umt 2.5.0 → 2.7.0

package/module/Math/mode.js

@@ -0,0 +1,31 @@
+/**
+ * Finds the most frequently occurring value(s) in an array
+ * @param array - Array of numbers to find mode for
+ * @returns Array of mode values (can be multiple values if there are ties)
+ * @example
+ * mode([1, 2, 2, 3, 3, 3]); // [3]
+ * mode([1, 2, 2, 3, 3]); // [2, 3]
+ * mode([1, 2, 3]); // [1, 2, 3]
+ */
+export const mode = (array) => {
+    if (array.length === 0) {
+        return [];
+    }
+    const frequency = new Map();
+    let maxFrequency = 0;
+    // Count frequencies
+    for (const value of array) {
+        const count = (frequency.get(value) || 0) + 1;
+        frequency.set(value, count);
+        maxFrequency = Math.max(maxFrequency, count);
+    }
+    // Find all values with maximum frequency
+    const modes = [];
+    for (const [value, count] of frequency) {
+        if (count === maxFrequency) {
+            modes.push(value);
+        }
+    }
+    return modes.sort((a, b) => a - b);
+};
+//# sourceMappingURL=mode.js.map

package/module/Math/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../../src/Math/mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAe,EAAY,EAAE;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,oBAAoB;IACpB,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC9C,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC5B,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,yCAAyC;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;QACvC,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACrC,CAAC,CAAC"}

package/module/Math/percentile.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Calculate the nth percentile of values in an array
+ * @param array - Array of numbers
+ * @param percentile - Percentile value (0-100)
+ * @returns The percentile value
+ * @example
+ * percentile([1, 2, 3, 4, 5], 50); // 3 (50th percentile - median)
+ * percentile([1, 2, 3, 4, 5], 25); // 2 (25th percentile)
+ * percentile([1, 2, 3, 4, 5], 75); // 4 (75th percentile)
+ */
+export declare const percentile: (array: number[], percentile: number) => number;

package/module/Math/percentile.js

@@ -0,0 +1,31 @@
+import { quickSort } from "../Array/quickSort";
+/**
+ * Calculate the nth percentile of values in an array
+ * @param array - Array of numbers
+ * @param percentile - Percentile value (0-100)
+ * @returns The percentile value
+ * @example
+ * percentile([1, 2, 3, 4, 5], 50); // 3 (50th percentile - median)
+ * percentile([1, 2, 3, 4, 5], 25); // 2 (25th percentile)
+ * percentile([1, 2, 3, 4, 5], 75); // 4 (75th percentile)
+ */
+export const percentile = (array, percentile) => {
+    if (array.length === 0) {
+        return Number.NaN;
+    }
+    if (percentile < 0 || percentile > 100) {
+        throw new Error("Percentile must be between 0 and 100");
+    }
+    const sortedArray = quickSort([...array]);
+    const index = (percentile / 100) * (sortedArray.length - 1);
+    const lowerIndex = Math.floor(index);
+    const upperIndex = Math.ceil(index);
+    if (lowerIndex === upperIndex) {
+        return sortedArray[lowerIndex];
+    }
+    const lowerValue = sortedArray[lowerIndex];
+    const upperValue = sortedArray[upperIndex];
+    const weight = index - lowerIndex;
+    return lowerValue + (upperValue - lowerValue) * weight;
+};
+//# sourceMappingURL=percentile.js.map

package/module/Math/percentile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"percentile.js","sourceRoot":"","sources":["../../src/Math/percentile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAe,EAAE,UAAkB,EAAU,EAAE;IACxE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEpC,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;IAElC,OAAO,UAAU,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,MAAM,CAAC;AACzD,CAAC,CAAC"}

package/module/Math/standardDeviation.js

@@ -1,4 +1,6 @@
 import { average } from "./average";
