@flatjs/evolve 1.8.1-next.66 → 1.8.1-next.68

package/dist/default-options.js

@@ -1 +1,79 @@
-export const defaultEvolveOptions={projectCwd:process.cwd(),projectVirtualPath:"flatjs/evolve",rejectWarnings:!1,devServer:{autoOpen:!0,mockOptions:{mockBaseDir:"mocks"},clientOverlay:{errors:!0,warnings:!1},middlewares:[],watchOptions:{poll:1e3,ignored:/node_modules/,aggregateTimeout:500},defaultServeGlobalData:()=>Promise.resolve({})},webpack:{target:["web","es5"],plugins:[],ruleSets:[],publicPath:"auto",externals:{vue:"Vue",react:"React","react-dom":"ReactDOM"},outputDir:"public",enableBundleHashName:!0},pluginOptions:{},loaderOptions:{assetDataUrlMaxSize:4096,babelOptions:{usePreset:"react",plugins:[],presets:[]},runTsChecker:!0,lessOptions:{},postcssOptions:{cssnanoOptions:{}},pixelOptions:{rootValue:{px:100,rpx:1},outputUnit:"rem"},modularImports:[]},entryMap:{},multiHtmlCdn:{},multiHtmlCdnEnvResolver:function cdnResolver(){},needVerifyPackages:{},packageInstallChecker:{enabled:!1,detectModules:["@dimjs/*"],throwError:!1,showAllInstalledGraph:!0},maxProcesses:"80%",ci:{basedBranch:"master"}};
+export const defaultEvolveOptions = {
+    projectCwd: process.cwd(),
+    projectVirtualPath: 'flatjs/evolve',
+    rejectWarnings: false,
+    devServer: {
+        autoOpen: true,
+        mockOptions: {
+            mockBaseDir: 'mocks',
+        },
+        clientOverlay: {
+            errors: true,
+            warnings: false,
+        },
+        middlewares: [],
+        watchOptions: {
+            poll: 1000,
+            ignored: /node_modules/,
+            aggregateTimeout: 500,
+        },
+        defaultServeGlobalData: () => Promise.resolve({}),
+    },
+    webpack: {
+        // The default is es5
+        target: ['web', 'es5'],
+        plugins: [],
+        ruleSets: [],
+        publicPath: 'auto',
+        externals: {
+            vue: 'Vue',
+            react: 'React',
+            // eslint-disable-next-line @typescript-eslint/naming-convention
+            'react-dom': 'ReactDOM',
+        },
+        outputDir: 'public',
+        enableBundleHashName: true,
+    },
+    pluginOptions: {},
+    loaderOptions: {
+        assetDataUrlMaxSize: 4 * 1024,
+        babelOptions: {
+            // 默认值的必须使用object类型, 如果使用函数, 会导致merge默认值失败.
+            usePreset: 'react',
+            plugins: [],
+            presets: [],
+        },
+        runTsChecker: true,
+        lessOptions: {},
+        postcssOptions: {
+            cssnanoOptions: {},
+        },
+        pixelOptions: {
+            rootValue: { px: 100, rpx: 1 },
+            outputUnit: 'rem',
+        },
+        // Always defined in evolve.config.js
+        modularImports: [],
+    },
+    entryMap: {},
+    // The configurations for plugin `@flatjs/evolve`, `multi-cdn-plugin`
+    multiHtmlCdn: {},
+    // Do not use arrow function here.
+    multiHtmlCdnEnvResolver: function cdnResolver() {
+        return undefined;
+    },
+    needVerifyPackages: {},
+    packageInstallChecker: {
+        enabled: false,
+        detectModules: ['@dimjs/*'],
+        throwError: false,
+        showAllInstalledGraph: true,
+    },
+    maxProcesses: '80%',
+    /**
+     * CI default configurations.
+     */
+    ci: {
+        basedBranch: 'master',
+    },
+};

package/dist/define-config/define-config.js

@@ -1 +1,4 @@
-import{defineConfig as myDefineConfig}from"@flatjs/common";export const defineConfig=f=>myDefineConfig(f);
+import { defineConfig as myDefineConfig, } from '@flatjs/common';
+export const defineConfig = (userConfig) => {
+    return myDefineConfig(userConfig);
+};

package/dist/define-config/index.js

@@ -1 +1 @@
-export*from"./define-config.js";
+export * from './define-config.js';

package/dist/dev-server/add-compiler-to-dev-server.js

