@pawells/typescript-common 1.0.0

package/build/object/sort-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-keys.js","sourceRoot":"","sources":["../../src/object/sort-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,cAAc,CAAgC,MAAS;IACtE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,OAAO,MAAM,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAChD,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC;QACpB,OAAO,CAAC,CAAC;IACV,CAAC,CAAC;SACA,MAAM,CACN,CAAC,KAAQ,EAAE,GAAW,EAAE,EAAE;QACzB,KAAK,CAAC,GAAc,CAAC,GAAG,MAAM,CAAC,GAAc,CAAC,CAAC;QAC/C,OAAO,KAAK,CAAC;IACd,CAAC,EACD,EAAO,CACP,CAAC;IAEH,qCAAqC;IACrC,MAAM,OAAO,GAAG,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAEnD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YACxD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAChE,IAAI,UAAU,EAAE,CAAC;gBAChB,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;YAChD,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/build/object/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * A constructor function type for creating objects of type O.
+ * @template O The object type to construct.
+ */
+export type TConstructableObject<O extends object = object> = new (...args: any[]) => O;
+/**
+ * Omits properties from B that are not in A.
+ * @template A Base type.
+ * @template B Type to filter.
+ */
+export type TObjectOmitExtraProperties<A, B> = {
+    [K in keyof B]: K extends A ? B[K] : never;
+};
+/**
+ * Extracts the property keys of an object type.
+ * @template O The object type.
+ */
+export type TObjectProperties<O extends object> = keyof O;
+/**
+ * Extracts property keys of a specific type from an object.
+ * @template O Object type.
+ * @template PropertyType The type to match.
+ */
+export type TObjectPropertiesOfType<O extends object, PropertyType> = keyof {
+    [K in keyof O as O[K] extends PropertyType ? K : never]: any;
+};
+/**
+ * Omits properties of a specific type from an object.
+ * @template O Object type.
+ * @template PropertyType The type to omit.
+ */
+export type TObjectOmitPropertiesOfType<O extends object, PropertyType> = {
+    [K in keyof O as O[K] extends PropertyType ? never : K]: O[K];
+};
+/**
+ * Represents the union of all property values in an object.
+ * @template T Object type.
+ */
+export type TObjectPropertyType<T extends object> = T[keyof T];
+/**
+ * Extracts properties shared between two object types.
+ * @template A First object type.
+ * @template B Second object type.
+ */
+export type TObjectSharedProperties<A extends object, B extends object> = {
+    [K in keyof A & keyof B]: K extends keyof A ? A[K] : never;
+};
+/**
+ * Extracts keys of array properties from an object type.
+ * @template T Object type.
+ */
+export type TObjectArrayProperties<T extends object> = {
+    [K in keyof T]: T[K] extends Array<any> ? K : never;
+}[keyof T];
+/**
+ * Generates nested dot-notation keys for an object type.
+ * @template ObjectType The object type.
+ */
+export type TObjectNestedKeyOf<ObjectType extends object> = {
+    [Key in keyof ObjectType & (string | number)]: ObjectType[Key] extends object ? `${Key}` | `${Key}.${TObjectNestedKeyOf<ObjectType[Key]>}` : `${Key}`;
+}[keyof ObjectType & (string | number)];
+/**
+ * Options for object filtering behavior.
+ */
+export interface IObjectFilterOptions {
+    /** When `true`, uses deep equality for nested object comparisons instead of strict reference equality. Default: `false`. */
+    useDeepEqual?: boolean | undefined;
+    /** When `true`, string comparisons are case-insensitive. Default: `false`. */
+    caseInsensitiveStrings?: boolean | undefined;
+    /** When `true`, validates dot-notation property paths against prototype-pollution patterns. Default: `false`. */
+    validatePaths?: boolean | undefined;
+}
+/**
+ * Options for cached object filtering behavior.
+ */
+export interface ICachedObjectFilterOptions {
+    /** Maximum number of unique (filter, object) result pairs to store in the cache. Default: `1000`. */
+    maxCacheSize?: number | undefined;
+    /** When `true`, uses deep equality for nested object comparisons instead of strict reference equality. Default: `false`. */
+    useDeepEqual?: boolean | undefined;
+    /** When `true`, string comparisons are case-insensitive. Default: `false`. */
+    caseInsensitiveStrings?: boolean | undefined;
+    /** When `true`, validates dot-notation property paths against prototype-pollution patterns. Default: `false`. */
+    validatePaths?: boolean | undefined;
+}
+/**
+ * Options for cached object mapping behavior.
+ */
+export interface ICachedObjectMapOptions {
+    /** Maximum number of cached mapping results to retain per mapper key. Default: `1000`. */
+    maxCacheSize?: number | undefined;
+}
+/**
+ * Type for cached object filter functions.
+ * @template T The object type being filtered.
+ */
+export type TCachedObjectFilterFunction<T extends object> = (cursor: T, filter: Partial<Record<string, any>>) => Promise<boolean>;
+/**
+ * Type for cached object map functions.
+ * @template T The object type being mapped.
+ */
+export type TCachedObjectMapperFunction<T extends object> = (cursor: T, mapper: TPropertyMapper<T>, mapperKey?: string) => Promise<Record<keyof T, unknown>>;
+/**
+ * Object predicate function type for filtering and validation
+ * @template T - The type of object being tested
+ * @param obj - The object to test
+ * @returns true if the object passes the predicate, false otherwise
+ */
+export type TObjectPredicate<T extends object = object> = (obj: T) => boolean;
+/**
+ * Object transformer function type for mapping operations
+ * @template TInput - The input object type
+ * @template TOutput - The output object type
+ * @param input - The object to transform
+ * @returns The transformed object
+ */
+export type TObjectTransformer<TInput extends object = object, TOutput extends object = object> = (input: TInput) => TOutput;
+/**
+ * Object comparator function type for sorting and comparison
+ * @template T - The type of objects being compared
+ * @param a - First object
+ * @param b - Second object
+ * @returns Negative if a < b, zero if a === b, positive if a > b
+ */
+export type TObjectComparator<T extends object = object> = (a: T, b: T) => number;
+/**
+ * Object equality comparator function type
+ * @template T - The type of objects being compared
+ * @param a - First object
+ * @param b - Second object
+ * @returns true if objects are equal, false otherwise
+ */
+export type TObjectEqualityComparator<T extends object = object> = (a: T, b: T) => boolean;
+/**
+ * Property mapper function type
+ * @template T - The object type
+ * @template K - The property key type
+ * @param key - The property key
+ * @param value - The property value
+ * @returns The mapped value
+ */
+export type TPropertyMapper<T extends object = object, K extends keyof T = keyof T> = (key: K, value: T[K]) => unknown;
+/**
+ * Property filter predicate type
+ * @template T - The object type
+ * @template K - The property key type
+ * @param key - The property key
+ * @param value - The property value
+ * @returns true to include the property, false to exclude
+ */
+export type TPropertyFilter<T extends object = object, K extends keyof T = keyof T> = (key: K, value: T[K]) => boolean;
+//# sourceMappingURL=types.d.ts.map