+import { multiplication } from "../Math/multiplication";
+import { subtract } from "../Math/subtract";
 /**
  * Calculates the standard deviation of a set of values
  * @param {number[]} values Array of numeric values
@@ -14,8 +16,8 @@ export const standardDeviation = (values) => {
     const avg = average(values);
     // Calculate the squared differences from the mean
     const squareDiffs = values.map((value) => {
-        const diff = value - avg;
-        return diff * diff;
+        const diff = subtract(value, avg);
+        return multiplication(diff, diff);
     });
     // Calculate the mean of the squared differences
     const avgSquareDiff = average(squareDiffs);

package/module/Math/standardDeviation.js.map

@@ -1 +1 @@
-{"version":3,"file":"standardDeviation.js","sourceRoot":"","sources":["../../src/Math/standardDeviation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAgB,EAAU,EAAE;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5B,kDAAkD;IAClD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACvC,MAAM,IAAI,GAAG,KAAK,GAAG,GAAG,CAAC;QACzB,OAAO,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,gDAAgD;IAChD,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3C,yDAAyD;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAClC,CAAC,CAAC"}
+{"version":3,"file":"standardDeviation.js","sourceRoot":"","sources":["../../src/Math/standardDeviation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAgB,EAAU,EAAE;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5B,kDAAkD;IAClD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAClC,OAAO,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,gDAAgD;IAChD,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3C,yDAAyD;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAClC,CAAC,CAAC"}

package/module/Object/has.js

@@ -11,8 +11,7 @@ export const has = (object, path) => {
     const localPath = typeof path === "string" ? path.split(".") : path;
     let current = { ...object };
     for (const key of localPath) {
-        if (current == null ||
-            !Object.prototype.hasOwnProperty.call(current, key)) {
+        if (current == null || !Object.hasOwn(current, key)) {
             return false;
         }
         current = current[key];

package/module/Object/has.js.map

@@ -1 +1 @@
-{"version":3,"file":"has.js","sourceRoot":"","sources":["../../src/Object/has.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CACjB,MAAS,EACT,IAAuB,EACd,EAAE;IACX,MAAM,SAAS,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,IAAI,OAAO,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IACE,OAAO,IAAI,IAAI;YACf,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,EACnD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}
+{"version":3,"file":"has.js","sourceRoot":"","sources":["../../src/Object/has.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CACjB,MAAS,EACT,IAAuB,EACd,EAAE;IACX,MAAM,SAAS,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,IAAI,OAAO,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,OAAO,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;YACpD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/module/Object/index.d.ts

@@ -1,4 +1,8 @@
 export * from "./has";
+export * from "./isEmpty";
 export * from "./keyBy";
+export * from "./merge";
+export * from "./mergeDeep";
+export * from "./omit";
 export * from "./pick";
 export * from "./pickDeep";

package/module/Object/index.js

@@ -1,5 +1,9 @@
 export * from "./has";
+export * from "./isEmpty";
 export * from "./keyBy";
+export * from "./merge";
+export * from "./mergeDeep";
+export * from "./omit";
 export * from "./pick";
 export * from "./pickDeep";
 //# sourceMappingURL=index.js.map

package/module/Object/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Object/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Object/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}

package/module/Object/isEmpty.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Checks if an object is empty (has no own properties)
+ * @param object - The object to check
+ * @returns true if the object is empty, false otherwise
+ */
+export declare const isEmpty: (object: Record<string, unknown>) => boolean;

package/module/Object/isEmpty.js

@@ -0,0 +1,20 @@
+/**
+ * Checks if an object is empty (has no own properties)
+ * @param object - The object to check
+ * @returns true if the object is empty, false otherwise
+ */
+export const isEmpty = (object) => {
+    // Check enumerable string keys
+    for (const key in object) {
+        if (Object.hasOwn(object, key)) {
+            return false;
+        }
+    }
+    // Check symbol properties
+    const symbolKeys = Object.getOwnPropertySymbols(object);
+    if (symbolKeys.length > 0) {
+        return false;
+    }
+    return true;
+};
+//# sourceMappingURL=isEmpty.js.map

package/module/Object/isEmpty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEmpty.js","sourceRoot":"","sources":["../../src/Object/isEmpty.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAA+B,EAAW,EAAE;IAClE,+BAA+B;IAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/module/Object/merge.d.ts

@@ -0,0 +1,8 @@
+import type { UnionToIntersection } from "../types/logic/unionToIntersection";
+/**
+ * Merges multiple objects into a single object (shallow merge)
+ * @param target - The target object to merge into
+ * @param sources - The source objects to merge from
+ * @returns The merged object
+ */
+export declare const merge: <T extends Record<string, unknown>, U extends Record<string, unknown>[]>(target: T, ...sources: U) => T & UnionToIntersection<U[number]>;

package/module/Object/merge.js