@@ -1 +1,47 @@
-import{join}from"node:path";import WebpackDevServer from"webpack-dev-server";export const addCompilerToDevServer=(e,r,t,o)=>{const{projectCwd:p,devServer:s}=o,l=new WebpackDevServer({server:{type:s?.https?"https":"http",options:{...s?.https}},open:!1,compress:!0,port:t,hot:r,liveReload:!r,allowedHosts:"all",static:{directory:`${join(p,"/public")}`},headers:{"Access-Control-Allow-Origin":"*"},client:{progress:!0,overlay:s?.clientOverlay}},e);return new Promise(((e,r)=>{l.startCallback((t=>{if(t)return r(t);e(!0)}))}))};
+import { join } from 'node:path';
+import WebpackDevServer from 'webpack-dev-server';
+/**
+ * Integrated webpack-dev-server with `mock` server together
+ * @param compiler Webpack compiler(s)
+ * @param enableHmr Value indicates if we need to liveReload or `HMR`
+ * @param devPort The port number of `@flatjs/mock`
+ * @param evolveOptions The configuration of `@flatjs/evolve` (FlatEvolveOptions)
+ */
+export const addCompilerToDevServer = (compiler, enableHmr, devPort, evolveOptions) => {
+    const { projectCwd, devServer } = evolveOptions;
+    const server = new WebpackDevServer({
+        server: {
+            type: devServer?.https ? 'https' : 'http',
+            options: {
+                // Load https
+                ...devServer?.https,
+            },
+        },
+        open: false,
+        compress: true,
+        port: devPort,
+        hot: enableHmr,
+        liveReload: !enableHmr,
+        // Enable firewall or set hosts that are allowed to access the dev server.
+        allowedHosts: 'all',
+        static: {
+            directory: `${join(projectCwd, '/public')}`,
+        },
+        headers: {
+            // eslint-disable-next-line @typescript-eslint/naming-convention
+            'Access-Control-Allow-Origin': '*',
+        },
+        client: {
+            progress: true,
+            overlay: devServer?.clientOverlay,
+        },
+    }, compiler);
+    return new Promise((resolve, reject) => {
+        server.startCallback((err) => {
+            if (err) {
+                return reject(err);
+            }
+            resolve(true);
+        });
+    });
+};

package/dist/dev-server/create-app-page-route.js

@@ -1 +1,11 @@
-import{createPageMiddleware,createPublicAssetsMiddleware}from"./middlewares/index.js";export const createAppPageRoute=(e,a,r,t,s)=>{const{devServer:d}=s;a.use("/pages",...createPageMiddleware(r,d?.mockOptions?.apiContext||"api",t,s)),a.use("*",createPublicAssetsMiddleware(e))};
+import { createPageMiddleware, createPublicAssetsMiddleware, } from './middlewares/index.js';
+/**
+ * Add route `/pages`, `*` to main web-server
+ */
+export const createAppPageRoute = (projectCwd, app, devHostUri, servedDevServerEntries, evolveOptions) => {
+    const { devServer } = evolveOptions;
+    // Attach request handlers for context `/page/*`
+    app.use('/pages', ...createPageMiddleware(devHostUri, devServer?.mockOptions?.apiContext || 'api', servedDevServerEntries, evolveOptions));
+    // handle all no-matched page request.
+    app.use('*', createPublicAssetsMiddleware(projectCwd));
+};

package/dist/dev-server/create-dev-server-compiler-tasks.js

