@tanwan/utils 1.1.0 → 1.2.0

package/dist/formatBankCard.js

@@ -0,0 +1,19 @@
+//#region src/business/formatBankCard/index.ts
+/**
+* 银行卡号格式化，每 4 位用空格分隔
+*
+* @param cardNo - 银行卡号
+* @returns 格式化后的卡号
+*
+* @example
+* ```ts
+* import formatBankCard from '@tanwan/utils/formatBankCard'
+* formatBankCard('6222021234567890')
+* // '6222 0212 3456 7890'
+* ```
+*/
+function formatBankCard(cardNo) {
+	return cardNo.replace(/(\d{4})(?=\d)/g, "$1 ");
+}
+//#endregion
+export { formatBankCard as default };

package/dist/formatCurrency.cjs

@@ -0,0 +1,7 @@
+//#region src/business/formatCurrency/index.ts
+function formatCurrency(amount, options = {}) {
+	const { unit = "cent", symbol = "¥", decimals = 2 } = options;
+	return `${symbol}${(unit === "cent" ? amount / 100 : amount).toFixed(decimals).replace(/\B(?=(\d{3})+(?!\d))/g, ",")}`;
+}
+//#endregion
+module.exports = formatCurrency;

package/dist/formatCurrency.d.cts

@@ -0,0 +1,27 @@
+//#region src/business/formatCurrency/index.d.ts
+/**
+* 金额格式化
+*
+* @param amount - 金额（分，整数），或元（当 unit 为 'yuan' 时）
+* @param options - 配置项
+* @param options.unit - 单位，`'cent'`（分，默认）| `'yuan'`（元）
+* @param options.symbol - 货币符号，默认 `'¥'`
+* @param options.decimals - 小数位数，默认 2
+* @returns 格式化后的金额字符串
+*
+* @example
+* ```ts
+* import formatCurrency from '@tanwan/utils/formatCurrency'
+* formatCurrency(1234567)          // '¥12,345.67'（分 → 元）
+* formatCurrency(12345, { unit: 'yuan' })   // '¥12,345.00'
+* formatCurrency(1234567, { symbol: '$' })  // '$12,345.67'
+* formatCurrency(1234567, { decimals: 0 })  // '¥12,346'
+* ```
+*/
+interface FormatCurrencyOptions {
+  unit?: "cent" | "yuan";
+  symbol?: string;
+  decimals?: number;
+}
+declare function formatCurrency(amount: number, options?: FormatCurrencyOptions): string;
+export = formatCurrency;

package/dist/formatCurrency.d.ts

@@ -0,0 +1,28 @@
+//#region src/business/formatCurrency/index.d.ts
+/**
+* 金额格式化
+*
+* @param amount - 金额（分，整数），或元（当 unit 为 'yuan' 时）
+* @param options - 配置项
+* @param options.unit - 单位，`'cent'`（分，默认）| `'yuan'`（元）
+* @param options.symbol - 货币符号，默认 `'¥'`
+* @param options.decimals - 小数位数，默认 2
+* @returns 格式化后的金额字符串
+*
+* @example
+* ```ts
+* import formatCurrency from '@tanwan/utils/formatCurrency'
+* formatCurrency(1234567)          // '¥12,345.67'（分 → 元）
+* formatCurrency(12345, { unit: 'yuan' })   // '¥12,345.00'
+* formatCurrency(1234567, { symbol: '$' })  // '$12,345.67'
+* formatCurrency(1234567, { decimals: 0 })  // '¥12,346'
+* ```
+*/
+interface FormatCurrencyOptions {
+  unit?: "cent" | "yuan";
+  symbol?: string;
+  decimals?: number;
+}
+declare function formatCurrency(amount: number, options?: FormatCurrencyOptions): string;
+//#endregion
+export { formatCurrency as default };

package/dist/formatCurrency.js

@@ -0,0 +1,7 @@
+//#region src/business/formatCurrency/index.ts
+function formatCurrency(amount, options = {}) {
+	const { unit = "cent", symbol = "¥", decimals = 2 } = options;
+	return `${symbol}${(unit === "cent" ? amount / 100 : amount).toFixed(decimals).replace(/\B(?=(\d{3})+(?!\d))/g, ",")}`;
+}
+//#endregion
+export { formatCurrency as default };

