zcw-shared 1.46.2 → 1.47.0

package/dist/functions/data/date/timeAgo.js

@@ -0,0 +1,49 @@
+export function timeAgo(date, locale = 'zh') {
+    const d = typeof date === 'object' ? date : new Date(date);
+    if (isNaN(d.getTime())) {
+        throw new Error('Invalid date');
+    }
+    const now = Date.now();
+    const diff = now - d.getTime();
+    const seconds = Math.floor(diff / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    const months = Math.floor(days / 30);
+    const years = Math.floor(days / 365);
+    const formats = {
+        zh: {
+            justNow: '刚刚',
+            secondsAgo: (n) => `${n}秒前`,
+            minutesAgo: (n) => `${n}分钟前`,
+            hoursAgo: (n) => `${n}小时前`,
+            daysAgo: (n) => `${n}天前`,
+            monthsAgo: (n) => `${n}个月前`,
+            yearsAgo: (n) => `${n}年前`
+        },
+        en: {
+            justNow: 'just now',
+            secondsAgo: (n) => `${n} second${n > 1 ? 's' : ''} ago`,
+            minutesAgo: (n) => `${n} minute${n > 1 ? 's' : ''} ago`,
+            hoursAgo: (n) => `${n} hour${n > 1 ? 's' : ''} ago`,
+            daysAgo: (n) => `${n} day${n > 1 ? 's' : ''} ago`,
+            monthsAgo: (n) => `${n} month${n > 1 ? 's' : ''} ago`,
+            yearsAgo: (n) => `${n} year${n > 1 ? 's' : ''} ago`
+        }
+    };
+    const fmt = formats[locale];
+    if (seconds < 10)
+        return fmt.justNow;
+    if (seconds < 60)
+        return fmt.secondsAgo(seconds);
+    if (minutes < 60)
+        return fmt.minutesAgo(minutes);
+    if (hours < 24)
+        return fmt.hoursAgo(hours);
+    if (days < 30)
+        return fmt.daysAgo(days);
+    if (months < 12)
+        return fmt.monthsAgo(months);
+    return fmt.yearsAgo(years);
+}
+//# sourceMappingURL=timeAgo.js.map

package/dist/functions/data/date/timeAgo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeAgo.js","sourceRoot":"","sources":["../../../../src/functions/data/date/timeAgo.ts"],"names":[],"mappings":"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"}

package/dist/functions/data/number/average.d.ts

@@ -0,0 +1 @@
+export declare function average(numbers: number[]): number;

package/dist/functions/data/number/average.js

@@ -0,0 +1,8 @@
+export function average(numbers) {
+    if (numbers.length === 0) {
+        return 0;
+    }
+    const sum = numbers.reduce((acc, num) => acc + num, 0);
+    return sum / numbers.length;
+}
+//# sourceMappingURL=average.js.map

package/dist/functions/data/number/average.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"average.js","sourceRoot":"","sources":["../../../../src/functions/data/number/average.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,OAAO,CAAC,OAAiB;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,CAAA;IACV,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAA;IACtD,OAAO,GAAG,GAAG,OAAO,CAAC,MAAM,CAAA;AAC7B,CAAC"}

package/dist/functions/data/number/clamp.d.ts

@@ -0,0 +1 @@
+export declare function clamp(value: number, min: number, max: number): number;

package/dist/functions/data/number/clamp.js

@@ -0,0 +1,7 @@
+export function clamp(value, min, max) {
+    if (min > max) {
+        throw new Error('Min value cannot be greater than max value');
+    }
+    return Math.min(Math.max(value, min), max);
+}
+//# sourceMappingURL=clamp.js.map

package/dist/functions/data/number/clamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.js","sourceRoot":"","sources":["../../../../src/functions/data/number/clamp.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC3D,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC/D,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;AAC5C,CAAC"}

package/dist/functions/data/number/formatNumber.d.ts

@@ -0,0 +1,8 @@
+export interface FormatNumberOptions {
+    decimals?: number;
+    separator?: string;
+    decimalPoint?: string;
+    prefix?: string;
+    suffix?: string;
+}
+export declare function formatNumber(num: number, options?: FormatNumberOptions): string;

package/dist/functions/data/number/formatNumber.js

@@ -0,0 +1,16 @@
+export function formatNumber(num, options = {}) {
+    const { decimals, separator = ',', decimalPoint = '.', prefix = '', suffix = '' } = options;
+    let value = decimals !== undefined
+        ? num.toFixed(decimals)
+        : String(num);
+    const parts = value.split('.');
+    const integerPart = parts[0];
+    const decimalPart = parts[1] || '';
+    const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, separator);
+    let result = formattedInteger;
+    if (decimalPart) {
+        result += decimalPoint + decimalPart;
+    }
+    return `${prefix}${result}${suffix}`;
+}
+//# sourceMappingURL=formatNumber.js.map

