sculp-js 1.18.2 → 1.19.0

package/README.md

@@ -120,17 +120,94 @@ const cloned = cloneDeep(original);
 
 ## 📦 Module Formats
 
+### Named Imports (Recommended)
+
 ```js
-// ES Modules (recommended)
-import { cloneDeep } from 'sculp-js';
+// ES Modules - Named imports (tree-shaking friendly)
+import { cloneDeep, forEachDeep } from 'sculp-js';
+
+// CommonJS - Named imports
+const { cloneDeep, forEachDeep } = require('sculp-js');
+```
 
-// Individual module imports
-import cloneDeep from 'sculp-js/cloneDeep';
+### Default Import (Full Library)
 
-// CommonJS
-const { cloneDeep } = require('sculp-js');
+```js
+// ES Modules - Default import
+import sculp from 'sculp-js';
+const { cloneDeep, forEachDeep } = sculp;
+
+// CommonJS - Default import
+const sculp = require('sculp-js');
+const { cloneDeep, forEachDeep } = sculp;
 ```
 
+### Module-Specific Imports
+
+Import specific modules for better tree-shaking and smaller bundle sizes:
+
+```js
+// ES Modules - Import specific modules
+import array from 'sculp-js/array';
+import string from 'sculp-js/string';
+import type from 'sculp-js/type';
+import date from 'sculp-js/date';
+import object from 'sculp-js/object';
+import math from 'sculp-js/math';
+import validator from 'sculp-js/validator';
+// ... and more
+
+// CommonJS - Import specific modules
+const array = require('sculp-js/array');
+const string = require('sculp-js/string');
+const type = require('sculp-js/type');
+
+// Usage examples
+import array from 'sculp-js/array';
+array.arrayEach([1, 2, 3], val => console.log(val));
+
+import string from 'sculp-js/string';
+const camelCase = string.stringCamelCase('hello-world'); // 'helloWorld'
+
+import validator from 'sculp-js/validator';
+if (validator.isEmail('test@example.com')) {
+  console.log('Valid email');
+}
+```
+
+### Available Modules
+
+All modules support both named and default exports:
+
+- `sculp-js/array` - Array utilities
+- `sculp-js/string` - String manipulation
+- `sculp-js/type` - Type checking
+- `sculp-js/date` - Date formatting
+- `sculp-js/object` - Object utilities
+- `sculp-js/math` - Math operations
+- `sculp-js/number` - Number formatting
+- `sculp-js/url` - URL parsing
+- `sculp-js/qs` - Query string parsing
+- `sculp-js/path` - Path utilities
+- `sculp-js/async` - Async utilities
+- `sculp-js/func` - Function utilities
+- `sculp-js/random` - Random generators
+- `sculp-js/validator` - Validation functions
+- `sculp-js/tree` - Tree operations
+- `sculp-js/base64` - Base64 encoding
+- `sculp-js/unique` - Unique ID generators
+- `sculp-js/variable` - Variable utilities
+- `sculp-js/clipboard` - Clipboard operations
+- `sculp-js/cookie` - Cookie management
+- `sculp-js/dom` - DOM utilities
+- `sculp-js/download` - Download helpers
+- `sculp-js/file` - File utilities
+- `sculp-js/watermark` - Watermark generation
+- `sculp-js/tooltip` - Tooltip utilities
+- `sculp-js/cloneDeep` - Deep cloning
+- `sculp-js/isEqual` - Deep equality
+- `sculp-js/unicodeToolkit` - Unicode utilities
+
 ## 📄 License
 
 MIT License © 2023-present, [chandq](https://github.com/chandq)

package/dist/cjs/{array.js → array.cjs}

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
 /**
  * 遍历数组，返回 false 中断遍历(支持continue和break操作)
@@ -166,9 +166,17 @@ function diffArray(source, target, getKey) {
   }
   return { added, removed: del };
 }
+var array = {
+  arrayEach,
+  arrayEachAsync,
+  arrayInsertBefore,
+  arrayRemove,
+  diffArray
+};
 
 exports.arrayEach = arrayEach;
 exports.arrayEachAsync = arrayEachAsync;
 exports.arrayInsertBefore = arrayInsertBefore;
 exports.arrayRemove = arrayRemove;
+exports.default = array;
 exports.diffArray = diffArray;

package/dist/cjs/{async.js → async.cjs}

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
 /**
  * 等待一段时间
@@ -88,7 +88,13 @@ function safeAwait(promise, errorExt) {
       return [err, undefined];
     });
 }
+var async = {
+  wait,
+  asyncMap,
+  safeAwait
+};
 
 exports.asyncMap = asyncMap;
+exports.default = async;
 exports.safeAwait = safeAwait;
 exports.wait = wait;

package/dist/cjs/{base64.js → base64.cjs}

@@ -1,15 +1,15 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
-var func = require('./func.js');
-var type = require('./type.js');
+var func = require('./func.cjs');
+var type = require('./type.cjs');
 
 const b64 = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';
 // eslint-disable-next-line
@@ -122,8 +122,15 @@ function b64encode(rawStr) {
   // 将二进制字符串转换为base64编码的字符串
   return !type.isNullOrUnDef(func.getGlobal('btoa')) ? func.getGlobal('btoa')(binaryString) : weBtoa(binaryString);
 }
+var base64 = {
+  weBtoa,
+  weAtob,
+  b64decode,
+  b64encode
+};
 
 exports.b64decode = b64decode;
 exports.b64encode = b64encode;
+exports.default = base64;
 exports.weAtob = weAtob;
 exports.weBtoa = weBtoa;

package/dist/cjs/{clipboard.js → clipboard.cjs}

@@ -1,15 +1,15 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
-var dom = require('./dom.js');
-var type = require('./type.js');
+var dom = require('./dom.cjs');
+var type = require('./type.cjs');
 
 /**
  * 复制文本，优先使用navigator.clipboard，仅在安全上下文(HTTPS/localhost)下生效，若不支持则回退使用execCommand方式
@@ -90,6 +90,11 @@ function createFakeElement(value) {
   fakeElement.value = value;
   return fakeElement;
 }
+var clipboard = {
+  copyText,
+  fallbackCopyText
+};
 
 exports.copyText = copyText;
+exports.default = clipboard;
 exports.fallbackCopyText = fallbackCopyText;

package/dist/cjs/{cloneDeep.js → cloneDeep.cjs}

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
 /**
  * 深拷贝堪称完全体 即：任何类型的数据都会被深拷贝
@@ -114,5 +114,9 @@ function cloneDeep(source, map = new WeakMap()) {
   }
   return copy;
 }
+var cloneDeep_default = {
+  cloneDeep
+};
 
 exports.cloneDeep = cloneDeep;
+exports.default = cloneDeep_default;

package/dist/cjs/{cookie.js → cookie.cjs}

@@ -1,14 +1,14 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
-var type = require('./type.js');
+var type = require('./type.cjs');
 
 /**
  * 获取cookie
@@ -56,7 +56,13 @@ function cookieSet(name, value, maxAge) {
  * @param name cookie 名称
  */
 const cookieDel = name => cookieSet(name, '', -1);
+var cookie = {
+  cookieSet,
+  cookieGet,
+  cookieDel
+};
 
 exports.cookieDel = cookieDel;
 exports.cookieGet = cookieGet;
 exports.cookieSet = cookieSet;
+exports.default = cookie;

package/dist/cjs/{date.js → date.cjs}

@@ -1,14 +1,14 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
-var type = require('./type.js');
+var type = require('./type.cjs');
 
 const isValidDate = any => type.isDate(any) && !type.isNaN(any.getTime());
 /* istanbul ignore next */
@@ -212,11 +212,21 @@ function calculateDateTime(originDateTime, n, dateSep = '-', timeSep = ':') {
     String(targetDateTime.getSeconds()).padStart(2, '0')
   );
 }
