@forthtilliath/ts-kit 0.10.0 → 0.12.0

package/dist/csv/escapeCsvField.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Escapes a single CSV field per RFC 4180, quoting it only when needed: if it
+ * contains a double quote, the delimiter or a line break, it's wrapped in
+ * double quotes with any internal double quote doubled; otherwise it's
+ * returned as-is.
+ *
+ * Builds rows cell by cell. To serialize whole rows at once, see `toCsv`
+ * (which always quotes, and defaults to `,`).
+ *
+ * @param value - The raw field value.
+ * @param delimiter - The cell separator the field will be joined with.
+ *   Defaults to `";"`, what French-locale Excel expects.
+ * @returns The value, quoted and escaped only if needed.
+ * @example
+ * escapeCsvField("Apple"); // => "Apple"
+ * escapeCsvField("a;b"); // => '"a;b"'
+ * escapeCsvField("a,b", ","); // => '"a,b"'
+ * escapeCsvField('He said "hi"'); // => '"He said ""hi"""'
+ */
+export declare function escapeCsvField(value: string, delimiter?: string): string;
+//# sourceMappingURL=escapeCsvField.d.ts.map

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

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

package/dist/csv/escapeCsvField.js

@@ -0,0 +1,28 @@
+/**
+ * Escapes a single CSV field per RFC 4180, quoting it only when needed: if it
+ * contains a double quote, the delimiter or a line break, it's wrapped in
+ * double quotes with any internal double quote doubled; otherwise it's
+ * returned as-is.
+ *
+ * Builds rows cell by cell. To serialize whole rows at once, see `toCsv`
+ * (which always quotes, and defaults to `,`).
+ *
+ * @param value - The raw field value.
+ * @param delimiter - The cell separator the field will be joined with.
+ *   Defaults to `";"`, what French-locale Excel expects.
+ * @returns The value, quoted and escaped only if needed.
+ * @example
+ * escapeCsvField("Apple"); // => "Apple"
+ * escapeCsvField("a;b"); // => '"a;b"'
+ * escapeCsvField("a,b", ","); // => '"a,b"'
+ * escapeCsvField('He said "hi"'); // => '"He said ""hi"""'
+ */
+export function escapeCsvField(value, delimiter = ";") {
+    const needsQuoting = value.includes('"') ||
+        value.includes(delimiter) ||
+        value.includes("\n") ||
+        value.includes("\r");
+    if (!needsQuoting)
+        return value;
+    return `"${value.replace(/"/g, '""')}"`;
+}

package/dist/csv/formatCsvNumber.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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;
+//# sourceMappingURL=formatCsvNumber.d.ts.map

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

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

package/dist/csv/formatCsvNumber.js

@@ -0,0 +1,15 @@
+/**
+ * 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(".", ",");
+}

package/dist/csv/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./downloadCsv.js";
+export * from "./escapeCsvField.js";
+export * from "./formatCsvNumber.js";
 export * from "./parseCsvLine.js";
 export * from "./toCsv.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/csv/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/csv/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/csv/index.js

@@ -1,3 +1,5 @@
 export * from "./downloadCsv.js";
+export * from "./escapeCsvField.js";
+export * from "./formatCsvNumber.js";
 export * from "./parseCsvLine.js";
 export * from "./toCsv.js";

package/dist/date/dateInTimeZone.d.ts

@@ -0,0 +1,22 @@
+export interface CalendarDate {
+    year: number;
+    /** 1–12. */
+    month: number;
+    day: number;
+    /** `YYYY-MM-DD`. */
+    iso: string;
+}
+/**
+ * Returns the calendar date of an instant in a given time zone, whatever the
+ * machine's own time zone (e.g. a server running in UTC).
+ *
+ * @param date - The instant (a `Date`, a timestamp in ms or a parsable string).
+ * @param timeZone - An IANA time zone, e.g. `"Europe/Paris"`.
+ * @returns `{ year, month, day, iso }`, `month` from 1 to 12.
+ * @throws {RangeError} If the time zone or the date is invalid.
+ * @example
+ * dateInTimeZone("2026-03-14T23:30:00Z", "Europe/Paris");
+ * // => { year: 2026, month: 3, day: 15, iso: "2026-03-15" }
+ */
+export declare function dateInTimeZone(date: Date | number | string, timeZone: string): CalendarDate;
+//# sourceMappingURL=dateInTimeZone.d.ts.map

