@pithos/core 2.0.0

package/dist/arkhe/object/pickBy.js

@@ -0,0 +1,46 @@
+/**
+ * Creates a new object with properties that satisfy the predicate.
+ *
+ * @template T - The type of the input object.
+ * @param object - The object to pick properties from.
+ * @param predicate - Function to test each property: `(value, key, object) => boolean`.
+ * @returns A new object with only the properties that pass the predicate.
+ * @since 2.0.0
+ *
+ * @note Only enumerable string keys are included (Symbol keys are ignored).
+ *
+ * @performance O(n) time & space where n is number of properties.
+ *
+ * @see pick
+ * @see omit
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: 'hello', c: 3, d: null };
+ *
+ * // Pick by value type
+ * pickBy(obj, (v) => typeof v === 'string');
+ * // => { b: 'hello' }
+ *
+ * // Pick by key pattern
+ * pickBy(obj, (_, key) => String(key).startsWith('a'));
+ * // => { a: 1 }
+ *
+ * // Pick non-null values
+ * pickBy(obj, (v) => v != null);
+ * // => { a: 1, b: 'hello', c: 3 }
+ * ```
+ */
+export function pickBy(object, predicate) {
+    const result = {};
+    const keys = Object.keys(object);
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        const value = object[key];
+        if (predicate(value, key, object)) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=pickBy.js.map

package/dist/arkhe/object/pickBy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickBy.js","sourceRoot":"","sources":["../../../src/arkhe/object/pickBy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,MAAM,CAKpB,MAAS,EACT,SAAkE;IAElE,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAmB,CAAC;IAEnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/arkhe/object/set.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Sets the value at path of object, returning a new object (immutable).
+ * @info Why wrapping native?: We prefer to wrap this method to ensure **Immutability** and safe property access. See [Design Philosophy](/guide/contribution/design-principles/design-philosophy/)
+ *
+ * @template T - The type of the input object.
+ * @param object - The object to set the value in.
+ * @param path - Property path (dot notation string, symbol, or array of keys).
+ * @param value - The value to set.
+ * @returns A new object with the value set at the specified path.
+ * @since 2.0.0
+ *
+ * @note Creates intermediate objects/arrays as needed based on path structure.
+ * @note Uses structuredClone for performance; falls back to deepClone for symbol keys.
+ *
+ * @performance O(n + m) time & space where n is object size, m is path length. structuredClone when possible (faster), deepClone only for symbol keys. Early returns for null/empty path.
+ *
+ * @see get
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: { b: { c: 3 } } };
+ *
+ * set(obj, 'a.b.c', 42);       // => { a: { b: { c: 42 } } }
+ * set(obj, ['a', 'b', 'd'], 'new'); // => { a: { b: { c: 3, d: 'new' } } }
+ *
+ * // Create nested structures automatically
+ * set({}, 'user.profile.name', 'John');
+ * // => { user: { profile: { name: 'John' } } }
+ *
+ * // Array creation with bracket notation
+ * set({}, 'items[0].value', 42);
+ * // => { items: [{ value: 42 }] }
+ * ```
+ */
+export declare function set<T = any>(object: T, path: string | symbol | (string | number | symbol)[], value: any): T;
+//# sourceMappingURL=set.d.ts.map

package/dist/arkhe/object/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../src/arkhe/object/set.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,wBAAgB,GAAG,CAAC,CAAC,GAAG,GAAG,EACzB,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,EAGpD,KAAK,EAAE,GAAG,GACT,CAAC,CAuEH"}

package/dist/arkhe/object/set.js

@@ -0,0 +1,125 @@
+import { parsePath } from "../string/parsers/path-parser";
+import { deepClone } from "./deep-clone";
+/**
+ * Sets the value at path of object, returning a new object (immutable).
+ * @info Why wrapping native?: We prefer to wrap this method to ensure **Immutability** and safe property access. See [Design Philosophy](/guide/contribution/design-principles/design-philosophy/)
+ *
+ * @template T - The type of the input object.
+ * @param object - The object to set the value in.
+ * @param path - Property path (dot notation string, symbol, or array of keys).
+ * @param value - The value to set.
+ * @returns A new object with the value set at the specified path.
+ * @since 2.0.0
+ *
+ * @note Creates intermediate objects/arrays as needed based on path structure.
+ * @note Uses structuredClone for performance; falls back to deepClone for symbol keys.
+ *
+ * @performance O(n + m) time & space where n is object size, m is path length. structuredClone when possible (faster), deepClone only for symbol keys. Early returns for null/empty path.
+ *
+ * @see get
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: { b: { c: 3 } } };
+ *
+ * set(obj, 'a.b.c', 42);       // => { a: { b: { c: 42 } } }
+ * set(obj, ['a', 'b', 'd'], 'new'); // => { a: { b: { c: 3, d: 'new' } } }
+ *
+ * // Create nested structures automatically
+ * set({}, 'user.profile.name', 'John');
+ * // => { user: { profile: { name: 'John' } } }
+ *
+ * // Array creation with bracket notation
+ * set({}, 'items[0].value', 42);
+ * // => { items: [{ value: 42 }] }
+ * ```
+ */
+// INTENTIONAL: any required for dynamic path access; type inference works at call site via generic T
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function set(object, path, 
+// INTENTIONAL: any required for dynamic value assignment
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+value) {
+    if (object == null) {
+        return value;
+    }
+    if (typeof path === "symbol") {
+        return { ...object, [path]: value };
+    }
+    // Stryker disable next-line ConditionalExpression,LogicalOperator,BlockStatement,StringLiteral,EqualityOperator,UnaryOperator: Fast-path optimization — parsePath-based path produces identical results for dot-only string paths
+    if (typeof path === "string" && path.indexOf("[") === -1 && !hasDigit(path)) {
+        // Stryker disable next-line ConditionalExpression: Early return optimization — parsePath([]) returns empty array handled identically below
+        if (path.length === 0)
+            return value;
+        const result = structuredClone(object);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let current = result;
+        let start = 0;
+        let dot;
+        while ((dot = path.indexOf(".", start)) !== -1) {
+            const segment = path.substring(start, dot);
+            if (current[segment] == null || typeof current[segment] !== "object") {
+                current[segment] = {};
+            }
+            current = current[segment];
+            start = dot + 1;
+        }
+        const lastKey = path.substring(start);
+        current[lastKey] = value;
+        return result;
+    }
+    const pathArray = typeof path === "string" ? parsePath(path) : path;
+    if (pathArray.length === 0) {
+        return value;
+    }
+    // Symbol check only needed for user-provided array paths (parsePath never returns symbols)
+    // Stryker disable next-line MethodExpression,EqualityOperator,ConditionalExpression,ArrowFunction,StringLiteral: Performance optimization - deepClone vs structuredClone produces identical results when original object has no symbol keys
+    const hasSymbol = Array.isArray(path) && path.some((k) => typeof k === "symbol");
+    const result = (hasSymbol ? deepClone(object) : structuredClone(object));
+    // Navigate to the target location and set the value
+    // INTENTIONAL: any required for dynamic nested property traversal
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let current = result;
+    const lastIndex = pathArray.length - 1;
+    for (let i = 0; i < lastIndex; i++) {
+        const key = pathArray[i];
+        if (current[key] == null || typeof current[key] !== "object") {
+            const nextKey = pathArray[i + 1];
+            current[key] =
+                typeof nextKey === "number" ||
+                    // Stryker disable next-line ConditionalExpression: typeof guard is optimization — isAllDigits on non-string returns false via NaN charCodeAt
+                    (typeof nextKey === "string" && isAllDigits(nextKey))
+                    ? []
+                    : {};
+        }
+        current = current[key];
+    }
+    const finalKey = pathArray[lastIndex];
+    current[finalKey] = value;
+    return result;
+}
+// Stryker disable next-line BlockStatement: Only used for fast-path optimization — both paths produce identical results
+function hasDigit(str) {
+    // Stryker disable next-line EqualityOperator: Only used for fast-path optimization
+    for (let i = 0; i < str.length; i++) {
+        const c = str.charCodeAt(i);
+        // Stryker disable next-line ConditionalExpression,LogicalOperator,EqualityOperator,BooleanLiteral: Only used for fast-path optimization
+        if (c >= 48 && c <= 57)
+            return true;
+    }
+    // Stryker disable next-line BooleanLiteral: Only used for fast-path optimization
+    return false;
+}
+function isAllDigits(str) {
+    if (str.length === 0)
+        return false;
+    // Stryker disable next-line EqualityOperator: Out-of-bounds charCodeAt returns NaN which never satisfies the rejection condition
+    for (let i = 0; i < str.length; i++) {
+        const c = str.charCodeAt(i);
+        // Stryker disable next-line ConditionalExpression: Chars below '0' (code 48) are not valid in path keys produced by parsePath
+        if (c < 48 || c > 57)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=set.js.map

package/dist/arkhe/object/set.js.map

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

package/dist/arkhe/string/camel-case.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Converts a string to camelCase.
+ *
+ * @param str - The string to convert.
+ * @returns The string in camelCase.
+ * @since 2.0.0
+ *
+ * @note Handles kebab-case, snake_case, PascalCase, space-separated strings, and acronyms.
+ *
+ * @performance O(n) single-pass charCode traversal, no regex.
+ *
+ * @example
+ * ```typescript
+ * camelCase('background-color'); // => 'backgroundColor'
+ * camelCase('font_size');        // => 'fontSize'
+ * camelCase('Hello World');      // => 'helloWorld'
+ * camelCase('PascalCase');       // => 'pascalCase'
+ * camelCase('HTTPRequest');      // => 'httpRequest'
+ * camelCase('--foo--bar--');     // => 'fooBar'
+ * ```
+ */
+export declare function camelCase(str: string): string;
+//# sourceMappingURL=camel-case.d.ts.map

package/dist/arkhe/string/camel-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camel-case.d.ts","sourceRoot":"","sources":["../../../src/arkhe/string/camel-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkE7C"}

package/dist/arkhe/string/camel-case.js

@@ -0,0 +1,89 @@
+/**
+ * Converts a string to camelCase.
+ *
+ * @param str - The string to convert.
+ * @returns The string in camelCase.
+ * @since 2.0.0
+ *
+ * @note Handles kebab-case, snake_case, PascalCase, space-separated strings, and acronyms.
+ *
+ * @performance O(n) single-pass charCode traversal, no regex.
+ *
+ * @example
+ * ```typescript
+ * camelCase('background-color'); // => 'backgroundColor'
+ * camelCase('font_size');        // => 'fontSize'
+ * camelCase('Hello World');      // => 'helloWorld'
+ * camelCase('PascalCase');       // => 'pascalCase'
+ * camelCase('HTTPRequest');      // => 'httpRequest'
+ * camelCase('--foo--bar--');     // => 'fooBar'
+ * ```
+ */
+export function camelCase(str) {
+    const len = str.length;
+    // Stryker disable next-line ConditionalExpression: Early return optimization — loop on empty string produces identical empty result
+    if (len === 0)
+        return "";
+    let result = "";
+    let wordStart = false;
+    let hasOutput = false;
+    for (let i = 0; i < len; i++) {
+        const code = str.charCodeAt(i);
+        // Separators: - (45), _ (95), whitespace (<=32 covers space, tab, newline, etc.)
+        if (code === 45 || code === 95 || code <= 32) {
+            if (hasOutput)
+                wordStart = true;
+            continue;
+        }
+        // Unicode whitespace (rare path)
+        if (code === 160 ||
+            code === 5760 ||
+            (code >= 8192 && code <= 8202) ||
+            code === 8232 ||
+            code === 8233 ||
+            code === 8239 ||
+            code === 8287 ||
+            code === 12288 ||
+            code === 65279) {
+            if (hasOutput)
+                wordStart = true;
+            continue;
+        }
+        if (code >= 65 && code <= 90) {
+            // Uppercase A-Z
+            // Stryker disable next-line ConditionalExpression,EqualityOperator: At i=0, charCodeAt(-1) returns NaN which fails the >= 65 check identically
+            if (i > 0 && str.charCodeAt(i - 1) >= 65 && str.charCodeAt(i - 1) <= 90) {
+                // Continuation of uppercase group: lowercase
+                result += String.fromCharCode(code + 32);
+            }
+            else if (!hasOutput) {
+                // First output: lowercase
+                result += String.fromCharCode(code + 32);
+                hasOutput = true;
+            }
+            else {
+                // First of uppercase group (word boundary): keep uppercase
+                result += str[i];
+            }
+            wordStart = false;
+        }
+        else if (code >= 97 && code <= 122) {
+            // Lowercase a-z
+            if (wordStart) {
+                result += String.fromCharCode(code - 32);
+                wordStart = false;
+            }
+            else {
+                result += str[i];
+            }
+            hasOutput = true;
+        }
+        else {
+            // Digit or other
+            result += str[i];
+            hasOutput = true;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=camel-case.js.map

package/dist/arkhe/string/camel-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camel-case.js","sourceRoot":"","sources":["../../../src/arkhe/string/camel-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IACvB,oIAAoI;IACpI,IAAI,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAE/B,iFAAiF;QACjF,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;YAC7C,IAAI,SAAS;gBAAE,SAAS,GAAG,IAAI,CAAC;YAChC,SAAS;QACX,CAAC;QAED,iCAAiC;QACjC,IACE,IAAI,KAAK,GAAG;YACZ,IAAI,KAAK,IAAI;YACb,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC;YAC9B,IAAI,KAAK,IAAI;YACb,IAAI,KAAK,IAAI;YACb,IAAI,KAAK,IAAI;YACb,IAAI,KAAK,IAAI;YACb,IAAI,KAAK,KAAK;YACd,IAAI,KAAK,KAAK,EACd,CAAC;YACD,IAAI,SAAS;gBAAE,SAAS,GAAG,IAAI,CAAC;YAChC,SAAS;QACX,CAAC;QAED,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;YAC7B,gBAAgB;YAChB,+IAA+I;YAC/I,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBACxE,6CAA6C;gBAC7C,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;YAC3C,CAAC;iBAAM,IAAI,CAAC,SAAS,EAAE,CAAC;gBACtB,0BAA0B;gBAC1B,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;gBACzC,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,2DAA2D;gBAC3D,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC;YACD,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;aAAM,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;YACrC,gBAAgB;YAChB,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;gBACzC,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC;YACD,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,iBAAiB;YACjB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YACjB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/arkhe/string/capitalize.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Converts the first character to uppercase and the rest to lowercase.
+ *
+ * @param str - The string to capitalize.
+ * @returns The capitalized string.
+ * @since 2.0.0
+ *
+ * @note Supports Unicode characters (accents, Cyrillic, etc.).
+ *
+ * @example
+ * ```typescript
+ * capitalize('hello');  // => 'Hello'
+ * capitalize('HELLO');  // => 'Hello'
+ * capitalize('été');    // => 'Été'
+ * capitalize('москва'); // => 'Москва'
+ * ```
+ */
+export declare function capitalize(str: string): string;
+//# sourceMappingURL=capitalize.d.ts.map

package/dist/arkhe/string/capitalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.d.ts","sourceRoot":"","sources":["../../../src/arkhe/string/capitalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK9C"}

package/dist/arkhe/string/capitalize.js

@@ -0,0 +1,24 @@
+/**
+ * Converts the first character to uppercase and the rest to lowercase.
+ *
+ * @param str - The string to capitalize.
+ * @returns The capitalized string.
+ * @since 2.0.0
+ *
+ * @note Supports Unicode characters (accents, Cyrillic, etc.).
+ *
+ * @example
+ * ```typescript
+ * capitalize('hello');  // => 'Hello'
+ * capitalize('HELLO');  // => 'Hello'
+ * capitalize('été');    // => 'Été'
+ * capitalize('москва'); // => 'Москва'
+ * ```
+ */
+export function capitalize(str) {
+    // Stryker disable next-line ConditionalExpression: equivalent mutant - str.charAt(0) on empty string returns "" anyway
+    if (str.length === 0)
+        return str;
+    return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+}
+//# sourceMappingURL=capitalize.js.map

package/dist/arkhe/string/capitalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.js","sourceRoot":"","sources":["../../../src/arkhe/string/capitalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,uHAAuH;IACvH,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAEjC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAClE,CAAC"}

package/dist/arkhe/string/constant-case.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Converts a string to CONSTANT_CASE.
+ *
+ * @param str - The string to convert.
+ * @returns The string in CONSTANT_CASE.
+ * @since 2.0.0
+ *
+ * @note Handles camelCase, kebab-case, space-separated strings, and acronyms.
+ *
+ * @performance O(n) where n is string length. Multiple regex passes.
+ *
+ * @example
+ * ```typescript
+ * constantCase('helloWorld');       // => 'HELLO_WORLD'
+ * constantCase('background-color'); // => 'BACKGROUND_COLOR'
+ * constantCase('foo bar');          // => 'FOO_BAR'
+ * constantCase('parseHTMLString');  // => 'PARSE_HTML_STRING'
+ * constantCase('--foo--bar--');     // => 'FOO_BAR'
+ * ```
+ */
+export declare function constantCase(str: string): string;
+//# sourceMappingURL=constant-case.d.ts.map

package/dist/arkhe/string/constant-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant-case.d.ts","sourceRoot":"","sources":["../../../src/arkhe/string/constant-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAahD"}

package/dist/arkhe/string/constant-case.js

@@ -0,0 +1,35 @@
+/**
+ * Converts a string to CONSTANT_CASE.
+ *
+ * @param str - The string to convert.
+ * @returns The string in CONSTANT_CASE.
+ * @since 2.0.0
+ *
+ * @note Handles camelCase, kebab-case, space-separated strings, and acronyms.
+ *
+ * @performance O(n) where n is string length. Multiple regex passes.
+ *
+ * @example
+ * ```typescript
+ * constantCase('helloWorld');       // => 'HELLO_WORLD'
+ * constantCase('background-color'); // => 'BACKGROUND_COLOR'
+ * constantCase('foo bar');          // => 'FOO_BAR'
+ * constantCase('parseHTMLString');  // => 'PARSE_HTML_STRING'
+ * constantCase('--foo--bar--');     // => 'FOO_BAR'
+ * ```
+ */
+export function constantCase(str) {
+    // Stryker disable next-line ConditionalExpression: equivalent mutant - empty string operations return "" anyway
+    if (str.length === 0)
+        return "";
+    // Stryker disable next-line StringLiteral,MethodExpression: equivalent mutants in regex replacement strings
+    return str
+        // Stryker disable next-line StringLiteral,MethodExpression: equivalent mutants in regex replacement strings
+        .replace(/([a-z])([A-Z])/g, "$1_$2")
+        .replace(/* Stryker disable next-line Regex */ /([A-Z]+)([A-Z][a-z])/g, "$1_$2")
+        // Stryker disable next-line StringLiteral,MethodExpression: equivalent mutants in regex replacement strings
+        .replace(/[\s\-_]+/g, "_")
+        .replace(/* Stryker disable next-line Regex */ /^_+|_+$/g, "")
+        .toUpperCase();
+}
+//# sourceMappingURL=constant-case.js.map

package/dist/arkhe/string/constant-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant-case.js","sourceRoot":"","sources":["../../../src/arkhe/string/constant-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,gHAAgH;IAChH,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,4GAA4G;IAC5G,OAAO,GAAG;QACR,4GAA4G;SAC3G,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,qCAAqC,CAAC,uBAAuB,EAAE,OAAO,CAAC;QAChF,4GAA4G;SAC3G,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;SACzB,OAAO,CAAC,qCAAqC,CAAC,UAAU,EAAE,EAAE,CAAC;SAC7D,WAAW,EAAE,CAAC;AACnB,CAAC"}

package/dist/arkhe/string/deburr.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Removes diacritical marks and converts ligatures to basic Latin letters.
+ *
+ * @param str - The string to deburr.
+ * @returns The deburred string.
+ * @since 2.0.0
+ *
+ * @note Uses NFD normalization. Expands ligatures (œ→oe, ß→ss, æ→ae, Þ→Th, etc.).
+ *
+ * @performance O(n) time where n is string length. Uses native `normalize()` and object lookup for ligatures.
+ *
+ * @example
+ * ```typescript
+ * deburr('café');      // => 'cafe'
+ * deburr('Müller');    // => 'Muller'
+ * deburr('Straße');    // => 'Strasse'
+ * deburr('Œuvre');     // => 'OEuvre'
+ * deburr('Þór');       // => 'Thor'
+ * deburr('Łódź');      // => 'Lodz'
+ * ```
+ */
+export declare function deburr(str: string): string;
+//# sourceMappingURL=deburr.d.ts.map

package/dist/arkhe/string/deburr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deburr.d.ts","sourceRoot":"","sources":["../../../src/arkhe/string/deburr.ts"],"names":[],"mappings":"AAuCA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ1C"}

package/dist/arkhe/string/deburr.js

@@ -0,0 +1,68 @@
+const LIGATURES = {
+    // Ligatures classiques
+    Œ: "OE",
+    œ: "oe",
+    Æ: "AE",
+    æ: "ae",
+    IJ: "IJ",
+    ij: "ij",
+    ß: "ss",
+    // Caractères nordiques
+    Ð: "D",
+    ð: "d",
+    Þ: "Th",
+    þ: "th",
+    Ø: "O",
+    ø: "o",
+    // Caractères d'Europe de l'Est
+    Ł: "L",
+    ł: "l",
+    Đ: "D",
+    đ: "d",
+    Ħ: "H",
+    ħ: "h",
+    Ŧ: "T",
+    ŧ: "t",
+    // Autres
+    Ŋ: "N",
+    ŋ: "n",
+    Ŀ: "L",
+    ŀ: "l",
+    ĸ: "k",
+    ı: "i",
+    ſ: "s",
+    ʼn: "'n",
+};
+// Regex pré-compilée pour les ligatures
+const LIGATURE_REGEX = new RegExp(`[${Object.keys(LIGATURES).join("")}]`, "g");
+/**
+ * Removes diacritical marks and converts ligatures to basic Latin letters.
+ *
+ * @param str - The string to deburr.
+ * @returns The deburred string.
+ * @since 2.0.0
+ *
+ * @note Uses NFD normalization. Expands ligatures (œ→oe, ß→ss, æ→ae, Þ→Th, etc.).
+ *
+ * @performance O(n) time where n is string length. Uses native `normalize()` and object lookup for ligatures.
+ *
+ * @example
+ * ```typescript
+ * deburr('café');      // => 'cafe'
+ * deburr('Müller');    // => 'Muller'
+ * deburr('Straße');    // => 'Strasse'
+ * deburr('Œuvre');     // => 'OEuvre'
+ * deburr('Þór');       // => 'Thor'
+ * deburr('Łódź');      // => 'Lodz'
+ * ```
+ */
+export function deburr(str) {
+    // Stryker disable next-line ConditionalExpression: equivalent mutant - empty string normalize/replace returns "" anyway
+    if (str.length === 0)
+        return "";
+    return str
+        .normalize("NFD")
+        .replace(/[\u0300-\u036f\ufe20-\ufe2f]/g, "")
+        .replace(LIGATURE_REGEX, (match) => LIGATURES[match]);
+}
+//# sourceMappingURL=deburr.js.map

package/dist/arkhe/string/deburr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deburr.js","sourceRoot":"","sources":["../../../src/arkhe/string/deburr.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GAA2B;IACxC,uBAAuB;IACvB,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,uBAAuB;IACvB,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,+BAA+B;IAC/B,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,SAAS;IACT,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,IAAI;CACR,CAAC;AAEF,wCAAwC;AACxC,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,wHAAwH;IACxH,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,OAAO,GAAG;SACP,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC;SAC5C,OAAO,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/arkhe/string/escape-regexp.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Escapes RegExp special characters in a string.
+ *
+ * @param str - The string to escape.
+ * @returns The escaped string safe for use in RegExp.
+ * @since 2.0.0
+ *
+ * @note Escapes: `^`, `$`, `\`, `.`, `*`, `+`, `?`, `(`, `)`, `[`, `]`, `{`, `}`, `|`.
+ *
+ * @performance O(n) time where n is string length. Single regex pass.
+ *
+ * @example
+ * ```typescript
+ * escapeRegExp('[lodash](https://lodash.com/)');
+ * // => '\\[lodash\\]\\(https://lodash\\.com/\\)'
+ *
+ * escapeRegExp('$100.00');
+ * // => '\\$100\\.00'
+ *
+ * // Use to create safe regex patterns
+ * const userInput = 'hello.*world';
+ * const pattern = new RegExp(escapeRegExp(userInput));
+ * pattern.test('hello.*world'); // => true
+ * pattern.test('helloXworld');  // => false
+ * ```
+ */
+export declare function escapeRegExp(str: string): string;
+//# sourceMappingURL=escape-regexp.d.ts.map

package/dist/arkhe/string/escape-regexp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-regexp.d.ts","sourceRoot":"","sources":["../../../src/arkhe/string/escape-regexp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD"}

package/dist/arkhe/string/escape-regexp.js

@@ -0,0 +1,33 @@
+/**
+ * Escapes RegExp special characters in a string.
+ *
+ * @param str - The string to escape.
+ * @returns The escaped string safe for use in RegExp.
+ * @since 2.0.0
+ *
+ * @note Escapes: `^`, `$`, `\`, `.`, `*`, `+`, `?`, `(`, `)`, `[`, `]`, `{`, `}`, `|`.
+ *
+ * @performance O(n) time where n is string length. Single regex pass.
+ *
+ * @example
+ * ```typescript
+ * escapeRegExp('[lodash](https://lodash.com/)');
+ * // => '\\[lodash\\]\\(https://lodash\\.com/\\)'
+ *
+ * escapeRegExp('$100.00');
+ * // => '\\$100\\.00'
+ *
+ * // Use to create safe regex patterns
+ * const userInput = 'hello.*world';
+ * const pattern = new RegExp(escapeRegExp(userInput));
+ * pattern.test('hello.*world'); // => true
+ * pattern.test('helloXworld');  // => false
+ * ```
+ */
+export function escapeRegExp(str) {
+    // Stryker disable next-line ConditionalExpression: equivalent mutant - empty string replace returns "" anyway
+    if (str.length === 0)
+        return "";
+    return str.replace(/[\\^$.*+?()[\]{}|]/g, "\\$&");
+}
+//# sourceMappingURL=escape-regexp.js.map

package/dist/arkhe/string/escape-regexp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-regexp.js","sourceRoot":"","sources":["../../../src/arkhe/string/escape-regexp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,8GAA8G;IAC9G,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}