docusaurus-plugin-openapi-docs 0.0.0-1092 → 0.0.0-1093

package/lib/index.js

@@ -20,7 +20,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const json5_1 = __importDefault(require("json5"));
 const mustache_1 = require("mustache");
 const markdown_1 = require("./markdown");
-const externalizeJsonProps_1 = require("./markdown/externalizeJsonProps");
+const utils_2 = require("./markdown/utils");
 const openapi_1 = require("./openapi");
 const options_1 = require("./options");
 const sidebars_1 = __importDefault(require("./sidebars"));
@@ -239,8 +239,17 @@ custom_edit_url: null
                 if (downloadUrl) {
                     item.downloadUrl = downloadUrl;
                 }
-                const markdown = pageGeneratorByType[item.type](item);
-                item.markdown = markdown;
+                // Generate markdown, with externalization for API and schema pages
+                let externalFiles = [];
+                if (options.externalJsonProps &&
+                    (item.type === "api" || item.type === "schema")) {
+                    const result = (0, utils_2.runWithExternalization)(item.id, () => pageGeneratorByType[item.type](item));
+                    item.markdown = result.result;
+                    externalFiles = result.files;
+                }
+                else {
+                    item.markdown = pageGeneratorByType[item.type](item);
+                }
                 if (isSchemasOnly && item.type !== "schema") {
                     return;
                 }
@@ -282,23 +291,15 @@ custom_edit_url: null
                             if (item.id.length === 0) {
                                 throw Error("Operation must have summary or operationId defined");
                             }