package/dist/date/dateInTimeZone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateInTimeZone.d.ts","sourceRoot":"","sources":["../../src/date/dateInTimeZone.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAkBD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,QAAQ,EAAE,MAAM,GACf,YAAY,CASd"}

package/dist/date/dateInTimeZone.js

@@ -0,0 +1,35 @@
+const formatters = new Map();
+function formatter(timeZone) {
+    let result = formatters.get(timeZone);
+    if (!result) {
+        result = new Intl.DateTimeFormat("en-US", {
+            timeZone,
+            year: "numeric",
+            month: "numeric",
+            day: "numeric",
+        });
+        formatters.set(timeZone, result);
+    }
+    return result;
+}
+/**
+ * Returns the calendar date of an instant in a given time zone, whatever the
+ * machine's own time zone (e.g. a server running in UTC).
+ *
+ * @param date - The instant (a `Date`, a timestamp in ms or a parsable string).
+ * @param timeZone - An IANA time zone, e.g. `"Europe/Paris"`.
+ * @returns `{ year, month, day, iso }`, `month` from 1 to 12.
+ * @throws {RangeError} If the time zone or the date is invalid.
+ * @example
+ * dateInTimeZone("2026-03-14T23:30:00Z", "Europe/Paris");
+ * // => { year: 2026, month: 3, day: 15, iso: "2026-03-15" }
+ */
+export function dateInTimeZone(date, timeZone) {
+    const parts = formatter(timeZone).formatToParts(new Date(date));
+    const get = (type) => Number(parts.find((p) => p.type === type)?.value);
+    const year = get("year");
+    const month = get("month");
+    const day = get("day");
+    const iso = `${String(year).padStart(4, "0")}-${String(month).padStart(2, "0")}-${String(day).padStart(2, "0")}`;
+    return { year, month, day, iso };
+}

package/dist/date/daysUntil.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Counts the calendar days between today and a date, both taken in a given
+ * time zone: the time of day doesn't matter, only the date on the calendar.
+ *
+ * @param date - The target instant (a `Date`, a timestamp in ms or a parsable string).
+ * @param timeZone - An IANA time zone, e.g. `"Europe/Paris"`.
+ * @param now - The reference instant (defaults to now).
+ * @returns `0` today, `1` tomorrow, `-1` yesterday…
+ * @throws {RangeError} If the time zone or the date is invalid.
+ * @example
+ * // It's 2026-03-14 23:00 in Paris
+ * daysUntil("2026-03-15T08:00:00+01:00", "Europe/Paris"); // => 1
+ */
+export declare function daysUntil(date: Date | number | string, timeZone: string, now?: Date): number;
+//# sourceMappingURL=daysUntil.d.ts.map

package/dist/date/daysUntil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daysUntil.d.ts","sourceRoot":"","sources":["../../src/date/daysUntil.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,IAAiB,GACrB,MAAM,CAER"}

package/dist/date/daysUntil.js

@@ -0,0 +1,22 @@
+import { dateInTimeZone } from "./dateInTimeZone.js";
+const DAY_MS = 24 * 60 * 60 * 1000;
+function dayNumber(date, timeZone) {
+    const { year, month, day } = dateInTimeZone(date, timeZone);
+    return Date.UTC(year, month - 1, day) / DAY_MS;
+}
+/**
+ * Counts the calendar days between today and a date, both taken in a given
+ * time zone: the time of day doesn't matter, only the date on the calendar.
+ *
+ * @param date - The target instant (a `Date`, a timestamp in ms or a parsable string).
+ * @param timeZone - An IANA time zone, e.g. `"Europe/Paris"`.
+ * @param now - The reference instant (defaults to now).
+ * @returns `0` today, `1` tomorrow, `-1` yesterday…
+ * @throws {RangeError} If the time zone or the date is invalid.
+ * @example
+ * // It's 2026-03-14 23:00 in Paris
+ * daysUntil("2026-03-15T08:00:00+01:00", "Europe/Paris"); // => 1
+ */
+export function daysUntil(date, timeZone, now = new Date()) {
+    return dayNumber(date, timeZone) - dayNumber(now, timeZone);
+}

package/dist/date/formatRecentDate.d.ts

