umt 2.5.0 → 2.7.0

package/module/es5/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/es5/Math/percentile.js

@@ -0,0 +1,42 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.percentile = void 0;
+var _quickSort = require("@/Array/quickSort");
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+/**
+ * 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)
+ */
+var percentile = exports.percentile = function 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");
+  }
+  var sortedArray = (0, _quickSort.quickSort)(_toConsumableArray(array));
+  var index = _percentile / 100 * (sortedArray.length - 1);
+  var lowerIndex = Math.floor(index);
+  var upperIndex = Math.ceil(index);
+  if (lowerIndex === upperIndex) {
+    return sortedArray[lowerIndex];
+  }
+  var lowerValue = sortedArray[lowerIndex];
+  var upperValue = sortedArray[upperIndex];
+  var weight = index - lowerIndex;
+  return lowerValue + (upperValue - lowerValue) * weight;
+};

package/module/es5/Math/standardDeviation.js

@@ -5,6 +5,8 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.standardDeviation = void 0;
 var _average = require("./average");
+var _multiplication = require("@/Math/multiplication");
+var _subtract = require("@/Math/subtract");
 /**
  * Calculates the standard deviation of a set of values
  * @param {number[]} values Array of numeric values
@@ -21,8 +23,8 @@ var standardDeviation = exports.standardDeviation = function standardDeviation(v
 
   // Calculate the squared differences from the mean
   var squareDiffs = values.map(function (value) {
-    var diff = value - avg;
-    return diff * diff;
+    var diff = (0, _subtract.subtract)(value, avg);
+    return (0, _multiplication.multiplication)(diff, diff);
   });
 
   // Calculate the mean of the squared differences

package/module/es5/Object/has.js

@@ -30,7 +30,7 @@ var has = exports.has = function has(object, path) {
   try {
     for (_iterator.s(); !(_step = _iterator.n()).done;) {
       var _key = _step.value;
-      if (current == null || !Object.prototype.hasOwnProperty.call(current, _key)) {
+      if (current == null || !Object.hasOwn(current, _key)) {
         return false;
       }
       current = current[_key];

package/module/es5/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/es5/Object/index.js

@@ -14,6 +14,17 @@ Object.keys(_has).forEach(function (key) {
     }
   });
 });
+var _isEmpty = require("./isEmpty");
+Object.keys(_isEmpty).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _isEmpty[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _isEmpty[key];
+    }
+  });
+});
 var _keyBy = require("./keyBy");
 Object.keys(_keyBy).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -25,6 +36,39 @@ Object.keys(_keyBy).forEach(function (key) {
     }
   });
 });
+var _merge = require("./merge");
+Object.keys(_merge).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _merge[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _merge[key];
+    }
+  });
+});
+var _mergeDeep = require("./mergeDeep");
+Object.keys(_mergeDeep).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _mergeDeep[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _mergeDeep[key];
+    }
+  });
+});
+var _omit = require("./omit");
+Object.keys(_omit).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _omit[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _omit[key];
+    }
+  });
+});
 var _pick = require("./pick");
 Object.keys(_pick).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/module/es5/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/es5/Object/isEmpty.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isEmpty = void 0;
+/**
+ * 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
+ */
+var isEmpty = exports.isEmpty = function isEmpty(object) {
+  // Check enumerable string keys
+  for (var key in object) {
+    if (Object.hasOwn(object, key)) {
+      return false;
+    }
+  }
+
+  // Check symbol properties
+  var symbolKeys = Object.getOwnPropertySymbols(object);
+  if (symbolKeys.length > 0) {
+    return false;
+  }
+  return true;
+};

package/module/es5/Object/merge.d.ts

@@ -0,0 +1,8 @@
+import type { UnionToIntersection } from "$/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/es5/Object/merge.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.merge = void 0;
+/**
+ * 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
+ */
+var merge = exports.merge = function merge(target) {
+  for (var _len = arguments.length, sources = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+    sources[_key - 1] = arguments[_key];
+  }
+  return Object.assign.apply(Object, [{}, target].concat(sources));
+};

package/module/es5/Object/mergeDeep.d.ts

@@ -0,0 +1,8 @@
+import type { UnionToIntersection } from "$/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/es5/Object/mergeDeep.js

@@ -0,0 +1,46 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.mergeDeep = void 0;
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+/**
+ * Checks if a value is a plain object
+ */
+var isPlainObject = function 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
+ */
+var _mergeDeep = exports.mergeDeep = function mergeDeep(target) {
+  for (var _len = arguments.length, sources = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+    sources[_key - 1] = arguments[_key];
+  }
+  if (sources.length === 0) {
+    return target;
+  }
+  var source = sources.shift();
+  if (isPlainObject(target) && isPlainObject(source)) {
+    var result = _objectSpread({}, target);
+    for (var key in source) {
+      if (Object.hasOwn(source, key)) {
+        var sourceValue = source[key];
+        var targetValue = result[key];
+        result[key] = isPlainObject(targetValue) && isPlainObject(sourceValue) ? _mergeDeep(targetValue, sourceValue) : sourceValue;
+      }
+    }
+    return _mergeDeep.apply(void 0, [result].concat(sources));
+  }
+  return _mergeDeep.apply(void 0, [source].concat(sources));
+};

package/module/es5/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/es5/Object/omit.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.omit = void 0;
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * 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
+ */
+var omit = exports.omit = function omit(object) {
+  var result = _objectSpread({}, object);
+  for (var _len = arguments.length, keys = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+    keys[_key - 1] = arguments[_key];
+  }
+  for (var _i = 0, _keys = keys; _i < _keys.length; _i++) {
+    var key = _keys[_i];
+    delete result[key];
+  }
+  return result;
+};

