dumi 2.0.0-beta.2 → 2.0.0-beta.3

package/dist/assetParsers/atom.d.ts

@@ -0,0 +1,21 @@
+import { AtomComponentAsset, AtomFunctionAsset } from 'dumi-assets-types';
+declare class AtomAssetsParser {
+    private entryDir;
+    private resolveDir;
+    private unresolvedFiles;
+    private parser;
+    private resolverDeferrer;
+    private watcher;
+    private cbs;
+    constructor(opts: {
+        entryFile: string;
+        resolveDir: string;
+        watch?: boolean;
+    });
+    parse(): Promise<{
+        components: Record<string, AtomComponentAsset>;
+        functions: Record<string, AtomFunctionAsset>;
+    }>;
+    watch(cb: AtomAssetsParser['cbs'][number]): void;
+}
+export default AtomAssetsParser;

package/dist/assetParsers/atom.js

@@ -0,0 +1,112 @@
+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(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/assetParsers/atom.ts
+var atom_exports = {};
+__export(atom_exports, {
+  default: () => atom_default
+});
+module.exports = __toCommonJS(atom_exports);
+var import_parser = require("dumi-afx-deps/compiled/parser");
+var import_path = __toESM(require("path"));
+var import_plugin_utils = require("umi/plugin-utils");
+var MAX_PARSE_SIZE = 1024 * 512;
+var AtomAssetsParser = class {
+  constructor(opts) {
+    this.unresolvedFiles = [];
+    this.watcher = null;
+    this.cbs = [];
+    this.resolveDir = opts.resolveDir;
+    this.entryDir = import_path.default.relative(opts.resolveDir, import_path.default.dirname(opts.entryFile));
+    this.parser = new import_parser.SchemaParser({
+      entryPath: opts.entryFile,
+      basePath: opts.resolveDir,
+      unPkgHost: "https://unpkg.com"
+    });
+  }
+  async parse() {
+    if (!this.resolverDeferrer || this.unresolvedFiles.length) {
+      this.resolverDeferrer = (async () => {
+        await this.parser.patch(this.unresolvedFiles);
+        return new import_parser.SchemaResolver(await this.parser.parse());
+      })();
+    }
+    return this.resolverDeferrer.then((resolver) => {
+      const components = {};
+      const functions = {};
+      resolver.componentList.forEach((id) => {
+        let propsConfig = resolver.getComponent(id).props;
+        const size = Buffer.byteLength(JSON.stringify(propsConfig));
+        if (size > MAX_PARSE_SIZE) {
+          propsConfig = { type: "object", properties: {} };
+          import_plugin_utils.logger.warn(`Parsed component ${id} props size ${size} exceeds 512KB, skip it.`);
+        }
+        components[id] = {
+          type: "COMPONENT",
+          id,
+          title: id,
+          propsConfig
+        };
+      });
+      resolver.functionList.forEach((id) => {
+        let signature = resolver.getFunction(id).signature;
+        const size = Buffer.byteLength(JSON.stringify(signature));
+        if (size > MAX_PARSE_SIZE) {
+          signature = { arguments: [] };
+          import_plugin_utils.logger.warn(`Parsed function ${id} signature size ${size} exceeds 512KB, skip it.`);
+        }
+        functions[id] = {
+          type: "FUNCTION",
+          id,
+          title: id,
+          signature
+        };
+      });
+      return { components, functions };
+    });
+  }
+  watch(cb) {
+    this.cbs.push(cb);
+    if (!this.watcher) {
+      const lazyParse = import_plugin_utils.lodash.debounce(() => {
+        this.parse().then((data) => this.cbs.forEach((cb2) => cb2(data)));
+      }, 100);
+      this.watcher = import_plugin_utils.chokidar.watch(this.entryDir, {
+        cwd: this.resolveDir,
+        ignored: [
+          "**/.*",
+          "**/.*/**",
+          "**/_*",
+          "**/_*/**",
+          "**/*.{md,less,scss,sass,styl,css}"
+        ]
+      }).on("all", (ev, file) => {
+        if (["add", "change"].includes(ev) && /\.(j|t)sx?$/.test(file)) {
+          this.unresolvedFiles.push(file);
+          lazyParse();
+        }
+      });
+    }
+  }
+};
+var atom_default = AtomAssetsParser;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {});

package/dist/assetParsers/block.d.ts