package/build/object/types.d.ts.map

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

package/build/object/types.js

@@ -0,0 +1,6 @@
+/**
+ * A constructor function type for creating objects of type O.
+ * @template O The object type to construct.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/build/object/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/object/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/build/string/case-conversion.d.ts

@@ -0,0 +1,50 @@
+import type { TCaseConverter } from './types';
+/**
+ * Converts a string to camelCase.
+ *
+ * @param value The input string.
+ * @returns The camelCased string.
+ * @see {@link TCaseConverter}
+ */
+export declare function CamelCase(value: string): string;
+/**
+ * Capitalizes the first letter of a string.
+ *
+ * @param value The input string.
+ * @returns The capitalized string.
+ * @see {@link TCaseConverter}
+ */
+export declare const CAPITALIZE: TCaseConverter;
+/**
+ * Converts a string to kebab-case.
+ *
+ * @param value The input string.
+ * @returns The kebab-cased string.
+ * @see {@link TCaseConverter}
+ */
+export declare const KEBAB_CASE: TCaseConverter;
+/**
+ * Converts a string to PascalCase.
+ *
+ * @param value The input string.
+ * @returns The PascalCased string.
+ * @see {@link TCaseConverter}
+ */
+export declare const PASCAL_CASE: TCaseConverter;
+/**
+ * Converts a string to snake_case.
+ *
+ * @param value The input string.
+ * @returns The snake_cased string.
+ * @see {@link TCaseConverter}
+ */
+export declare const SNAKE_CASE: TCaseConverter;
+/**
+ * Converts a string to SCREAMING_SNAKE_CASE.
+ *
+ * @param value The input string.
+ * @returns The SCREAMING_SNAKE_CASED string.
+ * @see {@link TCaseConverter}
+ */
+export declare const SCREAMING_SNAKE_CASE: TCaseConverter;
+//# sourceMappingURL=case-conversion.d.ts.map

