@umijs/plugin-docs 4.0.0-beta.18 → 4.0.0-rc.3

package/client/theme-doc/useLanguage.ts

@@ -0,0 +1,69 @@
+import { useThemeContext } from './context';
+
+interface useLanguageResult {
+  isFromPath: boolean;
+  currentLanguage: { locale: string; text: string } | undefined;
+  languages: { locale: string; text: string }[];
+  switchLanguage: (locale: string) => void;
+  render: (key: string) => string;
+}
+
+function useLanguage(): useLanguageResult {
+  const { themeConfig, location } = useThemeContext()!;
+
+  const languages = themeConfig.i18n;
+  let currentLanguage: { locale: string; text: string } | undefined = undefined;
+  let isFromPath: boolean;
+
+  const s = location.pathname.split('/')[1];
+
+  // 用户当前访问的页面是否有在路径中指定语言
+  isFromPath = !!(s && s.match(/^[a-z]{2}-[A-Z]{2}$/));
+
+  if (isFromPath)
+    currentLanguage = languages?.find(
+      (item) => item.locale === location.pathname.split('/')[1],
+    );
+  else currentLanguage = languages && languages[0] ? languages[0] : undefined;
+
+  function switchLanguage(locale: string) {
+    if (!languages || languages.length === 0) return;
+
+    if (!languages.find((l) => l.locale === locale)) return;
+
+    // 切换到默认语言
+    if (locale === languages[0].locale && isFromPath) {
+      let p = location.pathname.split('/');
+      p.shift();
+      p.shift();
+      window.location.pathname = p.join('/');
+      return;
+    }
+
+    // 当前在默认语言，切换到其他语言
+    if (!isFromPath) {
+      window.location.pathname = locale + location.pathname;
+      return;
+    }
+
+    let p = location.pathname.split('/');
+    p[1] = locale;
+    window.location.pathname = p.join('/');
+  }
+
+  function render(key: string) {
+    if (!currentLanguage || !themeConfig.locales) return key;
+    if (!themeConfig.locales[currentLanguage.locale]) return key;
+    return themeConfig.locales[currentLanguage.locale][key] || key;
+  }
+
+  return {
+    isFromPath,
+    currentLanguage,
+    languages: languages || [],
+    switchLanguage,
+    render,
+  };
+}
+
+export default useLanguage;

package/dist/compiler.d.ts

@@ -1,5 +1,5 @@
 export declare function compile(opts: {
     content: string;
 }): Promise<{
-    result: any;
+    result: string;
 }>;

package/dist/compiler.js

@@ -14,20 +14,31 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.compile = void 0;
 // @ts-ignore
-const mdx_1 = __importDefault(require("@mdx-js/mdx"));
-const remark_slug_1 = __importDefault(require("remark-slug"));
+const mdx_1 = require("../compiled/@mdx-js/mdx");
+// @ts-ignore
+const rehype_slug_1 = __importDefault(require("../compiled/rehype-slug"));
 function compile(opts) {
     return __awaiter(this, void 0, void 0, function* () {
-        let result = yield (0, mdx_1.default)(opts.content, {
-            remarkPlugins: [remark_slug_1.default],
-            rehypePlugins: [],
-            compilers: [],
+        const compiler = (0, mdx_1.createProcessor)({
+            jsx: true,
+            remarkPlugins: [],
+            rehypePlugins: [rehype_slug_1.default],
         });
-        result = `
-import React from 'react';
-${result}`;
-        result = result.replace('/* @jsxRuntime classic */', '');
-        result = result.replace('/* @jsx mdx */', '');
+        let result = String(yield compiler.process(opts.content));
+        result = result.replace('function MDXContent(props = {}) {', `
+import { useEffect } from 'react';
+
+function MDXContent(props = {}) {
+
+  useEffect(() => {
+    if (window.location.hash.length !== 0) {
+      const hash = window.location.hash;
+      window.location.hash = '';
+      window.location.hash = hash;
+    }
+  }, []);
+
+`);
         return { result };
     });
 }

package/dist/index.js

@@ -19,6 +19,8 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const bundler_utils_1 = require("@umijs/bundler-utils");
+const utils_1 = require("@umijs/utils");
 const fs_1 = __importStar(require("fs"));
 const path_1 = require("path");
 const markdown_1 = require("./markdown");
@@ -55,6 +57,13 @@ exports.default = (api) => {
         }
     });
     api.onGenerateFiles(() => {
+        var _a;
+        // theme path
+        let theme = ((_a = api.config.docs) === null || _a === void 0 ? void 0 : _a.theme) || require.resolve('../client/theme-doc/index.ts');
+        if (theme === 'blog') {
+            theme = require.resolve('../client/theme-blog/index.ts');
+        }
+        theme = (0, utils_1.winPath)(theme);
         const themeConfigPath = (0, path_1.join)(api.cwd, 'theme.config.ts');
         const themeExists = (0, fs_1.existsSync)(themeConfigPath);
         // 将 docs/locales 目录下的 json 文件注入到 themeConfig.locales 中
@@ -72,11 +81,17 @@ exports.default = (api) => {
                 }
             });
         }
