@mintlify/msft-sdk 1.1.10 → 1.1.12

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';
@@ -27,10 +28,6 @@ export declare const allComponents: {
     Summary: typeof Summary;
 };
 
-export declare function Api({ children }: {
-    children?: default_2.ReactNode;
-}): JSX_2.Element;
-
 declare interface ApiReferenceContextValue {
     apiReferenceData2?: any;
     docsConfig?: any;
@@ -87,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;
@@ -123,13 +128,128 @@ declare interface DetailsProps {
     open?: boolean;
 }
 
-export declare function DocsPage({ payload, toc, navTree, dropdown, 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;
     toc?: TocItem[];
     navTree?: NavTreeData;
-    dropdown?: DropdownConfig;
     activeHref?: string;
     theme?: "light" | "dark";
     className?: string;
@@ -141,35 +261,34 @@ export declare interface DocsPageProps {
     LinkComponent?: LinkComponent;
 }
 
-export declare interface DropdownConfig {
-    title: string;
-    description: string;
-    icon?: default_2.ComponentType<{
-        className?: string;
-    }>;
-    color?: {
-        light?: string;
-        dark?: string;
-    };
-    items?: DropdownItem[];
-}
-
-export declare interface DropdownItem {
-    title: string;
-    href?: string;
-    description?: string;
-    icon?: default_2.ComponentType<{
-        className?: string;
-    }>;
-}
-
-export declare function DropdownMenu({ dropdown, isActive, activeHref, className, }: DropdownMenuProps): JSX_2.Element;
-
-declare interface DropdownMenuProps {
-    dropdown: DropdownConfig;
-    isActive?: boolean;
-    activeHref?: string;
-    className?: string;
+/**
+ * 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 = {
@@ -284,7 +403,7 @@ declare interface MDXRendererProps {
     components?: MDXComponents;
 }
 
-export declare function MobileNavTree({ isOpen, setIsOpen, navTree, activeId, className, theme, dropdown, activeHref, bottomLinks, LinkComponent, }: MobileNavTreeProps): JSX_2.Element;
+export declare function MobileNavTree({ isOpen, setIsOpen, navTree, activeId, className, theme, activeHref, bottomLinks, LinkComponent, }: MobileNavTreeProps): JSX_2.Element;
 
 declare interface MobileNavTreeProps {
     isOpen: boolean;
@@ -293,7 +412,6 @@ declare interface MobileNavTreeProps {
     activeId?: string;
     className?: string;
     theme?: "light" | "dark" | "system";
-    dropdown?: DropdownConfig;
     activeHref?: string;
     bottomLinks?: BottomLinkConfig[];
     LinkComponent?: LinkComponent;
@@ -310,7 +428,7 @@ export declare interface NavItem {
     method?: string;
 }
 
-export declare function NavTree({ navTree, activeId, className, dropdown, activeHref, theme, bottomLinks, }: NavTreeProps): JSX_2.Element | null;
+export declare function NavTree({ navTree, activeId, className, activeHref, theme, bottomLinks, }: NavTreeProps): JSX_2.Element | null;
 
 export declare interface NavTreeData {
     items: NavItem[];
@@ -320,7 +438,6 @@ declare interface NavTreeProps {
     navTree: NavTreeData;
     activeId?: string;
     className?: string;
-    dropdown?: DropdownConfig;
     activeHref?: string;
     theme?: "light" | "dark" | "system";
     bottomLinks?: BottomLinkConfig[];
@@ -328,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;
@@ -390,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,17 +1,17 @@
-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 { Api as b } from "./components/Api/Api.js";
-import { ApiReferenceProvider2 as P, useApiReference as H } from "./components/Api/ApiReferenceProvider.js";
-import { TableOfContents as y } from "./components/toc/index.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 M } from "./components/page-context-menu.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 A } from "./utils/generate-llms-txt.js";
-import { getNodeText as F } from "./utils/get-node-text.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";
@@ -29,53 +29,51 @@ import { ZonePivotProvider as se } from "./components/content-components/zone-pi
 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 He } from "./components/content-components/tabs/tab.js";
-import { Details as ye, Summary as ce } from "./components/content-components/details/details.js";
-import { Table as he, TableBody as Me, TableCaption as ke, TableCell as we, TableFooter as Re, TableHead as De, TableHeader as Ne, TableRow as Ze } from "./components/content-components/table/index.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 Le } from "./components/content-components/home.js";
-import { DropdownMenu as Ee } from "./components/nav-tree/dropdown-menu.js";
-import { MobileNavTree as Oe } from "./components/nav-tree/mobile-nav.js";
-import { rehypeCodeblocks as Je } from "./plugins/rehype/rehype-code-blocks.js";
-import { remarkHeadingIds as je } from "./plugins/remark/remark-heading-ids.js";
-import { sanitizePreTags as Ge } from "./plugins/sanitize/rehype-pre-to-mdx-fence.js";
-import { rehypeCallouts as Qe } from "./plugins/sanitize/rehype-callouts.js";
-import { rehypeParamName as Ve } from "./plugins/sanitize/rehype-param-name.js";
-import { rehypeTabs as Ye } from "./plugins/sanitize/rehype-tabs.js";
-import { rehypeDetails as $e } from "./plugins/sanitize/rehype-details.js";
-import { rehypeHeadingIds as oo } from "./plugins/sanitize/rehype-heading-ids.js";
-import { rehypeZonePivots as to } from "./plugins/sanitize/rehype-zone-pivots.js";
-import { mdxJsxFlowElementHandler as po, rehypeRemark as ao } from "./plugins/sanitize/rehype-remark.js";
-import { tableCellHandler as fo, tableHandler as lo, tableRowHandler as no } from "./plugins/sanitize/rehype-table-align.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 Api,
   P as ApiReferenceProvider2,
   pe as Callout,
   $ as CodeBlock,
-  s as ComponentsProvider,
-  ye as Details,
+  i as ComponentsProvider,
+  ce as Details,
+  m as DocsLayout,
   r as DocsPage,
-  Ee as DropdownMenu,
   oe as Heading,
-  Le as Home,
+  Fe as Home,
   te as Link,
-  m as MDXRenderer,
-  Oe as MobileNavTree,
-  T as NavTree,
-  M as PageContextMenu,
+  a as MDXRenderer,
+  Ee as MobileNavTree,
+  b as NavTree,
+  k as PageContextMenu,
   Ce as ParamName,
   u as PivotAwareTOC,
-  a as PlainTextPage,
-  ce as Summary,
-  He as Tab,
+  f as PlainTextPage,
+  ve as Summary,
+  ye as Tab,
   he as Table,
-  Me as TableBody,
-  ke as TableCaption,
+  ke as TableBody,
+  Me as TableCaption,
   we as TableCell,
   Re as TableFooter,
   De as TableHead,
   Ne as TableHeader,
-  y as TableOfContents,
+  c as TableOfContents,
   Ze as TableRow,
   ge as Tabs,
   xe as ZonePivot,
@@ -87,35 +85,35 @@ export {
   I as cn,
   q as convertHtmlToMdx,
   w as copyMarkdownToClipboard,
-  f as createDefaultComponents,
-  l as defaultComponents,
+  n as createDefaultComponents,
+  s as defaultComponents,
   U as extractHeadings,
   Z as generateLlmsFullTxt,
-  A as generateLlmsTxt,
+  L as generateLlmsTxt,
   S as getClassNames,
-  F as getNodeText,
+  A as getNodeText,
   R as getPageMarkdown,
   J as getTextContent,
   X as isElement,
-  po as mdxJsxFlowElementHandler,
-  Qe as rehypeCallouts,
-  Je as rehypeCodeblocks,
-  $e as rehypeDetails,
-  oo as rehypeHeadingIds,
-  Ve as rehypeParamName,
-  ao as rehypeRemark,
+  to as mdxJsxFlowElementHandler,
+  Ge as rehypeCallouts,
+  Oe as rehypeCodeblocks,
+  Ye as rehypeDetails,
+  $e as rehypeHeadingIds,
+  Qe as rehypeParamName,
+  mo as rehypeRemark,
   W as rehypeRemoveHtmlComments,
-  Ye as rehypeTabs,
-  to as rehypeZonePivots,
-  je as remarkHeadingIds,
+  Ve as rehypeTabs,
+  oo as rehypeZonePivots,
+  Je as remarkHeadingIds,
   Y as removeHtmlComments,
-  Ge as sanitizePreTags,
+  je as sanitizePreTags,
   K as serializeMdx,
-  fo as tableCellHandler,
-  lo as tableHandler,
-  no as tableRowHandler,
-  H as useApiReference,
-  d as useComponents,
+  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;"}