umt 2.5.0 → 2.6.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaultFormatters.js","sourceRoot":"","sources":["../../../src/String/formatString/defaultFormatters.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA8B;IAC1D,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE;IAC7C,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE;IAE7C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,QAAQ,GAAG,KAAK,EAAE,EAAE;QACtD,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;YACnC,KAAK,EAAE,UAAU;YACjB,QAAQ;SACT,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,EAAE;QAClD,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACrE,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,EAAE,CACN,KAAK,EACL,MAAM,GAAG,OAAO,EAChB,qBAAqB,GAAG,GAAG,EAC3B,qBAAqB,GAAG,IAAI,EAC5B,EAAE;QACF,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;YACnC,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,CAAC;YACpD,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,CAAC;SACrD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QAClC,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IACjD,CAAC;IAED,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,GAAG,GAAG,EAAE,EAAE;QACvC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,26 @@
+import type { FormatData } from "../../types/string/formatString/formatData";
+import type { FormatOptions } from "../../types/string/formatString/formatOptions";
+import type { FormatValue } from "../../types/string/formatString/formatValue";
+/**
+ * Detects whether formatString should use indexed or named mode based on arguments.
+ *
+ * Named mode: First argument is a non-array object
+ * Indexed mode: Arguments are treated as array values
+ *
+ * @param dataOrFirstValue - First argument (object for named mode, value for indexed mode)
+ * @param optionsOrSecondValue - Second argument (options for named mode, value for indexed mode)
+ * @param restValues - Remaining arguments for indexed mode
+ * @returns Object containing data and options for formatting
+ *
+ * @example
+ * // Named mode detection
+ * detectMode({ name: "Alice" }) // → { data: { name: "Alice" }, options: {} }
+ *
+ * @example
+ * // Indexed mode detection
+ * detectMode("first", "second") // → { data: ["first", "second"], options: {} }
+ */
+export declare function detectMode(dataOrFirstValue: FormatData | FormatValue | undefined, optionsOrSecondValue: FormatOptions | FormatValue | undefined, restValues: FormatValue[]): {
+    data: unknown;
+    options: FormatOptions;
+};

package/module/String/formatString/detectMode.js

