@umijs/babel-preset-umi 4.0.51 → 4.0.52

package/dist/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
 ));
@@ -41,12 +45,16 @@ var src_default = (_context, opts) => {
         require.resolve("@umijs/bundler-utils/compiled/babel/preset-env"),
         {
           bugfixes: true,
+          // 更兼容 spec，但会变慢，所以不开
           spec: false,
+          // 推荐用 top level 的 assumptions 配置
           loose: false,
+          // 保留 es modules 语法，交给 webpack 处理
           modules: false,
           debug: false,
           useBuiltIns: "entry",
           corejs: (0, import_utils.getCorejsVersion)((0, import_path.join)(__dirname, "../package.json")),
+          // 没必要，遇到了应该改 targets 配置
           forceAllTransforms: false,
           ignoreBrowserslistConfig: true,
           ...opts.presetEnv
@@ -65,6 +73,9 @@ var src_default = (_context, opts) => {
         {
           allowNamespaces: true,
           allowDeclareFields: true,
+          // Why false?
+          // 如果为 true，babel 只删除 import type 语句，会保留其他通过 import 引入的 type
+          // 这些 type 引用走到 webpack 之后，就会报错
           onlyRemoveTypeImports: false,
           optimizeConstEnums: true,
           ...opts.presetTypeScript
@@ -78,10 +89,24 @@ var src_default = (_context, opts) => {
           ...opts.pluginStyledComponents
         }
       ],
+      // TC39 Proposals
+      // class-static-block
+      // decorators
       [
         require.resolve("@umijs/bundler-utils/compiled/babel/plugin-proposal-decorators"),
         { legacy: true }
       ],
+      // Enable loose mode to use assignment instead of defineProperty
+      // Note:
+      // 'loose' mode configuration must be the same for
+      // * @babel/plugin-proposal-class-properties
+      // * @babel/plugin-proposal-private-methods
+      // * @babel/plugin-proposal-private-property-in-object
+      // (when they are enabled)
+      // ref: https://github.com/facebook/create-react-app/issues/4263
+      // ref: https://github.com/mobxjs/mobx/issues/1471
+      // ref: https://github.com/umijs/umi/issues/9396
+      // 不移动到 feature 里的原因是因为 decorators 有顺序要求
       opts.classPropertiesLoose && [
         require.resolve("@umijs/bundler-utils/compiled/babel/plugin-proposal-class-properties"),
         { loose: true }
@@ -98,25 +123,34 @@ var src_default = (_context, opts) => {
           loose: true
         }
       ],
+      // do-expressions
       [
         require.resolve("@umijs/bundler-utils/compiled/babel/plugin-proposal-do-expressions")
       ],
+      // export-default-from
       [
         require.resolve("@umijs/bundler-utils/compiled/babel/plugin-proposal-export-default-from")
       ],
+      // export-namespace-from
       [
         require.resolve("@umijs/bundler-utils/compiled/babel/plugin-proposal-export-namespace-from")
       ],
+      // function-bind
       [
         require.resolve("@umijs/bundler-utils/compiled/babel/plugin-proposal-function-bind")
       ],
+      // function-sent
+      // partial-application
       [
         require.resolve("@umijs/bundler-utils/compiled/babel/plugin-proposal-partial-application")
       ],
+      // pipeline-operator
       [
         require.resolve("@umijs/bundler-utils/compiled/babel/plugin-proposal-pipeline-operator"),
         { proposal: "minimal" }
       ],
+      // throw-expressions
+      // record-and-tuple
       [
         require.resolve("@umijs/bundler-utils/compiled/babel/plugin-proposal-record-and-tuple"),
         {
@@ -132,12 +166,18 @@ var src_default = (_context, opts) => {
         {
           helpers: true,
           regenerator: true,
+          // 7.13 之后根据 exports 自动选择 esm 和 cjs，无需此配置
           useESModules: false,
+          // lock the version of @babel/runtime
+          // make sure we are using the correct version
+          // ref: https://github.com/babel/babel/blob/v7.16.12/packages/babel-plugin-transform-runtime/src/get-runtime-path/index.ts#L19
+          // ref: https://github.com/umijs/umi/pull/7816
           absoluteRuntime: (0, import_path.dirname)(require.resolve("../package.json")),
           version: `^${require("@babel/runtime/package.json").version}`,
           ...opts.pluginTransformRuntime
         }
       ],
+      // none official plugins
       opts.pluginLockCoreJS && [import_lockCoreJS.default],
       opts.pluginDynamicImportNode && [import_dynamicImportNode.default],
       opts.pluginAutoCSSModules && [import_autoCSSModules.default],

package/dist/plugins/autoCSSModules.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
 ));
@@ -44,6 +48,8 @@ function autoCSSModules_default() {
           source.value = `${value}?modules`;
         }
       },
+      // e.g.
+      // const styles = await import('./index.less');
       VariableDeclarator(path) {
         const { node } = path;
         if (t.isAwaitExpression(node.init) && t.isCallExpression(node.init.argument) && t.isImport(node.init.argument.callee) && node.init.argument.arguments.length === 1 && t.isStringLiteral(node.init.argument.arguments[0]) && CSS_EXT_NAMES.includes((0, import_path.extname)(node.init.argument.arguments[0].value))) {

package/dist/plugins/dynamicImportNode.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/plugins/lockCoreJS.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/plugins/stripExports.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umijs/babel-preset-umi",
-  "version": "4.0.51",
+  "version": "4.0.52",
   "description": "Official babel preset for umi.",
   "homepage": "https://github.com/umijs/umi/tree/master/packages/babel-preset-umi#readme",
   "bugs": "https://github.com/umijs/umi/issues",
@@ -23,8 +23,8 @@
   "dependencies": {
     "@babel/runtime": "7.20.7",
     "@bloomberg/record-tuple-polyfill": "0.0.4",
-    "@umijs/bundler-utils": "4.0.51",
-    "@umijs/utils": "4.0.51",
+    "@umijs/bundler-utils": "4.0.52",
+    "@umijs/utils": "4.0.52",
     "babel-plugin-styled-components": "2.0.7",
     "core-js": "3.27.1"
   },