+var date = {
+  isValidDate,
+  dateParse,
+  dateToStart,
+  dateToEnd,
+  formatDate,
+  calculateDate,
+  calculateDateTime
+};
 
 exports.calculateDate = calculateDate;
 exports.calculateDateTime = calculateDateTime;
 exports.dateParse = dateParse;
 exports.dateToEnd = dateToEnd;
 exports.dateToStart = dateToStart;
+exports.default = date;
 exports.formatDate = formatDate;
 exports.isValidDate = isValidDate;

package/dist/cjs/{dom.js → dom.cjs}

@@ -1,16 +1,16 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
-var object = require('./object.js');
-var string = require('./string.js');
-var type = require('./type.js');
+var object = require('./object.cjs');
+var string = require('./string.cjs');
+var type = require('./type.cjs');
 
 /**
  * 判断元素是否包含某个样式名
@@ -150,8 +150,19 @@ function select(element) {
   }
   return selectedText;
 }
+var dom = {
+  hasClass,
+  addClass,
+  removeClass,
+  setStyle,
+  getStyle,
+  getComputedCssVal,
+  getStrWidthPx,
+  select
+};
 
 exports.addClass = addClass;
+exports.default = dom;
 exports.getComputedCssVal = getComputedCssVal;
 exports.getStrWidthPx = getStrWidthPx;
 exports.getStyle = getStyle;

package/dist/cjs/{download.js → download.cjs}

@@ -1,15 +1,15 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
-var type = require('./type.js');
-var url = require('./url.js');
+var type = require('./type.cjs');
+var url = require('./url.cjs');
 
 /**
  * 通过打开新窗口的方式下载
@@ -131,8 +131,16 @@ function downloadData(data, fileType, filename, headers) {
     downloadHref(href, filename);
   }
 }
+var download = {
+  downloadURL,
+  downloadHref,
+  downloadBlob,
+  crossOriginDownload,
+  downloadData
+};
 
 exports.crossOriginDownload = crossOriginDownload;
+exports.default = download;
 exports.downloadBlob = downloadBlob;
 exports.downloadData = downloadData;
 exports.downloadHref = downloadHref;

package/dist/cjs/{file.js → file.cjs}

@@ -1,14 +1,14 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
-var type = require('./type.js');
+var type = require('./type.cjs');
 
 /**
  * 判断是否支持canvas
@@ -208,7 +208,13 @@ function compressImg(file, options = { mime: 'image/jpeg', minFileSizeKB: 50 })
   }
   return Promise.resolve(null);
 }
+var file = {
+  supportCanvas,
+  chooseLocalFile,
+  compressImg
+};
 
 exports.chooseLocalFile = chooseLocalFile;
 exports.compressImg = compressImg;
+exports.default = file;
 exports.supportCanvas = supportCanvas;

package/dist/cjs/{func.js → func.cjs}

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
 /**
  * 防抖函数
@@ -113,8 +113,16 @@ function getGlobal(key) {
   else if (typeof global !== 'undefined') return global[key];
   else if (typeof self !== 'undefined') return self[key];
 }
+var func = {
+  debounce,
+  throttle,
+  once,
+  getGlobal,
+  setGlobal
+};
 
 exports.debounce = debounce;
+exports.default = func;
 exports.getGlobal = getGlobal;
 exports.once = once;
 exports.setGlobal = setGlobal;

package/dist/cjs/{index.js → index.cjs}

@@ -1,41 +1,72 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
-var array = require('./array.js');
-var clipboard = require('./clipboard.js');
-var cookie = require('./cookie.js');
-var date = require('./date.js');
-var dom = require('./dom.js');
-var download = require('./download.js');
-var object = require('./object.js');
-var path = require('./path.js');
-var qs = require('./qs.js');
-var string = require('./string.js');
-var type = require('./type.js');
-var url = require('./url.js');
-var async = require('./async.js');
-var file = require('./file.js');
-var watermark = require('./watermark.js');
-var func = require('./func.js');
-var random = require('./random.js');
-var number = require('./number.js');
-var unique = require('./unique.js');
-var tooltip = require('./tooltip.js');
-var tree = require('./tree.js');
-var math = require('./math.js');
-var base64 = require('./base64.js');
-var validator = require('./validator.js');
-var variable = require('./variable.js');
-var cloneDeep = require('./cloneDeep.js');
-var isEqual = require('./isEqual.js');
-var unicodeToolkit = require('./unicodeToolkit.js');
+var array = require('./array.cjs');
+var clipboard = require('./clipboard.cjs');
+var cookie = require('./cookie.cjs');
+var date = require('./date.cjs');
+var dom = require('./dom.cjs');
+var download = require('./download.cjs');
+var object = require('./object.cjs');
+var path = require('./path.cjs');
+var qs = require('./qs.cjs');
+var string = require('./string.cjs');
+var type = require('./type.cjs');
+var url = require('./url.cjs');
+var async = require('./async.cjs');
+var file = require('./file.cjs');
+var watermark = require('./watermark.cjs');
+var func = require('./func.cjs');
+var random = require('./random.cjs');
+var number = require('./number.cjs');
+var unique = require('./unique.cjs');
+var tooltip = require('./tooltip.cjs');
+var tree = require('./tree.cjs');
+var math = require('./math.cjs');
+var base64 = require('./base64.cjs');
+var validator = require('./validator.cjs');
+var variable = require('./variable.cjs');
+var cloneDeep = require('./cloneDeep.cjs');
+var isEqual = require('./isEqual.cjs');
+var unicodeToolkit = require('./unicodeToolkit.cjs');
+
+var index = {
+  ...array,
+  ...clipboard,
+  ...cookie,
+  ...date,
+  ...dom,
+  ...download,
+  ...object,
+  ...path,
+  ...qs,
+  ...string,
+  ...type,
+  ...url,
+  ...async,
+  ...file,
+  ...watermark,
+  ...func,
+  ...random,
+  ...number,
+  ...unique,
+  ...tooltip,
+  ...tree,
+  ...math,
+  ...base64,
+  ...validator,
+  ...variable,
+  ...cloneDeep,
+  ...isEqual,
+  ...unicodeToolkit
+};
 
 exports.arrayEach = array.arrayEach;
 exports.arrayEachAsync = array.arrayEachAsync;
@@ -113,7 +144,7 @@ exports.isString = type.isString;
 exports.isSymbol = type.isSymbol;
 exports.isUndefined = type.isUndefined;
 exports.objectHas = type.objectHas;
-exports.typeIs = type.default;
+exports.typeIs = type.typeIs;
 exports.urlDelParams = url.urlDelParams;
 exports.urlParse = url.urlParse;
 exports.urlSetParams = url.urlSetParams;
@@ -185,3 +216,4 @@ exports.uniqueSymbol = variable.uniqueSymbol;
 exports.cloneDeep = cloneDeep.cloneDeep;
 exports.isEqual = isEqual.isEqual;
 exports.UnicodeToolkit = unicodeToolkit.UnicodeToolkit;
+exports.default = index;

package/dist/cjs/{isEqual.js → isEqual.cjs}

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
 /**
  * 使用位运算或常量定义常用 Tag，这里保持字符串以匹配 Object.prototype.toString
@@ -208,5 +208,9 @@ function deepCompareObject(a, b, stack) {
   }
   return true;
 }
+var isEqual_default = {
+  isEqual
+};
 
+exports.default = isEqual_default;
 exports.isEqual = isEqual;

package/dist/cjs/{math.js → math.cjs}

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.2
+ * sculp-js v1.19.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
 /**
  * 数值安全乘法
@@ -76,8 +76,16 @@ const divide = (arg1, arg2) => {
 function strip(num, precision = 15) {
   return +parseFloat(Number(num).toPrecision(precision));
 }
+var math = {
+  add,
+  subtract,
+  multiply,
+  divide,
+  strip
+};
 
 exports.add = add;
+exports.default = math;
 exports.divide = divide;
 exports.multiply = multiply;
 exports.strip = strip;