package/dist/{date/formatDate.d.cts → formatDate.d.cts}

@@ -9,5 +9,4 @@
 * ```
 */
 declare function formatDate(date: number | string | Date, fmt?: string): string;
-export = formatDate;
-//# sourceMappingURL=formatDate.d.cts.map
+export = formatDate;

package/dist/{date/formatDate.d.ts → formatDate.d.ts}

@@ -10,5 +10,4 @@
 */
 declare function formatDate(date: number | string | Date, fmt?: string): string;
 //#endregion
-export { formatDate as default };
-//# sourceMappingURL=formatDate.d.ts.map
+export { formatDate as default };

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

@@ -36,5 +36,3 @@ function formatDate(date, fmt = "yyyy-MM-dd HH:mm:ss") {
 }
 //#endregion
 export { formatDate as default };
-
-//# sourceMappingURL=formatDate.js.map

package/dist/formatFileSize.cjs

@@ -0,0 +1,33 @@
+//#region src/business/formatFileSize/index.ts
+/**
+* 文件大小格式化
+*
+* @param bytes - 字节数
+* @param decimals - 小数位数，默认 2
+* @returns 格式化后的文件大小字符串
+*
+* @example
+* ```ts
+* import formatFileSize from '@tanwan/utils/formatFileSize'
+* formatFileSize(0)           // '0 B'
+* formatFileSize(1024)        // '1 KB'
+* formatFileSize(1536000)     // '1.46 MB'
+* formatFileSize(1073741824)  // '1 GB'
+* ```
+*/
+function formatFileSize(bytes, decimals = 2) {
+	if (bytes === 0) return "0 B";
+	const units = [
+		"B",
+		"KB",
+		"MB",
+		"GB",
+		"TB",
+		"PB"
+	];
+	const k = 1024;
+	const i = Math.floor(Math.log(bytes) / Math.log(k));
+	return `${Number.parseFloat((bytes / k ** i).toFixed(decimals))} ${units[i]}`;
+}
+//#endregion
+module.exports = formatFileSize;

package/dist/formatFileSize.d.cts

@@ -0,0 +1,19 @@
+//#region src/business/formatFileSize/index.d.ts
+/**
+* 文件大小格式化
+*
+* @param bytes - 字节数
+* @param decimals - 小数位数，默认 2
+* @returns 格式化后的文件大小字符串
+*
+* @example
+* ```ts
+* import formatFileSize from '@tanwan/utils/formatFileSize'
+* formatFileSize(0)           // '0 B'
+* formatFileSize(1024)        // '1 KB'
+* formatFileSize(1536000)     // '1.46 MB'
+* formatFileSize(1073741824)  // '1 GB'
+* ```
+*/
+declare function formatFileSize(bytes: number, decimals?: number): string;
+export = formatFileSize;

package/dist/formatFileSize.d.ts

@@ -0,0 +1,20 @@
+//#region src/business/formatFileSize/index.d.ts
+/**
+* 文件大小格式化
+*
+* @param bytes - 字节数
+* @param decimals - 小数位数，默认 2
+* @returns 格式化后的文件大小字符串
+*
+* @example
+* ```ts
+* import formatFileSize from '@tanwan/utils/formatFileSize'
+* formatFileSize(0)           // '0 B'
+* formatFileSize(1024)        // '1 KB'
+* formatFileSize(1536000)     // '1.46 MB'
+* formatFileSize(1073741824)  // '1 GB'
+* ```
+*/
+declare function formatFileSize(bytes: number, decimals?: number): string;
+//#endregion
+export { formatFileSize as default };

package/dist/formatFileSize.js

@@ -0,0 +1,33 @@
+//#region src/business/formatFileSize/index.ts
+/**
+* 文件大小格式化
+*
+* @param bytes - 字节数
+* @param decimals - 小数位数，默认 2
+* @returns 格式化后的文件大小字符串
+*
+* @example
+* ```ts
+* import formatFileSize from '@tanwan/utils/formatFileSize'
+* formatFileSize(0)           // '0 B'
+* formatFileSize(1024)        // '1 KB'
+* formatFileSize(1536000)     // '1.46 MB'
+* formatFileSize(1073741824)  // '1 GB'
+* ```
+*/
+function formatFileSize(bytes, decimals = 2) {
+	if (bytes === 0) return "0 B";
+	const units = [
+		"B",
+		"KB",
+		"MB",
+		"GB",
+		"TB",
+		"PB"
+	];
+	const k = 1024;
+	const i = Math.floor(Math.log(bytes) / Math.log(k));
+	return `${Number.parseFloat((bytes / k ** i).toFixed(decimals))} ${units[i]}`;
+}
+//#endregion
+export { formatFileSize as default };

package/dist/formatIdCard.cjs

@@ -0,0 +1,21 @@
+//#region src/business/formatIdCard/index.ts
+/**
+* 身份证号格式化 / 脱敏
+*
+* @param idCard - 18 位身份证号
+* @param mode - `'display'`（显示） | `'mask'`（脱敏，默认）
+* @returns 格式化后的身份证号
+*
+* @example
+* ```ts
+* import formatIdCard from '@tanwan/utils/formatIdCard'
+* formatIdCard('510123199001011234')             // '510123********1234'
+* formatIdCard('510123199001011234', 'display')  // '510123 19900101 1234'
+* ```
+*/
+function formatIdCard(idCard, mode = "mask") {
+	if (mode === "display") return idCard.replace(/(\d{6})(\d{8})(\d{4})/, "$1 $2 $3");
+	return idCard.replace(/(\d{6})\d{8}(\d{4})/, "$1********$2");
+}
+//#endregion
+module.exports = formatIdCard;

package/dist/formatIdCard.d.cts

@@ -0,0 +1,17 @@
+//#region src/business/formatIdCard/index.d.ts
+/**
+* 身份证号格式化 / 脱敏
+*
+* @param idCard - 18 位身份证号
+* @param mode - `'display'`（显示） | `'mask'`（脱敏，默认）
+* @returns 格式化后的身份证号
+*
+* @example
+* ```ts
+* import formatIdCard from '@tanwan/utils/formatIdCard'
+* formatIdCard('510123199001011234')             // '510123********1234'
+* formatIdCard('510123199001011234', 'display')  // '510123 19900101 1234'
+* ```
+*/
+declare function formatIdCard(idCard: string, mode?: "display" | "mask"): string;
+export = formatIdCard;

package/dist/formatIdCard.d.ts

@@ -0,0 +1,18 @@
+//#region src/business/formatIdCard/index.d.ts
+/**
+* 身份证号格式化 / 脱敏
+*
+* @param idCard - 18 位身份证号
+* @param mode - `'display'`（显示） | `'mask'`（脱敏，默认）
+* @returns 格式化后的身份证号
+*
+* @example
+* ```ts
+* import formatIdCard from '@tanwan/utils/formatIdCard'
+* formatIdCard('510123199001011234')             // '510123********1234'
+* formatIdCard('510123199001011234', 'display')  // '510123 19900101 1234'
+* ```
+*/
+declare function formatIdCard(idCard: string, mode?: "display" | "mask"): string;
+//#endregion
+export { formatIdCard as default };

package/dist/formatIdCard.js

@@ -0,0 +1,21 @@
+//#region src/business/formatIdCard/index.ts
+/**
+* 身份证号格式化 / 脱敏
+*
+* @param idCard - 18 位身份证号
+* @param mode - `'display'`（显示） | `'mask'`（脱敏，默认）
+* @returns 格式化后的身份证号
+*
+* @example
+* ```ts
+* import formatIdCard from '@tanwan/utils/formatIdCard'
+* formatIdCard('510123199001011234')             // '510123********1234'
+* formatIdCard('510123199001011234', 'display')  // '510123 19900101 1234'
+* ```
+*/
+function formatIdCard(idCard, mode = "mask") {
+	if (mode === "display") return idCard.replace(/(\d{6})(\d{8})(\d{4})/, "$1 $2 $3");
+	return idCard.replace(/(\d{6})\d{8}(\d{4})/, "$1********$2");
+}
+//#endregion
+export { formatIdCard as default };

package/dist/formatPhone.cjs

@@ -0,0 +1,21 @@
+//#region src/business/formatPhone/index.ts
+/**
+* 手机号格式化
+*
+* @param phone - 11 位手机号字符串
+* @param mode - `'display'`（显示：188-1234-5678，默认）| `'mask'`（脱敏：188****5678）
+* @returns 格式化后的手机号
+*
+* @example
+* ```ts
+* import formatPhone from '@tanwan/utils/formatPhone'
+* formatPhone('18812345678')              // '188-1234-5678'
+* formatPhone('18812345678', 'mask')      // '188****5678'
+* ```
+*/
+function formatPhone(phone, mode = "display") {
+	if (mode === "mask") return phone.replace(/(\d{3})\d{4}(\d{4})/, "$1****$2");
+	return phone.replace(/(\d{3})(\d{4})(\d{4})/, "$1-$2-$3");
+}
+//#endregion
+module.exports = formatPhone;

package/dist/formatPhone.d.cts

@@ -0,0 +1,17 @@
+//#region src/business/formatPhone/index.d.ts
+/**
+* 手机号格式化
+*
+* @param phone - 11 位手机号字符串
+* @param mode - `'display'`（显示：188-1234-5678，默认）| `'mask'`（脱敏：188****5678）
+* @returns 格式化后的手机号
+*
+* @example
+* ```ts
+* import formatPhone from '@tanwan/utils/formatPhone'
+* formatPhone('18812345678')              // '188-1234-5678'
+* formatPhone('18812345678', 'mask')      // '188****5678'
+* ```
+*/
+declare function formatPhone(phone: string, mode?: "display" | "mask"): string;
+export = formatPhone;

package/dist/formatPhone.d.ts

@@ -0,0 +1,18 @@
+//#region src/business/formatPhone/index.d.ts
+/**
+* 手机号格式化
+*
+* @param phone - 11 位手机号字符串
+* @param mode - `'display'`（显示：188-1234-5678，默认）| `'mask'`（脱敏：188****5678）
+* @returns 格式化后的手机号
+*
+* @example
+* ```ts
+* import formatPhone from '@tanwan/utils/formatPhone'
+* formatPhone('18812345678')              // '188-1234-5678'
+* formatPhone('18812345678', 'mask')      // '188****5678'
+* ```
+*/
+declare function formatPhone(phone: string, mode?: "display" | "mask"): string;
+//#endregion
+export { formatPhone as default };

package/dist/formatPhone.js

@@ -0,0 +1,21 @@
+//#region src/business/formatPhone/index.ts
+/**
+* 手机号格式化
+*
+* @param phone - 11 位手机号字符串
+* @param mode - `'display'`（显示：188-1234-5678，默认）| `'mask'`（脱敏：188****5678）
+* @returns 格式化后的手机号
+*
+* @example
+* ```ts
+* import formatPhone from '@tanwan/utils/formatPhone'
+* formatPhone('18812345678')              // '188-1234-5678'
+* formatPhone('18812345678', 'mask')      // '188****5678'
+* ```
+*/
+function formatPhone(phone, mode = "display") {
+	if (mode === "mask") return phone.replace(/(\d{3})\d{4}(\d{4})/, "$1****$2");
+	return phone.replace(/(\d{3})(\d{4})(\d{4})/, "$1-$2-$3");
+}
+//#endregion
+export { formatPhone as default };

package/dist/{number/formatThousands.d.cts → formatThousands.d.cts}

@@ -9,5 +9,4 @@
 * ```
 */
 declare function formatThousands(num: number | string): string;
