@moneko/core 3.1.0-beta.2 → 3.1.0-beta.3

package/lib/dev.js

@@ -1,6 +1,90 @@
-import e from"@soda/friendly-errors-webpack-plugin";import o from"chalk";import r from"webpack";import{merge as t}from"webpack-merge";import{clientConfig as s}from"./common.js";import{CONFIG as p}from"./config.js";import{hasPkg as i}from"./has-pkg.js";import{getIPv4 as a,getPort as m}from"./net.js";import{isReact as n}from"./process-env.js";import{isFunction as l,resolveProgramPath as d}from"./utils.js";let{HotModuleReplacementPlugin:c}=r,{yellow:v,green:f}=o,h=a(),w=p.devServer.port||3e3,u=await m(w,65535,p.devServer.host),g=p.devServer.port!==u,k=i("@moneko/mock"),$=k&&(await import("@moneko/mock")).default,S=n&&(await import("@pmmmwh/react-refresh-webpack-plugin")).default,b=!1===p.devtool||p.devtool?p.devtool:"eval-cheap-module-source-map";p.devServer.port=u;let y="/"===p.basename,j=p.devServer.https?"https:":"http:",x=y?"":p.basename,A=t(s,{devtool:b,mode:"development",devServer:{headers:{"Access-Control-Allow-Origin":"*"},compress:p.devServer.compress,host:"0.0.0.0",port:u,historyApiFallback:y||{index:x.endsWith("/")?x:`${x}/`,disableDotRule:!0},https:p.devServer.https,proxy:p.proxy,allowedHosts:p.devServer.allowedHosts,client:{// 在浏览器中以百分比显示编译进度。
-progress:!1,logging:"info",// 当出现编译错误或警告时，在浏览器中显示全屏覆盖。
-overlay:!1},static:{watch:{ignored:e=>e.endsWith(".d.ts")||/\/node_modules\//.test(e)}},setupMiddlewares:(e,o)=>{if(!o)throw Error("webpack-dev-server is not defined");return o.app&&l($)&&$(o.app,d("mock/")),e},open:!1,hot:!0},plugins:[new c,S&&new S,new e({compilationSuccessInfo:{messages:[`You application is running here:
+import FriendlyErrorsWebpackPlugin from '@soda/friendly-errors-webpack-plugin';
+import chalk from 'chalk';
+import webpack from 'webpack';
+import { merge } from 'webpack-merge';
+import { clientConfig } from './common.js';
+import { CONFIG } from './config.js';
+import { hasPkg } from './has-pkg.js';
+import { getIPv4, getPort } from './net.js';
+import { isReact } from './process-env.js';
+import { isFunction, resolveProgramPath } from './utils.js';
+const { HotModuleReplacementPlugin } = webpack;
+const { yellow, green } = chalk;
+const ip = getIPv4();
+const oldPord = CONFIG.devServer.port || 3000;
+const port = await getPort(oldPord, 65535, CONFIG.devServer.host);
+const skipPort = CONFIG.devServer.port !== port;
+const hasMockMiddlewares = hasPkg('@moneko/mock');
+const mockMiddlewares = hasMockMiddlewares && (await import('@moneko/mock')).default;
+const ReactRefresh = isReact && (await import('@pmmmwh/react-refresh-webpack-plugin')).default;
+const devtool = CONFIG.devtool === false || CONFIG.devtool ? CONFIG.devtool : 'eval-cheap-module-source-map';
+CONFIG.devServer.port = port;
+const initRouteBase = CONFIG.basename === '/';
+const protocol = CONFIG.devServer.https ? 'https:' : 'http:';
+const routeBase = initRouteBase ? '' : CONFIG.basename;
+const client = merge(clientConfig, {
+    devtool: devtool,
+    mode: 'development',
+    devServer: {
+        headers: {
+            'Access-Control-Allow-Origin': '*'
+        },
+        compress: CONFIG.devServer.compress,
+        host: '0.0.0.0',
+        port: port,
+        historyApiFallback: initRouteBase || {
+            index: routeBase.endsWith('/') ? routeBase : `${routeBase}/`,
+            disableDotRule: true
+        },
+        https: CONFIG.devServer.https,
+        proxy: CONFIG.proxy,
+        allowedHosts: CONFIG.devServer.allowedHosts,
+        client: {
+            // 在浏览器中以百分比显示编译进度。
+            progress: false,
+            logging: 'info',
+            // 当出现编译错误或警告时，在浏览器中显示全屏覆盖。
+            overlay: false
+        },
+        static: {
+            watch: {
+                ignored: (f)=>{
+                    // 生成的类型定义不要监听，否则会引发全局的 reload 使 HMR 失去意义
+                    return f.endsWith('.d.ts') || /\/node_modules\//.test(f);
+                }
+            }
+        },
+        setupMiddlewares: (middlewares, devServer)=>{
+            if (!devServer) {
+                throw new Error('webpack-dev-server is not defined');
+            }
+            if (devServer.app && isFunction(mockMiddlewares)) {
+                mockMiddlewares(devServer.app, resolveProgramPath('mock/'));
+            }
+            return middlewares;
+        },
+        open: false,
+        hot: true
+    },
+    plugins: [
+        new HotModuleReplacementPlugin(),
+        ReactRefresh && new ReactRefresh(),
+        new FriendlyErrorsWebpackPlugin({
+            compilationSuccessInfo: {
+                messages: [
+                    `You application is running here:
 
-    Local:   ${o.cyan(`${j}//${p.devServer.host}:${u}${x}`)}
-    Network: ${o.cyan(`${j}//${h}:${u}${x}`)}`],notes:g?[`Port ${v(w)} is in use, trying ${f(u)} instead`]:[]},clearConsole:!0})].filter(Boolean)});export default[A];
+    Local:   ${chalk.cyan(`${protocol}//${CONFIG.devServer.host}:${port}${routeBase}`)}
+    Network: ${chalk.cyan(`${protocol}//${ip}:${port}${routeBase}`)}`
+                ],
+                notes: skipPort ? [
+                    `Port ${yellow(oldPord)} is in use, trying ${green(port)} instead`
+                ] : []
+            },
+            clearConsole: true
+        })
+    ].filter(Boolean)
+});
+export default [
+    client
+];

package/lib/docs.js

@@ -1,2 +1,107 @@
-import{statSync as e}from"fs";import{dirname as t,join as r}from"path";import{watch as o}from"chokidar";import{CONFIG as n}from"./config.js";import i from"./generate-api.js";import s from"./object-listener.js";import{FRAMEWORK as p,FRAMEWORKNAME as l,createElement as a,isLibrary as c,isReact as d,isSolid as m}from"./process-env.js";import{resolveProgramPath as f}from"./utils.js";let u="@app/comment";export const docs=s({});let $={[u]:{}},g=`() => ${a}(SuspenseComp, { comp: $1 })`,b=`import { ${a}${m?",Dynamic":""} } from "${l}${m?"/web":""}";import SuspenseComp from "@app/suspense";`;// 要执行的函数
-function h(e,o){let s=e.replace(RegExp(`^${n.alias["@pkg"]}`),""),p=t(s).replace(/^\//,""),l=[u,p].join("/"),c=s.split("/").pop()?.replace(/\.tsx?/,".md");if(!c)return;$[u][p]||($[u][p]={});let f=r(l,c);if("deleted"===o)$[u][p][c]&&delete $[u][p][c];else{let t=i(e);$[f]=t,t?$[u][p][c]=`rr(() => import(/* webpackChunkName: '${f}' */'${f}?raw').then((res) => ({default: ${d?"() =>":""}${a}(${m?"Dynamic":"'n-md'"}, {text: res.default, ${m?"component: 'n-md', ":""}css: 'table td a {display:inline-flex;align-items:center;gap:2px;}table td a n-img{display:inline-block;overflow:hidden;border-radius:var(--border-radius);inline-size:18px;block-size:18px;}'})})))rr`:$[u][p][c]&&delete $[u][p][c]}let h={};for(let e in $[u])Object.prototype.hasOwnProperty.call($[u],e)&&(h[e]=Object.values($[u][e]));let x={...$};delete x[u],Object.assign(docs.data,{...x,"@app/docs":`${b}export default ${JSON.stringify(h).replace(/"rr\((.+?)\)rr"/g,g)}`})}["react","solid"].includes(p)||(g="$1",b=""),c&&function(){let t=[],r=o(f("components"),{ignored:[/(^|[\\/\\])\../,/(^|[\\/\\])__tests__([\\/\\]|$)/],persistent:!0,ignoreInitial:!1});function n(t){return/\.tsx?$/.test(t)&&e(t).isFile()}r.on("add",e=>{n(e)&&(h(e,"added"),t.push(e))}),r.on("change",e=>{n(e)&&h(e,"change")}),r.on("unlink",e=>{n(e)&&(h(e,"deleted"),t.splice(t.indexOf(e),1))}),r.on("ready",()=>{t.forEach(e=>{h(e,"change")})}),process.on("SIGINT",function(){r.close()})}();
+import { statSync } from 'fs';
+import { dirname, join } from 'path';
+import { watch } from 'chokidar';
+import { CONFIG } from './config.js';
+import generateApi from './generate-api.js';
+import objectListener from './object-listener.js';
+import { FRAMEWORK, FRAMEWORKNAME, createElement, isLibrary, isReact, isSolid } from './process-env.js';
+import { resolveProgramPath } from './utils.js';
+const base = '@app/comment';
+const apiEntry = '@app/docs';
+export const docs = objectListener({});
+const cacheEnvApi = {
+    [base]: {}
+};
+let replaceStr = `() => ${createElement}(SuspenseComp, { comp: $1 })`;
+let prefixStr = `import { ${createElement}${isSolid ? ',Dynamic' : ''} } from "${FRAMEWORKNAME}${isSolid ? '/web' : ''}";import SuspenseComp from "@app/suspense";`;
+if (![
+    'react',
+    'solid'
+].includes(FRAMEWORK)) {
+    replaceStr = '$1';
+    prefixStr = '';
+}
+// 要执行的函数
+function handleFileChange(filePath, changeType) {
+    const fil = filePath.replace(new RegExp(`^${CONFIG.alias['@pkg']}`), '');
+    const __dir = dirname(fil).replace(/^\//, '');
+    const apiDir = [
+        base,
+        __dir
+    ].join('/');
+    const name = fil.split('/').pop()?.replace(/\.tsx?/, '.md');
+    if (!name) return;
+    if (!cacheEnvApi[base][__dir]) {
+        cacheEnvApi[base][__dir] = {};
+    }
+    const target = join(apiDir, name);
+    if (changeType === 'deleted') {
+        if (cacheEnvApi[base][__dir][name]) {
+            delete cacheEnvApi[base][__dir][name];
+        }
+    } else {
+        const api = generateApi(filePath);
+        cacheEnvApi[target] = api;
+        if (api) {
+            cacheEnvApi[base][__dir][name] = `rr(() => import(/* webpackChunkName: '${target}' */'${target}?raw').then((res) => ({default: ${isReact ? '() =>' : ''}${createElement}(${isSolid ? 'Dynamic' : "'n-md'"}, {text: res.default, ${isSolid ? "component: 'n-md', " : ''}css: 'table td a {display:inline-flex;align-items:center;gap:2px;}table td a n-img{display:inline-block;overflow:hidden;border-radius:var(--border-radius);inline-size:18px;block-size:18px;}'})})))rr`;
+        } else if (cacheEnvApi[base][__dir][name]) {
+            delete cacheEnvApi[base][__dir][name];
+        }
+    }
+    const basestr = {};
+    for(const k in cacheEnvApi[base]){
+        if (Object.prototype.hasOwnProperty.call(cacheEnvApi[base], k)) {
+            basestr[k] = Object.values(cacheEnvApi[base][k]);
+        }
+    }
+    const env = {
+        ...cacheEnvApi
+    };
+    delete env[base];
+    Object.assign(docs.data, {
+        ...env,
+        [apiEntry]: `${prefixStr}export default ${JSON.stringify(basestr).replace(/"rr\((.+?)\)rr"/g, replaceStr)}`
+    });
+}
+function watchDirectory() {
+    const files = [];
+    const watcher = watch(resolveProgramPath('components'), {
+        ignored: [
+            /(^|[\\/\\])\../,
+            /(^|[\\/\\])__tests__([\\/\\]|$)/
+        ],
+        persistent: true,
+        ignoreInitial: false
+    });
+    function isTs(path) {
+        return /\.tsx?$/.test(path) && statSync(path).isFile();
+    }
+    watcher.on('add', (path)=>{
+        if (isTs(path)) {
+            handleFileChange(path, 'added');
+            files.push(path);
+        }
+    });
+    watcher.on('change', (path)=>{
+        if (isTs(path)) {
+            handleFileChange(path, 'change');
+        }
+    });
+    watcher.on('unlink', (path)=>{
+        if (isTs(path)) {
+            handleFileChange(path, 'deleted');
+            files.splice(files.indexOf(path), 1);
+        }
+    });
+    watcher.on('ready', ()=>{
+        files.forEach((f)=>{
+            handleFileChange(f, 'change');
+        });
+    });
+    process.on('SIGINT', function() {
+        watcher.close();
+    });
+}
+if (isLibrary) {
+    watchDirectory();
+}

package/lib/done.js

@@ -1 +1,11 @@
-export default class{constructor(o){this.options=Object.assign({},o)}apply(o){o.hooks.done.tap("DoneWebpackPlugin",()=>{this.options.done?.()})}}
+class DoneWebpackPlugin {
+    constructor(options){
+        this.options = Object.assign({}, options);
+    }
+    apply(compiler) {
+        compiler.hooks.done.tap('DoneWebpackPlugin', ()=>{
+            this.options.done?.();
+        });
+    }
+}
+export default DoneWebpackPlugin;

package/lib/esm.js

@@ -1 +1,7 @@
-export default function t(t,...e){let r=t.raw[0];for(let a=0;a<e.length;a++)r+=e[a]+t.raw[a+1];return`data:text/javascript;base64,${Buffer.from(r).toString("base64")}`}
+export default function esm(templateStrings, ...substitutions) {
+    let js = templateStrings.raw[0];
+    for(let i = 0; i < substitutions.length; i++){
+        js += substitutions[i] + templateStrings.raw[i + 1];
+    }
+    return `data:text/javascript;base64,${Buffer.from(js).toString('base64')}`;
+}

package/lib/fallback.js

@@ -1 +1,6 @@
-import{CONFIG as l}from"./config.js";let a="export default null";l.fallbackCompPath&&(a=`import Fallback from "${l.fallbackCompPath}";export default Fallback;`);export default a;
+import { CONFIG } from './config.js';
+let fallback = 'export default null';
+if (CONFIG.fallbackCompPath) {
+    fallback = `import Fallback from "${CONFIG.fallbackCompPath}";export default Fallback;`;
+}
+export default fallback;

package/lib/generate-api.js

@@ -1,3 +1,341 @@
-import{readFileSync as e}from"fs";import{dirname as t}from"path";import n from"typescript";import{CONFIG as r}from"./config.js";let{ScriptKind:l,ScriptTarget:o,SyntaxKind:i,createSourceFile:a,forEachChild:c,getLeadingCommentRanges:u,isInterfaceDeclaration:s,isQuestionToken:f,isPropertySignature:p,isFunctionTypeNode:m,isUnionTypeNode:g,isMethodSignature:$}=n,h={};function b(e){let t=u(e.getSourceFile().text,e.pos);if(t){let n=e.getSourceFile().text.substring(t[0].pos,t[0].end),r=n.match(/\/\*\*([\s\S]*?)\*\//);if(r){let e=r[1].replace(/^\s*\* ?/gm,"").replace(/\s+$/,"").trim();return e}}return null}function d(e){if(!e)return null;let t=e.match(/@since\s+([^\n]+)/);return t?t[1].trim():null}function y(e){if(!e)return null;let t=e.match(/@author (\w+)\s*(?:<([^>]+)>)?/);if(t?.length){let e=t[1].trim(),n=t[2]?.trim(),r=/^[\w-]+(\.[\w-]+)*@[\w-]+(\.[\w-]+)+$/.test(n);return n?r&&(n=`mailto:${n}`):n=`https://github.com/${e}`,`[![${e}](https://avatars.githubusercontent.com/${e}?s=64)${e}](${n})`}return null}function x(e){if(!e)return null;let t=e.match(/@ignore\s+([^\n]+)/);return t?t[1].trim():null}let j=/(?<!['"])(unknown|any|void|bigint|object|undefined|null|boolean|number|string|symbol)(?!['"])/g;function T(e,t){if(!e)return null;let n=e.replace(/\b([A-Z][a-zA-Z0-9]*)\b/g,e=>{if(h[e]){let n=`/${[r.basename,h[e]].join("/").split("/").filter(Boolean).join("/")}`;return t?`[\\color{#009688}{${e}}](${n})`:`[${e}](${n})`}return t?`\\color{#009688}{${e}}`:e});return t&&(n=n.replace(j,e=>`\\color{#009688}{${e}}`)),n}function B(e){return(function(e){let t;if(!e)return null;let n=[];for(;t=/\\color{([^|}]*)\|?([^|}]*)\|?([^|}]*)\|?([^}]*)}{([^}]*)}/g.exec(e);)n.push(t[0]);return e.replace(/(\{|\}|\[|\]|\(|\)|=>|keyof|typeof|true|false)/g,e=>n.some(t=>t.includes(e))?e:`\\color{#569cd6}{${e}}`)})(e)?.replace(/^\s*\|\s*|\s*\|\s*$/gm,"").replace(/\n/g,"<br/>").replace(/\*/g,"\\*").replace(/\|/g,"\\|").replace(/(['"])((?:(?!\1).)*)\1/g,"\\color{#ce9178}{$1$2$1}")}function k(e){return e?e.replace(/^@[a-z].+/gm,"").replace(/(\n\s+)+/g,"<br />").replace(/\n/g,"<br />").replace(/(<br \/>)$/g,""):null}export default function w(u){let j=e(u,"utf-8"),w=a(u,j,o.Latest,!0,l.TS),E="";return c(w,e=>{s(e)?E+=function(e){let l=e.name.text;Object.assign(h,{[e.name.text]:t(e.getSourceFile().fileName).replace(r.alias["@pkg"],"")});let o=b(e),a=d(o),c=k(o),u=x(o)?.split("|")||[],s=u.includes("comment"),j=u.includes("initial"),w=u.includes("optional"),E=u.includes("version"),S=u.includes("author"),v=c?`\\color{|4||0.45}{${l}}`:l,F=(function(e){let t=[];if(e.heritageClauses){for(let r of e.heritageClauses)if(r.token===n.SyntaxKind.ExtendsKeyword)for(let e of r.types)t.push(e.getText())}return t})(e)?.map(e=>`<n-tag color="#4c81db" css=".tag{gap:0px;}">${T(B(e))}</n-tag>`),z=[c,v,a&&`\\color{#52c11b|1||0.9}{${a}}`,F.length>0&&`<sub>\`extends\`</sub> ${F.join(" ")}`].filter(Boolean).join(" "),K=`## ${z}`,N=e.members.filter(// 排除 never
-e=>p(e)&&e.type?.kind!==i.NeverKeyword||$(e)),q=[];if(N.length){N.forEach(e=>{let t=T(B($(e)?`(${e.parameters.map(e=>`${e.name.getText()}: ${e.type?.getText()||"any"}`).join(", ")}): ${e.type?.getText()||"any"}`:e.type?.getText()||"any"),!0),n=b(e),r=B(e.name.getText());!r||r.startsWith("\\color")||($(e)||function(e){if(e.type){if(!g(e.type))return m(e.type);for(let t of e.type.types)if(m(t))return!0}return!1}(e)||t?.includes("=>")?r=`\\color{#f9a913}{${r}}`:/^("|')(.+)("|')$/.test(r)||(r=`\\color{#4c81db}{${r}}`));let l=e.questionToken&&f(e.questionToken);q.push([r,!w&&`\\color{${l?"#f9a913":"#52c11b"}\\|\\|\\|0.9}{${l?"✘":"✔"}}`,!s&&B(k(n)),t,!j&&B(function(e){if(!e)return null;let t=e.match(/@default\s+([^\n]+)/);return t?t[1].trim():null}(n)),!E&&B(d(n)),!S&&(y(n)||y(o))])});let e=!1,t=!1,n=!1,r=!1;q.forEach(l=>{!s&&l[2]&&(r=!0),!j&&l[4]&&(n=!0),!E&&l[5]&&(t=!0),!S&&l[6]&&(e=!0)}),K+="\n";let l=["属性",!w&&"必要",r&&"说明","类型",n&&"默认值",t&&"版本",e&&"作者"].filter(Boolean).join("|");K+=`|${l}|`;let i=[":-",!w&&":-",r&&":-",":-",n&&":-",t&&":-",e&&":-"].filter(Boolean);K+="\n";let a=i.join("|");K+=`|${a}|`,q.forEach(l=>{K+="\n";let o=[l[0]||"-",!w&&(l[1]||"-"),r&&(l[2]||"-"),l[3]||"-",n&&(l[4]||"-"),t&&(l[5]||"-"),e&&(l[6]||"-")].filter(Boolean).join("|");K+=`|${o}|`}),K+="\n"}return K+="\n"}(e):n.isEnumDeclaration(e)&&(E+=function(e){let l=e.name.text,o=b(e),i=k(o),a=d(o);Object.assign(h,{[e.name.text]:t(e.getSourceFile().fileName).replace(r.alias["@pkg"],"")});let c=i?`\\color{|4||0.45}{${l}}`:l,u=[i,c,a&&`\\color{#52c11b|1||0.9}{${a}}`].filter(Boolean).join(" "),s=x(o)?.split("|")||[],f=s.includes("comment"),p=s.includes("version"),m=s.includes("author"),g=`## ${u}`;if(e.members.length){let t=[];e.members.forEach(e=>{let r=B(e.name.getText()),l=b(e),i=B(function(e){let t=e.initializer;return t&&n.isStringLiteral(t)?` '${t.text}'`:null}(e)),a=B(d(l)),c=B(k(l));!r||r.startsWith("\\color")||/^("|')(.+)("|')$/.test(r)||(r=`\\color{#4c81db}{${r}}`),t.push([r,!f&&c,i,!p&&a,!m&&(y(l)||y(o))]);// markdownContent += `| ${name} | ${comment} | ${value} | ${version} |`;
-});let r=!1,l=!1,i=!1;t.forEach(e=>{!f&&e[1]&&(i=!0),!p&&e[3]&&(l=!0),!m&&e[4]&&(r=!0)}),g+="\n";let a=["属性",i&&"说明","值",l&&"版本",r&&"作者"].filter(Boolean).join("|");g+=`|${a}|`;let c=[":-",i&&":-",":-",l&&":-",r&&":-"].filter(Boolean);g+="\n";let u=c.join("|");g+=`|${u}|`,t.forEach(e=>{g+="\n";let t=[e[0]||"-",i&&(e[1]||"-"),e[2]||"-",l&&(e[3]||"-"),r&&(e[4]||"-")].filter(Boolean).join("|");g+=`|${t}|`})}return g+="\n\n"}(e))}),E}
+import { readFileSync } from 'fs';
+import { dirname } from 'path';
+import ts from 'typescript';
+import { CONFIG } from './config.js';
+const { ScriptKind, ScriptTarget, SyntaxKind, createSourceFile, forEachChild, getLeadingCommentRanges, isInterfaceDeclaration, isQuestionToken, isPropertySignature, isFunctionTypeNode, isUnionTypeNode, isMethodSignature } = ts;
+const allType = {};
+function getPropertyComment(propertyNode) {
+    const comments = getLeadingCommentRanges(propertyNode.getSourceFile().text, propertyNode.pos);
+    if (comments) {
+        const commentText = propertyNode.getSourceFile().text.substring(comments[0].pos, comments[0].end);
+        const match = commentText.match(/\/\*\*([\s\S]*?)\*\//);
+        if (match) {
+            const trimmedCommentText = match[1].replace(/^\s*\* ?/gm, '').replace(/\s+$/, '').trim();
+            return trimmedCommentText;
+        }
+    }
+    return null;
+}
+function getDefaultValueFromComment(commentText) {
+    if (!commentText) return null;
+    const defaultValueRegex = /@default\s+([^\n]+)/;
+    const defaultValueMatch = commentText.match(defaultValueRegex);
+    return defaultValueMatch ? defaultValueMatch[1].trim() : null;
+}
+function getVersionFromComment(commentText) {
+    if (!commentText) return null;
+    const versionRegex = /@since\s+([^\n]+)/;
+    const versionMatch = commentText.match(versionRegex);
+    return versionMatch ? versionMatch[1].trim() : null;
+}
+function getAuthor(commentText) {
+    if (!commentText) return null;
+    const regex = /@author (\w+)\s*(?:<([^>]+)>)?/;
+    const match = commentText.match(regex);
+    if (match?.length) {
+        const author = match[1].trim();
+        let url = match[2]?.trim();
+        const isEmail = /^[\w-]+(\.[\w-]+)*@[\w-]+(\.[\w-]+)+$/.test(url);
+        if (!url) {
+            url = `https://github.com/${author}`;
+        } else if (isEmail) {
+            url = `mailto:${url}`;
+        }
+        return `[![${author}](https://avatars.githubusercontent.com/${author}?s=64)${author}](${url})`;
+    }
+    return null;
+}
+function getIgnore(commentText) {
+    if (!commentText) return null;
+    const versionRegex = /@ignore\s+([^\n]+)/;
+    const versionMatch = commentText.match(versionRegex);
+    return versionMatch ? versionMatch[1].trim() : null;
+}
+const regex = /(?<!['"])(unknown|any|void|bigint|object|undefined|null|boolean|number|string|symbol)(?!['"])/g;
+function getTypeText(typeText, hasColor) {
+    if (!typeText) return null;
+    let modifiedTypeText = typeText.replace(/\b([A-Z][a-zA-Z0-9]*)\b/g, (item)=>{
+        if (allType[item]) {
+            const url = `/${[
+                CONFIG.basename,
+                allType[item]
+            ].join('/').split('/').filter(Boolean).join('/')}`;
+            return hasColor ? `[\\color{#009688}{${item}}](${url})` : `[${item}](${url})`;
+        }
+        return hasColor ? `\\color{#009688}{${item}}` : item;
+    });
+    if (hasColor) {
+        modifiedTypeText = modifiedTypeText.replace(regex, (match)=>{
+            return `\\color{#009688}{${match}}`;
+        });
+    }
+    return modifiedTypeText;
+}
+function getMemberValue(memberNode) {
+    const initializer = memberNode.initializer;
+    if (initializer && ts.isStringLiteral(initializer)) {
+        return ` '${initializer.text}'`;
+    }
+    return null;
+}
+function replacePairedSymbols(inputString) {
+    if (!inputString) return null;
+    const coloredContent = [];
+    let matches;
+    while(matches = /\\color{([^|}]*)\|?([^|}]*)\|?([^|}]*)\|?([^}]*)}{([^}]*)}/g.exec(inputString)){
+        coloredContent.push(matches[0]);
+    }
+    return inputString.replace(/(\{|\}|\[|\]|\(|\)|=>|keyof|typeof|true|false)/g, (match)=>{
+        if (coloredContent.some((content)=>content.includes(match))) {
+            return match;
+        }
+        return `\\color{#569cd6}{${match}}`;
+    });
+}
+function isFunctionTypeProperty(member) {
+    if (member.type) {
+        if (isUnionTypeNode(member.type)) {
+            for (const typeNode of member.type.types){
+                if (isFunctionTypeNode(typeNode)) {
+                    return true;
+                }
+            }
+        } else {
+            return isFunctionTypeNode(member.type);
+        }
+    }
+    return false;
+}
+function replaceText(str) {
+    return replacePairedSymbols(str)?.replace(/^\s*\|\s*|\s*\|\s*$/gm, '').replace(/\n/g, '<br/>').replace(/\*/g, '\\*').replace(/\|/g, '\\|').replace(/(['"])((?:(?!\1).)*)\1/g, '\\color{#ce9178}{$1$2$1}');
+}
+function getBaseInterfaces(interfaceNode) {
+    const baseInterfaces = [];
+    if (interfaceNode.heritageClauses) {
+        for (const clause of interfaceNode.heritageClauses){
+            if (clause.token === ts.SyntaxKind.ExtendsKeyword) {
+                for (const typeNode of clause.types){
+                    baseInterfaces.push(typeNode.getText());
+                }
+            }
+        }
+    }
+    return baseInterfaces;
+}
+function getComment(comment) {
+    if (!comment) return null;
+    return comment.replace(/^@[a-z].+/gm, '').replace(/(\n\s+)+/g, '<br />').replace(/\n/g, '<br />').replace(/(<br \/>)$/g, '');
+}
+function getMethodText(member) {
+    if (isMethodSignature(member)) {
+        return `(${member.parameters.map((param)=>`${param.name.getText()}: ${param.type?.getText() || 'any'}`).join(', ')}): ${member.type?.getText() || 'any'}`;
+    }
+    return member.type?.getText() || 'any';
+}
+function generateInterfaceDocumentation(node) {
+    const typeName = node.name.text;
+    Object.assign(allType, {
+        [node.name.text]: dirname(node.getSourceFile().fileName).replace(CONFIG.alias['@pkg'], '')
+    });
+    const baseComment = getPropertyComment(node);
+    const vers = getVersionFromComment(baseComment);
+    const title = getComment(baseComment);
+    const ignore = getIgnore(baseComment)?.split('|') || [];
+    const ignoreComment = ignore.includes('comment');
+    const ignoreInitial = ignore.includes('initial');
+    const ignoreOptional = ignore.includes('optional');
+    const ignoreVersion = ignore.includes('version');
+    const ignoreAuthor = ignore.includes('author');
+    const subTitle = title ? `\\color{|4||0.45}{${typeName}}` : typeName;
+    const baseInterfaces = getBaseInterfaces(node)?.map((s)=>{
+        return `<n-tag color="#4c81db" css=".tag{gap:0px;}">${getTypeText(replaceText(s))}</n-tag>`;
+    });
+    const heading = [
+        title,
+        subTitle,
+        vers && `\\color{#52c11b|1||0.9}{${vers}}`,
+        baseInterfaces.length > 0 && `<sub>\`extends\`</sub> ${baseInterfaces.join(' ')}`
+    ].filter(Boolean).join(' ');
+    let markdownContent = `## ${heading}`;
+    const members = node.members.filter(// 排除 never
+    (m)=>isPropertySignature(m) && m.type?.kind !== SyntaxKind.NeverKeyword || isMethodSignature(m));
+    const rowsData = [];
+    if (members.length) {
+        members.forEach((member)=>{
+            const type = getTypeText(replaceText(getMethodText(member)), true);
+            const propertyComment = getPropertyComment(member);
+            let name = replaceText(member.name.getText());
+            if (name && !name.startsWith('\\color')) {
+                if (isMethodSignature(member) || isFunctionTypeProperty(member) || type?.includes('=>')) {
+                    name = `\\color{#f9a913}{${name}}`;
+                } else if (!/^("|')(.+)("|')$/.test(name)) {
+                    name = `\\color{#4c81db}{${name}}`;
+                }
+            }
+            const isOptional = member.questionToken && isQuestionToken(member.questionToken);
+            rowsData.push([
+                name,
+                !ignoreOptional && `\\color{${isOptional ? '#f9a913' : '#52c11b'}\\|\\|\\|0.9}{${isOptional ? '✘' : '✔'}}`,
+                !ignoreComment && replaceText(getComment(propertyComment)),
+                type,
+                !ignoreInitial && replaceText(getDefaultValueFromComment(propertyComment)),
+                !ignoreVersion && replaceText(getVersionFromComment(propertyComment)),
+                !ignoreAuthor && (getAuthor(propertyComment) || getAuthor(baseComment))
+            ]);
+        });
+        let hasAuthor = false, hasVersion = false, hasInitial = false, hasComment = false;
+        rowsData.forEach((row)=>{
+            if (!ignoreComment && row[2]) {
+                hasComment = true;
+            }
+            if (!ignoreInitial && row[4]) {
+                hasInitial = true;
+            }
+            if (!ignoreVersion && row[5]) {
+                hasVersion = true;
+            }
+            if (!ignoreAuthor && row[6]) {
+                hasAuthor = true;
+            }
+        });
+        markdownContent += '\n';
+        const cols = [
+            '属性',
+            !ignoreOptional && '必要',
+            hasComment && '说明',
+            '类型',
+            hasInitial && '默认值',
+            hasVersion && '版本',
+            hasAuthor && '作者'
+        ].filter(Boolean).join('|');
+        markdownContent += `|${cols}|`;
+        const algins = [
+            ':-',
+            !ignoreOptional && ':-',
+            hasComment && ':-',
+            ':-',
+            hasInitial && ':-',
+            hasVersion && ':-',
+            hasAuthor && ':-'
+        ].filter(Boolean);
+        markdownContent += '\n';
+        const alignStr = algins.join('|');
+        markdownContent += `|${alignStr}|`;
+        rowsData.forEach((row)=>{
+            markdownContent += '\n';
+            const rowStr = [
+                row[0] || '-',
+                !ignoreOptional && (row[1] || '-'),
+                hasComment && (row[2] || '-'),
+                row[3] || '-',
+                hasInitial && (row[4] || '-'),
+                hasVersion && (row[5] || '-'),
+                hasAuthor && (row[6] || '-')
+            ].filter(Boolean).join('|');
+            markdownContent += `|${rowStr}|`;
+        });
+        markdownContent += '\n';
+    }
+    markdownContent += '\n';
+    return markdownContent;
+}
+function generateEnumDocumentation(node) {
+    const enumName = node.name.text;
+    const baseComment = getPropertyComment(node);
+    const title = getComment(baseComment);
+    const vers = getVersionFromComment(baseComment);
+    Object.assign(allType, {
+        [node.name.text]: dirname(node.getSourceFile().fileName).replace(CONFIG.alias['@pkg'], '')
+    });
+    const subTitle = title ? `\\color{|4||0.45}{${enumName}}` : enumName;
+    const heading = [
+        title,
+        subTitle,
+        vers && `\\color{#52c11b|1||0.9}{${vers}}`
+    ].filter(Boolean).join(' ');
+    const ignore = getIgnore(baseComment)?.split('|') || [];
+    const ignoreComment = ignore.includes('comment');
+    const ignoreVersion = ignore.includes('version');
+    const ignoreAuthor = ignore.includes('author');
+    let markdownContent = `## ${heading}`;
+    if (node.members.length) {
+        const rowsData = [];
+        node.members.forEach((member)=>{
+            let name = replaceText(member.name.getText());
+            const memberComment = getPropertyComment(member);
+            const value = replaceText(getMemberValue(member));
+            const version = replaceText(getVersionFromComment(memberComment));
+            const comment = replaceText(getComment(memberComment));
+            // markdownContent += '\n';
+            if (name && !name.startsWith('\\color') && !/^("|')(.+)("|')$/.test(name)) {
+                name = `\\color{#4c81db}{${name}}`;
+            }
+            rowsData.push([
+                name,
+                !ignoreComment && comment,
+                value,
+                !ignoreVersion && version,
+                !ignoreAuthor && (getAuthor(memberComment) || getAuthor(baseComment))
+            ]);
+        // markdownContent += `| ${name} | ${comment} | ${value} | ${version} |`;
+        });
+        let hasAuthor = false, hasVersion = false, hasComment = false;
+        rowsData.forEach((row)=>{
+            if (!ignoreComment && row[1]) {
+                hasComment = true;
+            }
+            if (!ignoreVersion && row[3]) {
+                hasVersion = true;
+            }
+            if (!ignoreAuthor && row[4]) {
+                hasAuthor = true;
+            }
+        });
+        markdownContent += '\n';
+        const cols = [
+            '属性',
+            hasComment && '说明',
+            '值',
+            hasVersion && '版本',
+            hasAuthor && '作者'
+        ].filter(Boolean).join('|');
+        markdownContent += `|${cols}|`;
+        const algins = [
+            ':-',
+            hasComment && ':-',
+            ':-',
+            hasVersion && ':-',
+            hasAuthor && ':-'
+        ].filter(Boolean);
+        markdownContent += '\n';
+        const alignStr = algins.join('|');
+        markdownContent += `|${alignStr}|`;
+        rowsData.forEach((row)=>{
+            markdownContent += '\n';
+            const rowStr = [
+                row[0] || '-',
+                hasComment && (row[1] || '-'),
+                row[2] || '-',
+                hasVersion && (row[3] || '-'),
+                hasAuthor && (row[4] || '-')
+            ].filter(Boolean).join('|');
+            markdownContent += `|${rowStr}|`;
+        });
+    }
+    markdownContent += '\n';
+    markdownContent += '\n';
+    return markdownContent;
+}
+export default function generateApi(path) {
+    const content = readFileSync(path, 'utf-8');
+    const sourceFile = createSourceFile(path, content, ScriptTarget.Latest, true, ScriptKind.TS);
+    let markdownDocumentation = '';
+    forEachChild(sourceFile, (node)=>{
+        if (isInterfaceDeclaration(node)) {
+            markdownDocumentation += generateInterfaceDocumentation(node);
+        } else if (ts.isEnumDeclaration(node)) {
+            markdownDocumentation += generateEnumDocumentation(node);
+        }
+    });
+    return markdownDocumentation;
+}

package/lib/has-pkg.js

@@ -1 +1,12 @@
-import{accessSync as o,constants as r}from"fs";import t from"./paths.js";export function hasPkg(a){let e=!1;try{o(`${t.programPath}/node_modules/${a}/package.json`,r.R_OK),e=!0}catch(o){e=!1}return e}
+import { accessSync, constants } from 'fs';
+import paths from './paths.js';
+export function hasPkg(name) {
+    let flag = false;
+    try {
+        accessSync(`${paths.programPath}/node_modules/${name}/package.json`, constants.R_OK);
+        flag = true;
+    } catch (error) {
+        flag = false;
+    }
+    return flag;
+}

package/lib/html-add-entry-attr.js

@@ -1,4 +1,4 @@
-export default /**
+/**
  * 向 html-webpack-plugin 导出的 HTML 模板 script 添加属性
  * ```javascript
  * // 假设输出 main chunk 为 main.[hash].chunk.js。
@@ -7,12 +7,33 @@ export default /**
  *     return !!(src.match(/main\.(.*)\.bundle.js$/) || src.match('main.bundle.js'));
  * })),
  * ```
- */class{// eslint-disable-next-line no-unused-vars
-constructor(t){this.entryMatchCallback=t}apply(t){t.hooks.compilation.tap("AddEntryAttributeWebpackPlugin",a=>{// 通过最终的 webpack 配置的 plugins 属性，根据插件的 constructor.name 拿到 html-webpack-plugin 实例
-let e=t.options.plugins.map(({constructor:t})=>t).find(t=>t&&"HtmlWebpackPlugin"===t.name);// .find(
-//   (plugin) => plugin instanceof HtmlWebpackPlugin,
-// ) as typeof HtmlWebpackPlugin;
-if(e){// 获取 html-webpack-plugin 所有的 hooks
-let t=e.getHooks(a);// 在插入标签之前做些什么
-t.alterAssetTagGroups.tap("AddEntryAttributeWebpackPlugin",t=>(// 拿到所有的标签，如果是 script 标签，并且满足我们的匹配函数，则将其 attributes['entry'] 设为 true
-    t.headTags.forEach(t=>{"script"===t.tagName&&this.entryMatchCallback(t.attributes.src)&&(t.attributes.entry=!0)}),t))}})}}
+ */ class AddEntryAttributeWebpackPlugin {
+    // eslint-disable-next-line no-unused-vars
+    constructor(matchCallback){
+        this.entryMatchCallback = matchCallback;
+    }
+    apply(compiler) {
+        compiler.hooks.compilation.tap('AddEntryAttributeWebpackPlugin', (compilation)=>{
+            // 通过最终的 webpack 配置的 plugins 属性，根据插件的 constructor.name 拿到 html-webpack-plugin 实例
+            const HtmlWebpackPluginInstance = compiler.options.plugins.map(({ constructor })=>constructor).find((constructor)=>constructor && constructor.name === 'HtmlWebpackPlugin');
+            // .find(
+            //   (plugin) => plugin instanceof HtmlWebpackPlugin,
+            // ) as typeof HtmlWebpackPlugin;
+            if (HtmlWebpackPluginInstance) {
+                // 获取 html-webpack-plugin 所有的 hooks
+                const hooks = HtmlWebpackPluginInstance.getHooks(compilation);
+                // 在插入标签之前做些什么
+                hooks.alterAssetTagGroups.tap('AddEntryAttributeWebpackPlugin', (data)=>{
+                    // 拿到所有的标签，如果是 script 标签，并且满足我们的匹配函数，则将其 attributes['entry'] 设为 true
+                    data.headTags.forEach((tag)=>{
+                        if (tag.tagName === 'script' && this.entryMatchCallback(tag.attributes.src)) {
+                            tag.attributes.entry = true;
+                        }
+                    });
+                    return data;
+                });
+            }
+        });
+    }
+}
+export default AddEntryAttributeWebpackPlugin;