@mintlify/msft-sdk 1.1.11 → 1.1.14

package/dist/index.d.ts

@@ -8,6 +8,7 @@ import { Node as Node_2 } from 'unist';
 import { Node as Node_3 } from 'hast';
 import { Plugin as Plugin_2 } from 'unified';
 import * as React_2 from 'react';
+import { ReactNode } from 'react';
 import { Root } from 'mdast';
 import { Root as Root_2 } from 'hast';
 import { State } from 'hast-util-to-mdast';
@@ -83,6 +84,14 @@ export declare function ComponentsProvider({ children, LinkComponent, }: {
     LinkComponent?: LinkComponent;
 }): JSX_2.Element;
 
+declare type ContextualOption = {
+    id: string;
+    title: string;
+    description: string;
+    icon: default_2.ElementType;
+    action: () => void;
+};
+
 export declare function convertHtmlToMdx(html: string, options?: ConvertOptions): Promise<{
     mdx: string;
     mdxExtracts: MdxExtracts;
@@ -119,7 +128,123 @@ declare interface DetailsProps {
     open?: boolean;
 }
 
-export declare function DocsPage({ payload, toc, navTree, activeHref, theme, className, pathname, markdownContent, allPages, baseUrl, bottomLinks, LinkComponent, }: DocsPageProps): JSX_2.Element;
+/**
+ * DocsLayout component provides a complete documentation layout with sidebar navigation
+ * and main content area. It's designed to be scalable, customizable, and tree-shakable.
+ *
+ * @example
+ * ```tsx
+ * <DocsLayout
+ *   navTree={{ items: [...] }}
+ *   activeHref="/docs/getting-started"
+ *   theme="dark"
+ *   bottomLinks={[
+ *     { href: "https://blog.com", label: "Blog", icon: BlogIcon }
+ *   ]}
+ *   LinkComponent={Link}
+ * >
+ *   <YourPageContent />
+ * </DocsLayout>
+ * ```
+ */
+export declare const DocsLayout: ({ navTree, children, activeHref, activeId, theme, className, bottomLinks, LinkComponent, localization, telemetry, showSidebar, sidebarClassName, }: DocsLayoutProps) => JSX_2.Element;
+
+/**
+ * Localization strings for DocsLayout
+ */
+export declare interface DocsLayoutLocalization {
+    /** Aria label for the sidebar navigation. Default: "Sidebar navigation" */
+    sidebarAriaLabel?: string;
+}
+
+/**
+ * Props for the DocsLayout component
+ */
+export declare interface DocsLayoutProps {
+    /** Navigation tree data structure */
+    navTree: NavTreeData;
+    /** The main content to render in the layout */
+    children: ReactNode;
+    /** Currently active href for navigation highlighting */
+    activeHref?: string;
+    /** Currently active ID for navigation highlighting */
+    activeId?: string;
+    /** Theme for the layout */
+    theme?: "light" | "dark";
+    /** Additional CSS classes for the outer container */
+    className?: string;
+    /** Bottom links configuration (e.g., blog, GitHub, feedback) */
+    bottomLinks?: BottomLinkConfig[];
+    /** Custom Link component for navigation (e.g., React Router Link, Next.js Link) */
+    LinkComponent?: LinkComponent;
+    /** Localization strings */
+    localization?: DocsLayoutLocalization;
+    /** Telemetry configuration */
+    telemetry?: DocsLayoutTelemetry;
+    /** Whether to show the sidebar. Default: true */
+    showSidebar?: boolean;
+    /** Custom className for the sidebar to control responsive behavior.
+     * Default: "mint:max-lg:hidden" (hidden below lg breakpoint) */
+    sidebarClassName?: string;
+}
+
+/**
+ * Telemetry configuration for DocsLayout
+ */
+export declare interface DocsLayoutTelemetry {
+    /** Activity name for bottom link clicks */
+    bottomLinkActivity?: string;
+    /** Phase for bottom link clicks (e.g., "Start", "Complete") */
+    bottomLinkPhase?: string;
+}
+
+/**
+ * DocsPage component renders a documentation page with MDX content, table of contents,
+ * zone pivot selectors, and page context menu. It supports full customization through
+ * props for localization, telemetry, and custom components.
+ *
+ * @example
+ * ```tsx
+ * <DocsPage
+ *   payload={{
+ *     content: "...",
+ *     serializedContent: Content,
+ *     title: "Getting Started",
+ *     description: "Learn how to get started"
+ *   }}
+ *   toc={[{ title: "Introduction", slug: "intro", level: 2 }]}
+ *   theme="dark"
+ *   pathname="/docs/getting-started"
+ *   LinkComponent={Link}
+ *   localization={{
+ *     onThisPage: "In this article"
+ *   }}
+ *   telemetry={{
+ *     contextMenuActivity: "DocsPageContextMenu",
+ *     contextMenuPhase: "Start"
+ *   }}
+ * />
+ * ```
+ */
+export declare function DocsPage({ payload, toc, navTree, activeHref, theme, className, pathname, markdownContent, allPages, baseUrl, bottomLinks, LinkComponent, localization, telemetry, contextMenu, }: DocsPagePropsWithCustomization): JSX_2.Element;
+
+/**
+ * Localization strings for DocsPage component
+ */
+export declare interface DocsPageLocalization {
+    /** Text for "On this page" heading. Default: "On this page" */
+    onThisPage?: string;
+    /** Loading message. Default: "Loading..." */
+    loading?: string;
+    /** Error title. Default: "Error" */
+    errorTitle?: string;
+    /** Generic error message. Default: "Something went wrong" */
+    errorMessage?: string;
+    /** Not found title. Default: "Page not found" */
+    notFoundTitle?: string;
+    /** Not found message. Default: "The page you're looking for doesn't exist" */
+    notFoundMessage?: string;
+}
 
 export declare interface DocsPageProps {
     payload: PayloadData;
@@ -136,6 +261,36 @@ export declare interface DocsPageProps {
     LinkComponent?: LinkComponent;
 }
 
+/**
+ * Enhanced DocsPageProps with localization and telemetry support
+ */
+export declare interface DocsPagePropsWithCustomization extends DocsPageProps {
+    /** Localization strings */
+    localization?: DocsPageLocalization;
+    /** Telemetry configuration */
+    telemetry?: DocsPageTelemetry;
+    /** Context menu configuration */
+    contextMenu?: PageContextMenuConfig;
+}
+
+/**
+ * Telemetry configuration for DocsPage
+ */
+export declare interface DocsPageTelemetry {
+    /** Activity name for page context menu interactions */
+    contextMenuActivity?: string;
+    /** Phase for context menu interactions */
+    contextMenuPhase?: string;
+    /** Activity name for TOC link clicks */
+    tocLinkActivity?: string;
+    /** Phase for TOC link clicks */
+    tocLinkPhase?: string;
+    /** Activity name for zone pivot selector changes */
+    zonePivotActivity?: string;
+    /** Phase for zone pivot changes */
+    zonePivotPhase?: string;
+}
+
 export declare type ElementType = {
     type?: string;
     tagName?: string;
@@ -290,6 +445,24 @@ declare interface NavTreeProps {
 
 export declare const PageContextMenu: ({ className, pathname, markdownContent, onCopyMarkdown, onViewMarkdown, allPages, baseUrl, }: PageContextMenuProps) => JSX_2.Element;
 
+/**
+ * Configuration for the page context menu
+ */
+export declare interface PageContextMenuConfig {
+    /** Custom actions for the page context menu. If provided, these will replace the default actions. */
+    customActions?: ContextualOption[];
+    /** Callback fired after markdown is successfully copied */
+    onCopyMarkdown?: () => void;
+    /** Custom handler for "Copy Page" action. If provided, replaces default copy behavior. */
+    onCopyPage?: () => void | Promise<void>;
+    /** Custom handler for "View as Markdown" action. If provided, replaces default view behavior. */
+    onViewMarkdown?: (pathname: string) => void;
+    /** Custom handler for "View llms.txt" action. If provided, replaces default behavior. */
+    onViewLlmsTxt?: () => void;
+    /** Custom handler for "View llms-full.txt" action. If provided, replaces default behavior. */
+    onViewLlmsFullTxt?: () => void;
+}
+
 export declare interface PageContextMenuProps {
     className?: string;
     pathname: string;
@@ -352,7 +525,12 @@ export declare function removeHtmlComments(root: Root_2): void;
 
 export declare const sanitizePreTags: Plugin_2<[], Node_3>;
 
-export declare function serializeMdx(mdxString: string): Promise<default_2.ComponentType>;
+export declare function serializeMdx(mdxString: string): Promise<SerializeMdxResult>;
+
+export declare interface SerializeMdxResult {
+    Content: default_2.ComponentType;
+    headings: TocItem[];
+}
 
 export declare function Summary({ children, isOpen }: SummaryProps): JSX_2.Element;
 

package/dist/index.js

@@ -1,117 +1,119 @@
-import { DocsPage as r } from "./components/page.js";
-import { MDXRenderer as m } from "./components/mdx-renderer.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 { ApiReferenceProvider2 as b, useApiReference as g } from "./components/Api/ApiReferenceProvider.js";
-import { TableOfContents as H } from "./components/toc/index.js";
-import { PivotAwareTOC as y } from "./components/toc/pivot-aware-toc.js";
-import { PageContextMenu as u } from "./components/page-context-menu.js";
-import { copyMarkdownToClipboard as k, getPageMarkdown as M, useMarkdownCopy as w } from "./hooks/useMarkdownCopy.js";
-import { generateLlmsFullTxt as N, generateLlmsTxt as D } from "./utils/generate-llms-txt.js";
-import { getNodeText as z } from "./utils/get-node-text.js";
-import { capitalize as F } from "./utils/string.js";
-import { cn as B } from "./utils/cn.js";
-import { getClassNames as I, getTextContent as O, isElement as S } from "./utils/rehype.js";
-import { convertHtmlToMdx as X } from "./parser/convert-html-to-mdx.js";
-import { serializeMdx as q } from "./parser/serialize-mdx.js";
-import { extractHeadings as K } from "./plugins/extract-headings.js";
-import { rehypeRemoveHtmlComments as U, removeHtmlComments as V } from "./plugins/sanitize/remove-html-comments.js";
-import { CodeBlock as Y } from "./components/content-components/code-block.js";
-import { Heading as $ } from "./components/content-components/heading.js";
-import { Link as oe } from "./components/content-components/link.js";
-import { Callout as te } from "./components/content-components/callouts.js";
-import { ZonePivot as pe } from "./components/content-components/zone-pivots/zone-pivot.js";
-import { ZoneTarget as xe } from "./components/content-components/zone-pivots/zone-target.js";
-import { ZonePivotProvider as le } from "./components/content-components/zone-pivots/zone-pivot-context.js";
-import { ZonePivotSelector as se } from "./components/content-components/zone-pivots/zone-pivot-selector.js";
-import { ParamName as ie } from "./components/content-components/param-name.js";
-import { Tabs as Ce } from "./components/content-components/tabs/tabs.js";
-import { Tab as ge } from "./components/content-components/tabs/tab.js";
-import { Details as He, Summary as ve } from "./components/content-components/details/details.js";
-import { Table as ce, TableBody as ue, TableCaption as he, TableCell as ke, TableFooter as Me, TableHead as we, TableHeader as Re, TableRow as Ne } from "./components/content-components/table/index.js";
-import { allComponents as Ze } from "./components/content-components/all-components.js";
-import { Home as Ae } from "./components/content-components/home.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 Je } from "./plugins/sanitize/rehype-pre-to-mdx-fence.js";
-import { rehypeCallouts as je } from "./plugins/sanitize/rehype-callouts.js";
-import { rehypeParamName as Ge } from "./plugins/sanitize/rehype-param-name.js";
-import { rehypeTabs as Qe } from "./plugins/sanitize/rehype-tabs.js";
-import { rehypeDetails as Ve } from "./plugins/sanitize/rehype-details.js";
-import { rehypeHeadingIds as Ye } from "./plugins/sanitize/rehype-heading-ids.js";
-import { rehypeZonePivots as $e } from "./plugins/sanitize/rehype-zone-pivots.js";
-import { mdxJsxFlowElementHandler as oo, rehypeRemark as ro } from "./plugins/sanitize/rehype-remark.js";
-import { tableCellHandler as mo, tableHandler as po, tableRowHandler as ao } from "./plugins/sanitize/rehype-table-align.js";
+import { DocsPage as r } from "./components/docsPage.js";
+import { DocsLayout as m } from "./components/docsLayout.js";
+import { MDXRenderer as a } from "./components/mdx-renderer.js";
+import { PlainTextPage as f } from "./components/plain-text-page.js";
+import { createDefaultComponents as n, defaultComponents as s } from "./components/content-components/default-components.js";
+import { ComponentsProvider as i, useComponents as T } from "./context/components-context.js";
+import { NavTree as b } from "./components/nav-tree/index.js";
+import { ApiReferenceProvider2 as P, useApiReference as y } from "./components/Api/ApiReferenceProvider.js";
+import { TableOfContents as c } from "./components/toc/index.js";
+import { PivotAwareTOC as u } from "./components/toc/pivot-aware-toc.js";
+import { PageContextMenu as k } from "./components/page-context-menu.js";
+import { copyMarkdownToClipboard as w, getPageMarkdown as R, useMarkdownCopy as D } from "./hooks/useMarkdownCopy.js";
+import { generateLlmsFullTxt as Z, generateLlmsTxt as L } from "./utils/generate-llms-txt.js";
+import { getNodeText as A } from "./utils/get-node-text.js";
+import { capitalize as B } from "./utils/string.js";
+import { cn as I } from "./utils/cn.js";
+import { getClassNames as S, getTextContent as J, isElement as X } from "./utils/rehype.js";
+import { convertHtmlToMdx as q } from "./parser/convert-html-to-mdx.js";
+import { serializeMdx as K } from "./parser/serialize-mdx.js";
+import { extractHeadings as U } from "./plugins/extract-headings.js";
+import { rehypeRemoveHtmlComments as W, removeHtmlComments as Y } from "./plugins/sanitize/remove-html-comments.js";
+import { CodeBlock as $ } from "./components/content-components/code-block.js";
+import { Heading as oe } from "./components/content-components/heading.js";
+import { Link as te } from "./components/content-components/link.js";
+import { Callout as pe } from "./components/content-components/callouts.js";
+import { ZonePivot as xe } from "./components/content-components/zone-pivots/zone-pivot.js";
+import { ZoneTarget as le } from "./components/content-components/zone-pivots/zone-target.js";
+import { ZonePivotProvider as se } from "./components/content-components/zone-pivots/zone-pivot-context.js";
+import { ZonePivotSelector as ie } from "./components/content-components/zone-pivots/zone-pivot-selector.js";
+import { ParamName as Ce } from "./components/content-components/param-name.js";
+import { Tabs as ge } from "./components/content-components/tabs/tabs.js";
+import { Tab as ye } from "./components/content-components/tabs/tab.js";
+import { Details as ce, Summary as ve } from "./components/content-components/details/details.js";
+import { Table as he, TableBody as ke, TableCaption as Me, TableCell as we, TableFooter as Re, TableHead as De, TableHeader as Ne, TableRow as Ze } from "./components/content-components/table/index.js";
+import { allComponents as ze } from "./components/content-components/all-components.js";
+import { Home as Fe } from "./components/content-components/home.js";
+import { MobileNavTree as Ee } from "./components/nav-tree/mobile-nav.js";
+import { rehypeCodeblocks as Oe } from "./plugins/rehype/rehype-code-blocks.js";
+import { remarkHeadingIds as Je } from "./plugins/remark/remark-heading-ids.js";
+import { sanitizePreTags as je } from "./plugins/sanitize/rehype-pre-to-mdx-fence.js";
+import { rehypeCallouts as Ge } from "./plugins/sanitize/rehype-callouts.js";
+import { rehypeParamName as Qe } from "./plugins/sanitize/rehype-param-name.js";
+import { rehypeTabs as Ve } from "./plugins/sanitize/rehype-tabs.js";
+import { rehypeDetails as Ye } from "./plugins/sanitize/rehype-details.js";
+import { rehypeHeadingIds as $e } from "./plugins/sanitize/rehype-heading-ids.js";
+import { rehypeZonePivots as oo } from "./plugins/sanitize/rehype-zone-pivots.js";
+import { mdxJsxFlowElementHandler as to, rehypeRemark as mo } from "./plugins/sanitize/rehype-remark.js";
+import { tableCellHandler as ao, tableHandler as xo, tableRowHandler as fo } from "./plugins/sanitize/rehype-table-align.js";
 export {
-  b as ApiReferenceProvider2,
-  te as Callout,
-  Y as CodeBlock,
-  s as ComponentsProvider,
-  He as Details,
+  P as ApiReferenceProvider2,
+  pe as Callout,
+  $ as CodeBlock,
+  i as ComponentsProvider,
+  ce as Details,
+  m as DocsLayout,
   r as DocsPage,
-  $ as Heading,
-  Ae as Home,
-  oe as Link,
-  m as MDXRenderer,
-  Le as MobileNavTree,
-  T as NavTree,
-  u as PageContextMenu,
-  ie as ParamName,
-  y as PivotAwareTOC,
-  a as PlainTextPage,
+  oe as Heading,
+  Fe as Home,
+  te as Link,
+  a as MDXRenderer,
+  Ee as MobileNavTree,
+  b as NavTree,
+  k as PageContextMenu,
+  Ce as ParamName,
+  u as PivotAwareTOC,
+  f as PlainTextPage,
   ve as Summary,
-  ge as Tab,
-  ce as Table,
-  ue as TableBody,
-  he as TableCaption,
-  ke as TableCell,
-  Me as TableFooter,
-  we as TableHead,
-  Re as TableHeader,
-  H as TableOfContents,
-  Ne as TableRow,
-  Ce as Tabs,
-  pe as ZonePivot,
-  le as ZonePivotProvider,
-  se as ZonePivotSelector,
-  xe as ZoneTarget,
-  Ze as allComponents,
-  F as capitalize,
-  B as cn,
-  X as convertHtmlToMdx,
-  k as copyMarkdownToClipboard,
-  f as createDefaultComponents,
-  l as defaultComponents,
-  K as extractHeadings,
-  N as generateLlmsFullTxt,
-  D as generateLlmsTxt,
-  I as getClassNames,
-  z as getNodeText,
-  M as getPageMarkdown,
-  O as getTextContent,
-  S as isElement,
-  oo as mdxJsxFlowElementHandler,
-  je as rehypeCallouts,
-  Ee as rehypeCodeblocks,
-  Ve as rehypeDetails,
-  Ye as rehypeHeadingIds,
-  Ge as rehypeParamName,
-  ro as rehypeRemark,
-  U as rehypeRemoveHtmlComments,
-  Qe as rehypeTabs,
-  $e as rehypeZonePivots,
-  Oe as remarkHeadingIds,
-  V as removeHtmlComments,
-  Je as sanitizePreTags,
-  q as serializeMdx,
-  mo as tableCellHandler,
-  po as tableHandler,
-  ao as tableRowHandler,
-  g as useApiReference,
-  d as useComponents,
-  w as useMarkdownCopy
+  ye as Tab,
+  he as Table,
+  ke as TableBody,
+  Me as TableCaption,
+  we as TableCell,
+  Re as TableFooter,
+  De as TableHead,
+  Ne as TableHeader,
+  c as TableOfContents,
+  Ze as TableRow,
+  ge as Tabs,
+  xe as ZonePivot,
+  se as ZonePivotProvider,
+  ie as ZonePivotSelector,
+  le as ZoneTarget,
+  ze as allComponents,
+  B as capitalize,
+  I as cn,
+  q as convertHtmlToMdx,
+  w as copyMarkdownToClipboard,
+  n as createDefaultComponents,
+  s as defaultComponents,
+  U as extractHeadings,
+  Z as generateLlmsFullTxt,
+  L as generateLlmsTxt,
+  S as getClassNames,
+  A as getNodeText,
+  R as getPageMarkdown,
+  J as getTextContent,
+  X as isElement,
+  to as mdxJsxFlowElementHandler,
+  Ge as rehypeCallouts,
+  Oe as rehypeCodeblocks,
+  Ye as rehypeDetails,
+  $e as rehypeHeadingIds,
+  Qe as rehypeParamName,
+  mo as rehypeRemark,
+  W as rehypeRemoveHtmlComments,
+  Ve as rehypeTabs,
+  oo as rehypeZonePivots,
+  Je as remarkHeadingIds,
+  Y as removeHtmlComments,
+  je as sanitizePreTags,
+  K as serializeMdx,
+  ao as tableCellHandler,
+  xo as tableHandler,
+  fo as tableRowHandler,
+  y as useApiReference,
+  T as useComponents,
+  D 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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/parser/serialize-mdx.js

@@ -1,28 +1,33 @@
-import * as i from "react/jsx-runtime";
-import { jsx as n } from "react/jsx-runtime";
-import { compile as a, run as p } from "@mdx-js/mdx";
-import s from "remark-gfm";
-import { rehypeCodeblocks as c } from "../plugins/rehype/rehype-code-blocks.js";
-import { remarkHeadingIds as f } from "../plugins/remark/remark-heading-ids.js";
-import { defaultComponents as l } from "../components/content-components/default-components.js";
-async function x(r) {
+import * as a from "react/jsx-runtime";
+import { jsx as s } from "react/jsx-runtime";
+import { compile as p, run as c } from "@mdx-js/mdx";
+import d from "remark-gfm";
+import { extractHeadings as f } from "../plugins/extract-headings.js";
+import { rehypeCodeblocks as l } from "../plugins/rehype/rehype-code-blocks.js";
+import { remarkHeadingIds as u } from "../plugins/remark/remark-heading-ids.js";
+import { defaultComponents as g } from "../components/content-components/default-components.js";
+async function H(t) {
+  var r;
   try {
-    const o = await a(r, {
+    const o = await p(t, {
       outputFormat: "function-body",
-      remarkPlugins: [s, f],
-      rehypePlugins: [c]
-    }), t = String(o), { default: e } = await p(t, {
-      ...i
+      remarkPlugins: [d, u, f],
+      rehypePlugins: [l]
+    }), n = String(o), e = ((r = o.data) == null ? void 0 : r.headings) || [], { default: m } = await c(n, {
+      ...a
     });
-    return (m) => /* @__PURE__ */ n(
-      e,
-      {
-        ...m,
-        components: {
-          ...l
+    return {
+      Content: (i) => /* @__PURE__ */ s(
+        m,
+        {
+          ...i,
+          components: {
+            ...g
+          }
         }
-      }
-    );
+      ),
+      headings: e
+    };
   } catch (o) {
     throw console.error(
       "MDX compilation failed:",
@@ -31,6 +36,6 @@ async function x(r) {
   }
 }
 export {
-  x as serializeMdx
+  H as serializeMdx
 };
 //# sourceMappingURL=serialize-mdx.js.map

package/dist/parser/serialize-mdx.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialize-mdx.js","sources":["../../src/parser/serialize-mdx.tsx"],"sourcesContent":["import { compile } from \"@mdx-js/mdx\";\nimport { run } from \"@mdx-js/mdx\";\nimport * as runtime from \"react/jsx-runtime\";\nimport React from \"react\";\nimport remarkGfm from \"remark-gfm\";\nimport { rehypeCodeblocks, remarkHeadingIds } from \"../plugins\";\nimport { defaultComponents } from \"../components\";\n\nexport async function serializeMdx(\n  mdxString: string\n): Promise<React.ComponentType> {\n  try {\n    const compiled = await compile(mdxString, {\n      outputFormat: \"function-body\",\n      remarkPlugins: [remarkGfm, remarkHeadingIds],\n      rehypePlugins: [rehypeCodeblocks],\n    });\n\n    const compiledMdx = String(compiled);\n\n    const { default: Content } = await run(compiledMdx, {\n      ...runtime,\n    });\n\n    return (props) => (\n      <Content\n        {...props}\n        components={{\n          ...defaultComponents,\n        }}\n      />\n    );\n  } catch (error) {\n    console.error(\n      \"MDX compilation failed:\",\n      error instanceof Error ? error.message : String(error)\n    );\n    throw error;\n  }\n}\n"],"names":["serializeMdx","mdxString","compiled","compile","remarkGfm","remarkHeadingIds","rehypeCodeblocks","compiledMdx","Content","run","runtime","props","jsx","defaultComponents","error"],"mappings":";;;;;;;AAQA,eAAsBA,EACpBC,GAC8B;AAC9B,MAAI;AACF,UAAMC,IAAW,MAAMC,EAAQF,GAAW;AAAA,MACxC,cAAc;AAAA,MACd,eAAe,CAACG,GAAWC,CAAgB;AAAA,MAC3C,eAAe,CAACC,CAAgB;AAAA,IAAA,CACjC,GAEKC,IAAc,OAAOL,CAAQ,GAE7B,EAAE,SAASM,EAAA,IAAY,MAAMC,EAAIF,GAAa;AAAA,MAClD,GAAGG;AAAA,IAAA,CACJ;AAED,WAAO,CAACC,MACN,gBAAAC;AAAA,MAACJ;AAAA,MAAA;AAAA,QACE,GAAGG;AAAA,QACJ,YAAY;AAAA,UACV,GAAGE;AAAA,QAAA;AAAA,MACL;AAAA,IAAA;AAAA,EAGN,SAASC,GAAO;AACd,kBAAQ;AAAA,MACN;AAAA,MACAA,aAAiB,QAAQA,EAAM,UAAU,OAAOA,CAAK;AAAA,IAAA,GAEjDA;AAAA,EACR;AACF;"}
+{"version":3,"file":"serialize-mdx.js","sources":["../../src/parser/serialize-mdx.tsx"],"sourcesContent":["import { compile } from \"@mdx-js/mdx\";\nimport { run } from \"@mdx-js/mdx\";\nimport * as runtime from \"react/jsx-runtime\";\nimport React from \"react\";\nimport remarkGfm from \"remark-gfm\";\nimport { rehypeCodeblocks, remarkHeadingIds } from \"../plugins\";\nimport { extractHeadings } from \"../plugins/extract-headings\";\nimport { defaultComponents } from \"../components\";\nimport type { TocItem } from \"../types\";\n\nexport interface SerializeMdxResult {\n  Content: React.ComponentType;\n  headings: TocItem[];\n}\n\nexport async function serializeMdx(\n  mdxString: string\n): Promise<SerializeMdxResult> {\n  try {\n    const compiled = await compile(mdxString, {\n      outputFormat: \"function-body\",\n      remarkPlugins: [remarkGfm, remarkHeadingIds, extractHeadings],\n      rehypePlugins: [rehypeCodeblocks],\n    });\n\n    const compiledMdx = String(compiled);\n\n    const headings = (compiled.data?.headings as TocItem[]) || [];\n\n    const { default: Content } = await run(compiledMdx, {\n      ...runtime,\n    });\n\n    const Component = (props: Record<string, unknown>) => (\n      <Content\n        {...props}\n        components={{\n          ...defaultComponents,\n        }}\n      />\n    );\n\n    return {\n      Content: Component,\n      headings,\n    };\n  } catch (error) {\n    console.error(\n      \"MDX compilation failed:\",\n      error instanceof Error ? error.message : String(error)\n    );\n    throw error;\n  }\n}\n"],"names":["serializeMdx","mdxString","compiled","compile","remarkGfm","remarkHeadingIds","extractHeadings","rehypeCodeblocks","compiledMdx","headings","_a","Content","run","runtime","props","jsx","defaultComponents","error"],"mappings":";;;;;;;;AAeA,eAAsBA,EACpBC,GAC6B;;AAC7B,MAAI;AACF,UAAMC,IAAW,MAAMC,EAAQF,GAAW;AAAA,MACxC,cAAc;AAAA,MACd,eAAe,CAACG,GAAWC,GAAkBC,CAAe;AAAA,MAC5D,eAAe,CAACC,CAAgB;AAAA,IAAA,CACjC,GAEKC,IAAc,OAAON,CAAQ,GAE7BO,MAAYC,IAAAR,EAAS,SAAT,gBAAAQ,EAAe,aAA0B,CAAA,GAErD,EAAE,SAASC,EAAA,IAAY,MAAMC,EAAIJ,GAAa;AAAA,MAClD,GAAGK;AAAA,IAAA,CACJ;AAWD,WAAO;AAAA,MACL,SAVgB,CAACC,MACjB,gBAAAC;AAAA,QAACJ;AAAA,QAAA;AAAA,UACE,GAAGG;AAAA,UACJ,YAAY;AAAA,YACV,GAAGE;AAAA,UAAA;AAAA,QACL;AAAA,MAAA;AAAA,MAMF,UAAAP;AAAA,IAAA;AAAA,EAEJ,SAASQ,GAAO;AACd,kBAAQ;AAAA,MACN;AAAA,MACAA,aAAiB,QAAQA,EAAM,UAAU,OAAOA,CAAK;AAAA,IAAA,GAEjDA;AAAA,EACR;AACF;"}

package/dist/plugins/extract-headings.js

@@ -1,28 +1,34 @@
-import { visit as a } from "unist-util-visit";
-import o from "@sindresorhus/slugify";
-function l(e) {
-  return e.children.filter((t) => t.type === "text").map((t) => t.value).join("").replace(/\s*\([^)]*\)\s*/g, " ").trim();
+import { visit as l } from "unist-util-visit";
+import g from "@sindresorhus/slugify";
+function p(n) {
+  return n.children.filter((t) => t.type === "text").map((t) => t.value).join("").replace(/\s*\([^)]*\)\s*/g, " ").trim();
 }
-function g() {
-  return (e, n) => {
-    const i = [];
-    a(e, "heading", (t) => {
-      const r = t.depth;
-      if (r >= 2 && r <= 3) {
-        const c = l(t), s = o(c.replace(/\./g, "-"));
+function h() {
+  return (n, s) => {
+    const i = [], t = /* @__PURE__ */ new Map();
+    l(n, "heading", (r) => {
+      const c = r.depth;
+      if (c === 2) {
+        const o = p(r);
+        let e = g(o.replace(/\./g, "-"));
+        if (t.has(e)) {
+          const a = t.get(e) + 1;
+          t.set(e, a), e = `${e}-${a}`;
+        } else
+          t.set(e, 1);
         i.push({
-          title: c,
-          slug: s,
-          level: r
+          title: o,
+          slug: e,
+          level: c
         });
       }
-    }), n.data = {
-      ...n.data,
+    }), s.data = {
+      ...s.data,
       headings: i
     };
   };
 }
 export {
-  g as extractHeadings
+  h as extractHeadings
 };
 //# sourceMappingURL=extract-headings.js.map

package/dist/plugins/extract-headings.js.map

@@ -1 +1 @@
-{"version":3,"file":"extract-headings.js","sources":["../../src/plugins/extract-headings.ts"],"sourcesContent":["import { visit } from \"unist-util-visit\";\nimport type { Node } from \"unist\";\nimport type { TocItem } from \"../types\";\nimport slugify from \"@sindresorhus/slugify\";\n\nfunction getHeadingText(node: Record<string, unknown>): string {\n  const children = node.children as Array<Record<string, unknown>>;\n  const text = children\n    .filter((child) => child.type === \"text\")\n    .map((child) => child.value as string)\n    .join(\"\");\n\n  return text.replace(/\\s*\\([^)]*\\)\\s*/g, \" \").trim();\n}\n\nexport function extractHeadings() {\n  return (tree: Node, file: unknown) => {\n    const headings: TocItem[] = [];\n\n    visit(tree, \"heading\", (node: Record<string, unknown>) => {\n      const depth = node.depth as number;\n      if (depth >= 2 && depth <= 3) {\n        const text = getHeadingText(node);\n        const slug = slugify(text.replace(/\\./g, '-'));\n\n        headings.push({\n          title: text,\n          slug,\n          level: depth,\n        });\n      }\n    });\n\n    (file as Record<string, unknown>).data = {\n      ...((file as Record<string, unknown>).data as Record<string, unknown>),\n      headings,\n    };\n  };\n}\n"],"names":["getHeadingText","node","child","extractHeadings","tree","file","headings","visit","depth","text","slug","slugify"],"mappings":";;AAKA,SAASA,EAAeC,GAAuC;AAO7D,SANiBA,EAAK,SAEnB,OAAO,CAACC,MAAUA,EAAM,SAAS,MAAM,EACvC,IAAI,CAACA,MAAUA,EAAM,KAAe,EACpC,KAAK,EAAE,EAEE,QAAQ,oBAAoB,GAAG,EAAE,KAAA;AAC/C;AAEO,SAASC,IAAkB;AAChC,SAAO,CAACC,GAAYC,MAAkB;AACpC,UAAMC,IAAsB,CAAA;AAE5B,IAAAC,EAAMH,GAAM,WAAW,CAACH,MAAkC;AACxD,YAAMO,IAAQP,EAAK;AACnB,UAAIO,KAAS,KAAKA,KAAS,GAAG;AAC5B,cAAMC,IAAOT,EAAeC,CAAI,GAC1BS,IAAOC,EAAQF,EAAK,QAAQ,OAAO,GAAG,CAAC;AAE7C,QAAAH,EAAS,KAAK;AAAA,UACZ,OAAOG;AAAA,UACP,MAAAC;AAAA,UACA,OAAOF;AAAA,QAAA,CACR;AAAA,MACH;AAAA,IACF,CAAC,GAEAH,EAAiC,OAAO;AAAA,MACvC,GAAKA,EAAiC;AAAA,MACtC,UAAAC;AAAA,IAAA;AAAA,EAEJ;AACF;"}
+{"version":3,"file":"extract-headings.js","sources":["../../src/plugins/extract-headings.ts"],"sourcesContent":["import { visit } from \"unist-util-visit\";\nimport type { Node } from \"unist\";\nimport type { TocItem } from \"../types\";\nimport slugify from \"@sindresorhus/slugify\";\n\nfunction getHeadingText(node: Record<string, unknown>): string {\n  const children = node.children as Array<Record<string, unknown>>;\n  const text = children\n    .filter((child) => child.type === \"text\")\n    .map((child) => child.value as string)\n    .join(\"\");\n\n  return text.replace(/\\s*\\([^)]*\\)\\s*/g, \" \").trim();\n}\n\nexport function extractHeadings() {\n  return (tree: Node, file: unknown) => {\n    const headings: TocItem[] = [];\n    const slugCounts = new Map<string, number>();\n\n    visit(tree, \"heading\", (node: Record<string, unknown>) => {\n      const depth = node.depth as number;\n      if (depth === 2) {\n        const text = getHeadingText(node);\n        let slug = slugify(text.replace(/\\./g, '-'));\n\n        // Handle duplicate slugs by adding a counter\n        if (slugCounts.has(slug)) {\n          const count = slugCounts.get(slug)! + 1;\n          slugCounts.set(slug, count);\n          slug = `${slug}-${count}`;\n        } else {\n          slugCounts.set(slug, 1);\n        }\n\n        headings.push({\n          title: text,\n          slug,\n          level: depth,\n        });\n      }\n    });\n\n    (file as Record<string, unknown>).data = {\n      ...((file as Record<string, unknown>).data as Record<string, unknown>),\n      headings,\n    };\n  };\n}\n"],"names":["getHeadingText","node","child","extractHeadings","tree","file","headings","slugCounts","visit","depth","text","slug","slugify","count"],"mappings":";;AAKA,SAASA,EAAeC,GAAuC;AAO7D,SANiBA,EAAK,SAEnB,OAAO,CAACC,MAAUA,EAAM,SAAS,MAAM,EACvC,IAAI,CAACA,MAAUA,EAAM,KAAe,EACpC,KAAK,EAAE,EAEE,QAAQ,oBAAoB,GAAG,EAAE,KAAA;AAC/C;AAEO,SAASC,IAAkB;AAChC,SAAO,CAACC,GAAYC,MAAkB;AACpC,UAAMC,IAAsB,CAAA,GACtBC,wBAAiB,IAAA;AAEvB,IAAAC,EAAMJ,GAAM,WAAW,CAACH,MAAkC;AACxD,YAAMQ,IAAQR,EAAK;AACnB,UAAIQ,MAAU,GAAG;AACf,cAAMC,IAAOV,EAAeC,CAAI;AAChC,YAAIU,IAAOC,EAAQF,EAAK,QAAQ,OAAO,GAAG,CAAC;AAG3C,YAAIH,EAAW,IAAII,CAAI,GAAG;AACxB,gBAAME,IAAQN,EAAW,IAAII,CAAI,IAAK;AACtC,UAAAJ,EAAW,IAAII,GAAME,CAAK,GAC1BF,IAAO,GAAGA,CAAI,IAAIE,CAAK;AAAA,QACzB;AACE,UAAAN,EAAW,IAAII,GAAM,CAAC;AAGxB,QAAAL,EAAS,KAAK;AAAA,UACZ,OAAOI;AAAA,UACP,MAAAC;AAAA,UACA,OAAOF;AAAA,QAAA,CACR;AAAA,MACH;AAAA,IACF,CAAC,GAEAJ,EAAiC,OAAO;AAAA,MACvC,GAAKA,EAAiC;AAAA,MACtC,UAAAC;AAAA,IAAA;AAAA,EAEJ;AACF;"}