-export = formatThousands;
-//# sourceMappingURL=formatThousands.d.cts.map
+export = formatThousands;

package/dist/{number/formatThousands.d.ts → formatThousands.d.ts}

@@ -10,5 +10,4 @@
 */
 declare function formatThousands(num: number | string): string;
 //#endregion
-export { formatThousands as default };
-//# sourceMappingURL=formatThousands.d.ts.map
+export { formatThousands as default };

package/dist/{number/formatThousands.js → formatThousands.js}

@@ -15,5 +15,3 @@ function formatThousands(num) {
 }
 //#endregion
 export { formatThousands as default };
-
-//# sourceMappingURL=formatThousands.js.map

package/dist/generateCode.cjs

@@ -0,0 +1,29 @@
+//#region src/business/generateCode/index.ts
+/**
+* 生成随机验证码
+*
+* @param length - 验证码长度，默认 6
+* @param type - 类型：`'number'` | `'letter'` | `'mixed'`（默认）
+* @returns 随机验证码字符串
+*
+* @example
+* ```ts
+* import generateCode from '@tanwan/utils/generateCode'
+* generateCode()          // 'a3Bk9M'（混合）
+* generateCode(4)         // 'G2xP'
+* generateCode(6, 'number') // '382410'
+* generateCode(6, 'letter') // 'aBcDeF'
+* ```
+*/
+function generateCode(length = 6, type = "mixed") {
+	const pool = {
+		number: "0123456789",
+		letter: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",
+		mixed: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"
+	}[type];
+	let result = "";
+	for (let i = 0; i < length; i++) result += pool[Math.floor(Math.random() * pool.length)];
+	return result;
+}
+//#endregion
+module.exports = generateCode;

