@forthtilliath/ts-kit 0.10.0 → 0.12.0

package/dist/function/memoize.js

@@ -0,0 +1,50 @@
+/**
+ * Caches the result of `fn` per argument tuple (JSON-stringified by
+ * default).
+ *
+ * A returned promise that rejects is evicted from the cache, so a failed
+ * async call is retried on the next invocation instead of failing forever.
+ *
+ * @param fn - The function to memoize.
+ * @param getKeyOrOptions - A key function, or `{ getKey, maxSize }`.
+ * @returns A memoized version of `fn`, with a `cache` map exposed.
+ * @example
+ * const square = memoize((n: number) => expensiveSquare(n));
+ * square(4); // computed
+ * square(4); // cached
+ *
+ * const getUser = memoize(fetchUser, { maxSize: 100 });
+ */
+export function memoize(fn, getKeyOrOptions = {}) {
+    const { getKey = (...args) => JSON.stringify(args), maxSize = Infinity, } = typeof getKeyOrOptions === "function"
+        ? { getKey: getKeyOrOptions }
+        : getKeyOrOptions;
+    const cache = new Map();
+    const memoized = ((...args) => {
+        const key = getKey(...args);
+        if (cache.has(key)) {
+            const cached = cache.get(key);
+            // Re-insert to mark it as the most recently used.
+            cache.delete(key);
+            cache.set(key, cached);
+            return cached;
+        }
+        const result = fn(...args);
+        cache.set(key, result);
+        if (cache.size > maxSize) {
+            const oldestKey = cache.keys().next().value;
+            if (oldestKey !== undefined)
+                cache.delete(oldestKey);
+        }
+        if (result instanceof Promise) {
+            result.catch(() => {
+                // Only if it's still this call's promise (not a newer one).
+                if (cache.get(key) === result)
+                    cache.delete(key);
+            });
+        }
+        return result;
+    });
+    memoized.cache = cache;
+    return memoized;
+}

package/dist/ics/escapeIcsText.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Escapes a value for an iCalendar (RFC 5545) TEXT property — `SUMMARY`,
+ * `DESCRIPTION`, `LOCATION`…: backslashes, semicolons and commas get a
+ * backslash, line breaks become a literal `\n`.
+ *
+ * @param text - The raw text.
+ * @returns The text, safe to put after `SUMMARY:` and the like.
+ * @example
+ * escapeIcsText("Matin; puis soir, à 20h"); // => "Matin\\; puis soir\\, à 20h"
+ */
+export declare function escapeIcsText(text: string): string;
+//# sourceMappingURL=escapeIcsText.d.ts.map

package/dist/ics/escapeIcsText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeIcsText.d.ts","sourceRoot":"","sources":["../../src/ics/escapeIcsText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD"}

package/dist/ics/escapeIcsText.js

@@ -0,0 +1,17 @@
+/**
+ * Escapes a value for an iCalendar (RFC 5545) TEXT property — `SUMMARY`,
+ * `DESCRIPTION`, `LOCATION`…: backslashes, semicolons and commas get a
+ * backslash, line breaks become a literal `\n`.
+ *
+ * @param text - The raw text.
+ * @returns The text, safe to put after `SUMMARY:` and the like.
+ * @example
+ * escapeIcsText("Matin; puis soir, à 20h"); // => "Matin\\; puis soir\\, à 20h"
+ */
+export function escapeIcsText(text) {
+    return text
+        .replace(/\\/g, "\\\\")
+        .replace(/;/g, "\\;")
+        .replace(/,/g, "\\,")
+        .replace(/\r?\n/g, "\\n");
+}

package/dist/ics/foldIcsLine.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Folds an iCalendar (RFC 5545) content line longer than 75 **octets**: the
+ * rest goes on continuation lines (CRLF + one space), each 75 octets at most
+ * including that space. Counts UTF-8 bytes, not characters — an accented
+ * line folded at 75 characters would overflow — and never splits a
+ * multi-byte character.
+ *
+ * @param line - One unfolded content line, without its line break.
+ * @param maxOctets - Octets per line. @defaultValue 75
+ * @returns The line, folded with `\r\n ` where needed.
+ * @example
+ * foldIcsLine(`DESCRIPTION:${"é".repeat(40)}`); // => 2 lines
+ */
+export declare function foldIcsLine(line: string, maxOctets?: number): string;
+//# sourceMappingURL=foldIcsLine.d.ts.map

