@rspress/plugin-api-docgen 1.37.2 → 1.37.3

package/dist/index.d.ts

@@ -1,63 +1,68 @@
-import { RspressPlugin } from '@rspress/shared';
-import { ParserOptions } from 'react-docgen-typescript';
-import { CompilerOptions } from 'typescript';
-
-type Entries = Record<string, string>;
-type ToolEntries = {
-    documentation: Entries;
-    'react-docgen-typescript': Entries;
-};
-type ApiParseTool = 'documentation' | 'react-docgen-typescript';
-type DocumentationArgs = {
-    external?: Array<string>;
-    shallow?: boolean;
-    order?: Array<unknown>;
-    access?: Array<string>;
-    hljs?: {
-        highlightAuto?: boolean;
-        languages?: string;
-    };
-    inferPrivate?: string;
-    extension?: string | Array<string>;
-    noReferenceLinks?: boolean;
-};
-type ParseToolOptions = {
-    'react-docgen-typescript'?: ParserOptions & {
-        tsconfigPath?: Record<string, string>;
-        compilerOptions?: Record<string, CompilerOptions>;
-    };
-    documentation?: DocumentationArgs;
-};
-type PluginOptions = {
-    /**
-     * Module entries
-     * @zh 传入自动生成文档的模块名称及相对路径
-     */
-    entries?: Entries | ToolEntries;
-    /**
-     * apiParseTool
-     * @experimental
-     * @zh 解析工具
-     * @default 'react-docgen-typescript'
-     */
-    apiParseTool?: ApiParseTool;
-    /**
-     * parserToolOptions
-     * @experimental
-     * @zh 解析器参数
-     */
-    parseToolOptions?: ParseToolOptions;
-    /**
-     * appDirectory
-     * @zh 项目根目录
-     * @default process.cwd()
-     */
-    appDir?: string;
-};
-
-/**
- * The plugin is used to generate api doc for files.
- */
-declare function pluginApiDocgen(options?: PluginOptions): RspressPlugin;
-
-export { type PluginOptions, pluginApiDocgen };
+import type { CompilerOptions } from 'typescript';
+import type { ParserOptions } from 'react-docgen-typescript';
+import type { RspressPlugin } from '@rspress/shared';
+
+declare type ApiParseTool = 'documentation' | 'react-docgen-typescript';
+
+declare type DocumentationArgs = {
+    external?: Array<string>;
+    shallow?: boolean;
+    order?: Array<unknown>;
+    access?: Array<string>;
+    hljs?: {
+        highlightAuto?: boolean;
+        languages?: string;
+    };
+    inferPrivate?: string;
+    extension?: string | Array<string>;
+    noReferenceLinks?: boolean;
+};
+
+declare type Entries = Record<string, string>;
+
+declare type ParseToolOptions = {
+    'react-docgen-typescript'?: ParserOptions & {
+        tsconfigPath?: Record<string, string>;
+        compilerOptions?: Record<string, CompilerOptions>;
+    };
+    documentation?: DocumentationArgs;
+};
+
+/**
+ * The plugin is used to generate api doc for files.
+ */
+export declare function pluginApiDocgen(options?: PluginOptions): RspressPlugin;
+
+export declare type PluginOptions = {
+    /**
+     * Module entries
+     * @zh 传入自动生成文档的模块名称及相对路径
+     */
+    entries?: Entries | ToolEntries;
+    /**
+     * apiParseTool
+     * @experimental
+     * @zh 解析工具
+     * @default 'react-docgen-typescript'
+     */
+    apiParseTool?: ApiParseTool;
+    /**
+     * parserToolOptions
+     * @experimental
+     * @zh 解析器参数
+     */
+    parseToolOptions?: ParseToolOptions;
+    /**
+     * appDirectory
+     * @zh 项目根目录
+     * @default process.cwd()
+     */
+    appDir?: string;
+};
+
+declare type ToolEntries = {
+    documentation: Entries;
+    'react-docgen-typescript': Entries;
+};
+
+export { }

package/dist/index.js

@@ -1,335 +1,322 @@
 "use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