@@ -0,0 +1,10 @@
+/**
+ * Merges multiple objects into a single object (shallow merge)
+ * @param target - The target object to merge into
+ * @param sources - The source objects to merge from
+ * @returns The merged object
+ */
+export const merge = (target, ...sources) => {
+    return Object.assign({}, target, ...sources);
+};
+//# sourceMappingURL=merge.js.map

package/module/Object/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/Object/merge.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAInB,MAAS,EACT,GAAG,OAAU,EACuB,EAAE;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC;AAC/C,CAAC,CAAC"}

package/module/Object/mergeDeep.d.ts

@@ -0,0 +1,8 @@
+import type { UnionToIntersection } from "../types/logic/unionToIntersection";
+/**
+ * Deeply merges multiple objects into a single object
+ * @param target - The target object to merge into
+ * @param sources - The source objects to merge from
+ * @returns The deeply merged object
+ */
+export declare const mergeDeep: <T extends Record<string, unknown>, U extends Record<string, unknown>[]>(target: T, ...sources: U) => T & UnionToIntersection<U[number]>;

package/module/Object/mergeDeep.js

@@ -0,0 +1,37 @@
+/**
+ * Checks if a value is a plain object
+ */
+const isPlainObject = (value) => {
+    return (value !== null &&
+        typeof value === "object" &&
+        value.constructor === Object &&
+        Object.prototype.toString.call(value) === "[object Object]");
+};
+/**
+ * Deeply merges multiple objects into a single object
+ * @param target - The target object to merge into
+ * @param sources - The source objects to merge from
+ * @returns The deeply merged object
+ */
+export const mergeDeep = (target, ...sources) => {
+    if (sources.length === 0) {
+        return target;
+    }
+    const source = sources.shift();
+    if (isPlainObject(target) && isPlainObject(source)) {
+        const result = { ...target };
+        for (const key in source) {
+            if (Object.hasOwn(source, key)) {
+                const sourceValue = source[key];
+                const targetValue = result[key];
+                result[key] =
+                    isPlainObject(targetValue) && isPlainObject(sourceValue)
+                        ? mergeDeep(targetValue, sourceValue)
+                        : sourceValue;
+            }
+        }
+        return mergeDeep(result, ...sources);
+    }
+    return mergeDeep(source, ...sources);
+};
+//# sourceMappingURL=mergeDeep.js.map

package/module/Object/mergeDeep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeDeep.js","sourceRoot":"","sources":["../../src/Object/mergeDeep.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,aAAa,GAAG,CAAC,KAAc,EAAoC,EAAE;IACzE,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,WAAW,KAAK,MAAM;QAC5B,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB,CAC5D,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAIvB,MAAS,EACT,GAAG,OAAU,EACuB,EAAE;IACtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,MAA4C,CAAC;IACtD,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAE/B,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;QAE7B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAE/B,MAAkC,CAAC,GAAG,CAAC;oBACtC,aAAa,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC;wBACtD,CAAC,CAAC,SAAS,CACP,WAAsC,EACtC,WAAsC,CACvC;wBACH,CAAC,CAAC,WAAW,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC,MAAM,EAAE,GAAG,OAAO,CAAuC,CAAC;IAC7E,CAAC;IAED,OAAO,SAAS,CAAC,MAAW,EAAE,GAAG,OAAO,CACR,CAAC;AACnC,CAAC,CAAC"}

package/module/Object/omit.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Creates an object without the specified keys
+ * @param object - The source object
+ * @param keys - The keys to omit
+ * @returns A new object without the specified keys
+ */
+export declare const omit: <T extends object, K extends keyof T>(object: T, ...keys: K[]) => Omit<T, K>;

package/module/Object/omit.js

@@ -0,0 +1,14 @@
+/**
+ * Creates an object without the specified keys
+ * @param object - The source object
+ * @param keys - The keys to omit
+ * @returns A new object without the specified keys
+ */
+export const omit = (object, ...keys) => {
+    const result = { ...object };
+    for (const key of keys) {
+        delete result[key];
+    }
+    return result;
+};
+//# sourceMappingURL=omit.js.map

package/module/Object/omit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omit.js","sourceRoot":"","sources":["../../src/Object/omit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,MAAS,EACT,GAAG,IAAS,EACA,EAAE;IACd,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAE7B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/module/Object/pickDeep.d.ts