-        // @TODO: 需要能够动态解析 theme 中导出的组件，现在是硬编码
+        // exports don't start with $ will be MDX Component
+        const [_, exports] = (0, bundler_utils_1.parseModuleSync)({
+            content: (0, fs_1.readFileSync)(theme, 'utf-8'),
+            path: theme,
+        });
         api.writeTmpFile({
             path: 'index.ts',
             content: `
-export { Message } from '${require.resolve('../client/theme-doc')}';
+export { ${exports
+                .filter((item) => !item.startsWith('$'))
+                .join(', ')} } from '${require.resolve('../client/theme-doc/index.ts')}';
     `,
         });
         api.writeTmpFile({
@@ -84,7 +99,7 @@ export { Message } from '${require.resolve('../client/theme-doc')}';
             content: `
 import React from 'react';
 import { useOutlet, useAppData, useLocation, Link } from 'umi';
-import { Layout } from '${require.resolve('../client/theme-doc')}';
+import { $Layout as Layout } from '${require.resolve('../client/theme-doc/index.ts')}';
 ${themeExists
                 ? `import themeConfig from '${themeConfigPath}'`
                 : `const themeConfig = {}`}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umijs/plugin-docs",
-  "version": "4.0.0-beta.18",
+  "version": "4.0.0-rc.3",
   "description": "@umijs/plugin-docs",
   "homepage": "https://github.com/umijs/umi-next/tree/master/packages/plugin-docs#readme",
   "bugs": "https://github.com/umijs/umi-next/issues",
@@ -12,29 +12,44 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "client"
   ],
   "scripts": {
     "build": "pnpm tsc",
     "build:css": "tailwindcss -i ./client/theme-doc/tailwind.css -o ./client/theme-doc/tailwind.out.css",
     "build:deps": "pnpm esno ../../scripts/bundleDeps.ts",
+    "build:extra": "pnpm build:css",
     "dev": "pnpm build -- --watch"
   },
   "dependencies": {
-    "@mdx-js/mdx": "1.6.22",
-    "keymaster": "^1.6.2",
-    "remark-slug": "6.1.0"
+    "keymaster": "1.6.2",
+    "react-helmet": "^6.1.0"
   },
   "devDependencies": {
+    "@mdx-js/mdx": "2.0.0",
     "@types/keymaster": "^1.6.30",
+    "@types/react-helmet": "^6.1.5",
     "classnames": "^2.3.1",
-    "tailwindcss": "^3.0.15",
-    "umi": "4.0.0-beta.18"
+    "rehype-slug": "5.0.1",
+    "tailwindcss": "^3.0.23",
+    "umi": "4.0.0-rc.3"
   },
   "publishConfig": {
     "access": "public"
   },
   "authors": [
     "chencheng <sorrycc@gmail.com> (https://github.com/sorrycc)"
-  ]
+  ],
+  "compiledConfig": {
+    "deps": [
+      "@mdx-js/mdx",
+      "rehype-slug"
+    ],
+    "externals": {},
+    "excludeDtsDeps": [
+      "@mdx-js/mdx",
+      "rehype-slug"
+    ]
+  }
 }