coda-builder 1.0.1 → 1.2.2

package/build/index.js

@@ -1 +1,855 @@
-"use strict";var j=Object.create;var h=Object.defineProperty;var q=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var N=Object.getPrototypeOf,F=Object.prototype.hasOwnProperty;var D=(t,e)=>{for(var i in e)h(t,i,{get:e[i],enumerable:!0})},C=(t,e,i,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of T(e))!F.call(t,s)&&s!==i&&h(t,s,{get:()=>e[s],enumerable:!(o=q(e,s))||o.enumerable});return t};var d=(t,e,i)=>(i=t!=null?j(N(t)):{},C(e||!t||!t.__esModule?h(i,"default",{value:t,enumerable:!0}):i,t)),U=t=>C(h({},"__esModule",{value:!0}),t);var G={};D(G,{resolveWebpackConfig:()=>M});module.exports=U(G);var v=d(require("webpack-node-externals")),O=require("webpack-bundle-analyzer");var w=d(require("path")),z=d(require("os")),S=d(require("webpackbar")),u={js:/\.(ts|js)$/,css:/\.css$/,image:/\.(png|jpg|jpeg|gif|svg)$/,font:/\.(woff|woff2|eot|ttf|otf)$/,media:/\.(mp4|webm|ogg|mp3|wav)$/},y=(t={},e="development")=>{let i=z.default.cpus().length||4;return{name:t.name||"ts-thread",workers:t.workers||(e==="development"?2:Math.max(1,Math.floor((i-2)/2))),workerParallelJobs:t.workerParallelJobs||(e==="development"?40:20),workerNodeArgs:Array.isArray(t.workerNodeArgs)?t.workerNodeArgs:[t.workerNodeArgs||(e==="development"?"--max-old-space-size=512":"--max-old-space-size=256")],poolRespawn:t.poolRespawn??e!=="development",poolTimeout:t.poolTimeout||500,poolParallelJobs:t.poolParallelJobs||(e==="development"?200:100)}},A=(t=!1,e)=>{let i=[];if(e?.thread){let o=y(e.workerOptions,e.mode);i.push({loader:"thread-loader",options:o})}return i.push({loader:"ts-loader",options:{compilerOptions:{declaration:!1,declarationMap:!1}}}),{mode:"none",output:{path:w.default.resolve(__dirname,"dist"),clean:!0},resolve:{extensions:[".ts",".js"],modules:["node_modules"]},module:{rules:[{test:u.js,use:i,exclude:/node_modules/},{test:u.css,use:[t?{loader:require("mini-css-extract-plugin").loader}:"style-loader",{loader:"css-loader",options:{sourceMap:!0,importLoaders:1}},"postcss-loader"]},{test:u.image,type:"asset/resource",generator:{filename:"assets/img/[hash][ext]"}},{test:u.font,type:"asset/resource",generator:{filename:"assets/font/[name][ext]"}},{test:u.media,type:"asset/resource",generator:{filename:"assets/media/[name][ext]"}}]},plugins:[new S.default({name:"coda-builder",color:"#0052cc"})],devServer:{historyApiFallback:!0,port:8080,compress:!1,open:!1,hot:!0,static:{directory:w.default.join(process.cwd(),"dist")}},stats:"minimal"}};var g=class{config;constructor(e){this.config={...e}}setMode(e){return this.config.mode=e,this}setEntry(e){return this.config.entry=e,this}setContext(e){return e!==void 0&&(this.config.context=e),this}setOutput(e){return e?(this.config.output={...this.config.output,...e},this):this}setDevtool(e){return e!==void 0&&(this.config.devtool=e),this}setTarget(e){return e!==void 0&&(this.config.target=e),this}setCache(e){return e!==void 0&&(this.config.cache=e),this}setResolve(e,i){let o=i?.modules,s=i?.mainFields,n=i?.alias,r=i?.extensions,a=i?.extensionAlias;return this.config.resolve={...this.config.resolve,...o?{modules:o}:{},...s?{mainFields:s}:{},...n?{alias:n}:{},...r?{extensions:r}:{},...a?{extensionAlias:a}:{},...e},this}setModule(e,i){let o=this.config.module?.rules||[],s=i?.rules||[],n=i?.noParse;return this.config.module={...this.config.module||{},...n?{noParse:n}:{},rules:[...o,...s],...e},this}setOptimization(e,i,o,s,n,r,a){let l=i;l===void 0&&(s==="web"||s==="chrome-ext")&&(l={chunks:"all",minSize:2e4,maxSize:2e5,minChunks:1,maxAsyncRequests:6,maxInitialRequests:6,cacheGroups:{libs:{name:"chunk-libs",test:/[\\/]node_modules[\\/]/,chunks:"initial",priority:20,reuseExistingChunk:!0},common:{name:"chunk-common",minChunks:2,priority:2,reuseExistingChunk:!0}}});let m=r!==void 0?r:n==="production"||n==="analyzer",p=e?.minimizer||this.config.optimization?.minimizer;if(m&&!p)try{let P=require("terser-webpack-plugin"),E=require("css-minimizer-webpack-plugin"),R=o!==void 0?o:{parse:{ecma:8},compress:{ecma:5,comparisons:!1,inline:2,warnings:!1},mangle:!0,module:!1,output:{ecma:5,comments:!1},toplevel:!1,ie8:!1,safari10:!1},W=a||2;p=[new P({parallel:W,terserOptions:R}),new E({parallel:W})]}catch{}let f=e?.runtimeChunk||this.config.optimization?.runtimeChunk;return l!==void 0&&!f&&(f={name:"manifest"}),this.config.optimization={...this.config.optimization||{},minimize:m,...l!==void 0?{splitChunks:l}:{},...p!==void 0?{minimizer:p}:{},...f!==void 0?{runtimeChunk:f}:{},...e},this}setStats(e){return e!==void 0&&(this.config.stats=e),this}setDevServer(e){if(!e)return this;let i=this.config.devServer||{};return this.config.devServer={...i,...e,...e.static?{static:typeof e.static=="object"&&typeof i.static=="object"?{...i.static,...e.static}:e.static}:{}},this}setWatch(e){return e!==void 0&&(this.config.watch=e),this}setWatchOptions(e){return e?(this.config.watchOptions={...this.config.watchOptions,...e},this):this}setExternals(e){return e!==void 0&&(this.config.externals=e),this}addPlugin(e){return this.config.plugins=this.config.plugins||[],this.config.plugins.push(e),this}addPlugins(e){return!e||!Array.isArray(e)?this:(e.forEach(i=>{i&&this.addPlugin(i)}),this)}setMaxChunks(e){if(e===void 0)return this;let i=require("webpack");return this.addPlugin(new i.optimize.LimitChunkCountPlugin({maxChunks:e})),this}getConfig(){return this.config}setConfig(e){return this.config={...this.config,...e},this}};var c=d(require("fs")),b=d(require("path")),k=class{rules;constructor(e=[]){this.rules=e}apply(e){e.hooks.thisCompilation.tap("CodaCopyWebpackPlugin",i=>{i.hooks.processAssets.tap({name:"CodaCopyWebpackPlugin",stage:e.webpack.Compilation.PROCESS_ASSETS_STAGE_ADDITIONS},()=>{this.rules.forEach(o=>{c.default.existsSync(o.from)&&(o.type==="single"?this.processSingleFile(i,o.from,o.to):o.type==="directory"?this.processDirectory(i,o.from,o.to,o.ignore||[]):o.type==="template"&&this.processTemplate(i,o.from,o.to,o.data))})})})}processSingleFile(e,i,o){let s=c.default.readFileSync(i);e.emitAsset(o,new e.compiler.webpack.sources.RawSource(s))}processDirectory(e,i,o,s){c.default.readdirSync(i,{recursive:!0}).forEach(r=>{let a=b.default.join(i,r);if(c.default.statSync(a).isDirectory())return;let l=b.default.relative(i,a);if(s.some(p=>l.includes(p)))return;let x=b.default.join(o,l).replace(/\\/g,"/"),m=c.default.readFileSync(a);e.emitAsset(x,new e.compiler.webpack.sources.RawSource(m))})}processTemplate(e,i,o,s){let n=c.default.readFileSync(i,"utf-8");Object.keys(s).forEach(r=>{let a=r.replace(/{{\s*|\s*}}/g,""),l=new RegExp(`{{\\s*${a}\\s*}}`,"g");n=n.replace(l,String(s[r]))}),e.emitAsset(o,new e.compiler.webpack.sources.RawSource(Buffer.from(n)))}};function _(t){if(!t.techRoute)throw new Error("[coda-builder] Missing required config: techRoute");if(!t.platformTarget)throw new Error("[coda-builder] Missing required config: platformTarget");if(!t.mode)throw new Error("[coda-builder] Missing required config: mode");if(!t.entry)throw new Error("[coda-builder] Missing required config: entry")}function I(t){let e=t.mode==="production"||t.mode==="analyzer";return A(e,t)}function B(t,e){let{platformTarget:i}=t;["nodejs-cli","node-server","vscode-ext"].includes(i)?(e.setTarget("node"),i==="vscode-ext"?e.setExternals([(0,v.default)(),{vscode:"commonjs vscode"}]):e.setExternals([(0,v.default)()])):i==="chrome-ext"&&e.setTarget("web")}function $(t,e){let i=t.mode==="analyzer"?"production":t.mode;e.setMode(i).setEntry(t.entry).setContext(t.context).setOutput(t.output).setDevtool(t.devtool).setCache(t.cache).setMaxChunks(t.maxChunks).setStats(t.stats).setDevServer(t.devServer).setWatch(t.watch).setWatchOptions(t.watchOptions),e.setOptimization(t.optimization,t.splitChunks,t.terserOptions,t.platformTarget,i,t.minimize,t.parallel),e.setResolve(t.resolve,{alias:t.alias,extensions:t.extensions,extensionAlias:t.extensionAlias,modules:t.modules,mainFields:t.mainFields}),e.setModule(t.module,{noParse:t.noParse,rules:t.rules}),t.target&&e.setTarget(t.target),t.externals&&e.setExternals(t.externals)}function J(t,e){let i=t.mode==="production"||t.mode==="analyzer";if(t.copyRules&&t.copyRules.length>0&&e.addPlugin(new k(t.copyRules)),t.html)try{let o=require("html-webpack-plugin"),s=typeof t.html=="object"?t.html:{};e.addPlugin(new o(s))}catch{throw new Error('[coda-builder] html-webpack-plugin is required when using "html" config. Please install it.')}if(i)try{let o=require("mini-css-extract-plugin");e.addPlugin(new o({filename:"css/[name].[contenthash:8].css",chunkFilename:"css/[name].[contenthash:8].chunk.css"}))}catch{throw new Error("[coda-builder] mini-css-extract-plugin is required in production mode. Please install it.")}if(t.gzip!==!1&&(t.gzip||i))try{let o=require("compression-webpack-plugin"),s={filename:"[path][base].gz",algorithm:"gzip",test:/\.(js|css|png|jpg|jpeg|svg)(\?.*)?$/i,threshold:8192,minRatio:.8,deleteOriginalAssets:!1,exclude:[/node_modules/]},n=typeof t.gzip=="object"?{...s,...t.gzip}:s;e.addPlugin(new o(n))}catch{throw new Error('[coda-builder] compression-webpack-plugin is required when using "gzip" config. Please install it.')}t.plugins&&t.plugins.length>0&&e.addPlugins(t.plugins),t.mode==="analyzer"&&e.addPlugin(new O.BundleAnalyzerPlugin({analyzerMode:"server"}))}function L(t,e){if(t.configureWebpack&&typeof t.configureWebpack=="function"){let i=t.configureWebpack(e,t.mode);if(i)return i}return e}function M(t,e){if(_(t),t.thread&&t.mode==="development")try{let n=require("thread-loader"),r=y(t.workerOptions||{name:"ts-thread",workers:2,workerParallelJobs:40,workerNodeArgs:"--max-old-space-size=512",poolRespawn:!1,poolParallelJobs:200},t.mode);n.warmup({workerBabelArgs:r},["ts-loader"])}catch{}let i=I(t),o=new g(i);o.setConfig({context:process.cwd()}),B(t,o),$(t,o),J(t,o);let s=o.getConfig();if(s=L(t,s),t.speedMeasure&&(t.mode==="development"||t.mode==="analyzer"))try{let n=require("speed-measure-webpack-v5-plugin");s=new n().wrap(s)}catch{throw new Error('[coda-builder] speed-measure-webpack-v5-plugin is required when using "speedMeasure" config. Please install it.')}return e&&(console.log("webpack\u914D\u7F6E:"),console.dir(i,{depth:null})),s}0&&(module.exports={resolveWebpackConfig});
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  resolveWebpackConfig: () => resolveWebpackConfig
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/pipeline.ts
+var import_webpack_node_externals = __toESM(require("webpack-node-externals"));
+var import_webpack_bundle_analyzer = require("webpack-bundle-analyzer");
+
+// src/default.config.ts
+var import_path = __toESM(require("path"));
+var import_os = __toESM(require("os"));
+var import_webpackbar = __toESM(require("webpackbar"));
+var ruleMap = {
+  js: /\.(ts|js)$/,
+  css: /\.css$/,
+  image: /\.(png|jpg|jpeg|gif|svg)$/,
+  font: /\.(woff|woff2|eot|ttf|otf)$/,
+  media: /\.(mp4|webm|ogg|mp3|wav)$/
+};
+var setWorkerOptions = (option = {}, mode = "development") => {
+  const CPULen = import_os.default.cpus().length || 4;
+  return {
+    name: option.name || "ts-thread",
+    workers: option.workers || (mode === "development" ? 2 : Math.max(1, Math.floor((CPULen - 2) / 2))),
+    workerParallelJobs: option.workerParallelJobs || (mode === "development" ? 40 : 20),
+    workerNodeArgs: Array.isArray(option.workerNodeArgs) ? option.workerNodeArgs : [
+      option.workerNodeArgs || (mode === "development" ? "--max-old-space-size=512" : "--max-old-space-size=256")
+    ],
+    poolRespawn: option.poolRespawn ?? (mode === "development" ? false : true),
+    poolTimeout: option.poolTimeout || 500,
+    poolParallelJobs: option.poolParallelJobs || (mode === "development" ? 200 : 100)
+  };
+};
+var getDefaultWebpackConfig = (isProduction = false, userConfig) => {
+  const techRoute = userConfig?.techRoute;
+  const isReact = techRoute === "react";
+  const isVue = techRoute === "vue";
+  const jsTestRule = isReact || isVue ? /\.(ts|tsx|js|jsx)$/ : /\.(ts|js)$/;
+  const defaultExtensions = isReact ? [".tsx", ".ts", ".jsx", ".js"] : isVue ? [".vue", ".tsx", ".ts", ".jsx", ".js"] : [".ts", ".js"];
+  const tsLoaderUse = [];
+  if (userConfig?.thread) {
+    const workerOptions = setWorkerOptions(userConfig.workerOptions, userConfig.mode);
+    tsLoaderUse.push({
+      loader: "thread-loader",
+      options: workerOptions
+    });
+  }
+  const tsLoaderCompilerOptions = {
+    declaration: false,
+    declarationMap: false
+  };
+  if (isReact) {
+    tsLoaderCompilerOptions.jsx = "react-jsx";
+  }
+  tsLoaderUse.push({
+    loader: "ts-loader",
+    options: {
+      //强制关闭 Webpack 打包时生成 .d.ts 声明文件，避免多余的目录嵌套
+      compilerOptions: tsLoaderCompilerOptions
+    }
+  });
+  const rules = [
+    {
+      test: jsTestRule,
+      use: tsLoaderUse,
+      exclude: /node_modules/
+    }
+  ];
+  if (isVue) {
+    let vueLoaderPath = "vue-loader";
+    try {
+      vueLoaderPath = require.resolve("vue-loader", { paths: [process.cwd()] });
+    } catch (e) {
+    }
+    rules.push({
+      test: /\.vue$/,
+      loader: vueLoaderPath
+    });
+  }
+  rules.push(
+    {
+      test: ruleMap.css,
+      use: [
+        // 生产/分析模式下使用 MiniCssExtractPlugin 提取 CSS，开发模式使用 style-loader 注入 DOM
+        isProduction ? {
+          loader: require("mini-css-extract-plugin").loader
+        } : "style-loader",
+        {
+          loader: "css-loader",
+          options: {
+            sourceMap: true,
+            importLoaders: 1
+          }
+        },
+        "postcss-loader"
+      ]
+    },
+    {
+      test: ruleMap.image,
+      type: "asset/resource",
+      generator: {
+        filename: "assets/img/[hash][ext]"
+      }
+    },
+    {
+      test: ruleMap.font,
+      type: "asset/resource",
+      generator: {
+        filename: "assets/font/[name][ext]"
+      }
+    },
+    {
+      test: ruleMap.media,
+      type: "asset/resource",
+      generator: {
+        filename: "assets/media/[name][ext]"
+      }
+    }
+  );
+  return {
+    mode: "none",
+    output: {
+      path: import_path.default.resolve(__dirname, "dist"),
+      clean: true
+    },
+    resolve: {
+      // 限制 extensions 数量以提升编译性能
+      extensions: defaultExtensions,
+      modules: ["node_modules"]
+    },
+    module: {
+      rules
+    },
+    plugins: [
+      new import_webpackbar.default({
+        name: "coda-builder",
+        color: "#0052cc"
+      })
+    ],
+    devServer: {
+      historyApiFallback: true,
+      port: 8080,
+      compress: false,
+      open: false,
+      hot: true,
+      static: {
+        directory: import_path.default.join(process.cwd(), "dist")
+      }
+    },
+    stats: "minimal",
+    devtool: userConfig?.mode === "development" ? "source-map" : "cheap-module-source-map"
+  };
+};
+
+// src/mutator.ts
+var WebpackConfigMutator = class {
+  config;
+  /**
+   * 构造函数
+   * @param {WebpackConfiguration} baseConfig 基础 Webpack 配置对象
+   */
+  constructor(baseConfig) {
+    this.config = { ...baseConfig };
+  }
+  /**
+   * 设置运行模式
+   * @param {WebpackConfiguration['mode']} mode 运行模式 (development | production | none)
+   * @returns {this} 返回当前实例支持链式调用
+   */
+  setMode(mode) {
+    this.config.mode = mode;
+    return this;
+  }
+  /**
+   * 设置脚本入口 entry
+   * @param {WebpackConfiguration['entry']} entry 入口配置
+   * @returns {this} 返回当前实例
+   */
+  setEntry(entry) {
+    this.config.entry = entry;
+    return this;
+  }
+  /**
+   * 设置webpack执行的根目录
+   * @param {WebpackConfiguration['context']} context 执行目录
+   * @returns {this} 返回当前实例
+   */
+  setContext(context) {
+    if (context !== void 0) this.config.context = context;
+    return this;
+  }
+  /**
+   * 设置构建输出 output
+   * @param {WebpackConfiguration['output']} [output] 输出配置选项
+   * @returns {this} 返回当前实例
+   */
+  setOutput(output) {
+    if (!output) return this;
+    this.config.output = {
+      ...this.config.output,
+      ...output
+    };
+    return this;
+  }
+  /**
+   * 设置 source map 生成方式 devtool
+   * @param {WebpackConfiguration['devtool']} [devtool] devtool 属性
+   * @returns {this} 返回当前实例
+   */
+  setDevtool(devtool) {
+    if (devtool !== void 0) this.config.devtool = devtool;
+    return this;
+  }
+  /**
+   * 设置编译目标环境 target
+   * @param {WebpackConfiguration['target']} [target] 目标环境
+   * @returns {this} 返回当前实例
+   */
+  setTarget(target) {
+    if (target !== void 0) this.config.target = target;
+    return this;
+  }
+  /**
+   * 设置缓存配置 cache
+   * @param {WebpackConfiguration['cache']} [cache] 缓存设置
+   * @returns {this} 返回当前实例
+   */
+  setCache(cache) {
+    if (cache !== void 0) this.config.cache = cache;
+    return this;
+  }
+  /**
+   * 设置 Webpack 原生 resolve，同时兼容合并快捷属性 alias/extensions/extensionAlias/modules/mainFields
+   * 规则：Webpack 原生属性优先，快捷属性作为补充兜底
+   */
+  setResolve(resolve, shortcuts) {
+    const resolvedModules = shortcuts?.modules;
+    const resolvedMainFields = shortcuts?.mainFields;
+    const resolvedAlias = shortcuts?.alias;
+    const resolvedExtensions = shortcuts?.extensions;
+    const resolvedExtensionAlias = shortcuts?.extensionAlias;
+    this.config.resolve = {
+      ...this.config.resolve,
+      ...resolvedModules ? { modules: resolvedModules } : {},
+      ...resolvedMainFields ? { mainFields: resolvedMainFields } : {},
+      ...resolvedAlias ? { alias: resolvedAlias } : {},
+      ...resolvedExtensions ? { extensions: resolvedExtensions } : {},
+      ...resolvedExtensionAlias ? { extensionAlias: resolvedExtensionAlias } : {},
+      ...resolve
+      // <--- 原生 resolve 放在最后，确保“以 Webpack 自身属性为主”
+    };
+    return this;
+  }
+  /**
+   * 设置 Webpack 原生 module，同时兼容合并 noParse 与 自定义 rules
+   * 规则：Webpack 原生 module 优先
+   */
+  setModule(moduleConfig, shortcuts) {
+    const defaultRules = this.config.module?.rules || [];
+    const shortcutRules = shortcuts?.rules || [];
+    const shortcutNoParse = shortcuts?.noParse;
+    this.config.module = {
+      ...this.config.module || {},
+      ...shortcutNoParse ? { noParse: shortcutNoParse } : {},
+      // 用户自定义 rules 应当排在默认 rules 前面，确保用户规则优先匹配
+      rules: [...shortcutRules, ...defaultRules],
+      ...moduleConfig
+      // <--- 原生 module 放在最后，确保“以 Webpack 自身属性为主”
+    };
+    return this;
+  }
+  /**
+   * 设置代码优化配置 optimization（集成 splitChunks 智能平台适配、JS/CSS 双重压缩与 runtimeChunk 映射）
+   * 规则：Webpack 原生 optimization 优先，其次是快捷属性，最后是平台智能兜底
+   */
+  setOptimization(optimization, shortcutSplitChunks, shortcutTerserOptions, techRoute, mode, minimize, parallel) {
+    let finalSplitChunks = shortcutSplitChunks;
+    if (finalSplitChunks === void 0) {
+      if (techRoute && ["sdk", "react", "vue", "chrome-ext"].includes(techRoute)) {
+        finalSplitChunks = {
+          chunks: "all",
+          minSize: 2e4,
+          maxSize: 2e5,
+          minChunks: 1,
+          maxAsyncRequests: 6,
+          maxInitialRequests: 6,
+          cacheGroups: {
+            libs: {
+              name: "chunk-libs",
+              test: /[\\/]node_modules[\\/]/,
+              chunks: "initial",
+              priority: 20,
+              reuseExistingChunk: true
+            },
+            common: {
+              name: "chunk-common",
+              minChunks: 2,
+              priority: 2,
+              reuseExistingChunk: true
+            }
+          }
+        };
+      }
+    }
+    const isProdOrAnalyzer = mode === "production" || mode === "analyzer";
+    const shouldMinimize = minimize !== void 0 ? minimize : isProdOrAnalyzer;
+    let minimizer = optimization?.minimizer || this.config.optimization?.minimizer;
+    if (shouldMinimize && !minimizer) {
+      try {
+        const TerserPlugin = require("terser-webpack-plugin");
+        const CssMinimizerPlugin = require("css-minimizer-webpack-plugin");
+        const defaultTerserOptions = {
+          parse: { ecma: 8 },
+          compress: {
+            ecma: 5,
+            comparisons: false,
+            inline: 2,
+            warnings: false
+          },
+          mangle: true,
+          module: false,
+          output: {
+            ecma: 5,
+            comments: false
+          },
+          toplevel: false,
+          ie8: false,
+          safari10: false
+        };
+        const finalTerserOptions = shortcutTerserOptions !== void 0 ? shortcutTerserOptions : defaultTerserOptions;
+        const cpuParallel = parallel || 2;
+        minimizer = [
+          new TerserPlugin({
+            parallel: cpuParallel,
+            terserOptions: finalTerserOptions
+          }),
+          new CssMinimizerPlugin({
+            parallel: cpuParallel
+          })
+        ];
+      } catch (e) {
+      }
+    }
+    let runtimeChunk = optimization?.runtimeChunk || this.config.optimization?.runtimeChunk;
+    if (finalSplitChunks !== void 0 && !runtimeChunk) {
+      runtimeChunk = { name: "manifest" };
+    }
+    this.config.optimization = {
+      ...this.config.optimization || {},
+      minimize: shouldMinimize,
+      ...finalSplitChunks !== void 0 ? { splitChunks: finalSplitChunks } : {},
+      ...minimizer !== void 0 ? { minimizer } : {},
+      ...runtimeChunk !== void 0 ? { runtimeChunk } : {},
+      ...optimization
+      // <--- 原生 optimization 放在最后，确保“以 Webpack 自身属性为主”
+    };
+    return this;
+  }
+  /**
+   * 设置构建日志输出控制 stats
+   * @param {WebpackConfiguration['stats']} [stats] 日志输出控制配置
+   * @returns {this} 返回当前实例支持链式调用
+   */
+  setStats(stats) {
+    if (stats !== void 0) this.config.stats = stats;
+    return this;
+  }
+  /**
+   * 设置Dev Server（支持深度合并嵌套对象如 static）
+   * @param  {DevServerConfiguration} [devServer] devServer 配置
+   * @returns {this} 返回当前实例支持链式调用
+   */
+  setDevServer(devServer) {
+    if (!devServer) return this;
+    const existingDevServer = this.config.devServer || {};
+    this.config.devServer = {
+      ...existingDevServer,
+      ...devServer,
+      // 精准深度合并 static 配置对象，防止外部覆盖时丢失默认目录
+      ...devServer.static ? {
+        static: typeof devServer.static === "object" && typeof existingDevServer.static === "object" ? {
+          ...existingDevServer.static,
+          ...devServer.static
+        } : devServer.static
+      } : {}
+    };
+    return this;
+  }
+  /**
+   * 设置监听文件变化
+   * @param  {WebpackConfiguration[watch]} [watch] 监听文件变化
+   * @returns {this} 返回当前实例支持链式调用
+   */
+  setWatch(watch) {
+    if (watch !== void 0) this.config.watch = watch;
+    return this;
+  }
+  /**
+   * 设置监听项
+   * @param  {WebpackConfiguration[watch]} [watchOptions] 监听项
+   * @returns {this} 返回当前实例支持链式调用
+   */
+  setWatchOptions(watchOptions) {
+    if (!watchOptions) return this;
+    this.config.watchOptions = {
+      ...this.config.watchOptions,
+      ...watchOptions
+    };
+    return this;
+  }
+  /**
+   * 设置外部依赖处理 externals
+   * @param {WebpackConfiguration['externals']} [externals] 外部依赖项
+   * @returns {this} 返回当前实例
+   */
+  setExternals(externals) {
+    if (externals !== void 0) {
+      this.config.externals = externals;
+    }
+    return this;
+  }
+  /**
+   * 添加 Webpack 插件
+   * @param {WebpackPluginInstance} plugin 插件实例
+   * @returns {this} 返回当前实例
+   */
+  addPlugin(plugin) {
+    this.config.plugins = this.config.plugins || [];
+    this.config.plugins.push(plugin);
+    return this;
+  }
+  /**
+   * 批量添加自定义插件
+   * @param {NonNullable<WebpackConfiguration['plugins']>} [plugins] 插件数组
+   * @returns {this} 返回当前实例支持链式调用
+   */
+  addPlugins(plugins) {
+    if (!plugins || !Array.isArray(plugins)) return this;
+    plugins.forEach((plugin) => {
+      if (plugin) {
+        this.addPlugin(plugin);
+      }
+    });
+    return this;
+  }
+  /**
+   * 限制每个入口生成的最大 Chunk 数
+   * @param {number} [maxChunks] 最大 Chunk 数量
+   * @returns {this} 返回当前实例
+   */
+  setMaxChunks(maxChunks) {
+    if (maxChunks === void 0) return this;
+    const webpack = require("webpack");
+    this.addPlugin(
+      new webpack.optimize.LimitChunkCountPlugin({
+        maxChunks
+      })
+    );
+    return this;
+  }
+  /**
+   * 获取最终组装好的 Webpack 配置对象
+   * @returns {WebpackConfiguration} 完整的 Webpack 配置
+   */
+  getConfig() {
+    return this.config;
+  }
+  /**
+   * 批量或直接合并设置 Webpack 原始配置对象属性
+   * @param {Partial<WebpackConfiguration>} partialConfig 部分配置对象
+   * @returns {this} 返回当前实例
+   */
+  setConfig(partialConfig) {
+    this.config = {
+      ...this.config,
+      ...partialConfig
+    };
+    return this;
+  }
+};
+
+// src/webpack.copy.plugin.ts
+var import_fs = __toESM(require("fs"));
+var import_path2 = __toESM(require("path"));
+var CodaCopyWebpackPlugin = class {
+  rules;
+  /**
+   * 构造函数
+   * @param {CopyRuleItem[]} [rules=[]] 复制规则数组
+   */
+  constructor(rules = []) {
+    this.rules = rules;
+  }
+  /**
+   * Webpack 插件应用入口
+   * @param {Compiler} compiler Webpack 编译器实例
+   */
+  apply(compiler) {
+    compiler.hooks.thisCompilation.tap("CodaCopyWebpackPlugin", (compilation) => {
+      compilation.hooks.processAssets.tap(
+        {
+          name: "CodaCopyWebpackPlugin",
+          stage: compiler.webpack.Compilation.PROCESS_ASSETS_STAGE_ADDITIONS
+        },
+        () => {
+          this.rules.forEach((rule) => {
+            if (!import_fs.default.existsSync(rule.from)) return;
+            if (rule.type === "single") {
+              this.processSingleFile(compilation, rule.from, rule.to);
+            } else if (rule.type === "directory") {
+              this.processDirectory(compilation, rule.from, rule.to, rule.ignore || []);
+            } else if (rule.type === "template") {
+              this.processTemplate(compilation, rule.from, rule.to, rule.data);
+            }
+          });
+        }
+      );
+    });
+  }
+  /**
+   * 处理单文件复制规则
+   * @private
+   * @param {Compilation} compilation Webpack 编译对象
+   * @param {string} from 源文件绝对路径
+   * @param {string} to 目标输出相对路径
+   */
+  processSingleFile(compilation, from, to) {
+    const content = import_fs.default.readFileSync(from);
+    compilation.emitAsset(to, new compilation.compiler.webpack.sources.RawSource(content));
+  }
+  /**
+   * 处理目录递归复制规则
+   * @private
+   * @param {Compilation} compilation Webpack 编译对象
+   * @param {string} srcDir 源目录路径
+   * @param {string} destDir 目标输出目录路径
+   * @param {string[]} ignore 忽略匹配模式数组
+   */
+  processDirectory(compilation, srcDir, destDir, ignore) {
+    const files = import_fs.default.readdirSync(srcDir, { recursive: true });
+    files.forEach((file) => {
+      const srcPath = import_path2.default.join(srcDir, file);
+      if (import_fs.default.statSync(srcPath).isDirectory()) return;
+      const relativePath = import_path2.default.relative(srcDir, srcPath);
+      if (ignore.some((pattern) => relativePath.includes(pattern))) return;
+      const targetPath = import_path2.default.join(destDir, relativePath).replace(/\\/g, "/");
+      const content = import_fs.default.readFileSync(srcPath);
+      compilation.emitAsset(
+        targetPath,
+        new compilation.compiler.webpack.sources.RawSource(content)
+      );
+    });
+  }
+  /**
+   * 处理模板文件占位符替换规则
+   * @private
+   * @param {Compilation} compilation Webpack 编译对象
+   * @param {string} from 模板文件源路径
+   * @param {string} to 目标输出路径
+   * @param {Record<string, string | number>} data 占位符键值对数据
+   */
+  processTemplate(compilation, from, to, data) {
+    let content = import_fs.default.readFileSync(from, "utf-8");
+    Object.keys(data).forEach((rawKey) => {
+      const cleanKey = rawKey.replace(/{{\s*|\s*}}/g, "");
+      const escapedKey = cleanKey.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      const reg = new RegExp(`{{\\s*${escapedKey}\\s*}}`, "g");
+      content = content.replace(reg, String(data[rawKey]));
+    });
+    compilation.emitAsset(
+      to,
+      new compilation.compiler.webpack.sources.RawSource(Buffer.from(content))
+    );
+  }
+};
+
+// src/pipeline.ts
+function stageValidate(userConfig) {
+  if (!userConfig.techRoute) throw new Error("[coda-builder] Missing required config: techRoute");
+  if (!userConfig.mode) throw new Error("[coda-builder] Missing required config: mode");
+  if (!userConfig.entry) throw new Error("[coda-builder] Missing required config: entry");
+  try {
+    const webpack = require("webpack");
+    const version = webpack.version || "0.0.0";
+    const [major, minor] = version.split(".").map(Number);
+    if (major < 5 || major === 5 && minor < 91) {
+      throw new Error(
+        `[coda-builder] Webpack version 5.91.0 or higher is required, but detected v${version}. Please upgrade your project's webpack.`
+      );
+    }
+  } catch (e) {
+    if (e.message && e.message.includes("[coda-builder]")) throw e;
+    throw new Error(
+      "[coda-builder] Failed to detect webpack version. Please ensure webpack is installed."
+    );
+  }
+}
+function stageGetBaseConfig(userConfig) {
+  const isProduction = userConfig.mode === "production" || userConfig.mode === "analyzer";
+  return getDefaultWebpackConfig(isProduction, userConfig);
+}
+function stageSetPlatformParam(userConfig, mutator) {
+  const { techRoute } = userConfig;
+  if (["node-server", "node-cli", "vscode-ext"].includes(techRoute)) {
+    mutator.setTarget("node");
+    if (techRoute === "vscode-ext") {
+      mutator.setExternals([(0, import_webpack_node_externals.default)(), { vscode: "commonjs vscode" }]);
+    } else {
+      mutator.setExternals([(0, import_webpack_node_externals.default)()]);
+    }
+  } else if (["sdk", "react", "vue", "chrome-ext"].includes(techRoute)) {
+    mutator.setTarget("web");
+  }
+}
+function stageSetFeatures(userConfig, mutator) {
+  const webpackMode = userConfig.mode === "analyzer" ? "production" : userConfig.mode;
+  mutator.setMode(webpackMode).setEntry(userConfig.entry).setContext(userConfig.context).setOutput(userConfig.output).setDevtool(userConfig.devtool).setCache(userConfig.cache).setMaxChunks(userConfig.maxChunks).setStats(userConfig.stats).setDevServer(userConfig.devServer).setWatch(userConfig.watch).setWatchOptions(userConfig.watchOptions);
+  mutator.setOptimization(
+    userConfig.optimization,
+    userConfig.splitChunks,
+    userConfig.terserOptions,
+    userConfig.techRoute,
+    webpackMode,
+    userConfig.minimize,
+    userConfig.parallel
+  );
+  mutator.setResolve(userConfig.resolve, {
+    alias: userConfig.alias,
+    extensions: userConfig.extensions,
+    extensionAlias: userConfig.extensionAlias,
+    modules: userConfig.modules,
+    mainFields: userConfig.mainFields
+  });
+  mutator.setModule(userConfig.module, {
+    noParse: userConfig.noParse,
+    rules: userConfig.rules
+  });
+  if (userConfig.target) {
+    mutator.setTarget(userConfig.target);
+  }
+  if (userConfig.externals) {
+    mutator.setExternals(userConfig.externals);
+  }
+}
+function stageSetPlugins(userConfig, mutator) {
+  const isProductionOrAnalyzer = userConfig.mode === "production" || userConfig.mode === "analyzer";
+  if (userConfig.copyRules && userConfig.copyRules.length > 0) {
+    mutator.addPlugin(new CodaCopyWebpackPlugin(userConfig.copyRules));
+  }
+  if (userConfig.html) {
+    try {
+      const HtmlWebpackPlugin = require("html-webpack-plugin");
+      const htmlOptions = typeof userConfig.html === "object" ? userConfig.html : {};
+      mutator.addPlugin(new HtmlWebpackPlugin(htmlOptions));
+    } catch (e) {
+      throw new Error(
+        '[coda-builder] html-webpack-plugin is required when using "html" config. Please install it.'
+      );
+    }
+  }
+  if (isProductionOrAnalyzer) {
+    try {
+      const MiniCssExtractPlugin = require("mini-css-extract-plugin");
+      mutator.addPlugin(
+        new MiniCssExtractPlugin({
+          filename: "css/[name].[contenthash:8].css",
+          chunkFilename: "css/[name].[contenthash:8].chunk.css"
+        })
+      );
+    } catch (e) {
+      throw new Error(
+        "[coda-builder] mini-css-extract-plugin is required in production mode. Please install it."
+      );
+    }
+  }
+  if (userConfig.techRoute === "vue") {
+    try {
+      const fs2 = require("fs");
+      const path3 = require("path");
+      const pkgPath = path3.resolve(process.cwd(), "package.json");
+      let isVue2 = false;
+      if (fs2.existsSync(pkgPath)) {
+        const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf-8"));
+        const vueVersion = pkg.dependencies?.vue || pkg.devDependencies?.vue || "3.0.0";
+        isVue2 = typeof vueVersion === "string" && (vueVersion.startsWith("2") || vueVersion.includes("^2"));
+      }
+      const paths = [process.cwd()];
+      const vueLoader = require(require.resolve("vue-loader", { paths }));
+      let vueLoaderPluginInstance;
+      if (isVue2) {
+        const VueLoaderPlugin = require(require.resolve("vue-loader/lib/plugin", { paths }));
+        vueLoaderPluginInstance = new VueLoaderPlugin();
+      } else {
+        const VueLoaderPlugin = vueLoader.VueLoaderPlugin || vueLoader.default?.VueLoaderPlugin;
+        vueLoaderPluginInstance = new VueLoaderPlugin();
+      }
+      mutator.addPlugin(vueLoaderPluginInstance);
+    } catch (e) {
+      throw new Error(
+        `[coda-builder] vue-loader is required when using techRoute: "vue". Please ensure "vue" and "vue-loader" are installed in your project. Details: ${e.message}`
+      );
+    }
+  }
+  if (userConfig.gzip !== false && (userConfig.gzip || isProductionOrAnalyzer)) {
+    try {
+      const CompressionPlugin = require("compression-webpack-plugin");
+      const defaultGzipOptions = {
+        filename: "[path][base].gz",
+        algorithm: "gzip",
+        test: /\.(js|css|png|jpg|jpeg|svg)(\?.*)?$/i,
+        threshold: 8192,
+        minRatio: 0.8,
+        deleteOriginalAssets: false,
+        exclude: [/node_modules/]
+      };
+      const gzipOptions = typeof userConfig.gzip === "object" ? { ...defaultGzipOptions, ...userConfig.gzip } : defaultGzipOptions;
+      mutator.addPlugin(new CompressionPlugin(gzipOptions));
+    } catch (e) {
+      throw new Error(
+        '[coda-builder] compression-webpack-plugin is required when using "gzip" config. Please install it.'
+      );
+    }
+  }
+  if (userConfig.plugins && userConfig.plugins.length > 0) {
+    mutator.addPlugins(userConfig.plugins);
+  }
+  if (userConfig.mode === "analyzer") {
+    mutator.addPlugin(new import_webpack_bundle_analyzer.BundleAnalyzerPlugin({ analyzerMode: "server" }));
+  }
+  if (userConfig.techRoute === "node-cli") {
+    try {
+      const fs2 = require("fs");
+      const path3 = require("path");
+      const webpack = require("webpack");
+      const pkgPath = path3.resolve(process.cwd(), "package.json");
+      if (fs2.existsSync(pkgPath)) {
+        const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf-8"));
+        if (pkg.bin) {
+          let binPaths = [];
+          if (typeof pkg.bin === "string") {
+            binPaths = [pkg.bin];
+          } else if (typeof pkg.bin === "object" && pkg.bin !== null) {
+            binPaths = Object.values(pkg.bin);
+          }
+          binPaths.forEach((binPath) => {
+            const cleanPath = binPath.replace(/^\.\//, "");
+            const parts = cleanPath.split("/");
+            const fileName = parts.pop() || "index.js";
+            const targetRegex = new RegExp(`(^|[\\\\/])${fileName}$`);
+            mutator.addPlugin(
+              new webpack.BannerPlugin({
+                banner: "#!/usr/bin/env node",
+                raw: true,
+                // 作为原始文本置顶插入，不加注释符
+                test: targetRegex
+                // 精准匹配，绝不误伤其他子模块
+              })
+            );
+          });
+        }
+      }
+    } catch (e) {
+    }
+  }
+}
+function stageSetHooks(userConfig, config) {
+  if (userConfig.configureWebpack && typeof userConfig.configureWebpack === "function") {
+    const result = userConfig.configureWebpack(config, userConfig.mode);
+    return result || config;
+  }
+  return config;
+}
+function resolveWebpackConfig(userConfig, isLogger) {
+  stageValidate(userConfig);
+  if (userConfig.thread && userConfig.mode === "development") {
+    try {
+      const threadLoader = require("thread-loader");
+      const workerOptions = setWorkerOptions(
+        userConfig.workerOptions || {
+          name: "ts-thread",
+          workers: 2,
+          workerParallelJobs: 40,
+          workerNodeArgs: "--max-old-space-size=512",
+          poolRespawn: false,
+          poolParallelJobs: 200
+        },
+        userConfig.mode
+      );
+      threadLoader.warmup(workerOptions, ["ts-loader"]);
+    } catch (e) {
+    }
+  }
+  const baseConfig = stageGetBaseConfig(userConfig);
+  const mutator = new WebpackConfigMutator(baseConfig);
+  mutator.setConfig({
+    context: process.cwd()
+  });
+  stageSetPlatformParam(userConfig, mutator);
+  stageSetFeatures(userConfig, mutator);
+  stageSetPlugins(userConfig, mutator);
+  let finalConfig = mutator.getConfig();
+  finalConfig = stageSetHooks(userConfig, finalConfig);
+  if (userConfig.speedMeasure && (userConfig.mode === "development" || userConfig.mode === "analyzer")) {
+    try {
+      const SpeedMeasurePlugin = require("speed-measure-webpack-v5-plugin");
+      const smp = new SpeedMeasurePlugin();
+      finalConfig = smp.wrap(finalConfig);
+    } catch (e) {
+      throw new Error(
+        '[coda-builder] speed-measure-webpack-v5-plugin is required when using "speedMeasure" config. Please install it.'
+      );
+    }
+  }
+  if (isLogger) {
+    console.log("webpack\u914D\u7F6E:");
+    console.dir(baseConfig, { depth: null });
+  }
+  return finalConfig;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  resolveWebpackConfig
+});