@wiajs/core 0.1.19 → 1.0.2

package/.eslintrc.js

@@ -1,90 +1,121 @@
+const rules = {
+  // Disable for console/alert
+  // 0 关闭 1 警告 2 报错 https://eslint.org/docs/rules/  中文网址：http://eslint.cn/docs/rules/
+  // "arrow-parens": [2, "as-needed"],
+  'arrow-parens': [2, 'as-needed', {requireForBlockBody: false}],
+  'arrow-body-style': [2, 'as-needed'],
+  'global-require': 0,
+  'no-console': process.env.NODE_ENV === 'production' ? 'error' : 'off',
+  'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',
+  quotes: [1, 'single'],
+  'no-alert': 0,
+  'no-trailing-spaces': 0,
+  'nonblock-statement-body-position': 0, // [2, "beside"], // if else 强制单行
+  'block-spacing': 0, // 对象空格
+  'function-paren-newline': 0, // 函数参数换行
+  'linebreak-style': 0,
+  'lines-between-class-members': 0,
+  'class-methods-use-this': 0,
+  'import/no-extraneous-dependencies': 0,
+  indent: [2, 2, {SwitchCase: 1}],
+  'object-curly-spacing': 0,
+  'no-plusplus': 0,
+  'no-multi-spaces': 0,
+  'no-param-reassign': ['warn', {props: false}],
+  'no-use-before-define': [2, {functions: false, classes: true}],
+  'no-unused-expressions': ['error', {allowShortCircuit: true}],
+  'no-underscore-dangle': 0,
+  'no-unused-vars': [1, {vars: 'local', args: 'after-used'}],
+  'no-cond-assign': ['error', 'except-parens'],
+  'no-return-assign': [2, 'except-parens'],
+  'no-await-in-loop': 0,
+  'import/prefer-default-export': 0,
+  'operator-linebreak': 0,
+  'generator-star-spacing': 0,
+  // if while function 后面的{必须与if在同一行，java风格。
+  // "brace-style": [2, "1tbs", { "allowSingleLine": true }]
+
+  // 数组和对象键值对最后一个逗号， never 参数：不能带末尾的逗号, always参数：必须带末尾的逗号，
+  // always-multiline：多行模式必须带逗号，单行模式不能带逗号
+  'comma-dangle': [2, 'only-multiline'],
+  // 控制逗号前后的空格
+  'comma-spacing': [2, {before: false, after: true}],
+  // 控制逗号在行尾出现还是在行首出现
+  // http://eslint.org/docs/rules/comma-style
+  'comma-style': [0, 'last'],
+  'max-len': [2, 120, 2],
+  curly: [0, 'multi'], // 单行无需大括号
+  // 强制方法必须返回值，TypeScript强类型，不配置
+  'consistent-return': 0,
+  'object-curly-newline': 0,
+  semi: 0, // 分号检查
+  'space-before-function-paren': 0, // ["error", "never"]
+  'func-names': ['error', 'never'],
+};
+
 module.exports = {
   root: true, // 停止父目录查找配置
-  parser: "babel-eslint", // "typescript-eslint-parser", "babel-eslint",
+  parser: '@babel/eslint-parser', // "typescript-eslint-parser", "babel-eslint",
   env: {
     es6: true,
-    browser: true,  // 浏览器环境中的全局变量
+    es2017: true,
+    es2020: true,
+    es2021: true,
+    browser: true, // 浏览器环境中的全局变量
+    worker: true,
     node: true,
     commonjs: true,
     mongo: true,
-    jest: true
+    jest: true,
+    jquery: true,
+  },
+  globals: {
+    XMLHttpRequest: true,
+    Blob: true,
+    Document: true,
+    FormData: true,
+    Dom: true,
+    $: true,
+    document: true,
+    window: true,
   },
   parserOptions: {
-    ecmaVersion: 6,
+    ecmaVersion: 'latest',
     sourceType: 'module',
     ecmaFeatures: {
-      jsx: true
-    }
+      jsx: true,
+    },
   },