@@ -0,0 +1,22 @@
+/** Languages {@link formatRecentDate} has wording for. */
+export type RecentDateLocale = "fr" | "en";
+export interface FormatRecentDateOptions {
+    /** Reference "now" (defaults to the current time). */
+    now?: Date;
+    /** Wording and `Intl` formats. @defaultValue "fr" */
+    locale?: RecentDateLocale;
+}
+/**
+ * Describes a past moment the way a "last saved…" line reads best: with the
+ * time when it's today or yesterday, as a plain day otherwise. A date in the
+ * future (clock change between devices) reads as today.
+ *
+ * @param date - The moment to describe.
+ * @param options - See {@link FormatRecentDateOptions}.
+ * @returns E.g. `"aujourd'hui à 21:42"`, `"hier à 08:05"`, `"le 11 octobre 2026"`.
+ * @example
+ * formatRecentDate(lastBackupAt); // => "hier à 21:42"
+ * formatRecentDate(lastBackupAt, { locale: "en" }); // => "yesterday at 9:42 PM"
+ */
+export declare function formatRecentDate(date: Date, { now, locale }?: FormatRecentDateOptions): string;
+//# sourceMappingURL=formatRecentDate.d.ts.map

package/dist/date/formatRecentDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatRecentDate.d.ts","sourceRoot":"","sources":["../../src/date/formatRecentDate.ts"],"names":[],"mappings":"AAEA,0DAA0D;AAC1D,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,qDAAqD;IACrD,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AA2BD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,EAAE,GAAgB,EAAE,MAAa,EAAE,GAAE,uBAA4B,GAChE,MAAM,CAmBR"}

package/dist/date/formatRecentDate.js

@@ -0,0 +1,46 @@
+import { startOfDay } from "./startOfDay.js";
+const WORDING = {
+    fr: {
+        tag: "fr-FR",
+        today: (time) => `aujourd'hui à ${time}`,
+        yesterday: (time) => `hier à ${time}`,
+        older: (day) => `le ${day}`,
+    },
+    en: {
+        tag: "en-US",
+        today: (time) => `today at ${time}`,
+        yesterday: (time) => `yesterday at ${time}`,
+        older: (day) => `on ${day}`,
+    },
+};
+const DAY_MS = 24 * 60 * 60 * 1000;
+/**
+ * Describes a past moment the way a "last saved…" line reads best: with the
+ * time when it's today or yesterday, as a plain day otherwise. A date in the
+ * future (clock change between devices) reads as today.
+ *
+ * @param date - The moment to describe.
+ * @param options - See {@link FormatRecentDateOptions}.
+ * @returns E.g. `"aujourd'hui à 21:42"`, `"hier à 08:05"`, `"le 11 octobre 2026"`.
+ * @example
+ * formatRecentDate(lastBackupAt); // => "hier à 21:42"
+ * formatRecentDate(lastBackupAt, { locale: "en" }); // => "yesterday at 9:42 PM"
+ */
+export function formatRecentDate(date, { now = new Date(), locale = "fr" } = {}) {
+    const wording = WORDING[locale];
+    // Rounded: a day that has a DST change lasts 23 or 25 hours.
+    const dayDiff = Math.round((startOfDay(now).getTime() - startOfDay(date).getTime()) / DAY_MS);
+    if (dayDiff <= 1) {
+        const time = new Intl.DateTimeFormat(wording.tag, {
+            hour: "2-digit",
+            minute: "2-digit",
+        }).format(date);
+        return dayDiff === 1 ? wording.yesterday(time) : wording.today(time);
+    }
+    const day = new Intl.DateTimeFormat(wording.tag, {
+        day: "numeric",
+        month: "long",
+        year: "numeric",
+    }).format(date);
+    return wording.older(day);
+}

package/dist/date/index.d.ts

@@ -1,5 +1,12 @@
+export * from "./dateInTimeZone.js";
+export * from "./daysUntil.js";
+export * from "./formatRecentDate.js";
 export * from "./formatRelativeTime.js";
 export * from "./getPeriodStartMs.js";
 export * from "./isSameDay.js";
+export * from "./mondayFirstWeekday.js";
+export * from "./parseIsoDate.js";
+export * from "./parseSqliteDate.js";
 export * from "./startOfDay.js";
+export * from "./todayInTimeZone.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/dist/date/index.js

@@ -1,4 +1,11 @@
+export * from "./dateInTimeZone.js";
+export * from "./daysUntil.js";
+export * from "./formatRecentDate.js";
 export * from "./formatRelativeTime.js";
 export * from "./getPeriodStartMs.js";
 export * from "./isSameDay.js";
