@pithos/core 2.0.0

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

@@ -0,0 +1,25 @@
+/**
+ * Converts a string to PascalCase.
+ *
+ * @param str - The string to convert.
+ * @returns The string in PascalCase.
+ * @since 2.0.0
+ *
+ * @note Handles kebab-case, snake_case, camelCase, and space-separated strings.
+ *       Delegates word parsing to `camelCase` for consistency.
+ *
+ * @performance O(n) where n is string length. Single pass via camelCase + O(1) uppercase.
+ *
+ * @see camelCase
+ *
+ * @example
+ * ```typescript
+ * pascalCase('hello-world');      // => 'HelloWorld'
+ * pascalCase('background_color'); // => 'BackgroundColor'
+ * pascalCase('foo bar');          // => 'FooBar'
+ * pascalCase('helloWorld');       // => 'HelloWorld'
+ * pascalCase('XMLHttpRequest');   // => 'XmlHttpRequest'
+ * ```
+ */
+export declare function pascalCase(str: string): string;
+//# sourceMappingURL=pascal-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pascal-case.d.ts","sourceRoot":"","sources":["../../../src/arkhe/string/pascal-case.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS9C"}

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

@@ -0,0 +1,35 @@
+import { camelCase } from "./camel-case";
+/**
+ * Converts a string to PascalCase.
+ *
+ * @param str - The string to convert.
+ * @returns The string in PascalCase.
+ * @since 2.0.0
+ *
+ * @note Handles kebab-case, snake_case, camelCase, and space-separated strings.
+ *       Delegates word parsing to `camelCase` for consistency.
+ *
+ * @performance O(n) where n is string length. Single pass via camelCase + O(1) uppercase.
+ *
+ * @see camelCase
+ *
+ * @example
+ * ```typescript
+ * pascalCase('hello-world');      // => 'HelloWorld'
+ * pascalCase('background_color'); // => 'BackgroundColor'
+ * pascalCase('foo bar');          // => 'FooBar'
+ * pascalCase('helloWorld');       // => 'HelloWorld'
+ * pascalCase('XMLHttpRequest');   // => 'XmlHttpRequest'
+ * ```
+ */
+export function pascalCase(str) {
+    // Stryker disable next-line ConditionalExpression: equivalent mutant - camelCase("") returns "" anyway
+    if (str.length === 0)
+        return "";
+    const camel = camelCase(str);
+    // Stryker disable next-line ConditionalExpression: equivalent mutant - "".charAt(0).toUpperCase() returns "" anyway
+    if (camel.length === 0)
+        return "";
+    return camel.charAt(0).toUpperCase() + camel.slice(1);
+}
+//# sourceMappingURL=pascal-case.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pascal-case.js","sourceRoot":"","sources":["../../../src/arkhe/string/pascal-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,uGAAuG;IACvG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,oHAAoH;IACpH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * Converts a string to Sentence case.
+ *
+ * @param str - The string to convert.
+ * @returns The string in Sentence case.
+ * @since 2.0.0
+ *
+ * @note First character uppercase, rest lowercase. Alias behavior of `capitalize`.
+ *
+ * @see capitalize
+ *
+ * @example
+ * ```typescript
+ * sentenceCase('HELLO WORLD'); // => 'Hello world'
+ * sentenceCase('hELLO wORLD'); // => 'Hello world'
+ * sentenceCase('hello');       // => 'Hello'
+ * ```
+ */
+export declare function sentenceCase(str: string): string;
+//# sourceMappingURL=sentence-case.d.ts.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * Converts a string to Sentence case.
+ *
+ * @param str - The string to convert.
+ * @returns The string in Sentence case.
+ * @since 2.0.0
+ *
+ * @note First character uppercase, rest lowercase. Alias behavior of `capitalize`.
+ *
+ * @see capitalize
+ *
+ * @example
+ * ```typescript
+ * sentenceCase('HELLO WORLD'); // => 'Hello world'
+ * sentenceCase('hELLO wORLD'); // => 'Hello world'
+ * sentenceCase('hello');       // => 'Hello'
+ * ```
+ */
+export function sentenceCase(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=sentence-case.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sentence-case.js","sourceRoot":"","sources":["../../../src/arkhe/string/sentence-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,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/snake-case.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Converts a string to snake_case.
+ *
+ * @param str - The string to convert.
+ * @returns The string in snake_case.
+ * @since 2.0.0
+ *
+ * @note Handles camelCase, PascalCase, acronyms, kebab-case, and spaces.
+ *
+ * @performance O(n) where n is string length. Single regex pass with match + join.
+ *
+ * @example
+ * ```typescript
+ * snakeCase('helloWorld');     // => 'hello_world'
+ * snakeCase('XMLHttpRequest'); // => 'xml_http_request'
+ * snakeCase('hello-world');    // => 'hello_world'
+ * snakeCase('Hello World');    // => 'hello_world'
+ * snakeCase('--foo--bar--');   // => 'foo_bar'
+ * ```
+ */
+export declare function snakeCase(str: string): string;
+//# sourceMappingURL=snake-case.d.ts.map

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

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

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

@@ -0,0 +1,38 @@
+/**
+ * Pattern to split strings into words for case conversion.
+ * Matches: lowercase sequences (with trailing digits), uppercase sequences, uppercase followed by lowercase, standalone digits.
+ *
+ * @internal
+ */
+const WORD_PATTERN = /[A-Z]{2,}(?=[A-Z][a-z]|[0-9]|[^a-zA-Z0-9]|$)|[A-Z]?[a-z]+[0-9]*|[A-Z]+|[0-9]+/g;
+/**
+ * Converts a string to snake_case.
+ *
+ * @param str - The string to convert.
+ * @returns The string in snake_case.
+ * @since 2.0.0
+ *
+ * @note Handles camelCase, PascalCase, acronyms, kebab-case, and spaces.
+ *
+ * @performance O(n) where n is string length. Single regex pass with match + join.
+ *
+ * @example
+ * ```typescript
+ * snakeCase('helloWorld');     // => 'hello_world'
+ * snakeCase('XMLHttpRequest'); // => 'xml_http_request'
+ * snakeCase('hello-world');    // => 'hello_world'
+ * snakeCase('Hello World');    // => 'hello_world'
+ * snakeCase('--foo--bar--');   // => 'foo_bar'
+ * ```
+ */
+export function snakeCase(str) {
+    // Stryker disable next-line ConditionalExpression: equivalent mutant - empty string operations return "" anyway
+    if (str.length === 0)
+        return "";
+    const words = str.match(WORD_PATTERN);
+    // Stryker disable next-line ConditionalExpression: no words means empty result
+    if (!words)
+        return "";
+    return words.map((word) => word.toLowerCase()).join("_");
+}
+//# sourceMappingURL=snake-case.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snake-case.js","sourceRoot":"","sources":["../../../src/arkhe/string/snake-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,YAAY,GAChB,gFAAgF,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,gHAAgH;IAChH,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACtC,+EAA+E;IAC/E,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * Replaces `{key}` placeholders in a string with values from a data object.
+ *
+ * @param template - The template string with `{key}` placeholders.
+ * @param data - The data object containing values.
+ * @returns The interpolated string.
+ * @since 2.0.0
+ *
+ * @note Supports nested paths (`{user.name}`). Use `{{` and `}}` for literal braces. Missing keys become empty strings.
+ *
+ * @performance O(n × m) time where n is template length, m is max path depth. Single regex pass with reduce for nested paths.
+ *
+ * @example
+ * ```typescript
+ * template('Hello {name}', { name: 'World' });
+ * // => 'Hello World'
+ *
+ * template('{user.name} <{user.email}>', {
+ *   user: { name: 'John', email: 'john@example.com' }
+ * });
+ * // => 'John <john@example.com>'
+ *
+ * template('Literal: {{escaped}}', {});
+ * // => 'Literal: {escaped}'
+ * ```
+ */
+export declare function template(template: string, data?: Record<string, unknown>): string;
+//# sourceMappingURL=template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/arkhe/string/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,MAAM,CAiBR"}

package/dist/arkhe/string/template.js

@@ -0,0 +1,45 @@
+/**
+ * Replaces `{key}` placeholders in a string with values from a data object.
+ *
+ * @param template - The template string with `{key}` placeholders.
+ * @param data - The data object containing values.
+ * @returns The interpolated string.
+ * @since 2.0.0
+ *
+ * @note Supports nested paths (`{user.name}`). Use `{{` and `}}` for literal braces. Missing keys become empty strings.
+ *
+ * @performance O(n × m) time where n is template length, m is max path depth. Single regex pass with reduce for nested paths.
+ *
+ * @example
+ * ```typescript
+ * template('Hello {name}', { name: 'World' });
+ * // => 'Hello World'
+ *
+ * template('{user.name} <{user.email}>', {
+ *   user: { name: 'John', email: 'john@example.com' }
+ * });
+ * // => 'John <john@example.com>'
+ *
+ * template('Literal: {{escaped}}', {});
+ * // => 'Literal: {escaped}'
+ * ```
+ */
+export function template(template, data = {}) {
+    return template.replace(/\{\{|\}\}|\{([^}]+)\}/g, (match, key) => {
+        if (match === "{{")
+            return "{";
+        if (match === "}}")
+            return "}";
+        const value = key
+            .trim()
+            .split(".")
+            .reduce((obj, k) => {
+            // Stryker disable next-line ConditionalExpression: equivalent mutant - accessing property on primitive returns undefined anyway
+            return obj != null && typeof obj === "object"
+                ? obj[k]
+                : undefined;
+        }, data);
+        return value != null ? String(value) : "";
+    });
+}
+//# sourceMappingURL=template.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/arkhe/string/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,QAAQ,CACtB,QAAgB,EAChB,OAAgC,EAAE;IAElC,OAAO,QAAQ,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC/D,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,GAAG,CAAC;QAC/B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,GAAG,CAAC;QAE/B,MAAM,KAAK,GAAG,GAAG;aACd,IAAI,EAAE;aACN,KAAK,CAAC,GAAG,CAAC;aACV,MAAM,CAAC,CAAC,GAAY,EAAE,CAAS,EAAE,EAAE;YAClC,gIAAgI;YAChI,OAAO,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAC3C,CAAC,CAAE,GAA+B,CAAC,CAAC,CAAC;gBACrC,CAAC,CAAC,SAAS,CAAC;QAChB,CAAC,EAAE,IAAI,CAAC,CAAC;QAEX,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Converts a string to Title Case.
+ *
+ * @param str - The string to convert.
+ * @returns The string in Title Case.
+ * @since 2.0.0
+ *
+ * @note Capitalizes after spaces, hyphens, and underscores. Supports Unicode.
+ *
+ * @example
+ * ```typescript
+ * titleCase('hello world');  // => 'Hello World'
+ * titleCase('hello-world');  // => 'Hello-World'
+ * titleCase('HELLO WORLD');  // => 'Hello World'
+ * titleCase('café résumé');  // => 'Café Résumé'
+ * ```
+ */
+export declare function titleCase(str: string): string;
+//# sourceMappingURL=title-case.d.ts.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * Converts a string to Title Case.
+ *
+ * @param str - The string to convert.
+ * @returns The string in Title Case.
+ * @since 2.0.0
+ *
+ * @note Capitalizes after spaces, hyphens, and underscores. Supports Unicode.
+ *
+ * @example
+ * ```typescript
+ * titleCase('hello world');  // => 'Hello World'
+ * titleCase('hello-world');  // => 'Hello-World'
+ * titleCase('HELLO WORLD');  // => 'Hello World'
+ * titleCase('café résumé');  // => 'Café Résumé'
+ * ```
+ */
+export function titleCase(str) {
+    return str
+        .toLowerCase()
+        .replace(/(^|\s|-|_)(\p{L})/gu, (_, separator, letter) => separator + letter.toUpperCase());
+}
+//# sourceMappingURL=title-case.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"title-case.js","sourceRoot":"","sources":["../../../src/arkhe/string/title-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,GAAG;SACP,WAAW,EAAE;SACb,OAAO,CACN,qBAAqB,EACrB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,SAAS,GAAG,MAAM,CAAC,WAAW,EAAE,CAC3D,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,48 @@
+/**
+ * Options for the truncate function.
+ * @since 2.0.0
+ */
+export interface TruncateOptions {
+    /** Maximum string length (default: 30). */
+    length?: number;
+    /** The string to indicate text is omitted (default: '...'). */
+    omission?: string;
+    /** The separator pattern to truncate to. */
+    separator?: string | RegExp;
+}
+/**
+ * Truncates string if it's longer than the given maximum length.
+ *
+ * @param str - The string to truncate.
+ * @param options - The options object.
+ * @returns The truncated string.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * truncate('hi-diddly-ho there, neighborino');
+ * // => 'hi-diddly-ho there, neighbo...'
+ *
+ * truncate('hi-diddly-ho there, neighborino', { length: 24 });
+ * // => 'hi-diddly-ho there, n...'
+ *
+ * truncate('hi-diddly-ho there, neighborino', {
+ *   length: 24,
+ *   separator: ' '
+ * });
+ * // => 'hi-diddly-ho there,...'
+ *
+ * truncate('hi-diddly-ho there, neighborino', {
+ *   length: 24,
+ *   separator: /,? +/
+ * });
+ * // => 'hi-diddly-ho there...'
+ *
+ * truncate('hi-diddly-ho there, neighborino', {
+ *   omission: ' [...]'
+ * });
+ * // => 'hi-diddly-ho there, neig [...]'
+ * ```
+ */
+export declare function truncate(str: string, options?: TruncateOptions): string;
+//# sourceMappingURL=truncate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../../src/arkhe/string/truncate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CAwC3E"}