@@ -1 +1,51 @@
-import{relative}from"node:path";import{chalk,logger,mergeOptions,urlJoin}from"@flatjs/common";import webpack from"webpack";import{loadWebpackConfig}from"../create-webpack/load-webpack-config.js";import{shouldEnableReactFastRefresh}from"../helpers/should-enable-react-fast-refresh.js";import{splitToMultiCompilerConfigs}from"../helpers/split-to-multi-compiler.js";import{addCompilerToDevServer}from"./add-compiler-to-dev-server.js";export const createDevServerCompilerTasks=async(e,o,r,t)=>{const i=[];for(const[a,n]of Object.entries(r)){const l=n.entryConfig,s=l.options?.moduleFederation,p=shouldEnableReactFastRefresh(!0,[a,l],t);(s?.remotes||[]).forEach((e=>{e.endpoint=e=>{const o=r[e];if(!o)throw new Error(`No servedDevServerEntry found via "${e}"`);return urlJoin(o?.devServerHostUri,["/public"])}}));const{devServerPort:c,devServerHostUri:m}=r[a],f={[a]:l},d=urlJoin(m,["public"]),v=await loadWebpackConfig("development",f,mergeOptions(t,{webpack:{publicPath:d}})),h=webpack(splitToMultiCompilerConfigs(f,v,t)[0]);i.push(addCompilerToDevServer(h,p,c,t));const g=h.name||"";h.hooks.invalid.tap("fileChange",(o=>{const r=relative(e,o||"");logger.info(`file change ➩ ${chalk(["cyan"])(r)}`,g)})),h.hooks.done.tap("compileDone",(()=>{logger.info(`debug page ➩ ${chalk(["cyan"])(o)}`,g)}))}return i};
+import { relative } from 'node:path';
+import { chalk, logger, mergeOptions, urlJoin } from '@flatjs/common';
+import webpack from 'webpack';
+import { loadWebpackConfig } from '../create-webpack/load-webpack-config.js';
+import { shouldEnableReactFastRefresh } from '../helpers/should-enable-react-fast-refresh.js';
+import { splitToMultiCompilerConfigs } from '../helpers/split-to-multi-compiler.js';
+import { addCompilerToDevServer } from './add-compiler-to-dev-server.js';
+export const createDevServerCompilerTasks = async (projectCwd, mainPage, servedDevServerEntries, evolveOptions) => {
+    const serveTaks = [];
+    for (const [entryName, servedDevServerEntry] of Object.entries(servedDevServerEntries)) {
+        const itemEntryConfig = servedDevServerEntry.entryConfig;
+        const moduleFederation = itemEntryConfig.options?.moduleFederation;
+        const enabledHmr = shouldEnableReactFastRefresh(true, [entryName, itemEntryConfig], evolveOptions);
+        const moduleFederationRemotes = moduleFederation?.remotes || [];
+        moduleFederationRemotes.forEach((remote) => {
+            // Dynamic construct remote endpoint as hostUri
+            remote.endpoint = (shortName) => {
+                const servedDevServerEntry = servedDevServerEntries[shortName];
+                if (!servedDevServerEntry) {
+                    throw new Error(`No servedDevServerEntry found via "${shortName}"`);
+                }
+                return urlJoin(servedDevServerEntry?.devServerHostUri, ['/public']);
+            };
+        });
+        const { devServerPort, devServerHostUri } = servedDevServerEntries[entryName];
+        const singleEvolveEntryMap = {
+            // e.g. `home`
+            [entryName]: itemEntryConfig,
+        };
+        // e.g. `http://dev.flatjs.com:3002/public/`
+        const servePublicPath = urlJoin(devServerHostUri, ['public']);
+        const webpackConfig = await loadWebpackConfig('development', singleEvolveEntryMap, mergeOptions(evolveOptions, {
+            webpack: {
+                publicPath: servePublicPath,
+            },
+        }));
+        const compiler = webpack(splitToMultiCompilerConfigs(singleEvolveEntryMap, webpackConfig, evolveOptions)[0]);
+        serveTaks.push(
+        // create webpack dev server instance.
+        addCompilerToDevServer(compiler, enabledHmr, devServerPort, evolveOptions));
+        const title = compiler.name || '';
+        compiler.hooks.invalid.tap('fileChange', (fileName) => {
+            const relativeFileName = relative(projectCwd, fileName || '');
+            logger.info(`file change ➩ ${chalk(['cyan'])(relativeFileName)}`, title);
+        });
+        compiler.hooks.done.tap('compileDone', () => {
+            logger.info(`debug page ➩ ${chalk(['cyan'])(mainPage)}`, title);
+        });
+    }
+    return serveTaks;
+};

package/dist/dev-server/create-dev-server-entries.js

@@ -1 +1,27 @@
-import{mergeOptions}from"@flatjs/common";import{prepareMockDomain}from"@flatjs/mock";import{normalizeEvolveEntryName}from"../helpers/normalize-entry-map.js";export const createDevServerEntries=async(r,e,o)=>{const{devServer:t,projectVirtualPath:n}=o,m={};let a=r;for(const[r,o]of Object.entries(e)){a+=1;const{mockPort:e,hostUri:i}=await prepareMockDomain(mergeOptions(t?.mockOptions||{},{port:a})),s=normalizeEvolveEntryName(r,n);m[r]={entryConfig:o,devServerPort:e,devServerHostUri:i,normalizedEntryName:s}}return m};
+import { mergeOptions } from '@flatjs/common';
+import { prepareMockDomain } from '@flatjs/mock';
+import { normalizeEvolveEntryName } from '../helpers/normalize-entry-map.js';
+export const createDevServerEntries = async (startPort, servedEntries, evolveOptions) => {
+    const { devServer, projectVirtualPath } = evolveOptions;
+    const servedDevServerEntries = {};
+    // https://github.com/webpack/webpack-dev-server/issues/2692
+    // For `webpack-dev-server@4.0.0` we should run dev server on each compiler
+    let makeLastestPort = startPort;
+    // Prepare devServer ports for each served entry.
+    for (const [entryName, entryConfig] of Object.entries(servedEntries)) {
+        makeLastestPort = makeLastestPort + 1;
+        // Create individual devPort for each compiler here.
+        const { mockPort: devServerPort, hostUri: devServerHostUri } = await prepareMockDomain(mergeOptions(devServer?.mockOptions || {}, {
+            port: makeLastestPort,
+        }));
+        // entryName: `home` should be normallized to ${`projectVirtualPath`}/home
+        const normalizedEntryName = normalizeEvolveEntryName(entryName, projectVirtualPath);
+        servedDevServerEntries[entryName] = {
+            entryConfig,
+            devServerPort,
+            devServerHostUri,
+            normalizedEntryName,
+        };
+    }
+    return servedDevServerEntries;
+};

package/dist/dev-server/create-dev-server.js