+  plugins: [
+    // 插件，需安装好，配置时省略 eslint-plugin-
+    // babel,
+    // react,
+  ],
   extends: [
-    'airbnb' // 'eslint:recommended'
-    //'plugin:vue/essential',
-    //'@vue/airbnb'
+    // 继承规则 // 'airbnb', 'eslint:recommended'
+    'plugin:react/recommended',
+    'airbnb',
+    'plugin:prettier/recommended',
+    'plugin:import/recommended',
   ],
   rules: {
-    // Disable for console/alert
-		// 0 关闭 1 警告 2 报错 https://eslint.org/docs/rules/  中文网址：http://eslint.cn/docs/rules/
-    // "arrow-parens": [2, "as-needed"],
-		"arrow-parens": [2, "as-needed", {requireForBlockBody: false}],
-    "arrow-body-style": [2, "as-needed"],
-    'no-console': process.env.NODE_ENV === 'production' ? 'error' : 'off',
-    'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',
-    "quotes": [1, "single"],
-    "no-alert": 0,
-    "no-trailing-spaces": 0,
-    "nonblock-statement-body-position": 0, //[2, "beside"], // if else 强制单行
-    "block-spacing": 0, // 对象空格
-    "function-paren-newline": 0, // 函数参数换行
-    "linebreak-style": 0,
-    "lines-between-class-members": 0,
-    "class-methods-use-this": 0,
-    "indent": [2, 2, {"SwitchCase": 1}],
-    "object-curly-spacing": 0,
-    "no-plusplus": 0,
-    "no-multi-spaces": 0,
-    "no-trailing-spaces": 0,
-    "no-param-reassign": [0, {props: false }],
-    "no-param-reassign": ["warn", { "props": false }],
-    "no-use-before-define": [2, { "functions": false, "classes": true }],
-    "no-unused-expressions": ["error", { "allowShortCircuit": true }],
-    "no-underscore-dangle": 0,
-    "no-unused-vars": [0, { "vars": "local", "args": "after-used" }],
-    "generator-star-spacing": 0,
-    // if while function 后面的{必须与if在同一行，java风格。
-    // "brace-style": [2, "1tbs", { "allowSingleLine": true }]
-
-    // 数组和对象键值对最后一个逗号， never 参数：不能带末尾的逗号, always参数：必须带末尾的逗号，
-    // always-multiline：多行模式必须带逗号，单行模式不能带逗号
-    "comma-dangle": [2, "only-multiline"],
-    // 控制逗号前后的空格
-    "comma-spacing": [2, { "before": false, "after": true }],
-    // 控制逗号在行尾出现还是在行首出现
-    // http://eslint.org/docs/rules/comma-style
-    "comma-style": [0, "last"],
-    "max-len": [2, 120, 2],
-    "curly": [0, "multi"], // 单行无需大括号
-    // 强制方法必须返回值，TypeScript强类型，不配置
-    "consistent-return": 0,
-    "object-curly-newline": 0,
-    "semi": 0, // 分号检查
-    "space-before-function-paren": 0, // ["error", "never"]
-		"func-names": ["error", "never"]
+    ...rules,
   },
-  "plugins": [
-    "import"
+  overrides: [
+    {
+      files: ['src/**/*.js'],
+      extends: [
+        'plugin:react/recommended',
+        'airbnb-base',
+        'plugin:prettier/recommended',
+        'plugin:import/recommended'
+      ],
+      plugins: ['react'],
+      rules: {
+        ...rules,
+         'react/no-unknown-property': ['off'],
+        'react/jsx-key': ['off'],
+},
+    },
   ],
-  "settings": {
-    "import/parser": "babel-eslint",
-    "import/resolve": {
-      "moduleDirectory": ["node_modules", "src"]
-    }
-  },
-  "globals": {
-    "__DEV__": true,
-    "__OPTION__": true,
-    "window": true,
-    "document": true,
-    "Dom": true,
-    "$": true
-  }
-}
+};

package/.prettierignore

@@ -16,12 +16,10 @@ wiamap.yml
 
 package.json
 package-lock.json
+package
 yarn.lock
 
-node_modules/
-/packages/*/dist/
-/packages/*/doc/
-
-/dist/
-/doc/
-/.vscode/
+dist
+doc
+.vscode
+node_modules

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2013-present, Yuxi (Evan) You
+Copyright (c) 2015-present, Yan (Sibyl) Yu
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/babel.config.js