+export * from "./mondayFirstWeekday.js";
+export * from "./parseIsoDate.js";
+export * from "./parseSqliteDate.js";
 export * from "./startOfDay.js";
+export * from "./todayInTimeZone.js";

package/dist/date/mondayFirstWeekday.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Day of the week with Monday as the first day: `0` for Monday … `6` for
+ * Sunday (instead of JavaScript's Sunday = `0`). Handy to offset the first
+ * day of a month in a Monday-first calendar grid.
+ *
+ * @param date - A `Date`, or a `YYYY-MM-DD` calendar date read as local midnight.
+ * @returns The weekday index, Monday = `0`.
+ * @example
+ * mondayFirstWeekday("2026-10-01"); // => 3 (a Thursday)
+ */
+export declare function mondayFirstWeekday(date: Date | string): number;
+//# sourceMappingURL=mondayFirstWeekday.d.ts.map

package/dist/date/mondayFirstWeekday.d.ts.map

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

package/dist/date/mondayFirstWeekday.js

@@ -0,0 +1,15 @@
+import { parseIsoDate } from "./parseIsoDate.js";
+/**
+ * Day of the week with Monday as the first day: `0` for Monday … `6` for
+ * Sunday (instead of JavaScript's Sunday = `0`). Handy to offset the first
+ * day of a month in a Monday-first calendar grid.
+ *
+ * @param date - A `Date`, or a `YYYY-MM-DD` calendar date read as local midnight.
+ * @returns The weekday index, Monday = `0`.
+ * @example
+ * mondayFirstWeekday("2026-10-01"); // => 3 (a Thursday)
+ */
+export function mondayFirstWeekday(date) {
+    const day = (typeof date === "string" ? parseIsoDate(date) : date).getDay();
+    return (day + 6) % 7;
+}

package/dist/date/parseIsoDate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Parses a `YYYY-MM-DD` calendar date as **local** midnight — unlike
+ * `new Date("2026-03-14")`, which the spec reads as UTC midnight and which
+ * therefore lands on the previous day west of Greenwich.
+ *
+ * @param iso - A calendar date, `YYYY-MM-DD`.
+ * @returns A `Date` at local midnight on that day.
+ * @example
+ * parseIsoDate("2026-03-14").getDate(); // => 14, whatever the time zone
+ */
+export declare function parseIsoDate(iso: string): Date;
+//# sourceMappingURL=parseIsoDate.d.ts.map

package/dist/date/parseIsoDate.d.ts.map

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

package/dist/date/parseIsoDate.js

@@ -0,0 +1,13 @@
+/**
+ * Parses a `YYYY-MM-DD` calendar date as **local** midnight — unlike
+ * `new Date("2026-03-14")`, which the spec reads as UTC midnight and which
+ * therefore lands on the previous day west of Greenwich.
+ *
+ * @param iso - A calendar date, `YYYY-MM-DD`.
+ * @returns A `Date` at local midnight on that day.
+ * @example
+ * parseIsoDate("2026-03-14").getDate(); // => 14, whatever the time zone
+ */
+export function parseIsoDate(iso) {
+    return new Date(`${iso}T00:00:00`);
+}

package/dist/date/parseSqliteDate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Parses a date read from SQLite. A `current_timestamp` value
+ * (`"2026-10-09 19:46:00"`, UTC without a zone marker) is read as **UTC** —
+ * `new Date()` would take it for local time and shift it by the time zone
+ * offset. Full ISO strings (with `Z` or an offset) are read as they are.
+ *
+ * @param value - A SQLite datetime or a full ISO string.
+ * @returns The corresponding `Date`.
+ * @example
+ * parseSqliteDate("2026-10-09 19:46:00").toISOString(); // => "2026-10-09T19:46:00.000Z"
+ */
+export declare function parseSqliteDate(value: string): Date;
+//# sourceMappingURL=parseSqliteDate.d.ts.map

package/dist/date/parseSqliteDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSqliteDate.d.ts","sourceRoot":"","sources":["../../src/date/parseSqliteDate.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAInD"}

package/dist/date/parseSqliteDate.js

@@ -0,0 +1,17 @@
+// SQLite's `current_timestamp` stores UTC as "YYYY-MM-DD HH:MM:SS", with no
+// zone marker: `new Date()` would read it as local time.
+const SQLITE_DATETIME = /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}(\.\d+)?$/;
+/**
+ * Parses a date read from SQLite. A `current_timestamp` value
+ * (`"2026-10-09 19:46:00"`, UTC without a zone marker) is read as **UTC** —
+ * `new Date()` would take it for local time and shift it by the time zone
+ * offset. Full ISO strings (with `Z` or an offset) are read as they are.
+ *
+ * @param value - A SQLite datetime or a full ISO string.
+ * @returns The corresponding `Date`.
+ * @example
+ * parseSqliteDate("2026-10-09 19:46:00").toISOString(); // => "2026-10-09T19:46:00.000Z"
+ */
+export function parseSqliteDate(value) {
+    return new Date(SQLITE_DATETIME.test(value) ? `${value.replace(" ", "T")}Z` : value);
+}