package/dist/ics/foldIcsLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foldIcsLine.d.ts","sourceRoot":"","sources":["../../src/ics/foldIcsLine.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAgBhE"}

package/dist/ics/foldIcsLine.js

@@ -0,0 +1,40 @@
+/** Octets taken by one code point in UTF-8. */
+function utf8Length(codePoint) {
+    if (codePoint < 0x80)
+        return 1;
+    if (codePoint < 0x800)
+        return 2;
+    if (codePoint < 0x10000)
+        return 3;
+    return 4;
+}
+/**
+ * Folds an iCalendar (RFC 5545) content line longer than 75 **octets**: the
+ * rest goes on continuation lines (CRLF + one space), each 75 octets at most
+ * including that space. Counts UTF-8 bytes, not characters — an accented
+ * line folded at 75 characters would overflow — and never splits a
+ * multi-byte character.
+ *
+ * @param line - One unfolded content line, without its line break.
+ * @param maxOctets - Octets per line. @defaultValue 75
+ * @returns The line, folded with `\r\n ` where needed.
+ * @example
+ * foldIcsLine(`DESCRIPTION:${"é".repeat(40)}`); // => 2 lines
+ */
+export function foldIcsLine(line, maxOctets = 75) {
+    const parts = [];
+    let current = "";
+    let size = 0;
+    for (const char of line) {
+        const bytes = utf8Length(char.codePointAt(0) ?? 0);
+        if (size + bytes > maxOctets) {
+            parts.push(current);
+            current = " ";
+            size = 1;
+        }
+        current += char;
+        size += bytes;
+    }
+    parts.push(current);
+    return parts.join("\r\n");
+}

package/dist/ics/icsTimestamp.d.ts

@@ -0,0 +1,10 @@
+/**
+ * An iCalendar UTC `DATE-TIME` (`YYYYMMDDTHHMMSSZ`), as `DTSTAMP` expects.
+ *
+ * @param date - The instant. @defaultValue now
+ * @returns The instant in UTC, as `YYYYMMDDTHHMMSSZ`.
+ * @example
+ * icsTimestamp(new Date("2026-07-14T08:05:09.123Z")); // => "20260714T080509Z"
+ */
+export declare function icsTimestamp(date?: Date): string;
+//# sourceMappingURL=icsTimestamp.d.ts.map

package/dist/ics/icsTimestamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icsTimestamp.d.ts","sourceRoot":"","sources":["../../src/ics/icsTimestamp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAE5D"}

package/dist/ics/icsTimestamp.js

@@ -0,0 +1,11 @@
+/**
+ * An iCalendar UTC `DATE-TIME` (`YYYYMMDDTHHMMSSZ`), as `DTSTAMP` expects.
+ *
+ * @param date - The instant. @defaultValue now
+ * @returns The instant in UTC, as `YYYYMMDDTHHMMSSZ`.
+ * @example
+ * icsTimestamp(new Date("2026-07-14T08:05:09.123Z")); // => "20260714T080509Z"
+ */
+export function icsTimestamp(date = new Date()) {
+    return `${date.toISOString().replace(/[-:]/g, "").slice(0, 15)}Z`;
+}

package/dist/ics/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./escapeIcsText.js";
+export * from "./foldIcsLine.js";
+export * from "./icsTimestamp.js";
+export * from "./toIcsDate.js";
+export * from "./toIcsDateTime.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ics/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/ics/index.js

@@ -0,0 +1,5 @@
+export * from "./escapeIcsText.js";
+export * from "./foldIcsLine.js";
+export * from "./icsTimestamp.js";
+export * from "./toIcsDate.js";
+export * from "./toIcsDateTime.js";

