@modern-js/app-tools 2.5.1-alpha.0 → 2.6.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # @modern-js/app-tools
 
+## 2.6.0
+
+### Patch Changes
+
+- 88f7b34: fix(app-tools): incorrect tools.esbuild config
+
+  fix(app-tools): 修复 tools.esbuild 格式与文档不一致的问题
+
+- e1f799e: fix: use 0.0.0.0 instead of localhost as the default dev host
+  fix: 使用 0.0.0.0 代替 localhost 作为默认的 dev host
+- 7915ab3: fix: should not assign nestedRoutesEntry to entrypoint if use v5 router
+  fix: 使用 v5 路由的时候，不应该在 entrypoint 上挂载 nestedRoutesEntry 属性
+- 08cb975: feat: optimize worker build
+
+  feat: 优化 worker 构建
+
+- Updated dependencies [671477d]
+- Updated dependencies [b92d6db]
+- Updated dependencies [36164a2]
+- Updated dependencies [d638438]
+- Updated dependencies [ba6db6e]
+- Updated dependencies [ba6db6e]
+- Updated dependencies [e1f799e]
+- Updated dependencies [107f674]
+- Updated dependencies [7915ab3]
+- Updated dependencies [03d7f7d]
+- Updated dependencies [1c76d0e]
+- Updated dependencies [fae9d1b]
+- Updated dependencies [49fa0b1]
+- Updated dependencies [0fe658a]
+- Updated dependencies [62930b9]
+  - @modern-js/builder-webpack-provider@2.6.0
+  - @modern-js/builder-shared@2.6.0
+  - @modern-js/prod-server@2.6.0
+  - @modern-js/plugin-data-loader@2.6.0
+  - @modern-js/server@2.6.0
+  - @modern-js/utils@2.6.0
+  - @modern-js/builder@2.6.0
+  - @modern-js/types@2.6.0
+  - @modern-js/builder-rspack-provider@2.6.0
+  - @modern-js/builder-plugin-esbuild@2.6.0
+  - @modern-js/builder-plugin-node-polyfill@2.6.0
+  - @modern-js/core@2.6.0
+  - @modern-js/plugin-i18n@2.6.0
+  - @modern-js/plugin-lint@2.6.0
+  - @modern-js/new-action@2.6.0
+  - @modern-js/node-bundle-require@2.6.0
+  - @modern-js/upgrade@2.6.0
+  - @modern-js/plugin@2.6.0
+
 ## 2.5.0
 
 ### Patch Changes

package/dist/cjs/analyze/generateCode.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/analyze/getBundleEntry.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/analyze/getClientRoutes/getRoutes.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/analyze/getClientRoutes/getRoutesLegacy.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/analyze/getClientRoutes/utils.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/analyze/getFileSystemEntry.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/analyze/getHtmlTemplate.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/analyze/getServerRoutes.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/analyze/index.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));
@@ -219,6 +223,7 @@ var analyze_default = ({
           resolved: config
         };
       },