package/dist/date/todayInTimeZone.d.ts

@@ -0,0 +1,14 @@
+import type { CalendarDate } from "./dateInTimeZone.js";
+/**
+ * Returns today's calendar date in a given time zone — on a server running in
+ * UTC, `new Date()` is still "yesterday" in Paris between midnight and 1–2 am.
+ *
+ * @param timeZone - An IANA time zone, e.g. `"Europe/Paris"`.
+ * @param now - The reference instant (defaults to now).
+ * @returns `{ year, month, day, iso }`, `month` from 1 to 12.
+ * @throws {RangeError} If the time zone is invalid.
+ * @example
+ * todayInTimeZone("Europe/Paris").iso; // => "2026-09-30"
+ */
+export declare function todayInTimeZone(timeZone: string, now?: Date): CalendarDate;
+//# sourceMappingURL=todayInTimeZone.d.ts.map

package/dist/date/todayInTimeZone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todayInTimeZone.d.ts","sourceRoot":"","sources":["../../src/date/todayInTimeZone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,IAAiB,GACrB,YAAY,CAEd"}

package/dist/date/todayInTimeZone.js

@@ -0,0 +1,15 @@
+import { dateInTimeZone } from "./dateInTimeZone.js";
+/**
+ * Returns today's calendar date in a given time zone — on a server running in
+ * UTC, `new Date()` is still "yesterday" in Paris between midnight and 1–2 am.
+ *
+ * @param timeZone - An IANA time zone, e.g. `"Europe/Paris"`.
+ * @param now - The reference instant (defaults to now).
+ * @returns `{ year, month, day, iso }`, `month` from 1 to 12.
+ * @throws {RangeError} If the time zone is invalid.
+ * @example
+ * todayInTimeZone("Europe/Paris").iso; // => "2026-09-30"
+ */
+export function todayInTimeZone(timeZone, now = new Date()) {
+    return dateInTimeZone(now, timeZone);
+}

package/dist/files/downloadText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"downloadText.d.ts","sourceRoot":"","sources":["../../src/files/downloadText.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAcjE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAe,GACtB,IAAI,CAcN"}
+{"version":3,"file":"downloadText.d.ts","sourceRoot":"","sources":["../../src/files/downloadText.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAcjE;AASD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAe,GACtB,IAAI,CAgBN"}

package/dist/files/downloadText.js

@@ -12,6 +12,12 @@ export function downloadText(filename, text) {
     element.click();
     document.body.removeChild(element);
 }
+/**
+ * How long the object URL stays valid after the click. Revoking it right
+ * away can cancel the download in Firefox and Safari, which start it
+ * asynchronously; FileSaver.js uses the same 40 s delay.
+ */
+const REVOKE_DELAY_MS = 40_000;
 /**
  * Downloads a text blob as a file.
  * @param filename The filename to save to.
@@ -26,6 +32,8 @@ export function downloadTextBlob(filename, text, mimeType = "text/plain") {
     a.style.setProperty("display", "none");
     document.body.appendChild(a);
     a.click();
-    URL.revokeObjectURL(url);
     document.body.removeChild(a);
+    setTimeout(() => {
+        URL.revokeObjectURL(url);
+    }, REVOKE_DELAY_MS);
 }

package/dist/files/formatFileTimestamp.d.ts

@@ -0,0 +1,22 @@
+export interface FormatFileTimestampOptions {
+    /** Append the seconds (`HHMMSS` instead of `HHMM`). Default: `false`. */
+    seconds?: boolean;
+    /** Put between the date and the time. Default: `"-"`. */
+    separator?: string;
+}
+/**
+ * Compact, file-name-safe timestamp in **local** time, `YYYYMMDD-HHMM` by
+ * default: unlike `toISOString()` (UTC, with `:` that Windows rejects), an
+ * export made at 00:30 carries the day it was made on, and names built with it
+ * sort chronologically in a file explorer.
+ *
+ * @param date - The instant to format. Default: now.
+ * @param options - `seconds`, `separator` between date and time.
+ * @returns The formatted timestamp.
+ * @example
+ * formatFileTimestamp(new Date(2026, 9, 8, 9, 2)); // => "20261008-0902"
+ * formatFileTimestamp(new Date(2026, 9, 8, 9, 2, 5), { seconds: true, separator: "" });
+ * // => "20261008090205"
+ */
+export declare function formatFileTimestamp(date?: Date, { seconds, separator }?: FormatFileTimestampOptions): string;
+//# sourceMappingURL=formatFileTimestamp.d.ts.map

