@mintlify/msft-sdk 1.1.68 → 1.1.69

package/README.md

@@ -52,13 +52,93 @@ import { DocsPage } from "@mintlify/msft-sdk";
 
 ## Core Exports
 
+### Documentation Components
 - `DocsPage` - Main documentation page component
+- `ApiPage` - API reference page component
+- `DocsLayout` - Layout with navigation sidebar
 - `MDXRenderer` - Standalone MDX renderer
-- `convertHtmlToMdx` - Convert HTML to MDX
-- `serializeMdx` - Compile MDX to React components
 - `NavTree`, `TableOfContents` - Navigation components
 - `allComponents` - All available MDX components
 
+### Content Processing
+- `convertHtmlToMdx` - Convert HTML to MDX
+- `serializeMdx` - Compile MDX to React components
+
+### OpenAPI Utilities
+- `convertOpenApiSpecToGraph` - Convert OpenAPI spec to schema graph data
+- `convertOpenApiSpecToNav` - Generate navigation structure from OpenAPI spec
+- `convertOpenApiSpecToHrefMap` - Create href-to-endpoint lookup map
+
+## OpenAPI Integration
+
+The SDK provides utilities for working with OpenAPI specifications:
+
+```tsx
+import {
+  convertOpenApiSpecToGraph,
+  convertOpenApiSpecToNav,
+  convertOpenApiSpecToHrefMap,
+  getApiReferenceDataFromGraph,
+  ApiPage,
+} from "@mintlify/msft-sdk";
+import openApiSpec from "./my-openapi-spec.json";
+
+// Convert spec to schema graph (required for API rendering)
+const graphData = convertOpenApiSpecToGraph(openApiSpec, {
+  filename: "my-api.json",
+  originalFileLocation: "my-api.json",
+});
+
+// Generate navigation from OpenAPI spec
+const navData = convertOpenApiSpecToNav(openApiSpec);
+
+// Create href-to-endpoint map for routing
+const hrefMap = convertOpenApiSpecToHrefMap(openApiSpec);
+
+// Get API reference data for a specific endpoint
+const apiReferenceData = getApiReferenceDataFromGraph({
+  metadata: {
+    title: "Create User",
+    description: "Create a new user",
+    openapi: "post /users",
+  },
+  schemaGraphData: graphData,
+});
+
+// Render the API page
+<ApiPage
+  apiReferenceData={apiReferenceData}
+  pageMetadata={metadata}
+  theme="light"
+/>;
+```
+
+## Development
+
+### Running Tests
+
+This project uses [Vitest](https://vitest.dev/) for testing.
+
+```bash
+# Run tests once
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Run tests with coverage
+npm run test:coverage
+```
+
+### Test Structure
+
+Tests are located in the `tests/` directory and are organized as follows:
+
+- `tests/fixtures/` - Test fixtures including OpenAPI specs and expected outputs
+- `tests/*.test.ts` - Test files for various conversion functions
+
+The test fixtures are kept outside of the `src/` directory to ensure they're not bundled with the package.
+
 ## License
 
 MIT © Mintlify, Inc.

package/dist/index.d.ts

@@ -100,6 +100,15 @@ export declare const ApiFields: NamedExoticComponent<    {
 pageMetadata: PageMetaTags;
 }>;
 
+export declare interface ApiNavStructure {
+    items: NavItem_2[];
+    metadata: {
+        generated_from: string;
+        spec_title: string;
+        spec_version: string;
+    };
+}
+
 export declare function ApiPage({ theme, className, pathname, markdownContent, allPages, baseUrl, LinkComponent, contextMenu, contextMenuEnabled, apiReferenceData, pageMetadata, playgroundDisplay, requestEndpointUrl, fileRequestEndpointUrl, }: ApiPageProps): JSX_2.Element;
 
 declare interface ApiPageProps {
@@ -287,6 +296,37 @@ export declare function convertHtmlToMdx(html: string, options?: ConvertOptions)
     mdxExtracts: MdxExtracts;
 }>;
 
+/**
+ * Converts an OpenAPI specification object to schema graph format.
+ *
+ * @param spec - The OpenAPI specification object (will be validated as OpenAPI 3.0 or 3.1)
+ * @param options - Optional configuration
+ * @param options.filename - The filename for the spec (defaults to 'openapi.json')
+ * @param options.originalFileLocation - The original file location (defaults to filename)
+ * @returns SchemaGraphData - The converted schema graph structure
+ * @throws Error if the spec is not a valid OpenAPI 3.0 or 3.1 document
+ *
+ * @example
+ * ```typescript
+ * import { convertOpenApiSpecToGraph } from '@mintlify/msft-sdk';
+ * import openApiSpec from './azure-openapi.json';
+ *
+ * const graphData = convertOpenApiSpecToGraph(openApiSpec, {
+ *   filename: 'azure-openapi.json'
+ * });
+ * ```
+ */
+export declare function convertOpenApiSpecToGraph(spec: unknown, options?: {
+    filename?: string;
+    originalFileLocation?: string;
+}): SchemaGraphData;
+
+export declare function convertOpenApiSpecToHrefMap(spec: unknown, options?: {
+    baseHref?: string;
+}): HrefToEndpointMap;
+
+export declare function convertOpenApiSpecToNav(spec: unknown): ApiNavStructure;
+
 export declare interface ConvertOptions {
     metadata?: Record<string, unknown>;
     mdxExtracts?: MdxExtracts;
@@ -539,6 +579,12 @@ declare type EndpointHeaderProps = {
     children?: React.ReactNode;
 };
 
+export declare interface EndpointInfo {
+    path: string;
+    title: string;
+    description?: string;
+}
+
 export declare function extractHeadings(): (tree: Node_2, file: unknown) => void;
 
 export declare function generateLlmsFullTxt(pages: LlmsPageConfig[], baseUrl: string): Promise<string>;
@@ -569,6 +615,10 @@ declare interface HeadingProps {
 
 export declare const Home: () => JSX_2.Element;
 
+export declare interface HrefToEndpointMap {
+    [href: string]: EndpointInfo;
+}
+
 export declare function isElement<T extends ElementType = Element_2>(node: ElementType | undefined, key?: keyof T, element?: string): node is T & {
     data?: {
         meta?: unknown;
@@ -687,6 +737,14 @@ export declare interface NavItem {
     method?: string;
 }
 
+declare interface NavItem_2 {
+    toc_title: string;
+    href?: string;
+    description?: string;
+    method?: string;
+    children?: NavItem_2[];
+}
+
 export declare function NavTree({ navTree, activeId, className, activeHref, theme, bottomLinks, anchors, }: NavTreeProps): JSX_2.Element | null;
 
 export declare interface NavTreeData {

package/dist/index.js

@@ -3,15 +3,15 @@ import { DocsLayout as p } from "./components/docsLayout.js";
 import { MDXRenderer as a } from "./components/mdx-renderer.js";
 import { PlainTextPage as n } from "./components/plain-text-page.js";
 import { createDefaultComponents as l, defaultComponents as i } from "./components/content-components/default-components.js";
-import { ComponentsProvider as d, useComponents as C } from "./context/components-context.js";
-import { NavTree as P } from "./components/nav-tree/index.js";
-import { useApiReference as u } from "./components/Api/ApiReferenceProvider.js";
-import { ApiReferenceContext as T, ApiReferenceContext2 as b, ApiReferenceProvider as v, ApiReferenceProvider2 as A, DeploymentMetadataContext as H, DeploymentMetadataProvider as h, DocsConfigContext as D, DocsConfigProvider as R, PageContext as M, PageProvider as k } from "./contexts/ConfigContext.js";
-import { TableOfContents as w } from "./components/toc/index.js";
-import { PivotAwareTOC as F } from "./components/toc/pivot-aware-toc.js";
-import { PageContextMenu as N } from "./components/page-context-menu.js";
+import { ComponentsProvider as d, useComponents as c } from "./context/components-context.js";
+import { NavTree as g } from "./components/nav-tree/index.js";
+import { useApiReference as T } from "./components/Api/ApiReferenceProvider.js";
+import { ApiReferenceContext as y, ApiReferenceContext2 as v, ApiReferenceProvider as A, ApiReferenceProvider2 as b, DeploymentMetadataContext as H, DeploymentMetadataProvider as h, DocsConfigContext as D, DocsConfigProvider as R, PageContext as M, PageProvider as S } from "./contexts/ConfigContext.js";
+import { TableOfContents as O } from "./components/toc/index.js";
+import { PivotAwareTOC as L } from "./components/toc/pivot-aware-toc.js";
+import { PageContextMenu as F } from "./components/page-context-menu.js";
 import { copyMarkdownToClipboard as Z, getPageMarkdown as z, useMarkdownCopy as E } from "./hooks/useMarkdownCopy.js";
-import { generateLlmsFullTxt as X, generateLlmsTxt as q } from "./utils/generate-llms-txt.js";
+import { generateLlmsFullTxt as G, generateLlmsTxt as X } from "./utils/generate-llms-txt.js";
 import { getNodeText as J } from "./utils/get-node-text.js";
 import { capitalize as j } from "./utils/string.js";
 import { cn as Q } from "./utils/cn.js";
@@ -23,147 +23,153 @@ import { extractHeadings as ae } from "./plugins/extract-headings.js";
 import { rehypeRemoveHtmlComments as ne, removeHtmlComments as fe } from "./plugins/sanitize/remove-html-comments.js";
 import { Api as ie } from "./api-playground-2/Api.js";
 import { OperationPage as de } from "./api-playground-2/OperationPage.js";
-import { SchemaPage as ge } from "./api-playground-2/SchemaPage.js";
-import { ApiExamples as ce } from "./api-playground-2/ApiExamples.js";
-import { ApiFields as ye } from "./api-playground-2/ApiFields.js";
-import { Playground as be } from "./api-playground-2/Playground.js";
-import { EndpointHeader as Ae } from "./api-playground-2/EndpointHeader.js";
+import { SchemaPage as Ce } from "./api-playground-2/SchemaPage.js";
+import { ApiExamples as Pe } from "./api-playground-2/ApiExamples.js";
+import { ApiFields as ue } from "./api-playground-2/ApiFields.js";
+import { Playground as ve } from "./api-playground-2/Playground.js";
+import { EndpointHeader as be } from "./api-playground-2/EndpointHeader.js";
 import { ApiPlaygroundContext as he, ApiPlaygroundContext as De } from "./api-playground-2/contexts/ApiPlaygroundContext.js";
 import { usePlaygroundInputsStore as Me } from "./api-playground-2/hooks/usePlaygroundInputsStore.js";
-import { useSendPlaygroundRequest as Se } from "./api-playground-2/hooks/useSendPlaygroundRequest.js";
-import { useInitializeInputs as Le } from "./api-playground-2/hooks/useInitializeInputs.js";
-import { useCopyPathWithInputs as Ie } from "./api-playground-2/hooks/useCopyPathWithInputs.js";
-import { useSelectedSecurityOption as Oe } from "./api-playground-2/hooks/useSelectedSecurityOption.js";
+import { useSendPlaygroundRequest as ke } from "./api-playground-2/hooks/useSendPlaygroundRequest.js";
+import { useInitializeInputs as we } from "./api-playground-2/hooks/useInitializeInputs.js";
+import { useCopyPathWithInputs as Ne } from "./api-playground-2/hooks/useCopyPathWithInputs.js";
+import { useSelectedSecurityOption as Ie } from "./api-playground-2/hooks/useSelectedSecurityOption.js";
 import { addApiReferenceDataFromMdxAndDocsConfig as ze } from "./api-playground-2/schemaGraph/addApiReferenceDataFromMdxAndDocsConfig.js";
 import { processSecurityOptions as Be } from "./api-playground-2/schemaGraph/processSecurityOptions.js";
-import { getApiReferenceDataFromGraph as qe } from "./api-playground-2/schemaGraph/getApiReferenceDataFromGraph.js";
+import { getApiReferenceDataFromGraph as Xe } from "./api-playground-2/schemaGraph/getApiReferenceDataFromGraph.js";
 import { ApiPage as Je } from "./components/apiPage.js";
-import { CodeBlock as je } from "./components/content-components/code-block.js";
-import { Heading as Qe } from "./components/content-components/heading.js";
-import { Link as Ve } from "./components/content-components/link.js";
-import { Callout as _e } from "./components/content-components/callouts.js";
-import { ZonePivot as eo } from "./components/content-components/zone-pivots/zone-pivot.js";
-import { ZoneTarget as ro } from "./components/content-components/zone-pivots/zone-target.js";
-import { ZonePivotProvider as po } from "./components/content-components/zone-pivots/zone-pivot-context.js";
-import { ZonePivotSelector as ao } from "./components/content-components/zone-pivots/zone-pivot-selector.js";
-import { ParamName as no } from "./components/content-components/param-name.js";
-import { Tabs as lo } from "./components/content-components/tabs/tabs.js";
-import { Tab as so } from "./components/content-components/tabs/tab.js";
-import { Details as go, Summary as Po } from "./components/content-components/details/details.js";
-import { Table as uo, TableBody as yo, TableCaption as To, TableCell as bo, TableFooter as vo, TableHead as Ao, TableHeader as Ho, TableRow as ho } from "./components/content-components/table/index.js";
-import { LaTeX as Ro } from "./components/content-components/latex.js";
-import { allComponents as ko } from "./components/content-components/all-components.js";
-import { Home as wo } from "./components/content-components/home.js";
-import { MobileNavTree as Fo } from "./components/nav-tree/mobile-nav.js";
-import { rehypeCodeblocks as No } from "./plugins/rehype/rehype-code-blocks.js";
-import { remarkHeadingIds as Zo } from "./plugins/remark/remark-heading-ids.js";
-import { sanitizePreTags as Eo } from "./plugins/sanitize/rehype-pre-to-mdx-fence.js";
-import { rehypeCallouts as Xo } from "./plugins/sanitize/rehype-callouts.js";
-import { rehypeParamName as Go } from "./plugins/sanitize/rehype-param-name.js";
-import { rehypeTabs as Wo } from "./plugins/sanitize/rehype-tabs.js";
-import { rehypeDetails as Ko } from "./plugins/sanitize/rehype-details.js";
-import { rehypeHeadingIds as Uo } from "./plugins/sanitize/rehype-heading-ids.js";
-import { rehypeZonePivots as Yo } from "./plugins/sanitize/rehype-zone-pivots.js";
-import { mdxJsxFlowElementHandler as $o, rehypeRemark as er } from "./plugins/sanitize/rehype-remark.js";
-import { rehypeLatex as rr } from "./plugins/sanitize/rehype-latex.js";
-import { tableCellHandler as pr, tableHandler as mr, tableRowHandler as ar } from "./plugins/sanitize/rehype-table-align.js";
+import { convertOpenApiSpecToGraph as je } from "./openapi/loadAndConvertOpenApiSpec.js";
+import { convertOpenApiSpecToNav as Qe } from "./openapi/convertOpenApiSpecToNav.js";
+import { convertOpenApiSpecToHrefMap as Ve } from "./openapi/convertOpenApiSpecToHrefMap.js";
+import { CodeBlock as _e } from "./components/content-components/code-block.js";
+import { Heading as eo } from "./components/content-components/heading.js";
+import { Link as ro } from "./components/content-components/link.js";
+import { Callout as po } from "./components/content-components/callouts.js";
+import { ZonePivot as ao } from "./components/content-components/zone-pivots/zone-pivot.js";
+import { ZoneTarget as no } from "./components/content-components/zone-pivots/zone-target.js";
+import { ZonePivotProvider as lo } from "./components/content-components/zone-pivots/zone-pivot-context.js";
+import { ZonePivotSelector as so } from "./components/content-components/zone-pivots/zone-pivot-selector.js";
+import { ParamName as Co } from "./components/content-components/param-name.js";
+import { Tabs as Po } from "./components/content-components/tabs/tabs.js";
+import { Tab as uo } from "./components/content-components/tabs/tab.js";
+import { Details as vo, Summary as Ao } from "./components/content-components/details/details.js";
+import { Table as Ho, TableBody as ho, TableCaption as Do, TableCell as Ro, TableFooter as Mo, TableHead as So, TableHeader as ko, TableRow as Oo } from "./components/content-components/table/index.js";
+import { LaTeX as Lo } from "./components/content-components/latex.js";
+import { allComponents as Fo } from "./components/content-components/all-components.js";
+import { Home as Zo } from "./components/content-components/home.js";
+import { MobileNavTree as Eo } from "./components/nav-tree/mobile-nav.js";
+import { rehypeCodeblocks as Go } from "./plugins/rehype/rehype-code-blocks.js";
+import { remarkHeadingIds as qo } from "./plugins/remark/remark-heading-ids.js";
+import { sanitizePreTags as Wo } from "./plugins/sanitize/rehype-pre-to-mdx-fence.js";
+import { rehypeCallouts as Ko } from "./plugins/sanitize/rehype-callouts.js";
+import { rehypeParamName as Uo } from "./plugins/sanitize/rehype-param-name.js";
+import { rehypeTabs as Yo } from "./plugins/sanitize/rehype-tabs.js";
+import { rehypeDetails as $o } from "./plugins/sanitize/rehype-details.js";
+import { rehypeHeadingIds as or } from "./plugins/sanitize/rehype-heading-ids.js";
+import { rehypeZonePivots as tr } from "./plugins/sanitize/rehype-zone-pivots.js";
+import { mdxJsxFlowElementHandler as mr, rehypeRemark as ar } from "./plugins/sanitize/rehype-remark.js";
+import { rehypeLatex as nr } from "./plugins/sanitize/rehype-latex.js";
+import { tableCellHandler as lr, tableHandler as ir, tableRowHandler as sr } from "./plugins/sanitize/rehype-table-align.js";
 export {
   ie as Api,
-  ce as ApiExamples,
-  ye as ApiFields,
+  Pe as ApiExamples,
+  ue as ApiFields,
   Je as ApiPage,
   he as ApiPlaygroundContext,
   De as ApiPlaygroundContextLegacy,
-  T as ApiReferenceContext,
-  b as ApiReferenceContext2,
-  v as ApiReferenceProvider,
-  A as ApiReferenceProvider2,
-  _e as Callout,
-  je as CodeBlock,
+  y as ApiReferenceContext,
+  v as ApiReferenceContext2,
+  A as ApiReferenceProvider,
+  b as ApiReferenceProvider2,
+  po as Callout,
+  _e as CodeBlock,
   d as ComponentsProvider,
   H as DeploymentMetadataContext,
   h as DeploymentMetadataProvider,
-  go as Details,
+  vo as Details,
   D as DocsConfigContext,
   R as DocsConfigProvider,
   p as DocsLayout,
   r as DocsPage,
-  Ae as EndpointHeader,
-  Qe as Heading,
-  wo as Home,
-  Ro as LaTeX,
-  Ve as Link,
+  be as EndpointHeader,
+  eo as Heading,
+  Zo as Home,
+  Lo as LaTeX,
+  ro as Link,
   a as MDXRenderer,
-  Fo as MobileNavTree,
-  P as NavTree,
+  Eo as MobileNavTree,
+  g as NavTree,
   de as OperationPage,
   M as PageContext,
-  N as PageContextMenu,
-  k as PageProvider,
-  no as ParamName,
-  F as PivotAwareTOC,
+  F as PageContextMenu,
+  S as PageProvider,
+  Co as ParamName,
+  L as PivotAwareTOC,
   n as PlainTextPage,
-  be as Playground,
-  ge as SchemaPage,
-  Po as Summary,
-  so as Tab,
-  uo as Table,
-  yo as TableBody,
-  To as TableCaption,
-  bo as TableCell,
-  vo as TableFooter,
-  Ao as TableHead,
-  Ho as TableHeader,
-  w as TableOfContents,
-  ho as TableRow,
-  lo as Tabs,
-  eo as ZonePivot,
-  po as ZonePivotProvider,
-  ao as ZonePivotSelector,
-  ro as ZoneTarget,
+  ve as Playground,
+  Ce as SchemaPage,
+  Ao as Summary,
+  uo as Tab,
+  Ho as Table,
+  ho as TableBody,
+  Do as TableCaption,
+  Ro as TableCell,
+  Mo as TableFooter,
+  So as TableHead,
+  ko as TableHeader,
+  O as TableOfContents,
+  Oo as TableRow,
+  Po as Tabs,
+  ao as ZonePivot,
+  lo as ZonePivotProvider,
+  so as ZonePivotSelector,
+  no as ZoneTarget,
   ze as addApiReferenceDataFromMdxAndDocsConfig,
-  ko as allComponents,
+  Fo as allComponents,
   j as capitalize,
   V as cleanTitle,
   Q as cn,
   re as convertHtmlToMdx,
+  je as convertOpenApiSpecToGraph,
+  Ve as convertOpenApiSpecToHrefMap,
+  Qe as convertOpenApiSpecToNav,
   Z as copyMarkdownToClipboard,
   l as createDefaultComponents,
   i as defaultComponents,
   ae as extractHeadings,
-  X as generateLlmsFullTxt,
-  q as generateLlmsTxt,
-  qe as getApiReferenceDataFromGraph,
+  G as generateLlmsFullTxt,
+  X as generateLlmsTxt,
+  Xe as getApiReferenceDataFromGraph,
   _ as getClassNames,
   J as getNodeText,
   z as getPageMarkdown,
   $ as getTextContent,
   ee as isElement,
-  $o as mdxJsxFlowElementHandler,
+  mr as mdxJsxFlowElementHandler,
   Be as processSecurityOptions,
-  Xo as rehypeCallouts,
-  No as rehypeCodeblocks,
-  Ko as rehypeDetails,
-  Uo as rehypeHeadingIds,
-  rr as rehypeLatex,
-  Go as rehypeParamName,
-  er as rehypeRemark,
+  Ko as rehypeCallouts,
+  Go as rehypeCodeblocks,
+  $o as rehypeDetails,
+  or as rehypeHeadingIds,
+  nr as rehypeLatex,
+  Uo as rehypeParamName,
+  ar as rehypeRemark,
   ne as rehypeRemoveHtmlComments,
-  Wo as rehypeTabs,
-  Yo as rehypeZonePivots,
-  Zo as remarkHeadingIds,
+  Yo as rehypeTabs,
+  tr as rehypeZonePivots,
+  qo as remarkHeadingIds,
   fe as removeHtmlComments,
-  Eo as sanitizePreTags,
+  Wo as sanitizePreTags,
   pe as serializeMdx,
-  pr as tableCellHandler,
-  mr as tableHandler,
-  ar as tableRowHandler,
-  u as useApiReference,
-  C as useComponents,
-  Ie as useCopyPathWithInputs,
-  Le as useInitializeInputs,
+  lr as tableCellHandler,
+  ir as tableHandler,
+  sr as tableRowHandler,
+  T as useApiReference,
+  c as useComponents,
+  Ne as useCopyPathWithInputs,
+  we as useInitializeInputs,
   E as useMarkdownCopy,
   Me as usePlaygroundInputsStore,
-  Oe as useSelectedSecurityOption,
-  Se as useSendPlaygroundRequest
+  Ie as useSelectedSecurityOption,
+  ke as useSendPlaygroundRequest
 };

package/dist/openapi/convertOpenApiSpecToHrefMap.js

@@ -0,0 +1,20 @@
+import { isOpenAPIV3orV31Document as b } from "@mintlify/validation";
+function w(t, r) {
+  if (!b(t))
+    throw new Error("Invalid OpenAPI document: must be OpenAPI 3.0 or 3.1");
+  const p = (r == null ? void 0 : r.baseHref) || "api-reference", a = {};
+  return t.paths && Object.entries(t.paths).forEach(([g, n]) => {
+    n && Object.entries(n).forEach(([o, s]) => {
+      if (!["get", "post", "put", "delete", "patch", "options", "head"].includes(o.toLowerCase()) || !s || typeof s != "object") return;
+      const e = s, c = e.summary || "", f = e.description, i = (e.tags && e.tags.length > 0 ? e.tags : ["General"])[0].toLowerCase().replace(/\s+/g, "-"), u = c.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, ""), l = `${p}/${i}/${u}`, h = `${g}/${o.toLowerCase()}`;
+      a[l] = {
+        path: h,
+        title: c,
+        ...f && { description: f }
+      };
+    });
+  }), a;
+}
+export {
+  w as convertOpenApiSpecToHrefMap
+};

package/dist/openapi/convertOpenApiSpecToNav.js

@@ -0,0 +1,44 @@
+import { isOpenAPIV3orV31Document as d } from "@mintlify/validation";
+function _(t) {
+  var p, f;
+  if (!d(t))
+    throw new Error("Invalid OpenAPI document: must be OpenAPI 3.0 or 3.1");
+  const a = [], r = {};
+  return t.paths && Object.entries(t.paths).forEach(([i, s]) => {
+    s && Object.entries(s).forEach(([e, c]) => {
+      if (!["get", "post", "put", "delete", "patch", "options", "head"].includes(e.toLowerCase()) || !c || typeof c != "object") return;
+      const o = c, h = o.summary || "", l = o.description;
+      (o.tags && o.tags.length > 0 ? o.tags : ["General"]).forEach((n) => {
+        r[n] || (r[n] = []);
+        const u = n.toLowerCase().replace(/\s+/g, "-"), m = h.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+        r[n].push({
+          toc_title: h,
+          description: l,
+          href: `${u}/${m}`,
+          method: e.toUpperCase(),
+          path: i
+        });
+      });
+    });
+  }), Object.entries(r).forEach(([i, s]) => {
+    a.push({
+      toc_title: i,
+      children: s.map((e) => ({
+        toc_title: e.toc_title,
+        description: e.description,
+        href: e.href,
+        method: e.method.toLowerCase()
+      }))
+    });
+  }), {
+    items: a,
+    metadata: {
+      generated_from: "openapi",
+      spec_title: ((p = t.info) == null ? void 0 : p.title) || "API Documentation",
+      spec_version: ((f = t.info) == null ? void 0 : f.version) || "1.0.0"
+    }
+  };
+}
+export {
+  _ as convertOpenApiSpecToNav
+};

package/dist/openapi/loadAndConvertOpenApiSpec.js

@@ -0,0 +1,14 @@
+import { isOpenAPIV3orV31Document as i, openApiToSchemaGraph as o } from "@mintlify/validation";
+function l(r, e) {
+  if (!i(r))
+    throw new Error("Invalid OpenAPI document: must be OpenAPI 3.0 or 3.1");
+  const n = JSON.parse(JSON.stringify(r)), a = (e == null ? void 0 : e.filename) ?? "openapi.json", c = (e == null ? void 0 : e.originalFileLocation) ?? a;
+  return o({
+    spec: n,
+    filename: a,
+    originalFileLocation: c
+  });
+}
+export {
+  l as convertOpenApiSpecToGraph
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/msft-sdk",
-  "version": "1.1.68",
+  "version": "1.1.69",
   "description": "Lightweight SDK for Microsoft documentation with MDX rendering",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -36,7 +36,10 @@
     "dev": "vite build --watch",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
-    "prepublishOnly": "npm run clean && npm run build"
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage"
   },
   "keywords": [
     "microsoft",