zhiaiwan-utils 1.0.3

package/dist/esm/object/pickBy.js

@@ -0,0 +1,32 @@
+import baseIteratee from '../_internal/baseIteratee';
+import baseKeysIn from '../_internal/baseKeysIn';
+/**
+ * 返回 object 中 predicate 为真值的属性组成的新对象。
+ *
+ * @param object - 源对象
+ * @param predicate - 每次属性检查调用的函数或简写
+ * @returns 筛选后的新对象
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.pickBy({ a: 1, b: '2', c: 3 }, (value) => typeof value === 'number');
+ * // => { a: 1, c: 3 }
+ * ```
+ *
+ * @since 1.0.0
+ * @category Object
+ */
+export default function pickBy(object, predicate = baseIteratee()) {
+    if (object == null) {
+        return {};
+    }
+    const resolvedPredicate = baseIteratee(predicate);
+    const result = {};
+    for (const key of baseKeysIn(object)) {
+        const value = object[key];
+        if (resolvedPredicate(value, key, object)) {
+            result[key] = value;
+        }
+    }
+    return result;
+}

package/dist/esm/object/set.js

@@ -0,0 +1,61 @@
+import isIndex from '../_internal/isIndex';
+import toPath from '../_internal/toPath';
+function createNestedValue(nextKey) {
+    return isIndex(nextKey) ? [] : {};
+}
+function assignValue(container, key, value) {
+    if (Array.isArray(container) && isIndex(key)) {
+        const index = Number(key);
+        container[index] = value;
+        if (index >= container.length) {
+            container.length = index + 1;
+        }
+        return;
+    }
+    container[key] = value;
+}
+function getNestedValue(container, key) {
+    return container[key];
+}
+/**
+ * 设置 object 上 path 路径对应的值。若中间路径不存在会自动创建对象或数组
+ * （下一级为数字下标时创建数组）；当 object 为 null 或 undefined 时会创建并返回新对象。
+ *
+ * @param object - 要修改的对象
+ * @param path - 属性路径，支持 `'a.b[0].c'` 字符串或键数组
+ * @param value - 要设置的值
+ * @returns 修改后的 object（可能与入参为同一引用）
+ *
+ * @example
+ * ```ts
+ * const obj = { a: [{ b: 2 }] };
+ * set(obj, 'a[0].b', 3);
+ * // => { a: [{ b: 3 }] }
+ *
+ * set({}, 'a.b.c', 4);
+ * // => { a: { b: { c: 4 } } }
+ * ```
+ *
+ * @since 1.0.0
+ * @category Object
+ */
+export default function set(object, path, value) {
+    const keys = toPath(path);
+    if (keys.length === 0) {
+        return object;
+    }
+    const root = object == null ? createNestedValue(keys[0]) : object;
+    let current = root;
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        const nextKey = keys[i + 1];
+        let next = getNestedValue(current, key);
+        if (next == null || typeof next !== 'object') {
+            next = createNestedValue(nextKey);
+            assignValue(current, key, next);
+        }
+        current = next;
+    }
+    assignValue(current, keys[keys.length - 1], value);
+    return root;
+}

package/dist/esm/object/unset.js

@@ -0,0 +1,22 @@
+import baseUnset from '../_internal/baseUnset';
+/**
+ * 删除 object 上 path 路径对应的属性。
+ *
+ * @param object - 要修改的对象
+ * @param path - 属性路径，支持 `'a.b[0].c'` 字符串或键数组
+ * @returns 删除成功返回 true，路径不存在或无法到达时返回 false
+ *
+ * @example
+ * ```ts
+ * const obj = { a: [{ b: 2 }, { b: 3 }] };
+ * zhiaiwanUtils.unset(obj, 'a[0].b');
+ * // => true
+ * // obj => { a: [{}, { b: 3 }] }
+ * ```
+ *
+ * @since 1.0.0
+ * @category Object
+ */
+export default function unset(object, path) {
+    return baseUnset(object, path);
+}

package/dist/esm/object/update.js