@@ -7,7 +7,7 @@ import type { PickDeepKey } from "../types/object/pickDeepKey";
  * @template K - Type of property keys to select. Must be a subset of PickDeepKey<T>.
  * @param {T} object - The source object to extract properties from.
  * @param {...K[]} keys - Property keys to extract. Can use dot notation for nested properties.
- * @returns {PickDeep<T>} A new object containing only the specified properties.
+ * @returns {PickDeep<T, K>} A new object containing only the specified properties.
  *
  * @example
  * ```typescript
@@ -16,4 +16,4 @@ import type { PickDeepKey } from "../types/object/pickDeepKey";
  * // picked will be { a: { b: { c: 1 } }, f: 4 }
  * ```
  */
-export declare const pickDeep: <T extends object, K extends PickDeepKey<T>>(object: T, ...keys: K[]) => PickDeep<T>;
+export declare const pickDeep: <T extends object, const K extends readonly PickDeepKey<T>[]>(object: T, ...keys: K) => PickDeep<T, K>;

package/module/Object/pickDeep.js

@@ -5,7 +5,7 @@
  * @template K - Type of property keys to select. Must be a subset of PickDeepKey<T>.
  * @param {T} object - The source object to extract properties from.
  * @param {...K[]} keys - Property keys to extract. Can use dot notation for nested properties.
