@flatjs/evolve 2.1.0-next.3 → 2.1.0-next.5

package/dist/create-webpack/rule-sets/rule-utils.js

@@ -1 +1,10 @@
-import{ICON_PATH_REGEX}from"./constants.js";export const isIconSvg=s=>ICON_PATH_REGEX.test(s)&&s.endsWith(".svg");
+import { ICON_PATH_REGEX } from './constants.js';
+/**
+ * Causeof we expose a component <Icon /> from `@wove/react` it can be optimized via icon-loader.
+ * limitation assets match `svg-icons/**\/*.svg` to icon loader resolver.
+ * @param resource
+ * @returns
+ */
+export const isIconSvg = (resource) => {
+    return ICON_PATH_REGEX.test(resource) && resource.endsWith('.svg');
+};

package/dist/create-webpack/types.js

@@ -1 +1 @@
-export{};
+export {};

package/dist/default-options.js

@@ -1 +1,84 @@
-export const defaultEvolveOptions={projectCwd:process.cwd(),projectVirtualPath:"flatjs/evolve",rejectWarnings:!1,devServer:{autoOpen:!0,pageProxy:"/pages",mockOptions:{mockBaseDir:"mocks"},clientOverlay:{errors:!0,warnings:!1},webSocketURL:"localIp",middlewares:[],watchOptions:{poll:1e3,ignored:["**/node_modules","**/mocks"],aggregateTimeout:500},defaultServeGlobalData:()=>Promise.resolve({}),bundleDirResolver:e=>e},webpack:{target:["web","es5"],plugins:[],ruleSets:[],publicPath:"auto",resolve:{},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:5,ci:{basedBranch:"origin/master"}};
+export const defaultEvolveOptions = {
+    projectCwd: process.cwd(),
+    projectVirtualPath: 'flatjs/evolve',
+    rejectWarnings: false,
+    devServer: {
+        autoOpen: true,
+        pageProxy: '/pages',
+        mockOptions: {
+            mockBaseDir: 'mocks',
+        },
+        clientOverlay: {
+            errors: true,
+            warnings: false,
+        },
+        webSocketURL: 'localIp',
+        middlewares: [],
+        watchOptions: {
+            poll: 1000,
+            // Use array here, easy can add a new ignore dynamic at runtime.
+            ignored: ['**/node_modules', '**/mocks'],
+            aggregateTimeout: 500,
+        },
+        defaultServeGlobalData: () => Promise.resolve({}),
+        bundleDirResolver: (dir) => dir,
+    },
+    webpack: {
+        // The default is es5
+        target: ['web', 'es5'],
+        plugins: [],
+        ruleSets: [],
+        publicPath: 'auto',
+        resolve: {},
+        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: 5,
+    /**
+     * CI default configurations.
+     */
+    ci: {
+        basedBranch: 'origin/master',
+    },
+};

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

@@ -1 +1,4 @@
-import{defineConfig as myDefineConfig}from"@armit/config-loader";export const defineConfig=i=>myDefineConfig(i);
+import { defineConfig as myDefineConfig, } from '@armit/config-loader';
+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,58 @@
-import{join}from"node:path";import WebpackDevServer from"webpack-dev-server";export const addCompilerToDevServer=(e,o,r,t,s)=>{const{projectCwd:p,devServer:c}=s,l=new WebpackDevServer({server:{type:c?.https?"https":"http",options:{...c?.https}},open:!1,compress:!0,port:r,hot:o,liveReload:!o,allowedHosts:"all",static:{directory:`${join(p,"/public")}`},headers:{"Access-Control-Allow-Origin":"*"},client:{progress:!0,overlay:c?.clientOverlay,webSocketURL:"localIp"===c?.webSocketURL?{hostname:t||void 0}:{hostname:"0.0.0.0",...c?.webSocketURL}}},e);return new Promise(((e,o)=>{l.startCallback((r=>{if(r)return o(r);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 enabledHmr Value indicates if we need to liveReload or `HMR`
+ * @param devPort The port number of `@flatjs/mock`
+ * @param publicIp The public ip address of local server
+ * @param evolveOptions The configuration of `@flatjs/evolve` (FlatEvolveOptions)
+ */
+export const addCompilerToDevServer = (compiler, enabledHmr, devPort, publicIp, 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: enabledHmr,
+        liveReload: !enabledHmr,
+        // 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,
+            webSocketURL: devServer?.webSocketURL === 'localIp'
+                ? {
+                    hostname: publicIp || undefined,
+                }
+                : {
+                    // always use public ip address cause of charles proxy to mobile devices don't work on  `ws://${domain host}:port`
+                    // if we use https, we don't need to specify the hostname or specify the https domain address
+                    hostname: '0.0.0.0',
+                    ...devServer?.webSocketURL,
+                },
+        },
+    }, 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,13 @@
-import{normalizePageProxy}from"../helpers/normalize-page-proxy.js";import{createPageMiddleware,createPublicAssetsMiddleware}from"./middlewares/index.js";export const createAppPageRoute=(e,r,a,o,i)=>{const{devServer:s}=i,t=normalizePageProxy(s?.pageProxy||"/pages");r.use(t,...createPageMiddleware(a,s?.mockOptions?.apiContext||"api",o,i)),r.use("*",createPublicAssetsMiddleware(e,t))};
+import { normalizePageProxy } from '../helpers/normalize-page-proxy.js';
+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;
+    const pageProxy = normalizePageProxy(devServer?.pageProxy || '/pages');
+    // Attach request handlers for context `/page/*`
+    app.use(pageProxy, ...createPageMiddleware(devHostUri, devServer?.mockOptions?.apiContext || 'api', servedDevServerEntries, evolveOptions));
+    // handle all no-matched page request.
+    app.use('*', createPublicAssetsMiddleware(projectCwd, pageProxy));
+};

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

@@ -1 +1,52 @@
-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,i)=>{const a=[];for(const[n,l]of Object.entries(t)){const s=l.entryConfig,p=s.options?.moduleFederation;(p?.remotes||[]).forEach((e=>{e.endpoint=e=>{const o=t[e];if(!o)throw new Error(`No servedDevServerEntry found via "${e}"`);return urlJoin(o?.devServerHostUri,["/public"])}}));const{devServerPort:c,devServerHostUri:m}=t[n],f={[n]:s},d=urlJoin(m,["public"]),v=await loadWebpackConfig("development",f,mergeOptions(i,{webpack:{publicPath:d}})),h=shouldEnableReactFastRefresh(!0,[n,s],i),g=webpack(splitToMultiCompilerConfigs(f,v,i,h)[0]);a.push(addCompilerToDevServer(g,h,c,r,i));const u=g.name||"";g.hooks.invalid.tap("fileChange",(o=>{const r=relative(e,o||"");logger.info(`file change ➩ ${chalk(["cyan"])(r)}`,u)})),g.hooks.done.tap("compileDone",(()=>{logger.info(`debug page ➩ ${chalk(["cyan"])(o)}`,u)}))}return a};
+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, publicIp, servedDevServerEntries, evolveOptions) => {
+    const serveTaks = [];
+    for (const [entryName, servedDevServerEntry] of Object.entries(servedDevServerEntries)) {
+        const itemEntryConfig = servedDevServerEntry.entryConfig;
+        const moduleFederation = itemEntryConfig.options?.moduleFederation;
+        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 enabledHmr = shouldEnableReactFastRefresh(true, [entryName, itemEntryConfig], evolveOptions);
+        const compiler = webpack(splitToMultiCompilerConfigs(singleEvolveEntryMap, webpackConfig, evolveOptions, enabledHmr)[0]);
+        // '@pmmmwh/react-refresh-webpack-plugin/client/ReactRefreshEntry.js',
+        serveTaks.push(
+        // create webpack dev server instance.
+        addCompilerToDevServer(compiler, enabledHmr, devServerPort, publicIp, 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,24 @@
-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:p,publicIp:s}=await prepareMockDomain(t||{});return new Promise((t=>{const i=e.devServer?.https?https.createServer(e.devServer?.https,r):r;r.set("hostUri",p),i.listen(o,(()=>{t({app:r,publicIp:s,devHostUri:p,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, publicIp } = 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,
+                publicIp,
+                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,33 @@
-import{getPageMainHtml}from"./get-page-main-html.js";import{getPageModuleHtml}from"./get-page-module-html.js";import{getRuntimeManifest}from"./get-runtime-manifest.js";export const createPageMiddleware=(e,t,a,m)=>(m.devServer?.middlewares||[]).concat((async(i,n)=>{let g;if("/runtime/manifest.json"===i.path){const t=await getRuntimeManifest(a,e,m);return n.json(t)}g="/"===i.path?await getPageMainHtml(a,e,m):await getPageModuleHtml(a,i,e,t,m),n.send(g)}));
+import { getPageMainHtml } from './get-page-main-html.js';
+import { getPageModuleHtml } from './get-page-module-html.js';
+import { getRuntimeManifest } from './get-runtime-manifest.js';
+/**
+ * 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;
+        // Expose a special runtime manifest.json for other system to intergration
+        if (req.path === '/runtime/manifest.json') {
+            const jsonManifest = await getRuntimeManifest(servedDevServerEntries, devHostUri, evolveOptions);
+            return res.json(jsonManifest);
+        }
+        // For root main page
+        if (req.path === '/') {
+            html = await getPageMainHtml(servedDevServerEntries, devHostUri, evolveOptions);
+        }
+        else {
+            // For serve page modules
+            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,i)=>async(t,s)=>{const a=t.baseUrl;if(a.startsWith("/public")){const i=await fileWalk(join("public/","**/*.{js,css}"),{cwd:e}),t=extname(a),l=i.find((e=>extname(e)===t&&-1!==e.indexOf(a.replace(/\.(?:js|css)$/,""))));l?s.sendFile(l):s.sendFile(join(e,a))}else s.redirect(i)};
+import { extname, join } from 'node:path';
+import { fileWalk } from '@armit/file-utility';
+export const createPublicAssetsMiddleware = (projectCwd, pageProxy) => async (req, res) => {
+    const baseUrl = req.baseUrl;
+    // exclude `/public` leave it fallback into webpack hot server
+    if (!baseUrl.startsWith('/public')) {
+        res.redirect(pageProxy);
+    }
+    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/get-all-sorted-modules.js

@@ -1 +1,24 @@
-import{getDevServerHostUri}from"./get-dev-server-host-uri.js";import{getNormalizedEntryName}from"./get-normalized-entry-name.js";import{getProjectVirtualPath}from"./get-project-virtual-path.js";export function getSortedModules(e,t,r){const o=[],n=getProjectVirtualPath(e);for(const[i,a]of Object.entries(e.entryMap)){const s=Object.keys(t).includes(i),m=getDevServerHostUri(t,i,r),v=getNormalizedEntryName(i,n,t,e.devServer);o.push({entryName:i,entryContent:a,devHostUri:r,devServerHostUri:m,normalizedEntryName:v,projectVirtualPath:n,isServedEntry:s})}return o}
+import { getDevServerHostUri } from './get-dev-server-host-uri.js';
+import { getNormalizedEntryName } from './get-normalized-entry-name.js';
+import { getProjectVirtualPath } from './get-project-virtual-path.js';
+export function getSortedModules(evolveOptions, servedDevServerEntries, devHostUri) {
+    const sortedModules = [];
+    const projectVirtualPath = getProjectVirtualPath(evolveOptions);
+    for (const [entryName, entryContent] of Object.entries(evolveOptions.entryMap)) {
+        // `home`, servedDevServerEntries[key] => `home`
+        const isServedEntry = Object.keys(servedDevServerEntries).includes(entryName);
+        const devServerHostUri = getDevServerHostUri(servedDevServerEntries, entryName, devHostUri);
+        // `flatjs/evolve/home`
+        const normalizedEntryName = getNormalizedEntryName(entryName, projectVirtualPath, servedDevServerEntries, evolveOptions.devServer);
+        sortedModules.push({
+            entryName,
+            entryContent,
+            devHostUri,
+            devServerHostUri,
+            normalizedEntryName,
+            projectVirtualPath,
+            isServedEntry,
+        });
+    }
+    return sortedModules;
+}

package/dist/dev-server/middlewares/get-bundle-asset.js

@@ -1 +1,7 @@
-import{join}from"node:path/posix";import{urlJoin}from"@flatjs/common";export const getBundleAsset=(o,n,i)=>urlJoin(o,[join("public",n,`bundle${i}`)]);
+import { join } from 'node:path/posix';
+import { urlJoin } from '@flatjs/common';
+export const getBundleAsset = (devServerHostUri, normalizedCurrEntry, extension) => {
+    return urlJoin(devServerHostUri, [
+        join('public', normalizedCurrEntry, `bundle${extension}`),
+    ]);
+};

package/dist/dev-server/middlewares/get-dev-server-host-uri.js

@@ -1 +1,5 @@
-export function getDevServerHostUri(e,r,t){const o=e[r];return o?.devServerHostUri||t}
+export function getDevServerHostUri(servedDevServerEntries, currEntry, devHostUri) {
+    const currDevServerEntry = servedDevServerEntries[currEntry];
+    // Maybe No currEntry found in servedDevServerEntries, use default `hostUri`, e.g. `static` mode.
+    return currDevServerEntry?.devServerHostUri || devHostUri;
+}

package/dist/dev-server/middlewares/get-hmr-runtime-chunks.js

@@ -1 +1,14 @@
-import{join}from"node:path";import{devReactFastRefresh}from"../../constants.js";import{shouldEnableReactFastRefresh}from"../../helpers/should-enable-react-fast-refresh.js";import{getBundleAsset}from"./get-bundle-asset.js";export function getHmrRuntimeChunks(e,t,s,r,n,a){if(e[t]&&shouldEnableReactFastRefresh(!0,[s,r],n)){return[getBundleAsset(a,join(s,devReactFastRefresh.runtime),".js"),getBundleAsset(a,join(s,devReactFastRefresh.reactRefreshSetup),".js")]}return[]}
+import { join } from 'node:path';
+import { devReactFastRefresh } from '../../constants.js';
+import { shouldEnableReactFastRefresh } from '../../helpers/should-enable-react-fast-refresh.js';
+import { getBundleAsset } from './get-bundle-asset.js';
+export function getHmrRuntimeChunks(servedDevServerEntries, entryName, normalizedCurrEntry, currEntryItem, evolveOptions, devServerHostUri) {
+    const enabledHmr = servedDevServerEntries[entryName] &&
+        shouldEnableReactFastRefresh(true, [normalizedCurrEntry, currEntryItem], evolveOptions);
+    if (enabledHmr) {
+        const runtimeAsset = getBundleAsset(devServerHostUri, join(normalizedCurrEntry, devReactFastRefresh.runtime), '.js');
+        const reactRefreshSetup = getBundleAsset(devServerHostUri, join(normalizedCurrEntry, devReactFastRefresh.reactRefreshSetup), '.js');
+        return [runtimeAsset, reactRefreshSetup];
+    }
+    return [];
+}

package/dist/dev-server/middlewares/get-normalized-entry-name.js

@@ -1 +1,14 @@
-import{normalizeEvolveEntryName}from"../../helpers/normalize-entry-map.js";export function getNormalizedEntryName(e,r,t,l){let n=normalizeEvolveEntryName(e,r);if(l?.bundleDirResolver){const o=Object.keys(t).includes(e);n=l?.bundleDirResolver(n,{currEntry:e,projectVirtualPath:r,isServedModule:o})}return n}
+import { normalizeEvolveEntryName } from '../../helpers/normalize-entry-map.js';
+export function getNormalizedEntryName(entryName, projectVirtualPath, servedDevServerEntries, devServer) {
+    let normalizedEntryName = normalizeEvolveEntryName(entryName, projectVirtualPath);
+    // Check if we have customized dir resolver
+    if (devServer?.bundleDirResolver) {
+        const isServedEntry = Object.keys(servedDevServerEntries).includes(entryName);
+        normalizedEntryName = devServer?.bundleDirResolver(normalizedEntryName, {
+            currEntry: entryName,
+            projectVirtualPath,
+            isServedModule: isServedEntry,
+        });
+    }
+    return normalizedEntryName;
+}

package/dist/dev-server/middlewares/get-page-main-html.js

@@ -1 +1,42 @@
-import{readFileSync}from"node:fs";import{join}from"node:path";import{urlJoin}from"@flatjs/common";import _ from"lodash";import{getPackageDir}from"../../helpers/get-pacakge-dir.js";import{normalizePageProxy}from"../../helpers/normalize-page-proxy.js";import{getSortedModules}from"./get-all-sorted-modules.js";export const getPageMainHtml=async(e,r,t)=>{const o=getPackageDir(),a=readFileSync(join(o,"./templates/main.html"),"utf-8"),i=getSortedModules(t,e,r),n=normalizePageProxy(t.devServer?.pageProxy||"/pages"),m={title:"@flatjs/evolve",modules:i.map((e=>{const{entryName:t,entryContent:o,isServedEntry:a,projectVirtualPath:i,normalizedEntryName:m}=e,l=urlJoin(r,[n,m],{env:"me"}),s=o.options?.servePageMainLinkFn||(e=>e);return{link:s(l,{hostUri:r,entryName:t,virtualPath:i}),name:t.replace(i,"").replace(/^\//,""),flagText:a?"serve":"static",isServed:a?1:0}})).sort(((e,r)=>r.isServed-e.isServed))};return _.template(a)(m)};
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { urlJoin } from '@flatjs/common';
+import _ from 'lodash';
+import { getPackageDir } from '../../helpers/get-pacakge-dir.js';
+import { normalizePageProxy } from '../../helpers/normalize-page-proxy.js';
+import { getSortedModules, } from './get-all-sorted-modules.js';
+export const getPageMainHtml = async (servedDevServerEntries, devHostUri, evolveOptions) => {
+    const evolveCwd = getPackageDir();
+    const templateStr = readFileSync(join(evolveCwd, './templates/main.html'), 'utf-8');
+    const sortedModules = getSortedModules(evolveOptions, servedDevServerEntries, devHostUri);
+    const pageProxy = normalizePageProxy(evolveOptions.devServer?.pageProxy || '/pages');
+    const templateModules = sortedModules.map((module) => {
+        const { entryName, entryContent, isServedEntry, projectVirtualPath, normalizedEntryName, } = module;
+        const linkHref = urlJoin(devHostUri, [pageProxy, normalizedEntryName], {
+            env: 'me',
+        });
+        // Allow customized page main link.
+        const servePageMainLinkFn = entryContent.options?.servePageMainLinkFn || ((link) => link);
+        const link = servePageMainLinkFn(linkHref, {
+            hostUri: devHostUri,
+            entryName,
+            virtualPath: projectVirtualPath,
+        });
+        const displayName = entryName
+            .replace(projectVirtualPath, '')
+            .replace(/^\//, '');
+        return {
+            link,
+            name: displayName,
+            flagText: isServedEntry ? 'serve' : 'static',
+            isServed: isServedEntry ? 1 : 0,
+        };
+    });
+    const templateData = {
+        title: '@flatjs/evolve',
+        modules: templateModules.sort((a, b) => {
+            return b.isServed - a.isServed;
+        }),
+    };
+    return _.template(templateStr)(templateData);
+};

package/dist/dev-server/middlewares/get-page-module-html.js

@@ -1 +1,120 @@
-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{normalizePageProxy}from"../../helpers/normalize-page-proxy.js";import{injectFederationScripts}from"../../helpers/script-injects.js";import{getBundleAsset}from"./get-bundle-asset.js";import{getDevServerHostUri}from"./get-dev-server-host-uri.js";import{getHmrRuntimeChunks}from"./get-hmr-runtime-chunks.js";import{getNormalizedEntryName}from"./get-normalized-entry-name.js";export const getPageModuleHtml=async(e,t,r,o,l)=>{const{entryMap:i,projectVirtualPath:a}=l,s=Object.keys(i).sort(((e,t)=>t.length-e.length)),n=getPackageDir(),m=s.find((e=>{const r=normalizeEvolveEntryName(e,a);return ensureSlash(t.path.replace(/^\//,""),!0).startsWith(ensureSlash(r,!0))}));if(!m){const e=readFileSync(join(n,"./templates/module-404.html"),"utf-8");return _.template(e)({title:"404 Not Found",errorMeta:[{name:"@flatjs/evolve workspace",value:n},{name:"served entry names",value:JSON.stringify(s)},{name:"module path",value:`${t.path}`}]})}const p=i[m],g=p.options,u=getDevServerHostUri(e,m,r),d=g?.serveModuleTemplate||"./templates/module.html",f=join(l.projectCwd,"./templates/module.html"),c=readFileSync(isAbsolute(d)?d:existsSync(f)?f:join(n,"./templates/module.html"),"utf-8"),h=l.devServer,v=h?.defaultServeGlobalData?await h.defaultServeGlobalData(p,r):{},S={mode:"development",envCdn:urlJoin(r,["public"])},y=getNormalizedEntryName(m,a,e,h),j=normalizePageProxy(h?.pageProxy||"/pages"),H={title:getHtmlPluginConfig("title",S,g?.title),favicon:getHtmlPluginConfig("favicon",S,g?.favicon),viewport:allowPx2remForModule([m,p],l)?getHtmlPluginConfig("viewport",S,g?.viewport):"",headBeforeHtmlTags:getHtmlPluginConfig("headBeforeHtmlTags",S,g?.headBeforeHtmlTags),inlineScripts:getHtmlPluginConfig("inlineScripts",S,g?.inlineScripts),headBeforeStyles:getHtmlPluginConfig("headBeforeStyles",S,g?.headBeforeStyles),headBeforeScripts:getHtmlPluginConfig("headBeforeScripts",S,g?.headBeforeScripts),bodyAfterScripts:getHtmlPluginConfig("bodyAfterScripts",S,g?.bodyAfterScripts),moduleFederationScripts:injectFederationScripts({me:[urlJoin(r,["public"])]},l.multiHtmlCdnEnvResolver),global:{hostUrl:r,apiBase:urlJoin(r,[o]),virtualPath:join(j,a),moduleName:m.replace(a,"").replace(/^\//,""),...v,...g?.serveGlobalData||{}},styles:[getBundleAsset(u,y,".css")],scripts:[getBundleAsset(u,y,".js")]};H.headBeforeHtmlTags?H.headBeforeHtmlTags=H.headBeforeHtmlTags.slice(0):H.headBeforeHtmlTags=[];return getHmrRuntimeChunks(e,m,y,p,l,u).forEach((e=>{H.headBeforeHtmlTags?.push(`<script src="${e}"><\/script>`)})),_.template(c)(H)};
+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 { normalizePageProxy } from '../../helpers/normalize-page-proxy.js';
+import { injectFederationScripts } from '../../helpers/script-injects.js';
+import { getBundleAsset } from './get-bundle-asset.js';
+import { getDevServerHostUri } from './get-dev-server-host-uri.js';
+import { getHmrRuntimeChunks } from './get-hmr-runtime-chunks.js';
+import { getNormalizedEntryName } from './get-normalized-entry-name.js';
+export const getPageModuleHtml = async (servedDevServerEntries, req, devHostUri, apiContext, evolveOptions
+// eslint-disable-next-line sonarjs/cognitive-complexity
+) => {
+    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 currEntryName = entryNames.find((entryName) => {
+        const normalizedEntryName = normalizeEvolveEntryName(entryName, projectVirtualPath);
+        return ensureSlash(req.path.replace(/^\//, ''), true).startsWith(ensureSlash(normalizedEntryName, true));
+    });
+    if (!currEntryName) {
+        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 currEntryItem = entryMap[currEntryName];
+    const currEntryOption = currEntryItem.options;
+    // currEntry: `home`
+    const devServerHostUri = getDevServerHostUri(servedDevServerEntries, currEntryName, 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']),
+    };
+    // Get normalized entry name
+    const normalizedEntryName = getNormalizedEntryName(currEntryName, projectVirtualPath, servedDevServerEntries, devServer);
+    const pageProxy = normalizePageProxy(devServer?.pageProxy || '/pages');
+    const templateData = {
+        // title
+        title: getHtmlPluginConfig('title', configData, currEntryOption?.title),
+        // favicon
+        favicon: getHtmlPluginConfig('favicon', configData, currEntryOption?.favicon),
+        // `allowPx2rem` default is true
+        viewport: allowPx2remForModule([currEntryName, 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(pageProxy, projectVirtualPath),
+            moduleName: currEntryName
+                .replace(projectVirtualPath, '')
+                .replace(/^\//, ''),
+            ...defaultGlobalData,
+            ...(currEntryOption?.serveGlobalData || {}),
+        },
+        styles: [getBundleAsset(devServerHostUri, normalizedEntryName, '.css')],
+        scripts: [getBundleAsset(devServerHostUri, normalizedEntryName, '.js')],
+    };
+    if (!templateData.headBeforeHtmlTags) {
+        templateData.headBeforeHtmlTags = [];
+    }
+    else {
+        // Avoid deep object reference here.
+        templateData.headBeforeHtmlTags = templateData.headBeforeHtmlTags.slice(0);
+    }
+    // Indicates current we use `hot` mode for `webpack-dev-server` hot reload true.
+    const devRuntimeChunks = getHmrRuntimeChunks(servedDevServerEntries, currEntryName, normalizedEntryName, currEntryItem, evolveOptions, devServerHostUri);
+    devRuntimeChunks.forEach((runtimeChunk) => {
+        templateData.headBeforeHtmlTags?.push(`<script src="${runtimeChunk}"></script>`);
+    });
+    return _.template(templateStr)(templateData);
+};

package/dist/dev-server/middlewares/get-project-virtual-path.js

@@ -1 +1,3 @@
-export const getProjectVirtualPath=t=>t.projectVirtualPath.replace(/^\//,"");
+export const getProjectVirtualPath = (evolveOptions) => {
+    return evolveOptions.projectVirtualPath.replace(/^\//, '');
+};