package/dist/functions/data/number/formatNumber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatNumber.js","sourceRoot":"","sources":["../../../../src/functions/data/number/formatNumber.ts"],"names":[],"mappings":"AAmCA,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,UAA+B,EAAE;IAEjC,MAAM,EACJ,QAAQ,EACR,SAAS,GAAG,GAAG,EACf,YAAY,GAAG,GAAG,EAClB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACZ,GAAG,OAAO,CAAA;IAGX,IAAI,KAAK,GAAG,QAAQ,KAAK,SAAS;QAChC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC;QACvB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAGf,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC9B,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IAC5B,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAGlC,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAA;IAGhF,IAAI,MAAM,GAAG,gBAAgB,CAAA;IAC7B,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,YAAY,GAAG,WAAW,CAAA;IACtC,CAAC;IAED,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;AACtC,CAAC"}

package/dist/functions/data/number/median.d.ts

@@ -0,0 +1 @@
+export declare function median(numbers: number[]): number;

package/dist/functions/data/number/median.js

@@ -0,0 +1,14 @@
+export function median(numbers) {
+    if (numbers.length === 0) {
+        return 0;
+    }
+    const sorted = [...numbers].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 0) {
+        return (sorted[mid - 1] + sorted[mid]) / 2;
+    }
+    else {
+        return sorted[mid];
+    }
+}
+//# sourceMappingURL=median.js.map

package/dist/functions/data/number/median.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"median.js","sourceRoot":"","sources":["../../../../src/functions/data/number/median.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,MAAM,CAAC,OAAiB;IACtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,CAAA;IACV,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAEzC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAE5B,OAAO,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;IAC5C,CAAC;SAAM,CAAC;QAEN,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;IACpB,CAAC;AACH,CAAC"}

package/dist/functions/data/number/percentile.d.ts

@@ -0,0 +1 @@
+export declare function percentile(numbers: number[], p: number): number;

package/dist/functions/data/number/percentile.js

@@ -0,0 +1,18 @@
+export function percentile(numbers, p) {
+    if (numbers.length === 0) {
+        throw new Error('Array cannot be empty');
+    }
+    if (p < 0 || p > 100) {
+        throw new Error('Percentile must be between 0 and 100');
+    }
+    const sorted = [...numbers].sort((a, b) => a - b);
+    const index = (p / 100) * (sorted.length - 1);
+    if (Number.isInteger(index)) {
+        return sorted[index];
+    }
+    const lower = Math.floor(index);
+    const upper = Math.ceil(index);
+    const weight = index - lower;
+    return sorted[lower] * (1 - weight) + sorted[upper] * weight;
+}
+//# sourceMappingURL=percentile.js.map

package/dist/functions/data/number/percentile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"percentile.js","sourceRoot":"","sources":["../../../../src/functions/data/number/percentile.ts"],"names":[],"mappings":"AAwBA,MAAM,UAAU,UAAU,CAAC,OAAiB,EAAE,CAAS;IACrD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAC1C,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACjD,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAE7C,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC9B,MAAM,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;IAE5B,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAA;AAC9D,CAAC"}

package/dist/functions/data/number/random.d.ts

@@ -0,0 +1,4 @@
+export interface RandomOptions {
+    integer?: boolean;
+}
+export declare function random(min: number, max: number, options?: RandomOptions): number;

package/dist/functions/data/number/random.js

@@ -0,0 +1,9 @@
+export function random(min, max, options = {}) {
+    const { integer = true } = options;
+    if (min > max) {
+        [min, max] = [max, min];
+    }
+    const value = Math.random() * (max - min) + min;
+    return integer ? Math.floor(value) : value;
+}
+//# sourceMappingURL=random.js.map