-                            let finalView = view;
-                            let jsonFilesToWrite = [];
-                            // Externalize large JSON props if enabled
-                            if (options.externalJsonProps) {
-                                const result = (0, externalizeJsonProps_1.externalizeJsonPropsSimple)(view, item.id);
-                                finalView = result.mdx;
-                                jsonFilesToWrite = result.jsonFiles;
-                                // Write JSON files
-                                for (const jsonFile of jsonFilesToWrite) {
-                                    const jsonPath = `${outputDir}/${jsonFile.filename}`;
-                                    if (!fs_1.default.existsSync(jsonPath)) {
-                                        fs_1.default.writeFileSync(jsonPath, jsonFile.content, "utf8");
-                                        console.log(chalk_1.default.green(`Successfully created "${jsonPath}"`));
-                                    }
+                            // Write externalized JSON files
+                            for (const jsonFile of externalFiles) {
+                                const jsonPath = `${outputDir}/${jsonFile.filename}`;
+                                if (!fs_1.default.existsSync(jsonPath)) {
+                                    fs_1.default.writeFileSync(jsonPath, jsonFile.content, "utf8");
+                                    console.log(chalk_1.default.green(`Successfully created "${jsonPath}"`));
                                 }
                             }
-                            fs_1.default.writeFileSync(`${outputDir}/${item.id}.api.mdx`, finalView, "utf8");
+                            fs_1.default.writeFileSync(`${outputDir}/${item.id}.api.mdx`, view, "utf8");
                             console.log(chalk_1.default.green(`Successfully created "${outputDir}/${item.id}.api.mdx"`));
                         }
                         catch (err) {
@@ -347,20 +348,13 @@ custom_edit_url: null
                                 throw Error("Schema must have title defined");
                             }
                             // eslint-disable-next-line testing-library/render-result-naming-convention
-                            let schemaView = (0, mustache_1.render)(schemaMdTemplate, item);
-                            let jsonFilesToWrite = [];
-                            // Externalize large JSON props if enabled
-                            if (options.externalJsonProps) {
-                                const result = (0, externalizeJsonProps_1.externalizeJsonPropsSimple)(schemaView, item.id);
-                                schemaView = result.mdx;
-                                jsonFilesToWrite = result.jsonFiles;
-                                // Write JSON files in schemas directory
-                                for (const jsonFile of jsonFilesToWrite) {
-                                    const jsonPath = `${outputDir}/schemas/${jsonFile.filename}`;
-                                    if (!fs_1.default.existsSync(jsonPath)) {
-                                        fs_1.default.writeFileSync(jsonPath, jsonFile.content, "utf8");
-                                        console.log(chalk_1.default.green(`Successfully created "${jsonPath}"`));
-                                    }
+                            const schemaView = (0, mustache_1.render)(schemaMdTemplate, item);
+                            // Write externalized JSON files in schemas directory
+                            for (const jsonFile of externalFiles) {
+                                const jsonPath = `${outputDir}/schemas/${jsonFile.filename}`;
+                                if (!fs_1.default.existsSync(jsonPath)) {
+                                    fs_1.default.writeFileSync(jsonPath, jsonFile.content, "utf8");
+                                    console.log(chalk_1.default.green(`Successfully created "${jsonPath}"`));
                                 }
                             }
                             fs_1.default.writeFileSync(`${outputDir}/schemas/${item.id}.schema.mdx`, schemaView, "utf8");

package/lib/markdown/utils.d.ts

@@ -1,6 +1,38 @@
+/**
+ * Represents an external JSON file to be written alongside the MDX.
+ */
+export interface ExternalFile {
+    /** The filename for the JSON file (relative to outputDir) */
+    filename: string;
+    /** The JSON content to write */
+    content: string;
+}
+/**
+ * Result of running MDX generation with externalization.
+ */
+export interface ExternalizationResult<T> {
+    /** The result of the generation function */
+    result: T;
+    /** External JSON files to write */
+    files: ExternalFile[];
+}
+/**
+ * Runs a function with externalization enabled.
+ * Any calls to create() within the function will externalize eligible component props.
+ *
+ * @param baseFilename - Base filename for the MDX file (without extension)
+ * @param fn - Function to run with externalization enabled
+ * @returns The function result and any external files that were collected
+ *
+ * @example
+ * const { result: mdx, files } = runWithExternalization("add-pet", () => {
+ *   return createApiPageMD(item);
+ * });
+ */
+export declare function runWithExternalization<T>(baseFilename: string, fn: () => T): ExternalizationResult<T>;
 /**
  * Children in the plugin does not accept DOM elements, when compared with Children in the theme.
- * It is designed for rendering HTML a strings.
+ * It is designed for rendering HTML as strings.
  */
 export type Children = string | undefined | (string | string[] | undefined)[];
 export type Props = Record<string, any> & {
@@ -9,6 +41,11 @@ export type Props = Record<string, any> & {
 export type Options = {
     inline?: boolean;
 };
+/**
+ * Creates a JSX component string with the given tag, props, and options.
+ * When called within runWithExternalization(), props for eligible
+ * components are externalized to a single JSON file and spread.
+ */
 export declare function create(tag: string, props: Props, options?: Options): string;
 export declare function guard<T>(value: T | undefined, cb: (value: T) => Children): string;
 export declare function render(children: Children): string;

package/lib/markdown/utils.js

@@ -7,15 +7,82 @@
  * ========================================================================== */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.codeBlock = exports.curlyBrackets = exports.codeFence = exports.greaterThan = exports.lessThan = void 0;
+exports.runWithExternalization = runWithExternalization;
 exports.create = create;
 exports.guard = guard;
 exports.render = render;
 exports.clean = clean;
+/**
+ * Module-level externalization context.
+ * Note: AsyncLocalStorage would be cleaner but isn't available in browser bundles.
+ */
+let externalizationContext = null;
+/**
+ * Components whose props should be externalized to separate JSON files.
+ * These are the components that typically receive large JSON objects.
+ */
+const EXTERNALIZABLE_COMPONENTS = new Set([
+    "StatusCodes",
+    "ParamsDetails",
+    "RequestSchema",
+    "Schema",
+    "SchemaItem",
+]);
+/**
+ * Runs a function with externalization enabled.
+ * Any calls to create() within the function will externalize eligible component props.
+ *
+ * @param baseFilename - Base filename for the MDX file (without extension)
+ * @param fn - Function to run with externalization enabled
+ * @returns The function result and any external files that were collected
+ *
+ * @example
+ * const { result: mdx, files } = runWithExternalization("add-pet", () => {
+ *   return createApiPageMD(item);
+ * });
+ */
+function runWithExternalization(baseFilename, fn) {
+    // Set up context
+    externalizationContext = {
+        baseFilename,
+        componentCounters: {},
+        files: [],
+    };
+    try {
+        const result = fn();
+        const files = externalizationContext.files;
+        return { result, files };
+    }
+    finally {
+        // Always clear context
+        externalizationContext = null;
+    }
+}
+/**
+ * Creates a JSX component string with the given tag, props, and options.
+ * When called within runWithExternalization(), props for eligible
+ * components are externalized to a single JSON file and spread.
+ */
 function create(tag, props, options = {}) {
     const { children, ...rest } = props;
     let propString = "";
-    for (const [key, value] of Object.entries(rest)) {
-        propString += `\n  ${key}={${JSON.stringify(value)}}`;
+    // Check if this component's props should be externalized
+    if (shouldExternalizeComponent(tag, rest)) {
+        const filename = generateExternalFilename(tag);
+        const content = JSON.stringify(rest);
+        // Add to external files
+        externalizationContext.files.push({
+            filename,
+            content,
+        });
+        // Use spread syntax with require
+        propString = `\n  {...require("./${filename}")}`;
+    }
+    else {
+        // Inline props as usual
+        for (const [key, value] of Object.entries(rest)) {
+            propString += `\n  ${key}={${JSON.stringify(value)}}`;
+        }
     }
     let indentedChildren = render(children).replace(/^/gm, "  ");
     if (options.inline) {
@@ -26,6 +93,37 @@ function create(tag, props, options = {}) {
     indentedChildren += indentedChildren ? "\n" : "";
     return `<${tag}${propString}>\n${indentedChildren}</${tag}>`;
 }
+/**
+ * Determines if a component's props should be externalized.
+ */
+function shouldExternalizeComponent(tag, props) {
+    // No context means externalization is not enabled
+    if (!externalizationContext) {
+        return false;
+    }
+    if (!EXTERNALIZABLE_COMPONENTS.has(tag)) {
+        return false;
+    }
+    // Don't externalize if props are empty or only contain undefined/null
+    const hasContent = Object.values(props).some((v) => v !== undefined && v !== null);
+    if (!hasContent) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Generates a unique filename for an externalized component's props.
+ */
+function generateExternalFilename(componentName) {
+    var _a;
+    if (!externalizationContext) {
+        throw new Error("Externalization context not set");
+    }
+    const count = ((_a = externalizationContext.componentCounters[componentName]) !== null && _a !== void 0 ? _a : 0) + 1;
+    externalizationContext.componentCounters[componentName] = count;
+    const suffix = count > 1 ? `.${count}` : "";
+    return `${externalizationContext.baseFilename}.${componentName}${suffix}.json`;
+}
 function guard(value, cb) {
     if (!!value || value === 0) {
         const children = cb(value);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docusaurus-plugin-openapi-docs",
   "description": "OpenAPI plugin for Docusaurus.",
-  "version": "0.0.0-1092",
+  "version": "0.0.0-1093",
   "license": "MIT",
   "keywords": [
     "openapi",
@@ -65,5 +65,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "52285283e2fc0ee02b7f5e42a9678a3bb89c095b"
+  "gitHead": "25ec109b85febce944f00689f6985a89886280ae"
 }

package/src/index.ts

@@ -21,10 +21,7 @@ import {
   createSchemaPageMD,
   createTagPageMD,
 } from "./markdown";
-import {
-  externalizeJsonPropsSimple,
-  ExternalizedJsonFile,
-} from "./markdown/externalizeJsonProps";
+import { ExternalFile, runWithExternalization } from "./markdown/utils";
 import { processOpenapiFiles, readOpenapiFiles } from "./openapi";
 import { OptionsSchema } from "./options";
 import generateSidebarSlice from "./sidebars";
@@ -337,8 +334,21 @@ custom_edit_url: null
         if (downloadUrl) {
           item.downloadUrl = downloadUrl;
         }
-        const markdown = pageGeneratorByType[item.type](item as any);
-        item.markdown = markdown;
+
+        // Generate markdown, with externalization for API and schema pages
+        let externalFiles: ExternalFile[] = [];
+        if (
+          options.externalJsonProps &&
+          (item.type === "api" || item.type === "schema")
+        ) {
+          const result = runWithExternalization(item.id, () =>
+            pageGeneratorByType[item.type](item as any)
+          );
+          item.markdown = result.result;
+          externalFiles = result.files;
+        } else {
+          item.markdown = pageGeneratorByType[item.type](item as any);
+        }
         if (isSchemasOnly && item.type !== "schema") {
           return;
         }
@@ -388,32 +398,18 @@ custom_edit_url: null
                 );
               }
 
-              let finalView = view;
-              let jsonFilesToWrite: ExternalizedJsonFile[] = [];
-
-              // Externalize large JSON props if enabled
-              if (options.externalJsonProps) {
-                const result = externalizeJsonPropsSimple(view, item.id);
-                finalView = result.mdx;
-                jsonFilesToWrite = result.jsonFiles;
-
-                // Write JSON files
-                for (const jsonFile of jsonFilesToWrite) {
-                  const jsonPath = `${outputDir}/${jsonFile.filename}`;
-                  if (!fs.existsSync(jsonPath)) {
-                    fs.writeFileSync(jsonPath, jsonFile.content, "utf8");
-                    console.log(
-                      chalk.green(`Successfully created "${jsonPath}"`)
-                    );
-                  }
+              // Write externalized JSON files
+              for (const jsonFile of externalFiles) {
+                const jsonPath = `${outputDir}/${jsonFile.filename}`;
+                if (!fs.existsSync(jsonPath)) {
+                  fs.writeFileSync(jsonPath, jsonFile.content, "utf8");
+                  console.log(
+                    chalk.green(`Successfully created "${jsonPath}"`)
+                  );
                 }
               }
 
-              fs.writeFileSync(
-                `${outputDir}/${item.id}.api.mdx`,
-                finalView,
-                "utf8"
-              );
+              fs.writeFileSync(`${outputDir}/${item.id}.api.mdx`, view, "utf8");
               console.log(
                 chalk.green(
                   `Successfully created "${outputDir}/${item.id}.api.mdx"`
@@ -499,24 +495,16 @@ custom_edit_url: null
                 throw Error("Schema must have title defined");
               }
               // eslint-disable-next-line testing-library/render-result-naming-convention
-              let schemaView = render(schemaMdTemplate, item);
-              let jsonFilesToWrite: ExternalizedJsonFile[] = [];
-
-              // Externalize large JSON props if enabled
-              if (options.externalJsonProps) {
-                const result = externalizeJsonPropsSimple(schemaView, item.id);
-                schemaView = result.mdx;
-                jsonFilesToWrite = result.jsonFiles;
-
-                // Write JSON files in schemas directory
-                for (const jsonFile of jsonFilesToWrite) {
-                  const jsonPath = `${outputDir}/schemas/${jsonFile.filename}`;
-                  if (!fs.existsSync(jsonPath)) {
-                    fs.writeFileSync(jsonPath, jsonFile.content, "utf8");
-                    console.log(
-                      chalk.green(`Successfully created "${jsonPath}"`)
-                    );
-                  }
+              const schemaView = render(schemaMdTemplate, item);
+
+              // Write externalized JSON files in schemas directory
+              for (const jsonFile of externalFiles) {
+                const jsonPath = `${outputDir}/schemas/${jsonFile.filename}`;
+                if (!fs.existsSync(jsonPath)) {
+                  fs.writeFileSync(jsonPath, jsonFile.content, "utf8");
+                  console.log(
+                    chalk.green(`Successfully created "${jsonPath}"`)
+                  );
                 }
               }
 

package/src/markdown/utils.ts

@@ -5,9 +5,93 @@
  * LICENSE file in the root directory of this source tree.
  * ========================================================================== */
 
+/**
+ * Represents an external JSON file to be written alongside the MDX.
+ */
+export interface ExternalFile {
+  /** The filename for the JSON file (relative to outputDir) */
+  filename: string;
+  /** The JSON content to write */
+  content: string;
+}
+
+/**
+ * Result of running MDX generation with externalization.
+ */
+export interface ExternalizationResult<T> {
+  /** The result of the generation function */
+  result: T;
+  /** External JSON files to write */
+  files: ExternalFile[];
+}
+
+/**
+ * Context for externalization during MDX generation.
+ */
+interface ExternalizationContext {
+  /** Base filename for external files (e.g., "add-pet" for "add-pet.api.mdx") */
+  baseFilename: string;
+  /** Counter for generating unique filenames per component type */
+  componentCounters: Record<string, number>;
+  /** Collected external files during generation */
+  files: ExternalFile[];
+}
+
+/**
+ * Module-level externalization context.
+ * Note: AsyncLocalStorage would be cleaner but isn't available in browser bundles.
+ */
+let externalizationContext: ExternalizationContext | null = null;
+
+/**
+ * Components whose props should be externalized to separate JSON files.
+ * These are the components that typically receive large JSON objects.
+ */
+const EXTERNALIZABLE_COMPONENTS = new Set([
+  "StatusCodes",
+  "ParamsDetails",
+  "RequestSchema",
+  "Schema",
+  "SchemaItem",
+]);
+
+/**
+ * Runs a function with externalization enabled.
+ * Any calls to create() within the function will externalize eligible component props.
+ *
+ * @param baseFilename - Base filename for the MDX file (without extension)
+ * @param fn - Function to run with externalization enabled
+ * @returns The function result and any external files that were collected
+ *
+ * @example
+ * const { result: mdx, files } = runWithExternalization("add-pet", () => {
+ *   return createApiPageMD(item);
+ * });
+ */
+export function runWithExternalization<T>(
+  baseFilename: string,
+  fn: () => T
+): ExternalizationResult<T> {
+  // Set up context
+  externalizationContext = {
+    baseFilename,
+    componentCounters: {},
+    files: [],
+  };
+
+  try {
+    const result = fn();
+    const files = externalizationContext.files;
+    return { result, files };
+  } finally {
+    // Always clear context
+    externalizationContext = null;
+  }
+}
+
 /**
  * Children in the plugin does not accept DOM elements, when compared with Children in the theme.
- * It is designed for rendering HTML a strings.
+ * It is designed for rendering HTML as strings.
  */
 export type Children = string | undefined | (string | string[] | undefined)[];
 
@@ -15,6 +99,11 @@ export type Props = Record<string, any> & { children?: Children };
 
 export type Options = { inline?: boolean };
 
+/**
+ * Creates a JSX component string with the given tag, props, and options.
+ * When called within runWithExternalization(), props for eligible
+ * components are externalized to a single JSON file and spread.
+ */
 export function create(
   tag: string,
   props: Props,
@@ -23,9 +112,27 @@ export function create(
   const { children, ...rest } = props;
 
   let propString = "";
-  for (const [key, value] of Object.entries(rest)) {
-    propString += `\n  ${key}={${JSON.stringify(value)}}`;
+
+  // Check if this component's props should be externalized
+  if (shouldExternalizeComponent(tag, rest)) {
+    const filename = generateExternalFilename(tag);
+    const content = JSON.stringify(rest);
+
+    // Add to external files
+    externalizationContext!.files.push({
+      filename,
+      content,
+    });
+
+    // Use spread syntax with require
+    propString = `\n  {...require("./${filename}")}`;
+  } else {
+    // Inline props as usual
+    for (const [key, value] of Object.entries(rest)) {
+      propString += `\n  ${key}={${JSON.stringify(value)}}`;
+    }
   }
+
   let indentedChildren = render(children).replace(/^/gm, "  ");
 
   if (options.inline) {
@@ -38,6 +145,49 @@ export function create(
   return `<${tag}${propString}>\n${indentedChildren}</${tag}>`;
 }
 
+/**
+ * Determines if a component's props should be externalized.
+ */
+function shouldExternalizeComponent(
+  tag: string,
+  props: Record<string, any>
+): boolean {
+  // No context means externalization is not enabled
+  if (!externalizationContext) {
+    return false;
+  }
+
+  if (!EXTERNALIZABLE_COMPONENTS.has(tag)) {
+    return false;
+  }
+
+  // Don't externalize if props are empty or only contain undefined/null
+  const hasContent = Object.values(props).some(
+    (v) => v !== undefined && v !== null
+  );
+  if (!hasContent) {
+    return false;
+  }
+
+  return true;
+}
+
+/**
+ * Generates a unique filename for an externalized component's props.
+ */
+function generateExternalFilename(componentName: string): string {
+  if (!externalizationContext) {
+    throw new Error("Externalization context not set");
+  }
+
+  const count =
+    (externalizationContext.componentCounters[componentName] ?? 0) + 1;
+  externalizationContext.componentCounters[componentName] = count;
+
+  const suffix = count > 1 ? `.${count}` : "";
+  return `${externalizationContext.baseFilename}.${componentName}${suffix}.json`;
+}
+
 export function guard<T>(
   value: T | undefined,
   cb: (value: T) => Children

package/lib/markdown/externalizeJsonProps.d.ts

@@ -1,31 +0,0 @@
-/**
- * This module provides utilities for externalizing large JSON props in MDX files.
- *
- * The motivation is to improve MDX compilation performance. When large JSON objects
- * are embedded directly as JSX props, MDX needs to parse them into AST and then
- * serialize them back. By externalizing to JSON files and using require(), the
- * MDX compiler can skip this expensive processing.
- *
- * @see https://github.com/facebook/docusaurus/discussions/11664
- */
-export interface ExternalizedJsonFile {
-    /** The filename for the JSON file (without path) */
-    filename: string;
-    /** The JSON content to write */
-    content: string;
-}
-export interface ExternalizeResult {
-    /** The transformed MDX content with require() statements */
-    mdx: string;
-    /** List of JSON files that need to be written */
-    jsonFiles: ExternalizedJsonFile[];
-}
-/**
- * Externalizes large JSON props from MDX content.
- * Uses brace-counting to correctly handle deeply nested JSON.
- *
- * @param mdx - The original MDX content
- * @param baseFilename - The base filename (without extension) for the MDX file
- * @returns The transformed MDX and list of JSON files to write
- */
-export declare function externalizeJsonPropsSimple(mdx: string, baseFilename: string): ExternalizeResult;

package/lib/markdown/externalizeJsonProps.js

@@ -1,149 +0,0 @@
-"use strict";
-/* ============================================================================
- * Copyright (c) Palo Alto Networks
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- * ========================================================================== */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.externalizeJsonPropsSimple = externalizeJsonPropsSimple;
-/**
- * Components and their props that should be externalized.
- * These are the components that typically receive large JSON objects.
- */
-const COMPONENTS_TO_EXTERNALIZE = [
-    { component: "StatusCodes", prop: "responses" },
-    { component: "ParamsDetails", prop: "parameters" },
-    { component: "RequestSchema", prop: "body" },
-    { component: "Schema", prop: "schema" },
-    { component: "SchemaItem", prop: "schema" },
-];
-/**
- * Minimum size (in characters) for a JSON prop to be externalized.
- * Props smaller than this threshold will remain inline.
- */
-const MIN_SIZE_THRESHOLD = 500;
-/**
- * Extracts the content between balanced braces starting at a given position.
- * Returns the content (without outer braces) and the end position.
- */
-function extractBalancedBraces(str, startIndex) {
-    if (str[startIndex] !== "{") {
-        return null;
-    }
-    let depth = 0;
-    let inString = false;
-    let stringChar = "";
-    let escaped = false;
-    for (let i = startIndex; i < str.length; i++) {
-        const char = str[i];
-        if (escaped) {
-            escaped = false;
-            continue;
-        }
-        if (char === "\\") {
-            escaped = true;
-            continue;
-        }
-        if (!inString) {
-            if (char === '"' || char === "'") {
-                inString = true;
-                stringChar = char;
-            }
-            else if (char === "{") {
-                depth++;
-            }
-            else if (char === "}") {
-                depth--;
-                if (depth === 0) {
-                    // Found the matching closing brace
-                    return {
-                        content: str.substring(startIndex + 1, i),
-                        endIndex: i,
-                    };
-                }
-            }
-        }
-        else {
-            if (char === stringChar) {
-                inString = false;
-            }
-        }
-    }
-    return null; // Unbalanced braces
-}
-/**
- * Externalizes large JSON props from MDX content.
- * Uses brace-counting to correctly handle deeply nested JSON.
- *
- * @param mdx - The original MDX content
- * @param baseFilename - The base filename (without extension) for the MDX file
- * @returns The transformed MDX and list of JSON files to write
- */
-function externalizeJsonPropsSimple(mdx, baseFilename) {
-    const jsonFiles = [];
-    let transformedMdx = mdx;
-    for (const { component, prop } of COMPONENTS_TO_EXTERNALIZE) {
-        // Find pattern: prop={
-        const propPattern = new RegExp(`${prop}=\\{`, "g");
-        let match;
-        // Keep searching until no more matches (need to restart after each replacement)
-        let searchStart = 0;
-        while (true) {
-            propPattern.lastIndex = searchStart;
-            match = propPattern.exec(transformedMdx);
-            if (!match)
-                break;
-            const propStart = match.index;
-            const braceStart = propStart + prop.length + 1; // Position of '{'
-            // Extract the balanced content
-            const extracted = extractBalancedBraces(transformedMdx, braceStart);
-            if (!extracted) {
-                searchStart = braceStart + 1;
-                continue;
-            }
-            const jsonContent = extracted.content;
-            const propEnd = extracted.endIndex + 1; // Position after '}'
-            // Skip small or non-JSON content
-            const trimmed = jsonContent.trim();
-            if (jsonContent.length < MIN_SIZE_THRESHOLD ||
-                trimmed === "undefined" ||
-                trimmed === "null" ||
-                trimmed === "true" ||
-                trimmed === "false" ||
-                trimmed.startsWith("require(")) {
-                searchStart = propEnd;
-                continue;
-            }
-            // Check if this is within the target component
-            // Look backwards for the component tag
-            const beforeProp = transformedMdx.substring(0, propStart);
-            const componentTagPattern = new RegExp(`<${component}[\\s\\S]*$`);
-            if (!componentTagPattern.test(beforeProp)) {
-                searchStart = propEnd;
-                continue;
-            }
-            // Generate filename
-            const existingCount = jsonFiles.filter((f) => f.filename.includes(`.${prop}`)).length;
-            const suffix = existingCount > 0 ? `.${existingCount + 1}` : "";
-            const jsonFilename = `${baseFilename}.${prop}${suffix}.json`;
-            // Store the JSON file
-            jsonFiles.push({
-                filename: jsonFilename,
-                content: jsonContent.trim(),
-            });
-            // Replace the prop value with require()
-            const newProp = `${prop}={require("./${jsonFilename}")}`;
-            transformedMdx =
-                transformedMdx.substring(0, propStart) +
-                    newProp +
-                    transformedMdx.substring(propEnd);
-            // Continue searching after the replacement
-            searchStart = propStart + newProp.length;
-        }
-    }
-    return {
-        mdx: transformedMdx,
-        jsonFiles,
-    };
-}

package/src/markdown/externalizeJsonProps.ts

@@ -1,201 +0,0 @@
-/* ============================================================================
- * Copyright (c) Palo Alto Networks
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- * ========================================================================== */
-
-/**
- * This module provides utilities for externalizing large JSON props in MDX files.
- *
- * The motivation is to improve MDX compilation performance. When large JSON objects
- * are embedded directly as JSX props, MDX needs to parse them into AST and then
- * serialize them back. By externalizing to JSON files and using require(), the
- * MDX compiler can skip this expensive processing.
- *
- * @see https://github.com/facebook/docusaurus/discussions/11664
- */
-
-export interface ExternalizedJsonFile {
-  /** The filename for the JSON file (without path) */
-  filename: string;
-  /** The JSON content to write */
-  content: string;
-}
-
-export interface ExternalizeResult {
-  /** The transformed MDX content with require() statements */
-  mdx: string;
-  /** List of JSON files that need to be written */
-  jsonFiles: ExternalizedJsonFile[];
-}
-
-/**
- * Components and their props that should be externalized.
- * These are the components that typically receive large JSON objects.
- */
-const COMPONENTS_TO_EXTERNALIZE = [
-  { component: "StatusCodes", prop: "responses" },
-  { component: "ParamsDetails", prop: "parameters" },
-  { component: "RequestSchema", prop: "body" },
-  { component: "Schema", prop: "schema" },
-  { component: "SchemaItem", prop: "schema" },
-];
-
-/**
- * Minimum size (in characters) for a JSON prop to be externalized.
- * Props smaller than this threshold will remain inline.
- */
-const MIN_SIZE_THRESHOLD = 500;
-
-/**
- * Extracts the content between balanced braces starting at a given position.
- * Returns the content (without outer braces) and the end position.
- */
-function extractBalancedBraces(
-  str: string,
-  startIndex: number
-): { content: string; endIndex: number } | null {
-  if (str[startIndex] !== "{") {
-    return null;
-  }
-
-  let depth = 0;
-  let inString = false;
-  let stringChar = "";
-  let escaped = false;
-
-  for (let i = startIndex; i < str.length; i++) {
-    const char = str[i];
-
-    if (escaped) {
-      escaped = false;
-      continue;
-    }
-
-    if (char === "\\") {
-      escaped = true;
-      continue;
-    }
-
-    if (!inString) {
-      if (char === '"' || char === "'") {
-        inString = true;
-        stringChar = char;
-      } else if (char === "{") {
-        depth++;
-      } else if (char === "}") {
-        depth--;
-        if (depth === 0) {
-          // Found the matching closing brace
-          return {
-            content: str.substring(startIndex + 1, i),
-            endIndex: i,
-          };
-        }
-      }
-    } else {
-      if (char === stringChar) {
-        inString = false;
-      }
-    }
-  }
-
-  return null; // Unbalanced braces
-}
-
-/**
- * Externalizes large JSON props from MDX content.
- * Uses brace-counting to correctly handle deeply nested JSON.
- *
- * @param mdx - The original MDX content
- * @param baseFilename - The base filename (without extension) for the MDX file
- * @returns The transformed MDX and list of JSON files to write
- */
-export function externalizeJsonPropsSimple(
-  mdx: string,
-  baseFilename: string
-): ExternalizeResult {
-  const jsonFiles: ExternalizedJsonFile[] = [];
-  let transformedMdx = mdx;
-
-  for (const { component, prop } of COMPONENTS_TO_EXTERNALIZE) {
-    // Find pattern: prop={
-    const propPattern = new RegExp(`${prop}=\\{`, "g");
-    let match;
-
-    // Keep searching until no more matches (need to restart after each replacement)
-    let searchStart = 0;
-    while (true) {
-      propPattern.lastIndex = searchStart;
-      match = propPattern.exec(transformedMdx);
-
-      if (!match) break;
-
-      const propStart = match.index;
-      const braceStart = propStart + prop.length + 1; // Position of '{'
-
-      // Extract the balanced content
-      const extracted = extractBalancedBraces(transformedMdx, braceStart);
-      if (!extracted) {
-        searchStart = braceStart + 1;
-        continue;
-      }
-
-      const jsonContent = extracted.content;
-      const propEnd = extracted.endIndex + 1; // Position after '}'
-
-      // Skip small or non-JSON content
-      const trimmed = jsonContent.trim();
-      if (
-        jsonContent.length < MIN_SIZE_THRESHOLD ||
-        trimmed === "undefined" ||
-        trimmed === "null" ||
-        trimmed === "true" ||
-        trimmed === "false" ||
-        trimmed.startsWith("require(")
-      ) {
-        searchStart = propEnd;
-        continue;
-      }
-
-      // Check if this is within the target component
-      // Look backwards for the component tag
-      const beforeProp = transformedMdx.substring(0, propStart);
-      const componentTagPattern = new RegExp(`<${component}[\\s\\S]*$`);
-      if (!componentTagPattern.test(beforeProp)) {
-        searchStart = propEnd;
-        continue;
-      }
-
-      // Generate filename
-      const existingCount = jsonFiles.filter((f) =>
-        f.filename.includes(`.${prop}`)
-      ).length;
-      const suffix = existingCount > 0 ? `.${existingCount + 1}` : "";
-      const jsonFilename = `${baseFilename}.${prop}${suffix}.json`;
-
-      // Store the JSON file
-      jsonFiles.push({
-        filename: jsonFilename,
-        content: jsonContent.trim(),
-      });
-
-      // Replace the prop value with require()
-      const newProp = `${prop}={require("./${jsonFilename}")}`;
-
-      transformedMdx =
-        transformedMdx.substring(0, propStart) +
-        newProp +
-        transformedMdx.substring(propEnd);
-
-      // Continue searching after the replacement
-      searchStart = propStart + newProp.length;
-    }
-  }
-
-  return {
-    mdx: transformedMdx,
-    jsonFiles,
-  };
-}