@@ -0,0 +1,61 @@
+/**
+ * Detects whether formatString should use indexed or named mode based on arguments.
+ *
+ * Named mode: First argument is a non-array object
+ * Indexed mode: Arguments are treated as array values
+ *
+ * @param dataOrFirstValue - First argument (object for named mode, value for indexed mode)
+ * @param optionsOrSecondValue - Second argument (options for named mode, value for indexed mode)
+ * @param restValues - Remaining arguments for indexed mode
+ * @returns Object containing data and options for formatting
+ *
+ * @example
+ * // Named mode detection
+ * detectMode({ name: "Alice" }) // → { data: { name: "Alice" }, options: {} }
+ *
+ * @example
+ * // Indexed mode detection
+ * detectMode("first", "second") // → { data: ["first", "second"], options: {} }
+ */
+export function detectMode(dataOrFirstValue, optionsOrSecondValue, restValues) {
+    const isFirstArgumentObject = dataOrFirstValue !== undefined &&
+        typeof dataOrFirstValue === "object" &&
+        dataOrFirstValue !== null &&
+        !Array.isArray(dataOrFirstValue) &&
+        !(dataOrFirstValue instanceof Date);
+    const isSecondArgumentOptions = optionsOrSecondValue !== undefined &&
+        typeof optionsOrSecondValue === "object" &&
+        optionsOrSecondValue !== null &&
+        !Array.isArray(optionsOrSecondValue) &&
+        !(optionsOrSecondValue instanceof Date) &&
+        "formatters" in optionsOrSecondValue;
+    if (isFirstArgumentObject &&
+        optionsOrSecondValue === undefined &&
+        restValues.length === 0) {
+        return {
+            data: dataOrFirstValue,
+            options: {},
+        };
+    }
+    if (isFirstArgumentObject &&
+        isSecondArgumentOptions &&
+        restValues.length === 0) {
+        return {
+            data: dataOrFirstValue,
+            options: optionsOrSecondValue,
+        };
+    }
+    const allValues = [];
+    if (dataOrFirstValue !== undefined) {
+        allValues.push(dataOrFirstValue);
+    }
+    if (optionsOrSecondValue !== undefined) {
+        allValues.push(optionsOrSecondValue);
+    }
+    allValues.push(...restValues);
+    return {
+        data: allValues,
+        options: {},
+    };
+}
+//# sourceMappingURL=detectMode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detectMode.js","sourceRoot":"","sources":["../../../src/String/formatString/detectMode.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,UAAU,CACxB,gBAAsD,EACtD,oBAA6D,EAC7D,UAAyB;IAKzB,MAAM,qBAAqB,GACzB,gBAAgB,KAAK,SAAS;QAC9B,OAAO,gBAAgB,KAAK,QAAQ;QACpC,gBAAgB,KAAK,IAAI;QACzB,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC;QAChC,CAAC,CAAC,gBAAgB,YAAY,IAAI,CAAC,CAAC;IAEtC,MAAM,uBAAuB,GAC3B,oBAAoB,KAAK,SAAS;QAClC,OAAO,oBAAoB,KAAK,QAAQ;QACxC,oBAAoB,KAAK,IAAI;QAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC;QACpC,CAAC,CAAC,oBAAoB,YAAY,IAAI,CAAC;QACvC,YAAY,IAAI,oBAAoB,CAAC;IAEvC,IACE,qBAAqB;QACrB,oBAAoB,KAAK,SAAS;QAClC,UAAU,CAAC,MAAM,KAAK,CAAC,EACvB,CAAC;QACD,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,IACE,qBAAqB;QACrB,uBAAuB;QACvB,UAAU,CAAC,MAAM,KAAK,CAAC,EACvB,CAAC;QACD,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,oBAAoB;SAC9B,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAc,EAAE,CAAC;IAChC,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACnC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;QACvC,SAAS,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACvC,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IAE9B,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * Retrieves a value from an object using a dot-notation path with array index support.
+ *
+ * Supports nested properties and array access with positive/negative indices.
+ *
+ * @param object - The object to retrieve the value from
+ * @param path - Dot-notation path (e.g., "user.name", "items[0]", "data[0].items[-1].name")
+ * @returns The value at the specified path, or undefined if not found
+ *
+ * @example
+ * // Simple property access
+ * getValue({ name: "Alice" }, "name") // → "Alice"
+ *
+ * @example
+ * // Nested property access
+ * getValue({ user: { name: "Bob" } }, "user.name") // → "Bob"
+ *
+ * @example
+ * // Array access
+ * getValue({ items: ["A", "B", "C"] }, "items[0]") // → "A"
+ * getValue({ items: ["A", "B", "C"] }, "items[-1]") // → "C"
+ *
+ * @example
+ * // Complex nested access
+ * getValue({ users: [{ name: "Alice" }] }, "users[0].name") // → "Alice"
+ */
+export declare function getValue(object: unknown, path: string): unknown;

package/module/String/formatString/getValue.js