package/dist/generateCode.d.cts

@@ -0,0 +1,19 @@
+//#region src/business/generateCode/index.d.ts
+/**
+* 生成随机验证码
+*
+* @param length - 验证码长度，默认 6
+* @param type - 类型：`'number'` | `'letter'` | `'mixed'`（默认）
+* @returns 随机验证码字符串
+*
+* @example
+* ```ts
+* import generateCode from '@tanwan/utils/generateCode'
+* generateCode()          // 'a3Bk9M'（混合）
+* generateCode(4)         // 'G2xP'
+* generateCode(6, 'number') // '382410'
+* generateCode(6, 'letter') // 'aBcDeF'
+* ```
+*/
+declare function generateCode(length?: number, type?: "number" | "letter" | "mixed"): string;
+export = generateCode;

package/dist/generateCode.d.ts

@@ -0,0 +1,20 @@
+//#region src/business/generateCode/index.d.ts
+/**
+* 生成随机验证码
+*
+* @param length - 验证码长度，默认 6
+* @param type - 类型：`'number'` | `'letter'` | `'mixed'`（默认）
+* @returns 随机验证码字符串
+*
+* @example
+* ```ts
+* import generateCode from '@tanwan/utils/generateCode'
+* generateCode()          // 'a3Bk9M'（混合）
+* generateCode(4)         // 'G2xP'
+* generateCode(6, 'number') // '382410'
+* generateCode(6, 'letter') // 'aBcDeF'
+* ```
+*/
+declare function generateCode(length?: number, type?: "number" | "letter" | "mixed"): string;
+//#endregion
+export { generateCode as default };