+var __webpack_modules__ = {
+    documentation: function(module) {
+        module.exports = import("documentation");
+    }
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  pluginApiDocgen: () => pluginApiDocgen
+/************************************************************************/ // The module cache
+var __webpack_module_cache__ = {};
+// The require function
+function __webpack_require__(moduleId) {
+    // Check if module is in cache
+    var cachedModule = __webpack_module_cache__[moduleId];
+    if (void 0 !== cachedModule) return cachedModule.exports;
+    // Create a new module (and put it into the cache)
+    var module = __webpack_module_cache__[moduleId] = {
+        exports: {}
+    };
+    // Execute the module function
+    __webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+    // Return the exports of the module
+    return module.exports;
+}
+/************************************************************************/ // webpack/runtime/compat_get_default_export
+(()=>{
+    // getDefaultExport function for compatibility with non-ESM modules
+    __webpack_require__.n = function(module) {
+        var getter = module && module.__esModule ? function() {
+            return module['default'];
+        } : function() {
+            return module;
+        };
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+// webpack/runtime/define_property_getters
+(()=>{
+    __webpack_require__.d = function(exports1, definition) {
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+// webpack/runtime/has_own_property
+(()=>{
+    __webpack_require__.o = function(obj, prop) {
+        return Object.prototype.hasOwnProperty.call(obj, prop);
+    };
+})();
+// webpack/runtime/make_namespace_object
+(()=>{
+    // define __esModule on exports
+    __webpack_require__.r = function(exports1) {
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+/************************************************************************/ var __webpack_exports__ = {};
+// ESM COMPAT FLAG
+__webpack_require__.r(__webpack_exports__);
+// EXPORTS
+__webpack_require__.d(__webpack_exports__, {
+    pluginApiDocgen: ()=>/* binding */ pluginApiDocgen
 });
-module.exports = __toCommonJS(src_exports);
-var import_node_path3 = __toESM(require("path"));
-var import_node_fs2 = __toESM(require("fs"));
-
-// src/docgen.ts
-var import_node_path2 = __toESM(require("path"));
-var import_node_fs = __toESM(require("fs"));
-var import_logger = require("@rspress/shared/logger");
-var import_chokidar = __toESM(require("chokidar"));
-var import_react_docgen_typescript = require("react-docgen-typescript");
-var import_shared = require("@rspress/shared");
-
-// src/constants.ts
-var import_node_path = __toESM(require("path"));
-var PACKAGE_ROOT = import_node_path.default.join(__dirname, "..");
-var apiDocMap = {};
-
-// src/locales.ts
-var locales = {
-  zh: {
-    copy: "复制",
-    copied: "复制成功",
-    expand: "展开代码",
-    collapse: "收起代码",
-    className: "节点类名",
-    style: "节点样式",
-    children: "子节点",
-    disabled: "是否禁用",
-    required: "必填",
-    property: "属性",
-    description: "说明",
-    type: "类型",
-    defaultValue: "默认值",
-    overview: "概览"
-  },
-  en: {
-    copy: "Copy",
-    copied: "Copied Success!",
-    expand: "Expand Code",
-    collapse: "Collapse Code",
-    className: "Additional css class",
-    style: "Additional style",
-    children: "Children",
-    disabled: "Whether to disable ",
-    required: "Required",
-    property: "Property",
-    description: "Description",
-    type: "Type",
-    defaultValue: "Default Value",
-    overview: "Overview"
-  }
-};
-
-// src/docgen.ts
-var isToolEntries = (obj) => {
-  return obj.documentation || obj["react-docgen-typescript"];
-};
-var docgen = async ({
-  entries,
-  languages,
-  apiParseTool,
-  appDir,
-  parseToolOptions,
-  isProd
-}) => {
-  const watchFileMap = {};
-  const genApiDoc = async (entry, tool) => {
-    if (Object.keys(entry).length === 0) {
-      return;
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const external_node_fs_namespaceObject = require("node:fs");
+var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
+const logger_namespaceObject = require("@rspress/shared/logger");
+const external_chokidar_namespaceObject = require("chokidar");
+var external_chokidar_default = /*#__PURE__*/ __webpack_require__.n(external_chokidar_namespaceObject);
+const external_react_docgen_typescript_namespaceObject = require("react-docgen-typescript");
+const shared_namespaceObject = require("@rspress/shared");
+external_node_path_default().join(__dirname, '..');
+const apiDocMap = {};
+const locales = {
+    zh: {
+        copy: '复制',
+        copied: '复制成功',
+        expand: '展开代码',
+        collapse: '收起代码',
+        className: '节点类名',
+        style: '节点样式',
+        children: '子节点',
+        disabled: '是否禁用',
+        required: '必填',
+        property: '属性',
+        description: '说明',
+        type: '类型',
+        defaultValue: '默认值',
+        overview: '概览'
+    },
+    en: {
+        copy: 'Copy',
+        copied: 'Copied Success!',
+        expand: 'Expand Code',
+        collapse: 'Collapse Code',
+        className: 'Additional css class',
+        style: 'Additional style',
+        children: 'Children',
+        disabled: 'Whether to disable ',
+        required: 'Required',
+        property: 'Property',
+        description: 'Description',
+        type: 'Type',
+        defaultValue: 'Default Value',
+        overview: 'Overview'
     }
-    await Promise.all(
-      Object.entries(entry).map(async ([key, value]) => {
-        const moduleSourceFilePath = import_node_path2.default.resolve(appDir, value);
-        watchFileMap[moduleSourceFilePath] = {
-          apiParseTool,
-          moduleName: key
-        };
-        try {
-          if (tool === "documentation") {
-            const documentation = await import("documentation");
-            const documentationRes = await documentation.build(
-              [moduleSourceFilePath],
-              {
-                ...parseToolOptions.documentation
-              }
-            );
-            const apiDoc = await documentation.formats.md(documentationRes, {
-              noReferenceLinks: parseToolOptions.documentation?.noReferenceLinks ?? true
-            });
-            apiDocMap[key] = apiDoc;
-          } else {
-            const { tsconfigPath, compilerOptions, ...restOptions } = parseToolOptions?.["react-docgen-typescript"] ?? {};
-            const parserOpts = {
-              // https://github.com/styleguidist/react-docgen-typescript/blob/master/README.md?plain=1#L111
-              propFilter: (prop) => {
-                if (prop.declarations !== void 0 && prop.declarations.length > 0) {
-                  const hasPropAdditionalDescription = prop.declarations.find(
-                    (declaration) => {
-                      return !declaration.fileName.includes("node_modules");
-                    }
-                  );
-                  return Boolean(hasPropAdditionalDescription);
-                }
-                return true;
-              },
-              ...restOptions
+};
+const isToolEntries = (obj)=>obj.documentation || obj['react-docgen-typescript'];
+const docgen = async ({ entries, languages, apiParseTool, appDir, parseToolOptions, isProd })=>{
+    const watchFileMap = {};
+    const genApiDoc = async (entry, tool)=>{
+        if (0 === Object.keys(entry).length) return;
+        await Promise.all(Object.entries(entry).map(async ([key, value])=>{
+            const moduleSourceFilePath = external_node_path_default().resolve(appDir, value);
+            watchFileMap[moduleSourceFilePath] = {
+                apiParseTool,
+                moduleName: key
             };
-            let fileParser = (0, import_react_docgen_typescript.withDefaultConfig)(parserOpts);
-            if (tsconfigPath?.[key]) {
-              fileParser = (0, import_react_docgen_typescript.withCustomConfig)(tsconfigPath[key], parserOpts);
-            } else if (compilerOptions?.[key]) {
-              fileParser = (0, import_react_docgen_typescript.withCompilerOptions)(
-                compilerOptions[key],
-                parserOpts
-              );
-            }
-            const componentDoc = fileParser.parse(moduleSourceFilePath);
-            if (componentDoc.length === 0) {
-              import_logger.logger.warn(
-                "[module-doc-plugin]",
-                `Unable to parse API document in ${moduleSourceFilePath}`
-              );
+            try {
+                if ('documentation' === tool) {
+                    var _parseToolOptions_documentation;
+                    const documentation = await Promise.resolve().then(__webpack_require__.bind(__webpack_require__, "documentation"));
+                    const documentationRes = await documentation.build([
+                        moduleSourceFilePath
+                    ], {
+                        ...parseToolOptions.documentation
+                    });
+                    const apiDoc = await documentation.formats.md(documentationRes, {
+                        noReferenceLinks: (null === (_parseToolOptions_documentation = parseToolOptions.documentation) || void 0 === _parseToolOptions_documentation ? void 0 : _parseToolOptions_documentation.noReferenceLinks) ?? true
+                    });
+                    apiDocMap[key] = apiDoc;
+                } else {
+                    const { tsconfigPath, compilerOptions, ...restOptions } = (null == parseToolOptions ? void 0 : parseToolOptions['react-docgen-typescript']) ?? {};
+                    const parserOpts = {
+                        // https://github.com/styleguidist/react-docgen-typescript/blob/master/README.md?plain=1#L111
+                        propFilter: (prop)=>{
+                            if (void 0 !== prop.declarations && prop.declarations.length > 0) {
+                                const hasPropAdditionalDescription = prop.declarations.find((declaration)=>!declaration.fileName.includes('node_modules'));
+                                return Boolean(hasPropAdditionalDescription);
+                            }
+                            return true;
+                        },
+                        ...restOptions
+                    };
+                    let fileParser = (0, external_react_docgen_typescript_namespaceObject.withDefaultConfig)(parserOpts);
+                    if (null == tsconfigPath ? void 0 : tsconfigPath[key]) fileParser = (0, external_react_docgen_typescript_namespaceObject.withCustomConfig)(tsconfigPath[key], parserOpts);
+                    else if (null == compilerOptions ? void 0 : compilerOptions[key]) fileParser = (0, external_react_docgen_typescript_namespaceObject.withCompilerOptions)(compilerOptions[key], parserOpts);
+                    const componentDoc = fileParser.parse(moduleSourceFilePath);
+                    if (0 === componentDoc.length) logger_namespaceObject.logger.warn('[module-doc-plugin]', `Unable to parse API document in ${moduleSourceFilePath}`);
+                    if (languages.length > 0) languages.forEach((language)=>{
+                        apiDocMap[`${key}-${language}`] = generateTable(componentDoc, language);
+                    });
+                    else apiDocMap[key] = generateTable(componentDoc, 'en');
+                }
+            } catch (e) {
+                if (e instanceof Error) logger_namespaceObject.logger.error('[module-doc-plugin]', `Generate API table error: ${e.message}`);
             }
-            if (languages.length > 0) {
-              languages.forEach((language) => {
-                apiDocMap[`${key}-${language}`] = generateTable(
-                  componentDoc,
-                  language
-                );
-              });
-            } else {
-              apiDocMap[key] = generateTable(componentDoc, "en");
+        }));
+    };
+    logger_namespaceObject.logger.info('[module-doc-plugin]', 'Start to generate API table...');
+    if (isToolEntries(entries)) {
+        const reactEntries = entries['react-docgen-typescript'];
+        const documentationEntries = entries.documentation;
+        await Promise.all([
+            genApiDoc(reactEntries, 'react-docgen-typescript'),
+            genApiDoc(documentationEntries, 'documentation')
+        ]);
+    } else await genApiDoc(entries, apiParseTool);
+    if (!isProd) {
+        const watcher = external_chokidar_default().watch(Object.keys(watchFileMap), {
+            ignoreInitial: true,
+            ignorePermissionErrors: true,
+            ignored: [
+                /node_modules/
+            ]
+        });
+        let isUpdate = false;
+        watcher.on('change', (changed)=>{
+            if (isUpdate) return;
+            isUpdate = true;
+            logger_namespaceObject.logger.info('[module-doc-plugin]', 'updating API');
+            const watchFileInfo = watchFileMap[changed];
+            if (watchFileInfo) {
+                const { apiParseTool, moduleName } = watchFileInfo;
+                const updateSiteData = ()=>{
+                    const siteDataPath = external_node_path_default().join(process.cwd(), 'node_modules', shared_namespaceObject.RSPRESS_TEMP_DIR, 'runtime', 'virtual-site-data.mjs');
+                    import(siteDataPath).then((siteData)=>{
+                        const data = {
+                            ...siteData.default
+                        };
+                        data.pages.forEach((page)=>{
+                            page.apiDocMap = apiDocMap;
+                        });
+                        external_node_fs_default().writeFileSync(siteDataPath, `export default ${JSON.stringify(data)}`);
+                        isUpdate = false;
+                    });
+                };
+                genApiDoc({
+                    [moduleName]: changed
+                }, apiParseTool).then(updateSiteData);
             }
-          }
-        } catch (e) {
-          if (e instanceof Error) {
-            import_logger.logger.error(
-              "[module-doc-plugin]",
-              `Generate API table error: ${e.message}`
-            );
-          }
-        }
-      })
-    );
-  };
-  import_logger.logger.info("[module-doc-plugin]", "Start to generate API table...");
-  if (isToolEntries(entries)) {
-    const reactEntries = entries["react-docgen-typescript"];
-    const documentationEntries = entries.documentation;
-    await Promise.all([
-      genApiDoc(reactEntries, "react-docgen-typescript"),
-      genApiDoc(documentationEntries, "documentation")
-    ]);
-  } else {
-    await genApiDoc(entries, apiParseTool);
-  }
-  if (!isProd) {
-    const watcher = import_chokidar.default.watch(Object.keys(watchFileMap), {
-      ignoreInitial: true,
-      ignorePermissionErrors: true,
-      ignored: [/node_modules/]
-    });
-    let isUpdate = false;
-    watcher.on("change", (changed) => {
-      if (isUpdate) {
-        return;
-      }
-      isUpdate = true;
-      import_logger.logger.info("[module-doc-plugin]", "updating API");
-      const watchFileInfo = watchFileMap[changed];
-      if (watchFileInfo) {
-        const { apiParseTool: apiParseTool2, moduleName } = watchFileInfo;
-        const updateSiteData = () => {
-          const siteDataPath = import_node_path2.default.join(
-            process.cwd(),
-            "node_modules",
-            import_shared.RSPRESS_TEMP_DIR,
-            "runtime",
-            "virtual-site-data.mjs"
-          );
-          import(siteDataPath).then((siteData) => {
-            const data = { ...siteData.default };
-            data.pages.forEach((page) => {
-              page.apiDocMap = apiDocMap;
-            });
-            import_node_fs.default.writeFileSync(
-              siteDataPath,
-              `export default ${JSON.stringify(data)}`
-            );
-            isUpdate = false;
-          });
-        };
-        genApiDoc({ [moduleName]: changed }, apiParseTool2).then(updateSiteData);
-      }
-    });
-  }
-  import_logger.logger.success("[module-doc-plugin]", "Generate API table successfully!");
+        });
+    }
+    logger_namespaceObject.logger.success('[module-doc-plugin]', 'Generate API table successfully!');
 };
 function generateTable(componentDoc, language) {
-  return componentDoc.map((param) => {
-    const { props } = param;
-    const t = locales[language];
-    const PROP_TABLE_HEADER = `|${t.property}|${t.description}|${t.type}|${t.defaultValue}|
-|:---:|:---:|:---:|:---:|`;
-    const tableContent = Object.keys(props).filter((propName) => {
-      const { name, description } = props[propName];
-      return description || ["className", "style", "disabled", "children"].indexOf(name) > -1;
-    }).map((propName) => {
-      const { defaultValue, description, name, required, type } = props[propName];
-      const getType = () => `\`${type.name.replace(/\|/g, "\\|")}\`${required ? ` **(${t.required})**` : ""}`;
-      const getDefaultValue = () => `\`${defaultValue?.value || "-"}\``;
-      const getDescription = () => {
-        switch (name) {
-          case "className":
-            return description || t.className;
-          case "style":
-            return description || t.style;
-          case "children":
-            return description || t.children;
-          case "disabled":
-            return description || t.disabled;
-          default:
-            return description;
-        }
-      };
-      const formattedDescription = getDescription().replace(/\n/g, "
");
-      return `|${[name, formattedDescription, getType(), getDefaultValue()].map((str) => str.replace(/(?<!\\)\|/g, "&#124;")).join("|")}|`;
-    });
-    return `
-  ${param.displayName ? `### ${param.displayName}
-` : ""}
-  ${param.description ? `**${param.description}**
-` : ""}
+    return componentDoc.map((param)=>{
+        const { props } = param;
+        const t = locales[language];
+        const PROP_TABLE_HEADER = `|${t.property}|${t.description}|${t.type}|${t.defaultValue}|\n|:---:|:---:|:---:|:---:|`;
+        const tableContent = Object.keys(props).filter((propName)=>{
+            const { name, description } = props[propName];
+            return description || [
+                'className',
+                'style',
+                'disabled',
+                'children'
+            ].indexOf(name) > -1;
+        }).map((propName)=>{
+            const { defaultValue, description, name, required, type } = props[propName];
+            const getType = ()=>`\`${type.name.replace(/\|/g, '\\|')}\`${required ? ` **(${t.required})**` : ''}`;
+            const getDefaultValue = ()=>`\`${(null == defaultValue ? void 0 : defaultValue.value) || '-'}\``;
+            const getDescription = ()=>{
+                switch(name){
+                    case 'className':
+                        return description || t.className;
+                    case 'style':
+                        return description || t.style;
+                    case 'children':
+                        return description || t.children;
+                    case 'disabled':
+                        return description || t.disabled;
+                    default:
+                        return description;
+                }
+            };
+            const formattedDescription = getDescription() // allow newline
+            .replace(/\n/g, '&#10;');
+            return `|${[
+                name,
+                formattedDescription,
+                getType(),
+                getDefaultValue()
+            ].map((str)=>str.replace(/(?<!\\)\|/g, '&#124;')).join('|')}|`;
+        });
+        return `
+  ${param.displayName ? `### ${param.displayName}\n` : ''}
+  ${param.description ? `**${param.description}**\n` : ''}
   ${PROP_TABLE_HEADER}
-  ${tableContent.join("\n")}
+  ${tableContent.join('\n')}
     `;
-  }).join("\n");
+    }).join('\n');
 }
-
-// src/index.ts
-function pluginApiDocgen(options) {
-  const {
-    entries = {},
-    apiParseTool = "react-docgen-typescript",
-    appDir = process.cwd(),
-    parseToolOptions = {}
-  } = options || {};
-  return {
-    name: "@modern-js/doc-plugin-api-docgen",
-    config(config) {
-      config.markdown = config.markdown || {};
-      config.markdown.mdxRs = false;
-      return config;
-    },
-    async beforeBuild(config, isProd) {
-      const languages = (config.themeConfig?.locales?.map((locale) => locale.lang) || config.locales?.map((locale) => locale.lang) || [config.lang]).filter((lang) => lang === "zh" || lang === "en");
-      await docgen({
-        entries,
-        apiParseTool,
-        languages,
-        appDir,
-        parseToolOptions,
-        isProd
-      });
-    },
-    async modifySearchIndexData(pages) {
-      const apiCompRegExp = /(<API\s+moduleName=['"](\S+)['"]\s*(.*)?\/>)|(<API\s+moduleName=['"](\S+)['"]\s*(.*)?>(.*)?<\/API>)/;
-      await Promise.all(
-        pages.map(async (page) => {
-          const { _filepath, lang } = page;
-          let content = await import_node_fs2.default.promises.readFile(_filepath, "utf-8");
-          let matchResult = new RegExp(apiCompRegExp).exec(content);
-          if (!matchResult) {
-            return;
-          }
-          while (matchResult !== null) {
-            const [matchContent, moduleName] = matchResult;
-            const apiDoc = apiDocMap[moduleName] || apiDocMap[`${moduleName}-${lang}`];
-            content = content.replace(matchContent, apiDoc);
-            matchResult = new RegExp(apiCompRegExp).exec(content);
-          }
-          page.content = content;
-        })
-      );
-    },
-    extendPageData(pageData) {
-      pageData.apiDocMap = { ...apiDocMap };
-    },
-    markdown: {
-      globalComponents: [
-        import_node_path3.default.join(__dirname, "..", "static", "global-components", "API.tsx")
-      ]
-    }
-  };
+/**
+ * The plugin is used to generate api doc for files.
+ */ function pluginApiDocgen(options) {
+    const { entries = {}, apiParseTool = 'react-docgen-typescript', appDir = process.cwd(), parseToolOptions = {} } = options || {};
+    return {
+        name: '@modern-js/doc-plugin-api-docgen',
+        config (config) {
+            config.markdown = config.markdown || {};
+            config.markdown.mdxRs = false;
+            return config;
+        },
+        async beforeBuild (config, isProd) {
+            var _config_themeConfig_locales, _config_themeConfig, _config_locales;
+            // only support zh and en
+            const languages = ((null === (_config_themeConfig = config.themeConfig) || void 0 === _config_themeConfig ? void 0 : null === (_config_themeConfig_locales = _config_themeConfig.locales) || void 0 === _config_themeConfig_locales ? void 0 : _config_themeConfig_locales.map((locale)=>locale.lang)) || (null === (_config_locales = config.locales) || void 0 === _config_locales ? void 0 : _config_locales.map((locale)=>locale.lang)) || [
+                config.lang
+            ]).filter((lang)=>'zh' === lang || 'en' === lang);
+            await docgen({
+                entries,
+                apiParseTool,
+                languages,
+                appDir,
+                parseToolOptions,
+                isProd
+            });
+        },
+        async modifySearchIndexData (pages) {
+            // Update the search index of module doc which includes `<API moduleName="foo" />` and `<API moduleName="foo" ></API>
+            const apiCompRegExp = /(<API\s+moduleName=['"](\S+)['"]\s*(.*)?\/>)|(<API\s+moduleName=['"](\S+)['"]\s*(.*)?>(.*)?<\/API>)/;
+            await Promise.all(pages.map(async (page)=>{
+                const { _filepath, lang } = page;
+                let content = await external_node_fs_default().promises.readFile(_filepath, 'utf-8');
+                let matchResult = new RegExp(apiCompRegExp).exec(content);
+                if (!matchResult) return;
+                while(null !== matchResult){
+                    const [matchContent, moduleName] = matchResult;
+                    const apiDoc = apiDocMap[moduleName] || apiDocMap[`${moduleName}-${lang}`];
+                    content = content.replace(matchContent, apiDoc);
+                    matchResult = new RegExp(apiCompRegExp).exec(content);
+                }
+                page.content = content;
+            }));
+        },
+        extendPageData (pageData) {
+            pageData.apiDocMap = {
+                ...apiDocMap
+            };
+        },
+        markdown: {
+            globalComponents: [
+                external_node_path_default().join(__dirname, '..', 'static', 'global-components', 'API.tsx')
+            ]
+        }
+    };
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  pluginApiDocgen
+var __webpack_export_target__ = exports;
+for(var i in __webpack_exports__)__webpack_export_target__[i] = __webpack_exports__[i];
+if (__webpack_exports__.__esModule) Object.defineProperty(__webpack_export_target__, '__esModule', {
+    value: true
 });
-
-//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rspress/plugin-api-docgen",
-  "version": "1.37.2",
+  "version": "1.37.3",
   "description": "A plugin for rspress to generate api doc.",
   "bugs": "https://github.com/web-infra-dev/rspress/issues",
   "repository": {
@@ -21,9 +21,11 @@
     "react-docgen-typescript": "2.2.2",
     "react-markdown": "8.0.7",
     "remark-gfm": "3.0.1",
-    "@rspress/shared": "1.37.2"
+    "@rspress/shared": "1.37.3"
   },
   "devDependencies": {
+    "@microsoft/api-extractor": "^7.48.0",
+    "@rslib/core": "0.1.0",
     "@types/mdast": "^4.0.4",
     "@types/node": "^18.11.17",
     "@types/react": "^18.3.12",
@@ -39,7 +41,7 @@
   "peerDependencies": {
     "react": ">=17.0.0",
     "react-router-dom": "^6.8.1",
-    "@rspress/core": "^1.37.2",
+    "@rspress/core": "^1.37.3",
     "typescript": "^5.5.3"
   },
   "peerDependenciesMeta": {
@@ -58,8 +60,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "dev": "modern build -w",
-    "build": "modern build",
+    "dev": "rslib build -w",
+    "build": "rslib build",
     "reset": "rimraf ./**/node_modules",
     "test": "vitest run --passWithNoTests"
   }

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"mappings":"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","names":["import_node_path","import_node_fs","path","chokidar","apiParseTool","fs"],"ignoreList":[],"sources":["../src/index.ts","../src/docgen.ts","../src/constants.ts","../src/locales.ts"],"sourcesContent":["import path from 'node:path';\nimport type { RspressPlugin } from '@rspress/shared';\nimport fs from 'node:fs';\nimport type {\n  PluginOptions,\n  SupportLanguages,\n  ExtendedPageData,\n} from './types';\nimport { docgen } from './docgen';\nimport { apiDocMap } from './constants';\n\n/**\n * The plugin is used to generate api doc for files.\n */\nexport function pluginApiDocgen(options?: PluginOptions): RspressPlugin {\n  const {\n    entries = {},\n    apiParseTool = 'react-docgen-typescript',\n    appDir = process.cwd(),\n    parseToolOptions = {},\n  } = options || {};\n  return {\n    name: '@modern-js/doc-plugin-api-docgen',\n    config(config) {\n      config.markdown = config.markdown || {};\n      config.markdown.mdxRs = false;\n      return config;\n    },\n    async beforeBuild(config, isProd) {\n      // only support zh and en\n      const languages = (\n        config.themeConfig?.locales?.map(locale => locale.lang) ||\n        config.locales?.map(locale => locale.lang) || [config.lang]\n      ).filter(lang => lang === 'zh' || lang === 'en') as SupportLanguages[];\n      await docgen({\n        entries,\n        apiParseTool,\n        languages,\n        appDir,\n        parseToolOptions,\n        isProd,\n      });\n    },\n    async modifySearchIndexData(pages) {\n      // Update the search index of module doc which includes `<API moduleName=\"foo\" />` and `<API moduleName=\"foo\" ></API>\n      const apiCompRegExp =\n        /(<API\\s+moduleName=['\"](\\S+)['\"]\\s*(.*)?\\/>)|(<API\\s+moduleName=['\"](\\S+)['\"]\\s*(.*)?>(.*)?<\\/API>)/;\n      await Promise.all(\n        pages.map(async page => {\n          const { _filepath, lang } = page;\n          let content = await fs.promises.readFile(_filepath, 'utf-8');\n          let matchResult = new RegExp(apiCompRegExp).exec(content);\n          if (!matchResult) {\n            return;\n          }\n          while (matchResult !== null) {\n            const [matchContent, moduleName] = matchResult;\n            const apiDoc =\n              apiDocMap[moduleName] || apiDocMap[`${moduleName}-${lang}`];\n            content = content.replace(matchContent, apiDoc);\n            matchResult = new RegExp(apiCompRegExp).exec(content);\n          }\n          page.content = content;\n        }),\n      );\n    },\n    extendPageData(pageData) {\n      (pageData as ExtendedPageData).apiDocMap = { ...apiDocMap };\n    },\n    markdown: {\n      globalComponents: [\n        path.join(__dirname, '..', 'static', 'global-components', 'API.tsx'),\n      ],\n    },\n  };\n}\n\nexport type { PluginOptions };\n","import path from 'node:path';\nimport type { ComponentDoc, PropItem } from 'react-docgen-typescript';\nimport fs from 'node:fs';\nimport { logger } from '@rspress/shared/logger';\nimport chokidar from 'chokidar';\nimport {\n  withDefaultConfig,\n  withCustomConfig,\n  withCompilerOptions,\n} from 'react-docgen-typescript';\nimport { RSPRESS_TEMP_DIR } from '@rspress/shared';\nimport { apiDocMap } from './constants';\nimport { locales } from './locales';\nimport type {\n  DocGenOptions,\n  Entries,\n  ToolEntries,\n  ApiParseTool,\n  WatchFileInfo,\n} from './types';\n\nconst isToolEntries = (obj: Record<string, any>): obj is ToolEntries => {\n  return obj.documentation || obj['react-docgen-typescript'];\n};\n\nexport const docgen = async ({\n  entries,\n  languages,\n  apiParseTool,\n  appDir,\n  parseToolOptions,\n  isProd,\n}: DocGenOptions) => {\n  const watchFileMap: Record<string, WatchFileInfo> = {};\n  const genApiDoc = async (entry: Entries, tool: ApiParseTool) => {\n    if (Object.keys(entry).length === 0) {\n      return;\n    }\n    await Promise.all(\n      Object.entries(entry).map(async ([key, value]) => {\n        const moduleSourceFilePath = path.resolve(appDir, value);\n        watchFileMap[moduleSourceFilePath] = {\n          apiParseTool,\n          moduleName: key,\n        };\n        try {\n          if (tool === 'documentation') {\n            const documentation = await import('documentation');\n\n            const documentationRes = await documentation.build(\n              [moduleSourceFilePath],\n              {\n                ...parseToolOptions.documentation,\n              },\n            );\n            const apiDoc = await documentation.formats.md(documentationRes, {\n              noReferenceLinks:\n                parseToolOptions.documentation?.noReferenceLinks ?? true,\n            });\n            apiDocMap[key] = apiDoc;\n          } else {\n            const { tsconfigPath, compilerOptions, ...restOptions } =\n              parseToolOptions?.['react-docgen-typescript'] ?? {};\n            const parserOpts = {\n              // https://github.com/styleguidist/react-docgen-typescript/blob/master/README.md?plain=1#L111\n              propFilter: (prop: PropItem) => {\n                if (\n                  prop.declarations !== undefined &&\n                  prop.declarations.length > 0\n                ) {\n                  const hasPropAdditionalDescription = prop.declarations.find(\n                    declaration => {\n                      return !declaration.fileName.includes('node_modules');\n                    },\n                  );\n\n                  return Boolean(hasPropAdditionalDescription);\n                }\n\n                return true;\n              },\n              ...restOptions,\n            };\n            let fileParser = withDefaultConfig(parserOpts);\n            if (tsconfigPath?.[key]) {\n              fileParser = withCustomConfig(tsconfigPath[key], parserOpts);\n            } else if (compilerOptions?.[key]) {\n              fileParser = withCompilerOptions(\n                compilerOptions[key],\n                parserOpts,\n              );\n            }\n            const componentDoc = fileParser.parse(moduleSourceFilePath);\n            if (componentDoc.length === 0) {\n              logger.warn(\n                '[module-doc-plugin]',\n                `Unable to parse API document in ${moduleSourceFilePath}`,\n              );\n            }\n            if (languages.length > 0) {\n              languages.forEach(language => {\n                apiDocMap[`${key}-${language}`] = generateTable(\n                  componentDoc,\n                  language,\n                );\n              });\n            } else {\n              apiDocMap[key] = generateTable(componentDoc, 'en');\n            }\n          }\n        } catch (e) {\n          if (e instanceof Error) {\n            logger.error(\n              '[module-doc-plugin]',\n              `Generate API table error: ${e.message}`,\n            );\n          }\n        }\n      }),\n    );\n  };\n  logger.info('[module-doc-plugin]', 'Start to generate API table...');\n\n  if (isToolEntries(entries)) {\n    const reactEntries = entries['react-docgen-typescript'];\n    const documentationEntries = entries.documentation;\n    await Promise.all([\n      genApiDoc(reactEntries, 'react-docgen-typescript'),\n      genApiDoc(documentationEntries, 'documentation'),\n    ]);\n  } else {\n    await genApiDoc(entries, apiParseTool);\n  }\n  if (!isProd) {\n    const watcher = chokidar.watch(Object.keys(watchFileMap), {\n      ignoreInitial: true,\n      ignorePermissionErrors: true,\n      ignored: [/node_modules/],\n    });\n    let isUpdate = false;\n    watcher.on('change', changed => {\n      if (isUpdate) {\n        return;\n      }\n      isUpdate = true;\n      logger.info('[module-doc-plugin]', 'updating API');\n      const watchFileInfo = watchFileMap[changed];\n      if (watchFileInfo) {\n        const { apiParseTool, moduleName } = watchFileInfo;\n\n        const updateSiteData = () => {\n          const siteDataPath = path.join(\n            process.cwd(),\n            'node_modules',\n            RSPRESS_TEMP_DIR,\n            'runtime',\n            'virtual-site-data.mjs',\n          );\n          import(siteDataPath).then(siteData => {\n            const data = { ...siteData.default };\n            data.pages.forEach((page: Record<string, unknown>) => {\n              page.apiDocMap = apiDocMap;\n            });\n            fs.writeFileSync(\n              siteDataPath,\n              `export default ${JSON.stringify(data)}`,\n            );\n            isUpdate = false;\n          });\n        };\n        genApiDoc({ [moduleName]: changed }, apiParseTool).then(updateSiteData);\n      }\n    });\n  }\n\n  logger.success('[module-doc-plugin]', 'Generate API table successfully!');\n};\n\nfunction generateTable(componentDoc: ComponentDoc[], language: 'zh' | 'en') {\n  return componentDoc\n    .map(param => {\n      const { props } = param;\n      const t = locales[language];\n      const PROP_TABLE_HEADER = `|${t.property}|${t.description}|${t.type}|${t.defaultValue}|\\n|:---:|:---:|:---:|:---:|`;\n\n      const tableContent = Object.keys(props)\n        .filter(propName => {\n          const { name, description } = props[propName];\n          return (\n            description ||\n            ['className', 'style', 'disabled', 'children'].indexOf(name) > -1\n          );\n        })\n        .map(propName => {\n          const { defaultValue, description, name, required, type } =\n            props[propName];\n          const getType = () =>\n            `\\`${type.name.replace(/\\|/g, '\\\\|')}\\`${\n              required ? ` **(${t.required})**` : ''\n            }`;\n          const getDefaultValue = () => `\\`${defaultValue?.value || '-'}\\``;\n\n          const getDescription = () => {\n            switch (name) {\n              case 'className':\n                return description || t.className;\n              case 'style':\n                return description || t.style;\n              case 'children':\n                return description || t.children;\n              case 'disabled':\n                return description || t.disabled;\n              default:\n                return description;\n            }\n          };\n\n          const formattedDescription = getDescription()\n            // allow newline\n            .replace(/\\n/g, '&#10;');\n\n          return `|${[name, formattedDescription, getType(), getDefaultValue()]\n            .map(str => str.replace(/(?<!\\\\)\\|/g, '&#124;'))\n            .join('|')}|`;\n        });\n\n      return `\n  ${param.displayName ? `### ${param.displayName}\\n` : ''}\n  ${param.description ? `**${param.description}**\\n` : ''}\n  ${PROP_TABLE_HEADER}\n  ${tableContent.join('\\n')}\n    `;\n    })\n    .join('\\n');\n}\n","import path from 'node:path';\n\nexport const PACKAGE_ROOT = path.join(__dirname, '..');\n\nexport const apiDocMap: Record<string, string> = {};\n","export const locales = {\n  zh: {\n    copy: '复制',\n    copied: '复制成功',\n    expand: '展开代码',\n    collapse: '收起代码',\n    className: '节点类名',\n    style: '节点样式',\n    children: '子节点',\n    disabled: '是否禁用',\n    required: '必填',\n    property: '属性',\n    description: '说明',\n    type: '类型',\n    defaultValue: '默认值',\n    overview: '概览',\n  },\n  en: {\n    copy: 'Copy',\n    copied: 'Copied Success!',\n    expand: 'Expand Code',\n    collapse: 'Collapse Code',\n    className: 'Additional css class',\n    style: 'Additional style',\n    children: 'Children',\n    disabled: 'Whether to disable ',\n    required: 'Required',\n    property: 'Property',\n    description: 'Description',\n    type: 'Type',\n    defaultValue: 'Default Value',\n    overview: 'Overview',\n  },\n};\n"]}