@@ -0,0 +1,56 @@
+/**
+ * Retrieves a value from an object using a dot-notation path with array index support.
+ *
+ * Supports nested properties and array access with positive/negative indices.
+ *
+ * @param object - The object to retrieve the value from
+ * @param path - Dot-notation path (e.g., "user.name", "items[0]", "data[0].items[-1].name")
+ * @returns The value at the specified path, or undefined if not found
+ *
+ * @example
+ * // Simple property access
+ * getValue({ name: "Alice" }, "name") // → "Alice"
+ *
+ * @example
+ * // Nested property access
+ * getValue({ user: { name: "Bob" } }, "user.name") // → "Bob"
+ *
+ * @example
+ * // Array access
+ * getValue({ items: ["A", "B", "C"] }, "items[0]") // → "A"
+ * getValue({ items: ["A", "B", "C"] }, "items[-1]") // → "C"
+ *
+ * @example
+ * // Complex nested access
+ * getValue({ users: [{ name: "Alice" }] }, "users[0].name") // → "Alice"
+ */
+export function getValue(object, path) {
+    const segments = [];
+    const parts = path.split(".");
+    for (const part of parts) {
+        const arrayMatch = part.match(/^(.+?)\[(-?\d+)\]$/);
+        if (arrayMatch) {
+            const [, key, indexString] = arrayMatch;
+            segments.push({ key, index: Number(indexString) });
+        }
+        else {
+            segments.push({ key: part });
+        }
+    }
+    let current = object;
+    for (const segment of segments) {
+        if (typeof current !== "object" || current == null) {
+            return;
+        }
+        current = current[segment.key];
+        if (segment.index !== undefined) {
+            if (!Array.isArray(current)) {
+                return;
+            }
+            const index = segment.index;
+            current = index < 0 ? current[current.length + index] : current[index];
+        }
+    }
+    return current;
+}
+//# sourceMappingURL=getValue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getValue.js","sourceRoot":"","sources":["../../../src/String/formatString/getValue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAe,EAAE,IAAY;IACpD,MAAM,QAAQ,GAA2C,EAAE,CAAC;IAE5D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACpD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,GAAG,UAAU,CAAC;YACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,IAAI,OAAO,GAAG,MAAM,CAAC;IAErB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACnD,OAAO;QACT,CAAC;QAED,OAAO,GAAI,OAAmC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAE5D,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAC5B,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,91 @@
+import type { FormatData } from "../../types/string/formatString/formatData";
+import type { FormatOptions } from "../../types/string/formatString/formatOptions";
+import type { FormatValue } from "../../types/string/formatString/formatValue";
+/**
+ * Replaces placeholders in a template string with specified values.
+ *
+ * Supports two modes:
+ * 1. **Indexed mode**: Use numbered placeholders like {0}, {1}, {2}...
+ * 2. **Named mode**: Use named placeholders with an object like {name}, {age}...
+ *
+ * ## Advanced Features
+ *
+ * ### Nested Object Access
+ * Access nested properties using dot notation: `{user.name}`, `{user.address.city}`
+ *
+ * ### Array Access
+ * Access array elements with brackets: `{items[0]}`, `{users[1].name}`
+ * Supports negative indices: `{items[-1]}` (last element), `{items[-2]}` (second to last)
+ *
+ * ### Default Values
+ * Provide fallback values using pipe syntax: `{name|Unknown}`, `{age|N/A}`
+ *
+ * ### Formatters
+ * Apply formatters to values: `{name:upper}`, `{price:currency}`, `{date:date}`
+ *
+ * Built-in formatters:
+ * - `upper` - Convert to uppercase
+ * - `lower` - Convert to lowercase
+ * - `currency(locale?, currency?)` - Format as currency (e.g., `{price:currency(ja-JP,JPY)}`)
+ * - `date(locale?, format?)` - Format dates (format: short|medium|long|full|iso|time)
+ * - `time(locale?)` - Format time
+ * - `number(locale?, minFraction?, maxFraction?)` - Format numbers
+ * - `plural(singular, plural)` - Pluralization (e.g., `{count:plural(item,items)}`)
+ * - `pad(length, char?)` - Pad string/number (e.g., `{id:pad(4,0)}`)
+ *
+ * ### Escape Sequences
+ * Use double braces to escape: `{{name}}` renders as literal `{name}`
+ *
+ * @param template - Template string containing placeholders
+ * @param data - Data object for named mode OR first value for indexed mode
+ * @param options - Options object with custom formatters (named mode only)
+ * @returns String with placeholders replaced with formatted values
+ *
+ * @example
+ * // Indexed mode - basic replacement
+ * formatString("Hello, {0}! It's {1} today.", "World", "sunny");
+ * // → "Hello, World! It's sunny today."
+ *
+ * @example
+ * // Named mode - object properties
+ * formatString("Hello, {name}! You are {age} years old.", { name: "Alice", age: 25 });
+ * // → "Hello, Alice! You are 25 years old."
+ *
+ * @example
+ * // Nested object access
+ * formatString("User: {user.name}, Email: {user.email}", {
+ *   user: { name: "Charlie", email: "charlie@example.com" }
+ * });
+ * // → "User: Charlie, Email: charlie@example.com"
+ *
+ * @example
+ * // Array access with negative indices
+ * formatString("First: {items[0]}, Last: {items[-1]}", { items: ["A", "B", "C"] });
+ * // → "First: A, Last: C"
+ *
+ * @example
+ * // Default values
+ * formatString("Name: {name|Unknown}, Age: {age|N/A}", { age: 25 });
+ * // → "Name: Unknown, Age: 25"
+ *
+ * @example
+ * // Built-in formatters
+ * formatString("Price: {price:currency(ja-JP,JPY)}", { price: 1234 });
+ * // → "Price: ￥1,234"
+ *
+ * @example
+ * // Custom formatters
+ * formatString("Reversed: {text:reverse}", { text: "hello" }, {
+ *   formatters: {
+ *     reverse: (value) => String(value).split("").reverse().join("")
+ *   }
+ * });
+ * // → "Reversed: olleh"
+ *
+ * @example
+ * // Escape sequences
+ * formatString("Literal {{name}} and value {name}", { name: "Alice" });
+ * // → "Literal {name} and value Alice"
+ */
+export declare function formatString(template: string, data?: FormatData, options?: FormatOptions): string;
+export declare function formatString(template: string, ...values: FormatValue[]): string;