package/module/es5/Object/pickDeep.d.ts

@@ -7,7 +7,7 @@ import type { PickDeepKey } from "$/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 "$/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/es5/Object/pickDeep.js

@@ -24,7 +24,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  * @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
@@ -34,7 +34,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  * ```
  */
 var pickDeep = exports.pickDeep = function pickDeep(object) {
-  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  // biome-ignore lint/suspicious/noExplicitAny: ignore
   var result = {};
   for (var _len = arguments.length, keys = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
     keys[_key - 1] = arguments[_key];
@@ -42,9 +42,9 @@ var pickDeep = exports.pickDeep = function pickDeep(object) {
   for (var _i = 0, _keys = keys; _i < _keys.length; _i++) {
     var key = _keys[_i];
     var parts = key.split(".");
-    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    // biome-ignore lint/suspicious/noExplicitAny: ignore
     var current = _objectSpread({}, object);
-    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    // biome-ignore lint/suspicious/noExplicitAny: ignore
     var target = result;
     var _iterator = _createForOfIteratorHelper(parts.entries()),
       _step;

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

@@ -28,7 +28,7 @@ function dayOfWeekSimple(properties) {
   if (typeof properties === "string") {
     if (properties.includes(":")) {
       var _ref = properties.split(":")
-        // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+        // biome-ignore lint/suspicious/noExplicitAny: ignore
         .map(Number),
         _ref2 = _slicedToArray(_ref, 3),
         _year = _ref2[0],
@@ -42,7 +42,7 @@ function dayOfWeekSimple(properties) {
     }
     if (properties.includes("/")) {
       var _ref3 = properties.split("/")
-        // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+        // biome-ignore lint/suspicious/noExplicitAny: ignore
         .map(Number),
         _ref4 = _slicedToArray(_ref3, 3),
         _year2 = _ref4[0],
@@ -55,7 +55,7 @@ function dayOfWeekSimple(properties) {
       }, timeDifference);
     }
     var _ref5 = properties.split("-")
-      // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+      // biome-ignore lint/suspicious/noExplicitAny: ignore
       .map(Number),
       _ref6 = _slicedToArray(_ref5, 3),
       year = _ref6[0],

package/module/es5/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/es5/String/camelCase.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.camelCase = void 0;
+/**
+ * Converts a string to camelCase
+ * @param str - The string to convert
+ * @returns The camelCase string
+ */
+var camelCase = exports.camelCase = function camelCase(string_) {
+  return string_.replaceAll(/[^a-zA-Z0-9]+(.)/g, function (_, _char) {
+    return _char.toUpperCase();
+  }).replaceAll(/[^a-zA-Z0-9]+$/g, "").replace(/^[A-Z]/, function (_char2) {
+    return _char2.toLowerCase();
+  });
+};

package/module/es5/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/es5/String/escapeHtml.js

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.escapeHtml = void 0;
+/**
+ * HTML entities map for escaping
+ */
+var htmlEscapeMap = {
+  "&": "&",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;"
+};
+
+/**
+ * Escapes HTML special characters in a string
+ * @param str - The string to escape
+ * @returns The escaped string
+ */
+var escapeHtml = exports.escapeHtml = function escapeHtml(string_) {
+  return string_.replaceAll(/[&<>"']/g, function (match) {
+    return htmlEscapeMap[match];
+  });
+};

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

@@ -0,0 +1,25 @@
+import type { Formatter } from "$/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/es5/String/formatString/applyFormatter.js

@@ -0,0 +1,100 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.applyFormatter = applyFormatter;
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+/**
+ * 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"
+ */
+function applyFormatter(value, formatterString, formatters) {
+  var match = formatterString.match(/^(\w+)(?:\(([^)]*)\))?$/);
+  if (!match) {
+    return String(value);
+  }
+  var _match = _slicedToArray(match, 3),
+    formatterName = _match[1],
+    argumentsString = _match[2];
+  var formatter = formatters[formatterName];
+  if (!formatter) {
+    return String(value);
+  }
+  var arguments_ = argumentsString ? parseArguments(argumentsString) : [];
+  return formatter.apply(void 0, [value].concat(_toConsumableArray(arguments_)));
+}
+
+/**
+ * Parses comma-separated arguments while preserving quoted strings
+ * @param argumentsString - String containing comma-separated arguments
+ * @returns Array of parsed arguments
+ */
+function parseArguments(argumentsString) {
+  var arguments_ = [];
+  var current = "";
+  var inQuotes = false;
+  var quoteChar = "";
+  var _iterator = _createForOfIteratorHelper(argumentsString),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var _char = _step.value;
+      if (!inQuotes && (_char === '"' || _char === "'")) {
+        inQuotes = true;
+        quoteChar = _char;
+        continue;
+      }
+      if (inQuotes && _char === quoteChar) {
+        inQuotes = false;
+        quoteChar = "";
+        continue;
+      }
+      if (!inQuotes && _char === ",") {
+        var _trimmed = current.trim();
+        arguments_.push(_trimmed === "" ? " " : _trimmed);
+        current = "";
+        continue;
+      }
+      current += _char;
+    }
+
+    // Handle last argument
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  var trimmed = current.trim();
+  arguments_.push(trimmed === "" ? " " : trimmed);
+  return arguments_;
+}

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

@@ -0,0 +1,24 @@
+import type { Formatter } from "$/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>;