sculp-js 1.19.5 → 1.19.12

package/README.md

@@ -4,9 +4,9 @@
 
 **A Modern JavaScript Utility Library for Web**
 
-[![Node.js CI](https://github.com/chandq/sculp-js/actions/workflows/node.js.yml/badge.svg)](https://github.com/chandq/sculp-js/actions/workflows/node.js.yml)
+[![Node.js CI](https://github.com/chandq/sculp-js/actions/workflows/release.yml/badge.svg)](https://github.com/chandq/sculp-js/actions/workflows/release.yml)
 [![sculp-js](https://img.shields.io/github/package-json/v/chandq/sculp-js?style=flat-square)](https://www.npmjs.com/package/sculp-js)
-[![license:MIT](https://img.shields.io/npm/l/vue.svg?sanitize=true)](https://github.com/chandq/sculp-js/blob/main/LICENSE.md)
+[![license:MIT](https://img.shields.io/npm/l/vue.svg?sanitize=true)](https://github.com/chandq/sculp-js/blob/main/LICENSE)
 [![codecov](https://codecov.io/gh/chandq/sculp-js/graph/badge.svg?token=VZ6TERPGI9)](https://codecov.io/gh/chandq/sculp-js)
 
 </div>

package/dist/cjs/array.cjs

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

package/dist/cjs/async.cjs

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

package/dist/cjs/base64.cjs

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

package/dist/cjs/clipboard.cjs

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

package/dist/cjs/cloneDeep.cjs

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

package/dist/cjs/cookie.cjs

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

package/dist/cjs/date.cjs

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

package/dist/cjs/dom.cjs

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

package/dist/cjs/download.cjs

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

package/dist/cjs/file.cjs

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

package/dist/cjs/func.cjs

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

package/dist/cjs/index.cjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.5
+ * sculp-js v1.19.12
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -190,8 +190,9 @@ exports.flatTree = tree.flatTree;
 exports.forEachDeep = tree.forEachDeep;
 exports.formatTree = tree.formatTree;
 exports.fuzzySearchTree = tree.fuzzySearchTree;
+exports.getPathById = tree.getPathById;
 exports.mapDeep = tree.mapDeep;
-exports.searchTreeById = tree.searchTreeById;
+exports.searchTreeById = tree.getPathById;
 exports.add = math.add;
 exports.divide = math.divide;
 exports.multiply = math.multiply;

package/dist/cjs/isEqual.cjs

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

package/dist/cjs/math.cjs

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

package/dist/cjs/number.cjs

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

package/dist/cjs/object.cjs

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

package/dist/cjs/path.cjs

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

package/dist/cjs/qs.cjs

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

package/dist/cjs/random.cjs

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

package/dist/cjs/string.cjs

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

package/dist/cjs/tooltip.cjs

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

package/dist/cjs/tree.cjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.5
+ * sculp-js v1.19.12
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -24,10 +24,11 @@ function getChildNodes(item, childField, isDomNode) {
   return isDomNode && type.isNodeList(child) ? Array.from(child) : Array.isArray(child) ? child : null;
 }
 /**
- * 深度遍历函数 (支持 continue 和 break 操作), 可用于遍历 Array 和 NodeList 类型的数据
- * @param {ArrayLike<V>} tree  树形数据
- * @param {Function} iterator  迭代函数，返回值为 true 时 continue, 返回值为 false 时 break
- * @param {options} options 支持定制子元素名称、反向遍历、广度优先遍历，默认{
+ * Tree traversal function (default DFS, supports continue and break operations).
+ * Can be used to traverse Array and NodeList type data.
+ * @param {V[]} tree - Tree data
+ * @param {Function} iterator - Iterator function. Returns true to continue, false to break.
+ * @param {object} options - Options to customize child element name, reverse traversal, breadth-first traversal. Default: {
     childField: 'children',
     reverse: false,
     breadthFirst: false,
@@ -102,10 +103,10 @@ function forEachDeep(
   tree = null;
 }
 /**
- * 树查找函数，可用于查找 Array 和 NodeList 类型的数据
- * @param {ArrayLike<V>} tree  树形数据
- * @param {Function} predicate  断言函数
- * @param {options} options 支持定制子元素名称、反向遍历、广度优先遍历，默认{
+ * Tree search function, can be used to search Array and NodeList type data.
+ * @param {V[]} tree - Tree data
+ * @param {Function} predicate - Predicate function
+ * @param {object} options - Options to customize child element name, reverse traversal, breadth-first traversal. Default: {
     childField: 'children',
     reverse: false,
     breadthFirst: false,
@@ -137,10 +138,10 @@ function findDeep(
   return result;
 }
 /**
- * 树过滤函数，可用于过滤 Array 和 NodeList 类型的数据
- * @param {ArrayLike<V>} tree  树形数据
- * @param {Function} predicate  断言函数
- * @param {options} options 支持定制子元素名称、反向遍历、广度优先遍历，默认{
+ * Tree filter function, can be used to filter Array and NodeList type data.
+ * @param {V[]} tree - Tree data
+ * @param {Function} predicate - Predicate function
+ * @param {object} options - Options to customize child element name, reverse traversal, breadth-first traversal. Default: {
     childField: 'children',
     reverse: false,
     breadthFirst: false,
@@ -171,16 +172,17 @@ function filterDeep(
   return result;
 }
 /**
- * 创建一个新数组，深度优先遍历的 Map 函数 (支持 continue 和 break 操作), 可用于 insert tree item 和 remove tree item
+ * Creates a new array using a depth-first traversal Map function (supports continue and break operations).
+ * Can be used for inserting or removing tree items.
  *
- * 可遍历任何带有 length 属性和数字键的类数组对象
- * @param {ArrayLike<V>} tree  树形数据
- * @param {Function} iterator  迭代函数，返回值为 true 时 continue, 返回值为 false 时 break
- * @param {options} options 支持定制子元素名称、反向遍历，默认{
+ * Can traverse any array-like object with a length property and numeric keys.
+ * @param {V[]} tree - Tree data
+ * @param {Function} iterator - Iterator function. Returns true to continue, false to break.
+ * @param {object} options - Options to customize child element name, reverse traversal. Default: {
     childField: 'children',
     reverse: false,
   }
- * @returns {any[]} 新的一棵树
+ * @returns {any[]} A new tree structure
  */
 function mapDeep(
   tree,
@@ -238,14 +240,14 @@ function mapDeep(
   return newTree;
 }
 /**
- * 在树中找到 id 为某个值的节点，并返回上游的所有父级节点
+ * Retrieves the path (ancestors + self) for a given node ID.
  *
- * @param {ArrayLike<T>} tree - 树形数据
- * @param {number | string} nodeId - 目标元素 ID
- * @param {ITreeConf} options - 迭代配置项，默认：{ children = 'children', id = 'id' }
- * @returns {[(number | string)[], V[]]} - 由 parentId...childId, parentObject-childObject 组成的二维数组
+ * @param {ArrayLike<T>} tree - Tree data
+ * @param {number | string} nodeId - Target node ID
+ * @param {ITreeConf} options - Configuration. Default: { childField = 'children', keyField = 'id' }
+ * @returns {[(number | string)[], V[]]} - Array of IDs and Array of Nodes from root to target
  */
-function searchTreeById(tree, nodeId, options = { childField: 'children', keyField: 'id' }) {
+function getPathById(tree, nodeId, options = { childField: 'children', keyField: 'id' }) {
   const { childField = 'children', keyField = 'id' } = type.isObject(options) ? options : {};
   const flatMap = {};
   // 扁平化 - 使用迭代而非递归，避免栈溢出
@@ -283,11 +285,11 @@ function searchTreeById(tree, nodeId, options = { childField: 'children', keyFie
   return [ids, nodes];
 }
 /**
- * 扁平化数组转换成树
- * @param {any[]} list
- * @param {IFieldOptions} options 定制 id 字段名，子元素字段名，父元素字段名，默认
+ * Converts a flat array into a tree structure.
+ * @param {any[]} list - Flat list of items
+ * @param {IFieldOptions} options - Customizes id field name, child element field name, parent element field name. Default:
  *        { keyField: 'key', childField: 'children', pidField: 'pid' }
- * @returns {any[]}
+ * @returns {any[]} Tree structure array
  */
 function formatTree(list, options = defaultFieldOptions) {
   const { keyField = 'key', childField = 'children', pidField = 'pid' } = type.isObject(options) ? options : {};
@@ -313,11 +315,11 @@ function formatTree(list, options = defaultFieldOptions) {
   return treeArr;
 }
 /**
- * 树形结构转扁平化
- * @param {any[]} treeList
- * @param {IFieldOptions} options 定制 id 字段名，子元素字段名，父元素字段名，默认
+ * Converts a tree structure into a flat array.
+ * @param {any[]} treeList - Tree structure array
+ * @param {IFieldOptions} options - Customizes id field name, child element field name, parent element field name. Default:
  *        { keyField: 'key', childField: 'children', pidField: 'pid' }
- * @returns {any[]}
+ * @returns {any[]} Flat array
  */
 function flatTree(treeList, options = defaultFieldOptions) {
   const { keyField = 'key', childField = 'children', pidField = 'pid' } = type.isObject(options) ? options : {};
@@ -344,23 +346,26 @@ function flatTree(treeList, options = defaultFieldOptions) {
   return res;
 }
 /**
- * 模糊搜索函数，返回包含搜索字符的节点及其祖先节点, 适用于树型组件的字符过滤功能
- * 以下搜索条件二选一，按先后优先级处理：
- * 1. 过滤函数filter, 返回true/false
- * 2. 匹配关键词，支持是否启用忽略大小写来判断
+ * Fuzzy search function that returns nodes containing the search character and their ancestor nodes.
+ * Suitable for character filtering in tree components.
  *
- * 有以下特性：
- * 1. 可配置removeEmptyChild字段，来决定是否移除搜索结果中的空children字段
- * 2. 若无任何过滤条件或keyword模式匹配且keyword为空串，返回原对象；其他情况返回新数组
- * @param {V[]} nodes
- * @param {IFilterCondition} filterCondition
- * @param {ISearchTreeOpts} options 默认配置项 {
+ * Two search conditions are available, processed in priority order:
+ * 1. Filter function `filter`, returning true/false.
+ * 2. Keyword matching, supporting case-insensitive check.
+ *
+ * Features:
+ * 1. Configurable `removeEmptyChild` field to decide whether to remove empty children fields in search results.
+ * 2. If no filter condition is provided, or keyword mode is used with an empty keyword, the original object is returned; otherwise, a new array is returned.
+ *
+ * @param {V[]} nodes - Tree nodes
+ * @param {IFilterCondition} filterCondition - Filter conditions
+ * @param {ISearchTreeOpts} options - Default configuration: {
       childField: 'children',
       nameField: 'name',
       removeEmptyChild: false,
       ignoreCase: true
     }
- * @returns {V[]}
+ * @returns {V[]} Filtered tree nodes
  */
 function fuzzySearchTree(nodes, filterCondition, options = defaultSearchTreeOptions) {
   if (!type.objectHas(filterCondition, 'filter') && !filterCondition.keyword) {
@@ -415,7 +420,8 @@ var tree = {
   findDeep,
   filterDeep,
   mapDeep,
-  searchTreeById,
+  getPathById,
+  searchTreeById: getPathById,
   formatTree,
   flatTree,
   fuzzySearchTree
@@ -428,5 +434,6 @@ exports.flatTree = flatTree;
 exports.forEachDeep = forEachDeep;
 exports.formatTree = formatTree;
 exports.fuzzySearchTree = fuzzySearchTree;
+exports.getPathById = getPathById;
 exports.mapDeep = mapDeep;
-exports.searchTreeById = searchTreeById;
+exports.searchTreeById = getPathById;

package/dist/cjs/type.cjs

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

package/dist/cjs/unicodeToolkit.cjs

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

package/dist/cjs/unique.cjs

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

package/dist/cjs/url.cjs

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

package/dist/cjs/validator.cjs

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

package/dist/cjs/variable.cjs

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

package/dist/cjs/watermark.cjs

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

package/dist/esm/array.mjs

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

package/dist/esm/async.mjs

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

package/dist/esm/base64.mjs

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

package/dist/esm/clipboard.mjs

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

package/dist/esm/cloneDeep.mjs

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

package/dist/esm/cookie.mjs

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

package/dist/esm/date.mjs

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

package/dist/esm/dom.mjs

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

package/dist/esm/download.mjs

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

package/dist/esm/file.mjs

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

package/dist/esm/func.mjs

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

package/dist/esm/index.mjs

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.19.5
+ * sculp-js v1.19.12
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -123,8 +123,9 @@ export {
   forEachDeep,
   formatTree,
   fuzzySearchTree,
+  getPathById,
   mapDeep,
-  searchTreeById
+  getPathById as searchTreeById
 } from './tree.mjs';
 import * as math from './math.mjs';
 export { add, divide, multiply, strip, subtract } from './math.mjs';

package/dist/esm/isEqual.mjs

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

package/dist/esm/math.mjs

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

package/dist/esm/number.mjs

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

package/dist/esm/object.mjs

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

package/dist/esm/path.mjs

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

package/dist/esm/qs.mjs

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

package/dist/esm/random.mjs

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

package/dist/esm/string.mjs

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

package/dist/esm/tooltip.mjs

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