amos-tool 1.4.6 → 1.4.9

package/.prettierignore

@@ -1,2 +1,2 @@
-node_modules
-lib
+node_modules
+lib

package/.prettierrc

@@ -1,50 +1,50 @@
-{
-  "printWidth": 160,
-  "tabWidth": 2,
-  "useTabs": false,
-  "semi": true,
-  "singleQuote": true,
-  "parser": "babel",
-  "trailingComma": "none",
-  "bracketSpacing": true,
-  "jsxBracketSameLine": false,
-  "arrowParens": "avoid",
-  "requirePragma": false,
-  "proseWrap": "preserve",
-  "overrides": [
-    {
-      "files": ["*.json", ".eslintrc", ".tslintrc", ".prettierrc", ".tern-project", ".travis.yml"],
-      "options": {
-        "parser": "json",
-        "tabWidth": 2
-      }
-    },
-    {
-      "files": "*.css",
-      "options": {
-        "parser": "css",
-        "tabWidth": 2
-      }
-    },
-    {
-      "files": "*.{sass,scss}",
-      "options": {
-        "parser": "scss",
-        "tabWidth": 2
-      }
-    },
-    {
-      "files": "*.less",
-      "options": {
-        "parser": "less",
-        "tabWidth": 2
-      }
-    },
-    {
-      "files": "*.ts",
-      "options": {
-        "parser": "typescript"
-      }
-    }
-  ]
-}
+{
+  "printWidth": 160,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": true,
+  "parser": "babel",
+  "trailingComma": "none",
+  "bracketSpacing": true,
+  "jsxBracketSameLine": false,
+  "arrowParens": "avoid",
+  "requirePragma": false,
+  "proseWrap": "preserve",
+  "overrides": [
+    {
+      "files": ["*.json", ".eslintrc", ".tslintrc", ".prettierrc", ".tern-project", ".travis.yml"],
+      "options": {
+        "parser": "json",
+        "tabWidth": 2
+      }
+    },
+    {
+      "files": "*.css",
+      "options": {
+        "parser": "css",
+        "tabWidth": 2
+      }
+    },
+    {
+      "files": "*.{sass,scss}",
+      "options": {
+        "parser": "scss",
+        "tabWidth": 2
+      }
+    },
+    {
+      "files": "*.less",
+      "options": {
+        "parser": "less",
+        "tabWidth": 2
+      }
+    },
+    {
+      "files": "*.ts",
+      "options": {
+        "parser": "typescript"
+      }
+    }
+  ]
+}

package/README.md

@@ -2,6 +2,8 @@
 
   by ilex.h
 
