sculp-js 1.18.3 → 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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs');
 var type = require('./type.cjs');
@@ -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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs');
 var type = require('./type.cjs');
@@ -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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs');
 
@@ -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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs');
 
@@ -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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs');
 var string = require('./string.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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs');
 
@@ -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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs');
 var clipboard = require('./clipboard.cjs');
@@ -37,6 +37,37 @@ 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;
 exports.arrayInsertBefore = array.arrayInsertBefore;
@@ -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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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;

package/dist/cjs/number.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs');
 var string = require('./string.cjs');
@@ -72,9 +72,9 @@ const numberAbbr = (num, units, options = { ratio: 1000, decimals: 0, separator:
  *  reference: https://zh.wikipedia.org/wiki/%E5%8D%83%E5%AD%97%E8%8A%82
  * @param {number | string} num bytes Number in Bytes
  * @param {IHumanFileSizeOptions} options default: { decimals = 0, si = false, separator = ' ' }
- *        si: True to use metric (SI) units, aka powers of 1000, the units is
+ *        si: True to use metric (SI) units, aka powers of 1000, units is
  *            ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'].
- *            False to use binary (IEC), aka powers of 1024, the units is
+ *            False to use binary (IEC), aka powers of 1024, units is
  *            ['Byte', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB']
  * @returns
  */
@@ -113,8 +113,17 @@ function formatNumber(num, decimals) {
   }
   return Number(Number(num).toFixed(prec)).toLocaleString('en-US');
 }
+var number = {
+  HEX_POOL,
+  numberToHex,
+  numberAbbr,
+  humanFileSize,
+  formatNumber,
+  formatMoney: formatNumber
+};
 
 exports.HEX_POOL = HEX_POOL;
+exports.default = number;
 exports.formatMoney = formatNumber;
 exports.formatNumber = formatNumber;
 exports.humanFileSize = humanFileSize;

package/dist/cjs/object.cjs

@@ -1,15 +1,16 @@
 /*!
- * sculp-js v1.18.3
+ * 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.cjs');
 
+const typeIs = type.typeIs;
 /**
  * 判断对象是否为纯对象
  * @param {object} obj
@@ -101,8 +102,8 @@ function objectOmit(obj, keys) {
 }
 const merge = (map, source, target) => {
   if (type.isUndefined(target)) return source;
-  const sourceType = type.default(source);
-  const targetType = type.default(target);
+  const sourceType = typeIs(source);
+  const targetType = typeIs(target);
   if (sourceType !== targetType) {
     if (type.isArray(target)) return merge(map, [], target);
     if (type.isObject(target)) return merge(map, {}, target);
@@ -195,7 +196,20 @@ function objectGet(obj, path, strict = false) {
     v: tempObj ? tempObj[keyArr[i]] : undefined
   };
 }
+var object = {
+  isPlainObject,
+  objectEach,
+  objectEachAsync,
+  objectMap,
+  objectPick,
+  objectOmit,
+  objectAssign,
+  objectMerge: objectAssign,
+  objectFill,
+  objectGet
+};
 
+exports.default = object;
 exports.isPlainObject = isPlainObject;
 exports.objectAssign = objectAssign;
 exports.objectEach = objectEach;

package/dist/cjs/path.cjs

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.18.3
+ * 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' } });
 
 /**
  * 标准化路径
@@ -59,6 +59,11 @@ const pathNormalize = path => {
  * @returns {string}
  */
 const pathJoin = (from, ...to) => pathNormalize([from, ...to].join('/'));
+var path = {
+  pathJoin,
+  pathNormalize
+};
 
+exports.default = path;
 exports.pathJoin = pathJoin;
 exports.pathNormalize = pathNormalize;