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

package/dist/plugins/module-federation/module-federation.js

@@ -1 +1 @@
-import{join}from"node:path";import{ensureSlash}from"@flatjs/common";import webpack from"webpack";import{normalizeEvolveEntryName}from"../../helpers/normalize-entry-map.js";import{injectFederationScripts}from"../../helpers/script-injects.js";import{HtmlInjectScriptPlugin}from"../html-inject-scripts/plugin-html-inject-script.js";import{ExternalTemplateRemotesPlugin}from"./external-template-remotes.js";const normalizeWidgetName=(e="")=>e.replace(/[/-]/g,"_").toLowerCase(),remoteFileName=e=>join(e,"micro-remote-module.js");export const createModuleFederationPlugin=(e,t,r)=>{const o=r.projectVirtualPath,[n,i]=t,m=r.multiHtmlCdn,a=r.multiHtmlCdnEnvResolver,l=i.options?.moduleFederation,s=[];if(l){const{remotes:t,exposes:r,...i}=l,p=remoteFileName(n),c=normalizeWidgetName(n),u=(r?Array.isArray(r)?r:[r]:[]).map((e=>{const t={};for(const[r,o]of Object.entries(e))t[r]={...o,name:join(n,o.name.replace(/^\//,""))};return t})),d=(t||[]).map((({name:e,endpoint:t})=>{const r=normalizeEvolveEntryName(e,o),n=normalizeWidgetName(r),i=remoteFileName(r);return{[n]:`${n}@${t?ensureSlash(t(e,r),!1):"[window.evolveFetchMicroWidgets()]"}/${i}`}}));s.push(new webpack.container.ModuleFederationPlugin({...i,name:c,filename:p,remotes:d,exposes:u}),new ExternalTemplateRemotesPlugin),e||s.unshift(new HtmlInjectScriptPlugin([injectFederationScripts(m,a)]))}return s};
+import{join}from"node:path";import webpack from"webpack";import{ensureSlash}from"@flatjs/common";import{normalizeEvolveEntryName}from"../../helpers/normalize-entry-map.js";import{injectFederationScripts}from"../../helpers/script-injects.js";import{HtmlInjectScriptPlugin}from"../html-inject-scripts/plugin-html-inject-script.js";import{ExternalTemplateRemotesPlugin}from"./external-template-remotes.js";const normalizeWidgetName=(e="")=>e.replace(/[/-]/g,"_").toLowerCase(),remoteFileName=e=>join(e,"micro-remote-module.js");export const createModuleFederationPlugin=(e,t,o)=>{const r=o.projectVirtualPath,n=o.multiHtmlCdn,i=o.multiHtmlCdnEnvResolver,m=[];for(const o of t){const[t,a]=o,l=a.options?.moduleFederation;if(l){const{remotes:o,exposes:a,...s}=l,c=remoteFileName(t),p=normalizeWidgetName(t),u=(a?Array.isArray(a)?a:[a]:[]).map((e=>{const o={};for(const[r,n]of Object.entries(e))o[r]={...n,name:join(t,n.name.replace(/^\//,""))};return o})),d=(o||[]).map((({name:e,endpoint:t})=>{const o=normalizeEvolveEntryName(e,r),n=normalizeWidgetName(o),i=remoteFileName(o),m=t?ensureSlash(t(e,o),!1):"[window.evolveFetchMicroWidgets()]";return{[n]:`${n}@${m}/${i}`}}));m.push(new webpack.container.ModuleFederationPlugin({...s,name:p,filename:c,remotes:d,exposes:u}),new ExternalTemplateRemotesPlugin),e||m.unshift(new HtmlInjectScriptPlugin([injectFederationScripts(n,i)]))}}return m};

package/dist/plugins/multi-html/index.d.ts

@@ -1,4 +1,4 @@
 import { type WebpackPlugin } from '../../create-webpack/types.js';
 import { type EntryMapItem } from '../../types/types-entry-map.js';
 import { type FlatEvolveOptions } from '../../types/types-options.js';
-export declare const createHtmlPlugins: (serveMode: boolean, entryMapItem: EntryMapItem, evolveOptions: FlatEvolveOptions) => WebpackPlugin[];
+export declare const createHtmlPlugins: (serveMode: boolean, entryMapItemList: EntryMapItem[], evolveOptions: FlatEvolveOptions) => WebpackPlugin[];

package/dist/plugins/multi-html/index.js

@@ -1 +1 @@
-import{FlatEvolveMultiCdnPlugin}from"./multi-html-cdn-plugin.js";import{createMultiHtmlWebpackPlugin}from"./multi-html-plugin.js";export const createHtmlPlugins=(t,l,u)=>{const i=[];if(t||l[1]?.options?.output?.library)return i;const n=Object.keys(u.multiHtmlCdn);return i.push(...createMultiHtmlWebpackPlugin(t,u,l,n)),i.push(new FlatEvolveMultiCdnPlugin(u)),i};
+import{FlatEvolveMultiCdnPlugin}from"./multi-html-cdn-plugin.js";import{createMultiHtmlWebpackPlugin}from"./multi-html-plugin.js";export const createHtmlPlugins=(t,l,u)=>{const i=[],n=l[0];if(t||n[1]?.options?.output?.library)return i;const e=Object.keys(u.multiHtmlCdn);return i.push(...createMultiHtmlWebpackPlugin(t,u,l,e)),i.push(new FlatEvolveMultiCdnPlugin(u)),i};

package/dist/plugins/multi-html/multi-html-cdn-plugin.js

@@ -1 +1 @@
-import{basename}from"node:path";import HtmlWebpackPlugin from"html-webpack-plugin";import webpack from"webpack";import{cdnFinder,findEnvCdn,httpUrlJoin}from"../../helpers/script-injects.js";export class FlatEvolveMultiCdnPlugin{constructor(e){if(this.pluginName="FlatEvolveMultiCdnPlugin",this.requireFn=webpack.RuntimeGlobals.publicPath,this.config=e.multiHtmlCdn,this.cdnResolver=e.multiHtmlCdnEnvResolver||function cdnResolver(){},!this.config?.prod)throw new Error("We must setup `prod` for each CDN config node!")}apply(e){e.hooks.thisCompilation.tap(this.pluginName,(e=>{e.mainTemplate.hooks.requireExtensions.tap(this.pluginName,((n,t)=>{const i=[];i.push("// Dynamic assets path override(`@flatjs/evolve`) plugin-multi-html-cdn`)");const s=e.chunkGraph?.getTreeRuntimeRequirements(t);return s&&s.has(webpack.RuntimeGlobals.requireScope)&&(i.push("(function () {"),i.push(webpack.Template.indent("var flatjsMultiCdn = {")),i.push(webpack.Template.indent(webpack.Template.indent([`cdnConfig: ${JSON.stringify(this.config||{})},`]))),i.push(webpack.Template.indent(webpack.Template.indent([`cdnResolver: ${this.cdnResolver.toString()},`]))),i.push(webpack.Template.indent(webpack.Template.indent([`cdnFinder: ${cdnFinder.toString()}`]))),i.push(webpack.Template.indent("};")),i.push(webpack.Template.indent(`${this.requireFn} = flatjsMultiCdn.cdnFinder(flatjsMultiCdn.cdnConfig, flatjsMultiCdn.cdnResolver) || ${this.requireFn};`)),i.push("})();")),webpack.Template.asString(i)}))})),e.hooks.compilation.tap(this.pluginName,(e=>{HtmlWebpackPlugin.getHooks(e).beforeAssetTagGeneration.tap(this.pluginName,(e=>{const{assets:n}=e,{userOptions:t}=e.plugin,i=t.multiCdn,s=n.publicPath,a=n.js.map((e=>{if(i.disabled)return basename(e);const n=findEnvCdn(this.config,i.env);return httpUrlJoin(n,e.replace(s,""))})),p=n.css.map((e=>{if(i.disabled)return basename(e);const n=findEnvCdn(this.config,i.env);return httpUrlJoin(n,e.replace(s,""))}));return e.assets.js=a,e.assets.css=p,e}))}))}}
+import HtmlWebpackPlugin from"html-webpack-plugin";import{basename}from"node:path";import webpack from"webpack";import{getRuntimeCDNBase}from"../../helpers/get-runtime-cdn-base.js";import{findEnvCdn,httpUrlJoin}from"../../helpers/script-injects.js";export class FlatEvolveMultiCdnPlugin{constructor(e){if(this.pluginName="FlatEvolveMultiCdnPlugin",this.requireFn=webpack.RuntimeGlobals.publicPath,this.config=e.multiHtmlCdn,this.cdnResolver=e.multiHtmlCdnEnvResolver||function cdnResolver(){},!this.config?.prod)throw new Error("We must setup `prod` for each CDN config node!")}apply(e){e.hooks.thisCompilation.tap(this.pluginName,(e=>{e.mainTemplate.hooks.requireExtensions.tap(this.pluginName,((t,n)=>{const i=[];i.push("// Dynamic assets path override(`@flatjs/evolve`) plugin-multi-html-cdn`)");const s=e.chunkGraph?.getTreeRuntimeRequirements(n);return s&&s.has(webpack.RuntimeGlobals.requireScope)&&i.push(webpack.Template.indent(getRuntimeCDNBase(this.config,this.cdnResolver,this.requireFn))),webpack.Template.asString(i)}))})),e.hooks.compilation.tap(this.pluginName,(e=>{HtmlWebpackPlugin.getHooks(e).beforeAssetTagGeneration.tap(this.pluginName,(e=>{const{assets:t,plugin:n,outputName:i}=e,s=n?.options?.chunks||[],r=Array.isArray(s)?s.find((e=>i.includes(e))):s,{userOptions:o}=e.plugin;if(!r)throw new Error("We must have current chunk!");const a=t.js.filter((e=>e.includes(r))),l=t.css.filter((e=>e.includes(r))),p=o.multiCdn,u=t.publicPath,c=a.map((e=>{if(p.disabled)return basename(e);const t=findEnvCdn(this.config,p.env);return httpUrlJoin(t,e.replace(u,""))})),m=l.map((e=>{if(p.disabled)return basename(e);const t=findEnvCdn(this.config,p.env);return httpUrlJoin(t,e.replace(u,""))}));return e.assets.js=c,e.assets.css=m,e}))}))}}

package/dist/plugins/multi-html/multi-html-plugin.d.ts

@@ -8,4 +8,4 @@ import { type FlatEvolveOptions } from '../../types/types-options.js';
  * @param buildEntryItem the entries for this `build`
  * @param allEnv
  */
-export declare const createMultiHtmlWebpackPlugin: (serveMode: boolean, evolveOptions: FlatEvolveOptions, entryMapItem: EntryMapItem, allEnv: Array<EvolveMultiCdnEnvType>) => WebpackPlugin[];
+export declare const createMultiHtmlWebpackPlugin: (serveMode: boolean, evolveOptions: FlatEvolveOptions, entryMapItemList: EntryMapItem[], allEnv: Array<EvolveMultiCdnEnvType>) => WebpackPlugin[];

package/dist/plugins/multi-html/multi-html-plugin.js

@@ -1 +1 @@
-import HtmlWebpackPlugin from"html-webpack-plugin";import{allowPx2remForModule}from"../../helpers/allow-px2rem-for-module.js";import{getHtmlPluginConfig}from"../../helpers/get-html-plugin-config.js";import{findEnvCdn}from"../../helpers/script-injects.js";const minifyOpts={minifyJS:!0,removeComments:!0,collapseWhitespace:!0,collapseBooleanAttributes:!1};export const createMultiHtmlWebpackPlugin=(e,t,i,l)=>{const[n,o]=i,r=[],{options:m}=o,g=e?"development":"production";for(const e of l){const l={mode:g,envCdn:findEnvCdn(t.multiHtmlCdn,e)};r.push(new HtmlWebpackPlugin({inject:"body",title:getHtmlPluginConfig("title",l,m?.title),chunks:[n],minify:!1!==m?.htmlMinify&&!["me","dev"].includes(e)&&minifyOpts,filename:`${n}/index${"prod"===e?"":`-${e}`}.html`,template:getHtmlPluginConfig("templatePath",l,m?.templatePath).replace("{0}",e),templateParameters:{title:getHtmlPluginConfig("title",l,m?.title),favicon:getHtmlPluginConfig("favicon",l,m?.favicon),headBeforeHtmlTags:getHtmlPluginConfig("headBeforeHtmlTags",l,m?.headBeforeHtmlTags),inlineScripts:getHtmlPluginConfig("inlineScripts",l,m?.inlineScripts),headBeforeStyles:getHtmlPluginConfig("headBeforeStyles",l,m?.headBeforeStyles),headBeforeScripts:getHtmlPluginConfig("headBeforeScripts",l,m?.headBeforeScripts),bodyAfterScripts:getHtmlPluginConfig("bodyAfterScripts",l,m?.bodyAfterScripts),viewport:allowPx2remForModule(i,t)?getHtmlPluginConfig("viewport",l,m?.viewport):""},multiCdn:{env:e,disabled:(m?.excludeCdnEnvs||["me","dev","ntv"]).includes(e)}}))}return r};
+import HtmlWebpackPlugin from"html-webpack-plugin";import{existsSync}from"node:fs";import{logger}from"@flatjs/common";import{allowPx2remForModule}from"../../helpers/allow-px2rem-for-module.js";import{getHtmlPluginConfig}from"../../helpers/get-html-plugin-config.js";import{normalizeTemplateInjectTokens}from"../../helpers/normalize-template-inject-tokens.js";import{findEnvCdn}from"../../helpers/script-injects.js";const minifyOpts={minifyJS:!0,removeComments:!0,collapseWhitespace:!0,collapseBooleanAttributes:!1};export const createMultiHtmlWebpackPlugin=(e,t,l,i)=>{const n=l[0],[,o]=n,m=[],{options:r}=o,p=e?"development":"production",s=l.map((e=>e[0]));for(const e of i){const l={mode:p,envCdn:findEnvCdn(t.multiHtmlCdn,e)},i=normalizeTemplateInjectTokens(l,r);let o=getHtmlPluginConfig("templatePath",l,r?.templatePath).replace("{0}",e.trim());existsSync(o)||(logger.warn(`The template file ${o} is not exists, use \`prod\` instead!`),o=getHtmlPluginConfig("templatePath",l,r?.templatePath).replace("{0}","prod")),m.push(new HtmlWebpackPlugin({inject:"body",title:getHtmlPluginConfig("title",l,r?.title),chunks:s,minify:!1!==r?.htmlMinify&&!["me","dev"].includes(e)&&minifyOpts,filename:t=>`${t}/index${"prod"===e?"":`-${e}`}.html`,template:o,templateParameters:{title:getHtmlPluginConfig("title",l,r?.title),favicon:getHtmlPluginConfig("favicon",l,r?.favicon),viewport:allowPx2remForModule(n,t)?getHtmlPluginConfig("viewport",l,r?.viewport):"",...i},multiCdn:{env:e,disabled:(r?.excludeCdnEnvs||["me","dev","ntv"]).includes(e)}}))}return m};

package/dist/plugins/stats-webpack/helper-write-stats.d.ts

@@ -0,0 +1,28 @@
+import { Readable } from 'node:stream';
+import { StatsCompilation } from 'webpack';
+/**
+ * A readable stream that serializes a StatsCompilation object into a string representation.
+ */
+export declare class StatsSerializeStream extends Readable {
+    private indentLevel;
+    private stringifier;
+    /**
+     * Creates an instance of StatsSerializeStream.
+     * @param stats - The StatsCompilation object to be serialized.
+     */
+    constructor(stats: StatsCompilation);
+    /**
+     * Gets the indentation string based on the current indent level.
+     */
+    get indent(): string;
+    /**
+     * Implements the _read method required by the Readable stream.
+     */
+    _read(): void;
+    /**
+     * Generator function that recursively converts an object into a string representation.
+     * @param obj - The object to be serialized.
+     */
+    _stringify(obj: StatsCompilation): any;
+}
+export declare const writeStats: (stats: StatsCompilation, filepath: string) => Promise<unknown>;

package/dist/plugins/stats-webpack/helper-write-stats.js

@@ -0,0 +1 @@
+import{createWriteStream}from"node:fs";import{Readable}from"node:stream";export class StatsSerializeStream extends Readable{constructor(e){super(),this.indentLevel=0,this.stringifier=this._stringify(e)}get indent(){return"  ".repeat(this.indentLevel)}_read(){let e=!0;for(;e;){const{value:t,done:i}=this.stringifier.next();i?(this.push(null),e=!1):e=this.push(t)}}*_stringify(e){if("string"==typeof e||"number"==typeof e||"boolean"==typeof e||null===e)yield JSON.stringify(e);else if(Array.isArray(e)){yield"[",this.indentLevel++;let t=!0;for(let i of e)void 0===i&&(i=null),yield`${t?"":","}\n${this.indent}`,yield*this._stringify(i),t=!1;this.indentLevel--,yield e.length?`\n${this.indent}]`:"]"}else{yield"{",this.indentLevel++;let t=!0;const i=Object.entries(e);for(const[e,n]of i)void 0!==n&&(yield`${t?"":","}\n${this.indent}${JSON.stringify(e)}: `,yield*this._stringify(n),t=!1);this.indentLevel--,yield i.length?`\n${this.indent}}`:"}"}}}export const writeStats=(e,t)=>new Promise(((i,n)=>{new StatsSerializeStream(e).on("end",i).on("error",n).pipe(createWriteStream(t))}));

package/dist/plugins/stats-webpack/index.d.ts

@@ -0,0 +1,12 @@
+import { type WebpackPlugin } from '../../create-webpack/types.js';
+import { FlatCliOptions } from '../../types/types-cli-options.js';
+import { type FlatEvolveOptions } from '../../types/types-options.js';
+/**
+ * Creates an array of Webpack plugins for generating stats files.
+ *
+ * @param serveMode - A boolean indicating whether the application is running in serve mode.
+ * @param evolveOptions - The options for the evolve package.
+ * @param cliOptions - The options passed through the command-line interface.
+ * @returns An array of Webpack plugins.
+ */
+export declare const createStatsWebpackPlugin: (serveMode: boolean, evolveOptions: FlatEvolveOptions, cliOptions?: FlatCliOptions) => WebpackPlugin[];

package/dist/plugins/stats-webpack/index.js

@@ -0,0 +1 @@
+import{StatsWebpackPlugin}from"./stats-webpack-plugin.js";export const createStatsWebpackPlugin=(t,e,a={})=>{const{analyzer:r=!1}=a;return t||!r?[]:[new StatsWebpackPlugin({verbose:!0,projectCwd:e.projectCwd})]};

package/dist/plugins/stats-webpack/stats-webpack-plugin.d.ts

@@ -0,0 +1,25 @@
+import { Compiler, Stats, StatsCompilation } from 'webpack';
+export interface Options {
+    /**
+     * The project root.
+     */
+    projectCwd?: string;
+    /**
+     * Write Logs to Console
+     * (Always enabled when dry is true)
+     *
+     * default: false
+     */
+    verbose?: boolean;
+}
+export declare class StatsWebpackPlugin {
+    private readonly verbose;
+    private outputPath;
+    private projectCwd;
+    private statsFilename;
+    constructor(options?: Options);
+    apply(compiler: Compiler): void;
+    handleBeforeClean(): void;
+    handleDone(stats: Stats, callback: (error?: Error) => void): Promise<void>;
+    generateStatsFile(stats: StatsCompilation): Promise<void>;
+}

package/dist/plugins/stats-webpack/stats-webpack-plugin.js

@@ -0,0 +1 @@
+import{rmSync}from"node:fs";import{mkdir}from"node:fs/promises";import{dirname,join,resolve}from"node:path";import{logger}from"@flatjs/common";import{webpackStatsDir}from"../../constants.js";import{getStatsFileName}from"../../helpers/get-stats-file-name.js";import{writeStats}from"./helper-write-stats.js";export class StatsWebpackPlugin{constructor(t={}){this.verbose=!0===t.verbose||!1,this.projectCwd=t.projectCwd||process.cwd(),this.outputPath=join(this.projectCwd,webpackStatsDir)}apply(t){this.handleBeforeClean();t.hooks.done.tapAsync("stats-webpack-plugin",((t,e)=>{this.statsFilename=getStatsFileName(t),this.handleDone(t,e)}))}handleBeforeClean(){rmSync(this.outputPath,{force:!0,recursive:!0})}async handleDone(t,e){try{await this.generateStatsFile(t.toJson()),e()}catch(t){e(t)}}async generateStatsFile(t){const e=resolve(this.outputPath,this.statsFilename);await mkdir(dirname(e),{recursive:!0});try{await writeStats(t,e),this.verbose&&logger.debug(`stats-webpack-plugin: saved stats file to ${e}`)}catch(t){this.verbose&&logger.error(`stats-webpack-plugin: error saving stats file to ${e}: ${t}`)}}}

package/dist/plugins/ts-checker/ts-checker-guard-plugin.d.ts

@@ -0,0 +1,13 @@
+import { type Compiler } from 'webpack';
+export interface TsCheckerGuardPluginOption {
+    /**
+     * Whether to exit the process when issues is not empty
+     * @default false
+     */
+    autoExit?: boolean;
+}
+export declare class TsCheckerGuardPlugin {
+    private options;
+    constructor(option?: TsCheckerGuardPluginOption);
+    apply(compiler: Compiler): void;
+}

package/dist/plugins/ts-checker/ts-checker-guard-plugin.js

@@ -0,0 +1 @@
+import ForkTsCheckerWebpackPlugin from"fork-ts-checker-webpack-plugin";import{mergeOptions}from"@flatjs/common";export class TsCheckerGuardPlugin{constructor(r={}){this.options=mergeOptions({autoExit:!1},r)}apply(r){ForkTsCheckerWebpackPlugin.getCompilerHooks(r).issues.tap("issues",(r=>{const{autoExit:e}=this.options,o=r.filter((r=>"error"===r.severity));if(e&&o?.length>0)throw new Error(`TS_CHECKER_ERROR: \n ${JSON.stringify(o,null,2)}`);return r}))}}

package/dist/plugins/ts-checker/ts-checker-plugin.d.ts

@@ -0,0 +1,3 @@
+import { type WebpackPlugin } from '../../create-webpack/types.js';
+import { type FlatEvolveOptions } from '../../types/types-options.js';
+export declare const createTsCheckerPlugins: (serveMode: boolean, evolveOptions: FlatEvolveOptions) => WebpackPlugin[];

package/dist/plugins/ts-checker/ts-checker-plugin.js

@@ -0,0 +1 @@
+import ForkTsCheckerWebpackPlugin from"fork-ts-checker-webpack-plugin";import{TsCheckerGuardPlugin}from"./ts-checker-guard-plugin.js";export const createTsCheckerPlugins=(e,r)=>{const{entryMap:t,globalCompilerOptions:c}=r,s=[];let n=!1;for(const[,e]of Object.entries(t)){if((e.entry||[]).find((e=>/.vue$/.test(e)))){n=!0;break}}if(c?.runTsChecker&&!n){const t=new ForkTsCheckerWebpackPlugin({async:e,devServer:!1,issue:{},typescript:{context:r.projectCwd,memoryLimit:8192}});s.push(t),s.push(new TsCheckerGuardPlugin({autoExit:!e}))}return s};

package/dist/types/index.d.ts

@@ -1,8 +1,10 @@
+export * from './types-analyzer.js';
 export * from './types-dev-server.js';
 export * from './types-entry-map.js';
 export * from './types-federation.js';
+export * from './types-global-compiler-options.js';
+export * from './types-loader-options.js';
 export * from './types-modular-import.js';
 export * from './types-multi-html.js';
 export * from './types-options.js';
-export * from './types-loader-options.js';
 export * from './types-webpack.js';

package/dist/types/index.js

@@ -1 +1 @@
-export*from"./types-dev-server.js";export*from"./types-entry-map.js";export*from"./types-federation.js";export*from"./types-modular-import.js";export*from"./types-multi-html.js";export*from"./types-options.js";export*from"./types-loader-options.js";export*from"./types-webpack.js";
+export*from"./types-analyzer.js";export*from"./types-dev-server.js";export*from"./types-entry-map.js";export*from"./types-federation.js";export*from"./types-global-compiler-options.js";export*from"./types-loader-options.js";export*from"./types-modular-import.js";export*from"./types-multi-html.js";export*from"./types-options.js";export*from"./types-webpack.js";

package/dist/types/types-analyzer.d.ts

@@ -0,0 +1,70 @@
+import { type StatsCompilation } from 'webpack';
+type ExcludeAssetsPatternFn = (assetName: string) => boolean;
+type ExcludeAssetsPattern = string | RegExp | ExcludeAssetsPatternFn;
+interface AddressInfo {
+    address: string;
+    family: string;
+    port: number;
+}
+/**
+ * Options for serving and analyzing a project.
+ */
+export type AnalyzeServeOptions = {
+    /**
+     * The port number to listen on.
+     * @default 0 (auto-assign a port)
+     */
+    port?: number;
+    /**
+     * The host address to bind to.
+     * @default '127.0.0.1'
+     */
+    host?: string;
+    /**
+     * Whether to automatically open the browser.
+     * @default true
+     */
+    openBrowser?: boolean;
+    /**
+     * The directory where the bundled files are located.
+     */
+    bundleDir?: string;
+    /**
+     * Module sizes to show in the report by default.
+     * Should be one of "parsed", "stat", or "gzip".
+     * @default 'parsed'
+     */
+    defaultSizes?: 'parsed' | 'stat' | 'gzip' | undefined;
+    /**
+     * Patterns that will be used to match against asset names to exclude them from the report.
+     * If the pattern is a string, it will be converted to a regular expression via `new RegExp(str)`.
+     * If the pattern is a function, it should have the following signature: `(assetName: string) => boolean`
+     * and should return true to exclude the matching asset.
+     * If multiple patterns are provided, an asset should match at least one of them to be excluded.
+     * @default null
+     */
+    excludeAssets?: null | ExcludeAssetsPattern | ExcludeAssetsPattern[] | undefined;
+    /**
+     * Content of the HTML title element; or a function of the form `() => string` that provides the content.
+     * @default A function that returns the pretty printed current date and time.
+     */
+    reportTitle?: string | (() => string) | undefined;
+    /**
+     * The URL printed to the console with server mode.
+     * @default 'http://${listenHost}:${boundAddress.port}'
+     */
+    analyzerUrl?: (options: {
+        listenPort: string;
+        listenHost: string;
+        boundAddress: AddressInfo;
+    }) => string;
+};
+export type BundleStatsMapping = {
+    [statsFilename: string]: StatsCompilation;
+};
+export type PromptsOptionValue = {
+    value: string;
+    label: string;
+    hint?: string;
+};
+export {};

package/dist/types/types-analyzer.js

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

package/dist/types/types-cli-options.d.ts

@@ -0,0 +1,12 @@
+export interface FlatCliOptions {
+    /**
+     * Visualize size of webpack output files with an interactive zoomable treemap.
+     *
+     * With build mode `production` only
+     *
+     * This Configuration take effect only during the build phase
+     *
+     * @default false
+     */
+    analyzer?: boolean;
+}

package/dist/types/types-cli-options.js

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

package/dist/types/types-dev-server.d.ts

@@ -1,7 +1,6 @@
-import { type SecureContextHttps, type FlatMockOptions } from '@flatjs/mock';
 import { type RequestHandler } from 'express';
-import { type Configuration } from 'webpack';
-import { type WebSocketURL, type ClientConfiguration } from 'webpack-dev-server';
+import { type ClientConfiguration, Middleware, type WebSocketURL } from 'webpack-dev-server';
+import { type FlatMockOptions, type SecureContextHttps } from '@flatjs/mock';
 import { type EvolveEntryMapContent } from './types-entry-map.js';
 export interface WebpackWatchOptions {
     /**
@@ -13,9 +12,9 @@ export interface WebpackWatchOptions {
      */
     followSymlinks?: boolean;
     /**
-     * Ignore some files from watching (glob pattern or regexp).
+     * Ignore some files from watching
      */
-    ignored?: string | RegExp | string[];
+    ignored?: string[];
     /**
      * Enable polling mode for watching.
      */
@@ -36,7 +35,19 @@ export type FlatEvolveDevServerOptions = {
      * In webpack-dev-server watch mode is enabled by default.
      * This configuration will be merged into `webpack-dev-server`
      */
-    watchOptions?: Configuration['watchOptions'];
+    watchOptions?: WebpackWatchOptions;
+    /**
+     * Provides the ability to execute a custom function and apply custom middleware(s).
+     * https://webpack.js.org/configuration/dev-server/#devserversetupmiddlewares
+     * @default []
+     */
+    devBeforeMiddlewares?: Middleware[];
+    /**
+     * Provides the ability to execute a custom function and apply custom middleware(s).
+     * https://webpack.js.org/configuration/dev-server/#devserversetupmiddlewares
+     * @default []
+     */
+    devAfterMiddlewares?: Middleware[];
     /**
      * Allow us costomized global serve data injected into `window.GLOBAL = {...globalData}`
      */

package/dist/types/types-entry-map.d.ts

@@ -59,8 +59,8 @@ export interface EvolveEntryItemOption extends MultiHtmlCDNEntryItem {
      */
     mockFilters?: Array<string | RegExp>;
     /**
-     * Extends the default `output` configuration for each entry item.
-     * normally we use `output.library` to define the global variable name.
+     * Extends the default `output` configuration for each entry item, normally we use `output.library` to define the global variable name.
+     * Note we don't need to support react fast refresh for library target. because of the library module can not run in the browser individually.
      * @example
      * ```ts
      *'plugin-chart': {
@@ -78,11 +78,29 @@ export interface EvolveEntryItemOption extends MultiHtmlCDNEntryItem {
      * ```
      * @default undefined
      */
-    output?: Configuration['output'];
+    output?: Omit<Required<Configuration>['output'], 'chunkFilename' | 'cssChunkFilename'>;
 }
 export type EvolveEntryMapContent = {
     entry: [string, ...string[]];
     options?: EvolveEntryItemOption;
+    /**
+     * An alias used when grouping builds
+     */
+    groupName?: string;
+    /**
+     * The basis of the grouping, this configuration takes effect when re-entering a group
+     *
+     * If groupingSource is `manual`, The grouping depends on the manually set groupName
+     *
+     * If groupingSource is `auto`, Grouping depends on whether the entry options are the same
+     *
+     * @default 'auto'
+     */
+    groupingSource?: 'auto' | 'manual';
+    /**
+     * The base path of the entry module
+     */
+    entryModuleBase?: string[];
 };
 export interface EvolveEntryMap {
     /**

package/dist/types/types-global-compiler-options.d.ts

@@ -0,0 +1,7 @@
+export interface GlobalCompilerOptions {
+    /**
+     * The value indicates whether runs typescript type checker and linter on separate process.
+     * @default true
+     */
+    runTsChecker?: boolean;
+}

package/dist/types/types-global-compiler-options.js

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

package/dist/types/types-loader-options.d.ts

@@ -1,6 +1,7 @@
+import { type AcceptedPlugin } from 'postcss';
+import { type LoaderContext } from 'webpack';
 import { type TransformOptions } from '@babel/core';
 import { type PostcssPluginPixelOptions } from '@flatjs/forge-postcss-plugin-pixel';
-import { type AcceptedPlugin } from 'postcss';
 import { type ModularImportOption } from './types-modular-import.js';
 export type BabelInputOptions = Pick<TransformOptions, 'presets' | 'plugins'>;
 /**
@@ -14,6 +15,34 @@ export type BuiltinBabelOptions = BabelInputOptions & {
      */
     usePreset?: 'react' | 'vue';
 };
+/**
+ * The configurations for `css-loader` modules
+ * https://github.com/webpack-contrib/css-loader/blob/master/README.md#modules
+ */
+export type CssLoaderModules = boolean | 'local' | 'global' | 'pure' | 'icss' | Partial<{
+    auto: boolean | RegExp | ((resourcePath: string) => boolean);
+    mode: 'local' | 'global' | 'pure' | 'icss' | ((resourcePath: any) => 'local' | 'global' | 'pure' | 'icss');
+    localIdentName: string;
+    localIdentContext: string;
+    localIdentHashSalt: string;
+    localIdentHashFunction: string;
+    localIdentHashDigest: string;
+    localIdentRegExp: string | RegExp;
+    getLocalIdent: (context: LoaderContext<any>, localIdentName: string, localName: string) => string;
+    namedExport: boolean;
+    exportGlobals: boolean;
+    exportLocalsConvention: 'as-is' | 'camel-case' | 'camel-case-only' | 'dashes' | 'dashes-only' | ((name: string) => string);
+    exportOnlyLocals: boolean;
+    getJSON: ({ resourcePath, imports, exports, replacements, }: {
+        resourcePath: string;
+        imports: object[];
+        exports: object[];
+        replacements: object[];
+    }) => Promise<void> | void;
+}>;
+export type CssLoaderOptions = {
+    modules?: CssLoaderModules;
+} & Record<string, unknown>;
 /**
  * The configurations for `builtin` rule set options
  */
@@ -28,9 +57,7 @@ export interface RuleSetLoaderOptions {
      * The configurations of `css-loader`
      * https://github.com/webpack-contrib/css-loader/blob/master/README.md#modules
      */
-    cssLoaderOptions?: {
-        modules?: Record<string, unknown>;
-    } & Record<string, unknown>;
+    cssLoaderOptions?: CssLoaderOptions;
     /**
      * The config for `Less`
      */
@@ -40,11 +67,6 @@ export interface RuleSetLoaderOptions {
      * @default []
      */
     modularImports?: ModularImportOption[];
-    /**
-     * The value indicates whether runs typescript type checker and linter on separate process.
-     * @default true
-     */
-    runTsChecker?: boolean;
     /**
      * The configration options of `postcss-loader`
      */

package/dist/types/types-options.d.ts

@@ -2,9 +2,11 @@ import { type VerifyPackagePattern } from '@armit/package';
 import { type FlatEvolveCI } from './types-ci.js';
 import { type FlatEvolveDevServerOptions } from './types-dev-server.js';
 import { type EvolveEntryMap } from './types-entry-map.js';
+import { type GlobalCompilerOptions } from './types-global-compiler-options.js';
 import { type RuleSetLoaderOptions } from './types-loader-options.js';
-import { type EvolveMultiCDNEnvResolver, type EvolveMultiCDNConfig } from './types-multi-html.js';
+import { type EvolveMultiCDNConfig, type EvolveMultiCDNEnvResolver } from './types-multi-html.js';
 import { type EvolvePluginOptions } from './types-plugin-options.js';
+import { type ThreadsOptions } from './types-threads-options.js';
 import { type FlatEvolveWebpackOptions } from './types-webpack.js';
 /**
  * Detect locally installed dependencies that have correctly installed from `package.json` declared version `dependencies`
@@ -44,6 +46,10 @@ export interface FlatEvolveOptions {
      * The configurations of `webpack`
      */
     webpack?: FlatEvolveWebpackOptions;
+    /**
+     * The config options of global webpack compiler.
+     */
+    globalCompilerOptions?: GlobalCompilerOptions;
     /**
      * The config options of all rule set loaders.
      */
@@ -96,20 +102,9 @@ export interface FlatEvolveOptions {
     /**
      * All webpack entries configuration
      */
-    entryMap: EvolveEntryMap;
-    /**
-     * Visualize size of webpack output files with an interactive zoomable treemap.
-     */
-    analyzer?: Record<string, unknown>;
-    /**
-     * Maximum number of process to run at once for production build
-     * Exact number or a percent of CPUs available (for example "50%").
-     *
-     * If undefined, then all build processes will start in parallel.
-     * Setting this value to 1 will achieve sequential running.
-     * @default 5
-     */
-    maxProcesses?: number | string;
+    entryMap: {
+        [K in keyof EvolveEntryMap]: Omit<EvolveEntryMap[K], 'groupingSource'>;
+    };
     /**
      * For `production` mode, the value indicates if we interrupt compilation process while received "warnings" while evolve `build`
      * @default false
@@ -119,4 +114,24 @@ export interface FlatEvolveOptions {
      * The faster builds, simplified ci pipeline configurations
      */
     ci?: FlatEvolveCI;
+    /**
+     * The configurations of `threads`
+     */
+    threads?: ThreadsOptions;
+    /**
+     * Control whether each entry is built independently.
+     *
+     * If `true`, each entry will be built independently.
+     *
+     * If `false`, each entries are grouped according to certain rules
+     *
+     * @default false
+     */
+    isolation?: boolean;
+    /**
+     * The maximum size of an entry group.
+     *
+     * @default 10
+     */
+    maxEntryGroupSize?: number;
 }

package/dist/types/types-threads-options.d.ts

@@ -0,0 +1,18 @@
+export interface ThreadsOptions {
+    /**
+     * Minimum number of process to run at once for production build
+     *
+     * @default 1
+     */
+    minThreads?: number;
+    /**
+     * Maximum number of process to run at once for production build
+     */
+    maxThreads?: number;
+    /**
+     * Default timeout to wait for close when Thread shuts down, in milliseconds
+     *
+     * @default 60000
+     */
+    idleTimeout?: number;
+}

package/dist/types/types-threads-options.js

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

package/dist/types/types-webpack.d.ts

@@ -1,4 +1,4 @@
-import { type RuleSetRule, type Configuration } from 'webpack';
+import { type Configuration, type RuleSetRule } from 'webpack';
 import { type WebpackPlugin } from '../create-webpack/types.js';
 import { type TerserMinimizerOptions } from '../minimizer/types.js';
 /**
@@ -62,7 +62,10 @@ export interface FlatEvolveWebpackOptions extends Pick<Configuration, 'performan
      * @default `terser` minimizer has been enabled fro `production`
      */
     minimizer?: false | {
-        terserOptions?: TerserMinimizerOptions;
+        /**
+         * Allow to disable terser minimizer. or customized terser options.
+         */
+        terserOptions?: false | TerserMinimizerOptions;
         /**
          * @default false
          */