sculp-js 1.7.1 → 1.8.0

package/README.md

@@ -7,7 +7,7 @@
 
 # sculp-js
 
-[API文档](https://chandq.github.io/sculp-js/)
+[API Doc](https://chandq.github.io/sculp-js/)
 
 > TS + Rollup, native implementation, without relying on any third-party libraries, outputs products of three module modes: ESM, CJS, and UMD. sculp-js only used to Web environment, @sculp/core can be used to Web、Node.js、Mini Program.
 
@@ -29,13 +29,14 @@
   - isNumber
   - isUndefined
   - isNull
-  - isNullOrUnDef
+  - isNullish
   - isPrimitive
   - isFunction
   - isObject
   - isArray
   - typeIs
   - isJsonString
+  - isEmpty
 
 - encode/decode
 
@@ -60,11 +61,12 @@
 
   - isPlainObject
   - objectHas
-  - objectAssign 合并
+  - objectAssign
   - objectEach
   - objectEachAsync
   - objectGet
   - cloneDeep
+  - isEqual
 
 - Number
 

package/lib/cjs/array.js

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

package/lib/cjs/async.js

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

package/lib/cjs/base64.js

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

package/lib/cjs/clipboard.js

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

package/lib/cjs/cookie.js

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

package/lib/cjs/date.js

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

package/lib/cjs/dom.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.7.0
+ * sculp-js v1.8.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -118,31 +118,6 @@ function smoothScroll(options) {
         render();
     });
 }
