@mintlify/scraping 4.0.327 → 4.0.329

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/scraping",
-  "version": "4.0.327",
+  "version": "4.0.329",
   "description": "Scrape documentation frameworks to Mintlify docs",
   "engines": {
     "node": ">=18.0.0"
@@ -38,7 +38,7 @@
     "format:check": "prettier . --check"
   },
   "dependencies": {
-    "@mintlify/common": "1.0.471",
+    "@mintlify/common": "1.0.472",
     "@mintlify/openapi-parser": "^0.0.7",
     "fs-extra": "^11.1.1",
     "hast-util-to-mdast": "^10.1.0",
@@ -61,7 +61,7 @@
     "@mintlify/models": "0.0.216",
     "@mintlify/prettier-config": "1.0.4",
     "@mintlify/ts-config": "2.0.2",
-    "@mintlify/validation": "0.1.431",
+    "@mintlify/validation": "0.1.432",
     "@trivago/prettier-plugin-sort-imports": "^4.2.1",
     "@tsconfig/recommended": "1.x",
     "@types/hast": "^3.0.4",
@@ -77,5 +77,5 @@
     "typescript": "^5.5.3",
     "vitest": "^2.0.4"
   },
-  "gitHead": "020d9ebcbfe590f2cd2bce472dea0a5f27f8dbbf"
+  "gitHead": "a3394aaa3205b5b336d2a01a346659bc0b0112c7"
 }

package/src/openapi/common.ts

@@ -21,6 +21,7 @@ import {
   generateUniqueFilenameWithoutExtension,
 } from '../apiPages/common.js';
 import { fetchOpenApi } from '../utils/network.js';
+import { registerXMintContent } from './contentRegistry.js';
 
 export type OpenApiExtensions = {
   'x-mint'?: XMint;
@@ -202,12 +203,13 @@ export function processOpenApiPath<N, DN>(
         openapiMetaTag
       );
       const page: DecoratedNavigationPage = {
-        openapi: openapiMetaTag,
-        href: resolve('/', filenameWithoutExtension),
-        title: xMint?.metadata?.title ?? titleTag ?? slugToTitle(filenameWithoutExtension),
-        description: xMint?.metadata?.description ?? description,
+        title: titleTag ?? slugToTitle(filenameWithoutExtension),
+        description,
         deprecated: operation?.deprecated,
         version: options.version,
+        ...xMint?.metadata,
+        openapi: openapiMetaTag,
+        href: resolve('/', filenameWithoutExtension),
       };
 
       if (!isHiddenOperation(operation as MaybeOperationObjectWithExtensions)) {
@@ -216,6 +218,10 @@ export function processOpenApiPath<N, DN>(
       }
       pagesAcc[filenameWithoutExtension] = page;
 
+      if (!options.writeFiles) {
+        registerXMintContent(filenameWithoutExtension, xMint?.content);
+      }
+
       const targetPath = options.outDirBasePath
         ? join(options.outDirBasePath, `${filenameWithoutExtension}.mdx`)
         : `${filenameWithoutExtension}.mdx`;
@@ -288,15 +294,14 @@ export function processOpenApiWebhook<N, DN>(
         path: webhook,
       });
 
-      const description = xMint?.metadata?.description ?? operation?.description;
-
       const page: DecoratedNavigationPage = {
-        openapi: openapiMetaTag,
-        href: resolve('/', filenameWithoutExtension),
-        title: xMint?.metadata?.title ?? slugToTitle(filenameWithoutExtension),
-        description,
+        title: slugToTitle(filenameWithoutExtension),
+        description: operation?.description,
         version: options.version,
         deprecated: operation?.deprecated,
+        ...xMint?.metadata,
+        openapi: openapiMetaTag,
+        href: resolve('/', filenameWithoutExtension),
       };
 
       if (!isHiddenOperation(operation as MaybeOperationObjectWithExtensions)) {
@@ -304,6 +309,11 @@ export function processOpenApiWebhook<N, DN>(
         decoratedNavGroup.push(page);
       }
       pagesAcc[filenameWithoutExtension] = page;
+
+      if (!options.writeFiles) {
+        registerXMintContent(filenameWithoutExtension, xMint?.content);
+      }
+
       const targetPath = options.outDirBasePath
         ? join(options.outDirBasePath, `${filenameWithoutExtension}.mdx`)
         : `${filenameWithoutExtension}.mdx`;

package/src/openapi/contentRegistry.ts

@@ -0,0 +1,13 @@
+const registry = new Map<string, string>();
+
+export function registerXMintContent(slug: string, content?: string) {
+  if (content) registry.set(slug, content);
+}
+
+export function getXMintContent(slug: string): string | undefined {
+  return registry.get(slug);
+}
+
+export function getAllXMintContent(): Map<string, string> {
+  return new Map(registry);
+}