package/build/string/case-conversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"case-conversion.d.ts","sourceRoot":"","sources":["../../src/string/case-conversion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAY/C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,cAMxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,cASxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,cAYzB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,cASxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,cAElC,CAAC"}

package/build/string/case-conversion.js

@@ -0,0 +1,94 @@
+/**
+ * Converts a string to camelCase.
+ *
+ * @param value The input string.
+ * @returns The camelCased string.
+ * @see {@link TCaseConverter}
+ */
+export function CamelCase(value) {
+    if (value && typeof value === 'string') {
+        return value
+            .replace(/(?:^\w|[A-Z]|\b\w)/gu, (word, index) => {
+            return index === 0 ? word.toLowerCase() : word.toUpperCase();
+        })
+            .replace(/[-_\s]+(?<char>.)?/gu, (_, c) => {
+            return c ? c.toUpperCase() : '';
+        });
+    }
+    return '';
+}
+/**
+ * Capitalizes the first letter of a string.
+ *
+ * @param value The input string.
+ * @returns The capitalized string.
+ * @see {@link TCaseConverter}
+ */
+export const CAPITALIZE = (value) => {
+    if (value && typeof value === 'string') {
+        return value.charAt(0).toUpperCase() + value.slice(1);
+    }
+    return '';
+};
+/**
+ * Converts a string to kebab-case.
+ *
+ * @param value The input string.
+ * @returns The kebab-cased string.
+ * @see {@link TCaseConverter}
+ */
+export const KEBAB_CASE = (value) => {
+    if (value && typeof value === 'string') {
+        return value
+            .replace(/(?<lower>[a-z])(?<upper>[A-Z])/gu, '$1-$2')
+            .replace(/[\s_]+/gu, '-')
+            .toLowerCase();
+    }
+    return '';
+};
+/**
+ * Converts a string to PascalCase.
+ *
+ * @param value The input string.
+ * @returns The PascalCased string.
+ * @see {@link TCaseConverter}
+ */
+export const PASCAL_CASE = (value) => {
+    if (value && typeof value === 'string') {
+        return value
+            .replace(/(?:^\w|[A-Z]|\b\w)/gu, (word) => {
+            return word.toUpperCase();
+        })
+            .replace(/[-_\s]+(?<char>.)?/gu, (_, c) => {
+            return c ? c.toUpperCase() : '';
+        });
+    }
+    return '';
+};
+/**
+ * Converts a string to snake_case.
+ *
+ * @param value The input string.
+ * @returns The snake_cased string.
+ * @see {@link TCaseConverter}
+ */
+export const SNAKE_CASE = (value) => {
+    if (value && typeof value === 'string') {
+        return value
+            .replace(/(?<lower>[a-z])(?<upper>[A-Z])/gu, '$1_$2')
+            .replace(/[\s-]+/gu, '_')
+            .toLowerCase();
+    }
+    return '';
+};
+/**
+ * Converts a string to SCREAMING_SNAKE_CASE.
+ *
+ * @param value The input string.
+ * @returns The SCREAMING_SNAKE_CASED string.
+ * @see {@link TCaseConverter}
+ */
+export const SCREAMING_SNAKE_CASE = (value) => {
+    return SNAKE_CASE(value).toUpperCase();
+};
+//# sourceMappingURL=case-conversion.js.map

