@flatjs/evolve 2.1.0-next.11 → 2.1.0-next.12

package/dist/create-webpack/rule-sets/rule-svg-icon.js

@@ -1 +1,25 @@
-import{getDirname}from"@armit/file-utility";import{isIconSvg}from"./rule-utils.js";export const ruleSvgIcon=()=>({test:e=>isIconSvg(e),use:[{loader:getDirname(import.meta.url,"../../loaders/loader-icon.cjs"),options:{svgo:{plugins:[{name:"removeTitle"},{name:"removeDimensions"}]}}}]});
+import { getDirname } from '@armit/file-utility';
+import { isIconSvg } from './rule-utils.js';
+/**
+ * Preparing svg loader for `icons`
+ * Note we must be put all *.svg into folder `icons`
+ */
+export const ruleSvgIcon = () => {
+    const loader = {
+        test(resource) {
+            return isIconSvg(resource);
+        },
+        use: [
+            {
+                // FIXME: we need to always keep the directory structures here to make sure correct loader path resolve.
+                loader: getDirname(import.meta.url, '../../loaders/loader-icon.cjs'),
+                options: {
+                    svgo: {
+                        plugins: [{ name: 'removeTitle' }, { name: 'removeDimensions' }],
+                    },
+                },
+            },
+        ],
+    };
+    return loader;
+};

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,83 @@
-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},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,
+    },
+    /**
+     * 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-task.js

@@ -1 +1,55 @@
-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{assertSingleCompiler}from"../helpers/assert-single-compiler.js";import{flatEntryMap}from"../helpers/flat-entry-map.js";import{shouldEnableReactFastRefresh}from"../helpers/should-enable-react-fast-refresh.js";import{addCompilerToDevServer}from"./add-compiler-to-dev-server.js";export const createDevServerCompilerTask=async(e,r,o,t,a,n)=>{const[i,s]=Object.entries(t)[0],{devServerPort:l,devServerHostUri:p}=s;for(const[,e]of Object.entries(t)){const r=e.entryConfig,o=r.options?.moduleFederation,t=o?.remotes||[],n=flatEntryMap(a);t.forEach((e=>{e.endpoint=e=>{const r=n[e];if(!r)throw new Error(`No servedDevServerEntry found via "${e}"`);return urlJoin(r?.devServerHostUri,["/public"])}}))}const c=Object.keys(t).reduce(((e,r)=>(e[r]=t[r].entryConfig,e)),{}),m=urlJoin(p,["public"]),f=await loadWebpackConfig("development",c,mergeOptions(n,{webpack:{publicPath:m}})),d=shouldEnableReactFastRefresh(!0,[i,s.entryConfig],n),v=assertSingleCompiler(c,f,n,d),g=webpack(v),h=addCompilerToDevServer(g,d,l,o,n),b=g.name||"";return g.hooks.invalid.tap("fileChange",(r=>{const o=relative(e,r||"");logger.info(`file change ➩ ${chalk(["cyan"])(o)}`,b)})),g.hooks.done.tap("compileDone",(()=>{logger.info(`debug page ➩ ${chalk(["cyan"])(r)}`,b)})),h};
+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 { assertSingleCompiler } from '../helpers/assert-single-compiler.js';
+import { flatEntryMap } from '../helpers/flat-entry-map.js';
+import { shouldEnableReactFastRefresh } from '../helpers/should-enable-react-fast-refresh.js';
+import { addCompilerToDevServer } from './add-compiler-to-dev-server.js';
+export const createDevServerCompilerTask = async (projectCwd, mainPage, publicIp, servedDevServerEntries, servedDevServerEntryList, evolveOptions) => {
+    // First entry option in a group
+    const [firstDevServeEntryName, firstDevServeEntryOption] = Object.entries(servedDevServerEntries)[0];
+    const { devServerPort, devServerHostUri } = firstDevServeEntryOption;
+    for (const [, servedDevServerEntry] of Object.entries(servedDevServerEntries)) {
+        const itemEntryConfig = servedDevServerEntry.entryConfig;
+        const moduleFederation = itemEntryConfig.options?.moduleFederation;
+        const moduleFederationRemotes = moduleFederation?.remotes || [];
+        const allServedDevServerEntries = flatEntryMap(servedDevServerEntryList);
+        moduleFederationRemotes.forEach((remote) => {
+            // Dynamic construct remote endpoint as hostUri
+            remote.endpoint = (shortName) => {
+                const servedDevServerEntry = allServedDevServerEntries[shortName];
+                if (!servedDevServerEntry) {
+                    throw new Error(`No servedDevServerEntry found via "${shortName}"`);
+                }
+                return urlJoin(servedDevServerEntry?.devServerHostUri, ['/public']);
+            };
+        });
+    }
+    const devEvolveEntryMap = Object.keys(servedDevServerEntries).reduce((previousValue, currentValue) => {
+        previousValue[currentValue] =
+            servedDevServerEntries[currentValue].entryConfig;
+        return previousValue;
+    }, {});
+    // e.g. `http://dev.flatjs.com:3002/public/`
+    const servePublicPath = urlJoin(devServerHostUri, ['public']);
+    const webpackConfig = await loadWebpackConfig('development', devEvolveEntryMap, mergeOptions(evolveOptions, {
+        webpack: {
+            publicPath: servePublicPath,
+        },
+    }));
+    const enabledHmr = shouldEnableReactFastRefresh(true, [firstDevServeEntryName, firstDevServeEntryOption.entryConfig], evolveOptions);
+    const config = assertSingleCompiler(devEvolveEntryMap, webpackConfig, evolveOptions, enabledHmr);
+    const compiler = webpack(config);
+    // '@pmmmwh/react-refresh-webpack-plugin/client/ReactRefreshEntry.js',
+    const serveTask = 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 serveTask;
+};

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

@@ -1 +1,25 @@
-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={},{mockPort:a,hostUri:i}=await prepareMockDomain(mergeOptions(t?.mockOptions||{},{port:r}));for(const[r,o]of Object.entries(e)){const e=normalizeEvolveEntryName(r,n);m[r]={entryConfig:o,devServerPort:a,devServerHostUri:i,normalizedEntryName:e}}return m};
+import { mergeOptions } from '@flatjs/common';
+import { prepareMockDomain } from '@flatjs/mock';
+import { normalizeEvolveEntryName } from '../helpers/normalize-entry-map.js';
+export const createDevServerEntries = async (lastPort, 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
+    // Create individual devPort for each compiler here.
+    const { mockPort: devServerPort, hostUri: devServerHostUri } = await prepareMockDomain(mergeOptions(devServer?.mockOptions || {}, {
+        port: lastPort,
+    }));
+    // Prepare devServer ports for each served entry.
+    for (const [entryName, entryConfig] of Object.entries(servedEntries)) {
+        // entryName: `home` should be normalized 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-task.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-task.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,49 @@
-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"),n=getSortedModules(t,e,r),i=normalizePageProxy(t.devServer?.pageProxy||"/pages"),m=n.map((e=>{const{entryName:t,entryContent:o,isServedEntry:a,projectVirtualPath:n,normalizedEntryName:m}=e,s=urlJoin(r,[i,m],{env:"me"}),l=o.options?.servePageMainLinkFn||(e=>e);return{link:l(s,{hostUri:r,entryName:t,virtualPath:n}),name:t.replace(n,"").replace(/^\//,""),flagText:a?"serve":"static",isServed:a?1:0}}));m.push({flagText:"serve",isServed:1,link:urlJoin(r,[i,"/runtime/manifest.json"]),name:"Runtime Manifest"});const s={title:"@flatjs/evolve",modules:m.sort(((e,r)=>r.isServed-e.isServed))};return _.template(a)(s)};
+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,
+        };
+    });
+    // Add `runtime manifest` to the main page modules list
+    templateModules.push({
+        flagText: 'serve',
+        isServed: 1,
+        link: urlJoin(devHostUri, [pageProxy, '/runtime/manifest.json']),
+        name: 'Runtime Manifest',
+    });
+    const templateData = {
+        title: '@flatjs/evolve',
+        modules: templateModules.sort((a, b) => {
+            return b.isServed - a.isServed;
+        }),
+    };
+    return _.template(templateStr)(templateData);
+};