package/dist/arkhe/string/truncate.js

@@ -0,0 +1,67 @@
+/**
+ * Truncates string if it's longer than the given maximum length.
+ *
+ * @param str - The string to truncate.
+ * @param options - The options object.
+ * @returns The truncated string.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * truncate('hi-diddly-ho there, neighborino');
+ * // => 'hi-diddly-ho there, neighbo...'
+ *
+ * truncate('hi-diddly-ho there, neighborino', { length: 24 });
+ * // => 'hi-diddly-ho there, n...'
+ *
+ * truncate('hi-diddly-ho there, neighborino', {
+ *   length: 24,
+ *   separator: ' '
+ * });
+ * // => 'hi-diddly-ho there,...'
+ *
+ * truncate('hi-diddly-ho there, neighborino', {
+ *   length: 24,
+ *   separator: /,? +/
+ * });
+ * // => 'hi-diddly-ho there...'
+ *
+ * truncate('hi-diddly-ho there, neighborino', {
+ *   omission: ' [...]'
+ * });
+ * // => 'hi-diddly-ho there, neig [...]'
+ * ```
+ */
+export function truncate(str, options = {}) {
+    const { length = 30, omission = "...", separator } = options;
+    if (str.length <= length) {
+        return str;
+    }
+    const maxLength = length - omission.length;
+    // Stryker disable next-line EqualityOperator: equivalent mutant - when maxLength === 0, str.slice(0, 0) + omission equals omission.slice(0, length)
+    if (maxLength < 0) {
+        return omission.slice(0, length);
+    }
+    let truncated = str.slice(0, maxLength);
+    if (separator !== undefined) {
+        if (typeof separator === "string") {
+            const lastIndex = truncated.lastIndexOf(separator);
+            if (lastIndex > 0) {
+                truncated = truncated.slice(0, lastIndex);
+            }
+        }
+        else {
+            let lastMatch = null;
+            const globalSeparator = new RegExp(separator.source, separator.flags.includes("g") ? separator.flags : separator.flags + "g");
+            let match;
+            while ((match = globalSeparator.exec(truncated)) !== null) {
+                lastMatch = match;
+            }
+            if (lastMatch && lastMatch.index > 0) {
+                truncated = truncated.slice(0, lastMatch.index);
+            }
+        }
+    }
+    return truncated + omission;
+}
+//# sourceMappingURL=truncate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../../src/arkhe/string/truncate.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,UAA2B,EAAE;IACjE,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,QAAQ,GAAG,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE7D,IAAI,GAAG,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC3C,oJAAoJ;IACpJ,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAExC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YACnD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAClB,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,SAAS,GAA2B,IAAI,CAAC;YAC7C,MAAM,eAAe,GAAG,IAAI,MAAM,CAChC,SAAS,CAAC,MAAM,EAChB,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,GAAG,CACxE,CAAC;YAEF,IAAI,KAAK,CAAC;YACV,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC1D,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;YAED,IAAI,SAAS,IAAI,SAAS,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;gBACrC,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,GAAG,QAAQ,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * Unescapes HTML entities to their corresponding characters.
+ *
+ * @param str - The string to unescape.
+ * @returns The unescaped string.
+ * @since 2.0.0
+ *
+ * @note Unescapes `&`, `<`, `>`, `"`, and `'`.
+ *
+ * @performance O(n) time where n is string length. Single regex pass with object lookup.
+ *
+ * @see escape
+ *
+ * @example
+ * ```typescript
+ * unescape('&lt;div&gt;');           // => '<div>'
+ * unescape('a &amp; b');             // => 'a & b'
+ * unescape('&quot;hello&quot;');     // => '"hello"'
+ * unescape('&#39;quoted&#39;');      // => "'quoted'"
+ *
+ * // Roundtrip with escape
+ * const original = '<script>alert("XSS")</script>';
+ * unescape(escape(original)) === original; // => true
+ * ```
+ */
+export declare function unescape(str: string): string;
+//# sourceMappingURL=unescape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unescape.d.ts","sourceRoot":"","sources":["../../../src/arkhe/string/unescape.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK5C"}