package/build/string/case-conversion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"case-conversion.js","sourceRoot":"","sources":["../../src/string/case-conversion.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACtC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK;aACV,OAAO,CAAC,sBAAsB,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAChD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9D,CAAC,CAAC;aACD,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACzC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,CAAC;AACX,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAmB,CAAC,KAAa,EAAU,EAAE;IACnE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,EAAE,CAAC;AACX,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAmB,CAAC,KAAa,EAAU,EAAE;IACnE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK;aACV,OAAO,CAAC,kCAAkC,EAAE,OAAO,CAAC;aACpD,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;aACxB,WAAW,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,EAAE,CAAC;AACX,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAmB,CAAC,KAAa,EAAU,EAAE;IACpE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK;aACV,OAAO,CAAC,sBAAsB,EAAE,CAAC,IAAI,EAAE,EAAE;YACzC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC,CAAC;aACD,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACzC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,CAAC;AACX,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAmB,CAAC,KAAa,EAAU,EAAE;IACnE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK;aACV,OAAO,CAAC,kCAAkC,EAAE,OAAO,CAAC;aACpD,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;aACxB,WAAW,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,EAAE,CAAC;AACX,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAmB,CAAC,KAAa,EAAU,EAAE;IAC7E,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AACxC,CAAC,CAAC"}

package/build/string/formatting.d.ts

@@ -0,0 +1,108 @@
+import type { TFormatParams, TFormatArgs } from './types';
+/**
+ * Escapes a string for safe use in HTML.
+ *
+ * @param str The input string.
+ * @returns The HTML-escaped string.
+ */
+export declare function EscapeHTML(str: string): string;
+/**
+ * Formats a string by replacing placeholders with values
+ * Supports both named placeholders {name} and positional {0}, {1}
+ *
+ * @param template - The template string with placeholders
+ * @param params - Either an object with named parameters or array of positional parameters
+ * @returns The formatted string
+ *
+ * @example
+ * ```typescript
+ * // Named parameters
+ * FormatString('Hello {name}!', { name: 'World' }); // 'Hello World!'
+ *
+ * // Positional parameters
+ * FormatString('Hello {0}!', ['World']); // 'Hello World!'
+ *
+ * // Mixed types
+ * FormatString('Count: {count}, Active: {active}', {
+ *   count: 42,
+ *   active: true
+ * }); // 'Count: 42, Active: true'
+ * ```
+ */
+export declare function FormatString(template: string, params: TFormatParams | TFormatArgs): string;
+/**
+ * Truncates a string to a specified length, appending an ellipsis if truncated.
+ *
+ * @param str The string to truncate.
+ * @param maxLength The maximum length before truncation.
+ * @param ellipsis The string to append when truncated (default: '...').
+ * @returns The truncated string.
+ */
+export declare function TruncateString(str: string, maxLength: number, ellipsis?: string): string;
+/**
+ * Pads a string to a specified length.
+ *
+ * @param str The input string.
+ * @param length The target length.
+ * @param char The character to pad with (default: ' ').
+ * @param padEnd If true, pads the end; otherwise, pads the start (default: true).
+ * @returns The padded string.
+ */
+export declare function PadString(str: string, length: number, char?: string, padEnd?: boolean): string;
+/**
+ * Removes all HTML tags from a string.
+ *
+ * @param str The input string.
+ * @returns The string with all HTML tags stripped.
+ *
+ * @example
+ * ```typescript
+ * StripHTML('<p>Hello <strong>World</strong></p>'); // 'Hello World'
+ * ```
+ */
+export declare function StripHTML(str: string): string;
+/**
+ * Returns the plural form of a word based on a count.
+ *
+ * @param word The singular word.
+ * @param count The count to test against.
+ * @param plural Optional custom plural form (defaults to `word + 's'`).
+ * @returns The singular word when `count === 1`, otherwise the plural.
+ *
+ * @example
+ * ```typescript
+ * Pluralize('cat', 1);          // 'cat'
+ * Pluralize('cat', 3);          // 'cats'
+ * Pluralize('child', 2, 'children'); // 'children'
+ * ```
+ */
+export declare function Pluralize(word: string, count: number, plural?: string): string;
+/**
+ * Counts the number of words in a string.
+ * Words are separated by one or more whitespace characters.
+ *
+ * @param str The input string.
+ * @returns The number of words.
+ *
+ * @example
+ * ```typescript
+ * WordCount('hello world'); // 2
+ * WordCount('  foo  bar  baz  '); // 3
+ * ```
+ */
+export declare function WordCount(str: string): number;
+/**
+ * Counts the number of non-overlapping occurrences of `substr` in `str`.
+ *
+ * @param str The string to search in.
+ * @param substr The substring to count.
+ * @returns The number of occurrences.
+ *
+ * @example
+ * ```typescript
+ * CountOccurrences('hello world hello', 'hello'); // 2
+ * CountOccurrences('aaa', 'aa'); // 1  (non-overlapping)
+ * ```
+ */
+export declare function CountOccurrences(str: string, substr: string): number;
+//# sourceMappingURL=formatting.d.ts.map