package/dist/functions/data/number/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../../../src/functions/data/number/random.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,MAAM,CACpB,GAAW,EACX,GAAW,EACX,UAAyB,EAAE;IAE3B,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,OAAO,CAAA;IAElC,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACd,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IACzB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAA;IAE/C,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;AAC5C,CAAC"}

package/dist/functions/data/number/range.d.ts

@@ -0,0 +1 @@
+export declare function range(start: number, end: number, step?: number): number[];

package/dist/functions/data/number/range.js

@@ -0,0 +1,18 @@
+export function range(start, end, step = 1) {
+    if (step === 0) {
+        throw new Error('Step cannot be zero');
+    }
+    const result = [];
+    if (step > 0) {
+        for (let i = start; i < end; i += step) {
+            result.push(i);
+        }
+    }
+    else {
+        for (let i = start; i > end; i += step) {
+            result.push(i);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=range.js.map

package/dist/functions/data/number/range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.js","sourceRoot":"","sources":["../../../../src/functions/data/number/range.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,OAAe,CAAC;IAChE,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;IACxC,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/functions/data/number/sum.d.ts

@@ -0,0 +1 @@
+export declare function sum(numbers: number[]): number;

package/dist/functions/data/number/sum.js

@@ -0,0 +1,4 @@
+export function sum(numbers) {
+    return numbers.reduce((acc, num) => acc + num, 0);
+}
+//# sourceMappingURL=sum.js.map

package/dist/functions/data/number/sum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sum.js","sourceRoot":"","sources":["../../../../src/functions/data/number/sum.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,GAAG,CAAC,OAAiB;IACnC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAA;AACnD,CAAC"}

package/dist/functions/data/randomRegion.d.ts

@@ -0,0 +1,24 @@
+interface RegionCity {
+    name: string;
+    code: string;
+    area?: Array<{
+        name: string;
+        code: string;
+    }>;
+}
+interface RegionProvince {
+    name: string;
+    code: string;
+    city?: RegionCity[];
+}
+export interface RandomRegionResult {
+    province: string;
+    provinceCode: string;
+    city: string | null;
+    cityCode: string | null;
+    county: string | null;
+    countyCode: string | null;
+    fullPath: string;
+}
+export declare function randomRegion(regionData: RegionProvince[], codePrefix?: string): RandomRegionResult;
+export {};

package/dist/functions/data/randomRegion.js

@@ -0,0 +1,74 @@
+function randomInt(min, max) {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+export function randomRegion(regionData, codePrefix) {
+    let filteredProvinces = regionData;
+    if (codePrefix && codePrefix.length >= 2) {
+        const prefix2 = codePrefix.slice(0, 2);
+        filteredProvinces = regionData.filter(p => p.code.startsWith(prefix2));
+        if (filteredProvinces.length === 0) {
+            filteredProvinces = regionData;
+        }
+    }
+    const province = filteredProvinces[randomInt(0, filteredProvinces.length - 1)];
+    if (!province.city || province.city.length === 0) {
+        return {
+            province: province.name,
+            provinceCode: province.code,
+            city: null,
+            cityCode: null,
+            county: null,
+            countyCode: null,
+            fullPath: province.name
+        };
+    }
+    let filteredCities = province.city;
+    if (codePrefix && codePrefix.length >= 4) {
+        const prefix4 = codePrefix.slice(0, 4);
+        filteredCities = province.city.filter(c => c.code && c.code.startsWith(prefix4));
+        if (filteredCities.length === 0) {
+            filteredCities = province.city;
+        }
+    }
+    const city = filteredCities[randomInt(0, filteredCities.length - 1)];
+    if (!city.area || city.area.length === 0) {
+        return {
+            province: province.name,
+            provinceCode: province.code,
+            city: city.name,
+            cityCode: city.code,
+            county: null,
+            countyCode: null,
+            fullPath: `${province.name}${city.name}`
+        };
+    }
+    let filteredAreas = city.area;
+    if (codePrefix && codePrefix.length === 6) {
+        filteredAreas = city.area.filter(a => a.code && a.code === codePrefix);
+        if (filteredAreas.length === 0) {
+            const prefix4 = codePrefix.slice(0, 4);
+            filteredAreas = city.area.filter(a => a.code && a.code.startsWith(prefix4));
+        }
+        if (filteredAreas.length === 0) {
+            filteredAreas = city.area;
+        }
+    }
+    else if (codePrefix && codePrefix.length === 4) {
+        const prefix4 = codePrefix.slice(0, 4);
+        filteredAreas = city.area.filter(a => a.code && a.code.startsWith(prefix4));
+        if (filteredAreas.length === 0) {
+            filteredAreas = city.area;
+        }
+    }
+    const county = filteredAreas[randomInt(0, filteredAreas.length - 1)];
+    return {
+        province: province.name,
+        provinceCode: province.code,
+        city: city.name,
+        cityCode: city.code,
+        county: county.name,
+        countyCode: county.code,
+        fullPath: `${province.name}${city.name}${county.name}`
+    };
+}
+//# sourceMappingURL=randomRegion.js.map

package/dist/functions/data/randomRegion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomRegion.js","sourceRoot":"","sources":["../../../src/functions/data/randomRegion.ts"],"names":[],"mappings":"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"}

package/dist/functions/data/string/base64.d.ts

@@ -0,0 +1,5 @@
+import type { Base64Encoder } from '../../../references/encoding.d';
+export interface Base64Deps {
+    btoa: Base64Encoder['btoa'];
+}
+export declare function strToBase64(str: string, deps: Base64Deps): string;

package/dist/functions/data/string/base64.js

@@ -0,0 +1,6 @@
+export function strToBase64(str, deps) {
+    return deps.btoa(encodeURIComponent(str).replace(/%([0-9A-F]{2})/g, (match, p1) => {
+        return String.fromCharCode(parseInt(p1, 16));
+    }));
+}
+//# sourceMappingURL=base64.js.map

package/dist/functions/data/string/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../../../src/functions/data/string/base64.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,IAAgB;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QAChF,OAAO,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/functions/data/string/capitalize.d.ts

@@ -0,0 +1 @@
+export declare function capitalize(str: string): string;

package/dist/functions/data/string/capitalize.js

@@ -0,0 +1,6 @@
+export function capitalize(str) {
+    if (!str)
+        return str;
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=capitalize.js.map

package/dist/functions/data/string/capitalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.js","sourceRoot":"","sources":["../../../../src/functions/data/string/capitalize.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAA;IAEpB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AACnD,CAAC"}

package/dist/functions/data/string/caseConverter.d.ts

@@ -0,0 +1,19 @@
+export type CaseType = 'camel' | 'pascal' | 'kebab' | 'snake' | 'constant' | 'dot' | 'path' | 'sentence' | 'title';
+export interface CaseOptions {
+    targetCase?: CaseType;
+    preserveConsecutiveUppercase?: boolean;
+}
+export interface CaseResult {
+    original: string;
+    camelCase: string;
+    pascalCase: string;
+    kebabCase: string;
+    snakeCase: string;
+    constantCase: string;
+    dotCase: string;
+    pathCase: string;
+    sentenceCase: string;
+    titleCase: string;
+    detectedCase: CaseType | 'mixed';
+}
+export declare function caseConverter(str: string, options?: CaseOptions, returnDetails?: boolean): string | CaseResult;

package/dist/functions/data/string/caseConverter.js

@@ -0,0 +1,94 @@
+import { capitalize } from './capitalize';
+export function caseConverter(str, options = {}, returnDetails = false) {
+    const { targetCase = 'camel', preserveConsecutiveUppercase = false } = options;
+    if (!str) {
+        const emptyResult = {
+            original: str,
+            camelCase: str,
+            pascalCase: str,
+            kebabCase: str,
+            snakeCase: str,
+            constantCase: str,
+            dotCase: str,
+            pathCase: str,
+            sentenceCase: str,
+            titleCase: str,
+            detectedCase: 'mixed'
+        };
+        return returnDetails ? emptyResult : str;
+    }
+    const detectedCase = detectCase(str);
+    const words = splitIntoWords(str, preserveConsecutiveUppercase);
+    const camelCase = words.map((word, index) => index === 0 ? word.toLowerCase() : capitalize(word.toLowerCase())).join('');
+    const pascalCase = words.map(word => capitalize(word.toLowerCase())).join('');
+    const kebabCase = words.map(word => word.toLowerCase()).join('-');
+    const snakeCase = words.map(word => word.toLowerCase()).join('_');
+    const constantCase = words.map(word => word.toUpperCase()).join('_');
+    const dotCase = words.map(word => word.toLowerCase()).join('.');
+    const pathCase = words.map(word => word.toLowerCase()).join('/');
+    const sentenceCase = words.map((word, index) => index === 0 ? capitalize(word.toLowerCase()) : word.toLowerCase()).join(' ');
+    const titleCase = words.map(word => capitalize(word.toLowerCase())).join(' ');
+    const result = {
+        original: str,
+        camelCase,
+        pascalCase,
+        kebabCase,
+        snakeCase,
+        constantCase,
+        dotCase,
+        pathCase,
+        sentenceCase,
+        titleCase,
+        detectedCase
+    };
+    if (returnDetails) {
+        return result;
+    }
+    switch (targetCase) {
+        case 'camel': return camelCase;
+        case 'pascal': return pascalCase;
+        case 'kebab': return kebabCase;
+        case 'snake': return snakeCase;
+        case 'constant': return constantCase;
+        case 'dot': return dotCase;
+        case 'path': return pathCase;
+        case 'sentence': return sentenceCase;
+        case 'title': return titleCase;
+        default:
+            throw new Error(`Invalid target case: ${targetCase}`);
+    }
+}
+function detectCase(str) {
+    if (/^[a-z]+([A-Z][a-z]*)*$/.test(str))
+        return 'camel';
+    if (/^[A-Z][a-z]*([A-Z][a-z]*)*$/.test(str))
+        return 'pascal';
+    if (/^[a-z]+(-[a-z]+)*$/.test(str))
+        return 'kebab';
+    if (/^[a-z]+(_[a-z]+)*$/.test(str))
+        return 'snake';
+    if (/^[A-Z]+(_[A-Z]+)*$/.test(str))
+        return 'constant';
+    if (/^[a-z]+(\.[a-z]+)*$/.test(str))
+        return 'dot';
+    if (/^[a-z]+(\/[a-z]+)*$/.test(str))
+        return 'path';
+    if (/^[A-Z][a-z]*( [a-z]+)*$/.test(str))
+        return 'sentence';
+    if (/^[A-Z][a-z]*( [A-Z][a-z]*)*$/.test(str))
+        return 'title';
+    return 'mixed';
+}
+function splitIntoWords(str, preserveConsecutiveUppercase) {
+    let result = str
+        .replace(/[-_.\/ ]+/g, '|')
+        .replace(/([a-z])([A-Z])/g, '$1|$2');
+    if (!preserveConsecutiveUppercase) {
+        result = result.replace(/([A-Z])([A-Z][a-z])/g, '$1|$2');
+    }
+    return result
+        .split('|')
+        .filter(word => word.length > 0)
+        .map(word => word.trim());
+}
+//# sourceMappingURL=caseConverter.js.map

package/dist/functions/data/string/caseConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caseConverter.js","sourceRoot":"","sources":["../../../../src/functions/data/string/caseConverter.ts"],"names":[],"mappings":"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"}

package/dist/functions/data/string/desensitize.d.ts

@@ -0,0 +1,13 @@
+export type DesensitizeType = 'name' | 'phone' | 'email' | 'idCard' | 'bankCard' | 'auto';
+export interface DesensitizeOptions {
+    maskChar?: string;
+    keepStart?: number;
+    keepEnd?: number;
+}
+export declare function desensitize(data: string, type: DesensitizeType, options?: DesensitizeOptions): string;
+export declare function autoDesensitize(data: string, options?: DesensitizeOptions): string;
+export declare function desensitizeName(name: string, options?: DesensitizeOptions): string;
+export declare function desensitizePhone(phone: string, options?: DesensitizeOptions): string;
+export declare function desensitizeEmail(email: string, options?: DesensitizeOptions): string;
+export declare function desensitizeIdCard(idCard: string, options?: DesensitizeOptions): string;
+export declare function desensitizeBankCard(bankCard: string, options?: DesensitizeOptions): string;

package/dist/functions/data/string/desensitize.js

@@ -0,0 +1,107 @@
+export function desensitize(data, type, options = {}) {
+    if (!data)
+        return '';
+    const { maskChar = '*' } = options;
+    switch (type) {
+        case 'name':
+            return desensitizeName(data, { maskChar, ...options });
+        case 'phone':
+            return desensitizePhone(data, { maskChar, ...options });
+        case 'email':
+            return desensitizeEmail(data, { maskChar, ...options });
+        case 'idCard':
+            return desensitizeIdCard(data, { maskChar, ...options });
+        case 'bankCard':
+            return desensitizeBankCard(data, { maskChar, ...options });
+        case 'auto':
+            return autoDesensitize(data, { maskChar, ...options });
+        default:
+            return data;
+    }
+}
+export function autoDesensitize(data, options = {}) {
+    if (!data || typeof data !== 'string')
+        return data;
+    const { maskChar = '*' } = options;
+    if (data.length === 11 && /^1\d{10}$/.test(data)) {
+        return desensitizePhone(data, options);
+    }
+    if (data.includes('@')) {
+        return desensitizeEmail(data, options);
+    }
+    if (data.length === 18 && /^\d{17}[\dXx]$/.test(data)) {
+        return desensitizeIdCard(data, options);
+    }
+    if (data.length >= 16 && /^\d+$/.test(data)) {
+        return desensitizeBankCard(data, options);
+    }
+    if (data.length <= 4 && /^[\u4e00-\u9fa5a-zA-Z]+$/.test(data)) {
+        return desensitizeName(data, options);
+    }
+    const len = data.length;
+    if (len <= 2)
+        return data;
+    return data.charAt(0) + maskChar.repeat(len - 2) + data.charAt(len - 1);
+}
+export function desensitizeName(name, options = {}) {
+    if (!name)
+        return '';
+    if (name.length === 1)
+        return name;
+    const { maskChar = '*', keepStart = 0, keepEnd = 1 } = options;
+    const start = name.slice(0, keepStart);
+    const end = name.slice(-keepEnd);
+    const maskLength = Math.max(0, name.length - keepStart - keepEnd);
+    return start + maskChar.repeat(maskLength) + end;
+}
+export function desensitizePhone(phone, options = {}) {
+    if (!phone)
+        return '';
+    if (phone.length <= 7)
+        return phone;
+    const { maskChar = '*', keepStart = 3, keepEnd = 4 } = options;
+    const start = phone.slice(0, keepStart);
+    const end = phone.slice(-keepEnd);
+    const maskLength = Math.max(0, phone.length - keepStart - keepEnd);
+    return start + maskChar.repeat(maskLength) + end;
+}
+export function desensitizeEmail(email, options = {}) {
+    if (!email)
+        return '';
+    const atIndex = email.indexOf('@');
+    if (atIndex === -1)
+        return email;
+    const { maskChar = '*', keepStart = 1, keepEnd = 1 } = options;
+    const username = email.slice(0, atIndex);
+    const domain = email.slice(atIndex);
+    if (username.length <= keepStart + keepEnd) {
+        return email;
+    }
+    const start = username.slice(0, keepStart);
+    const end = username.slice(-keepEnd);
+    const maskLength = username.length - keepStart - keepEnd;
+    return start + maskChar.repeat(maskLength) + end + domain;
+}
+export function desensitizeIdCard(idCard, options = {}) {
+    if (!idCard)
+        return '';
+    if (idCard.length < 8)
+        return idCard;
+    const { maskChar = '*', keepStart = 4, keepEnd = 4 } = options;
+    const start = idCard.slice(0, keepStart);
+    const end = idCard.slice(-keepEnd);
+    const maskLength = Math.max(0, idCard.length - keepStart - keepEnd);
+    return start + maskChar.repeat(maskLength) + end;
+}
+export function desensitizeBankCard(bankCard, options = {}) {
+    if (!bankCard)
+        return '';
+    if (bankCard.length < 8)
+        return bankCard;
+    const { maskChar = '*', keepStart = 4, keepEnd = 4 } = options;
+    const start = bankCard.slice(0, keepStart);
+    const end = bankCard.slice(-keepEnd);
+    const maskLength = Math.max(0, bankCard.length - keepStart - keepEnd);
+    return start + maskChar.repeat(maskLength) + end;
+}
+//# sourceMappingURL=desensitize.js.map

package/dist/functions/data/string/desensitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desensitize.js","sourceRoot":"","sources":["../../../../src/functions/data/string/desensitize.ts"],"names":[],"mappings":"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"}