@@ -1 +1,23 @@
-import https from"node:https";import{prepareMockDomain}from"@flatjs/mock";import express from"express";export const createDevServer=async e=>{const r=express(),t=e.devServer?.mockOptions,{mockPort:o,hostUri:s}=await prepareMockDomain(t||{});return new Promise((t=>{const p=e.devServer?.https?https.createServer(e.devServer?.https,r):r;r.set("hostUri",s),p.listen(o,(()=>{t({app:r,devHostUri:s,devPort:o})}))}))};
+import https from 'node:https';
+import { prepareMockDomain } from '@flatjs/mock';
+import express from 'express';
+export const createDevServer = async (evolveOptions) => {
+    const app = express();
+    const mockOptions = evolveOptions.devServer?.mockOptions;
+    const { mockPort, hostUri } = await prepareMockDomain(mockOptions || {});
+    return new Promise((resolve) => {
+        // Https
+        const httpsServer = evolveOptions.devServer?.https
+            ? https.createServer(evolveOptions.devServer?.https, app)
+            : app;
+        // Attach hostUri to application instance without last slash `/`.
+        app.set('hostUri', hostUri);
+        httpsServer.listen(mockPort, () => {
+            resolve({
+                app,
+                devHostUri: hostUri,
+                devPort: mockPort,
+            });
+        });
+    });
+};

package/dist/dev-server/index.js

@@ -1 +1,6 @@
-export*from"./middlewares/index.js";export*from"./add-compiler-to-dev-server.js";export*from"./create-dev-server.js";export*from"./create-app-page-route.js";export*from"./create-dev-server-entries.js";export*from"./create-dev-server-compiler-tasks.js";
+export * from './middlewares/index.js';
+export * from './add-compiler-to-dev-server.js';
+export * from './create-dev-server.js';
+export * from './create-app-page-route.js';
+export * from './create-dev-server-entries.js';
+export * from './create-dev-server-compiler-tasks.js';

package/dist/dev-server/middlewares/create-page-middleware.js