@@ -1,21 +1,47 @@
+/**
+ * 代码转换时，控制语法转换与功能补全
+ * 目标 node，超es6语法转换，不补全
+ * 用于默认转换和eslint
+ */
 const loose = true;
 
 const presets = [
+  // '@babel/preset-react', // 支持 jsx 语法，如果前端项目中使用jsx，需安装并设置
   [
-    '@babel/preset-env',
+    '@babel/preset-env', // 预设，已经包含大部分新语法
+    /*
+      1、影响语法转换与功能补全，不指定则将代码转为ES5语法，补全由useBuiltIns决定
+      2、指定目标targets，则目标环境已支持的语法、功能不转换、不补全，减少代码
+      3、库、后端打包，无需考虑语法转换和补全，目标设置为node，转换、补全留给前端项目完成
+      前端项目需考虑浏览器功能缺失，建议设置较低浏览器版本，避免功能不全报错
+      后端项目或库，需支持特定node版本，可设置node版本，引入补全代码，可支持特定版本。
+      */
     {
-			loose,
+      loose,
+      // targets: 'defaults', // '> 0.5%, last 2 versions, Firefox ESR, not dead'
       targets: {
-				// node: 'current' // 按系统安装的node版本作为目标
-        browsers: [
-          '>0.5%',
-          'last 2 versions',
-          'Firefox ESR',
-          'not ie <= 8',
-          'not dead',
-        ], // defaults
-			},
-      // useBuiltIns: 'usage'
+        // 浏览器设置规则请参加：https://github.com/browserslist/browserslist
+        // browsers: ['>1%', 'last 3 versions', 'Firefox ESR', 'ie >= 11'],
+        node: 'current', // 按系统安装的node版本作为目标，后台项目
+        // node: '14.0', // 指定兼容到node版本，避免低版本node无法运行，后端项目需要
+      },
+      /*
+      1、用于补全，false不补全，由外部polyfill或runtime corejs补全，否则运行报错
+      2、库、后端无需补全，但需开启runtime的 helpers，引用辅助函数代替内置，减少体积
+      3、usage 通过自动添加使用方法的的corejs引用实现补全，用于前端项目打包
+      如：require("core-js/modules/es.promise.js");
+      4、需安装 core-js，属于替换全局的补全方案
+      5、UMD页面加载库，需通过runtime的corejs补全，避免污染全局
+      */
+      // useBuiltIns: 'usage', // 'usage' | 'entry' | false, 缺省为 false
+      // usage 需安装并配置corejs版本，defaults to "2.0"
+      // corejs: `${require('core-js/package.json').version}`,
+      /*
+      1、是否将es6模块语法改成其他模块语法，如cjs
+      2、false则保留es6语法，可以被rollup或webpack打包时摇树，减少包大小
+      3、后端库不需要摇树，直接设置为cjs，除非前端库输出es6版本，方便用户输出时摇树
+      */
+      modules: false, // 'cjs' | 'auto' | false, 缺省 auto
     },
   ],
 ];
@@ -26,12 +52,40 @@ const plugins = [
   ['@babel/plugin-proposal-function-bind'],
   ['@babel/plugin-proposal-nullish-coalescing-operator'],
   ['@babel/plugin-proposal-optional-chaining'],
+  [
+    /* 
+    1、将语法转换用到的辅助函数（包括异步await）从内置改为外部runtime引用，避免重复代码
+    2、需安装 @babel/runtime-corejs3 是 @babel/runtime、runtime-corejs2 的升级版
+    3、corejs: 3，所有用到的es6功能（不管targets），通过runtime-corejs3引用实现补全。
+       umd打包页面加载库时，代替usage实现补全，不污染全局空间。
+    4、与usage不同的是转换方法名称，不污染全局空间，usage 引用core-js/modules模块，如
+      require("core-js/modules/es.promise.js"); 
+      替换为：
+      var _promise = require("@babel/runtime-corejs3/core-js-stable/promise");
+    5、usage 与 corjs并存时，自动用runtime替换core-js/modules模块    
+    6、usage时，不使用 runtime，文件引用大量 core-js/modules，使用后引用模块数大量减少
+    */
+    '@babel/plugin-transform-runtime',
+    {
+      // helpers: true, // 语法辅助函数，缺省 true，将内置改为对引用，减少文件大小
+      // corejs: 3, // false, 2, 3, 缺省 false.
+      // require("@babel/runtime/helpers/asyncToGenerator")
+      // 设置为 true/false 好像无变化
+      // regenerator: true, // asynt/await支持函数asyncToGenerator转换，缺省 true
+      // absoluteRuntime: false, // runtime 路径，缺省false
+      // 指定runtime 版本，如 runtime-corejs3@7.20.1，缺省 @babel/runtime@7.0.0
+      version: `^${require('@babel/runtime-corejs3/package.json').version}`,
+    },
+  ],
 ];
 
-module.exports = {presets, plugins};
-
-// "plugins": [
-//   "syntax-object-rest-spread",
-//   "transform-object-rest-spread",
-//   "transform-strict-mode"
-// ]
+module.exports = {
+  presets,
+  plugins,
+  only: ['./src'],
+  ignore: ['./dist', './lib'],
+  sourceMaps: false, // boolean | "inline" | "both"
+  sourceType: 'unambiguous', // "script" | "module" | "unambiguous" 缺省 "module"
+  comments: true, // 保留备注 缺省 true
+  minified: false, // Default: false，压缩代码
+};

package/babel.web.js