package/dist/generateCode.js

@@ -0,0 +1,29 @@
+//#region src/business/generateCode/index.ts
+/**
+* 生成随机验证码
+*
+* @param length - 验证码长度，默认 6
+* @param type - 类型：`'number'` | `'letter'` | `'mixed'`（默认）
+* @returns 随机验证码字符串
+*
+* @example
+* ```ts
+* import generateCode from '@tanwan/utils/generateCode'
+* generateCode()          // 'a3Bk9M'（混合）
+* generateCode(4)         // 'G2xP'
+* generateCode(6, 'number') // '382410'
+* generateCode(6, 'letter') // 'aBcDeF'
+* ```
+*/
+function generateCode(length = 6, type = "mixed") {
+	const pool = {
+		number: "0123456789",
+		letter: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",
+		mixed: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"
+	}[type];
+	let result = "";
+	for (let i = 0; i < length; i++) result += pool[Math.floor(Math.random() * pool.length)];
+	return result;
+}
+//#endregion
+export { generateCode as default };

package/dist/getAge.cjs

@@ -0,0 +1,30 @@
+//#region src/business/getAge/index.ts
+/**
+* 计算年龄
+*
+* @param source - 身份证号（18 位）或 `YYYY-MM-DD` 日期字符串
+* @param baseDate - 计算的基准日期，默认为当天
+* @returns 年龄（周岁）
+*
+* @example
+* ```ts
+* import getAge from '@tanwan/utils/getAge'
+* getAge('1990-05-15')                  // 按当天计算
+* getAge('110101199001011234')          // 从身份证计算
+* getAge('1990-05-15', '2024-01-01')    // 按指定日期计算
+* ```
+*/
+function getAge(source, baseDate) {
+	let birthStr;
+	if (source.length === 18) birthStr = `${source.substring(6, 10)}-${source.substring(10, 12)}-${source.substring(12, 14)}`;
+	else birthStr = source;
+	const birth = new Date(birthStr);
+	const base = baseDate ? new Date(baseDate) : /* @__PURE__ */ new Date();
+	let age = base.getFullYear() - birth.getFullYear();
+	const monthDiff = base.getMonth() - birth.getMonth();
+	const dayDiff = base.getDate() - birth.getDate();
+	if (monthDiff < 0 || monthDiff === 0 && dayDiff < 0) age--;
+	return age;
+}
+//#endregion
+module.exports = getAge;