package/dist/arkhe/string/unescape.js

@@ -0,0 +1,40 @@
+const HTML_UNESCAPES = {
+    "&": "&",
+    "&lt;": "<",
+    "&gt;": ">",
+    "&quot;": '"',
+    "&#39;": "'",
+};
+const UNESCAPE_PATTERN = /&(?:amp|lt|gt|quot|#39);/g;
+/**
+ * Unescapes HTML entities to their corresponding characters.
+ *
+ * @param str - The string to unescape.
+ * @returns The unescaped string.
+ * @since 2.0.0
+ *
+ * @note Unescapes `&amp;`, `&lt;`, `&gt;`, `&quot;`, and `&#39;`.
+ *
+ * @performance O(n) time where n is string length. Single regex pass with object lookup.
+ *
+ * @see escape
+ *
+ * @example
+ * ```typescript
+ * unescape('&lt;div&gt;');           // => '<div>'
+ * unescape('a &amp; b');             // => 'a & b'
+ * unescape('&quot;hello&quot;');     // => '"hello"'
+ * unescape('&#39;quoted&#39;');      // => "'quoted'"
+ *
+ * // Roundtrip with escape
+ * const original = '<script>alert("XSS")</script>';
+ * unescape(escape(original)) === original; // => true
+ * ```
+ */
+export function unescape(str) {
+    // Stryker disable next-line ConditionalExpression: equivalent mutant - empty string replace returns "" anyway
+    if (str.length === 0)
+        return "";
+    return str.replace(UNESCAPE_PATTERN, (match) => HTML_UNESCAPES[match]);
+}
+//# sourceMappingURL=unescape.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unescape.js","sourceRoot":"","sources":["../../../src/arkhe/string/unescape.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAA2B;IAC7C,OAAO,EAAE,GAAG;IACZ,MAAM,EAAE,GAAG;IACX,MAAM,EAAE,GAAG;IACX,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,GAAG;CACb,CAAC;AAEF,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,8GAA8G;IAC9G,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/arkhe/string/uniq-with.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Creates a duplicate-free version of a string using a custom comparator.
+ *
+ * @param str - The string to process.
+ * @param comparator - Function to compare characters for equality.
+ * @returns The string with unique characters (first occurrence kept).
+ * @since 2.0.0
+ *
+ * @note Keeps first occurrence of each character. O(n²) complexity.
+ *
+ * @performance O(n²) time, O(n) space where n is string length. Uses `every()` for each character check.
+ *
+ * @example
+ * ```typescript
+ * uniqWith('hello', (a, b) => a === b);
+ * // => 'helo'
+ *
+ * uniqWith('Hello', (a, b) => a.toLowerCase() === b.toLowerCase());
+ * // => 'Helo'
+ *
+ * uniqWith('hello   world', (a, b) => /\s/.test(a) && /\s/.test(b));
+ * // => 'hello world'
+ * ```
+ */
+export declare function uniqWith(str: string, comparator: (a: string, b: string) => boolean): string;
+//# sourceMappingURL=uniq-with.d.ts.map

package/dist/arkhe/string/uniq-with.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniq-with.d.ts","sourceRoot":"","sources":["../../../src/arkhe/string/uniq-with.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,GAC5C,MAAM,CAYR"}

package/dist/arkhe/string/uniq-with.js

@@ -0,0 +1,35 @@
+/**
+ * Creates a duplicate-free version of a string using a custom comparator.
+ *
+ * @param str - The string to process.
+ * @param comparator - Function to compare characters for equality.
+ * @returns The string with unique characters (first occurrence kept).
+ * @since 2.0.0
+ *
+ * @note Keeps first occurrence of each character. O(n²) complexity.
+ *
+ * @performance O(n²) time, O(n) space where n is string length. Uses `every()` for each character check.
+ *
+ * @example
+ * ```typescript
+ * uniqWith('hello', (a, b) => a === b);
+ * // => 'helo'
+ *
+ * uniqWith('Hello', (a, b) => a.toLowerCase() === b.toLowerCase());
+ * // => 'Helo'
+ *
+ * uniqWith('hello   world', (a, b) => /\s/.test(a) && /\s/.test(b));
+ * // => 'hello world'
+ * ```
+ */
+export function uniqWith(str, comparator) {
+    const result = [];
+    for (const char of str) {
+        const isUnique = result.every((existing) => !comparator(existing, char));
+        if (isUnique) {
+            result.push(char);
+        }
+    }
+    return result.join("");
+}
+//# sourceMappingURL=uniq-with.js.map

package/dist/arkhe/string/uniq-with.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniq-with.js","sourceRoot":"","sources":["../../../src/arkhe/string/uniq-with.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,QAAQ,CACtB,GAAW,EACX,UAA6C;IAE7C,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QAEzE,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Converts string to upper case with space-separated words.
+ *
+ * @param str - The string to convert.
+ * @returns The upper cased string with words separated by spaces.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toUpperCase | String.toUpperCase() - MDN}
+ * @since 2.0.0
+ *
+ * @performance O(n) — charCode word splitting for short ASCII, regex for long/Unicode/emoji.
+ *
+ * @example
+ * ```typescript
+ * upperCase('--Foo-Bar--');  // => 'FOO BAR'
+ * upperCase('fooBar');       // => 'FOO BAR'
+ * upperCase('__foo_bar__');  // => 'FOO BAR'
+ * ```
+ */
+export declare function upperCase(str: string | null | undefined): string;
+//# sourceMappingURL=upper-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upper-case.d.ts","sourceRoot":"","sources":["../../../src/arkhe/string/upper-case.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CA+FhE"}