+docs: [docs](https://unpkg.com/amos-tool@latest/docs/index.html)
+
 ## useage
 
 npm install --save amos-tool
@@ -276,6 +278,9 @@ const result2 = browserSupport(paramsList, limit);
   Log.error()
   Log.fatal()
 
+  // 展示 pkg 信息，不受 LogConfig 配置影响
+  Log.pkgInfo(name, version)
+
 ```
 
 ### store

package/apis/objectPath.md

@@ -1,129 +1,129 @@
-# objectPath
-
-## Usage
-
-```js
-var {objectPath} from 'amos-tool';
-
-var obj = {
-  a: {
-    b: "d",
-    c: ["e", "f"],
-    '\u1200': 'unicode key',
-    'dot.dot': 'key'
-  }
-};
-
-var objectPath = require("object-path");
-
-//get deep property
-objectPath.get(obj, "a.b");  //returns "d"
-objectPath.get(obj, ["a", "dot.dot"]);  //returns "key"
-objectPath.get(obj, 'a.\u1200');  //returns "unicode key"
-
-//get the first non-undefined value
-objectPath.coalesce(obj, ['a.z', 'a.d', ['a','b']], 'default');
-
-//empty a given path (but do not delete it) depending on their type,so it retains reference to objects and arrays.
-//functions that are not inherited from prototype are set to null.
-//object instances are considered objects and just own property names are deleted
-objectPath.empty(obj, 'a.b'); // obj.a.b is now ''
-objectPath.empty(obj, 'a.c'); // obj.a.c is now []
-objectPath.empty(obj, 'a'); // obj.a is now {}
-
-//works also with arrays
-objectPath.get(obj, "a.c.1");  //returns "f"
-objectPath.get(obj, ["a","c","1"]);  //returns "f"
-
-//can return a default value with get
-objectPath.get(obj, ["a.c.b"], "DEFAULT");  //returns "DEFAULT", since a.c.b path doesn't exists, if omitted, returns undefined
-
-//set
-objectPath.set(obj, "a.h", "m"); // or objectPath.set(obj, ["a","h"], "m");
-objectPath.get(obj, "a.h");  //returns "m"
-
-//set will create intermediate object/arrays
-objectPath.set(obj, "a.j.0.f", "m");
-
-//will insert values in array
-objectPath.insert(obj, "a.c", "m", 1); // obj.a.c = ["e", "m", "f"]
-
-//push into arrays (and create intermediate objects/arrays)
-objectPath.push(obj, "a.k", "o");
-
-//ensure a path exists (if it doesn't, set the default value you provide)
-objectPath.ensureExists(obj, "a.k.1", "DEFAULT");
-var oldVal = objectPath.ensureExists(obj, "a.b", "DEFAULT"); // oldval === "d"
-
-//deletes a path
-objectPath.del(obj, "a.b"); // obj.a.b is now undefined
-objectPath.del(obj, ["a","c",0]); // obj.a.c is now ['f']
-
-//tests path existence
-objectPath.has(obj, "a.b"); // true
-objectPath.has(obj, ["a","d"]); // false
-
-//bind object
-var model = objectPath({
-  a: {
-    b: "d",
-    c: ["e", "f"]
-  }
-});
-
-//now any method from above is supported directly w/o passing an object
-model.get("a.b");  //returns "d"
-model.get(["a.c.b"], "DEFAULT");  //returns "DEFAULT"
-model.del("a.b"); // obj.a.b is now undefined
-model.has("a.b"); // false
-
-```
-
-### How `object-path` deals with inherited properties
-
-By default `object-path` will only access an object's own properties. Look at the following example:
-
-```js
-var proto = {
-  notOwn: {prop: 'a'}
-}
-var obj = Object.create(proto);
-
-//This will return undefined (or the default value you specified), because notOwn is
-//an inherited property
-objectPath.get(obj, 'notOwn.prop');
-
-//This will set the property on the obj instance and not the prototype.
-//In other words proto.notOwn.prop === 'a' and obj.notOwn.prop === 'b'
-objectPath.set(obj, 'notOwn.prop', 'b');
-```
-
-To configure `object-path` to also deal with inherited properties, you need to create a new instance and specify
-the `includeInheritedProps = true` in the options object:
-
-```js
-var objectPath = require("object-path");
-var objectPathWithInheritedProps = objectPath.create({includeInheritedProps: true})
-```
-
-Alternatively, `object-path` exposes an instance already configured to handle inherited properties (`objectPath.withInheritedProps`):
-
-```js
-var objectPath = require("object-path");
-var objectPathWithInheritedProps = objectPath.withInheritedProps
-```
-
-Once you have the new instance, you can access inherited properties as you access other properties:
-
-```js
-var proto = {
-  notOwn: {prop: 'a'}
-}
-var obj = Object.create(proto);
-
-//This will return 'a'
-objectPath.withInheritedProps.get(obj, 'notOwn.prop');
-
-//This will set proto.notOwn.prop to 'b'
-objectPath.set(obj, 'notOwn.prop', 'b');
-```
+# objectPath
+
+## Usage
+
+```js
+var {objectPath} from 'amos-tool';
+
+var obj = {
+  a: {
+    b: "d",
+    c: ["e", "f"],
+    '\u1200': 'unicode key',
+    'dot.dot': 'key'
+  }
+};
+
+var objectPath = require("object-path");
+
+//get deep property
+objectPath.get(obj, "a.b");  //returns "d"
+objectPath.get(obj, ["a", "dot.dot"]);  //returns "key"
+objectPath.get(obj, 'a.\u1200');  //returns "unicode key"
+
+//get the first non-undefined value
+objectPath.coalesce(obj, ['a.z', 'a.d', ['a','b']], 'default');
+
+//empty a given path (but do not delete it) depending on their type,so it retains reference to objects and arrays.
+//functions that are not inherited from prototype are set to null.
+//object instances are considered objects and just own property names are deleted
+objectPath.empty(obj, 'a.b'); // obj.a.b is now ''
+objectPath.empty(obj, 'a.c'); // obj.a.c is now []
+objectPath.empty(obj, 'a'); // obj.a is now {}
+
+//works also with arrays
+objectPath.get(obj, "a.c.1");  //returns "f"
+objectPath.get(obj, ["a","c","1"]);  //returns "f"
+
+//can return a default value with get
+objectPath.get(obj, ["a.c.b"], "DEFAULT");  //returns "DEFAULT", since a.c.b path doesn't exists, if omitted, returns undefined
+
+//set
+objectPath.set(obj, "a.h", "m"); // or objectPath.set(obj, ["a","h"], "m");
+objectPath.get(obj, "a.h");  //returns "m"
+
+//set will create intermediate object/arrays
+objectPath.set(obj, "a.j.0.f", "m");
+
+//will insert values in array
+objectPath.insert(obj, "a.c", "m", 1); // obj.a.c = ["e", "m", "f"]
+
+//push into arrays (and create intermediate objects/arrays)
+objectPath.push(obj, "a.k", "o");
+
+//ensure a path exists (if it doesn't, set the default value you provide)
+objectPath.ensureExists(obj, "a.k.1", "DEFAULT");
+var oldVal = objectPath.ensureExists(obj, "a.b", "DEFAULT"); // oldval === "d"
+
+//deletes a path
+objectPath.del(obj, "a.b"); // obj.a.b is now undefined
+objectPath.del(obj, ["a","c",0]); // obj.a.c is now ['f']
+
+//tests path existence
+objectPath.has(obj, "a.b"); // true
+objectPath.has(obj, ["a","d"]); // false
+
+//bind object
+var model = objectPath({
+  a: {
+    b: "d",
+    c: ["e", "f"]
+  }
+});
+
+//now any method from above is supported directly w/o passing an object
+model.get("a.b");  //returns "d"
+model.get(["a.c.b"], "DEFAULT");  //returns "DEFAULT"
+model.del("a.b"); // obj.a.b is now undefined
+model.has("a.b"); // false
+
+```
+
+### How `object-path` deals with inherited properties
+
+By default `object-path` will only access an object's own properties. Look at the following example:
+
+```js
+var proto = {
+  notOwn: {prop: 'a'}
+}
+var obj = Object.create(proto);
+
+//This will return undefined (or the default value you specified), because notOwn is
+//an inherited property
+objectPath.get(obj, 'notOwn.prop');
+
+//This will set the property on the obj instance and not the prototype.
+//In other words proto.notOwn.prop === 'a' and obj.notOwn.prop === 'b'
+objectPath.set(obj, 'notOwn.prop', 'b');
+```
+
+To configure `object-path` to also deal with inherited properties, you need to create a new instance and specify
+the `includeInheritedProps = true` in the options object:
+
+```js
+var objectPath = require("object-path");
+var objectPathWithInheritedProps = objectPath.create({includeInheritedProps: true})
+```
+
+Alternatively, `object-path` exposes an instance already configured to handle inherited properties (`objectPath.withInheritedProps`):
+
+```js
+var objectPath = require("object-path");
+var objectPathWithInheritedProps = objectPath.withInheritedProps
+```
+
+Once you have the new instance, you can access inherited properties as you access other properties:
+
+```js
+var proto = {
+  notOwn: {prop: 'a'}
+}
+var obj = Object.create(proto);
+
+//This will return 'a'
+objectPath.withInheritedProps.get(obj, 'notOwn.prop');
+
+//This will set proto.notOwn.prop to 'b'
+objectPath.set(obj, 'notOwn.prop', 'b');
+```

package/index.d.ts

@@ -169,11 +169,14 @@ declare namespace LocationParam {
   export function parse(paramString: string): object;
   export function paramSearch(_name: string, target: string): void;
   /**
-   * 获取 location 中的所有参数
+   * - 获取 location 中的所有参数
+   * - 对 location.href 进行查找，支持 hash 方式的路由
    */
   export function getLocationParams(): object;
   /**
-   * 获取 location 中的参数
+   * - 获取 location 中的参数。
+   * - 采用 location.search 进行查找，因此，如果采用 react-router hash 方式，将无法获取到参数
+   * - why not support hash router? because in hash router location.search=''
    * @param name
    */
   export function getLocationParamByName(name: string): string | null;
@@ -567,7 +570,7 @@ export function objectValues(obj): any;
  * @param obj 目标对象
  * @param keys 需要删除的键
  * @example
- *  omit({ name: 'ilex', age: 16 }, ['age']) // { name: 'ilex' }
+ *  omit({ name: 'ilex', age: 16 }, ['age']); // { name: 'ilex' }
  */
 export function omit(obj: object, keys: string | Array<String>): any;
 
@@ -576,7 +579,8 @@ export function omit(obj: object, keys: string | Array<String>): any;
  * @param obj
  * @param keys
  * @example
- *  omit({ name: 'ilex', age: 16 }, ['age']) // { age: 16 }
+ *  pick({ name: 'ilex', age: 16 }, ['age']); // { age: 16 }
+ *  pick({ name: 'ilex', age: 16 }, ['']); // {}
  */
 export function pick(obj: Object | Function, keys: string | Array<String>): Object;
 /**
@@ -985,6 +989,12 @@ declare namespace utils {
    * @return target
    */
   export function mergeAll(targetAndSources: Array<any>, overwrite?: boolean): object | Array<any>;
+  /**
+   * 比较 objTarget 中的所有属性值，是否在 objSource 中相等
+   * @param objSource
+   * @param objTarget
+   */
+  export function subObjectEqual(objSource: {}, objTarget: {}): Boolean;
 }
 
 declare namespace throttleDebounce {
@@ -1060,3 +1070,12 @@ declare const arrayMove: {
 	// TODO: Remove this for the next major release
 	default: typeof arrayMove;
 };
+
+declare namespace flat {
+  /**
+   * 获取树结构数据 flat keys
+   * @param item
+   * @param options
+   */
+  export function getTreeFlatKeys(item: Object | any[], options = { uniqueKey: 'key', childrenKey: 'children' }): String[] | Number[];
+}

package/index.js

@@ -1,3 +1,3 @@
-var amostool = require('./lib/amostool');
-
-module.exports = amostool;
+var amostool = require('./lib/amostool');
+
+module.exports = amostool;

package/lib/_browser.js

@@ -1,25 +1,27 @@
 "use strict";
+
 var Browser = {
   isFirefox: function() {
-    return "undefined" != typeof InstallTrigger
+    return "undefined" != typeof InstallTrigger;
   },
   isIE: function() {
-    return !!document.documentMode
+    return !!document.documentMode;
   },
   isEdge: function() {
-    return !Browser.isIE() && !!window.StyleMedia
+    return !Browser.isIE() && !!window.StyleMedia;
   },
   isChrome: function() {
-    return !!window.chrome && !!window.chrome.webstore
+    return !!window.chrome && !!window.chrome.webstore;
   },
   isSafari: function() {
-    return 0 < Object.prototype.toString.call(window.HTMLElement).indexOf("Constructor") || -1 !== navigator.userAgent.toLowerCase().indexOf("safari")
+    return Object.prototype.toString.call(window.HTMLElement).indexOf("Constructor") > 0 || -1 !== navigator.userAgent.toLowerCase().indexOf("safari");
   },
   wp: function() {
-    navigator.userAgent.match(/Windows Phone ([\d.]+)/)
+    navigator.userAgent.match(/Windows Phone ([\d.]+)/);
   },
   android: function() {
-    navigator.userAgent.match(/(Android);?[\s\/]+([\d.]+)?/)
+    navigator.userAgent.match(/(Android);?[\s\/]+([\d.]+)?/);
   }
 };
-module.exports = Browser;
+
+module.exports = Browser;

package/lib/_clone.js

@@ -1,74 +1,79 @@
 "use strict";
 
-function _typeof(e) {
-  return (_typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(e) {
-    return typeof e
-  } : function(e) {
-    return e && "function" == typeof Symbol && e.constructor === Symbol && e !== Symbol.prototype ? "symbol" : typeof e
-  })(e)
-}
-var findType = function(e) {
-  return Object.prototype.toString.call(e).match(/\[object (\w+)\]/)[1]
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault"), _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof")), findType = function(e) {
+  return Object.prototype.toString.call(e).match(/\[object (\w+)\]/)[1];
 };
 
 function findAllType(e) {
   switch (Object.prototype.toString.call(e)) {
-    case "[object Date]":
-      return "date";
-    case "[object RegExp]":
-      return "regexp";
-    case "[object Arguments]":
-      return "arguments";
-    case "[object Array]":
-      return "array";
-    case "[object Error]":
-      return "error"
+   case "[object Date]":
+    return "date";
+
+   case "[object RegExp]":
+    return "regexp";
+
+   case "[object Arguments]":
+    return "arguments";
+
+   case "[object Array]":
+    return "array";
+
+   case "[object Error]":
+    return "error";
   }
-  return null === e ? "null" : void 0 === e ? "undefined" : e && 1 === e.nodeType ? "element" : _typeof(e = e.valueOf ? e.valueOf() : Object.prototype.valueOf.apply(e))
+  return null === e ? "null" : void 0 === e ? "undefined" : e && 1 === e.nodeType ? "element" : (e = e.valueOf ? e.valueOf() : Object.prototype.valueOf.apply(e), 
+  (0, _typeof2.default)(e));
 }
-var simpleClone = function e(t) {
-    switch (findType(t)) {
-      case "Object":
-        var r = {};
-        for (var n in t) t.hasOwnProperty(n) && (r[n] = e(t[n]));
-        return r;
-      case "Array":
-        return t.slice()
-    }
-    return t
-  },
-  clone = function(t) {
-    try {
-      return JSON.parse(JSON.stringify(t, function(e, t) {
-        return "function" == typeof t ? t.toString() : t
-      }))
-    } catch (e) {
-      return t
-    }
-  },
-  cloneAll = function t(r) {
-    switch (findAllType(r)) {
-      case "object":
-        var n = {};
-        return Object.keys(r).forEach(function(e) {
-          "$" !== e.charAt(0) && (n[e] = t(r[e]))
-        }), n;
-      case "element":
-        return r.cloneNode(!0);
-      case "array":
-        for (var e = new Array(r.length), o = 0, c = r.length; o < c; o++) e[o] = t(r[o]);
-        return e;
-      case "regexp":
-        var l = "";
-        return l += r.multiline ? "m" : "", l += r.global ? "g" : "", l += r.ignoreCase ? "i" : "", new RegExp(r.source, l);
-      case "date":
-        return new Date(r.getTime());
-      default:
-        return r
-    }
-  };
+
+var simpleClone = function e(r) {
+  switch (findType(r)) {
+   case "Object":
+    var t = {};
+    for (var n in r) r.hasOwnProperty(n) && (t[n] = e(r[n]));
+    return t;
+
+   case "Array":
+    return r.slice();
+  }
+  return r;
+}, clone = function(e) {
+  try {
+    return JSON.parse(JSON.stringify(e, (function(e, r) {
+      return "function" == typeof r ? r.toString() : r;
+    })));
+  } catch (r) {
+    return e;
+  }
+}, cloneAll = function e(r) {
+  switch (findAllType(r)) {
+   case "object":
+    var t = {};
+    return Object.keys(r).forEach((function(n) {
+      "$" !== n.charAt(0) && (t[n] = e(r[n]));
+    })), t;
+
+   case "element":
+    return r.cloneNode(!0);
+
+   case "array":
+    for (var n = new Array(r.length), o = 0, l = r.length; o < l; o++) n[o] = e(r[o]);
+    return n;
+
+   case "regexp":
+    var a = "";
+    return a += r.multiline ? "m" : "", a += r.global ? "g" : "", a += r.ignoreCase ? "i" : "", 
+    new RegExp(r.source, a);
+
+   case "date":
+    return new Date(r.getTime());
+
+   default:
+    return r;
+  }
+};
+
 module.exports = {
   simpleClone: simpleClone,
   clone: clone,
   cloneAll: cloneAll
-};
+};