- * @returns {PickDeep<T>} A new object containing only the specified properties.
+ * @returns {PickDeep<T, K>} A new object containing only the specified properties.
  *
  * @example
  * ```typescript
@@ -15,13 +15,13 @@
  * ```
  */
 export const pickDeep = (object, ...keys) => {
-    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    // biome-ignore lint/suspicious/noExplicitAny: ignore
     const result = {};
     for (const key of keys) {
         const parts = key.split(".");
-        // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+        // biome-ignore lint/suspicious/noExplicitAny: ignore
         let current = { ...object };
-        // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+        // biome-ignore lint/suspicious/noExplicitAny: ignore
         let target = result;
         for (const [index, part] of parts.entries()) {
             if (current && typeof current === "object" && part in current) {

package/module/Object/pickDeep.js.map

@@ -1 +1 @@
-{"version":3,"file":"pickDeep.js","sourceRoot":"","sources":["../../src/Object/pickDeep.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,MAAS,EACT,GAAG,IAAS,EACC,EAAE;IACf,4DAA4D;IAC5D,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAI,GAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzC,4DAA4D;QAC5D,IAAI,OAAO,GAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;QACjC,4DAA4D;QAC5D,IAAI,MAAM,GAAQ,MAAM,CAAC;QAEzB,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5C,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;gBAC9D,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC/B,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBAClC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;oBACxB,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}
+{"version":3,"file":"pickDeep.js","sourceRoot":"","sources":["../../src/Object/pickDeep.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAItB,MAAS,EACT,GAAG,IAAO,EACM,EAAE;IAClB,qDAAqD;IACrD,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAI,GAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzC,qDAAqD;QACrD,IAAI,OAAO,GAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;QACjC,qDAAqD;QACrD,IAAI,MAAM,GAAQ,MAAM,CAAC;QAEzB,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5C,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;gBAC9D,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC/B,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBAClC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;oBACxB,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/module/Simple/Date/dayOfWeekSimple.js

@@ -4,20 +4,20 @@ function dayOfWeekSimple(properties, timeDifference = 9) {
         if (properties.includes(":")) {
             const [year, mon, day] = properties
                 .split(":")
-                // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+                // biome-ignore lint/suspicious/noExplicitAny: ignore
                 .map(Number);
             return dayOfWeek({ year, mon, day }, timeDifference);
         }
         if (properties.includes("/")) {
             const [year, mon, day] = properties
                 .split("/")
-                // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+                // biome-ignore lint/suspicious/noExplicitAny: ignore
                 .map(Number);
             return dayOfWeek({ year, mon, day }, timeDifference);
         }
         const [year, mon, day] = properties
             .split("-")
-            // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+            // biome-ignore lint/suspicious/noExplicitAny: ignore
             .map(Number);
         return dayOfWeek({ year, mon, day }, timeDifference);
     }

package/module/Simple/Date/dayOfWeekSimple.js.map

@@ -1 +1 @@
-{"version":3,"file":"dayOfWeekSimple.js","sourceRoot":"","sources":["../../../src/Simple/Date/dayOfWeekSimple.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA8B7C,SAAS,eAAe,CAOtB,UAyBQ,EACR,iBAA+B,CAAC;IAEhC,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,UAAU;iBAChC,KAAK,CAAC,GAAG,CAAC;gBACX,4DAA4D;iBAC3D,GAAG,CAAC,MAAM,CAAQ,CAAC;YACtB,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,UAAU;iBAChC,KAAK,CAAC,GAAG,CAAC;gBACX,4DAA4D;iBAC3D,GAAG,CAAC,MAAM,CAAQ,CAAC;YACtB,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,UAAU;aAChC,KAAK,CAAC,GAAG,CAAC;YACX,4DAA4D;aAC3D,GAAG,CAAC,MAAM,CAAQ,CAAC;QACtB,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,UAAU,YAAY,IAAI,EAAE,CAAC;QAC/B,OAAO,SAAS,CACd;YACE,IAAI,EAAE,UAAU,CAAC,WAAW,EAAE;YAC9B,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAER;YACvB,GAAG,EAAE,UAAU,CAAC,OAAO,EAEtB;SACF,EACD,cAAc,CACf,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CACd,UAIC,EACD,cAAc,CACf,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"dayOfWeekSimple.js","sourceRoot":"","sources":["../../../src/Simple/Date/dayOfWeekSimple.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA8B7C,SAAS,eAAe,CAOtB,UAyBQ,EACR,iBAA+B,CAAC;IAEhC,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,UAAU;iBAChC,KAAK,CAAC,GAAG,CAAC;gBACX,qDAAqD;iBACpD,GAAG,CAAC,MAAM,CAAQ,CAAC;YACtB,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,UAAU;iBAChC,KAAK,CAAC,GAAG,CAAC;gBACX,qDAAqD;iBACpD,GAAG,CAAC,MAAM,CAAQ,CAAC;YACtB,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,UAAU;aAChC,KAAK,CAAC,GAAG,CAAC;YACX,qDAAqD;aACpD,GAAG,CAAC,MAAM,CAAQ,CAAC;QACtB,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,UAAU,YAAY,IAAI,EAAE,CAAC;QAC/B,OAAO,SAAS,CACd;YACE,IAAI,EAAE,UAAU,CAAC,WAAW,EAAE;YAC9B,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAER;YACvB,GAAG,EAAE,UAAU,CAAC,OAAO,EAEtB;SACF,EACD,cAAc,CACf,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CACd,UAIC,EACD,cAAc,CACf,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/module/String/camelCase.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Converts a string to camelCase
+ * @param str - The string to convert
+ * @returns The camelCase string
+ */
+export declare const camelCase: (string_: string) => string;

package/module/String/camelCase.js

@@ -0,0 +1,12 @@
+/**
+ * Converts a string to camelCase
+ * @param str - The string to convert
+ * @returns The camelCase string
+ */
+export const camelCase = (string_) => {
+    return string_
+        .replaceAll(/[^a-zA-Z0-9]+(.)/g, (_, char) => char.toUpperCase())
+        .replaceAll(/[^a-zA-Z0-9]+$/g, "")
+        .replace(/^[A-Z]/, (char) => char.toLowerCase());
+};
+//# sourceMappingURL=camelCase.js.map

package/module/String/camelCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camelCase.js","sourceRoot":"","sources":["../../src/String/camelCase.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAU,EAAE;IACnD,OAAO,OAAO;SACX,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;SAChE,UAAU,CAAC,iBAAiB,EAAE,EAAE,CAAC;SACjC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACrD,CAAC,CAAC"}

package/module/String/escapeHtml.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Escapes HTML special characters in a string
+ * @param str - The string to escape
+ * @returns The escaped string
+ */
+export declare const escapeHtml: (string_: string) => string;

package/module/String/escapeHtml.js

@@ -0,0 +1,19 @@
+/**
+ * HTML entities map for escaping
+ */
+const htmlEscapeMap = {
+    "&": "&",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#39;",
+};
+/**
+ * Escapes HTML special characters in a string
+ * @param str - The string to escape
+ * @returns The escaped string
+ */
+export const escapeHtml = (string_) => {
+    return string_.replaceAll(/[&<>"']/g, (match) => htmlEscapeMap[match]);
+};
+//# sourceMappingURL=escapeHtml.js.map

package/module/String/escapeHtml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeHtml.js","sourceRoot":"","sources":["../../src/String/escapeHtml.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,aAAa,GAA2B;IAC5C,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAU,EAAE;IACpD,OAAO,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AACzE,CAAC,CAAC"}

package/module/String/formatString/applyFormatter.d.ts

@@ -0,0 +1,25 @@
+import type { Formatter } from "../../types/string/formatString/formatter";
+/**
+ * Applies a formatter function to a value with optional arguments.
+ *
+ * Parses formatter syntax like "upper", "currency(ja-JP,JPY)", "pad(4,0)" and applies
+ * the corresponding formatter function with parsed arguments.
+ *
+ * @param value - The value to format
+ * @param formatterString - Formatter name with optional arguments (e.g., "upper", "currency(ja-JP,JPY)")
+ * @param formatters - Available formatter functions
+ * @returns Formatted string, or original string value if formatter not found/invalid
+ *
+ * @example
+ * // Simple formatter
+ * applyFormatter("hello", "upper", { upper: (v) => String(v).toUpperCase() }) // → "HELLO"
+ *
+ * @example
+ * // Formatter with arguments
+ * applyFormatter(42, "pad(4,0)", { pad: (v, len, char) => String(v).padStart(+len, char) }) // → "0042"
+ *
+ * @example
+ * // Invalid formatter returns original value
+ * applyFormatter("test", "invalid!@#", {}) // → "test"
+ */
+export declare function applyFormatter(value: unknown, formatterString: string, formatters: Record<string, Formatter>): string;

package/module/String/formatString/applyFormatter.js

@@ -0,0 +1,71 @@
+/**
+ * Applies a formatter function to a value with optional arguments.
+ *
+ * Parses formatter syntax like "upper", "currency(ja-JP,JPY)", "pad(4,0)" and applies
+ * the corresponding formatter function with parsed arguments.
+ *
+ * @param value - The value to format
+ * @param formatterString - Formatter name with optional arguments (e.g., "upper", "currency(ja-JP,JPY)")
+ * @param formatters - Available formatter functions
+ * @returns Formatted string, or original string value if formatter not found/invalid
+ *
+ * @example
+ * // Simple formatter
+ * applyFormatter("hello", "upper", { upper: (v) => String(v).toUpperCase() }) // → "HELLO"
+ *
+ * @example
+ * // Formatter with arguments
+ * applyFormatter(42, "pad(4,0)", { pad: (v, len, char) => String(v).padStart(+len, char) }) // → "0042"
+ *
+ * @example
+ * // Invalid formatter returns original value
+ * applyFormatter("test", "invalid!@#", {}) // → "test"
+ */
+export function applyFormatter(value, formatterString, formatters) {
+    const match = formatterString.match(/^(\w+)(?:\(([^)]*)\))?$/);
+    if (!match) {
+        return String(value);
+    }
+    const [, formatterName, argumentsString] = match;
+    const formatter = formatters[formatterName];
+    if (!formatter) {
+        return String(value);
+    }
+    const arguments_ = argumentsString ? parseArguments(argumentsString) : [];
+    return formatter(value, ...arguments_);
+}
+/**
+ * Parses comma-separated arguments while preserving quoted strings
+ * @param argumentsString - String containing comma-separated arguments
+ * @returns Array of parsed arguments
+ */
+function parseArguments(argumentsString) {
+    const arguments_ = [];
+    let current = "";
+    let inQuotes = false;
+    let quoteChar = "";
+    for (const char of argumentsString) {
+        if (!inQuotes && (char === '"' || char === "'")) {
+            inQuotes = true;
+            quoteChar = char;
+            continue;
+        }
+        if (inQuotes && char === quoteChar) {
+            inQuotes = false;
+            quoteChar = "";
+            continue;
+        }
+        if (!inQuotes && char === ",") {
+            const trimmed = current.trim();
+            arguments_.push(trimmed === "" ? " " : trimmed);
+            current = "";
+            continue;
+        }
+        current += char;
+    }
+    // Handle last argument
+    const trimmed = current.trim();
+    arguments_.push(trimmed === "" ? " " : trimmed);
+    return arguments_;
+}
+//# sourceMappingURL=applyFormatter.js.map

package/module/String/formatString/applyFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyFormatter.js","sourceRoot":"","sources":["../../../src/String/formatString/applyFormatter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,eAAuB,EACvB,UAAqC;IAErC,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,EAAE,aAAa,EAAE,eAAe,CAAC,GAAG,KAAK,CAAC;IACjD,MAAM,SAAS,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IAE5C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,UAAU,GAAG,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1E,OAAO,SAAS,CAAC,KAAK,EAAE,GAAG,UAAU,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,eAAuB;IAC7C,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,SAAS,GAAG,EAAE,CAAC;IAEnB,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAChD,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS,GAAG,IAAI,CAAC;YACjB,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACnC,QAAQ,GAAG,KAAK,CAAC;YACjB,SAAS,GAAG,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QAED,IAAI,CAAC,QAAQ,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/B,UAAU,CAAC,IAAI,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAChD,OAAO,GAAG,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QAED,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,uBAAuB;IACvB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,UAAU,CAAC,IAAI,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAEhD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/module/String/formatString/defaultFormatters.d.ts

@@ -0,0 +1,24 @@
+import type { Formatter } from "../../types/string/formatString/formatter";
+/**
+ * Built-in formatter functions for formatString.
+ *
+ * Each formatter takes a value and optional arguments, returning a formatted string.
+ * Formatters are used with syntax like {value:formatterName} or {value:formatterName(arg1,arg2)}.
+ *
+ * Available formatters:
+ * - upper: Convert to uppercase
+ * - lower: Convert to lowercase
+ * - currency: Format as currency with locale support
+ * - date: Format dates with locale and format options
+ * - time: Format time with locale support
+ * - number: Format numbers with precision control
+ * - plural: Choose singular/plural form based on count
+ * - pad: Pad string with characters to specified length
+ *
+ * @example
+ * // Usage in formatString
+ * formatString("{name:upper}", { name: "alice" }) // → "ALICE"
+ * formatString("{price:currency(ja-JP,JPY)}", { price: 1000 }) // → "￥1,000"
+ * formatString("{count:plural(item,items)}", { count: 1 }) // → "item"
+ */
+export declare const defaultFormatters: Record<string, Formatter>;

package/module/String/formatString/defaultFormatters.js

@@ -0,0 +1,59 @@
+/**
+ * Built-in formatter functions for formatString.
+ *
+ * Each formatter takes a value and optional arguments, returning a formatted string.
+ * Formatters are used with syntax like {value:formatterName} or {value:formatterName(arg1,arg2)}.
+ *
+ * Available formatters:
+ * - upper: Convert to uppercase
+ * - lower: Convert to lowercase
+ * - currency: Format as currency with locale support
+ * - date: Format dates with locale and format options
+ * - time: Format time with locale support
+ * - number: Format numbers with precision control
+ * - plural: Choose singular/plural form based on count
+ * - pad: Pad string with characters to specified length
+ *
+ * @example
+ * // Usage in formatString
+ * formatString("{name:upper}", { name: "alice" }) // → "ALICE"
+ * formatString("{price:currency(ja-JP,JPY)}", { price: 1000 }) // → "￥1,000"
+ * formatString("{count:plural(item,items)}", { count: 1 }) // → "item"
+ */
+export const defaultFormatters = {
+    upper: (value) => String(value).toUpperCase(),
+    lower: (value) => String(value).toLowerCase(),
+    currency: (value, locale = "en-US", currency = "USD") => {
+        return new Intl.NumberFormat(locale, {
+            style: "currency",
+            currency,
+        }).format(Number(value));
+    },
+    date: (value, locale = "en-US", format = "short") => {
+        const date = value instanceof Date ? value : new Date(String(value));
+        if (format === "iso") {
+            return date.toISOString();
+        }
+        if (format === "time") {
+            return date.toLocaleTimeString(locale);
+        }
+        return date.toLocaleDateString(locale);
+    },
+    time: (value, locale = "en-US") => {
+        const date = value instanceof Date ? value : new Date(String(value));
+        return date.toLocaleTimeString(locale);
+    },
+    number: (value, locale = "en-US", minimumFractionDigits = "0", maximumFractionDigits = "20") => {
+        return new Intl.NumberFormat(locale, {
+            minimumFractionDigits: Number(minimumFractionDigits),
+            maximumFractionDigits: Number(maximumFractionDigits),
+        }).format(Number(value));
+    },
+    plural: (value, singular, plural) => {
+        return Number(value) === 1 ? singular : plural;
+    },
+    pad: (value, length = "2", char = "0") => {
+        return String(value).padStart(Number(length), char);
+    },
+};
+//# sourceMappingURL=defaultFormatters.js.map