@@ -1,13 +1,10 @@
+import { parseCodeFrontmatter } from "../utils";
 import type { ExampleBlockAsset } from 'dumi-assets-types';
 export interface IParsedBlockAsset {
     asset: ExampleBlockAsset;
     sources: Record<string, string>;
     frontmatter: ReturnType<typeof parseCodeFrontmatter>['frontmatter'];
 }
-declare function parseCodeFrontmatter(raw: string): {
-    code: string;
-    frontmatter: Record<string, any> | null;
-};
 declare function parseBlockAsset(opts: {
     fileAbsPath: string;
     id: string;

package/dist/assetParsers/block.js

@@ -25,21 +25,11 @@ __export(block_exports, {
   default: () => block_default
 });
 module.exports = __toCommonJS(block_exports);
+var import_utils = require("../utils");
 var import_esbuild = require("@umijs/bundler-utils/compiled/esbuild");
 var import_fs = __toESM(require("fs"));
-var import_js_yaml = __toESM(require("js-yaml"));
 var import_path = __toESM(require("path"));
 var import_plugin_utils = require("umi/plugin-utils");
-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");
-  let frontmatter = null;
-  try {
-    frontmatter = import_js_yaml.default.load(yamlComment);
-  } catch {
-  }
-  return { code: frontmatter ? code : raw, frontmatter };
-}
 async function parseBlockAsset(opts) {
   const asset = {
     type: "BLOCK",
@@ -101,7 +91,7 @@ async function parseBlockAsset(opts) {
                 value: opts.entryPointCode ?? import_fs.default.readFileSync(args.path, "utf-8")
               };
               if (isEntryPoint) {
-                const { code, frontmatter } = parseCodeFrontmatter(asset.dependencies[filename].value);
+                const { code, frontmatter } = (0, import_utils.parseCodeFrontmatter)(asset.dependencies[filename].value);
                 if (frontmatter) {
                   asset.dependencies[filename].value = code;
                   result.frontmatter = frontmatter;

package/dist/client/theme-api/context.d.ts

@@ -1,3 +1,4 @@
+import type { AtomComponentAsset } from 'dumi-assets-types';
 import { type ComponentType } from 'react';
 import type { ILocalesConfig, IPreviewerProps, IThemeConfig } from './types';
 interface ISiteContext {
@@ -5,6 +6,7 @@ interface ISiteContext {
         component: ComponentType;
         asset: IPreviewerProps['asset'];
     }>;
+    components: Record<string, AtomComponentAsset>;
     locales: NonNullable<ILocalesConfig>;
     themeConfig: IThemeConfig;
     loading: boolean;

package/dist/client/theme-api/context.js

@@ -1,6 +1,7 @@
 import { createContext, useContext } from 'react';
 export var SiteContext = /*#__PURE__*/createContext({
   demos: {},
+  components: {},
   locales: [],
   themeConfig: {},
   loading: false,

package/dist/client/theme-api/index.d.ts

@@ -3,6 +3,7 @@ export { useSiteData } from './context';
 export { DumiDemo } from './DumiDemo';
 export { DumiDemoGrid } from './DumiDemoGrid';
 export type { IPreviewerProps } from './types';
+export { useAtomAssets } from './useAtomAssets';
 export { useLocale } from './useLocale';
 export { useNavData } from './useNavData';
 export { useRouteMeta } from './useRouteMeta';

package/dist/client/theme-api/index.js

@@ -2,6 +2,7 @@ export { useIntl } from 'react-intl';
 export { useSiteData } from "./context";
 export { DumiDemo } from "./DumiDemo";
 export { DumiDemoGrid } from "./DumiDemoGrid";
+export { useAtomAssets } from "./useAtomAssets";
 export { useLocale } from "./useLocale";
 export { useNavData } from "./useNavData";
 export { useRouteMeta } from "./useRouteMeta";

package/dist/client/theme-api/useAtomAssets.d.ts

@@ -0,0 +1,4 @@
+import { AtomComponentAsset } from 'dumi-assets-types';
+export declare const useAtomAssets: () => {
+    components: Record<string, AtomComponentAsset>;
+};

package/dist/client/theme-api/useAtomAssets.js

@@ -0,0 +1,9 @@
+import { useSiteData } from 'dumi';
+export var useAtomAssets = function useAtomAssets() {
+  var _useSiteData = useSiteData(),
+      components = _useSiteData.components;
+
+  return {
+    components: components
+  };
+};

package/dist/features/compile.js

@@ -50,13 +50,14 @@ var compile_default = (api) => {
       extraRemarkPlugins: api.config.extraRemarkPlugins,
       extraRehypePlugins: api.config.extraRehypePlugins
     };
-    memo.module.rule("dumi-md").type("javascript/auto").test(/\.md$/).oneOf("md-meta").resourceQuery(/meta$/).use("md-meta-loader").loader(loaderPath).options({
+    memo.module.rule("dumi-md").type("javascript/auto").test(/\.md$/).oneOf("md-meta").resourceQuery(/meta$/).use("babel-loader").loader(babelInUmi.loader).options(babelInUmi.options).end().use("md-meta-loader").loader(loaderPath).options({
       ...loaderBaseOpts,
       mode: "meta"
     }).end().end().oneOf("md").use("babel-loader").loader(babelInUmi.loader).options(babelInUmi.options).end().use("md-loader").loader(loaderPath).options({
       ...loaderBaseOpts,
       builtins: api.service.themeData.builtins
     });
+    memo.module.rule("dumi-page").type("javascript/auto").test(/\.(j|t)sx?$/).resourceQuery(/meta$/).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").resourceQuery(/raw/).use("raw-loader").loader(require.resolve("raw-loader"));
     if (api.env === "development") {

package/dist/features/configPlugins/schema.js

@@ -30,7 +30,8 @@ function getSchemas() {
     resolve: (Joi) => Joi.object({
       docDirs: Joi.array().items(Joi.string()).optional(),
       entityDirs: Joi.array().items(Joi.object({ type: Joi.string(), dir: Joi.string() })).optional(),
-      codeBlockMode: Joi.string().valid("active", "passive").optional()
+      codeBlockMode: Joi.string().valid("active", "passive").optional(),
+      entryFile: Joi.string().optional()
     }).optional(),
     extraRemarkPlugins: getUnifiedPluginSchema,
     extraRehypePlugins: getUnifiedPluginSchema,

package/dist/features/meta.d.ts

@@ -1,3 +1,4 @@
 import type { IApi } from "../types";
+export declare const ATOMS_META_PATH = "dumi/meta/atoms.ts";
 declare const _default: (api: IApi) => void;
 export default _default;

package/dist/features/meta.js

@@ -19,18 +19,20 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/features/meta.ts
 var meta_exports = {};
 __export(meta_exports, {
+  ATOMS_META_PATH: () => ATOMS_META_PATH,
   default: () => meta_default
 });
 module.exports = __toCommonJS(meta_exports);
 var import_plugin_utils = require("umi/plugin-utils");
+var ATOMS_META_PATH = "dumi/meta/atoms.ts";
 var meta_default = (api) => {
-  const mdRouteFiles = [];
+  const routeFiles = [];
   api.modifyRoutes((routes) => {
-    mdRouteFiles.length = 0;
+    routeFiles.length = 0;
     Object.values(routes).forEach((route) => {
-      if (route.file.endsWith(".md")) {
-        mdRouteFiles.push({
-          index: mdRouteFiles.length,
+      if (!route.isLayout && !/\*|:/.test(route.path)) {
+        routeFiles.push({
+          index: routeFiles.length,
           file: route.file,
           id: route.id
         });
@@ -39,24 +41,31 @@ var meta_default = (api) => {
     return routes;
   });
   api.onGenerateFiles(() => {
+    api.writeTmpFile({
+      noPluginDir: true,
+      path: ATOMS_META_PATH,
+      content: "export const components = null;"
+    });
     api.writeTmpFile({
       noPluginDir: true,
       path: "dumi/meta/index.ts",
-      content: import_plugin_utils.Mustache.render(`{{#mdRouteFiles}}
+      content: import_plugin_utils.Mustache.render(`{{#routeFiles}}
 import { demos as d{{{index}}}, frontmatter as fm{{{index}}}, toc as toc{{{index}}} } from '{{{file}}}?type=meta';
-{{/mdRouteFiles}}
+{{/routeFiles}}
+
+export { components } from './atoms';
 
 export const demos = {
-  {{#mdRouteFiles}}
+  {{#routeFiles}}
   ...d{{{index}}},
-  {{/mdRouteFiles}}
+  {{/routeFiles}}
 };
 
 export const routesMeta = {
-  {{#mdRouteFiles}}
+  {{#routeFiles}}
   '{{{id}}}': { frontmatter: fm{{{index}}}, toc: toc{{{index}}} },
-  {{/mdRouteFiles}}
-}`, { mdRouteFiles })
+  {{/routeFiles}}
+}`, { routeFiles })
     });
     api.writeTmpFile({
       noPluginDir: true,
@@ -75,4 +84,6 @@ export const patchRoutes = ({ routes }) => {
   api.addRuntimePlugin(() => "@@/dumi/meta/runtime.ts");
 };
 // Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {});
+0 && (module.exports = {
+  ATOMS_META_PATH
+});

package/dist/features/parser.d.ts

@@ -0,0 +1,3 @@
+import type { IApi } from "../types";
+declare const _default: (api: IApi) => void;
+export default _default;

package/dist/features/parser.js

@@ -0,0 +1,60 @@
+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(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/features/parser.ts
+var parser_exports = {};
+__export(parser_exports, {
+  default: () => parser_default
+});
+module.exports = __toCommonJS(parser_exports);
+var import_atom = __toESM(require("../assetParsers/atom"));
+var import_meta = require("./meta");
+var parser_default = (api) => {
+  const writeAtomsMetaFile = (data) => {
+    api.writeTmpFile({
+      noPluginDir: true,
+      path: import_meta.ATOMS_META_PATH,
+      content: `export const components = ${JSON.stringify(data.components, null, 2)};`
+    });
+  };
+  api.describe({ key: "apiParser", enableBy: api.EnableBy.config });
+  api.modifyDefaultConfig((memo) => {
+    var _a;
+    if (!((_a = api.userConfig.resolve) == null ? void 0 : _a.entryFile)) {
+      api.logger.error("`resolve.entryFile` must be configured when `apiParser` enable");
+      process.exit(1);
+    }
+    return memo;
+  });
+  api.onStart(() => {
+    api.service.atomParser = new import_atom.default({
+      entryFile: api.config.resolve.entryFile,
+      resolveDir: api.cwd
+    });
+    if (api.env === "production") {
+      api.service.atomParser.parse().then(writeAtomsMetaFile);
+    } else {
+      api.service.atomParser.watch(writeAtomsMetaFile);
+    }
+  });
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {});

package/dist/features/routes.js

@@ -162,7 +162,7 @@ var routes_default = (api) => {
     const layouts = [
       {
         id: CTX_LAYOUT_ID,
-        file: "@/.umi/dumi/theme/ContextWrapper.tsx"
+        file: `${api.paths.absTmpPath}/dumi/theme/ContextWrapper.tsx`
       }
     ];
     const { GlobalLayout } = api.service.themeData.layouts;

package/dist/features/theme/index.js

@@ -109,7 +109,7 @@ export { default } from '${item.source}';`
       content: `import React, { useState, useEffect } from 'react';
 import { useOutlet, history } from 'dumi';
 import { SiteContext } from '${(0, import_plugin_utils.winPath)(require.resolve("../../client/theme-api/context"))}';
-import { demos } from '../meta';
+import { demos, components } from '../meta';
 import { locales } from '../locales/config';
 
 export default function DumiContextWrapper() {
@@ -124,6 +124,7 @@ export default function DumiContextWrapper() {
   return (
     <SiteContext.Provider value={{
       demos,
+      components,
       locales,
       loading,
       setLoading,

package/dist/loaders/page/index.d.ts

@@ -0,0 +1 @@
+export default function pageMetaLoader(this: any, raw: string): string;

package/dist/loaders/page/index.js

@@ -0,0 +1,41 @@
+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(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/loaders/page/index.ts
+var page_exports = {};
+__export(page_exports, {
+  default: () => pageMetaLoader
+});
+module.exports = __toCommonJS(page_exports);
+var import_utils = require("../../utils");
+var import_path = __toESM(require("path"));
+var import_plugin_utils = require("umi/plugin-utils");
+function pageMetaLoader(raw) {
+  const pathWithoutIndex = this.resourcePath.replace(/(\/index([^/]+)?)?\.(j|t)sx?$/, "");
+  let { frontmatter } = (0, import_utils.parseCodeFrontmatter)(raw);
+  frontmatter || (frontmatter = {});
+  frontmatter.title ?? (frontmatter.title = import_plugin_utils.lodash.startCase(import_path.default.basename(pathWithoutIndex)));
+  return `export const frontmatter = ${JSON.stringify(frontmatter)};
+export const toc = [];
+export const demos = {};`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {});

package/dist/preset.js

@@ -37,7 +37,8 @@ var preset_default = (api) => {
       require.resolve("./features/routes"),
       require.resolve("./features/meta"),
       require.resolve("./features/theme"),
-      require.resolve("./features/locales")
+      require.resolve("./features/locales"),
+      require.resolve("./features/parser")
     ]
   };
 };

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type AtomAssetsParser from "./assetParsers/atom";
 import type { IDumiDemoProps } from "./client/theme-api/DumiDemo";
 import type { ILocalesConfig, IThemeConfig } from "./client/theme-api/types";
 import type { IThemeLoadResult } from "./features/theme/loader";
@@ -14,6 +15,7 @@ export interface IDumiConfig extends IUmiConfig {
             dir: string;
         }[];
         codeBlockMode: 'active' | 'passive';
+        entryFile?: string;
     };
     locales: ILocalesConfig;
     themeConfig: IThemeConfig;
@@ -62,6 +64,7 @@ export declare type IApi = IUmiApi & {
     userConfig: IDumiUserConfig;
     service: IUmiApi['service'] & {
         themeData: IThemeLoadResult;
+        atomParser: AtomAssetsParser;
     };
     /**
      * register a new tech stack

package/dist/utils.d.ts

@@ -13,3 +13,10 @@ export declare const getFileRangeLines: (content: string, range: string) => stri
  * @param filePath  source file path
  */
 export declare const getFileContentByRegExp: (content: string, regexp: string, filePath: string) => string;
+/**
+ * parse frontmatter from code string
+ */
+export declare function parseCodeFrontmatter(raw: string): {
+    code: string;
+    frontmatter: Record<string, any> | null;
+};

package/dist/utils.js

@@ -1,6 +1,8 @@
+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)
@@ -14,6 +16,7 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/utils.ts
@@ -21,9 +24,11 @@ var utils_exports = {};
 __export(utils_exports, {
   getFileContentByRegExp: () => getFileContentByRegExp,
   getFileRangeLines: () => getFileRangeLines,
-  getRoutePathFromFsPath: () => getRoutePathFromFsPath
+  getRoutePathFromFsPath: () => getRoutePathFromFsPath,
+  parseCodeFrontmatter: () => parseCodeFrontmatter
 });
 module.exports = __toCommonJS(utils_exports);
+var import_js_yaml = __toESM(require("js-yaml"));
 var import_plugin_utils = require("umi/plugin-utils");
 function getRoutePathFromFsPath(fsPath) {
   return import_plugin_utils.lodash.kebabCase((0, import_plugin_utils.winPath)(fsPath).replace(/((\/|^)index(\.[a-zA-Z-]+)?)?\.\w+$/g, ""));
@@ -48,9 +53,20 @@ Error: ${err}`);
     return content;
   }
 };
+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");
+  let frontmatter = null;
+  try {
+    frontmatter = import_js_yaml.default.load(yamlComment);
+  } catch {
+  }
+  return { code: frontmatter ? code : raw, frontmatter };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getFileContentByRegExp,
   getFileRangeLines,
-  getRoutePathFromFsPath
+  getRoutePathFromFsPath,
+  parseCodeFrontmatter
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dumi",
-  "version": "2.0.0-beta.2",
+  "version": "2.0.0-beta.3",
   "description": "Framework for developing UI components",
   "keywords": [],
   "license": "MIT",
@@ -59,6 +59,7 @@
     "@types/mdast": "^3.0.10",
     "@umijs/bundler-utils": "^4.0.22",
     "@umijs/core": "^4.0.22",
+    "dumi-afx-deps": "^1.0.0-alpha.1",
     "dumi-assets-types": "2.0.0-alpha.0",
     "estree-util-to-js": "^1.1.0",
     "estree-util-visit": "^1.2.0",
@@ -110,7 +111,7 @@
     "@umijs/test": "^4.0.22",
     "cross-env": "^7.0.3",
     "eslint": "^8.20.0",
-    "father": "^4.0.3",
+    "father": "^4.0.7",
     "husky": "^8.0.1",
     "jest": "^27.0.0",
     "lint-staged": "^13.0.3",

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

@@ -0,0 +1,5 @@
+import { type FC } from 'react';
+declare const API: FC<{
+    id: string;
+}>;
+export default API;

package/theme-default/builtins/API/index.js

@@ -0,0 +1,57 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
+function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+
+import { useAtomAssets, useIntl } from 'dumi';
+import React from 'react';
+
+var API = function API(_ref) {
+  var _definition$propsConf;
+
+  var id = _ref.id;
+
+  var _useAtomAssets = useAtomAssets(),
+      components = _useAtomAssets.components;
+
+  var definition = components === null || components === void 0 ? void 0 : components[id];
+  var intl = useIntl();
+  return /*#__PURE__*/React.createElement("div", {
+    className: "markdown"
+  }, /*#__PURE__*/React.createElement("table", null, /*#__PURE__*/React.createElement("thead", null, /*#__PURE__*/React.createElement("tr", null, /*#__PURE__*/React.createElement("th", null, intl.formatMessage({
+    id: 'api.component.name'
+  })), /*#__PURE__*/React.createElement("th", null, intl.formatMessage({
+    id: 'api.component.description'
+  })), /*#__PURE__*/React.createElement("th", null, intl.formatMessage({
+    id: 'api.component.type'
+  })), /*#__PURE__*/React.createElement("th", null, intl.formatMessage({
+    id: 'api.component.default'
+  })))), /*#__PURE__*/React.createElement("tbody", null, definition && (_definition$propsConf = definition.propsConfig) !== null && _definition$propsConf !== void 0 && _definition$propsConf.properties ? Object.entries(definition.propsConfig.properties).map(function (_ref2) {
+    var _definition$propsConf2;
+
+    var _ref3 = _slicedToArray(_ref2, 2),
+        name = _ref3[0],
+        prop = _ref3[1];
+
+    return /*#__PURE__*/React.createElement("tr", {
+      key: name
+    }, /*#__PURE__*/React.createElement("td", null, name), /*#__PURE__*/React.createElement("td", null, prop.description || '--'), /*#__PURE__*/React.createElement("td", null, /*#__PURE__*/React.createElement("code", null, prop.type)), /*#__PURE__*/React.createElement("td", null, /*#__PURE__*/React.createElement("code", null, (_definition$propsConf2 = definition.propsConfig.required) !== null && _definition$propsConf2 !== void 0 && _definition$propsConf2.includes(name) ? intl.formatMessage({
+      id: 'api.component.required'
+    }) : prop.default || '--')));
+  }) : /*#__PURE__*/React.createElement("tr", null, /*#__PURE__*/React.createElement("td", {
+    colSpan: 4
+  }, intl.formatMessage({
+    id: "api.component.".concat(components ? 'not.found' : 'loading')
+  }, {
+    id: id
+  }))))));
+};
+
+export default API;

package/theme-default/locales/en-US.json

@@ -7,5 +7,12 @@
   "previewer.actions.codepen": "Open in CodePen (Not implemented)",
   "previewer.actions.separate": "Open in separate page",
   "404.title": "PAGE NOT FOUND",
-  "404.back": "Back to homepage"
+  "404.back": "Back to homepage",
+  "api.component.name": "Name",
+  "api.component.description": "Description",
+  "api.component.type": "Type",
+  "api.component.default": "Default",
+  "api.component.required": "(required)",
+  "api.component.loading": "Properties definition is resolving, wait a moment...",
+  "api.component.not.found": "Properties definition not found for {id} component"
 }

package/theme-default/locales/zh-CN.json

@@ -7,5 +7,12 @@
   "previewer.actions.codepen": "在 CodePen 中打开（未实现）",
   "previewer.actions.separate": "在独立页面中打开",
   "404.title": "页面未找到",
-  "404.back": "返回首页"
+  "404.back": "返回首页",
+  "api.component.name": "属性名",
+  "api.component.description": "描述",
+  "api.component.type": "类型",
+  "api.component.default": "默认值",
+  "api.component.required": "(必选)",
+  "api.component.loading": "属性定义正在解析中，稍等片刻...",
+  "api.component.not.found": "未找到 {id} 组件的属性定义"
 }

package/theme-default/slots/Content/index.less

@@ -23,6 +23,24 @@
     padding-right: 24px;
     background-color: tint(@c-site-bg, 50%);
   }
+
+  // table
+  table {
+    width: 100%;
+  }
+
+  th {
+    background-color: tint(@c-site-bg, 50%);
+  }
+
+  th,
+  td {
+    padding-block-start: 10px;
+    padding-block-end: 10px;
+    padding-inline-start: 16px;
+    padding-inline-end: 16px;
+    border-color: @c-border-light;
+  }
 }
 
 .@{prefix}-content {

package/dist/client/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "paths": {
-      "@/*": ["src/*"],
-      "@@/*": ["src/.umi/*"],
-      "dumi": ["."],
-      "dumi/theme": ["src/client/theme-api"],
-      "dumi/theme/*": ["src/client/theme-default/*"]
-    },
-    "types": ["../../src/.umi/typings"]
-  }
-}