zhiaiwan-utils 1.0.3

package/dist/cjs/object/pick.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = pick;
+const flattenPaths_1 = __importDefault(require("../_internal/flattenPaths"));
+const basePath_1 = require("../_internal/basePath");
+/**
+ * 从 object 中选取指定路径上的自有属性，组成新对象。
+ *
+ * @param object - 源对象
+ * @param paths - 要选取的属性路径，支持 `'a.b'` 字符串、键数组或混合传入
+ * @returns 由选取属性组成的新对象
+ *
+ * @example
+ * ```ts
+ * const obj = { a: { b: 1 }, c: 3 };
+ * zhiaiwanUtils.pick(obj, 'a.b', 'c');
+ * // => { a: { b: 1 }, c: 3 }
+ * ```
+ *
+ * @since 1.0.0
+ * @category Object
+ */
+function pick(object, ...paths) {
+    if (object == null) {
+        return {};
+    }
+    const result = {};
+    for (const path of (0, flattenPaths_1.default)(paths)) {
+        if ((0, basePath_1.hasPath)(object, path)) {
+            (0, basePath_1.setPathValue)(result, path, (0, basePath_1.getPathValue)(object, path));
+        }
+    }
+    return result;
+}

package/dist/cjs/object/pickBy.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = pickBy;
+const baseIteratee_1 = __importDefault(require("../_internal/baseIteratee"));
+const baseKeysIn_1 = __importDefault(require("../_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
+ */
+function pickBy(object, predicate = (0, baseIteratee_1.default)()) {
+    if (object == null) {
+        return {};
+    }
+    const resolvedPredicate = (0, baseIteratee_1.default)(predicate);
+    const result = {};
+    for (const key of (0, baseKeysIn_1.default)(object)) {
+        const value = object[key];
+        if (resolvedPredicate(value, key, object)) {
+            result[key] = value;
+        }
+    }
+    return result;
+}

package/dist/cjs/object/set.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = set;
+const isIndex_1 = __importDefault(require("../_internal/isIndex"));
+const toPath_1 = __importDefault(require("../_internal/toPath"));
+function createNestedValue(nextKey) {
+    return (0, isIndex_1.default)(nextKey) ? [] : {};
+}
+function assignValue(container, key, value) {
+    if (Array.isArray(container) && (0, isIndex_1.default)(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
+ */
+function set(object, path, value) {
+    const keys = (0, toPath_1.default)(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/cjs/object/unset.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = unset;
+const baseUnset_1 = __importDefault(require("../_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
+ */
+function unset(object, path) {
+    return (0, baseUnset_1.default)(object, path);
+}

package/dist/cjs/object/update.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const baseUpdate_1 = __importDefault(require("../_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
+ */
+function update(object, path, updater) {
+    if (object == null) {
+        return object;
+    }
+    return (0, baseUpdate_1.default)(object, path, updater);
+}

package/dist/cjs/object/updateWith.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = updateWith;
+const baseUpdate_1 = __importDefault(require("../_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
+ */
+function updateWith(object, path, updater, customizer) {
+    if (object == null) {
+        return object;
+    }
+    const resolvedCustomizer = typeof customizer === 'function' ? customizer : undefined;
+    return (0, baseUpdate_1.default)(object, path, updater, resolvedCustomizer);
+}

package/dist/cjs/object/values.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = values;
+const baseCollectionKeys_1 = require("../_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
+ */
+function values(object) {
+    return (0, baseCollectionKeys_1.baseValues)(object);
+}

package/dist/cjs/string/camelCase.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = camelCase;
+const deburr_1 = __importDefault(require("../_internal/deburr"));
+const upperFirst_1 = __importDefault(require("../_internal/upperFirst"));
+const words_1 = __importDefault(require("../_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
+ */
+function camelCase(string) {
+    const input = String(string !== null && string !== void 0 ? string : '');
+    if (!input) {
+        return '';
+    }
+    return (0, words_1.default)((0, deburr_1.default)(input).replace(/['\u2019]/g, '')).reduce((result, word, index) => {
+        const lower = word.toLowerCase();
+        return result + (index ? (0, upperFirst_1.default)(lower) : lower);
+    }, '');
+}

package/dist/cjs/string/capitalize.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = capitalize;
+const upperFirst_1 = __importDefault(require("../_internal/upperFirst"));
+/**
+ * 首字母大写，其余小写。
+ *
+ * @param string - 待转换字符串
+ * @returns 首字母大写后的字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.capitalize('FRED');
+ * // => 'Fred'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+function capitalize(string) {
+    return (0, upperFirst_1.default)(String(string !== null && string !== void 0 ? string : '').toLowerCase());
+}

package/dist/cjs/string/endsWith.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = endsWith;
+const coerceToString_1 = __importDefault(require("../_internal/coerceToString"));
+const toInteger_1 = __importDefault(require("../_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
+ */
+function endsWith(value, target, position) {
+    const string = (0, coerceToString_1.default)(value);
+    const search = (0, coerceToString_1.default)(target);
+    const normalizedPosition = position === undefined
+        ? string.length
+        : Math.max(0, Math.min((0, toInteger_1.default)(position), string.length));
+    return string.endsWith(search, normalizedPosition);
+}

package/dist/cjs/string/escape.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = escape;
+const coerceToString_1 = __importDefault(require("../_internal/coerceToString"));
+const htmlEscape_1 = require("../_internal/htmlEscape");
+/**
+ * 将字符串中的 `&`、`<`、`>`、`"`、`'` 转为对应 HTML 实体。
+ *
+ * @param value - 待转义的值
+ * @returns 转义后的字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.escape('fred, barney, & pebbles');
+ * // => 'fred, barney, &amp; pebbles'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+function escape(value) {
+    return (0, htmlEscape_1.escapeHtml)((0, coerceToString_1.default)(value));
+}

package/dist/cjs/string/index.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.upperFirst = exports.lowerCase = exports.capitalize = exports.snakeCase = exports.kebabCase = exports.camelCase = exports.repeat = exports.unescape = exports.escape = exports.padEnd = exports.padStart = exports.pad = exports.endsWith = exports.startsWith = exports.trimEnd = exports.trimStart = exports.trim = void 0;
+var trim_1 = require("./trim");
+Object.defineProperty(exports, "trim", { enumerable: true, get: function () { return __importDefault(trim_1).default; } });
+var trimStart_1 = require("./trimStart");
+Object.defineProperty(exports, "trimStart", { enumerable: true, get: function () { return __importDefault(trimStart_1).default; } });
+var trimEnd_1 = require("./trimEnd");
+Object.defineProperty(exports, "trimEnd", { enumerable: true, get: function () { return __importDefault(trimEnd_1).default; } });
+var startsWith_1 = require("./startsWith");
+Object.defineProperty(exports, "startsWith", { enumerable: true, get: function () { return __importDefault(startsWith_1).default; } });
+var endsWith_1 = require("./endsWith");
+Object.defineProperty(exports, "endsWith", { enumerable: true, get: function () { return __importDefault(endsWith_1).default; } });
+var pad_1 = require("./pad");
+Object.defineProperty(exports, "pad", { enumerable: true, get: function () { return __importDefault(pad_1).default; } });
+var padStart_1 = require("./padStart");
+Object.defineProperty(exports, "padStart", { enumerable: true, get: function () { return __importDefault(padStart_1).default; } });
+var padEnd_1 = require("./padEnd");
+Object.defineProperty(exports, "padEnd", { enumerable: true, get: function () { return __importDefault(padEnd_1).default; } });
+var escape_1 = require("./escape");
+Object.defineProperty(exports, "escape", { enumerable: true, get: function () { return __importDefault(escape_1).default; } });
+var unescape_1 = require("./unescape");
+Object.defineProperty(exports, "unescape", { enumerable: true, get: function () { return __importDefault(unescape_1).default; } });
+var repeat_1 = require("./repeat");
+Object.defineProperty(exports, "repeat", { enumerable: true, get: function () { return __importDefault(repeat_1).default; } });
+var camelCase_1 = require("./camelCase");
+Object.defineProperty(exports, "camelCase", { enumerable: true, get: function () { return __importDefault(camelCase_1).default; } });
+var kebabCase_1 = require("./kebabCase");
+Object.defineProperty(exports, "kebabCase", { enumerable: true, get: function () { return __importDefault(kebabCase_1).default; } });
+var snakeCase_1 = require("./snakeCase");
+Object.defineProperty(exports, "snakeCase", { enumerable: true, get: function () { return __importDefault(snakeCase_1).default; } });
+var capitalize_1 = require("./capitalize");
+Object.defineProperty(exports, "capitalize", { enumerable: true, get: function () { return __importDefault(capitalize_1).default; } });
+var lowerCase_1 = require("./lowerCase");
+Object.defineProperty(exports, "lowerCase", { enumerable: true, get: function () { return __importDefault(lowerCase_1).default; } });
+var upperFirst_1 = require("./upperFirst");
+Object.defineProperty(exports, "upperFirst", { enumerable: true, get: function () { return __importDefault(upperFirst_1).default; } });

package/dist/cjs/string/kebabCase.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const createCompounder_1 = __importDefault(require("../_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
+ */
+exports.default = (0, createCompounder_1.default)((result, word, index) => {
+    return result + (index ? '-' : '') + word.toLowerCase();
+});

package/dist/cjs/string/lowerCase.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const createCompounder_1 = __importDefault(require("../_internal/createCompounder"));
+/**
+ * 将字符串按单词拆分为空格分隔的小写形式。
+ *
+ * @param string - 待转换字符串
+ * @returns 小写空格分隔字符串
+ *
+ * @example
+ * ```ts
+ * zhiaiwanUtils.lowerCase('--Foo-Bar--');
+ * // => 'foo bar'
+ * ```
+ *
+ * @since 1.0.0
+ * @category String
+ */
+exports.default = (0, createCompounder_1.default)((result, word, index) => {
+    return result + (index ? ' ' : '') + word.toLowerCase();
+});

package/dist/cjs/string/pad.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = pad;
+const coerceToString_1 = __importDefault(require("../_internal/coerceToString"));
+const basePad_1 = require("../_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
+ */
+function pad(value, length, chars) {
+    return (0, basePad_1.padString)((0, coerceToString_1.default)(value), length, chars, 'both');
+}

package/dist/cjs/string/padEnd.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = padEnd;
+const coerceToString_1 = __importDefault(require("../_internal/coerceToString"));
+const basePad_1 = require("../_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
+ */
+function padEnd(value, length, chars) {
+    return (0, basePad_1.padString)((0, coerceToString_1.default)(value), length, chars, 'end');
+}

package/dist/cjs/string/padStart.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = padStart;
+const coerceToString_1 = __importDefault(require("../_internal/coerceToString"));
+const basePad_1 = require("../_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
+ */
+function padStart(value, length, chars) {
+    return (0, basePad_1.padString)((0, coerceToString_1.default)(value), length, chars, 'start');
+}

package/dist/cjs/string/repeat.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = repeat;
+const coerceToString_1 = __importDefault(require("../_internal/coerceToString"));
+const repeatString_1 = __importDefault(require("../_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
+ */
+function repeat(value, n) {
+    return (0, repeatString_1.default)((0, coerceToString_1.default)(value), n);
+}

package/dist/cjs/string/snakeCase.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const createCompounder_1 = __importDefault(require("../_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
+ */
+exports.default = (0, createCompounder_1.default)((result, word, index) => {
+    return result + (index ? '_' : '') + word.toLowerCase();
+});