+      // This logic is not in the router plugin to avoid having to include some dependencies in the utils package
       async modifyEntryImports({ entrypoint, imports }) {
         const appContext = api.useAppContext();
         const { srcDirectory, internalSrcAlias } = appContext;

package/dist/cjs/analyze/isDefaultExportFunction.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/analyze/nestedRoutes.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/analyze/templates.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));
@@ -101,7 +105,7 @@ const html = (partials) => `
 
   <script>
     window.__assetPrefix__ = '<%= assetPrefix %>';
-  <\/script>
+  </script>
   ${partials.head.join("\n")}
 
   <!--<?- chunksMap.css ?>-->

package/dist/cjs/analyze/utils.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/builder/builder-webpack/index.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/builder/builder-webpack/webpackPlugins/RouterPlugin.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/builder/generator/createBuilderProviderConfig.js

@@ -37,6 +37,7 @@ function createBuilderProviderConfig(resolveConfig, appContext, modifyBuilderCon
     html: htmlConfig,
     output: {
       ...resolveConfig.output,
+      // We need to do this in the app-tools prepare hook because some files will be generated into the dist directory in the analyze process
       cleanDistPath: false
     }
   };

package/dist/cjs/builder/generator/index.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/builder/index.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/builder/shared/builderPlugins/adapterModern.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/builder/shared/createCopyPattern.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));
@@ -37,6 +41,9 @@ function createCopyPattern(appContext, config, patternsType, chain) {
   const publicDir = import_path.default.posix.join(configDir.replace(/\\/g, "/"), "public");
   const minifiedJsRexExp = /\.min\.js/;
   const info = (file) => ({
+    // If the file name ends with `.min.js`, we assume it's a compressed file.
+    // So we don't want copy-webpack-plugin to minify it.
+    // ref: https://github.com/webpack-contrib/copy-webpack-plugin#info
     minimized: minifiedJsRexExp.test(file.sourceFilename)
   });
   if (patternsType === "public") {
@@ -49,6 +56,7 @@ function createCopyPattern(appContext, config, patternsType, chain) {
       to: "public",
       context: publicDir,
       noErrorOnMissing: true,
+      // eslint-disable-next-line node/prefer-global/buffer
       transform: (content, absoluteFrom) => {
         if (!/\.html?$/.test(absoluteFrom)) {
           return content;

package/dist/cjs/commands/build.js

@@ -35,6 +35,7 @@ const build = async (api, options) => {
   if (apiOnly) {
     const { appDirectory: appDirectory2, distDirectory: distDirectory2, serverConfigFile: serverConfigFile2 } = appContext;
     await hookRunners.beforeBuild({
+      // "null" bundlerConfigs
       bundlerConfigs: void 0
     });
     await (0, import_config.buildServerConfig)({
@@ -44,6 +45,7 @@ const build = async (api, options) => {
     });
     await (0, import_routes.generateRoutes)(appContext);
     await hookRunners.afterBuild({
+      // "null" stats
       stats: void 0
     });
     return;

package/dist/cjs/commands/dev.js

@@ -21,6 +21,7 @@ __export(dev_exports, {
 });
 module.exports = __toCommonJS(dev_exports);
 var import_core = require("@modern-js/core");
+var import_utils = require("@modern-js/utils");
 var import_printInstructions = require("../utils/printInstructions");
 var import_createServer = require("../utils/createServer");
 var import_routes = require("../utils/routes");
@@ -72,7 +73,7 @@ const dev = async (api, options) => {
       ...serverOptions,
       compiler: null
     });
-    const host = ((_b = normalizedConfig.dev) == null ? void 0 : _b.host) || "localhost";
+    const host = ((_b = normalizedConfig.dev) == null ? void 0 : _b.host) || import_utils.DEFAULT_DEV_HOST;
     app.listen(
       {
         port,

package/dist/cjs/commands/serve.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/config/default.js

@@ -26,6 +26,8 @@ function createDefaultConfig(appContext, bundler) {
   const defaultBuilderConfig = (0, import_builder_webpack_provider.createDefaultConfig)();
   const dev = {
     ...defaultBuilderConfig.dev,
+    // `dev.port` should not have a default value
+    // because we will use `server.port` by default
     port: void 0
   };
   const output = {

package/dist/cjs/config/initialize/inits.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/config/legacy/createOutputConfig.js

@@ -55,6 +55,7 @@ function createOutputConfig(config) {
       css: cssPath,
       js: jsPath,
       html: htmlPath,
+      // modern.js v1 output all media files to `dist/media` by default
       svg: mediaPath || "media",
       image: mediaPath || "media",
       font: mediaPath || "media",
@@ -80,6 +81,7 @@ function createOutputConfig(config) {
     disableFilenameHash: disableAssetsCache,
     enableLatestDecorators,
     ssg,
+    // set `true`, only in legacy config
     enableAssetFallback: true,
     enableAssetManifest: true,
     disableNodePolyfill

package/dist/cjs/index.js

@@ -18,6 +18,10 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 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
 ));
@@ -174,6 +178,7 @@ var src_default = (options = {
         const config = api.useResolvedConfigContext();
         return (0, import_generateWatchFiles.generateWatchFiles)(appContext, config.source.configDir);
       },
+      // 这里会被 core/initWatcher 监听的文件变动触发，如果是 src 目录下的文件变动，则不做 restart
       async fileChange(e) {
         const { filename, eventType } = e;
         const appContext = api.useAppContext();

package/dist/cjs/schema/index.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/utils/config.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/utils/createServer.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/utils/generateWatchFiles.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/cjs/utils/routes.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   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
 ));

package/dist/esm/analyze/index.js

@@ -570,7 +570,8 @@ var analyze_default = function(param) {
                         resolved: config
                     };
                 },
-                modifyEntryImports: function modifyEntryImports(param) {
+                modifyEntryImports: // This logic is not in the router plugin to avoid having to include some dependencies in the utils package
+                function modifyEntryImports(param) {
                     var entrypoint = param.entrypoint, imports = param.imports;
                     return _asyncToGenerator(function() {
                         var appContext, srcDirectory, internalSrcAlias, fileSystemRoutes, nestedRoutesEntry, rootLayoutPath, rootLayoutFile, rootLayoutBuffer, rootLayout, _ref, moduleExports, hasAppConfig, generateLayoutPath, hasAppInit;

package/dist/esm/builder/generator/createBuilderProviderConfig.js

@@ -61,6 +61,7 @@ function createBuilderProviderConfig(resolveConfig, appContext, modifyBuilderCon
         }),
         html: htmlConfig,
         output: _objectSpreadProps(_objectSpread({}, resolveConfig.output), {
+            // We need to do this in the app-tools prepare hook because some files will be generated into the dist directory in the analyze process
             cleanDistPath: false
         })
     });

package/dist/esm/builder/shared/createCopyPattern.js

@@ -7,6 +7,9 @@ function createCopyPattern(appContext, config, patternsType, chain) {
     var minifiedJsRexExp = /\.min\.js/;
     var info = function(file) {
         return {
+            // If the file name ends with `.min.js`, we assume it's a compressed file.
+            // So we don't want copy-webpack-plugin to minify it.
+            // ref: https://github.com/webpack-contrib/copy-webpack-plugin#info
             minimized: minifiedJsRexExp.test(file.sourceFilename)
         };
     };
@@ -20,6 +23,7 @@ function createCopyPattern(appContext, config, patternsType, chain) {
             to: "public",
             context: publicDir,
             noErrorOnMissing: true,
+            // eslint-disable-next-line node/prefer-global/buffer
             transform: function(content, absoluteFrom) {
                 if (!/\.html?$/.test(absoluteFrom)) {
                     return content;

package/dist/esm/commands/build.js

@@ -199,6 +199,7 @@ var build = function() {
                     return [
                         4,
                         hookRunners.beforeBuild({
+                            // "null" bundlerConfigs
                             bundlerConfigs: void 0
                         })
                     ];
@@ -223,6 +224,7 @@ var build = function() {
                     return [
                         4,
                         hookRunners.afterBuild({
+                            // "null" stats
                             stats: void 0
                         })
                     ];

package/dist/esm/commands/dev.js

@@ -175,6 +175,7 @@ var __generator = this && this.__generator || function(thisArg, body) {
     }
 };
 import { ResolvedConfigContext } from "@modern-js/core";
+import { DEFAULT_DEV_HOST } from "@modern-js/utils";
 import { printInstructions } from "../utils/printInstructions";
 import { setServer, createServer, injectDataLoaderPlugin } from "../utils/createServer";
 import { generateRoutes } from "../utils/routes";
@@ -256,7 +257,7 @@ var dev = function() {
                     ];
                 case 5:
                     app = _state.sent();
-                    host = ((_normalizedConfig_dev = normalizedConfig.dev) === null || _normalizedConfig_dev === void 0 ? void 0 : _normalizedConfig_dev.host) || "localhost";
+                    host = ((_normalizedConfig_dev = normalizedConfig.dev) === null || _normalizedConfig_dev === void 0 ? void 0 : _normalizedConfig_dev.host) || DEFAULT_DEV_HOST;
                     app.listen({
                         port: port,
                         host: host

package/dist/esm/config/default.js

@@ -54,6 +54,8 @@ import { createDefaultConfig as createDefaultBuilderConfig } from "@modern-js/bu
 function createDefaultConfig(appContext, bundler) {
     var defaultBuilderConfig = createDefaultBuilderConfig();
     var dev = _objectSpreadProps(_objectSpread({}, defaultBuilderConfig.dev), {
+        // `dev.port` should not have a default value
+        // because we will use `server.port` by default
         port: void 0
     });
     var output = _objectSpreadProps(_objectSpread({}, defaultBuilderConfig.output), {

package/dist/esm/config/legacy/createOutputConfig.js

@@ -8,6 +8,7 @@ function createOutputConfig(config) {
             css: cssPath,
             js: jsPath,
             html: htmlPath,
+            // modern.js v1 output all media files to `dist/media` by default
             svg: mediaPath || "media",
             image: mediaPath || "media",
             font: mediaPath || "media",
@@ -33,6 +34,7 @@ function createOutputConfig(config) {
         disableFilenameHash: disableAssetsCache,
         enableLatestDecorators: enableLatestDecorators,
         ssg: ssg,
+        // set `true`, only in legacy config
         enableAssetFallback: true,
         enableAssetManifest: true,
         disableNodePolyfill: disableNodePolyfill

package/dist/esm/index.js

@@ -653,7 +653,8 @@ var src_default = function() {
                         });
                     })();
                 },
-                fileChange: function fileChange(e) {
+                fileChange: // 这里会被 core/initWatcher 监听的文件变动触发，如果是 src 目录下的文件变动，则不做 restart
+                function fileChange(e) {
                     return _asyncToGenerator(function() {
                         var filename, eventType, appContext, appDirectory, srcDirectory, absolutePath, closeServer;
                         return __generator(this, function(_state) {

package/dist/esm-node/analyze/index.js

@@ -209,6 +209,7 @@ var analyze_default = ({
           resolved: config
         };
       },
+      // This logic is not in the router plugin to avoid having to include some dependencies in the utils package
       async modifyEntryImports({ entrypoint, imports }) {
         const appContext = api.useAppContext();
         const { srcDirectory, internalSrcAlias } = appContext;

package/dist/esm-node/analyze/templates.js

@@ -69,7 +69,7 @@ const html = (partials) => `
 
   <script>
     window.__assetPrefix__ = '<%= assetPrefix %>';
-  <\/script>
+  </script>
   ${partials.head.join("\n")}
 
   <!--<?- chunksMap.css ?>-->