@modern-js/utils 2.27.0 → 2.28.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @modern-js/utils
 
+## 2.28.0
+
+### Patch Changes
+
+- 00b58a7: feat(builder): add an error tip for source.include
+
+  feat(builder): 增加 source.include 常见问题的提示日志
+
 ## 2.27.0
 
 ### Patch Changes

package/dist/cjs/cli/alias.js

@@ -46,7 +46,7 @@ const validAlias = (modernConfig, { tsconfigPath }) => {
 };
 const mergeAlias = (alias) => (0, _applyOptionsChain.applyOptionsChain)({}, alias);
 const getAliasConfig = (aliasOption, option) => {
-  var _tsconfig_compilerOptions, _tsconfig_compilerOptions1;
+  var _tsconfig_compilerOptions, _tsconfig, _tsconfig_compilerOptions1, _tsconfig1;
   const isTsProject = _fs.default.existsSync(option.tsconfigPath);
   const alias = mergeAlias(aliasOption);
   if (!isTsProject) {
@@ -58,12 +58,12 @@ const getAliasConfig = (aliasOption, option) => {
     };
   }
   const tsconfig = (0, _get.readTsConfigByFile)(option.tsconfigPath);
-  const baseUrl = tsconfig === null || tsconfig === void 0 ? void 0 : (_tsconfig_compilerOptions = tsconfig.compilerOptions) === null || _tsconfig_compilerOptions === void 0 ? void 0 : _tsconfig_compilerOptions.baseUrl;
+  const baseUrl = (_tsconfig = tsconfig) === null || _tsconfig === void 0 ? void 0 : (_tsconfig_compilerOptions = _tsconfig.compilerOptions) === null || _tsconfig_compilerOptions === void 0 ? void 0 : _tsconfig_compilerOptions.baseUrl;
   return {
     absoluteBaseUrl: baseUrl ? _path.default.join(option.appDirectory, baseUrl) : option.appDirectory,
     paths: {
       ...alias,
-      ...tsconfig === null || tsconfig === void 0 ? void 0 : (_tsconfig_compilerOptions1 = tsconfig.compilerOptions) === null || _tsconfig_compilerOptions1 === void 0 ? void 0 : _tsconfig_compilerOptions1.paths
+      ...(_tsconfig1 = tsconfig) === null || _tsconfig1 === void 0 ? void 0 : (_tsconfig_compilerOptions1 = _tsconfig1.compilerOptions) === null || _tsconfig_compilerOptions1 === void 0 ? void 0 : _tsconfig_compilerOptions1.paths
     },
     isTsPath: true,
     isTsProject

package/dist/cjs/cli/constants/chainId.js

@@ -47,6 +47,8 @@ const CHAIN_ID = {
     YAML: "yaml",
     /** Rule for wasm */
     WASM: "wasm",
+    /** Rule for node */
+    NODE: "node",
     /** Rule for bff */
     JS_BFF_API: "js-bff-api"
   },
@@ -85,6 +87,8 @@ const CHAIN_ID = {
     TOML: "toml",
     /** html-loader */
     HTML: "html",
+    /** node-loader */
+    NODE: "html",
     /** babel-loader */
     BABEL: "babel",
     /** esbuild-loader */

package/dist/cjs/cli/constants/index.js

@@ -149,7 +149,6 @@ const INTERNAL_APP_TOOLS_RUNTIME_PLUGINS = {
 };
 const INTERNAL_MODULE_TOOLS_PLUGINS = {
   "@modern-js/module-tools": "@modern-js/module-tools",
-  "@modern-js/doc-tools": "@modern-js/doc-tools",
   "@modern-js/runtime": "@modern-js/runtime/cli",
   "@modern-js/plugin-testing": "@modern-js/plugin-testing/cli",
   "@modern-js/plugin-storybook": "@modern-js/plugin-storybook/cli",

package/dist/cjs/cli/is/config.js

@@ -31,11 +31,12 @@ _export(exports, {
 });
 const _type = require("./type");
 const isSSR = (config) => {
+  var _server, _server1;
   const { server } = config;
-  if (server === null || server === void 0 ? void 0 : server.ssr) {
+  if ((_server = server) === null || _server === void 0 ? void 0 : _server.ssr) {
     return true;
   }
-  if ((server === null || server === void 0 ? void 0 : server.ssrByEntries) && !(0, _type.isEmpty)(server.ssrByEntries)) {
+  if (((_server1 = server) === null || _server1 === void 0 ? void 0 : _server1.ssrByEntries) && !(0, _type.isEmpty)(server.ssrByEntries)) {
     for (const name of Object.keys(server.ssrByEntries)) {
       if (server.ssrByEntries[name]) {
         return true;
@@ -45,27 +46,29 @@ const isSSR = (config) => {
   return false;
 };
 const isUseSSRBundle = (config) => {
+  var _output;
   const { output } = config;
-  if (output === null || output === void 0 ? void 0 : output.ssg) {
+  if ((_output = output) === null || _output === void 0 ? void 0 : _output.ssg) {
     return true;
   }
   return isSSR(config);
 };
 const isServiceWorker = (config) => {
-  var _deploy_worker;
+  var _deploy_worker, _deploy, _output;
   const { output, deploy } = config;
-  if ((deploy === null || deploy === void 0 ? void 0 : (_deploy_worker = deploy.worker) === null || _deploy_worker === void 0 ? void 0 : _deploy_worker.ssr) && ((output === null || output === void 0 ? void 0 : output.ssg) || isSSR(config))) {
+  if (((_deploy = deploy) === null || _deploy === void 0 ? void 0 : (_deploy_worker = _deploy.worker) === null || _deploy_worker === void 0 ? void 0 : _deploy_worker.ssr) && (((_output = output) === null || _output === void 0 ? void 0 : _output.ssg) || isSSR(config))) {
     return true;
   }
   return false;
 };
 const isRouterV5 = (config) => {
-  var _config_runtime, _config_runtime1, _config_runtime_router;
-  return typeof ((_config_runtime = config.runtime) === null || _config_runtime === void 0 ? void 0 : _config_runtime.router) !== "boolean" && (config === null || config === void 0 ? void 0 : (_config_runtime1 = config.runtime) === null || _config_runtime1 === void 0 ? void 0 : (_config_runtime_router = _config_runtime1.router) === null || _config_runtime_router === void 0 ? void 0 : _config_runtime_router.mode) === "react-router-5";
+  var _config_runtime, _config_runtime_router, _config_runtime1, _config;
+  return typeof ((_config_runtime = config.runtime) === null || _config_runtime === void 0 ? void 0 : _config_runtime.router) !== "boolean" && ((_config = config) === null || _config === void 0 ? void 0 : (_config_runtime1 = _config.runtime) === null || _config_runtime1 === void 0 ? void 0 : (_config_runtime_router = _config_runtime1.router) === null || _config_runtime_router === void 0 ? void 0 : _config_runtime_router.mode) === "react-router-5";
 };
 const isSSGEntry = (config, entryName, entrypoints) => {
+  var _ssgConfig, _ssgConfig1;
   const ssgConfig = config.output.ssg;
-  const useSSG = isSingleEntry(entrypoints) ? Boolean(ssgConfig) : ssgConfig === true || typeof (ssgConfig === null || ssgConfig === void 0 ? void 0 : ssgConfig[0]) === "function" || Boolean(ssgConfig === null || ssgConfig === void 0 ? void 0 : ssgConfig[entryName]);
+  const useSSG = isSingleEntry(entrypoints) ? Boolean(ssgConfig) : ssgConfig === true || typeof ((_ssgConfig = ssgConfig) === null || _ssgConfig === void 0 ? void 0 : _ssgConfig[0]) === "function" || Boolean((_ssgConfig1 = ssgConfig) === null || _ssgConfig1 === void 0 ? void 0 : _ssgConfig1[entryName]);
   return useSSG;
 };
 const isSingleEntry = (entrypoints) => entrypoints.length === 1 && entrypoints[0].entryName === "main";

package/dist/cjs/cli/prettyInstructions.js

@@ -40,7 +40,8 @@ const getAddressUrls = (protocol = "http", port, host) => {
   const LOCAL_LABEL = "Local:  ";
   const NETWORK_LABEL = "Network:  ";
   const isLocalhost = (url) => {
-    return url === null || url === void 0 ? void 0 : url.includes("localhost");
+    var _url;
+    return (_url = url) === null || _url === void 0 ? void 0 : _url.includes("localhost");
   };
   if (host && host !== _constants.DEFAULT_DEV_HOST) {
     return [
@@ -69,7 +70,7 @@ const getAddressUrls = (protocol = "http", port, host) => {
 const prettyInstructions = (appContext, config) => {
   var _appContext_builder_context_devServer, _appContext_builder, _config_dev;
   const { entrypoints, serverRoutes, port, apiOnly, checkedEntries } = appContext;
-  const isHttps = (0, _is.isDev)() && ((_appContext_builder_context_devServer = (_appContext_builder = appContext.builder) === null || _appContext_builder === void 0 ? void 0 : _appContext_builder.context.devServer) === null || _appContext_builder_context_devServer === void 0 ? void 0 : _appContext_builder_context_devServer.https);
+  const isHttps = (0, _is.isDev)() && ((_appContext_builder = appContext.builder) === null || _appContext_builder === void 0 ? void 0 : (_appContext_builder_context_devServer = _appContext_builder.context.devServer) === null || _appContext_builder_context_devServer === void 0 ? void 0 : _appContext_builder_context_devServer.https);
   const urls = getAddressUrls(isHttps ? "https" : "http", port, (_config_dev = config.dev) === null || _config_dev === void 0 ? void 0 : _config_dev.host);
   const routes = !apiOnly ? serverRoutes.filter((route) => route.entryName) : serverRoutes;
   let message = "App running at:\n\n";

package/dist/cjs/cli/require.js

@@ -31,8 +31,9 @@ _export(exports, {
 });
 const _fs = require("./fs");
 const compatRequire = (filePath, interop = true) => {
+  var _mod;
   const mod = require(filePath);
-  const rtnESMDefault = interop && (mod === null || mod === void 0 ? void 0 : mod.__esModule);
+  const rtnESMDefault = interop && ((_mod = mod) === null || _mod === void 0 ? void 0 : _mod.__esModule);
   return rtnESMDefault ? mod.default : mod;
 };
 const dynamicImport = new Function("modulePath", "return import(modulePath)");

package/dist/cjs/runtime/nestedRoutes.js

@@ -30,6 +30,7 @@ const transformNestedRoutes = (routes) => {
   return (0, _reactrouterdom.createRoutesFromElements)(routeElements);
 };
 const renderNestedRoute = (nestedRoute, options = {}) => {
+  var _config, _children;
   const { children, index, id, component, isRoot, lazyImport, config, handle } = nestedRoute;
   const Component = component;
   const { parent, DeferredDataComponent, props = {} } = options;
@@ -43,7 +44,7 @@ const renderNestedRoute = (nestedRoute, options = {}) => {
     shouldRevalidate: nestedRoute.shouldRevalidate,
     handle: {
       ...handle,
-      ...typeof config === "object" ? config === null || config === void 0 ? void 0 : config.handle : {}
+      ...typeof config === "object" ? (_config = config) === null || _config === void 0 ? void 0 : _config.handle : {}
     },
     index: nestedRoute.index,
     element: nestedRoute.element,
@@ -55,7 +56,8 @@ const renderNestedRoute = (nestedRoute, options = {}) => {
   }
   let element;
   if (Component) {
-    if ((parent === null || parent === void 0 ? void 0 : parent.loading) && lazyImport) {
+    var _parent;
+    if (((_parent = parent) === null || _parent === void 0 ? void 0 : _parent.loading) && lazyImport) {
       const Loading = parent.loading;
       if (isLoadableComponent(Component)) {
         element = /* @__PURE__ */ (0, _jsxruntime.jsx)(Component, {
@@ -70,13 +72,14 @@ const renderNestedRoute = (nestedRoute, options = {}) => {
     } else if (isLoadableComponent(Component) && lazyImport) {
       element = /* @__PURE__ */ (0, _jsxruntime.jsx)(Component, {});
     } else if (isRoot) {
+      var _props;
       element = /* @__PURE__ */ (0, _jsxruntime.jsxs)(_jsxruntime.Fragment, {
         children: [
           /* @__PURE__ */ (0, _jsxruntime.jsx)(Component, {
             ...props
           }),
           typeof document === "undefined" && DeferredDataComponent && /* @__PURE__ */ (0, _jsxruntime.jsx)(DeferredDataComponent, {
-            nonce: props === null || props === void 0 ? void 0 : props.nonce
+            nonce: (_props = props) === null || _props === void 0 ? void 0 : _props.nonce
           })
         ]
       });
@@ -89,12 +92,13 @@ const renderNestedRoute = (nestedRoute, options = {}) => {
       element = /* @__PURE__ */ (0, _jsxruntime.jsx)(Component, {});
     }
   } else {
-    nestedRoute.loading = parent === null || parent === void 0 ? void 0 : parent.loading;
+    var _parent1;
+    nestedRoute.loading = (_parent1 = parent) === null || _parent1 === void 0 ? void 0 : _parent1.loading;
   }
   if (element) {
     routeProps.element = element;
   }
-  const childElements = children === null || children === void 0 ? void 0 : children.map((childRoute) => {
+  const childElements = (_children = children) === null || _children === void 0 ? void 0 : _children.map((childRoute) => {
     return renderNestedRoute(childRoute, {
       parent: nestedRoute
     });

package/dist/cjs/runtime-browser/parsed.js

@@ -16,7 +16,8 @@ const parsedJSONFromElement = (id) => {
   const element = elements[elements.length - 1];
   if (element) {
     try {
-      const parsed = JSON.parse((element === null || element === void 0 ? void 0 : element.textContent) || "");
+      var _element;
+      const parsed = JSON.parse(((_element = element) === null || _element === void 0 ? void 0 : _element.textContent) || "");
       return parsed;
     } catch (e) {
       console.error(`parse ${id} error`, e);

package/dist/cjs/universal/formatWebpack.js

@@ -2,9 +2,18 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-Object.defineProperty(exports, "formatWebpackMessages", {
-  enumerable: true,
-  get: function() {
+function _export(target, all) {
+  for (var name in all)
+    Object.defineProperty(target, name, {
+      enumerable: true,
+      get: all[name]
+    });
+}
+_export(exports, {
+  addErrorTips: function() {
+    return addErrorTips;
+  },
+  formatWebpackMessages: function() {
     return formatWebpackMessages;
   }
 });
@@ -52,13 +61,50 @@ ${stats.stack}` : "";
   message = lines.join("\n");
   return message.trim();
 }
-function formatWebpackMessages(json) {
-  var _json_errors, _json_warnings, _result_errors;
-  const formattedErrors = json === null || json === void 0 ? void 0 : (_json_errors = json.errors) === null || _json_errors === void 0 ? void 0 : _json_errors.map(formatMessage);
-  const formattedWarnings = json === null || json === void 0 ? void 0 : (_json_warnings = json.warnings) === null || _json_warnings === void 0 ? void 0 : _json_warnings.map(formatMessage);
+const noop = (message) => message;
+const defaultColor = {
+  gray: noop,
+  cyan: noop,
+  green: noop,
+  yellow: noop,
+  underline: noop
+};
+function addErrorTips(errors, color = defaultColor) {
+  const errorHelpers = [
+    {
+      validator(message) {
+        return (message.includes("You may need an appropriate loader") || message.includes("You may need an additional loader")) && message.includes(".ts");
+      },
+      formatter(message) {
+        return `${message}
+
+${color.yellow(`If it is a TypeScript file, you can use "source.include" config to compile it. see ${color.underline("https://modernjs.dev/builder/en/api/config-source.html#sourceinclude")}`)}
+
+${color.green(`${color.gray("// config file")}
+export default {
+  source: {
+    include: [
+      ${color.gray("// add some include rules")}
+    ]
+  }
+}`)}
+        `;
+      }
+    }
+  ];
+  return errors.map((error) => {
+    const helper = errorHelpers.find((item) => item.validator(error));
+    return helper ? helper.formatter(error) : error;
+  });
+}
+function formatWebpackMessages(json, color = defaultColor) {
+  var _json_errors, _json, _json_warnings, _json1, _result_errors;
+  const formattedErrors = (_json = json) === null || _json === void 0 ? void 0 : (_json_errors = _json.errors) === null || _json_errors === void 0 ? void 0 : _json_errors.map(formatMessage);
+  const formattedWarnings = (_json1 = json) === null || _json1 === void 0 ? void 0 : (_json_warnings = _json1.warnings) === null || _json_warnings === void 0 ? void 0 : _json_warnings.map(formatMessage);
   const result = {
     errors: formattedErrors || [],
-    warnings: formattedWarnings || []
+    warnings: formattedWarnings || [],
+    errorTips: []
   };
   if ((_result_errors = result.errors) === null || _result_errors === void 0 ? void 0 : _result_errors.some(isLikelyASyntaxError)) {
     result.errors = result.errors.filter(isLikelyASyntaxError);
@@ -66,5 +112,6 @@ function formatWebpackMessages(json) {
   if (result.errors.length > 1) {
     result.errors.length = 1;
   }
+  result.errors = addErrorTips(result.errors, color);
   return result;
 }

package/dist/esm/cli/alias.js

@@ -24,7 +24,7 @@ export var mergeAlias = function(alias) {
   return applyOptionsChain({}, alias);
 };
 export var getAliasConfig = function(aliasOption, option) {
-  var _tsconfig_compilerOptions, _tsconfig_compilerOptions1;
+  var _tsconfig_compilerOptions, _tsconfig, _tsconfig_compilerOptions1, _tsconfig1;
   var isTsProject = fs.existsSync(option.tsconfigPath);
   var alias = mergeAlias(aliasOption);
   if (!isTsProject) {
@@ -36,10 +36,10 @@ export var getAliasConfig = function(aliasOption, option) {
     };
   }
   var tsconfig = readTsConfigByFile(option.tsconfigPath);
-  var baseUrl = tsconfig === null || tsconfig === void 0 ? void 0 : (_tsconfig_compilerOptions = tsconfig.compilerOptions) === null || _tsconfig_compilerOptions === void 0 ? void 0 : _tsconfig_compilerOptions.baseUrl;
+  var baseUrl = (_tsconfig = tsconfig) === null || _tsconfig === void 0 ? void 0 : (_tsconfig_compilerOptions = _tsconfig.compilerOptions) === null || _tsconfig_compilerOptions === void 0 ? void 0 : _tsconfig_compilerOptions.baseUrl;
   return {
     absoluteBaseUrl: baseUrl ? path.join(option.appDirectory, baseUrl) : option.appDirectory,
-    paths: _object_spread({}, alias, tsconfig === null || tsconfig === void 0 ? void 0 : (_tsconfig_compilerOptions1 = tsconfig.compilerOptions) === null || _tsconfig_compilerOptions1 === void 0 ? void 0 : _tsconfig_compilerOptions1.paths),
+    paths: _object_spread({}, alias, (_tsconfig1 = tsconfig) === null || _tsconfig1 === void 0 ? void 0 : (_tsconfig_compilerOptions1 = _tsconfig1.compilerOptions) === null || _tsconfig_compilerOptions1 === void 0 ? void 0 : _tsconfig_compilerOptions1.paths),
     isTsPath: true,
     isTsProject: isTsProject
   };

package/dist/esm/cli/constants/chainId.js

@@ -37,6 +37,8 @@ export var CHAIN_ID = {
     YAML: "yaml",
     /** Rule for wasm */
     WASM: "wasm",
+    /** Rule for node */
+    NODE: "node",
     /** Rule for bff */
     JS_BFF_API: "js-bff-api"
   },
@@ -75,6 +77,8 @@ export var CHAIN_ID = {
     TOML: "toml",
     /** html-loader */
     HTML: "html",
+    /** node-loader */
+    NODE: "html",
     /** babel-loader */
     BABEL: "babel",
     /** esbuild-loader */

package/dist/esm/cli/constants/index.js

@@ -42,7 +42,6 @@ export var INTERNAL_APP_TOOLS_RUNTIME_PLUGINS = {
 };
 export var INTERNAL_MODULE_TOOLS_PLUGINS = {
   "@modern-js/module-tools": "@modern-js/module-tools",
-  "@modern-js/doc-tools": "@modern-js/doc-tools",
   "@modern-js/runtime": "@modern-js/runtime/cli",
   "@modern-js/plugin-testing": "@modern-js/plugin-testing/cli",
   "@modern-js/plugin-storybook": "@modern-js/plugin-storybook/cli",

package/dist/esm/cli/get/data.js

@@ -25,13 +25,22 @@ function _getPackageManager() {
           while (os.homedir() !== appDirectory && times < MAX_TIMES) {
             times++;
             if (fs.existsSync(path.resolve(appDirectory, "pnpm-lock.yaml"))) {
-              return "pnpm";
+              return [
+                2,
+                "pnpm"
+              ];
             }
             if (fs.existsSync(path.resolve(appDirectory, "yarn.lock"))) {
-              return "yarn";
+              return [
+                2,
+                "yarn"
+              ];
             }
             if (fs.existsSync(path.resolve(appDirectory, "package-lock.json"))) {
-              return "npm";
+              return [
+                2,
+                "npm"
+              ];
             }
             appDirectory = path.join(appDirectory, "..");
           }

package/dist/esm/cli/is/config.js

@@ -1,10 +1,11 @@
 import { isEmpty } from "./type";
 export var isSSR = function(config) {
+  var _server, _server1;
   var server = config.server;
-  if (server === null || server === void 0 ? void 0 : server.ssr) {
+  if ((_server = server) === null || _server === void 0 ? void 0 : _server.ssr) {
     return true;
   }
-  if ((server === null || server === void 0 ? void 0 : server.ssrByEntries) && !isEmpty(server.ssrByEntries)) {
+  if (((_server1 = server) === null || _server1 === void 0 ? void 0 : _server1.ssrByEntries) && !isEmpty(server.ssrByEntries)) {
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = void 0;
     try {
       for (var _iterator = Object.keys(server.ssrByEntries)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
@@ -31,27 +32,29 @@ export var isSSR = function(config) {
   return false;
 };
 export var isUseSSRBundle = function(config) {
+  var _output;
   var output = config.output;
-  if (output === null || output === void 0 ? void 0 : output.ssg) {
+  if ((_output = output) === null || _output === void 0 ? void 0 : _output.ssg) {
     return true;
   }
   return isSSR(config);
 };
 export var isServiceWorker = function(config) {
-  var _deploy_worker;
+  var _deploy_worker, _deploy, _output;
   var output = config.output, deploy = config.deploy;
-  if ((deploy === null || deploy === void 0 ? void 0 : (_deploy_worker = deploy.worker) === null || _deploy_worker === void 0 ? void 0 : _deploy_worker.ssr) && ((output === null || output === void 0 ? void 0 : output.ssg) || isSSR(config))) {
+  if (((_deploy = deploy) === null || _deploy === void 0 ? void 0 : (_deploy_worker = _deploy.worker) === null || _deploy_worker === void 0 ? void 0 : _deploy_worker.ssr) && (((_output = output) === null || _output === void 0 ? void 0 : _output.ssg) || isSSR(config))) {
     return true;
   }
   return false;
 };
 export var isRouterV5 = function(config) {
-  var _config_runtime, _config_runtime1, _config_runtime_router;
-  return typeof ((_config_runtime = config.runtime) === null || _config_runtime === void 0 ? void 0 : _config_runtime.router) !== "boolean" && (config === null || config === void 0 ? void 0 : (_config_runtime1 = config.runtime) === null || _config_runtime1 === void 0 ? void 0 : (_config_runtime_router = _config_runtime1.router) === null || _config_runtime_router === void 0 ? void 0 : _config_runtime_router.mode) === "react-router-5";
+  var _config_runtime, _config_runtime_router, _config_runtime1, _config;
+  return typeof ((_config_runtime = config.runtime) === null || _config_runtime === void 0 ? void 0 : _config_runtime.router) !== "boolean" && ((_config = config) === null || _config === void 0 ? void 0 : (_config_runtime1 = _config.runtime) === null || _config_runtime1 === void 0 ? void 0 : (_config_runtime_router = _config_runtime1.router) === null || _config_runtime_router === void 0 ? void 0 : _config_runtime_router.mode) === "react-router-5";
 };
 export var isSSGEntry = function(config, entryName, entrypoints) {
+  var _ssgConfig, _ssgConfig1;
   var ssgConfig = config.output.ssg;
-  var useSSG = isSingleEntry(entrypoints) ? Boolean(ssgConfig) : ssgConfig === true || typeof (ssgConfig === null || ssgConfig === void 0 ? void 0 : ssgConfig[0]) === "function" || Boolean(ssgConfig === null || ssgConfig === void 0 ? void 0 : ssgConfig[entryName]);
+  var useSSG = isSingleEntry(entrypoints) ? Boolean(ssgConfig) : ssgConfig === true || typeof ((_ssgConfig = ssgConfig) === null || _ssgConfig === void 0 ? void 0 : _ssgConfig[0]) === "function" || Boolean((_ssgConfig1 = ssgConfig) === null || _ssgConfig1 === void 0 ? void 0 : _ssgConfig1[entryName]);
   return useSSG;
 };
 export var isSingleEntry = function(entrypoints) {

package/dist/esm/cli/prettyInstructions.js

@@ -24,7 +24,8 @@ export var getAddressUrls = function() {
   var LOCAL_LABEL = "Local:  ";
   var NETWORK_LABEL = "Network:  ";
   var isLocalhost = function(url) {
-    return url === null || url === void 0 ? void 0 : url.includes("localhost");
+    var _url;
+    return (_url = url) === null || _url === void 0 ? void 0 : _url.includes("localhost");
   };
   if (host && host !== DEFAULT_DEV_HOST) {
     return [
@@ -53,7 +54,7 @@ export var getAddressUrls = function() {
 export var prettyInstructions = function(appContext, config) {
   var _appContext_builder_context_devServer, _appContext_builder, _config_dev;
   var entrypoints = appContext.entrypoints, serverRoutes = appContext.serverRoutes, port = appContext.port, apiOnly = appContext.apiOnly, checkedEntries = appContext.checkedEntries;
-  var isHttps = isDev() && ((_appContext_builder_context_devServer = (_appContext_builder = appContext.builder) === null || _appContext_builder === void 0 ? void 0 : _appContext_builder.context.devServer) === null || _appContext_builder_context_devServer === void 0 ? void 0 : _appContext_builder_context_devServer.https);
+  var isHttps = isDev() && ((_appContext_builder = appContext.builder) === null || _appContext_builder === void 0 ? void 0 : (_appContext_builder_context_devServer = _appContext_builder.context.devServer) === null || _appContext_builder_context_devServer === void 0 ? void 0 : _appContext_builder_context_devServer.https);
   var urls = getAddressUrls(isHttps ? "https" : "http", port, (_config_dev = config.dev) === null || _config_dev === void 0 ? void 0 : _config_dev.host);
   var routes = !apiOnly ? serverRoutes.filter(function(route) {
     return route.entryName;

package/dist/esm/cli/require.js

@@ -2,8 +2,9 @@ import { _ as _object_spread } from "@swc/helpers/_/_object_spread";
 import { findExists } from "./fs";
 export var compatRequire = function(filePath) {
   var interop = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : true;
+  var _mod;
   var mod = require(filePath);
-  var rtnESMDefault = interop && (mod === null || mod === void 0 ? void 0 : mod.__esModule);
+  var rtnESMDefault = interop && ((_mod = mod) === null || _mod === void 0 ? void 0 : _mod.__esModule);
   return rtnESMDefault ? mod.default : mod;
 };
 export var dynamicImport = new Function("modulePath", "return import(modulePath)");

package/dist/esm/runtime/nestedRoutes.js

@@ -30,6 +30,7 @@ export var transformNestedRoutes = function(routes) {
 };
 export var renderNestedRoute = function(nestedRoute) {
   var options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
+  var _config, _children;
   var children = nestedRoute.children, index = nestedRoute.index, id = nestedRoute.id, component = nestedRoute.component, isRoot = nestedRoute.isRoot, lazyImport = nestedRoute.lazyImport, config = nestedRoute.config, handle = nestedRoute.handle;
   var Component = component;
   var parent = options.parent, DeferredDataComponent = options.DeferredDataComponent, _options_props = options.props, props = _options_props === void 0 ? {} : _options_props;
@@ -41,7 +42,7 @@ export var renderNestedRoute = function(nestedRoute) {
     action: nestedRoute.action,
     hasErrorBoundary: nestedRoute.hasErrorBoundary,
     shouldRevalidate: nestedRoute.shouldRevalidate,
-    handle: _object_spread({}, handle, typeof config === "object" ? config === null || config === void 0 ? void 0 : config.handle : {}),
+    handle: _object_spread({}, handle, typeof config === "object" ? (_config = config) === null || _config === void 0 ? void 0 : _config.handle : {}),
     index: nestedRoute.index,
     element: nestedRoute.element,
     errorElement: nestedRoute.errorElement
@@ -52,7 +53,8 @@ export var renderNestedRoute = function(nestedRoute) {
   }
   var element;
   if (Component) {
-    if ((parent === null || parent === void 0 ? void 0 : parent.loading) && lazyImport) {
+    var _parent;
+    if (((_parent = parent) === null || _parent === void 0 ? void 0 : _parent.loading) && lazyImport) {
       var Loading = parent.loading;
       if (isLoadableComponent(Component)) {
         element = /* @__PURE__ */ _jsx(Component, {
@@ -67,11 +69,12 @@ export var renderNestedRoute = function(nestedRoute) {
     } else if (isLoadableComponent(Component) && lazyImport) {
       element = /* @__PURE__ */ _jsx(Component, {});
     } else if (isRoot) {
+      var _props;
       element = /* @__PURE__ */ _jsxs(_Fragment, {
         children: [
           /* @__PURE__ */ _jsx(Component, _object_spread({}, props)),
           typeof document === "undefined" && DeferredDataComponent && /* @__PURE__ */ _jsx(DeferredDataComponent, {
-            nonce: props === null || props === void 0 ? void 0 : props.nonce
+            nonce: (_props = props) === null || _props === void 0 ? void 0 : _props.nonce
           })
         ]
       });
@@ -84,12 +87,13 @@ export var renderNestedRoute = function(nestedRoute) {
       element = /* @__PURE__ */ _jsx(Component, {});
     }
   } else {
-    nestedRoute.loading = parent === null || parent === void 0 ? void 0 : parent.loading;
+    var _parent1;
+    nestedRoute.loading = (_parent1 = parent) === null || _parent1 === void 0 ? void 0 : _parent1.loading;
   }
   if (element) {
     routeProps.element = element;
   }
-  var childElements = children === null || children === void 0 ? void 0 : children.map(function(childRoute) {
+  var childElements = (_children = children) === null || _children === void 0 ? void 0 : _children.map(function(childRoute) {
     return renderNestedRoute(childRoute, {
       parent: nestedRoute
     });

package/dist/esm/runtime-browser/parsed.js

@@ -6,7 +6,8 @@ export var parsedJSONFromElement = function(id) {
   var element = elements[elements.length - 1];
   if (element) {
     try {
-      var parsed = JSON.parse((element === null || element === void 0 ? void 0 : element.textContent) || "");
+      var _element;
+      var parsed = JSON.parse(((_element = element) === null || _element === void 0 ? void 0 : _element.textContent) || "");
       return parsed;
     } catch (e) {
       console.error("parse ".concat(id, " error"), e);

package/dist/esm/universal/formatWebpack.js

@@ -40,13 +40,44 @@ function formatMessage(stats) {
   message = lines.join("\n");
   return message.trim();
 }
+var noop = function(message) {
+  return message;
+};
+var defaultColor = {
+  gray: noop,
+  cyan: noop,
+  green: noop,
+  yellow: noop,
+  underline: noop
+};
+export function addErrorTips(errors) {
+  var color = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : defaultColor;
+  var errorHelpers = [
+    {
+      validator: function validator(message) {
+        return (message.includes("You may need an appropriate loader") || message.includes("You may need an additional loader")) && message.includes(".ts");
+      },
+      formatter: function formatter(message) {
+        return "".concat(message, "\n\n").concat(color.yellow('If it is a TypeScript file, you can use "source.include" config to compile it. see '.concat(color.underline("https://modernjs.dev/builder/en/api/config-source.html#sourceinclude"))), "\n\n").concat(color.green("".concat(color.gray("// config file"), "\nexport default {\n  source: {\n    include: [\n      ").concat(color.gray("// add some include rules"), "\n    ]\n  }\n}")), "\n        ");
+      }
+    }
+  ];
+  return errors.map(function(error) {
+    var helper = errorHelpers.find(function(item) {
+      return item.validator(error);
+    });
+    return helper ? helper.formatter(error) : error;
+  });
+}
 function formatWebpackMessages(json) {
-  var _json_errors, _json_warnings, _result_errors;
-  var formattedErrors = json === null || json === void 0 ? void 0 : (_json_errors = json.errors) === null || _json_errors === void 0 ? void 0 : _json_errors.map(formatMessage);
-  var formattedWarnings = json === null || json === void 0 ? void 0 : (_json_warnings = json.warnings) === null || _json_warnings === void 0 ? void 0 : _json_warnings.map(formatMessage);
+  var color = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : defaultColor;
+  var _json_errors, _json, _json_warnings, _json1, _result_errors;
+  var formattedErrors = (_json = json) === null || _json === void 0 ? void 0 : (_json_errors = _json.errors) === null || _json_errors === void 0 ? void 0 : _json_errors.map(formatMessage);
+  var formattedWarnings = (_json1 = json) === null || _json1 === void 0 ? void 0 : (_json_warnings = _json1.warnings) === null || _json_warnings === void 0 ? void 0 : _json_warnings.map(formatMessage);
   var result = {
     errors: formattedErrors || [],
-    warnings: formattedWarnings || []
+    warnings: formattedWarnings || [],
+    errorTips: []
   };
   if ((_result_errors = result.errors) === null || _result_errors === void 0 ? void 0 : _result_errors.some(isLikelyASyntaxError)) {
     result.errors = result.errors.filter(isLikelyASyntaxError);
@@ -54,6 +85,7 @@ function formatWebpackMessages(json) {
   if (result.errors.length > 1) {
     result.errors.length = 1;
   }
+  result.errors = addErrorTips(result.errors, color);
   return result;
 }
 export { formatWebpackMessages };

package/dist/esm-node/cli/alias.js

@@ -20,7 +20,7 @@ export const validAlias = (modernConfig, { tsconfigPath }) => {
 };
 export const mergeAlias = (alias) => applyOptionsChain({}, alias);
 export const getAliasConfig = (aliasOption, option) => {
-  var _tsconfig_compilerOptions, _tsconfig_compilerOptions1;
+  var _tsconfig_compilerOptions, _tsconfig, _tsconfig_compilerOptions1, _tsconfig1;
   const isTsProject = fs.existsSync(option.tsconfigPath);
   const alias = mergeAlias(aliasOption);
   if (!isTsProject) {
@@ -32,12 +32,12 @@ export const getAliasConfig = (aliasOption, option) => {
     };
   }
   const tsconfig = readTsConfigByFile(option.tsconfigPath);
-  const baseUrl = tsconfig === null || tsconfig === void 0 ? void 0 : (_tsconfig_compilerOptions = tsconfig.compilerOptions) === null || _tsconfig_compilerOptions === void 0 ? void 0 : _tsconfig_compilerOptions.baseUrl;
+  const baseUrl = (_tsconfig = tsconfig) === null || _tsconfig === void 0 ? void 0 : (_tsconfig_compilerOptions = _tsconfig.compilerOptions) === null || _tsconfig_compilerOptions === void 0 ? void 0 : _tsconfig_compilerOptions.baseUrl;
   return {
     absoluteBaseUrl: baseUrl ? path.join(option.appDirectory, baseUrl) : option.appDirectory,
     paths: {
       ...alias,
-      ...tsconfig === null || tsconfig === void 0 ? void 0 : (_tsconfig_compilerOptions1 = tsconfig.compilerOptions) === null || _tsconfig_compilerOptions1 === void 0 ? void 0 : _tsconfig_compilerOptions1.paths
+      ...(_tsconfig1 = tsconfig) === null || _tsconfig1 === void 0 ? void 0 : (_tsconfig_compilerOptions1 = _tsconfig1.compilerOptions) === null || _tsconfig_compilerOptions1 === void 0 ? void 0 : _tsconfig_compilerOptions1.paths
     },
     isTsPath: true,
     isTsProject

package/dist/esm-node/cli/constants/chainId.js

@@ -37,6 +37,8 @@ export const CHAIN_ID = {
     YAML: "yaml",
     /** Rule for wasm */
     WASM: "wasm",
+    /** Rule for node */
+    NODE: "node",
     /** Rule for bff */
     JS_BFF_API: "js-bff-api"
   },
@@ -75,6 +77,8 @@ export const CHAIN_ID = {
     TOML: "toml",
     /** html-loader */
     HTML: "html",
+    /** node-loader */
+    NODE: "html",
     /** babel-loader */
     BABEL: "babel",
     /** esbuild-loader */

package/dist/esm-node/cli/constants/index.js

@@ -41,7 +41,6 @@ export const INTERNAL_APP_TOOLS_RUNTIME_PLUGINS = {
 };
 export const INTERNAL_MODULE_TOOLS_PLUGINS = {
   "@modern-js/module-tools": "@modern-js/module-tools",
-  "@modern-js/doc-tools": "@modern-js/doc-tools",
   "@modern-js/runtime": "@modern-js/runtime/cli",
   "@modern-js/plugin-testing": "@modern-js/plugin-testing/cli",
   "@modern-js/plugin-storybook": "@modern-js/plugin-storybook/cli",

package/dist/esm-node/cli/is/config.js

@@ -1,10 +1,11 @@
 import { isEmpty } from "./type";
 export const isSSR = (config) => {
+  var _server, _server1;
   const { server } = config;
-  if (server === null || server === void 0 ? void 0 : server.ssr) {
+  if ((_server = server) === null || _server === void 0 ? void 0 : _server.ssr) {
     return true;
   }
-  if ((server === null || server === void 0 ? void 0 : server.ssrByEntries) && !isEmpty(server.ssrByEntries)) {
+  if (((_server1 = server) === null || _server1 === void 0 ? void 0 : _server1.ssrByEntries) && !isEmpty(server.ssrByEntries)) {
     for (const name of Object.keys(server.ssrByEntries)) {
       if (server.ssrByEntries[name]) {
         return true;
@@ -14,27 +15,29 @@ export const isSSR = (config) => {
   return false;
 };
 export const isUseSSRBundle = (config) => {
+  var _output;
   const { output } = config;
-  if (output === null || output === void 0 ? void 0 : output.ssg) {
+  if ((_output = output) === null || _output === void 0 ? void 0 : _output.ssg) {
     return true;
   }
   return isSSR(config);
 };
 export const isServiceWorker = (config) => {
-  var _deploy_worker;
+  var _deploy_worker, _deploy, _output;
   const { output, deploy } = config;
-  if ((deploy === null || deploy === void 0 ? void 0 : (_deploy_worker = deploy.worker) === null || _deploy_worker === void 0 ? void 0 : _deploy_worker.ssr) && ((output === null || output === void 0 ? void 0 : output.ssg) || isSSR(config))) {
+  if (((_deploy = deploy) === null || _deploy === void 0 ? void 0 : (_deploy_worker = _deploy.worker) === null || _deploy_worker === void 0 ? void 0 : _deploy_worker.ssr) && (((_output = output) === null || _output === void 0 ? void 0 : _output.ssg) || isSSR(config))) {
     return true;
   }
   return false;
 };
 export const isRouterV5 = (config) => {
-  var _config_runtime, _config_runtime1, _config_runtime_router;
-  return typeof ((_config_runtime = config.runtime) === null || _config_runtime === void 0 ? void 0 : _config_runtime.router) !== "boolean" && (config === null || config === void 0 ? void 0 : (_config_runtime1 = config.runtime) === null || _config_runtime1 === void 0 ? void 0 : (_config_runtime_router = _config_runtime1.router) === null || _config_runtime_router === void 0 ? void 0 : _config_runtime_router.mode) === "react-router-5";
+  var _config_runtime, _config_runtime_router, _config_runtime1, _config;
+  return typeof ((_config_runtime = config.runtime) === null || _config_runtime === void 0 ? void 0 : _config_runtime.router) !== "boolean" && ((_config = config) === null || _config === void 0 ? void 0 : (_config_runtime1 = _config.runtime) === null || _config_runtime1 === void 0 ? void 0 : (_config_runtime_router = _config_runtime1.router) === null || _config_runtime_router === void 0 ? void 0 : _config_runtime_router.mode) === "react-router-5";
 };
 export const isSSGEntry = (config, entryName, entrypoints) => {
+  var _ssgConfig, _ssgConfig1;
   const ssgConfig = config.output.ssg;
-  const useSSG = isSingleEntry(entrypoints) ? Boolean(ssgConfig) : ssgConfig === true || typeof (ssgConfig === null || ssgConfig === void 0 ? void 0 : ssgConfig[0]) === "function" || Boolean(ssgConfig === null || ssgConfig === void 0 ? void 0 : ssgConfig[entryName]);
+  const useSSG = isSingleEntry(entrypoints) ? Boolean(ssgConfig) : ssgConfig === true || typeof ((_ssgConfig = ssgConfig) === null || _ssgConfig === void 0 ? void 0 : _ssgConfig[0]) === "function" || Boolean((_ssgConfig1 = ssgConfig) === null || _ssgConfig1 === void 0 ? void 0 : _ssgConfig1[entryName]);
   return useSSG;
 };
 export const isSingleEntry = (entrypoints) => entrypoints.length === 1 && entrypoints[0].entryName === "main";

package/dist/esm-node/cli/prettyInstructions.js

@@ -20,7 +20,8 @@ export const getAddressUrls = (protocol = "http", port, host) => {
   const LOCAL_LABEL = "Local:  ";
   const NETWORK_LABEL = "Network:  ";
   const isLocalhost = (url) => {
-    return url === null || url === void 0 ? void 0 : url.includes("localhost");
+    var _url;
+    return (_url = url) === null || _url === void 0 ? void 0 : _url.includes("localhost");
   };
   if (host && host !== DEFAULT_DEV_HOST) {
     return [
@@ -49,7 +50,7 @@ export const getAddressUrls = (protocol = "http", port, host) => {
 export const prettyInstructions = (appContext, config) => {
   var _appContext_builder_context_devServer, _appContext_builder, _config_dev;
   const { entrypoints, serverRoutes, port, apiOnly, checkedEntries } = appContext;
-  const isHttps = isDev() && ((_appContext_builder_context_devServer = (_appContext_builder = appContext.builder) === null || _appContext_builder === void 0 ? void 0 : _appContext_builder.context.devServer) === null || _appContext_builder_context_devServer === void 0 ? void 0 : _appContext_builder_context_devServer.https);
+  const isHttps = isDev() && ((_appContext_builder = appContext.builder) === null || _appContext_builder === void 0 ? void 0 : (_appContext_builder_context_devServer = _appContext_builder.context.devServer) === null || _appContext_builder_context_devServer === void 0 ? void 0 : _appContext_builder_context_devServer.https);
   const urls = getAddressUrls(isHttps ? "https" : "http", port, (_config_dev = config.dev) === null || _config_dev === void 0 ? void 0 : _config_dev.host);
   const routes = !apiOnly ? serverRoutes.filter((route) => route.entryName) : serverRoutes;
   let message = "App running at:\n\n";

package/dist/esm-node/cli/require.js

@@ -1,7 +1,8 @@
 import { findExists } from "./fs";
 export const compatRequire = (filePath, interop = true) => {
+  var _mod;
   const mod = require(filePath);
-  const rtnESMDefault = interop && (mod === null || mod === void 0 ? void 0 : mod.__esModule);
+  const rtnESMDefault = interop && ((_mod = mod) === null || _mod === void 0 ? void 0 : _mod.__esModule);
   return rtnESMDefault ? mod.default : mod;
 };
 export const dynamicImport = new Function("modulePath", "return import(modulePath)");

package/dist/esm-node/runtime/nestedRoutes.js

@@ -10,6 +10,7 @@ export const transformNestedRoutes = (routes) => {
   return createRoutesFromElements(routeElements);
 };
 export const renderNestedRoute = (nestedRoute, options = {}) => {
+  var _config, _children;
   const { children, index, id, component, isRoot, lazyImport, config, handle } = nestedRoute;
   const Component = component;
   const { parent, DeferredDataComponent, props = {} } = options;
@@ -23,7 +24,7 @@ export const renderNestedRoute = (nestedRoute, options = {}) => {
     shouldRevalidate: nestedRoute.shouldRevalidate,
     handle: {
       ...handle,
-      ...typeof config === "object" ? config === null || config === void 0 ? void 0 : config.handle : {}
+      ...typeof config === "object" ? (_config = config) === null || _config === void 0 ? void 0 : _config.handle : {}
     },
     index: nestedRoute.index,
     element: nestedRoute.element,
@@ -35,7 +36,8 @@ export const renderNestedRoute = (nestedRoute, options = {}) => {
   }
   let element;
   if (Component) {
-    if ((parent === null || parent === void 0 ? void 0 : parent.loading) && lazyImport) {
+    var _parent;
+    if (((_parent = parent) === null || _parent === void 0 ? void 0 : _parent.loading) && lazyImport) {
       const Loading = parent.loading;
       if (isLoadableComponent(Component)) {
         element = /* @__PURE__ */ _jsx(Component, {
@@ -50,13 +52,14 @@ export const renderNestedRoute = (nestedRoute, options = {}) => {
     } else if (isLoadableComponent(Component) && lazyImport) {
       element = /* @__PURE__ */ _jsx(Component, {});
     } else if (isRoot) {
+      var _props;
       element = /* @__PURE__ */ _jsxs(_Fragment, {
         children: [
           /* @__PURE__ */ _jsx(Component, {
             ...props
           }),
           typeof document === "undefined" && DeferredDataComponent && /* @__PURE__ */ _jsx(DeferredDataComponent, {
-            nonce: props === null || props === void 0 ? void 0 : props.nonce
+            nonce: (_props = props) === null || _props === void 0 ? void 0 : _props.nonce
           })
         ]
       });
@@ -69,12 +72,13 @@ export const renderNestedRoute = (nestedRoute, options = {}) => {
       element = /* @__PURE__ */ _jsx(Component, {});
     }
   } else {
-    nestedRoute.loading = parent === null || parent === void 0 ? void 0 : parent.loading;
+    var _parent1;
+    nestedRoute.loading = (_parent1 = parent) === null || _parent1 === void 0 ? void 0 : _parent1.loading;
   }
   if (element) {
     routeProps.element = element;
   }
-  const childElements = children === null || children === void 0 ? void 0 : children.map((childRoute) => {
+  const childElements = (_children = children) === null || _children === void 0 ? void 0 : _children.map((childRoute) => {
     return renderNestedRoute(childRoute, {
       parent: nestedRoute
     });

package/dist/esm-node/runtime-browser/parsed.js

@@ -6,7 +6,8 @@ export const parsedJSONFromElement = (id) => {
   const element = elements[elements.length - 1];
   if (element) {
     try {
-      const parsed = JSON.parse((element === null || element === void 0 ? void 0 : element.textContent) || "");
+      var _element;
+      const parsed = JSON.parse(((_element = element) === null || _element === void 0 ? void 0 : _element.textContent) || "");
       return parsed;
     } catch (e) {
       console.error(`parse ${id} error`, e);

package/dist/esm-node/universal/formatWebpack.js

@@ -42,13 +42,50 @@ ${stats.stack}` : "";
   message = lines.join("\n");
   return message.trim();
 }
-function formatWebpackMessages(json) {
-  var _json_errors, _json_warnings, _result_errors;
-  const formattedErrors = json === null || json === void 0 ? void 0 : (_json_errors = json.errors) === null || _json_errors === void 0 ? void 0 : _json_errors.map(formatMessage);
-  const formattedWarnings = json === null || json === void 0 ? void 0 : (_json_warnings = json.warnings) === null || _json_warnings === void 0 ? void 0 : _json_warnings.map(formatMessage);
+const noop = (message) => message;
+const defaultColor = {
+  gray: noop,
+  cyan: noop,
+  green: noop,
+  yellow: noop,
+  underline: noop
+};
+export function addErrorTips(errors, color = defaultColor) {
+  const errorHelpers = [
+    {
+      validator(message) {
+        return (message.includes("You may need an appropriate loader") || message.includes("You may need an additional loader")) && message.includes(".ts");
+      },
+      formatter(message) {
+        return `${message}
+
+${color.yellow(`If it is a TypeScript file, you can use "source.include" config to compile it. see ${color.underline("https://modernjs.dev/builder/en/api/config-source.html#sourceinclude")}`)}
+
+${color.green(`${color.gray("// config file")}
+export default {
+  source: {
+    include: [
+      ${color.gray("// add some include rules")}
+    ]
+  }
+}`)}
+        `;
+      }
+    }
+  ];
+  return errors.map((error) => {
+    const helper = errorHelpers.find((item) => item.validator(error));
+    return helper ? helper.formatter(error) : error;
+  });
+}
+function formatWebpackMessages(json, color = defaultColor) {
+  var _json_errors, _json, _json_warnings, _json1, _result_errors;
+  const formattedErrors = (_json = json) === null || _json === void 0 ? void 0 : (_json_errors = _json.errors) === null || _json_errors === void 0 ? void 0 : _json_errors.map(formatMessage);
+  const formattedWarnings = (_json1 = json) === null || _json1 === void 0 ? void 0 : (_json_warnings = _json1.warnings) === null || _json_warnings === void 0 ? void 0 : _json_warnings.map(formatMessage);
   const result = {
     errors: formattedErrors || [],
-    warnings: formattedWarnings || []
+    warnings: formattedWarnings || [],
+    errorTips: []
   };
   if ((_result_errors = result.errors) === null || _result_errors === void 0 ? void 0 : _result_errors.some(isLikelyASyntaxError)) {
     result.errors = result.errors.filter(isLikelyASyntaxError);
@@ -56,6 +93,7 @@ function formatWebpackMessages(json) {
   if (result.errors.length > 1) {
     result.errors.length = 1;
   }
+  result.errors = addErrorTips(result.errors, color);
   return result;
 }
 export { formatWebpackMessages };

package/dist/types/cli/constants/chainId.d.ts

@@ -37,6 +37,8 @@ export declare const CHAIN_ID: {
     readonly YAML: "yaml";
     /** Rule for wasm */
     readonly WASM: "wasm";
+    /** Rule for node */
+    readonly NODE: "node";
     /** Rule for bff */
     readonly JS_BFF_API: "js-bff-api";
   };
@@ -75,6 +77,8 @@ export declare const CHAIN_ID: {
     readonly TOML: "toml";
     /** html-loader */
     readonly HTML: "html";
+    /** node-loader */
+    readonly NODE: "html";
     /** babel-loader */
     readonly BABEL: "babel";
     /** esbuild-loader */

package/dist/types/universal/formatWebpack.d.ts

@@ -6,7 +6,20 @@
  * https://github.com/facebook/create-react-app/blob/master/LICENSE
  */
 import type { StatsCompilation } from 'webpack';
-declare function formatWebpackMessages(json?: Pick<StatsCompilation, 'errors' | 'warnings'>): {
+export declare function addErrorTips(errors: string[], color?: {
+  gray: (message: string) => string;
+  cyan: (message: string) => string;
+  green: (message: string) => string;
+  yellow: (message: string) => string;
+  underline: (message: string) => string;
+}): string[];
+declare function formatWebpackMessages(json?: Pick<StatsCompilation, 'errors' | 'warnings'>, color?: {
+  gray: (message: string) => string;
+  cyan: (message: string) => string;
+  green: (message: string) => string;
+  yellow: (message: string) => string;
+  underline: (message: string) => string;
+}): {
   errors: string[];
   warnings: string[];
 };

package/package.json

@@ -15,7 +15,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "2.27.0",
+  "version": "2.28.0",
   "jsnext:source": "./src/index.ts",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/cjs/index.js",
@@ -235,9 +235,9 @@
     "typescript": "^5",
     "webpack": "^5.88.1",
     "@types/serialize-javascript": "^5.0.1",
-    "@modern-js/types": "2.27.0",
-    "@scripts/jest-config": "2.27.0",
-    "@scripts/build": "2.27.0"
+    "@modern-js/types": "2.28.0",
+    "@scripts/build": "2.28.0",
+    "@scripts/jest-config": "2.28.0"
   },
   "sideEffects": false,
   "scripts": {