@@ -0,0 +1,25 @@
+import baseUpdate from '../_internal/baseUpdate';
+/**
+ * 按 path 更新 object 上的值，updater 接收当前值并返回新值。
+ *
+ * @param object - 待修改对象
+ * @param path - 属性路径
+ * @param updater - 更新函数
+ * @returns 修改后的 object
+ *
+ * @example
+ * ```ts
+ * const object = { a: [{ b: 1 }] };
+ * zhiaiwanUtils.update(object, 'a[0].b', (n) => (n as number) * 2);
+ * // object.a[0].b => 2
+ * ```
+ *
+ * @since 1.0.0
+ * @category Object
+ */
+export default function update(object, path, updater) {
+    if (object == null) {
+        return object;
+    }
+    return baseUpdate(object, path, updater);
+}

package/dist/esm/object/updateWith.js

@@ -0,0 +1,27 @@
+import baseUpdate from '../_internal/baseUpdate';
+/**
+ * 类似 update，但允许 customizer 控制中间路径节点的创建。
+ *
+ * @param object - 待修改对象
+ * @param path - 属性路径
+ * @param updater - 更新函数
+ * @param customizer - 路径节点创建函数
+ * @returns 修改后的 object
+ *
+ * @example
+ * ```ts
+ * const object = {};
+ * zhiaiwanUtils.updateWith(object, '[0][1]', () => 'a', Object);
+ * // => { '0': { '1': 'a' } }
+ * ```
+ *
+ * @since 1.0.0
+ * @category Object
+ */
+export default function updateWith(object, path, updater, customizer) {
+    if (object == null) {
+        return object;
+    }
+    const resolvedCustomizer = typeof customizer === 'function' ? customizer : undefined;
+    return baseUpdate(object, path, updater, resolvedCustomizer);
+}

package/dist/esm/object/values.js

@@ -0,0 +1,22 @@
+import { baseValues } from '../_internal/baseCollectionKeys';
+/**
+ * 返回 object 的自有可枚举属性值数组。
+ *
+ * @param object - 要查询的对象或集合
+ * @returns 属性值数组
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.values({ a: 1, b: 2 });
+ * // => [1, 2]
+ *
+ * zhiaiwanUtils.values([1, 2, 3]);
+ * // => [1, 2, 3]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Object
+ */
+export default function values(object) {
+    return baseValues(object);
+}

package/dist/esm/string/camelCase.js