@@ -0,0 +1,86 @@
+/**
+ * 代码转换时，控制语法转换与功能补全
+ * umd 格式，es5语法，runtime 补全
+ */
+const loose = true;
+
+const presets = [
+  // '@babel/preset-react', // 支持 jsx 语法，如果前端项目中使用jsx，需安装并设置
+  [
+    '@babel/preset-env', // 预设，已经包含大部分新语法
+    /*
+      1、影响语法转换与功能补全，不指定则将代码转为ES5语法，补全由useBuiltIns决定
+      2、指定目标targets，则目标环境已支持的语法、功能不转换、不补全，减少代码
+      3、库、后端打包，无需考虑语法转换和补全，目标设置为node，转换、补全留给前端项目完成
+      前端项目需考虑浏览器功能缺失，建议设置较低浏览器版本，避免功能不全报错
+      后端项目或库，需支持特定node版本，可设置node版本，引入补全代码，可支持特定版本。
+      */
+    {
+      loose,
+      // targets: 'defaults', // '> 0.5%, last 2 versions, Firefox ESR, not dead'
+      // targets: 'defaults and supports es6-module', //
+      // targets: {
+      // 浏览器设置规则请参加：https://github.com/browserslist/browserslist
+      // browsers: ['>1%', 'last 2 versions', 'Firefox ESR', 'ie >= 11'],
+      // node: 'current', // 按系统安装的node版本作为目标，后台项目
+      // node: '14.0', // 指定兼容到node版本，避免低版本node无法运行，后端项目需要
+      // },
+      /*
+      1、用于补全，false不补全，由外部polyfill或runtime corejs补全，否则运行报错
+      2、库、后端无需补全，但需开启runtime的 helpers，引用辅助函数代替内置，减少体积
+      3、usage 通过自动添加使用方法的的corejs引用实现补全，用于前端项目打包
+      如：require("core-js/modules/es.promise.js");
+      4、需安装 core-js，属于替换全局的补全方案
+      5、UMD页面加载库，需通过runtime的corejs补全，避免污染全局
+      */
+      // useBuiltIns: 'usage', // 'usage' | 'entry' | false, 缺省为 false
+      // usage 需安装并配置corejs版本，defaults to "2.0"
+      // corejs: `${require('core-js/package.json').version}`,
+      /*
+      1、是否将es6模块语法改成其他模块语法，如cjs
+      2、false则保留es6语法，可以被rollup或webpack打包时摇树，减少包大小
+      3、后端库不需要摇树，直接设置为cjs，除非前端库输出es6版本，方便用户输出时摇树
+      */
+      modules: false, // 'cjs' | 'auto' | false, 缺省 auto
+    },
+  ],
+];
+
+const plugins = [
+  [
+    /* 
+    1、将语法转换用到的辅助函数（包括异步await）从内置改为外部runtime引用，避免重复代码
+    2、需安装 @babel/runtime-corejs3 是 @babel/runtime、runtime-corejs2 的升级版
+    3、corejs: 3，所有用到的es6功能（不管targets），通过runtime-corejs3引用实现补全。
+       umd打包页面加载库时，代替usage实现补全，不污染全局空间。
+    4、与usage不同的是转换方法名称，不污染全局空间，usage 引用core-js/modules模块，如
+      require("core-js/modules/es.promise.js"); 
+      替换为：
+      var _promise = require("@babel/runtime-corejs3/core-js-stable/promise");
+    5、usage 与 corjs并存时，自动用runtime替换core-js/modules模块    
+    6、usage时，不使用 runtime，文件引用大量 core-js/modules，使用后引用模块数大量减少
+    */
+    '@babel/plugin-transform-runtime',
+    {
+      // helpers: true, // 语法辅助函数，缺省 true，将内置改为对引用，减少文件大小
+      // corejs: 3, // false, 2, 3, 缺省 false.
+      // require("@babel/runtime/helpers/asyncToGenerator")
+      // 设置为 true/false 好像无变化
+      // regenerator: true, // asynt/await支持函数asyncToGenerator转换，缺省 true
+      // absoluteRuntime: false, // runtime 路径，缺省false
+      // 指定runtime 版本，如 runtime-corejs3@7.20.1，缺省 @babel/runtime@7.0.0
+      version: `^${require('@babel/runtime-corejs3/package.json').version}`,
+    },
+  ],
+];
+
+module.exports = {
+  presets,
+  plugins,
+  only: ['./src'],
+  ignore: ['./dist'],
+  sourceMaps: false, // boolean | "inline" | "both"
+  // sourceType: 'unambiguous', // "script" | "module" | "unambiguous" 缺省 "module"
+  comments: false, // 保留备注 缺省 true
+  minified: false, // Default: false，压缩代码
+};