sculp-js 1.15.1 → 1.17.0

package/dist/cjs/array.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/async.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/base64.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/clipboard.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/cloneDeep.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/cookie.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/date.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/dom.js

@@ -1,13 +1,11 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-var array = require('./array.js');
-var easing = require('./easing.js');
 var object = require('./object.js');
 var string = require('./string.js');
 var type = require('./type.js');
@@ -66,53 +64,6 @@ const setStyle = (el, key, val) => {
 function getStyle(el, key) {
   return getComputedStyle(el).getPropertyValue(key);
 }
-function smoothScroll(options) {
-  return new Promise(resolve => {
-    const defaults = {
-      el: document,
-      to: 0,
-      duration: 567,
-      easing: 'ease'
-    };
-    const { el, to, duration, easing: easing$1 } = object.objectAssign(defaults, options);
-    const htmlEl = document.documentElement;
-    const bodyEl = document.body;
-    const globalMode = el === window || el === document || el === htmlEl || el === bodyEl;
-    const els = globalMode ? [htmlEl, bodyEl] : [el];
-    const query = () => {
-      let value = 0;
-      array.arrayEach(els, el => {
-        if ('scrollTop' in el) {
-          value = el.scrollTop;
-          return false;
-        }
-      });
-      return value;
-    };
-    const update = val => {
-      els.forEach(el => {
-        if ('scrollTop' in el) {
-          el.scrollTop = val;
-        }
-      });
-    };
-    let startTime;
-    const startValue = query();
-    const length = to - startValue;
-    const easingFn = easing.easingFunctional(easing$1);
-    const render = () => {
-      const now = performance.now();
-      const passingTime = startTime ? now - startTime : 0;
-      const t = passingTime / duration;
-      const p = easingFn(t);
-      if (!startTime) startTime = now;
-      update(startValue + length * p);
-      if (t >= 1) resolve();
-      else requestAnimationFrame(render);
-    };
-    render();
-  });
-}
 /**
  * 获取元素样式属性的计算值
  * @param {HTMLElement} el
@@ -206,4 +157,3 @@ exports.hasClass = hasClass;
 exports.removeClass = removeClass;
 exports.select = select;
 exports.setStyle = setStyle;
-exports.smoothScroll = smoothScroll;

package/dist/cjs/download.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/file.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/func.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/index.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -32,8 +32,7 @@ var base64 = require('./base64.js');
 var validator = require('./validator.js');
 var variable = require('./variable.js');
 var cloneDeep = require('./cloneDeep.js');
-var easing = require('./easing.js');
-var concurrentLimit = require('./concurrentLimit.js');
+var isEqual = require('./isEqual.js');
 
 exports.arrayEach = array.arrayEach;
 exports.arrayEachAsync = array.arrayEachAsync;
@@ -59,7 +58,6 @@ exports.hasClass = dom.hasClass;
 exports.removeClass = dom.removeClass;
 exports.select = dom.select;
 exports.setStyle = dom.setStyle;
-exports.smoothScroll = dom.smoothScroll;
 exports.crossOriginDownload = download.crossOriginDownload;
 exports.downloadBlob = download.downloadBlob;
 exports.downloadData = download.downloadData;
@@ -181,9 +179,4 @@ exports.parseVarFromString = variable.parseVarFromString;
 exports.replaceVarFromString = variable.replaceVarFromString;
 exports.uniqueSymbol = variable.uniqueSymbol;
 exports.cloneDeep = cloneDeep.cloneDeep;
-exports.easingFunctional = easing.easingFunctional;
-exports.easingStringify = easing.easingStringify;
-exports.getEasing = easing.getEasing;
-exports.setEasing = easing.setEasing;
-exports.ConcurrentExecutor = concurrentLimit.ConcurrentExecutor;
-exports.concurrentLimit = concurrentLimit.concurrentLimit;
+exports.isEqual = isEqual.isEqual;

package/dist/cjs/isEqual.js

@@ -0,0 +1,210 @@
+/*!
+ * sculp-js v1.17.0
+ * (c) 2023-present chandq
+ * Released under the MIT License.
+ */
+
+'use strict';
+
+/**
+ * 使用位运算或常量定义常用 Tag，这里保持字符串以匹配 Object.prototype.toString
+ */
+const TAGS = {
+  MAP: '[object Map]',
+  SET: '[object Set]',
+  DATE: '[object Date]',
+  REGEXP: '[object RegExp]',
+  SYMBOL: '[object Symbol]',
+  ARRAY_BUFFER: '[object ArrayBuffer]',
+  DATA_VIEW: '[object DataView]',
+  ARGUMENTS: '[object Arguments]'
+};
+const { toString, hasOwnProperty } = Object.prototype;
+/**
+ * 获取对象类型的辅助函数
+ */
+const getTag = value => toString.call(value);
+/**
+ * @description 深度比较两个值是否相等（支持循环引用、各种内置对象类型）
+ * @performance
+ * 1. 快速路径：引用相等和 NaN 检查
+ * 2. 快速失败：优先比较 constructor、length 和 size
+ * 3. 惰性 getTag：仅在构造函数一致且非基础类型时获取详细类型
+ * * @example
+ * isEqual({ a: [1, 2] }, { a: [1, 2] }) // true
+ * isEqual(new Date(0), new Date(0)) // true
+ * isEqual(() => {}, () => {}) // false (不同引用)
+ * * @param value 要比较的值
+ * @param other 另一个要比较的值
+ * @returns {boolean} 是否深度相等
+ */
+function isEqual(value, other) {
+  return baseIsEqual(value, other);
+}
+function baseIsEqual(value, other, stack = undefined) {
+  // 1. 引用相等 (快速路径)
+  if (value === other) {
+    return true;
+  }
+  // 2. 处理 NaN
+  if (value !== value && other !== other) {
+    return true;
+  }
+  // 3. 基本类型与空值检查
+  // 如果不是对象且不是函数，或者其中之一为 null，直接返回 false
+  if (typeof value !== 'object' || value === null || typeof other !== 'object' || other === null) {
+    return false;
+  }
+  // 4. 【性能优化】构造函数检查 (Fail Fast)
+  // 大多数不等的情况在这里就能被拦截，避免昂贵的 getTag 操作
+  // 注意：Object.create(null) 的 constructor 为 undefined
+  const ctorA = value.constructor;
+  const ctorB = other.constructor;
+  // 严格检查：
+  // 1. 解决 class A {} vs class B {} (结构相同但类不同) -> false
+  // 2. 解决 {} vs Object.create(null) -> false
+  if (ctorA !== ctorB) {
+    return false;
+  }
+  // 5. 初始化栈 (惰性初始化)
+  if (!stack) {
+    stack = new WeakMap();
+  }
+  // 6. 循环引用检查
+  if (stack.has(value)) {
+    return stack.get(value) === other;
+  }
+  stack.set(value, other);
+  // 7. 具体类型分发
+  // 此时我们确定 value 和 other 都是非 null 的对象/函数
+  const tagA = getTag(value);
+  const tagB = getTag(other); // 只有在 constructor 检查通过或存疑时才走到这里
+  if (tagA !== tagB) {
+    return false;
+  }
+  let result = false;
+  switch (tagA) {
+    case TAGS.DATE:
+      result = +value === +other;
+      break;
+    case TAGS.REGEXP:
+      result = '' + value === '' + other;
+      break;
+    case TAGS.SYMBOL:
+      result = Symbol.prototype.valueOf.call(value) === Symbol.prototype.valueOf.call(other);
+      break;
+    case TAGS.ARRAY_BUFFER:
+      result = deepCompareArrayBuffer(value, other);
+      break;
+    case TAGS.DATA_VIEW:
+      result = deepCompareDataView(value, other);
+      break;
+    case TAGS.MAP:
+      result = deepCompareMap(value, other, stack);
+      break;
+    case TAGS.SET:
+      result = deepCompareSet(value, other, stack);
+      break;
+    case TAGS.ARGUMENTS: // Arguments 视为对象或数组处理，通常 Tag 相同即可进入通用对象逻辑
+    default:
+      // 处理 Array, TypedArray, Object
+      if (Array.isArray(value) || ArrayBuffer.isView(value)) {
+        result = deepCompareArray(value, other, stack);
+      } else {
+        result = deepCompareObject(value, other, stack);
+      }
+  }
+  // 清理栈并非必须，因为是 WeakMap，但对于逻辑完整性可以不做操作
+  return result;
+}
+function deepCompareArray(a, b, stack) {
+  const len = a.length;
+  if (len !== b.length) {
+    return false;
+  }
+  // 倒序遍历，微小的性能提升
+  let i = len;
+  while (i--) {
+    if (!baseIsEqual(a[i], b[i], stack)) {
+      return false;
+    }
+  }
+  return true;
+}
+function deepCompareArrayBuffer(a, b) {
+  if (a.byteLength !== b.byteLength) return false;
+  const viewA = new Uint8Array(a);
+  const viewB = new Uint8Array(b);
+  let i = a.byteLength;
+  while (i--) {
+    if (viewA[i] !== viewB[i]) return false;
+  }
+  return true;
+}
+function deepCompareDataView(a, b) {
+  // 1. 长度不等直接退出
+  if (a.byteLength !== b.byteLength) return false;
+  // 2. 偏移量不等直接退出
+  if (a.byteOffset !== b.byteOffset) return false;
+  // 3. 比较底层的 buffer 内容
+  return deepCompareArrayBuffer(a.buffer, b.buffer);
+}
+function deepCompareMap(a, b, stack) {
+  if (a.size !== b.size) return false;
+  for (const [key, val] of a) {
+    // 性能关键：Map key 比较。如果 key 是对象，需要 O(N) 查找吗？
+    // 规范里 Map.get 使用 SameValueZero 算法。
+    // 如果 key 是引用类型且引用不同，Map 视为不同 key。
+    // isEqual 的语义下，如果 key 是两个内容相同的不同对象，我们是否应该视为匹配？
+    // Lodash 的处理：是的，Map 的 key 也进行深度比较。这非常慢 (O(N^2))。
+    // 这里为了性能，我们先尝试直接 get，只有拿不到时（可能 key 需要深度对比）才去遍历（Lodash 策略）。
+    // 但为了保持 "超高性能" 且符合大多数业务场景，我们假设 Map key 的引用关系必须一致，
+    // 或者仅仅对 primitive key 比较。
+    // 这里实现一个折中方案：直接 get，如果 undefined 再深度查。
+    const otherVal = b.get(key);
+    if (otherVal === undefined && !b.has(key)) {
+      // 只有当 key 是对象且在 b 中找不到引用相同的 key 时，才启用这个极慢的路径
+      // 真正的完全深度比较逻辑非常复杂，此处保持高性能假设：Key 引用必须匹配
+      return false;
+    }
+    if (!baseIsEqual(val, otherVal, stack)) {
+      return false;
+    }
+  }
+  return true;
+}
+function deepCompareSet(a, b, stack) {
+  if (a.size !== b.size) return false;
+  for (const val of a) {
+    if (b.has(val)) continue;
+    // Set 中存储对象时的深度比较 (O(N^2) 复杂度风险)
+    let matchFound = false;
+    for (const otherVal of b) {
+      if (baseIsEqual(val, otherVal, stack)) {
+        matchFound = true;
+        break;
+      }
+    }
+    if (!matchFound) return false;
+  }
+  return true;
+}
+function deepCompareObject(a, b, stack) {
+  // 使用 Reflect.ownKeys 以支持 Symbol，这是现代前端健壮性的关键
+  const keysA = Reflect.ownKeys(a);
+  const keysB = Reflect.ownKeys(b);
+  if (keysA.length !== keysB.length) {
+    return false;
+  }
+  for (let i = 0; i < keysA.length; i++) {
+    const key = keysA[i];
+    // 必须检查 b 是否也有这个 key（防止原型链干扰，虽然 Reflect.ownKeys 已过滤）
+    // 以及值的深度比较
+    if (!hasOwnProperty.call(b, key) || !baseIsEqual(a[key], b[key], stack)) {
+      return false;
+    }
+  }
+  return true;
+}
+
+exports.isEqual = isEqual;

package/dist/cjs/math.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/number.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/object.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/path.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/qs.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/random.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/string.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/tooltip.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/tree.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/type.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/unique.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/url.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/validator.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/variable.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/cjs/watermark.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/array.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/async.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/base64.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/clipboard.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/cloneDeep.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/cookie.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/date.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/dom.js

@@ -1,12 +1,10 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
-import { arrayEach } from './array.js';
-import { easingFunctional } from './easing.js';
-import { objectEach, objectAssign } from './object.js';
+import { objectEach } from './object.js';
 import { stringKebabCase } from './string.js';
 import { isObject, isString } from './type.js';
 
@@ -64,53 +62,6 @@ const setStyle = (el, key, val) => {
 function getStyle(el, key) {
   return getComputedStyle(el).getPropertyValue(key);
 }
-function smoothScroll(options) {
-  return new Promise(resolve => {
-    const defaults = {
-      el: document,
-      to: 0,
-      duration: 567,
-      easing: 'ease'
-    };
-    const { el, to, duration, easing } = objectAssign(defaults, options);
-    const htmlEl = document.documentElement;
-    const bodyEl = document.body;
-    const globalMode = el === window || el === document || el === htmlEl || el === bodyEl;
-    const els = globalMode ? [htmlEl, bodyEl] : [el];
-    const query = () => {
-      let value = 0;
-      arrayEach(els, el => {
-        if ('scrollTop' in el) {
-          value = el.scrollTop;
-          return false;
-        }
-      });
-      return value;
-    };
-    const update = val => {
-      els.forEach(el => {
-        if ('scrollTop' in el) {
-          el.scrollTop = val;
-        }
-      });
-    };
-    let startTime;
-    const startValue = query();
-    const length = to - startValue;
-    const easingFn = easingFunctional(easing);
-    const render = () => {
-      const now = performance.now();
-      const passingTime = startTime ? now - startTime : 0;
-      const t = passingTime / duration;
-      const p = easingFn(t);
-      if (!startTime) startTime = now;
-      update(startValue + length * p);
-      if (t >= 1) resolve();
-      else requestAnimationFrame(render);
-    };
-    render();
-  });
-}
 /**
  * 获取元素样式属性的计算值
  * @param {HTMLElement} el
@@ -196,4 +147,4 @@ function select(element) {
   return selectedText;
 }
 
-export { addClass, getComputedCssVal, getStrWidthPx, getStyle, hasClass, removeClass, select, setStyle, smoothScroll };
+export { addClass, getComputedCssVal, getStrWidthPx, getStyle, hasClass, removeClass, select, setStyle };

package/dist/esm/download.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/esm/file.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.15.1
+ * sculp-js v1.17.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */