@forthtilliath/ts-kit 0.2.0 → 0.4.0

package/dist/number/index.js

@@ -0,0 +1,5 @@
+export * from "./clamp.js";
+export * from "./formatBytes.js";
+export * from "./formatCsvNumber.js";
+export * from "./formatDuration.js";
+export * from "./round.js";

package/dist/number/round.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Rounds a number to a given number of decimal places.
+ *
+ * @param value - The number to round.
+ * @param decimals - The number of decimal places (default: 0).
+ * @returns The rounded number.
+ * @example
+ * round(1.2345, 2); // => 1.23
+ * round(1.005, 2); // => 1.01
+ */
+export declare function round(value: number, decimals?: number): number;
+//# sourceMappingURL=round.d.ts.map

package/dist/number/round.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round.d.ts","sourceRoot":"","sources":["../../src/number/round.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAGzD"}

package/dist/number/round.js

@@ -0,0 +1,14 @@
+/**
+ * Rounds a number to a given number of decimal places.
+ *
+ * @param value - The number to round.
+ * @param decimals - The number of decimal places (default: 0).
+ * @returns The rounded number.
+ * @example
+ * round(1.2345, 2); // => 1.23
+ * round(1.005, 2); // => 1.01
+ */
+export function round(value, decimals = 0) {
+    const factor = 10 ** decimals;
+    return Math.round((value + Number.EPSILON) * factor) / factor;
+}

package/dist/object/deepClone.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Deep clones a value.
+ *
+ * Uses the native `structuredClone` when available (handles `Date`, `Map`,
+ * `Set`, circular references, etc.), and falls back to a JSON round-trip
+ * otherwise — which loses `undefined` values, functions, and non-JSON types.
+ *
+ * @param value - The value to clone.
+ * @returns A deep copy of `value`.
+ */
+export declare function deepClone<T>(value: T): T;
+//# sourceMappingURL=deepClone.d.ts.map

package/dist/object/deepClone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepClone.d.ts","sourceRoot":"","sources":["../../src/object/deepClone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAKxC"}

package/dist/object/deepClone.js

@@ -0,0 +1,16 @@
+/**
+ * Deep clones a value.
+ *
+ * Uses the native `structuredClone` when available (handles `Date`, `Map`,
+ * `Set`, circular references, etc.), and falls back to a JSON round-trip
+ * otherwise — which loses `undefined` values, functions, and non-JSON types.
+ *
+ * @param value - The value to clone.
+ * @returns A deep copy of `value`.
+ */
+export function deepClone(value) {
+    if (typeof structuredClone === "function") {
+        return structuredClone(value);
+    }
+    return JSON.parse(JSON.stringify(value));
+}

package/dist/object/deepEqual.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Recursively compares two values for structural equality.
+ *
+ * @param a - The first value.
+ * @param b - The second value.
+ * @returns `true` if `a` and `b` are deeply equal.
+ * @example
+ * deepEqual({ a: [1, 2] }, { a: [1, 2] }); // => true
+ * deepEqual({ a: 1 }, { a: 2 }); // => false
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=deepEqual.d.ts.map

package/dist/object/deepEqual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepEqual.d.ts","sourceRoot":"","sources":["../../src/object/deepEqual.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAwBzD"}

package/dist/object/deepEqual.js

@@ -0,0 +1,31 @@
+/**
+ * Recursively compares two values for structural equality.
+ *
+ * @param a - The first value.
+ * @param b - The second value.
+ * @returns `true` if `a` and `b` are deeply equal.
+ * @example
+ * deepEqual({ a: [1, 2] }, { a: [1, 2] }); // => true
+ * deepEqual({ a: 1 }, { a: 2 }); // => false
+ */
+export function deepEqual(a, b) {
+    if (Object.is(a, b))
+        return true;
+    if (typeof a !== typeof b || a === null || b === null)
+        return false;
+    if (Array.isArray(a) || Array.isArray(b)) {
+        if (!Array.isArray(a) || !Array.isArray(b))
+            return false;
+        if (a.length !== b.length)
+            return false;
+        return a.every((item, index) => deepEqual(item, b[index]));
+    }
+    if (typeof a === "object" && typeof b === "object") {
+        const aKeys = Object.keys(a);
+        const bKeys = Object.keys(b);
+        if (aKeys.length !== bKeys.length)
+            return false;
+        return aKeys.every((key) => deepEqual(a[key], b[key]));
+    }
+    return false;
+}

package/dist/object/groupBy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Groups the elements of an array by a key derived from each element.
+ *
+ * @param array - The array to group.
+ * @param getKey - Computes the group key for an element.
+ * @returns A record mapping each key to the array of matching elements.
+ * @example
+ * groupBy([1, 2, 3, 4], (n) => (n % 2 === 0 ? "even" : "odd"));
+ * // => { odd: [1, 3], even: [2, 4] }
+ */
+export declare function groupBy<T, K extends PropertyKey>(array: readonly T[], getKey: (item: T) => K): Record<K, T[]>;
+//# sourceMappingURL=groupBy.d.ts.map

package/dist/object/groupBy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupBy.d.ts","sourceRoot":"","sources":["../../src/object/groupBy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,EAC9C,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GACrB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAOhB"}

package/dist/object/groupBy.js

@@ -0,0 +1,18 @@
+/**
+ * Groups the elements of an array by a key derived from each element.
+ *
+ * @param array - The array to group.
+ * @param getKey - Computes the group key for an element.
+ * @returns A record mapping each key to the array of matching elements.
+ * @example
+ * groupBy([1, 2, 3, 4], (n) => (n % 2 === 0 ? "even" : "odd"));
+ * // => { odd: [1, 3], even: [2, 4] }
+ */
+export function groupBy(array, getKey) {
+    const result = {};
+    for (const item of array) {
+        const key = getKey(item);
+        (result[key] ??= []).push(item);
+    }
+    return result;
+}

package/dist/object/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./deepClone.js";
+export * from "./deepEqual.js";
+export * from "./groupBy.js";
+export * from "./mapValues.js";
+export * from "./omit.js";
+export * from "./pick.js";
+export * from "./uniqueBy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/object/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/object/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,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/object/index.js

@@ -0,0 +1,7 @@
+export * from "./deepClone.js";
+export * from "./deepEqual.js";
+export * from "./groupBy.js";
+export * from "./mapValues.js";
+export * from "./omit.js";
+export * from "./pick.js";
+export * from "./uniqueBy.js";

package/dist/object/mapValues.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Creates a new object with the same keys, mapping each value through `fn`.
+ *
+ * @param obj - The source object.
+ * @param fn - Maps a value (and its key) to a new value.
+ * @returns A new object with transformed values.
+ * @example
+ * mapValues({ a: 1, b: 2 }, (n) => n * 2); // => { a: 2, b: 4 }
+ */
+export declare function mapValues<T extends object, R>(obj: T, fn: (value: T[keyof T], key: keyof T) => R): Record<keyof T, R>;
+//# sourceMappingURL=mapValues.d.ts.map

package/dist/object/mapValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapValues.d.ts","sourceRoot":"","sources":["../../src/object/mapValues.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAC3C,GAAG,EAAE,CAAC,EACN,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GACzC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAMpB"}

package/dist/object/mapValues.js

@@ -0,0 +1,16 @@
+/**
+ * Creates a new object with the same keys, mapping each value through `fn`.
+ *
+ * @param obj - The source object.
+ * @param fn - Maps a value (and its key) to a new value.
+ * @returns A new object with transformed values.
+ * @example
+ * mapValues({ a: 1, b: 2 }, (n) => n * 2); // => { a: 2, b: 4 }
+ */
+export function mapValues(obj, fn) {
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        result[key] = fn(obj[key], key);
+    }
+    return result;
+}

package/dist/object/omit.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Creates a new object without the specified keys.
+ *
+ * @param obj - The source object.
+ * @param keys - The keys to remove.
+ * @returns A new object without `keys`.
+ * @example
+ * omit({ a: 1, b: 2, c: 3 }, ["b"]); // => { a: 1, c: 3 }
+ */
+export declare function omit<T extends object, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T, K>;
+//# sourceMappingURL=omit.d.ts.map

package/dist/object/omit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"omit.d.ts","sourceRoot":"","sources":["../../src/object/omit.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EACtD,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,SAAS,CAAC,EAAE,GACjB,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAMZ"}

package/dist/object/omit.js

@@ -0,0 +1,16 @@
+/**
+ * Creates a new object without the specified keys.
+ *
+ * @param obj - The source object.
+ * @param keys - The keys to remove.
+ * @returns A new object without `keys`.
+ * @example
+ * omit({ a: 1, b: 2, c: 3 }, ["b"]); // => { a: 1, c: 3 }
+ */
+export function omit(obj, keys) {
+    const result = { ...obj };
+    for (const key of keys) {
+        Reflect.deleteProperty(result, key);
+    }
+    return result;
+}

package/dist/object/pick.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Creates a new object composed of only the specified keys.
+ *
+ * @param obj - The source object.
+ * @param keys - The keys to keep.
+ * @returns A new object containing only `keys`.
+ * @example
+ * pick({ a: 1, b: 2, c: 3 }, ["a", "c"]); // => { a: 1, c: 3 }
+ */
+export declare function pick<T extends object, K extends keyof T>(obj: T, keys: readonly K[]): Pick<T, K>;
+//# sourceMappingURL=pick.d.ts.map

package/dist/object/pick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.d.ts","sourceRoot":"","sources":["../../src/object/pick.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EACtD,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,SAAS,CAAC,EAAE,GACjB,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAQZ"}

package/dist/object/pick.js

@@ -0,0 +1,18 @@
+/**
+ * Creates a new object composed of only the specified keys.
+ *
+ * @param obj - The source object.
+ * @param keys - The keys to keep.
+ * @returns A new object containing only `keys`.
+ * @example
+ * pick({ a: 1, b: 2, c: 3 }, ["a", "c"]); // => { a: 1, c: 3 }
+ */
+export function pick(obj, keys) {
+    const result = {};
+    for (const key of keys) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+            result[key] = obj[key];
+        }
+    }
+    return result;
+}

package/dist/object/uniqueBy.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Removes duplicate elements from an array, keeping the first occurrence for
+ * each computed key.
+ *
+ * @param array - The array to deduplicate.
+ * @param getKey - Computes the uniqueness key for an element.
+ * @returns A new array with only the first element for each key.
+ * @example
+ * uniqueBy([{ id: 1 }, { id: 2 }, { id: 1 }], (item) => item.id);
+ * // => [{ id: 1 }, { id: 2 }]
+ */
+export declare function uniqueBy<T>(array: readonly T[], getKey: (item: T) => unknown): T[];
+//# sourceMappingURL=uniqueBy.d.ts.map

package/dist/object/uniqueBy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniqueBy.d.ts","sourceRoot":"","sources":["../../src/object/uniqueBy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAC3B,CAAC,EAAE,CAWL"}

package/dist/object/uniqueBy.js

@@ -0,0 +1,23 @@
+/**
+ * Removes duplicate elements from an array, keeping the first occurrence for
+ * each computed key.
+ *
+ * @param array - The array to deduplicate.
+ * @param getKey - Computes the uniqueness key for an element.
+ * @returns A new array with only the first element for each key.
+ * @example
+ * uniqueBy([{ id: 1 }, { id: 2 }, { id: 1 }], (item) => item.id);
+ * // => [{ id: 1 }, { id: 2 }]
+ */
+export function uniqueBy(array, getKey) {
+    const seen = new Set();
+    const result = [];
+    for (const item of array) {
+        const key = getKey(item);
+        if (!seen.has(key)) {
+            seen.add(key);
+            result.push(item);
+        }
+    }
+    return result;
+}

package/dist/string/capitalize.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Capitalizes the first character of a string and lower-cases the rest.
+ *
+ * @param str - The string to capitalize.
+ * @returns The capitalized string.
+ * @example
+ * capitalize("hello world"); // => "Hello world"
+ * capitalize("HELLO"); // => "Hello"
+ */
+export declare function capitalize(str: string): string;
+//# sourceMappingURL=capitalize.d.ts.map

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

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

package/dist/string/capitalize.js

@@ -0,0 +1,14 @@
+/**
+ * Capitalizes the first character of a string and lower-cases the rest.
+ *
+ * @param str - The string to capitalize.
+ * @returns The capitalized string.
+ * @example
+ * capitalize("hello world"); // => "Hello world"
+ * capitalize("HELLO"); // => "Hello"
+ */
+export function capitalize(str) {
+    if (str.length === 0)
+        return str;
+    return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+}

package/dist/string/escapeCsvField.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Escapes a CSV field per RFC 4180: wraps it in double quotes and doubles any
+ * internal double quote if the value contains a double quote, a semicolon
+ * (the delimiter), or a newline — returned as-is otherwise.
+ *
+ * @param value - The raw field value.
+ * @returns The value, quoted and escaped only if needed.
+ * @example
+ * escapeCsvField("Apple"); // => "Apple"
+ * escapeCsvField("a;b"); // => '"a;b"'
+ * escapeCsvField('He said "hi"'); // => '"He said ""hi"""'
+ */
+export declare function escapeCsvField(value: string): string;
+//# sourceMappingURL=escapeCsvField.d.ts.map

package/dist/string/escapeCsvField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeCsvField.d.ts","sourceRoot":"","sources":["../../src/string/escapeCsvField.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD"}

package/dist/string/escapeCsvField.js

@@ -0,0 +1,17 @@
+/**
+ * Escapes a CSV field per RFC 4180: wraps it in double quotes and doubles any
+ * internal double quote if the value contains a double quote, a semicolon
+ * (the delimiter), or a newline — returned as-is otherwise.
+ *
+ * @param value - The raw field value.
+ * @returns The value, quoted and escaped only if needed.
+ * @example
+ * escapeCsvField("Apple"); // => "Apple"
+ * escapeCsvField("a;b"); // => '"a;b"'
+ * escapeCsvField('He said "hi"'); // => '"He said ""hi"""'
+ */
+export function escapeCsvField(value) {
+    if (!/[";\n]/.test(value))
+        return value;
+    return `"${value.replace(/"/g, '""')}"`;
+}

package/dist/string/escapeHtml.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Escapes the HTML entities that matter when inserting arbitrary text into
+ * an HTML template (`&`, `<`, `>`, `"`), without pulling in a templating
+ * dependency.
+ *
+ * @param text - The text to escape.
+ * @returns `text` with `&`, `<`, `>` and `"` replaced by their HTML entities.
+ * @example
+ * escapeHtml("Tom & Jerry <script>"); // => "Tom &amp; Jerry &lt;script&gt;"
+ */
+export declare function escapeHtml(text: string): string;
+//# sourceMappingURL=escapeHtml.d.ts.map

package/dist/string/escapeHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeHtml.d.ts","sourceRoot":"","sources":["../../src/string/escapeHtml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C"}

package/dist/string/escapeHtml.js

@@ -0,0 +1,17 @@
+/**
+ * Escapes the HTML entities that matter when inserting arbitrary text into
+ * an HTML template (`&`, `<`, `>`, `"`), without pulling in a templating
+ * dependency.
+ *
+ * @param text - The text to escape.
+ * @returns `text` with `&`, `<`, `>` and `"` replaced by their HTML entities.
+ * @example
+ * escapeHtml("Tom & Jerry <script>"); // => "Tom &amp; Jerry &lt;script&gt;"
+ */
+export function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}

package/dist/string/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./capitalize.js";
+export * from "./escapeCsvField.js";
+export * from "./escapeHtml.js";
+export * from "./normalizeForSearch.js";
+export * from "./pluralize.js";
+export * from "./slugify.js";
+export * from "./truncate.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/string/index.js

@@ -0,0 +1,7 @@
+export * from "./capitalize.js";
+export * from "./escapeCsvField.js";
+export * from "./escapeHtml.js";
+export * from "./normalizeForSearch.js";
+export * from "./pluralize.js";
+export * from "./slugify.js";
+export * from "./truncate.js";

package/dist/string/normalizeForSearch.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Normalizes text for accent/case-insensitive search matching: expands
+ * œ/æ ligatures, strips accents, lower-cases, and trims.
+ *
+ * @param text - The text to normalize.
+ * @returns The normalized text.
+ * @example
+ * normalizeForSearch("Pâtes À La Crème"); // => "pates a la creme"
+ * normalizeForSearch("Œuf"); // => "oeuf"
+ */
+export declare function normalizeForSearch(text: string): string;
+//# sourceMappingURL=normalizeForSearch.d.ts.map

package/dist/string/normalizeForSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeForSearch.d.ts","sourceRoot":"","sources":["../../src/string/normalizeForSearch.ts"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMvD"}

package/dist/string/normalizeForSearch.js

@@ -0,0 +1,25 @@
+// The œ/æ ligatures do NOT decompose via normalize("NFD") (unlike accented
+// letters): they're standalone Unicode letters, not a base + combining mark.
+// Without this explicit replacement, searching "Œuf" (the real ligature)
+// never matches "Oeuf" in data spelled without the ligature (as most text
+// databases are).
+function expandLigatures(text) {
+    return text.replace(/[œŒ]/g, "oe").replace(/[æÆ]/g, "ae");
+}
+/**
+ * Normalizes text for accent/case-insensitive search matching: expands
+ * œ/æ ligatures, strips accents, lower-cases, and trims.
+ *
+ * @param text - The text to normalize.
+ * @returns The normalized text.
+ * @example
+ * normalizeForSearch("Pâtes À La Crème"); // => "pates a la creme"
+ * normalizeForSearch("Œuf"); // => "oeuf"
+ */
+export function normalizeForSearch(text) {
+    return expandLigatures(text)
+        .normalize("NFD")
+        .replace(/[̀-ͯ]/g, "")
+        .toLowerCase()
+        .trim();
+}

package/dist/string/pluralize.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Pluralizes a word based on a count, with a naive English default (`s`
+ * suffix, `y` → `ies`, `es` after `s`/`x`/`z`/`sh`/`ch`) or an explicit
+ * plural form for irregular words.
+ *
+ * @param count - The count driving singular vs. plural.
+ * @param singular - The singular form.
+ * @param plural - An explicit plural form (overrides the naive default).
+ * @returns `singular` when `count` is 1 or -1, otherwise the plural form.
+ * @example
+ * pluralize(1, "item"); // => "item"
+ * pluralize(3, "item"); // => "items"
+ * pluralize(3, "city"); // => "cities"
+ * pluralize(2, "child", "children"); // => "children"
+ */
+export declare function pluralize(count: number, singular: string, plural?: string): string;
+//# sourceMappingURL=pluralize.d.ts.map

package/dist/string/pluralize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluralize.d.ts","sourceRoot":"","sources":["../../src/string/pluralize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAMR"}

package/dist/string/pluralize.js

@@ -0,0 +1,26 @@
+/**
+ * Pluralizes a word based on a count, with a naive English default (`s`
+ * suffix, `y` → `ies`, `es` after `s`/`x`/`z`/`sh`/`ch`) or an explicit
+ * plural form for irregular words.
+ *
+ * @param count - The count driving singular vs. plural.
+ * @param singular - The singular form.
+ * @param plural - An explicit plural form (overrides the naive default).
+ * @returns `singular` when `count` is 1 or -1, otherwise the plural form.
+ * @example
+ * pluralize(1, "item"); // => "item"
+ * pluralize(3, "item"); // => "items"
+ * pluralize(3, "city"); // => "cities"
+ * pluralize(2, "child", "children"); // => "children"
+ */
+export function pluralize(count, singular, plural) {
+    if (Math.abs(count) === 1)
+        return singular;
+    if (plural !== undefined)
+        return plural;
+    if (/[sxz]$|[cs]h$/i.test(singular))
+        return `${singular}es`;
+    if (/[^aeiou]y$/i.test(singular))
+        return `${singular.slice(0, -1)}ies`;
+    return `${singular}s`;
+}

package/dist/string/slugify.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Converts a string into a URL-friendly slug: lower-cased, accents removed,
+ * non-alphanumeric runs collapsed into single hyphens.
+ *
+ * @param str - The string to slugify.
+ * @returns The slugified string.
+ * @example
+ * slugify("Héllo, World!"); // => "hello-world"
+ * slugify("  Multiple   spaces  "); // => "multiple-spaces"
+ */
+export declare function slugify(str: string): string;
+//# sourceMappingURL=slugify.d.ts.map

package/dist/string/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../src/string/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO3C"}

package/dist/string/slugify.js

@@ -0,0 +1,18 @@
+/**
+ * Converts a string into a URL-friendly slug: lower-cased, accents removed,
+ * non-alphanumeric runs collapsed into single hyphens.
+ *
+ * @param str - The string to slugify.
+ * @returns The slugified string.
+ * @example
+ * slugify("Héllo, World!"); // => "hello-world"
+ * slugify("  Multiple   spaces  "); // => "multiple-spaces"
+ */
+export function slugify(str) {
+    return str
+        .normalize("NFKD")
+        .replace(/[̀-ͯ]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}

package/dist/string/truncate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Truncates a string to a maximum length, appending a suffix when it was cut.
+ *
+ * @param str - The string to truncate.
+ * @param maxLength - The maximum length of the result, suffix included.
+ * @param suffix - Appended when the string is truncated (defaults to `"…"`).
+ * @returns `str` unchanged if it already fits, otherwise the truncated string.
+ * @example
+ * truncate("Hello world", 8); // => "Hello w…"
+ * truncate("Hi", 8); // => "Hi"
+ */
+export declare function truncate(str: string, maxLength: number, suffix?: string): string;
+//# sourceMappingURL=truncate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../src/string/truncate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CAI7E"}

package/dist/string/truncate.js

@@ -0,0 +1,17 @@
+/**
+ * Truncates a string to a maximum length, appending a suffix when it was cut.
+ *
+ * @param str - The string to truncate.
+ * @param maxLength - The maximum length of the result, suffix included.
+ * @param suffix - Appended when the string is truncated (defaults to `"…"`).
+ * @returns `str` unchanged if it already fits, otherwise the truncated string.
+ * @example
+ * truncate("Hello world", 8); // => "Hello w…"
+ * truncate("Hi", 8); // => "Hi"
+ */
+export function truncate(str, maxLength, suffix = "…") {
+    if (str.length <= maxLength)
+        return str;
+    const sliceLength = Math.max(0, maxLength - suffix.length);
+    return str.slice(0, sliceLength) + suffix;
+}