package/dist/files/formatFileTimestamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatFileTimestamp.d.ts","sourceRoot":"","sources":["../../src/files/formatFileTimestamp.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IACzC,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,GAAE,IAAiB,EACvB,EAAE,OAAe,EAAE,SAAe,EAAE,GAAE,0BAA+B,GACpE,MAAM,CAIR"}

package/dist/files/formatFileTimestamp.js

@@ -0,0 +1,20 @@
+const pad2 = (value) => String(value).padStart(2, "0");
+/**
+ * Compact, file-name-safe timestamp in **local** time, `YYYYMMDD-HHMM` by
+ * default: unlike `toISOString()` (UTC, with `:` that Windows rejects), an
+ * export made at 00:30 carries the day it was made on, and names built with it
+ * sort chronologically in a file explorer.
+ *
+ * @param date - The instant to format. Default: now.
+ * @param options - `seconds`, `separator` between date and time.
+ * @returns The formatted timestamp.
+ * @example
+ * formatFileTimestamp(new Date(2026, 9, 8, 9, 2)); // => "20261008-0902"
+ * formatFileTimestamp(new Date(2026, 9, 8, 9, 2, 5), { seconds: true, separator: "" });
+ * // => "20261008090205"
+ */
+export function formatFileTimestamp(date = new Date(), { seconds = false, separator = "-" } = {}) {
+    const day = `${date.getFullYear()}${pad2(date.getMonth() + 1)}${pad2(date.getDate())}`;
+    const time = `${pad2(date.getHours())}${pad2(date.getMinutes())}${seconds ? pad2(date.getSeconds()) : ""}`;
+    return `${day}${separator}${time}`;
+}

package/dist/files/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./downloadText.js";
+export * from "./formatFileTimestamp.js";
 export * from "./sanitizeFileName.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/files/index.js

@@ -1,2 +1,3 @@
 export * from "./downloadText.js";
+export * from "./formatFileTimestamp.js";
 export * from "./sanitizeFileName.js";

package/dist/function/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./memoize.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/function/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/function/index.js

@@ -0,0 +1 @@
+export * from "./memoize.js";

package/dist/function/memoize.d.ts

@@ -0,0 +1,34 @@
+export interface MemoizedFunction<Args extends unknown[], R> {
+    (...args: Args): R;
+    /** The underlying cache, exposed for inspection or manual clearing. */
+    cache: Map<string, R>;
+}
+export interface MemoizeOptions<Args extends unknown[]> {
+    /** Computes the cache key for a set of arguments (defaults to `JSON.stringify`). */
+    getKey?: (...args: Args) => string;
+    /**
+     * Max number of cached results; beyond it, the least recently used one is
+     * evicted. Unbounded by default — set it for a long-lived function called
+     * with many distinct arguments.
+     */
+    maxSize?: number;
+}
+/**
+ * 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 declare function memoize<Args extends unknown[], R>(fn: (...args: Args) => R, getKeyOrOptions?: ((...args: Args) => string) | MemoizeOptions<Args>): MemoizedFunction<Args, R>;
+//# sourceMappingURL=memoize.d.ts.map

package/dist/function/memoize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoize.d.ts","sourceRoot":"","sources":["../../src/function/memoize.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC;IACzD,CAAC,GAAG,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC;IACnB,uEAAuE;IACvE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,cAAc,CAAC,IAAI,SAAS,OAAO,EAAE;IACpD,oFAAoF;IACpF,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EAC/C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,EACxB,eAAe,GAAE,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,GAAG,cAAc,CAAC,IAAI,CAAM,GACvE,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAqC3B"}