package/module/String/formatString/index.js

@@ -0,0 +1,38 @@
+import { applyFormatter } from "./applyFormatter";
+import { defaultFormatters } from "./defaultFormatters";
+import { detectMode } from "./detectMode";
+import { getValue } from "./getValue";
+export function formatString(template, dataOrFirstValue, optionsOrSecondValue, ...restValues) {
+    const escapedTemplate = template
+        .replaceAll("{{", "\u0000")
+        .replaceAll("}}", "\u0001");
+    const { data, options } = detectMode(dataOrFirstValue, optionsOrSecondValue, restValues);
+    const formatters = { ...defaultFormatters, ...options.formatters };
+    const result = escapedTemplate.replaceAll(/{([^}]+)}/g, (match, content) => {
+        const [pathAndFormatter, defaultValue] = content
+            .split("|")
+            .map((part) => part.trim());
+        const [path, ...formatterParts] = pathAndFormatter.split(":");
+        const formatterString = formatterParts.join(":");
+        let value;
+        if (Array.isArray(data)) {
+            const index = Number(path);
+            value = Number.isNaN(index) ? undefined : data[index];
+        }
+        else {
+            value = getValue(data, path);
+        }
+        if (value === undefined || value === null) {
+            if (defaultValue === undefined) {
+                return match;
+            }
+            value = defaultValue;
+        }
+        if (formatterString) {
+            return applyFormatter(value, formatterString, formatters);
+        }
+        return String(value);
+    });
+    return result.replaceAll("\u0000", "{").replaceAll("\u0001", "}");
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/String/formatString/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAqGtC,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,gBAA2C,EAC3C,oBAAkD,EAClD,GAAG,UAAyB;IAE5B,MAAM,eAAe,GAAG,QAAQ;SAC7B,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC;SAC1B,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAE9B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,UAAU,CAClC,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,CACX,CAAC;IAEF,MAAM,UAAU,GAAG,EAAE,GAAG,iBAAiB,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAEnE,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,CACvC,YAAY,EACZ,CAAC,KAAK,EAAE,OAAe,EAAE,EAAE;QACzB,MAAM,CAAC,gBAAgB,EAAE,YAAY,CAAC,GAAG,OAAO;aAC7C,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,EAAE,GAAG,cAAc,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9D,MAAM,eAAe,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEjD,IAAI,KAAc,CAAC;QACnB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;gBAC/B,OAAO,KAAK,CAAC;YACf,CAAC;YACD,KAAK,GAAG,YAAY,CAAC;QACvB,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,cAAc,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AACpE,CAAC"}

package/module/String/index.d.ts

@@ -1,12 +1,17 @@
+export * from "./camelCase";
 export * from "./deleteSpaces";
+export * from "./escapeHtml";
 export * from "./formatString";
 export * from "./fromBase64";
 export * from "./hasNoLetters";
+export * from "./kebabCase";
+export * from "./levenshteinDistance";
 export * from "./padEnd";
 export * from "./padStart";
 export * from "./randomString";
 export * from "./randomStringInitialization";
 export * from "./reverseString";
+export * from "./stringSimilarity";
 export * from "./toBase64";
 export * from "./toHalfWidth";
 export * from "./trimCharacters";

package/module/String/index.js

@@ -1,12 +1,17 @@
+export * from "./camelCase";
 export * from "./deleteSpaces";
+export * from "./escapeHtml";
 export * from "./formatString";
 export * from "./fromBase64";
 export * from "./hasNoLetters";
