dumi 2.3.0-beta.7 → 2.3.0-beta.8

package/dist/constants.js

@@ -19,6 +19,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/constants.ts
 var constants_exports = {};
 __export(constants_exports, {
+  DEFAULT_DEMO_MODULE_EXTENSIONS: () => DEFAULT_DEMO_MODULE_EXTENSIONS,
+  DEFAULT_DEMO_PLAIN_TEXT_EXTENSIONS: () => DEFAULT_DEMO_PLAIN_TEXT_EXTENSIONS,
   FS_CACHE_DIR: () => FS_CACHE_DIR,
   LOCAL_DUMI_DIR: () => LOCAL_DUMI_DIR,
   LOCAL_PAGES_DIR: () => LOCAL_PAGES_DIR,
@@ -52,9 +54,20 @@ var PICKED_PKG_FIELDS = {
 var USELESS_TMP_FILES = ["tsconfig.json", "typings.d.ts"];
 var VERSION_2_LEVEL_NAV = "^2.2.0";
 var VERSION_2_DEPRECATE_SOFT_BREAKS = "^2.2.0";
+var DEFAULT_DEMO_MODULE_EXTENSIONS = [".js", ".jsx", ".ts", ".tsx"];
+var DEFAULT_DEMO_PLAIN_TEXT_EXTENSIONS = [
+  ".css",
+  ".less",
+  ".sass",
+  ".scss",
+  ".styl",
+  ".json"
+];
 var FS_CACHE_DIR = "node_modules/.cache/dumi";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_DEMO_MODULE_EXTENSIONS,
+  DEFAULT_DEMO_PLAIN_TEXT_EXTENSIONS,
   FS_CACHE_DIR,
   LOCAL_DUMI_DIR,
   LOCAL_PAGES_DIR,

package/dist/features/compile/index.js

@@ -108,22 +108,24 @@ var compile_default = (api) => {
       ...loaderBaseOpts,
       mode: "demo"
     }).end().end();
-    mdRule.oneOf("md").use("babel-loader").loader(babelInUmi.loader).options(babelInUmi.options).end().use("md-loader").loader(loaderPath).options({
-      ...loaderBaseOpts,
-      builtins: api.service.themeData.builtins,
-      onResolveDemos(demos) {
-        const assets = demos.reduce(
-          (ret, demo) => {
+    mdRule.oneOf("md").use("babel-loader").loader(babelInUmi.loader).options(babelInUmi.options).end().use("md-loader").loader(loaderPath).options(
+      api.isPluginEnable("assets") || api.isPluginEnable("exportStatic") ? {
+        ...loaderBaseOpts,
+        builtins: api.service.themeData.builtins,
+        onResolveDemos(demos) {
+          const assets = demos.reduce((ret, demo) => {
             if ("asset" in demo)
               ret.push(demo.asset);
             return ret;
-          },
-          []
-        );
-        (0, import_assets.addExampleAssets)(assets);
-      },
-      onResolveAtomMeta: import_assets.addAtomMeta
-    });
+          }, []);
+          (0, import_assets.addExampleAssets)(assets);
+        },
+        onResolveAtomMeta: import_assets.addAtomMeta
+      } : {
+        ...loaderBaseOpts,
+        builtins: api.service.themeData.builtins
+      }
+    );
     memo.module.rule("dumi-page").type("javascript/auto").test(/\.(j|t)sx?$/).resourceQuery(/frontmatter$/).use("page-meta-loader").loader(require.resolve("../../loaders/page"));
     memo.module.rule("dumi-demo").type("javascript/auto").test(/\..+$/).enforce("pre").resourceQuery(/techStack/).use("demo-loader").loader(require.resolve("../../loaders/demo")).options({ techStacks, cwd: api.cwd });
     memo.module.rule("dumi-raw").type("javascript/auto").post().resourceQuery(/dumi-raw/).use("raw-loader").loader(require.resolve("raw-loader")).end().use("pre-raw-loader").loader(require.resolve("../../loaders/pre-raw"));

package/dist/features/parser.js

@@ -34,6 +34,7 @@ __export(parser_exports, {
 module.exports = __toCommonJS(parser_exports);
 var import_utils = require("@umijs/utils");
 var import_assert = __toESM(require("assert"));
+var import_BaseParser = require("../assetParsers/BaseParser");
 var import_meta = require("./meta");
 function filterIgnoredProps(props) {
   return import_utils.lodash.pickBy(props, (prop) => {
@@ -89,15 +90,18 @@ var parser_default = (api) => {
     return memo;
   });
   api.onCheckPkgJSON(async () => {
+    if (api.service.atomParser instanceof import_BaseParser.BaseAtomAssetsParser)
+      return;
     const {
-      default: AtomAssetsParser
+      default: ReactAtomAssetsParser
     } = require("../assetParsers/atom");
-    api.service.atomParser = new AtomAssetsParser({
+    const apiParser = api.config.apiParser;
+    api.service.atomParser = new ReactAtomAssetsParser({
       entryFile: api.config.resolve.entryFile,
       resolveDir: api.cwd,
-      unpkgHost: api.config.apiParser.unpkgHost,
-      resolveFilter: api.config.apiParser.resolveFilter,
-      parseOptions: api.config.apiParser.parseOptions
+      unpkgHost: apiParser.unpkgHost,
+      resolveFilter: apiParser.resolveFilter,
+      parseOptions: apiParser.parseOptions
     });
   });
   api.onDevCompileDone(({ isFirstCompile }) => {

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import type { IDumiUserConfig } from "./types";
+import type { IDumiTechStack, IDumiTechStackRuntimeOpts, IDumiUserConfig } from "./types";
 declare let unistUtilVisit: typeof import('unist-util-visit');
 export * from 'umi';
-export { unistUtilVisit };
+export { getProjectRoot } from './utils';
+export { unistUtilVisit, IDumiTechStack, IDumiTechStackRuntimeOpts };
 export declare const defineConfig: (config: IDumiUserConfig) => IDumiUserConfig;

package/dist/index.js

@@ -31,10 +31,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   defineConfig: () => defineConfig,
+  getProjectRoot: () => import_utils.getProjectRoot,
   unistUtilVisit: () => unistUtilVisit
 });
 module.exports = __toCommonJS(src_exports);
 __reExport(src_exports, require("umi"), module.exports);
+var import_utils = require("./utils");
 var unistUtilVisit;
 (async () => {
   unistUtilVisit = await import("unist-util-visit");
@@ -43,6 +45,7 @@ var defineConfig = (config) => config;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   defineConfig,
+  getProjectRoot,
   unistUtilVisit,
   ...require("umi")
 });

package/dist/loaders/markdown/index.js

@@ -84,7 +84,9 @@ function emitDemo(opts, ret) {
 export const demos = {
   {{#demos}}
   '{{{id}}}': {
+    {{#component}}
     component: {{{component}}},
+    {{/component}}
     asset: {{{renderAsset}}},
     context: {{{renderContext}}},
     renderOpts: {{{renderRenderOpts}}},
@@ -124,15 +126,29 @@ export const demos = {
         return JSON.stringify(context, null, 2).replace(/"{{{|}}}"/g, "");
       },
       renderRenderOpts: function renderRenderOpts() {
-        if (!("renderOpts" in this) || !this.renderOpts.compilePath) {
+        if (!("renderOpts" in this)) {
           return "undefined";
         }
-        return `{
+        const renderOpts = this.renderOpts;
+        const propertyArray = [];
+        if (renderOpts.compilePath) {
+          propertyArray.push(`
           compile: async (...args) => {
             return (await import('${(0, import_plugin_utils.winPath)(
-          this.renderOpts.compilePath
-        )}')).default(...args);
-          },
+            renderOpts.compilePath
+          )}')).default(...args);
+          },`);
+        }
+        if (renderOpts.rendererPath) {
+          propertyArray.push(`
+            renderer: (await import('${(0, import_plugin_utils.winPath)(
+            renderOpts.rendererPath
+          )}')).default,`);
+        }
+        if (propertyArray.length === 0)
+          return "undefined";
+        return `{
+          ${propertyArray.join("\n")}
         }`;
       }
     }
@@ -201,6 +217,9 @@ var depsMapping = {};
 function mdLoader(content) {
   const opts = this.getOptions();
   const cb = this.async();
+  if (process.env.NODE_ENV === "production" && ["onResolveDemos", "onResolveAtomMeta"].some((k) => k in opts)) {
+    this.cacheable(false);
+  }
   const cache = (0, import_utils.getCache)("md-loader");
   const baseCacheKey = [
     this.resourcePath,

package/dist/loaders/markdown/transformer/index.d.ts

@@ -1,6 +1,6 @@
 import type { IParsedBlockAsset } from "../../../assetParsers/block";
 import type { ILocalesConfig, IRouteMeta } from "../../../client/theme-api/types";
-import type { IApi, IDumiConfig, IDumiTechStack, IDumiTechStackRuntimeOpts } from "../../../types";
+import type { IApi, IDumiConfig, IDumiTechStack } from "../../../types";
 import type { IRoute } from 'umi';
 import type { Data } from 'vfile';
 declare module 'hast' {
@@ -22,10 +22,19 @@ declare module 'vfile' {
             component: string;
             asset: IParsedBlockAsset['asset'];
             resolveMap: IParsedBlockAsset['resolveMap'];
-            renderOpts: Pick<IDumiTechStackRuntimeOpts, 'compilePath'>;
+            renderOpts: {
+                type?: string;
+                rendererPath?: string;
+                compilePath?: string;
+            };
         } | {
             id: string;
             component: string;
+            renderOpts: {
+                type?: string;
+                rendererPath?: string;
+                compilePath?: string;
+            };
         })[];
         texts: IRouteMeta['texts'];
         frontmatter: IRouteMeta['frontmatter'];

package/dist/loaders/markdown/transformer/index.js

@@ -80,6 +80,9 @@ var transformer_default = async (raw, opts) => {
   const resolver = import_enhanced_resolve.default.create.sync({
     mainFields: ["browser", "module", "main"],
     extensions: [".js", ".jsx", ".ts", ".tsx"],
+    // Common conditionName needs to be configured,
+    // otherwise some common library paths cannot be parsed, such as vue, pinia, etc.
+    conditionNames: ["import", "require", "default", "browser", "node"],
     alias: opts.alias
   });
   const fileLocale = (_a = opts.locales.find(

package/dist/loaders/markdown/transformer/rehypeDemo.js

@@ -180,9 +180,12 @@ function rehypeDemo(opts) {
               id: "",
               refAtomIds: vFile.data.frontmatter.atomId ? [vFile.data.frontmatter.atomId] : [],
               fileAbsPath: "",
+              lang: codeNode.data.lang,
               entryPointCode: codeType === "external" ? void 0 : codeValue,
-              resolver: opts.resolver
+              resolver: opts.resolver,
+              techStack
             };
+            const runtimeOpts = techStack.runtimeOpts;
             const previewerProps = {};
             let component = "";
             if (codeType === "external") {
@@ -199,9 +202,14 @@ function rehypeDemo(opts) {
                 localId,
                 vFile.data.frontmatter.atomId
               );
-              component = `React.memo(React.lazy(() => import( /* webpackChunkName: "${chunkName}" */ '${(0, import_plugin_utils.winPath)(
+              const importChunk = `import( /* webpackChunkName: "${chunkName}" */ '${(0, import_plugin_utils.winPath)(
                 parseOpts.fileAbsPath
-              )}?techStack=${techStack.name}')))`;
+              )}?techStack=${techStack.name}')`;
+              if (runtimeOpts == null ? void 0 : runtimeOpts.rendererPath) {
+                component = `(async () => ${importChunk})()`;
+              } else {
+                component = `React.memo(React.lazy(() => ${importChunk}))`;
+              }
               if (codeValue)
                 codeNode.properties.title = codeValue;
               (_c = codeNode.properties).filename ?? (_c.filename = (0, import_plugin_utils.winPath)(
@@ -209,7 +217,10 @@ function rehypeDemo(opts) {
               ));
             } else {
               const localId = [opts.fileLocale, String(index++)].filter(Boolean).join("-");
-              parseOpts.fileAbsPath = opts.fileAbsPath.replace(".md", ".tsx");
+              parseOpts.fileAbsPath = opts.fileAbsPath.replace(
+                ".md",
+                `.${parseOpts.lang}`
+              );
               parseOpts.id = getCodeId(
                 opts.cwd,
                 opts.fileLocaleLessPath,
@@ -226,7 +237,7 @@ function rehypeDemo(opts) {
             deferrers.push(
               (0, import_block.default)(parseOpts).then(
                 async ({ asset, resolveMap, frontmatter }) => {
-                  var _a2, _b2, _c2, _d;
+                  var _a2, _b2, _c2;
                   if (demoIds.indexOf(parseOpts.id) !== demoIds.lastIndexOf(parseOpts.id)) {
                     const startLine = (_a2 = node.position) == null ? void 0 : _a2.start.line;
                     const suffix = startLine ? `:${startLine}` : "";
@@ -265,7 +276,10 @@ function rehypeDemo(opts) {
                     return {
                       // TODO: special id for inline demo
                       id: asset.id,
-                      component
+                      component,
+                      renderOpts: {
+                        rendererPath: runtimeOpts == null ? void 0 : runtimeOpts.rendererPath
+                      }
                     };
                   }
                   Object.assign(
@@ -301,7 +315,8 @@ function rehypeDemo(opts) {
                       techStackOpts
                     ) : resolveMap,
                     renderOpts: {
-                      compilePath: (_d = techStack.runtimeOpts) == null ? void 0 : _d.compilePath
+                      rendererPath: runtimeOpts == null ? void 0 : runtimeOpts.rendererPath,
+                      compilePath: runtimeOpts == null ? void 0 : runtimeOpts.compilePath
                     }
                   };
                 }

package/dist/techStacks/react.js

@@ -32,7 +32,7 @@ __export(react_exports, {
   default: () => ReactTechStack
 });
 module.exports = __toCommonJS(react_exports);
-var import_core = require("@swc/core");
+var import_utils = require("./utils");
 var ReactTechStack = class {
   constructor() {
     this.name = "react";
@@ -46,31 +46,14 @@ var ReactTechStack = class {
   transformCode(...[raw, opts]) {
     if (opts.type === "code-block") {
       const isTSX = opts.fileAbsPath.endsWith(".tsx");
-      const { code } = (0, import_core.transformSync)(raw, {
+      const code = (0, import_utils.wrapDemoWithFn)(raw, {
         filename: opts.fileAbsPath,
-        jsc: {
-          parser: {
-            syntax: isTSX ? "typescript" : "ecmascript",
-            [isTSX ? "tsx" : "jsx"]: true
-          },
-          target: "es2022",
-          experimental: {
-            cacheRoot: "node_modules/.cache/swc",
-            plugins: [
-              [
-                require.resolve("../../compiled/crates/swc_plugin_react_demo.wasm"),
-                {}
-              ]
-            ]
-          }
-        },
-        module: {
-          type: "es6"
+        parserConfig: {
+          syntax: isTSX ? "typescript" : "ecmascript",
+          [isTSX ? "tsx" : "jsx"]: true
         }
       });
-      return `React.memo(React.lazy(async () => {
-${code}
-}))`;
+      return `React.memo(React.lazy(${code}))`;
     }
     return raw;
   }

package/dist/techStacks/utils.d.ts

@@ -0,0 +1,18 @@
+import type { ParserConfig } from '@swc/core';
+export { IDumiTechStack, IDumiTechStackOnBlockLoadArgs, IDumiTechStackOnBlockLoadResult, IDumiTechStackRuntimeOpts, } from '../types';
+/**
+ * for frameworks like vue , we need to extract the JS fragments in their scripts
+ * @param htmlLike HTML, vue and other html-like files are available
+ * @returns js/ts code
+ */
+export declare function extractScript(htmlLike: string): string;
+export interface IWrapDemoWithFnOptions {
+    filename: string;
+    parserConfig: ParserConfig;
+}
+/**
+ * Use swc to convert es module into async function.
+ * More transform process detail, refer to:
+ * https://github.com/umijs/dumi/blob/master/crates/swc_plugin_react_demo/src/lib.rs#L126
+ */
+export declare function wrapDemoWithFn(code: string, opts: IWrapDemoWithFnOptions): string;

package/dist/techStacks/utils.js

@@ -0,0 +1,85 @@
+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 __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/techStacks/utils.ts
+var utils_exports = {};
+__export(utils_exports, {
+  IDumiTechStack: () => import_types.IDumiTechStack,
+  IDumiTechStackOnBlockLoadArgs: () => import_types.IDumiTechStackOnBlockLoadArgs,
+  IDumiTechStackOnBlockLoadResult: () => import_types.IDumiTechStackOnBlockLoadResult,
+  IDumiTechStackRuntimeOpts: () => import_types.IDumiTechStackRuntimeOpts,
+  extractScript: () => extractScript,
+  wrapDemoWithFn: () => wrapDemoWithFn
+});
+module.exports = __toCommonJS(utils_exports);
+var import_core = require("@swc/core");
+var import_types = require("../types");
+function extractScript(htmlLike) {
+  const htmlScriptReg = /<script\b(?:\s[^>]*>|>)(.*?)<\/script>/gims;
+  let match = htmlScriptReg.exec(htmlLike);
+  let scripts = "";
+  while (match) {
+    scripts += match[1] + "\n";
+    match = htmlScriptReg.exec(htmlLike);
+  }
+  return scripts;
+}
+function wrapDemoWithFn(code, opts) {
+  const { filename, parserConfig } = opts;
+  const result = (0, import_core.transformSync)(code, {
+    filename,
+    jsc: {
+      parser: parserConfig,
+      target: "es2022",
+      experimental: {
+        cacheRoot: "node_modules/.cache/swc",
+        plugins: [
+          [
+            require.resolve("../../compiled/crates/swc_plugin_react_demo.wasm"),
+            {}
+          ]
+        ]
+      }
+    },
+    module: {
+      type: "es6"
+    }
+  });
+  return `async function() {
+  ${result.code}
+}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  IDumiTechStack,
+  IDumiTechStackOnBlockLoadArgs,
+  IDumiTechStackOnBlockLoadResult,
+  IDumiTechStackRuntimeOpts,
+  extractScript,
+  wrapDemoWithFn
+});

package/dist/types.d.ts

@@ -1,9 +1,10 @@
-import type AtomAssetsParser from "./assetParsers/atom";
+import type { BaseAtomAssetsParser as IAtomAssetsParser } from "./assetParsers/BaseParser";
 import type { IParsedBlockAsset } from "./assetParsers/block";
 import type { IDumiDemoProps } from "./client/theme-api/DumiDemo";
 import type { ILocalesConfig, IThemeConfig } from "./client/theme-api/types";
 import type { IContentTab } from "./features/tabs";
 import type { IThemeLoadResult } from "./features/theme/loader";
+import { OnLoadArgs, OnLoadResult } from '@umijs/bundler-utils/compiled/esbuild';
 import type { IModify } from '@umijs/core';
 import type { AssetsPackage, ExampleBlockAsset } from 'dumi-assets-types';
 import type { Element } from 'hast';
@@ -48,7 +49,20 @@ export type IDumiUserConfig = Subset<Omit<IDumiConfig, 'locales'>> & {
     }>, 'base'>[];
     [key: string]: any;
 };
+export interface IDumiTechStackOnBlockLoadResult {
+    content: string;
+    type: Required<OnLoadResult>['loader'];
+}
+export type IDumiTechStackOnBlockLoadArgs = OnLoadArgs & {
+    entryPointCode: string;
+    filename: string;
+};
 export interface IDumiTechStackRuntimeOpts {
+    /**
+     * path of the cancelable{@link IDemoCancelableFn} function
+     * that manipulate(mount/unmount) third-party framework component
+     */
+    rendererPath?: string;
     /**
      * path to runtime compile function module
      */
@@ -72,7 +86,7 @@ export declare abstract class IDumiTechStack {
      */
     abstract isSupported(node: Element, lang: string): boolean;
     /**
-     * transform for parse demo source to react component
+     * transform for parse demo source to expression/function/class
      */
     abstract transformCode(raw: string, opts: {
         type: 'external' | 'code-block';
@@ -95,6 +109,15 @@ export declare abstract class IDumiTechStack {
      * generator for return file path of demo source
      */
     abstract generateSources?(source: IParsedBlockAsset['resolveMap'], opts: Parameters<NonNullable<IDumiTechStack['generateMetadata']>>[1]): Promise<IParsedBlockAsset['resolveMap']> | IParsedBlockAsset['resolveMap'];
+    /**
+     * Use current function as onLoad CallBack(https://esbuild.github.io/plugins/#on-load)
+     * @description
+     * Why use this method?
+     * By default, dumi can only support the parsing of js/ts related code blocks,
+     * but many front-end frameworks have custom extensions,
+     * so this method is provided to facilitate developers to convert codes.
+     */
+    abstract onBlockLoad?(args: IDumiTechStackOnBlockLoadArgs): IDumiTechStackOnBlockLoadResult | null;
 }
 export type IApi = IUmiApi & {
     config: IDumiConfig & {
@@ -103,7 +126,7 @@ export type IApi = IUmiApi & {
     userConfig: IDumiUserConfig;
     service: IUmiApi['service'] & {
         themeData: IThemeLoadResult;
-        atomParser: AtomAssetsParser;
+        atomParser: IAtomAssetsParser;
     };
     /**
      * register a new tech stack

package/dist/utils.d.ts

@@ -15,7 +15,8 @@ export declare const getFileRangeLines: (content: string, range: string) => stri
  */
 export declare const getFileContentByRegExp: (content: string, regexp: string, filePath: string) => string;
 /**
- * parse frontmatter from code string
+ * parse frontmatter from code string,
+ * also supports html/xml comments
  */
 export declare function parseCodeFrontmatter(raw: string): {
     code: string;

package/dist/utils.js

@@ -73,8 +73,8 @@ Error: ${err}`);
   }
 };
 function parseCodeFrontmatter(raw) {
-  const [, comment = "", code = ""] = raw.replace(/^\n\s*/, "").match(/^(\/\*\*[^]*?\n\s*\*\/)?(?:\s|\n)*([^]+)?$/);
-  const yamlComment = comment.replace(/^\/|\/$/g, "").replace(/(^|\n)\s*\*+/g, "$1");
+  const [, comment = "", code = ""] = raw.replace(/^\n\s*/, "").match(/^(\/\*\*[^]*?\n\s*\*\/|<!--[^]*?\n\s*-->)?(?:\s|\n)*([^]+)?$/);
+  const yamlComment = comment.replace(/^(\/|<!--)|(\/|-->)$/g, "").replace(/(^|\n)\s*\*+/g, "$1");
   let frontmatter = null;
   try {
     frontmatter = import_js_yaml.default.load(yamlComment);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dumi",
-  "version": "2.3.0-beta.7",
+  "version": "2.3.0-beta.8",
   "description": "📖 Documentation Generator of React Component",
   "keywords": [
     "generator",
@@ -32,7 +32,9 @@
     "theme-default",
     "index.d.ts",
     "plugin-utils.js",
-    "plugin-utils.d.ts"
+    "plugin-utils.d.ts",
+    "tech-stack-utils.js",
+    "tech-stack-utils.d.ts"
   ],
   "scripts": {
     "build": "father build && npm run build:crates",
@@ -79,7 +81,7 @@
     "@ant-design/icons-svg": "^4.2.1",
     "@makotot/ghostui": "^2.0.0",
     "@stackblitz/sdk": "^1.9.0",
-    "@swc/core": "1.3.72",
+    "@swc/core": "1.4.2",
     "@types/hast": "^2.3.5",
     "@types/mdast": "^3.0.12",
     "@umijs/bundler-utils": "^4.0.84",
@@ -88,6 +90,7 @@
     "animated-scroll-to": "^2.3.0",
     "classnames": "2.3.2",
     "codesandbox": "^2.2.3",
+    "comlink": "^4.4.1",
     "copy-to-clipboard": "^3.3.3",
     "deepmerge": "^4.3.1",
     "dumi-afx-deps": "^1.0.0-alpha.19",
@@ -159,6 +162,7 @@
     "@types/react-dom": "^18.2.7",
     "@umijs/lint": "^4.0.84",
     "@umijs/plugins": "4.0.32",
+    "codesandbox-import-utils": "^2.2.3",
     "dumi-theme-mobile": "workspace:*",
     "eslint": "^8.46.0",
     "fast-glob": "^3.3.1",

package/tech-stack-utils.d.ts

@@ -0,0 +1,12 @@
+import type * as BabelCore from '@umijs/bundler-utils/compiled/@babel/core';
+export {
+  IBaseApiParserOptions,
+  ILanguageMetaParser,
+  IPatchFile,
+} from './dist/assetParsers/BaseParser';
+export { createApiParser } from './dist/assetParsers/utils';
+export * from './dist/techStacks/utils';
+export { BabelCore };
+export const babelCore: () => typeof import('@umijs/bundler-utils/compiled/@babel/core');
+export const babelPresetTypeScript: () => BabelCore.PluginItem;
+export const babelPresetEnv: () => BabelCore.PluginItem;

package/tech-stack-utils.js

@@ -0,0 +1,9 @@
+module.exports = {
+  ...require('./dist/techStacks/utils'),
+  createApiParser: require('./dist/assetParsers/utils').createApiParser,
+  babelCore: () => require('@umijs/bundler-utils/compiled/babel/core'),
+  babelPresetTypeScript: () =>
+    require('@umijs/bundler-utils/compiled/babel/preset-typescript'),
+  babelPresetEnv: () =>
+    require('@umijs/bundler-utils/compiled/babel/preset-env'),
+};

package/theme-default/builtins/API/index.d.ts

@@ -1,5 +1,6 @@
 import { type FC } from 'react';
 declare const API: FC<{
     id?: string;
+    type?: 'props' | 'events' | 'slots' | 'methods';
 }>;
 export default API;