@@ -0,0 +1,31 @@
+import deburr from '../_internal/deburr';
+import upperFirst from '../_internal/upperFirst';
+import words from '../_internal/words';
+/**
+ * 将字符串转换为 camelCase。
+ *
+ * @param string - 待转换的字符串
+ * @returns camelCase 字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.camelCase('Foo Bar');
+ * // => 'fooBar'
+ *
+ * zhiaiwanUtils.camelCase('__FOO_BAR__');
+ * // => 'fooBar'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function camelCase(string) {
+    const input = String(string !== null && string !== void 0 ? string : '');
+    if (!input) {
+        return '';
+    }
+    return words(deburr(input).replace(/['\u2019]/g, '')).reduce((result, word, index) => {
+        const lower = word.toLowerCase();
+        return result + (index ? upperFirst(lower) : lower);
+    }, '');
+}

package/dist/esm/string/capitalize.js

@@ -0,0 +1,19 @@
+import upperFirst from '../_internal/upperFirst';
+/**
+ * 首字母大写，其余小写。
+ *
+ * @param string - 待转换字符串
+ * @returns 首字母大写后的字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.capitalize('FRED');
+ * // => 'Fred'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function capitalize(string) {
+    return upperFirst(String(string !== null && string !== void 0 ? string : '').toLowerCase());
+}

package/dist/esm/string/endsWith.js

@@ -0,0 +1,30 @@
+import coerceToString from '../_internal/coerceToString';
+import toInteger from '../_internal/toInteger';
+/**
+ * 检查字符串是否以 target 结尾。
+ *
+ * @param value - 待检查的字符串
+ * @param target - 要匹配的后缀
+ * @param position - 检索结束位置，默认为字符串长度
+ * @returns 若匹配返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.endsWith('abc', 'c');
+ * // => true
+ *
+ * zhiaiwanUtils.endsWith('abc', 'b');
+ * // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function endsWith(value, target, position) {
+    const string = coerceToString(value);
+    const search = coerceToString(target);
+    const normalizedPosition = position === undefined
+        ? string.length
+        : Math.max(0, Math.min(toInteger(position), string.length));
+    return string.endsWith(search, normalizedPosition);
+}

package/dist/esm/string/escape.js

@@ -0,0 +1,20 @@
+import coerceToString from '../_internal/coerceToString';
+import { escapeHtml } from '../_internal/htmlEscape';
+/**
+ * 将字符串中的 `&`、`<`、`>`、`"`、`'` 转为对应 HTML 实体。
+ *
+ * @param value - 待转义的值
+ * @returns 转义后的字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.escape('fred, barney, & pebbles');
+ * // => 'fred, barney, &amp; pebbles'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function escape(value) {
+    return escapeHtml(coerceToString(value));
+}

package/dist/esm/string/index.js

@@ -0,0 +1,17 @@
+export { default as trim } from './trim';
+export { default as trimStart } from './trimStart';
+export { default as trimEnd } from './trimEnd';
+export { default as startsWith } from './startsWith';
+export { default as endsWith } from './endsWith';
+export { default as pad } from './pad';
+export { default as padStart } from './padStart';
+export { default as padEnd } from './padEnd';
+export { default as escape } from './escape';
+export { default as unescape } from './unescape';
+export { default as repeat } from './repeat';
+export { default as camelCase } from './camelCase';
+export { default as kebabCase } from './kebabCase';
+export { default as snakeCase } from './snakeCase';
+export { default as capitalize } from './capitalize';
+export { default as lowerCase } from './lowerCase';
+export { default as upperFirst } from './upperFirst';

package/dist/esm/string/kebabCase.js

@@ -0,0 +1,22 @@
+import createCompounder from '../_internal/createCompounder';
+/**
+ * 将字符串转换为 kebab-case。
+ *
+ * @param string - 待转换的字符串
+ * @returns kebab-case 字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.kebabCase('Foo Bar');
+ * // => 'foo-bar'
+ *
+ * zhiaiwanUtils.kebabCase('fooBar');
+ * // => 'foo-bar'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default createCompounder((result, word, index) => {
+    return result + (index ? '-' : '') + word.toLowerCase();
+});

package/dist/esm/string/lowerCase.js

@@ -0,0 +1,19 @@
+import createCompounder from '../_internal/createCompounder';
+/**
+ * 将字符串按单词拆分为空格分隔的小写形式。
+ *
+ * @param string - 待转换字符串
+ * @returns 小写空格分隔字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.lowerCase('--Foo-Bar--');
+ * // => 'foo bar'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default createCompounder((result, word, index) => {
+    return result + (index ? ' ' : '') + word.toLowerCase();
+});

package/dist/esm/string/pad.js

@@ -0,0 +1,25 @@
+import coerceToString from '../_internal/coerceToString';
+import { padString } from '../_internal/basePad';
+/**
+ * 将字符串填充到指定长度，默认用空格在两端补齐，多余填充优先加在右侧。
+ *
+ * @param value - 待处理的值
+ * @param length - 目标长度
+ * @param chars - 填充字符，默认为空格
+ * @returns 填充后的字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.pad('abc', 8);
+ * // => '  abc   '
+ *
+ * zhiaiwanUtils.pad('abc', 8, '_-');
+ * // => '_-abc_-_'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function pad(value, length, chars) {
+    return padString(coerceToString(value), length, chars, 'both');
+}

package/dist/esm/string/padEnd.js

@@ -0,0 +1,25 @@
+import coerceToString from '../_internal/coerceToString';
+import { padString } from '../_internal/basePad';
+/**
+ * 在字符串末尾填充到指定长度，默认使用空格。
+ *
+ * @param value - 待处理的值
+ * @param length - 目标长度
+ * @param chars - 填充字符，默认为空格
+ * @returns 填充后的字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.padEnd('abc', 6);
+ * // => 'abc   '
+ *
+ * zhiaiwanUtils.padEnd('abc', 6, '_-');
+ * // => 'abc_-_'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function padEnd(value, length, chars) {
+    return padString(coerceToString(value), length, chars, 'end');
+}

package/dist/esm/string/padStart.js

@@ -0,0 +1,25 @@
+import coerceToString from '../_internal/coerceToString';
+import { padString } from '../_internal/basePad';
+/**
+ * 在字符串开头填充到指定长度，默认使用空格。
+ *
+ * @param value - 待处理的值
+ * @param length - 目标长度
+ * @param chars - 填充字符，默认为空格
+ * @returns 填充后的字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.padStart('abc', 6);
+ * // => '   abc'
+ *
+ * zhiaiwanUtils.padStart('abc', 6, '_-');
+ * // => '_-_abc'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function padStart(value, length, chars) {
+    return padString(coerceToString(value), length, chars, 'start');
+}

package/dist/esm/string/repeat.js

@@ -0,0 +1,24 @@
+import coerceToString from '../_internal/coerceToString';
+import repeatString from '../_internal/repeatString';
+/**
+ * 将字符串重复 n 次；n 小于 1 时返回空字符串。
+ *
+ * @param value - 待重复的值
+ * @param n - 重复次数
+ * @returns 重复后的字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.repeat('*', 3);
+ * // => '***'
+ *
+ * zhiaiwanUtils.repeat('abc', 2);
+ * // => 'abcabc'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function repeat(value, n) {
+    return repeatString(coerceToString(value), n);
+}

package/dist/esm/string/snakeCase.js

@@ -0,0 +1,22 @@
+import createCompounder from '../_internal/createCompounder';
+/**
+ * 将字符串转换为 snake_case。
+ *
+ * @param string - 待转换的字符串
+ * @returns snake_case 字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.snakeCase('Foo Bar');
+ * // => 'foo_bar'
+ *
+ * zhiaiwanUtils.snakeCase('fooBar');
+ * // => 'foo_bar'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default createCompounder((result, word, index) => {
+    return result + (index ? '_' : '') + word.toLowerCase();
+});

package/dist/esm/string/startsWith.js

@@ -0,0 +1,28 @@
+import coerceToString from '../_internal/coerceToString';
+import toInteger from '../_internal/toInteger';
+/**
+ * 检查字符串是否以 target 开头。
+ *
+ * @param value - 待检查的字符串
+ * @param target - 要匹配的前缀
+ * @param position - 开始匹配的位置，默认为 0
+ * @returns 若匹配返回 true，否则返回 false
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.startsWith('abc', 'a');
+ * // => true
+ *
+ * zhiaiwanUtils.startsWith('abc', 'b');
+ * // => false
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function startsWith(value, target, position = 0) {
+    const string = coerceToString(value);
+    const search = coerceToString(target);
+    const normalizedPosition = Math.max(0, Math.min(toInteger(position), string.length));
+    return string.startsWith(search, normalizedPosition);
+}

package/dist/esm/string/trim.js

@@ -0,0 +1,24 @@
+import coerceToString from '../_internal/coerceToString';
+import { trimByChars } from '../_internal/baseTrim';
+/**
+ * 移除字符串两端的空白字符，或移除两端在 chars 中出现的字符。
+ *
+ * @param value - 待处理的值
+ * @param chars - 要移除的字符集合；省略时移除空白字符
+ * @returns 裁剪后的字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.trim('  abc  ');
+ * // => 'abc'
+ *
+ * zhiaiwanUtils.trim('-_-abc-_-', '_-');
+ * // => 'abc'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function trim(value, chars) {
+    return trimByChars(coerceToString(value), chars, 'both');
+}

package/dist/esm/string/trimEnd.js

@@ -0,0 +1,24 @@
+import coerceToString from '../_internal/coerceToString';
+import { trimByChars } from '../_internal/baseTrim';
+/**
+ * 移除字符串末尾的空白字符，或移除末尾在 chars 中出现的字符。
+ *
+ * @param value - 待处理的值
+ * @param chars - 要移除的字符集合；省略时移除空白字符
+ * @returns 裁剪后的字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.trimEnd('  abc  ');
+ * // => '  abc'
+ *
+ * zhiaiwanUtils.trimEnd('-_-abc-_-', '_-');
+ * // => '-_-abc'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function trimEnd(value, chars) {
+    return trimByChars(coerceToString(value), chars, 'end');
+}

package/dist/esm/string/trimStart.js

@@ -0,0 +1,24 @@
+import coerceToString from '../_internal/coerceToString';
+import { trimByChars } from '../_internal/baseTrim';
+/**
+ * 移除字符串开头的空白字符，或移除开头在 chars 中出现的字符。
+ *
+ * @param value - 待处理的值
+ * @param chars - 要移除的字符集合；省略时移除空白字符
+ * @returns 裁剪后的字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.trimStart('  abc  ');
+ * // => 'abc  '
+ *
+ * zhiaiwanUtils.trimStart('-_-abc-_-', '_-');
+ * // => 'abc-_-'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function trimStart(value, chars) {
+    return trimByChars(coerceToString(value), chars, 'start');
+}

package/dist/esm/string/unescape.js

@@ -0,0 +1,20 @@
+import coerceToString from '../_internal/coerceToString';
+import { unescapeHtml } from '../_internal/htmlEscape';
+/**
+ * 将 HTML 实体还原为对应字符。
+ *
+ * @param value - 待反转义的值
+ * @returns 反转义后的字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.unescape('fred, barney, & pebbles');
+ * // => 'fred, barney, & pebbles'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function unescape(value) {
+    return unescapeHtml(coerceToString(value));
+}

package/dist/esm/string/upperFirst.js

@@ -0,0 +1,19 @@
+import upperFirstInternal from '../_internal/upperFirst';
+/**
+ * 将字符串首字符转换为大写。
+ *
+ * @param string - 待转换字符串
+ * @returns 首字符大写后的字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.upperFirst('fred');
+ * // => 'Fred'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+export default function upperFirst(string) {
+    return upperFirstInternal(String(string !== null && string !== void 0 ? string : ''));
+}

package/dist/esm/tree/filterTreeNodes.js

@@ -0,0 +1,45 @@
+import { normalizeTreeMaxDepth } from '../_internal/baseTreeTraverse';
+import forEachTree from './forEachTree';
+/**
+ * 收集树中所有满足 `options.predicate` 的节点；DFS 遍历全部节点。
+ *
+ * @param tree - 树根节点或根节点数组
+ * @param options - 遍历与匹配配置，含 `predicate`、`maxDepth` 及字段映射项
+ * @returns 命中节点数组；`predicate` 未传或非函数时返回 `[]`
+ *
+ * @example
+ * ```ts
+ * filterTreeNodes(
+ *   {
+ *     id: 1,
+ *     title: '根',
+ *     children: [
+ *       { id: 2, title: '启用', status: 1 },
+ *       { id: 3, title: '禁用', status: 0 },
+ *     ],
+ *   },
+ *   { predicate: (node) => node.status === 1 },
+ * );
+ * // => [{ id: 2, title: '启用', status: 1 }]
+ * ```
+ *
+ * @since 1.0.0
+ * @category Tree
+ */
+export default function filterTreeNodes(tree, options) {
+    if (typeof (options === null || options === void 0 ? void 0 : options.predicate) !== 'function') {
+        return [];
+    }
+    if (tree == null) {
+        return [];
+    }
+    const { predicate, maxDepth: maxDepthInput, ...traverseOptions } = options;
+    const maxDepth = normalizeTreeMaxDepth(maxDepthInput);
+    const matched = [];
+    forEachTree(tree, (node, parent, depth, index, meta) => {
+        if (predicate(node, parent, depth, index, meta)) {
+            matched.push(node);
+        }
+    }, { ...traverseOptions, maxDepth });
+    return matched;
+}