package/dist/getAge.d.cts

@@ -0,0 +1,18 @@
+//#region src/business/getAge/index.d.ts
+/**
+* 计算年龄
+*
+* @param source - 身份证号（18 位）或 `YYYY-MM-DD` 日期字符串
+* @param baseDate - 计算的基准日期，默认为当天
+* @returns 年龄（周岁）
+*
+* @example
+* ```ts
+* import getAge from '@tanwan/utils/getAge'
+* getAge('1990-05-15')                  // 按当天计算
+* getAge('110101199001011234')          // 从身份证计算
+* getAge('1990-05-15', '2024-01-01')    // 按指定日期计算
+* ```
+*/
+declare function getAge(source: string, baseDate?: string | Date): number;
+export = getAge;

package/dist/getAge.d.ts

@@ -0,0 +1,19 @@
+//#region src/business/getAge/index.d.ts
+/**
+* 计算年龄
+*
+* @param source - 身份证号（18 位）或 `YYYY-MM-DD` 日期字符串
+* @param baseDate - 计算的基准日期，默认为当天
+* @returns 年龄（周岁）
+*
+* @example
+* ```ts
+* import getAge from '@tanwan/utils/getAge'
+* getAge('1990-05-15')                  // 按当天计算
+* getAge('110101199001011234')          // 从身份证计算
+* getAge('1990-05-15', '2024-01-01')    // 按指定日期计算
+* ```
+*/
+declare function getAge(source: string, baseDate?: string | Date): number;
+//#endregion
+export { getAge as default };

package/dist/getAge.js

@@ -0,0 +1,30 @@
+//#region src/business/getAge/index.ts
+/**
+* 计算年龄
+*
+* @param source - 身份证号（18 位）或 `YYYY-MM-DD` 日期字符串
+* @param baseDate - 计算的基准日期，默认为当天
+* @returns 年龄（周岁）
+*
+* @example
+* ```ts
+* import getAge from '@tanwan/utils/getAge'
+* getAge('1990-05-15')                  // 按当天计算
+* getAge('110101199001011234')          // 从身份证计算
+* getAge('1990-05-15', '2024-01-01')    // 按指定日期计算
+* ```
+*/
+function getAge(source, baseDate) {
+	let birthStr;
+	if (source.length === 18) birthStr = `${source.substring(6, 10)}-${source.substring(10, 12)}-${source.substring(12, 14)}`;
+	else birthStr = source;
+	const birth = new Date(birthStr);
+	const base = baseDate ? new Date(baseDate) : /* @__PURE__ */ new Date();
+	let age = base.getFullYear() - birth.getFullYear();
+	const monthDiff = base.getMonth() - birth.getMonth();
+	const dayDiff = base.getDate() - birth.getDate();
+	if (monthDiff < 0 || monthDiff === 0 && dayDiff < 0) age--;
+	return age;
+}
+//#endregion
+export { getAge as default };

package/dist/getByPath.cjs

@@ -0,0 +1,29 @@
+//#region src/object/getByPath/index.ts
+/**
+* 通过路径字符串安全获取嵌套对象的值
+*
+* @param obj - 源对象
+* @param path - 属性路径，支持点号分隔和方括号，如 `'a.b[0].c'`
+* @param defaultValue - 路径不存在时的默认值
+* @returns 路径对应的值，或默认值
+*
+* @example
+* ```ts
+* import getByPath from '@tanwan/utils/getByPath'
+* const obj = { a: { b: [{ c: 42 }] } }
+* getByPath(obj, 'a.b[0].c')       // 42
+* getByPath(obj, 'a.x.y')          // undefined
+* getByPath(obj, 'a.x.y', 'none')  // 'none'
+* ```
+*/
+function getByPath(obj, path, defaultValue) {
+	const keys = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
+	let current = obj;
+	for (const key of keys) {
+		if (current === null || current === void 0 || typeof current !== "object") return defaultValue;
+		current = current[key];
+	}
+	return current === void 0 ? defaultValue : current;
+}
+//#endregion
+module.exports = getByPath;