@@ -1 +1,164 @@
-import{existsSync,readFileSync}from"node:fs";import{isAbsolute,join}from"node:path";import{ensureSlash,urlJoin}from"@flatjs/common";import _ from"lodash";import{allowPx2remForModule}from"../../helpers/allow-px2rem-for-module.js";import{getHtmlPluginConfig}from"../../helpers/get-html-plugin-config.js";import{getPackageDir}from"../../helpers/get-pacakge-dir.js";import{normalizeEvolveEntryName}from"../../helpers/normalize-entry-map.js";import{injectFederationScripts}from"../../helpers/script-injects.js";const getPageMainHtml=async(e,t,l)=>{const r=getPackageDir(),o=readFileSync(join(r,"./templates/main.html"),"utf-8"),a=[],i=l.projectVirtualPath.replace(/^\//,"");for(const[r,o]of Object.entries(l.entryMap)){const l=o.options?.servePageMainLinkFn||(e=>e),n=Object.keys(e).includes(r),s=normalizeEvolveEntryName(r,i),m=urlJoin(t,["pages",s],{env:"me"});a.push({name:r.replace(i,"").replace(/^\//,""),link:l(m,{hostUri:t,entryName:r,virtualPath:i}),flagText:n?"serve":"static",isServed:n?1:0})}const n={title:"@flatjs/evolve",modules:a.sort(((e,t)=>t.isServed-e.isServed))};return _.template(o)(n)},getPageModuleHtml=async(e,t,l,r,o)=>{const{entryMap:a,projectVirtualPath:i}=o,n=Object.keys(a).sort(((e,t)=>t.length-e.length)),s=getPackageDir(),m=n.find((e=>{const l=normalizeEvolveEntryName(e,i);return ensureSlash(t.path.replace(/^\//,""),!0).startsWith(ensureSlash(l,!0))}));if(!m){const e=readFileSync(join(s,"./templates/module-404.html"),"utf-8");return _.template(e)({title:"404 Not Found",errorMeta:[{name:"@flatjs/evolve workspace",value:s},{name:"served entry names",value:JSON.stringify(n)},{name:"module path",value:`${t.path}`}]})}const p=normalizeEvolveEntryName(m,i),c=a[m],d=c.options,u=e[m],g=u?.devServerHostUri||l,f=d?.serveModuleTemplate||"./templates/module.html",v=join(o.projectCwd,"./templates/module.html"),h=readFileSync(isAbsolute(f)?f:existsSync(v)?v:join(s,"./templates/module.html"),"utf-8"),S=o.devServer,y=S?.defaultServeGlobalData?await S.defaultServeGlobalData(c,l):{},j={title:getHtmlPluginConfig("title","development",d?.title),favicon:getHtmlPluginConfig("favicon","development",d?.favicon),viewport:allowPx2remForModule([m,c],o)?getHtmlPluginConfig("viewport","development",d?.viewport):"",headBeforeHtmlTags:getHtmlPluginConfig("headBeforeHtmlTags","development",d?.headBeforeHtmlTags),inlineScripts:getHtmlPluginConfig("inlineScripts","development",d?.inlineScripts),headBeforeStyles:getHtmlPluginConfig("headBeforeStyles","development",d?.headBeforeStyles),headBeforeScripts:getHtmlPluginConfig("headBeforeScripts","development",d?.headBeforeScripts),bodyAfterScripts:getHtmlPluginConfig("bodyAfterScripts","development",d?.bodyAfterScripts),moduleFederationScripts:injectFederationScripts({me:[urlJoin(l,["public"])]},o.multiHtmlCdnEnvResolver),global:{hostUrl:l,apiBase:urlJoin(l,[r]),virtualPath:join("/pages",i),moduleName:m.replace(i,"").replace(/^\//,""),...y,...d?.serveGlobalData||{}},styles:[urlJoin(g,[join("public",p,"bundle.css")])],scripts:[urlJoin(g,[join("public",p,"bundle.js")])]};return _.template(h)(j)};export const createPageMiddleware=(e,t,l,r)=>(r.devServer?.middlewares||[]).concat((async(o,a)=>{let i;i="/"===o.path?await getPageMainHtml(l,e,r):await getPageModuleHtml(l,o,e,t,r),a.send(i)}));
+import { existsSync, readFileSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { ensureSlash, urlJoin } from '@flatjs/common';
+import _ from 'lodash';
+import { allowPx2remForModule } from '../../helpers/allow-px2rem-for-module.js';
+import { getHtmlPluginConfig, } from '../../helpers/get-html-plugin-config.js';
+import { getPackageDir } from '../../helpers/get-pacakge-dir.js';
+import { normalizeEvolveEntryName } from '../../helpers/normalize-entry-map.js';
+import { injectFederationScripts } from '../../helpers/script-injects.js';
+const getPageMainHtml = async (servedDevServerEntries, devHostUri, evolveOptions) => {
+    const evolveCwd = getPackageDir();
+    const templateStr = readFileSync(join(evolveCwd, './templates/main.html'), 'utf-8');
+    const sortedModules = [];
+    const virtualPath = evolveOptions.projectVirtualPath.replace(/^\//, '');
+    for (const [entryName, entryContent] of Object.entries(evolveOptions.entryMap)) {
+        // Allow customized page main link.
+        const servePageMainLinkFn = entryContent.options?.servePageMainLinkFn || ((link) => link);
+        // `home`, servedDevServerEntries[key] => `home`
+        const isServedEntry = Object.keys(servedDevServerEntries).includes(entryName);
+        // `flatjs/evolve/home`
+        const normalizedEntryName = normalizeEvolveEntryName(entryName, virtualPath);
+        const linkHref = urlJoin(devHostUri, ['pages', normalizedEntryName], {
+            env: 'me',
+        });
+        sortedModules.push({
+            name: entryName.replace(virtualPath, '').replace(/^\//, ''),
+            link: servePageMainLinkFn(linkHref, {
+                hostUri: devHostUri,
+                entryName,
+                virtualPath,
+            }),
+            flagText: isServedEntry ? 'serve' : 'static',
+            isServed: isServedEntry ? 1 : 0,
+        });
+    }
+    const templateData = {
+        title: '@flatjs/evolve',
+        modules: sortedModules.sort((a, b) => {
+            return b.isServed - a.isServed;
+        }),
+    };
+    return _.template(templateStr)(templateData);
+};
+const getPageModuleHtml = async (servedDevServerEntries, req, devHostUri, apiContext, evolveOptions) => {
+    const { entryMap, projectVirtualPath } = evolveOptions;
+    // normalize to ['a/b','a/b/c','inn/app/transfer_list','inn/app/transfer']
+    const entryNames = Object.keys(entryMap).sort((a, b) => b.length - a.length);
+    const evolveCwd = getPackageDir();
+    const currEntry = entryNames.find((entryName) => {
+        const normalizedEntryName = normalizeEvolveEntryName(entryName, projectVirtualPath);
+        return ensureSlash(req.path.replace(/^\//, ''), true).startsWith(ensureSlash(normalizedEntryName, true));
+    });
+    if (!currEntry) {
+        const notFoundTemplateStr = readFileSync(join(evolveCwd, `./templates/module-404.html`), 'utf-8');
+        return _.template(notFoundTemplateStr)({
+            title: '404 Not Found',
+            errorMeta: [
+                {
+                    name: `@flatjs/evolve workspace`,
+                    value: evolveCwd,
+                },
+                {
+                    name: `served entry names`,
+                    value: JSON.stringify(entryNames),
+                },
+                // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
+                { name: `module path`, value: `${req.path}` },
+            ],
+        });
+    }
+    const normalizedCurrEntry = normalizeEvolveEntryName(currEntry, projectVirtualPath);
+    const currEntryItem = entryMap[currEntry];
+    const currEntryOption = currEntryItem.options;
+    // currEntry: `home`
+    const currDevServerEntry = servedDevServerEntries[currEntry];
+    // Maybe No currEntry found in servedDevServerEntries, use default `hostUri`, e.g. `static` mode.
+    const devServerHostUri = currDevServerEntry?.devServerHostUri || devHostUri;
+    const moduleTemplate = 
+    // eslint-disable-next-line sonarjs/no-duplicate-string
+    currEntryOption?.serveModuleTemplate || './templates/module.html';
+    const projectHostedModuleTemplate = join(evolveOptions.projectCwd, './templates/module.html');
+    const templateStr = readFileSync(isAbsolute(moduleTemplate)
+        ? moduleTemplate
+        : existsSync(projectHostedModuleTemplate)
+            ? projectHostedModuleTemplate
+            : join(evolveCwd, './templates/module.html'), 'utf-8');
+    const devServer = evolveOptions.devServer;
+    const defaultGlobalData = devServer?.defaultServeGlobalData
+        ? await devServer.defaultServeGlobalData(currEntryItem, devHostUri)
+        : {};
+    const configData = {
+        mode: 'development',
+        // FIXME: always use `devHostUri` as served local `cdn`, if you want to serve `anther` module
+        // you need to generate cdn path manually.
+        envCdn: urlJoin(devHostUri, ['public']),
+    };
+    const templateData = {
+        // title
+        title: getHtmlPluginConfig('title', configData, currEntryOption?.title),
+        // favicon
+        favicon: getHtmlPluginConfig('favicon', configData, currEntryOption?.favicon),
+        // `allowPx2rem` default is true
+        viewport: allowPx2remForModule([currEntry, currEntryItem], evolveOptions)
+            ? getHtmlPluginConfig('viewport', configData, currEntryOption?.viewport)
+            : '',
+        // The customized html tags should be inject to <header />
+        headBeforeHtmlTags: getHtmlPluginConfig('headBeforeHtmlTags', configData, currEntryOption?.headBeforeHtmlTags),
+        // Allow us customized inline scripts into compiled html template.
+        inlineScripts: getHtmlPluginConfig('inlineScripts', configData, currEntryOption?.inlineScripts),
+        // The ordered styles will be injected start of html head.
+        headBeforeStyles: getHtmlPluginConfig('headBeforeStyles', configData, currEntryOption?.headBeforeStyles),
+        // The ordered scripts will be injected before html head.
+        headBeforeScripts: getHtmlPluginConfig('headBeforeScripts', configData, currEntryOption?.headBeforeScripts),
+        // The ordered scripts will be injected end of html body.
+        bodyAfterScripts: getHtmlPluginConfig('bodyAfterScripts', configData, currEntryOption?.bodyAfterScripts),
+        // Module Federation, Only for `static` mode, `serve` mode it will use entryItemConfig.endpoint()
+        moduleFederationScripts: injectFederationScripts({
+            me: [urlJoin(devHostUri, ['public'])],
+        }, evolveOptions.multiHtmlCdnEnvResolver),
+        // The global data.
+        global: {
+            hostUrl: devHostUri,
+            apiBase: urlJoin(devHostUri, [apiContext]),
+            virtualPath: join(`/pages`, projectVirtualPath),
+            moduleName: currEntry.replace(projectVirtualPath, '').replace(/^\//, ''),
+            ...defaultGlobalData,
+            ...(currEntryOption?.serveGlobalData || {}),
+        },
+        styles: [
+            urlJoin(devServerHostUri, [
+                join('public', normalizedCurrEntry, 'bundle.css'),
+            ]),
+        ],
+        scripts: [
+            urlJoin(devServerHostUri, [
+                join('public', normalizedCurrEntry, 'bundle.js'),
+            ]),
+        ],
+    };
+    return _.template(templateStr)(templateData);
+};
+/**
+ * A middleware to proxy the page modules template.
+ * @example `http://dev.flatjs.com:3001/pages`
+ * @param mode The mode of this dev server instance.
+ * @param hostUri The main host base url.
+ * @param apiContext apiBase e.g. `api`
+ * @param servedDevServerEntries The served webpack entries
+ * @param forPageMiddlewares Allow us provider customized middlewares for `page`, `modules`
+ * @param evolveOptions The evolve config options
+ */
+export const createPageMiddleware = (devHostUri, apiContext, servedDevServerEntries, evolveOptions) => {
+    const handler = async (req, res) => {
+        let html;
+        if (req.path === '/') {
+            html = await getPageMainHtml(servedDevServerEntries, devHostUri, evolveOptions);
+        }
+        else {
+            html = await getPageModuleHtml(servedDevServerEntries, req, devHostUri, apiContext, evolveOptions);
+        }
+        res.send(html);
+    };
+    return (evolveOptions.devServer?.middlewares || []).concat(handler);
+};

package/dist/dev-server/middlewares/create-public-assets-middleware.js

@@ -1 +1,25 @@
-import{extname,join}from"node:path";import{fileWalk}from"@armit/file-utility";export const createPublicAssetsMiddleware=e=>async(i,s)=>{const t=i.baseUrl;if(t.startsWith("/public")){const i=await fileWalk(join("public/","**/*.{js,css}"),{cwd:e}),a=extname(t),l=i.find((e=>extname(e)===a&&-1!==e.indexOf(t.replace(/\.(?:js|css)$/,""))));l?s.sendFile(l):s.sendFile(join(e,t))}else s.redirect("/pages")};
+import { extname, join } from 'node:path';
+import { fileWalk } from '@armit/file-utility';
+export const createPublicAssetsMiddleware = (projectCwd) => async (req, res) => {
+    const baseUrl = req.baseUrl;
+    // exclude `/public` leave it fallback into webpack hot server
+    if (!baseUrl.startsWith('/public')) {
+        res.redirect('/pages');
+    }
+    else {
+        const publicFiles = await fileWalk(join('public/', '**/*.{js,css}'), {
+            cwd: projectCwd,
+        });
+        const extension = extname(baseUrl);
+        const matchedBundleFile = publicFiles.find((file) => {
+            return (extname(file) === extension &&
+                file.indexOf(baseUrl.replace(/\.(?:js|css)$/, '')) !== -1);
+        });
+        if (matchedBundleFile) {
+            res.sendFile(matchedBundleFile);
+        }
+        else {
+            res.sendFile(join(projectCwd, baseUrl));
+        }
+    }
+};

package/dist/dev-server/middlewares/index.js

@@ -1 +1,2 @@
-export*from"./create-page-middleware.js";export*from"./create-public-assets-middleware.js";
+export * from './create-page-middleware.js';
+export * from './create-public-assets-middleware.js';

package/dist/errors/evolve-build-error.js

@@ -1 +1,10 @@
-export class EvolveBuildError extends Error{constructor(r,e){let o=r;e&&(o+=": "+JSON.stringify(e)),super(o),this.code=r}}
+export class EvolveBuildError extends Error {
+    constructor(code, messages) {
+        let message = code;
+        if (messages) {
+            message += ': ' + JSON.stringify(messages);
+        }
+        super(message);
+        this.code = code;
+    }
+}

package/dist/helpers/allow-px2rem-for-module.js

@@ -1 +1,6 @@
-export const allowPx2remForModule=(o,e)=>{const l=e?.loaderOptions?.pixelOptions;return!!((o&&o[1]?.options?.allowPx2rem)??l)};
+export const allowPx2remForModule = (entryItem, evolveOptions) => {
+    // Global settings for `AllowPx2Rem`
+    const globalAllowPx2Rem = evolveOptions?.loaderOptions?.pixelOptions;
+    const currItemPx2Rem = (entryItem && entryItem[1]?.options?.allowPx2rem) ?? globalAllowPx2Rem;
+    return !!currItemPx2Rem;
+};

package/dist/helpers/assert-only-single-entry-item.js

@@ -1 +1,23 @@
-import{normalizeEvolveEntryName}from"./normalize-entry-map.js";export const assertOnlySingleEntryItem=(e,r)=>{if(Object.keys(e).length>1)throw new Error("Only single one entry map support right now for `serve`, `build`!");let t;for(const[r,o]of Object.entries(e)){t=[r,o];break}if(!t)throw new Error('No entry map found while "serve", "build" process!');const[o,n]=t;return[normalizeEvolveEntryName(o,r.projectVirtualPath),n]};
+import { normalizeEvolveEntryName } from './normalize-entry-map.js';
+/**
+ * Only fetch single one entry map once `serve`,`build` recycle.
+ * @returns
+ */
+export const assertOnlySingleEntryItem = (entryMap, evolveOptions) => {
+    if (Object.keys(entryMap).length > 1) {
+        throw new Error('Only single one entry map support right now for `serve`, `build`!');
+    }
+    let result = undefined;
+    for (const [entryChunkName, entryItem] of Object.entries(entryMap)) {
+        result = [entryChunkName, entryItem];
+        break;
+    }
+    if (!result) {
+        throw new Error(`No entry map found while "serve", "build" process!`);
+    }
+    const [entryName, entryConfig] = result;
+    // Make sure that we have correct `virtualPath` for each webpack `entry`
+    const normalizedEntryName = normalizeEvolveEntryName(entryName, evolveOptions.projectVirtualPath);
+    `entry`;
+    return [normalizedEntryName, entryConfig];
+};

package/dist/helpers/chunk-entry-map.js

@@ -1 +1,21 @@
-import{arrayChunk}from"@flatjs/common";export const chunkEntryMap=(r,o=2)=>{const n=Object.keys(r),t=arrayChunk(n,o),c=[];for(const o of t){const n=o.reduce(((o,n)=>({...o,[n]:r[n]})),{});c.push(n)}return c};
+import { arrayChunk } from '@flatjs/common';
+/**
+ * Split entryMap into multi entryMap with a `size`
+ * @param entryMap
+ * @param size
+ */
+export const chunkEntryMap = (entryMap, size = 2) => {
+    const keys = Object.keys(entryMap);
+    const entryKeyChunks = arrayChunk(keys, size);
+    const finalEntryMaps = [];
+    for (const keys of entryKeyChunks) {
+        const chunkMap = keys.reduce((prev, curr) => {
+            return {
+                ...prev,
+                [curr]: entryMap[curr],
+            };
+        }, {});
+        finalEntryMaps.push(chunkMap);
+    }
+    return finalEntryMaps;
+};

package/dist/helpers/enable-bundle-hashname-for-module.js

@@ -1 +1,6 @@
-export const enableBundleHashNameForModule=(e,a)=>{const n=e.webpack?.enableBundleHashName;return!!(a?.enableBundleHashName??n)};
+export const enableBundleHashNameForModule = (evolveOptions, entryItemOption) => {
+    // Global settings for `enableBundleHashName`
+    const globalEnabledStatus = evolveOptions.webpack?.enableBundleHashName;
+    const bundleHashNameEnabled = entryItemOption?.enableBundleHashName ?? globalEnabledStatus;
+    return !!bundleHashNameEnabled;
+};

package/dist/helpers/filter-actived-entries.d.ts

@@ -5,7 +5,7 @@ import { type EvolveEntryMap } from '../types/types-entry-map.js';
  * @param modules `home;mine;`
  * @returns activedEntries
  */
-export declare const filterActivedEntriesByModule: (definedEntries: EvolveEntryMap, modules: string[]) => EvolveEntryMap;
+export declare const filterActivedEntriesByModule: (definedEntries: EvolveEntryMap, modules: Array<string | RegExp>) => EvolveEntryMap;
 /**
  * Filter to find actived entry input by absolute entry filepath
  * @param projectCwd

package/dist/helpers/filter-actived-entries.js

@@ -1 +1,41 @@
-import{arraysIntersect,normalizeSemicolonFilterParts}from"@flatjs/common";import{resolveEntryMapInputFiles}from"./resolve-entry-map-input-files.js";export const filterActivedEntriesByModule=(t,e)=>{const r=normalizeSemicolonFilterParts(e),n={};for(const[e,o]of Object.entries(t))r.find((t=>new RegExp(`${t}`).test(e)))&&(n[e]=o);return n};export const filterActivedEntriesByEntryInputs=async(t,e,r)=>{const n={};for(const[o,s]of Object.entries(e)){const e=await resolveEntryMapInputFiles(t,{[o]:s});arraysIntersect(e,r)&&(n[o]=s)}return n};
+import { arraysIntersect, normalizeSemicolonFilterParts } from '@flatjs/common';
+import { resolveEntryMapInputFiles } from './resolve-entry-map-input-files.js';
+/**
+ * Filter to find actived entry input by entry name filter.
+ * @param definedEntries
+ * @param modules `home;mine;`
+ * @returns activedEntries
+ */
+export const filterActivedEntriesByModule = (definedEntries, modules) => {
+    const patterns = normalizeSemicolonFilterParts(modules);
+    const newActivedEntries = {};
+    for (const [entryKey, itemConfig] of Object.entries(definedEntries)) {
+        const matched = patterns.find((m) => {
+            const testRegExp = typeof m === 'string' ? new RegExp(`${m}`) : m;
+            return testRegExp.test(entryKey);
+        });
+        if (matched) {
+            newActivedEntries[entryKey] = itemConfig;
+        }
+    }
+    return newActivedEntries;
+};
+/**
+ * Filter to find actived entry input by absolute entry filepath
+ * @param projectCwd
+ * @param definedEntries
+ * @param entryInputs [`/xxxx/x/xxxx/src/home/index.tsx`]
+ * @returns activedEntries
+ */
+export const filterActivedEntriesByEntryInputs = async (projectCwd, definedEntries, entryInputs) => {
+    const newActivedEntries = {};
+    for (const [entryKey, itemConfig] of Object.entries(definedEntries)) {
+        const entryAbsFiles = await resolveEntryMapInputFiles(projectCwd, {
+            [entryKey]: itemConfig,
+        });
+        if (arraysIntersect(entryAbsFiles, entryInputs)) {
+            newActivedEntries[entryKey] = itemConfig;
+        }
+    }
+    return newActivedEntries;
+};

package/dist/helpers/get-bundle-file-name.js

@@ -1 +1,23 @@
-export const currNow=()=>Date.now().toString();export const getBundleFileName=(t,n,e=!0)=>{const o="js"===t?".js":".css";return n?`bundle${o}`:e?`bundle[contenthash]${o}`:`bundle${o}?${Date.now().toString()}`};
+/**
+ * Get current timestramp as `string`
+ */
+export const currNow = () => Date.now().toString();
+/**
+ * Generate bundle file name from rules
+ * 1. if `serveMode`, always return `bundle
+ * 2. else if `enableBundleHashName` always return `bundle[contenthash].{css,js}`
+ * 3. otherwise return `bundle.{css,js}?${currNow}`
+ * @param type `js` | `css`
+ * @param serveMode If we are run `serve` mode
+ * @param enableBundleHashName If we need to generate bundle file name with `[contenthash]`
+ */
+export const getBundleFileName = (type, serveMode, enableBundleHashName = true) => {
+    const fileEndFix = type === 'js' ? '.js' : '.css';
+    if (serveMode) {
+        return `bundle${fileEndFix}`;
+    }
+    if (enableBundleHashName) {
+        return `bundle[contenthash]${fileEndFix}`;
+    }
+    return `bundle${fileEndFix}?${currNow()}`;
+};