package/dist/ics/toIcsDate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * An iCalendar `DATE` value (`YYYYMMDD`) from a `YYYY-MM-DD` calendar date,
+ * for all-day events (`DTSTART;VALUE=DATE:…`).
+ *
+ * @param isoDate - A calendar date, `YYYY-MM-DD`.
+ * @returns The date as `YYYYMMDD`.
+ * @example
+ * toIcsDate("2026-07-14"); // => "20260714"
+ */
+export declare function toIcsDate(isoDate: string): string;
+//# sourceMappingURL=toIcsDate.d.ts.map

package/dist/ics/toIcsDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toIcsDate.d.ts","sourceRoot":"","sources":["../../src/ics/toIcsDate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/ics/toIcsDate.js

@@ -0,0 +1,12 @@
+/**
+ * An iCalendar `DATE` value (`YYYYMMDD`) from a `YYYY-MM-DD` calendar date,
+ * for all-day events (`DTSTART;VALUE=DATE:…`).
+ *
+ * @param isoDate - A calendar date, `YYYY-MM-DD`.
+ * @returns The date as `YYYYMMDD`.
+ * @example
+ * toIcsDate("2026-07-14"); // => "20260714"
+ */
+export function toIcsDate(isoDate) {
+    return isoDate.replace(/-/g, "");
+}

package/dist/ics/toIcsDateTime.d.ts

@@ -0,0 +1,13 @@
+/**
+ * An iCalendar floating local `DATE-TIME` value (`YYYYMMDDTHHMMSS`, no `Z`)
+ * from a calendar date and a wall-clock time — the calendar app shows it at
+ * that time in its own time zone.
+ *
+ * @param isoDate - A calendar date, `YYYY-MM-DD`.
+ * @param time - A time, `H:MM` or `HH:MM`.
+ * @returns The date-time as `YYYYMMDDTHHMMSS`.
+ * @example
+ * toIcsDateTime("2026-07-14", "6:30"); // => "20260714T063000"
+ */
+export declare function toIcsDateTime(isoDate: string, time: string): string;
+//# sourceMappingURL=toIcsDateTime.d.ts.map

package/dist/ics/toIcsDateTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toIcsDateTime.d.ts","sourceRoot":"","sources":["../../src/ics/toIcsDateTime.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnE"}

package/dist/ics/toIcsDateTime.js

@@ -0,0 +1,16 @@
+import { toIcsDate } from "./toIcsDate.js";
+/**
+ * An iCalendar floating local `DATE-TIME` value (`YYYYMMDDTHHMMSS`, no `Z`)
+ * from a calendar date and a wall-clock time — the calendar app shows it at
+ * that time in its own time zone.
+ *
+ * @param isoDate - A calendar date, `YYYY-MM-DD`.
+ * @param time - A time, `H:MM` or `HH:MM`.
+ * @returns The date-time as `YYYYMMDDTHHMMSS`.
+ * @example
+ * toIcsDateTime("2026-07-14", "6:30"); // => "20260714T063000"
+ */
+export function toIcsDateTime(isoDate, time) {
+    const [hours = "0", minutes = "0"] = time.split(":");
+    return `${toIcsDate(isoDate)}T${hours.padStart(2, "0")}${minutes.padStart(2, "0")}00`;
+}

package/dist/index.d.ts

@@ -4,10 +4,11 @@ export * from "./classes/index.js";
 export * from "./csv/index.js";
 export * from "./date/index.js";
 export * from "./files/index.js";
+export * from "./function/index.js";
+export * from "./ics/index.js";
 export * from "./id/index.js";
 export * from "./image/index.js";
 export * from "./markdown/index.js";
-export * from "./maths/index.js";
 export * from "./number/index.js";
 export * from "./object/index.js";
 export * from "./string/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -9,10 +9,11 @@ export * from "./classes/index.js";
 export * from "./csv/index.js";
 export * from "./date/index.js";
 export * from "./files/index.js";
+export * from "./function/index.js";
+export * from "./ics/index.js";
 export * from "./id/index.js";
 export * from "./image/index.js";
 export * from "./markdown/index.js";
-export * from "./maths/index.js";
 export * from "./number/index.js";
 export * from "./object/index.js";
 export * from "./string/index.js";

package/dist/maths/average.d.ts