package/build/string/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/string/formatting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAW9C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,GAAG,WAAW,GACjC,MAAM,CAoBR;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,SAAQ,GAAG,MAAM,CAUvF;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,SAAM,EAAE,MAAM,UAAO,GAAG,MAAM,CASxF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CASpE"}

package/build/string/formatting.js

@@ -0,0 +1,171 @@
+/**
+ * Escapes a string for safe use in HTML.
+ *
+ * @param str The input string.
+ * @returns The HTML-escaped string.
+ */
+export function EscapeHTML(str) {
+    if (str && typeof str === 'string') {
+        return str
+            .replace(/&/gu, '&')
+            .replace(/</gu, '&lt;')
+            .replace(/>/gu, '&gt;')
+            .replace(/"/gu, '&quot;')
+            .replace(/'/gu, '&#039;');
+    }
+    return '';
+}
+/**
+ * Formats a string by replacing placeholders with values
+ * Supports both named placeholders {name} and positional {0}, {1}
+ *
+ * @param template - The template string with placeholders
+ * @param params - Either an object with named parameters or array of positional parameters
+ * @returns The formatted string
+ *
+ * @example
+ * ```typescript
+ * // Named parameters
+ * FormatString('Hello {name}!', { name: 'World' }); // 'Hello World!'
+ *
+ * // Positional parameters
+ * FormatString('Hello {0}!', ['World']); // 'Hello World!'
+ *
+ * // Mixed types
+ * FormatString('Count: {count}, Active: {active}', {
+ *   count: 42,
+ *   active: true
+ * }); // 'Count: 42, Active: true'
+ * ```
+ */
+export function FormatString(template, params) {
+    if (template && typeof template === 'string') {
+        if (params && (Array.isArray(params) || typeof params === 'object')) {
+            if (Array.isArray(params)) {
+                return template.replace(/{(\d+)}/g, (match, index) => {
+                    const value = params[parseInt(index, 10)];
+                    return value !== undefined && value !== null ? String(value) : match;
+                });
+            }
+            return template.replace(/{(\w+)}/g, (match, key) => {
+                const value = params[key];
+                return value !== undefined && value !== null ? String(value) : match;
+            });
+        }
+        return template;
+    }
+    return '';
+}
+/**
+ * Truncates a string to a specified length, appending an ellipsis if truncated.
+ *
+ * @param str The string to truncate.
+ * @param maxLength The maximum length before truncation.
+ * @param ellipsis The string to append when truncated (default: '...').
+ * @returns The truncated string.
+ */
+export function TruncateString(str, maxLength, ellipsis = '...') {
+    if (str && typeof str === 'string' && maxLength > 0) {
+        if (str.length <= maxLength) {
+            return str;
+        }
+        return str.slice(0, maxLength) + ellipsis;
+    }
+    return '';
+}
+/**
+ * Pads a string to a specified length.
+ *
+ * @param str The input string.
+ * @param length The target length.
+ * @param char The character to pad with (default: ' ').
+ * @param padEnd If true, pads the end; otherwise, pads the start (default: true).
+ * @returns The padded string.
+ */
+export function PadString(str, length, char = ' ', padEnd = true) {
+    if (str && typeof str === 'string' && length > str.length) {
+        const paddingLength = length - str.length;
+        const padding = char.repeat(paddingLength);
+        return padEnd ? str + padding : padding + str;
+    }
+    return str || '';
+}
+/**
+ * Removes all HTML tags from a string.
+ *
+ * @param str The input string.
+ * @returns The string with all HTML tags stripped.
+ *
+ * @example
+ * ```typescript
+ * StripHTML('<p>Hello <strong>World</strong></p>'); // 'Hello World'
+ * ```
+ */
+export function StripHTML(str) {
+    if (!str || typeof str !== 'string')
+        return '';
+    return str.replace(/<[^>]*>/gu, '');
+}
+/**
+ * Returns the plural form of a word based on a count.
+ *
+ * @param word The singular word.
+ * @param count The count to test against.
+ * @param plural Optional custom plural form (defaults to `word + 's'`).
+ * @returns The singular word when `count === 1`, otherwise the plural.
+ *
+ * @example
+ * ```typescript
+ * Pluralize('cat', 1);          // 'cat'
+ * Pluralize('cat', 3);          // 'cats'
+ * Pluralize('child', 2, 'children'); // 'children'
+ * ```
+ */
+export function Pluralize(word, count, plural) {
+    if (!word || typeof word !== 'string')
+        return '';
+    return count === 1 ? word : (plural ?? `${word}s`);
+}
+/**
+ * Counts the number of words in a string.
+ * Words are separated by one or more whitespace characters.
+ *
+ * @param str The input string.
+ * @returns The number of words.
+ *
+ * @example
+ * ```typescript
+ * WordCount('hello world'); // 2
+ * WordCount('  foo  bar  baz  '); // 3
+ * ```
+ */
+export function WordCount(str) {
+    if (!str || typeof str !== 'string')
+        return 0;
+    return str.trim().split(/\s+/u).filter(Boolean).length;
+}
+/**
+ * Counts the number of non-overlapping occurrences of `substr` in `str`.
+ *
+ * @param str The string to search in.
+ * @param substr The substring to count.
+ * @returns The number of occurrences.
+ *
+ * @example
+ * ```typescript
+ * CountOccurrences('hello world hello', 'hello'); // 2
+ * CountOccurrences('aaa', 'aa'); // 1  (non-overlapping)
+ * ```
+ */
+export function CountOccurrences(str, substr) {
+    if (!str || !substr)
+        return 0;
+    let count = 0;
+    let pos = 0;
+    while ((pos = str.indexOf(substr, pos)) !== -1) {
+        count++;
+        pos += substr.length;
+    }
+    return count;
+}
+//# sourceMappingURL=formatting.js.map

package/build/string/formatting.js.map

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

package/build/string/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * String utility functions and types.
+ *
+ * Provides helpers for case conversion (camelCase, PascalCase, kebab-case),
+ * HTML escaping, template formatting, truncation, padding, slugification,
+ * string reversal, and common validation predicates.
+ *
+ * @module string
+ */
+export * from './case-conversion.js';
+export * from './validation.js';
+export * from './formatting.js';
+export * from './transformation.js';
+export type { TStringValidator, TStringFormatter, TStringTransformer, TCaseConverter, TStringPredicate, TFormatValue, TFormatParams, TFormatArgs } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/build/string/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AAEpC,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/build/string/index.js

@@ -0,0 +1,14 @@
+/**
+ * String utility functions and types.
+ *
+ * Provides helpers for case conversion (camelCase, PascalCase, kebab-case),
+ * HTML escaping, template formatting, truncation, padding, slugification,
+ * string reversal, and common validation predicates.
+ *
+ * @module string
+ */
+export * from './case-conversion.js';
+export * from './validation.js';
+export * from './formatting.js';
+export * from './transformation.js';
+//# sourceMappingURL=index.js.map

package/build/string/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/build/string/string.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=string.test.d.ts.map

package/build/string/string.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.test.d.ts","sourceRoot":"","sources":["../../src/string/string.test.ts"],"names":[],"mappings":""}