+export * from "./kebabCase";
+export * from "./levenshteinDistance";
 export * from "./padEnd";
 export * from "./padStart";
 export * from "./randomString";
 export * from "./randomStringInitialization";
 export * from "./reverseString";
+export * from "./stringSimilarity";
 export * from "./toBase64";
 export * from "./toHalfWidth";
 export * from "./trimCharacters";

package/module/String/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/String/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/String/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}

package/module/String/kebabCase.d.ts

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

package/module/String/kebabCase.js

@@ -0,0 +1,22 @@
+/**
+ * Converts a string to kebab-case
+ * @param str - The string to convert
+ * @returns The kebab-case string
+ */
+export const kebabCase = (string_) => {
+    return (string_
+        // Insert dash between lowercase and uppercase
+        .replaceAll(/([a-z])([A-Z])/g, "$1-$2")
+        // Insert dash between sequences of uppercase letters and following lowercase
+        .replaceAll(/([A-Z])([A-Z][a-z])/g, "$1-$2")
+        // Replace spaces and underscores with dashes
+        .replaceAll(/[\s_]+/g, "-")
+        // Remove special characters except alphanumeric and dashes
+        .replaceAll(/[^a-zA-Z0-9-]/g, "-")
+        // Remove multiple consecutive dashes
+        .replaceAll(/-+/g, "-")
+        // Remove leading and trailing dashes
+        .replaceAll(/^-|-$/g, "")
+        .toLowerCase());
+};
+//# sourceMappingURL=kebabCase.js.map

package/module/String/kebabCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebabCase.js","sourceRoot":"","sources":["../../src/String/kebabCase.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAU,EAAE;IACnD,OAAO,CACL,OAAO;QACL,8CAA8C;SAC7C,UAAU,CAAC,iBAAiB,EAAE,OAAO,CAAC;QACvC,6EAA6E;SAC5E,UAAU,CAAC,sBAAsB,EAAE,OAAO,CAAC;QAC5C,6CAA6C;SAC5C,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC;QAC3B,2DAA2D;SAC1D,UAAU,CAAC,gBAAgB,EAAE,GAAG,CAAC;QAClC,qCAAqC;SACpC,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC;QACvB,qCAAqC;SACpC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC;SACxB,WAAW,EAAE,CACjB,CAAC;AACJ,CAAC,CAAC"}

package/module/String/levenshteinDistance.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Calculates the Levenshtein distance between two strings
+ * Returns the minimum number of single-character edits (insertions, deletions, or substitutions)
+ * @param str1 - First string to compare
+ * @param str2 - Second string to compare
+ * @returns The Levenshtein distance
+ */
+export declare const levenshteinDistance: (string1: string, string2: string) => number;

package/module/String/levenshteinDistance.js

@@ -0,0 +1,38 @@
+/**
+ * Calculates the Levenshtein distance between two strings
+ * Returns the minimum number of single-character edits (insertions, deletions, or substitutions)
+ * @param str1 - First string to compare
+ * @param str2 - Second string to compare
+ * @returns The Levenshtein distance
+ */
+export const levenshteinDistance = (string1, string2) => {
+    const length1 = string1.length;
+    const length2 = string2.length;
+    // Return the length of the other string if one is empty
+    if (length1 === 0) {
+        return length2;
+    }
+    if (length2 === 0) {
+        return length1;
+    }
+    // Create a 2D array for dynamic programming
+    const matrix = Array.from({ length: length1 + 1 }, () => Array.from({ length: length2 + 1 }, () => 0));
+    // Initialize first column and row
+    for (let index = 0; index <= length1; index++) {
+        matrix[index][0] = index;
+    }
+    for (let index = 0; index <= length2; index++) {
+        matrix[0][index] = index;
+    }
+    // Calculate distances
+    for (let index = 1; index <= length1; index++) {
+        for (let index_ = 1; index_ <= length2; index_++) {
+            const cost = string1[index - 1] === string2[index_ - 1] ? 0 : 1;
+            matrix[index][index_] = Math.min(matrix[index - 1][index_] + 1, // deletion
+            matrix[index][index_ - 1] + 1, // insertion
+            matrix[index - 1][index_ - 1] + cost);
+        }
+    }
+    return matrix[length1][length2];
+};
+//# sourceMappingURL=levenshteinDistance.js.map