@@ -1,8 +1,3 @@
-/**
- * Calculates the average of all numbers in an array.
- *
- * @param {number[]} arr - The array of numbers to average.
- * @return {number} The average of all numbers in the array.
- */
-export declare function avg(arr: number[]): number;
+/** @deprecated Import from `@forthtilliath/ts-kit/number/average` instead. */
+export { avg } from "../number/average.js";
 //# sourceMappingURL=average.d.ts.map

package/dist/maths/average.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"average.d.ts","sourceRoot":"","sources":["../../src/maths/average.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,CAEzC"}
+{"version":3,"file":"average.d.ts","sourceRoot":"","sources":["../../src/maths/average.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/maths/average.js

@@ -1,10 +1,4 @@
-import { sum } from "./sum.js";
-/**
- * Calculates the average of all numbers in an array.
- *
- * @param {number[]} arr - The array of numbers to average.
- * @return {number} The average of all numbers in the array.
- */
-export function avg(arr) {
-    return sum(arr) / arr.length;
-}
+// `maths/` duplicated `number/`: `avg` moved there. Re-exported so the
+// `@forthtilliath/ts-kit/maths/average` deep import keeps working.
+/** @deprecated Import from `@forthtilliath/ts-kit/number/average` instead. */
+export { avg } from "../number/average.js";

package/dist/maths/sum.d.ts

@@ -1,8 +1,3 @@
-/**
- * Calculates the sum of all numbers in an array.
- *
- * @param {number[]} arr - The array of numbers to sum.
- * @return {number} The sum of all numbers in the array.
- */
-export declare function sum(arr: number[]): number;
+/** @deprecated Import from `@forthtilliath/ts-kit/number/sum` instead. */
+export { sum } from "../number/sum.js";
 //# sourceMappingURL=sum.d.ts.map

package/dist/maths/sum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sum.d.ts","sourceRoot":"","sources":["../../src/maths/sum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,CAEzC"}
+{"version":3,"file":"sum.d.ts","sourceRoot":"","sources":["../../src/maths/sum.ts"],"names":[],"mappings":"AAGA,0EAA0E;AAC1E,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/maths/sum.js

@@ -1,9 +1,4 @@
-/**
- * Calculates the sum of all numbers in an array.
- *
- * @param {number[]} arr - The array of numbers to sum.
- * @return {number} The sum of all numbers in the array.
- */
-export function sum(arr) {
-    return arr.reduce((total, n) => total + n, 0);
-}
+// `maths/` duplicated `number/`: `sum` moved there. Re-exported so the
+// `@forthtilliath/ts-kit/maths/sum` deep import keeps working.
+/** @deprecated Import from `@forthtilliath/ts-kit/number/sum` instead. */
+export { sum } from "../number/sum.js";

package/dist/number/average.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Calculates the average (arithmetic mean) of all numbers in an array.
+ *
+ * @param arr - The numbers to average.
+ * @returns The average, or `NaN` for an empty array — there's no meaningful
+ *   average of nothing, and `0` would be indistinguishable from a real one
+ *   (same as lodash's `mean`). Check `arr.length` first if you need a fallback.
+ * @example
+ * avg([1, 2, 3]); // => 2
+ * avg([]); // => NaN
+ */
+export declare function avg(arr: readonly number[]): number;
+//# sourceMappingURL=average.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"average.d.ts","sourceRoot":"","sources":["../../src/number/average.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAElD"}

package/dist/number/average.js

@@ -0,0 +1,15 @@
+import { sum } from "./sum.js";
+/**
+ * Calculates the average (arithmetic mean) of all numbers in an array.
+ *
+ * @param arr - The numbers to average.
+ * @returns The average, or `NaN` for an empty array — there's no meaningful
+ *   average of nothing, and `0` would be indistinguishable from a real one
+ *   (same as lodash's `mean`). Check `arr.length` first if you need a fallback.
+ * @example
+ * avg([1, 2, 3]); // => 2
+ * avg([]); // => NaN
+ */
+export function avg(arr) {
+    return sum(arr) / arr.length;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"formatBytes.d.ts","sourceRoot":"","sources":["../../src/number/formatBytes.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAW/D"}
+{"version":3,"file":"formatBytes.d.ts","sourceRoot":"","sources":["../../src/number/formatBytes.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAkB/D"}

package/dist/number/formatBytes.js

@@ -12,8 +12,12 @@ const UNITS = ["B", "KB", "MB", "GB", "TB", "PB"];
 export function formatBytes(bytes, decimals = 2) {
     if (bytes === 0)
         return "0 B";
-    const exponent = Math.min(Math.floor(Math.log(Math.abs(bytes)) / Math.log(1024)), UNITS.length - 1);
+    // Clamped at 0 so a fraction of a byte stays in "B" (a negative exponent
+    // has no unit).
+    const exponent = Math.max(0, Math.min(Math.floor(Math.log(Math.abs(bytes)) / Math.log(1024)), UNITS.length - 1));
     const value = bytes / 1024 ** exponent;
-    const formatted = value.toFixed(Math.max(decimals, 0)).replace(/\.?0+$/, "");
+    // Round-tripping through Number drops trailing decimal zeros ("1.50" →
+    // "1.5") without touching the integer part ("100" stays "100").
+    const formatted = String(Number(value.toFixed(Math.max(decimals, 0))));
     return `${formatted} ${UNITS[exponent]}`;
 }

package/dist/number/formatCsvNumber.d.ts

@@ -1,14 +1,3 @@
-/**
- * Formats a number as a raw value (no unit suffix) for use in a spreadsheet
- * (sum, average...), with a comma decimal separator as expected by
- * French-locale spreadsheets instead of JS's dot.
- *
- * @param value - The number to format.
- * @param decimals - Number of decimal places. Defaults to `1`.
- * @returns The formatted number, comma as decimal separator.
- * @example
- * formatCsvNumber(1.5); // => "1,5"
- * formatCsvNumber(12.345, 2); // => "12,35"
- */
-export declare function formatCsvNumber(value: number, decimals?: number): string;
+/** @deprecated Import from `@forthtilliath/ts-kit/csv/formatCsvNumber` instead. */
+export { formatCsvNumber } from "../csv/formatCsvNumber.js";
 //# sourceMappingURL=formatCsvNumber.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"formatCsvNumber.d.ts","sourceRoot":"","sources":["../../src/number/formatCsvNumber.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAEnE"}
+{"version":3,"file":"formatCsvNumber.d.ts","sourceRoot":"","sources":["../../src/number/formatCsvNumber.ts"],"names":[],"mappings":"AAGA,mFAAmF;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/number/formatCsvNumber.js

@@ -1,15 +1,4 @@
-/**
- * Formats a number as a raw value (no unit suffix) for use in a spreadsheet
- * (sum, average...), with a comma decimal separator as expected by
- * French-locale spreadsheets instead of JS's dot.
- *
- * @param value - The number to format.
- * @param decimals - Number of decimal places. Defaults to `1`.
- * @returns The formatted number, comma as decimal separator.
- * @example
- * formatCsvNumber(1.5); // => "1,5"
- * formatCsvNumber(12.345, 2); // => "12,35"
- */
-export function formatCsvNumber(value, decimals = 1) {
-    return value.toFixed(decimals).replace(".", ",");
-}
+// CSV helpers now live together in `csv/`. Re-exported so the
+// `@forthtilliath/ts-kit/number/formatCsvNumber` deep import keeps working.
+/** @deprecated Import from `@forthtilliath/ts-kit/csv/formatCsvNumber` instead. */
+export { formatCsvNumber } from "../csv/formatCsvNumber.js";

package/dist/number/index.d.ts

@@ -1,7 +1,9 @@
+export * from "./average.js";
 export * from "./clamp.js";
 export * from "./formatBytes.js";
 export * from "./formatCsvNumber.js";
 export * from "./formatDuration.js";
 export * from "./padNumber.js";
 export * from "./round.js";
+export * from "./sum.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/number/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/number/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/dist/number/index.js

@@ -1,6 +1,8 @@
+export * from "./average.js";
 export * from "./clamp.js";
 export * from "./formatBytes.js";
 export * from "./formatCsvNumber.js";
 export * from "./formatDuration.js";
 export * from "./padNumber.js";
 export * from "./round.js";
+export * from "./sum.js";

package/dist/number/sum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Calculates the sum of all numbers in an array.
+ *
+ * @param arr - The numbers to add up.
+ * @returns Their sum, `0` for an empty array.
+ * @example
+ * sum([1, 2, 3]); // => 6
+ */
+export declare function sum(arr: readonly number[]): number;
+//# sourceMappingURL=sum.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sum.d.ts","sourceRoot":"","sources":["../../src/number/sum.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAElD"}

package/dist/number/sum.js

@@ -0,0 +1,11 @@
+/**
+ * Calculates the sum of all numbers in an array.
+ *
+ * @param arr - The numbers to add up.
+ * @returns Their sum, `0` for an empty array.
+ * @example
+ * sum([1, 2, 3]); // => 6
+ */
+export function sum(arr) {
+    return arr.reduce((total, n) => total + n, 0);
+}

package/dist/object/deepEqual.d.ts

@@ -1,12 +1,18 @@
 /**
  * Recursively compares two values for structural equality.
  *
+ * Both values must share the same prototype (a plain object never equals an
+ * array or a class instance). `Date`s are compared by timestamp, `RegExp`s by
+ * source and flags, `Map`s by keys (identity) then values (deeply), and
+ * `Set`s by membership (identity, like `Set.prototype.has`).
+ *
  * @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
+ * deepEqual(new Date(0), new Date(0)); // => true
  */
 export declare function deepEqual(a: unknown, b: unknown): boolean;
 //# sourceMappingURL=deepEqual.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"deepEqual.d.ts","sourceRoot":"","sources":["../../src/object/deepEqual.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAwDzD"}

package/dist/object/deepEqual.js

@@ -1,31 +1,65 @@
 /**
  * Recursively compares two values for structural equality.
  *
+ * Both values must share the same prototype (a plain object never equals an
+ * array or a class instance). `Date`s are compared by timestamp, `RegExp`s by
+ * source and flags, `Map`s by keys (identity) then values (deeply), and
+ * `Set`s by membership (identity, like `Set.prototype.has`).
+ *
  * @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
+ * deepEqual(new Date(0), new Date(0)); // => true
  */
 export function deepEqual(a, b) {
     if (Object.is(a, b))
         return true;
-    if (typeof a !== typeof b || a === null || b === null)
+    if (typeof a !== "object" ||
+        typeof b !== "object" ||
+        a === null ||
+        b === null ||
+        Object.getPrototypeOf(a) !== Object.getPrototypeOf(b)) {
         return false;
-    if (Array.isArray(a) || Array.isArray(b)) {
-        if (!Array.isArray(a) || !Array.isArray(b))
+    }
+    if (a instanceof Date) {
+        return Object.is(a.getTime(), b.getTime());
+    }
+    if (a instanceof RegExp) {
+        const other = b;
+        return a.source === other.source && a.flags === other.flags;
+    }
+    if (a instanceof Map) {
+        const other = b;
+        if (a.size !== other.size)
             return false;
-        if (a.length !== b.length)
+        for (const [key, value] of a) {
+            if (!other.has(key) || !deepEqual(value, other.get(key)))
+                return false;
+        }
+        return true;
+    }
+    if (a instanceof Set) {
+        const other = b;
+        if (a.size !== other.size)
             return false;
-        return a.every((item, index) => deepEqual(item, b[index]));
+        for (const value of a) {
+            if (!other.has(value))
+                return false;
+        }
+        return true;
     }
-    if (typeof a === "object" && typeof b === "object") {
-        const aKeys = Object.keys(a);
-        const bKeys = Object.keys(b);
-        if (aKeys.length !== bKeys.length)
+    if (Array.isArray(a)) {
+        const other = b;
+        if (a.length !== other.length)
             return false;
-        return aKeys.every((key) => deepEqual(a[key], b[key]));
+        return a.every((item, index) => deepEqual(item, other[index]));
     }
-    return false;
+    const aKeys = Object.keys(a);
+    if (aKeys.length !== Object.keys(b).length)
+        return false;
+    return aKeys.every((key) => Object.prototype.hasOwnProperty.call(b, key) &&
+        deepEqual(a[key], b[key]));
 }