-const domReadyCallbacks = [];
-const eventType = 'DOMContentLoaded';
-const listener = () => {
-    domReadyCallbacks.forEach(callback => callback());
-    domReadyCallbacks.length = 0;
-    document.removeEventListener(eventType, listener);
-};
-document.addEventListener(eventType, listener);
-let readied = false;
-function isDomReady() {
-    if (readied)
-        return true;
-    readied = ['complete', 'loaded', 'interactive'].indexOf(document.readyState) !== -1;
-    return readied;
-}
-function onDomReady(callback) {
-    // document readied
-    if (isDomReady()) {
-        setTimeout(callback, 0);
-    }
-    // listen document to ready
-    else {
-        domReadyCallbacks.push(callback);
-    }
-}
 /**
  * 获取元素样式属性的计算值
  * @param {HTMLElement} el
@@ -190,8 +165,6 @@ exports.getComputedCssVal = getComputedCssVal;
 exports.getStrWidthPx = getStrWidthPx;
 exports.getStyle = getStyle;
 exports.hasClass = hasClass;
-exports.isDomReady = isDomReady;
-exports.onDomReady = onDomReady;
 exports.removeClass = removeClass;
 exports.setStyle = setStyle;
 exports.smoothScroll = smoothScroll;

package/lib/cjs/download.js

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

package/lib/cjs/easing.js

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

package/lib/cjs/file.js

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

package/lib/cjs/func.js

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

package/lib/cjs/index.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.7.0
+ * sculp-js v1.8.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -55,8 +55,6 @@ exports.getComputedCssVal = dom.getComputedCssVal;
 exports.getStrWidthPx = dom.getStrWidthPx;
 exports.getStyle = dom.getStyle;
 exports.hasClass = dom.hasClass;
-exports.isDomReady = dom.isDomReady;
-exports.onDomReady = dom.onDomReady;
 exports.removeClass = dom.removeClass;
 exports.setStyle = dom.setStyle;
 exports.smoothScroll = dom.smoothScroll;
@@ -66,6 +64,7 @@ exports.downloadData = download.downloadData;
 exports.downloadHref = download.downloadHref;
 exports.downloadURL = download.downloadURL;
 exports.cloneDeep = object.cloneDeep;
+exports.isEqual = object.isEqual;
 exports.isPlainObject = object.isPlainObject;
 exports.objectAssign = object.objectAssign;
 exports.objectEach = object.objectEach;
@@ -102,6 +101,7 @@ exports.isJsonString = type.isJsonString;
 exports.isNaN = type.isNaN;
 exports.isNull = type.isNull;
 exports.isNullOrUnDef = type.isNullOrUnDef;
+exports.isNullish = type.isNullOrUnDef;
 exports.isNumber = type.isNumber;
 exports.isObject = type.isObject;
 exports.isPrimitive = type.isPrimitive;
@@ -138,7 +138,6 @@ exports.UNIQUE_NUMBER_SAFE_LENGTH = unique.UNIQUE_NUMBER_SAFE_LENGTH;
 exports.uniqueNumber = unique.uniqueNumber;
 exports.uniqueString = unique.uniqueString;
 exports.tooltipEvent = tooltip.tooltipEvent;
-exports.buildTree = tree.buildTree;
 exports.flatTree = tree.flatTree;
 exports.forEachDeep = tree.forEachDeep;
 exports.formatTree = tree.formatTree;

package/lib/cjs/math.js

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

package/lib/cjs/number.js

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

package/lib/cjs/object.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.7.0
+ * sculp-js v1.8.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -83,7 +83,7 @@ function objectPick(obj, keys) {
     return obj2;
 }
 /**
- * 对象祛除
+ * 对象去除
  * @param {O} obj
  * @param {K} keys
  * @returns {Pick<O, ArrayElements<K>>}
@@ -168,6 +168,13 @@ function objectFill(source, target, fillable) {
     });
     return source;
 }
+/**
+ * 获取对象指定层级下的属性值（现在可用ES6+的可选链?.来替代）
+ * @param {AnyObject} obj
+ * @param {string} path
+ * @param {boolean} strict
+ * @returns
+ */
 function objectGet(obj, path, strict = false) {
     path = path.replace(/\[(\w+)\]/g, '.$1');
     path = path.replace(/^\./, '');
@@ -198,12 +205,16 @@ function objectGet(obj, path, strict = false) {
 }
 /**
  * 深拷贝堪称完全体 即：任何类型的数据都会被深拷贝
+ *
+ * 包含对null、原始值、对象循环引用的处理
+ *
+ * 对Map、Set、ArrayBuffer、Date、RegExp、Array、Object及原型链属性方法执行深拷贝
  * @param {T} source
  * @param {WeakMap} map
  * @returns {T}
  */
 function cloneDeep(source, map = new WeakMap()) {
-    // 处理原始类型（非对象/数组）和 null/undefined
+    // 处理原始类型和 null/undefined
     if (source === null || typeof source !== 'object') {
         return source;
     }
@@ -211,28 +222,33 @@ function cloneDeep(source, map = new WeakMap()) {
     if (map.has(source)) {
         return map.get(source);
     }
-    // 处理 Date 类型
+    // 处理 ArrayBuffer
+    if (source instanceof ArrayBuffer) {
+        const copy = new ArrayBuffer(source.byteLength);
+        new Uint8Array(copy).set(new Uint8Array(source));
+        map.set(source, copy);
+        return copy;
+    }
+    // 处理 DataView 和 TypedArray (Uint8Array 等)
+    if (ArrayBuffer.isView(source)) {
+        const constructor = source.constructor;
+        const bufferCopy = cloneDeep(source.buffer, map);
+        return new constructor(bufferCopy, source.byteOffset, source.length);
+    }
+    // 处理 Date 对象
     if (source instanceof Date) {
         const copy = new Date(source.getTime());
         map.set(source, copy);
         return copy;
     }
-    // 处理 RegExp 类型
+    // 处理 RegExp 对象
     if (source instanceof RegExp) {
         const copy = new RegExp(source.source, source.flags);
+        copy.lastIndex = source.lastIndex; // 保留匹配状态
         map.set(source, copy);
         return copy;
     }
-    // 处理数组类型
-    if (Array.isArray(source)) {
-        const copy = [];
-        map.set(source, copy);
-        for (const item of source) {
-            copy.push(cloneDeep(item, map));
-        }
-        return copy;
-    }
-    // 处理 Map 类型
+    // 处理 Map
     if (source instanceof Map) {
         const copy = new Map();
         map.set(source, copy);
@@ -241,7 +257,7 @@ function cloneDeep(source, map = new WeakMap()) {
         });
         return copy;
     }
-    // 处理 Set 类型
+    // 处理 Set
     if (source instanceof Set) {
         const copy = new Set();
         map.set(source, copy);
@@ -250,24 +266,174 @@ function cloneDeep(source, map = new WeakMap()) {
         });
         return copy;
     }
-    // 处理 ArrayBuffer 类型
-    if (source instanceof ArrayBuffer) {
-        const copy = new ArrayBuffer(source.byteLength);
-        new Uint8Array(copy).set(new Uint8Array(source));
+    // 处理数组 (包含稀疏数组)
+    if (Array.isArray(source)) {
+        const copy = Array.from({ length: source.length });
         map.set(source, copy);
+        // 克隆所有有效索引
+        for (let i = 0; i < source.length; i++) {
+            if (i in source) {
+                // 保留空位
+                copy[i] = cloneDeep(source[i], map);
+            }
+        }
+        // 克隆数组的自定义属性
+        const descriptors = Object.getOwnPropertyDescriptors(source);
+        for (const key of Reflect.ownKeys(descriptors)) {
+            Object.defineProperty(copy, key, {
+                ...descriptors[key],
+                value: cloneDeep(descriptors[key].value, map)
+            });
+        }
         return copy;
     }
-    // 处理普通对象（包括原型链继承）
+    // 处理普通对象和类实例
     const copy = Object.create(Object.getPrototypeOf(source));
     map.set(source, copy);
-    for (const key of Reflect.ownKeys(source)) {
-        const value = source[key];
-        copy[key] = cloneDeep(value, map);
+    const descriptors = Object.getOwnPropertyDescriptors(source);
+    for (const key of Reflect.ownKeys(descriptors)) {
+        const descriptor = descriptors[key];
+        if ('value' in descriptor) {
+            // 克隆数据属性
+            descriptor.value = cloneDeep(descriptor.value, map);
+        }
+        else {
+            // 处理访问器属性 (getter/setter)
+            if (descriptor.get) {
+                descriptor.get = cloneDeep(descriptor.get, map);
+            }
+            if (descriptor.set) {
+                descriptor.set = cloneDeep(descriptor.set, map);
+            }
+        }
+        Object.defineProperty(copy, key, descriptor);
     }
     return copy;
 }
+/**
+ * 比较两值是否相等，适用所有数据类型
+ * @param {Comparable} a
+ * @param {Comparable} b
+ * @returns {boolean}
+ */
+function isEqual(a, b) {
+    return deepEqual(a, b);
+}
+function deepEqual(a, b, compared = new WeakMap()) {
+    // 相同值快速返回
+    if (Object.is(a, b))
+        return true;
+    // 类型不同直接返回false
+    const typeA = Object.prototype.toString.call(a);
+    const typeB = Object.prototype.toString.call(b);
+    if (typeA !== typeB)
+        return false;
+    // 只缓存对象类型
+    if (type.isObject(a) && type.isObject(b)) {
+        if (compared.has(a))
+            return compared.get(a) === b;
+        compared.set(a, b);
+        compared.set(b, a);
+    }
+    // 处理特殊对象类型
+    switch (typeA) {
+        case '[object Date]':
+            return a.getTime() === b.getTime();
+        case '[object RegExp]':
+            return a.toString() === b.toString();
+        case '[object Map]':
+            return compareMap(a, b, compared);
+        case '[object Set]':
+            return compareSet(a, b, compared);
+        case '[object ArrayBuffer]':
+            return compareArrayBuffer(a, b);
+        case '[object DataView]':
+            return compareDataView(a, b, compared);
+        case '[object Int8Array]':
+        case '[object Uint8Array]':
+        case '[object Uint8ClampedArray]':
+        case '[object Int16Array]':
+        case '[object Uint16Array]':
+        case '[object Int32Array]':
+        case '[object Uint32Array]':
+        case '[object Float32Array]':
+        case '[object Float64Array]':
+            return compareTypedArray(a, b, compared);
+        case '[object Object]':
+            return compareObjects(a, b, compared);
+        case '[object Array]':
+            return compareArrays(a, b, compared);
+    }
+    return false;
+}
+// 辅助比较函数
+function compareMap(a, b, compared) {
+    if (a.size !== b.size)
+        return false;
+    for (const [key, value] of a) {
+        if (!b.has(key) || !deepEqual(value, b.get(key), compared))
+            return false;
+    }
+    return true;
+}
+function compareSet(a, b, compared) {
+    if (a.size !== b.size)
+        return false;
+    for (const value of a) {
+        let found = false;
+        for (const bValue of b) {
+            if (deepEqual(value, bValue, compared)) {
+                found = true;
+                break;
+            }
+        }
+        if (!found)
+            return false;
+    }
+    return true;
+}
+function compareArrayBuffer(a, b) {
+    if (a.byteLength !== b.byteLength)
+        return false;
+    return new DataView(a).getInt32(0) === new DataView(b).getInt32(0);
+}
+function compareDataView(a, b, compared) {
+    return a.byteLength === b.byteLength && deepEqual(new Uint8Array(a.buffer), new Uint8Array(b.buffer), compared);
+}
+function compareTypedArray(a, b, compared) {
+    return a.byteLength === b.byteLength && deepEqual(Array.from(a), Array.from(b), compared);
+}
+function compareObjects(a, b, compared) {
+    const keysA = Reflect.ownKeys(a);
+    const keysB = Reflect.ownKeys(b);
+    if (keysA.length !== keysB.length)
+        return false;
+    for (const key of keysA) {
+        if (!keysB.includes(key))
+            return false;
+        if (!deepEqual(a[key], b[key], compared))
+            return false;
+    }
+    // 原型链比较
+    return Object.getPrototypeOf(a) === Object.getPrototypeOf(b);
+}
+function compareArrays(a, b, compared) {
+    // 增加有效索引检查
+    const keysA = Object.keys(a).map(Number);
+    const keysB = Object.keys(b).map(Number);
+    if (keysA.length !== keysB.length)
+        return false;
+    // 递归比较每个元素
+    for (let i = 0; i < a.length; i++) {
+        if (!deepEqual(a[i], b[i], compared))
+            return false;
+    }
+    // 比较数组对象的其他属性
+    return compareObjects(a, b, compared);
+}
 
 exports.cloneDeep = cloneDeep;
+exports.isEqual = isEqual;
 exports.isPlainObject = isPlainObject;
 exports.objectAssign = objectAssign;
 exports.objectEach = objectEach;

package/lib/cjs/path.js

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

package/lib/cjs/qs.js

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

package/lib/cjs/random.js

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

package/lib/cjs/string.js

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

package/lib/cjs/tooltip.js

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