@ethisyscore/core-utils 1.21.0

package/README.md

@@ -0,0 +1,52 @@
+# @ethisyscore/core-utils
+
+Framework-agnostic utilities shared by the EthisysCore monolith and plugins.
+Pure TypeScript — **no React, no MUI**. Utilities are grouped by domain; today
+that is `date`.
+
+## Install
+
+```bash
+npm install @ethisyscore/core-utils
+```
+
+`date-fns` is a runtime dependency. `dayjs` is an **optional** peer dependency —
+only needed if you import the `./date/dayjs` sub-path.
+
+## Usage
+
+```ts
+// Everything (umbrella entry)
+import { formatDateSafe, dateOnlyToIsoUtc, formatDurationNumber } from "@ethisyscore/core-utils";
+
+// Or import the date group directly
+import { addDaysToIsoDate, toHHmmss } from "@ethisyscore/core-utils/date";
+
+// dayjs-backed picker helper (requires dayjs)
+import { dayjsToIsoDayBoundary } from "@ethisyscore/core-utils/date/dayjs";
+```
+
+## What's inside (`./date`)
+
+| Area | Exports |
+| --- | --- |
+| **Format constants** | `DATE_FORMAT`, `DISPLAY_DATE_FORMAT`, `AUDIT_DATE_FORMAT`, `DAY_DATE_FORMAT`, `DAY_MONTH_FORMAT`, `DAY_MONTH_YEAR_FORMAT`, `TIME_FORMAT`, `SHORT_DATETIME_FORMAT` |
+| **ISO / timezone-safe** | `isDateOnlyString`, `formatDate`, `getTodayIsoDate`, `getMonthStartIso`, `getMonthEndIso`, `parseIsoDateLocal`, `addDaysToIsoDate`, `toDateOnlyString` |
+| **Display formatting** | `formatDateString`, `formatDateSafe`, `formatDateWithOrdinal`, `formatTimeAgo` |
+| **Duration / timespan** | `timespanToMilliseconds`, `millisecondsToHours`, `hoursToMilliseconds`, `formatMillisecondsAsTimeSpent`, `formatDuration`, `formatDurationNumber`, `toHHmm`, `toHHmmss` |
+| **Wire boundary (`<input>` ⇄ .NET `DateTimeOffset`)** | `isoToDateInput`, `dateInputToIso`, `dateOnlyToIsoUtc`, `nowLocalDateTimeInputValue`, `localDateTimeInputToIsoUtc`, `isoUtcToLocalDateTimeInput`, `ensureUtcIso` |
+| **Ranges / timezone** | `getDateRange`, `computeDateRange`, `currentMonthRangeUtc`, `getCurrentOffsetMinutes` |
+| **dayjs sub-path** | `dayjsToIsoDayBoundary` |
+
+The wire-boundary helpers exist to bridge the naive local strings emitted by
+`<input type="date">` / `<input type="datetime-local">` to full ISO-8601 UTC,
+avoiding the offset/DST drift that occurs when a .NET `DateTimeOffset` endpoint
+reinterprets a no-suffix timestamp as UTC.
+
+## Scripts
+
+```bash
+npm run build   # tsup → ESM + CJS + d.ts
+npm test        # vitest
+npm run lint    # tsc --noEmit
+```

package/dist/date/dayjs.cjs

@@ -0,0 +1,11 @@
+'use strict';
+
+// src/date/dayjs.ts
+function dayjsToIsoDayBoundary(value, endOfDay = false) {
+  if (!value || !value.isValid()) return void 0;
+  return endOfDay ? value.endOf("day").toISOString() : value.startOf("day").toISOString();
+}
+
+exports.dayjsToIsoDayBoundary = dayjsToIsoDayBoundary;
+//# sourceMappingURL=dayjs.cjs.map
+//# sourceMappingURL=dayjs.cjs.map

package/dist/date/dayjs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/date/dayjs.ts"],"names":[],"mappings":";;;AAwBO,SAAS,qBAAA,CAAsB,KAAA,EAAiC,QAAA,GAAW,KAAA,EAA2B;AAC3G,EAAA,IAAI,CAAC,KAAA,IAAS,CAAC,KAAA,CAAM,OAAA,IAAW,OAAO,MAAA;AACvC,EAAA,OAAO,QAAA,GAAW,KAAA,CAAM,KAAA,CAAM,KAAK,CAAA,CAAE,WAAA,EAAY,GAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,CAAE,WAAA,EAAY;AACxF","file":"dayjs.cjs","sourcesContent":["import type { Dayjs } from \"dayjs\";\n\n/**\n * Converts a Dayjs picker value to a UTC ISO timestamp anchored at the user's\n * LOCAL day boundary.\n *\n * Used by date-range filter bars where the BE expects a full ISO timestamp\n * boundary — `OccurredFrom` is start-of-local-day, `OccurredTo` is\n * end-of-local-day so the filter is inclusive of the user's calendar day\n * regardless of their timezone.\n *\n * Critical: hardcoding `T00:00:00.000Z` on the formatted date treats the picker\n * value as UTC, which shifts the boundary by the user's offset (e.g. a user in\n * Europe/London during BST loses the first hour of their local day).\n * `startOf(\"day\")` / `endOf(\"day\")` give the local boundary; `.toISOString()`\n * then converts to UTC for the wire.\n *\n * Lives behind the `@ethisyscore/core-utils/date/dayjs` sub-path so the core\n * entry stays free of the optional `dayjs` peer dependency.\n *\n * @param value - The Dayjs picker value (or null when the user cleared the field)\n * @param endOfDay - When true, returns the end-of-local-day boundary\n * @returns ISO timestamp string in UTC, or undefined when the value is null/invalid\n */\nexport function dayjsToIsoDayBoundary(value: Dayjs | null | undefined, endOfDay = false): string | undefined {\n  if (!value || !value.isValid()) return undefined;\n  return endOfDay ? value.endOf(\"day\").toISOString() : value.startOf(\"day\").toISOString();\n}\n"]}

package/dist/date/dayjs.d.cts

@@ -0,0 +1,27 @@
+import { Dayjs } from 'dayjs';
+
+/**
+ * Converts a Dayjs picker value to a UTC ISO timestamp anchored at the user's
+ * LOCAL day boundary.
+ *
+ * Used by date-range filter bars where the BE expects a full ISO timestamp
+ * boundary — `OccurredFrom` is start-of-local-day, `OccurredTo` is
+ * end-of-local-day so the filter is inclusive of the user's calendar day
+ * regardless of their timezone.
+ *
+ * Critical: hardcoding `T00:00:00.000Z` on the formatted date treats the picker
+ * value as UTC, which shifts the boundary by the user's offset (e.g. a user in
+ * Europe/London during BST loses the first hour of their local day).
+ * `startOf("day")` / `endOf("day")` give the local boundary; `.toISOString()`
+ * then converts to UTC for the wire.
+ *
+ * Lives behind the `@ethisyscore/core-utils/date/dayjs` sub-path so the core
+ * entry stays free of the optional `dayjs` peer dependency.
+ *
+ * @param value - The Dayjs picker value (or null when the user cleared the field)
+ * @param endOfDay - When true, returns the end-of-local-day boundary
+ * @returns ISO timestamp string in UTC, or undefined when the value is null/invalid
+ */
+declare function dayjsToIsoDayBoundary(value: Dayjs | null | undefined, endOfDay?: boolean): string | undefined;
+
+export { dayjsToIsoDayBoundary };

package/dist/date/dayjs.d.ts

@@ -0,0 +1,27 @@
+import { Dayjs } from 'dayjs';
+
+/**
+ * Converts a Dayjs picker value to a UTC ISO timestamp anchored at the user's
+ * LOCAL day boundary.
+ *
+ * Used by date-range filter bars where the BE expects a full ISO timestamp
+ * boundary — `OccurredFrom` is start-of-local-day, `OccurredTo` is
+ * end-of-local-day so the filter is inclusive of the user's calendar day
+ * regardless of their timezone.
+ *
+ * Critical: hardcoding `T00:00:00.000Z` on the formatted date treats the picker
+ * value as UTC, which shifts the boundary by the user's offset (e.g. a user in
+ * Europe/London during BST loses the first hour of their local day).
+ * `startOf("day")` / `endOf("day")` give the local boundary; `.toISOString()`
+ * then converts to UTC for the wire.
+ *
+ * Lives behind the `@ethisyscore/core-utils/date/dayjs` sub-path so the core
+ * entry stays free of the optional `dayjs` peer dependency.
+ *
+ * @param value - The Dayjs picker value (or null when the user cleared the field)
+ * @param endOfDay - When true, returns the end-of-local-day boundary
+ * @returns ISO timestamp string in UTC, or undefined when the value is null/invalid
+ */
+declare function dayjsToIsoDayBoundary(value: Dayjs | null | undefined, endOfDay?: boolean): string | undefined;
+
+export { dayjsToIsoDayBoundary };

package/dist/date/dayjs.js

@@ -0,0 +1,9 @@
+// src/date/dayjs.ts
+function dayjsToIsoDayBoundary(value, endOfDay = false) {
+  if (!value || !value.isValid()) return void 0;
+  return endOfDay ? value.endOf("day").toISOString() : value.startOf("day").toISOString();
+}
+
+export { dayjsToIsoDayBoundary };
+//# sourceMappingURL=dayjs.js.map
+//# sourceMappingURL=dayjs.js.map

package/dist/date/dayjs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/date/dayjs.ts"],"names":[],"mappings":";AAwBO,SAAS,qBAAA,CAAsB,KAAA,EAAiC,QAAA,GAAW,KAAA,EAA2B;AAC3G,EAAA,IAAI,CAAC,KAAA,IAAS,CAAC,KAAA,CAAM,OAAA,IAAW,OAAO,MAAA;AACvC,EAAA,OAAO,QAAA,GAAW,KAAA,CAAM,KAAA,CAAM,KAAK,CAAA,CAAE,WAAA,EAAY,GAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,CAAE,WAAA,EAAY;AACxF","file":"dayjs.js","sourcesContent":["import type { Dayjs } from \"dayjs\";\n\n/**\n * Converts a Dayjs picker value to a UTC ISO timestamp anchored at the user's\n * LOCAL day boundary.\n *\n * Used by date-range filter bars where the BE expects a full ISO timestamp\n * boundary — `OccurredFrom` is start-of-local-day, `OccurredTo` is\n * end-of-local-day so the filter is inclusive of the user's calendar day\n * regardless of their timezone.\n *\n * Critical: hardcoding `T00:00:00.000Z` on the formatted date treats the picker\n * value as UTC, which shifts the boundary by the user's offset (e.g. a user in\n * Europe/London during BST loses the first hour of their local day).\n * `startOf(\"day\")` / `endOf(\"day\")` give the local boundary; `.toISOString()`\n * then converts to UTC for the wire.\n *\n * Lives behind the `@ethisyscore/core-utils/date/dayjs` sub-path so the core\n * entry stays free of the optional `dayjs` peer dependency.\n *\n * @param value - The Dayjs picker value (or null when the user cleared the field)\n * @param endOfDay - When true, returns the end-of-local-day boundary\n * @returns ISO timestamp string in UTC, or undefined when the value is null/invalid\n */\nexport function dayjsToIsoDayBoundary(value: Dayjs | null | undefined, endOfDay = false): string | undefined {\n  if (!value || !value.isValid()) return undefined;\n  return endOfDay ? value.endOf(\"day\").toISOString() : value.startOf(\"day\").toISOString();\n}\n"]}

package/dist/date/index.cjs

@@ -0,0 +1,281 @@
+'use strict';
+
+var dateFns = require('date-fns');
+
+// src/date/constants.ts
+var DATE_FORMAT = "yyyy-MM-dd";
+var AUDIT_DATE_FORMAT = "d MMMM yyyy, HH:mm";
+var DISPLAY_DATE_FORMAT = "d MMM yyyy";
+var DAY_DATE_FORMAT = "EEEE, d MMMM";
+var DAY_MONTH_FORMAT = "MMM d";
+var DAY_MONTH_YEAR_FORMAT = "MMM d, yyyy";
+var TIME_FORMAT = "h:mm a";
+var SHORT_DATETIME_FORMAT = "MMM d, h:mm a";
+var isDateOnlyString = (value) => {
+  return typeof value === "string" && /^\d{4}-\d{2}-\d{2}$/.test(value);
+};
+var formatDate = (date, dateFormat = DATE_FORMAT) => {
+  return dateFns.format(date, dateFormat);
+};
+var getTodayIsoDate = () => {
+  return formatDate(/* @__PURE__ */ new Date());
+};
+var getMonthStartIso = (date) => formatDate(new Date(date.getFullYear(), date.getMonth(), 1));
+var getMonthEndIso = (date) => formatDate(new Date(date.getFullYear(), date.getMonth() + 1, 0));
+var parseIsoDateLocal = (value) => {
+  if (!value || !isDateOnlyString(value)) return null;
+  const [year, month, day] = value.split("-").map(Number);
+  const d = new Date(year, month - 1, day);
+  return dateFns.isValid(d) ? d : null;
+};
+var addDaysToIsoDate = (isoDate, days) => {
+  const base = parseIsoDateLocal(isoDate);
+  if (!base) return isoDate;
+  base.setDate(base.getDate() + days);
+  return formatDate(base);
+};
+var toDateOnlyString = (value) => {
+  if (!value) return "";
+  const datepart = value.split("T")[0];
+  return isDateOnlyString(datepart) ? datepart : "";
+};
+var formatDateString = (date, dateFormat = DATE_FORMAT) => {
+  if (!date) return "-";
+  const parsed = dateFns.parseISO(date);
+  if (!dateFns.isValid(parsed)) return "-";
+  return dateFns.format(parsed, dateFormat);
+};
+var formatDateSafe = (date, formatStr = DATE_FORMAT, fallback = "\u2014") => {
+  if (!date) return fallback;
+  try {
+    const dateObj = typeof date === "string" ? dateFns.parseISO(date) : date;
+    if (!dateFns.isValid(dateObj)) return fallback;
+    return dateFns.format(dateObj, formatStr);
+  } catch {
+    return fallback;
+  }
+};
+var getOrdinalSuffix = (day) => {
+  if (day > 3 && day < 21) return "th";
+  switch (day % 10) {
+    case 1:
+      return "st";
+    case 2:
+      return "nd";
+    case 3:
+      return "rd";
+    default:
+      return "th";
+  }
+};
+var formatDateWithOrdinal = (date) => {
+  if (!date) return "Not specified";
+  let dateObj;
+  if (typeof date === "string") {
+    if (isDateOnlyString(date)) {
+      const [year2, month2, day2] = date.split("-").map(Number);
+      dateObj = new Date(year2, month2 - 1, day2);
+    } else {
+      dateObj = dateFns.parseISO(date);
+    }
+  } else {
+    dateObj = date;
+  }
+  if (!dateFns.isValid(dateObj)) return "Invalid date";
+  const day = dateObj.getDate();
+  const month = dateFns.format(dateObj, "MMM");
+  const year = dateObj.getFullYear();
+  return `${day}${getOrdinalSuffix(day)} ${month} ${year}`;
+};
+var formatTimeAgo = (date) => {
+  if (!date) return "";
+  const dateObj = typeof date === "string" ? dateFns.parseISO(date) : date;
+  if (!dateFns.isValid(dateObj)) return "";
+  const now = /* @__PURE__ */ new Date();
+  const seconds = Math.floor((now.getTime() - dateObj.getTime()) / 1e3);
+  if (seconds < 60) return "Just now";
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60) return `${minutes}m ago`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours}h ago`;
+  const days = Math.floor(hours / 24);
+  if (days < 7) return `${days}d ago`;
+  return formatDate(dateObj);
+};
+
+// src/date/duration.ts
+var timespanToMilliseconds = (timespan) => {
+  if (!timespan) return 0;
+  const [h = "0", m = "0", s = "0"] = timespan.split(":");
+  const hours = parseInt(h || "0", 10);
+  const minutes = parseInt(m || "0", 10);
+  const seconds = parseInt(s || "0", 10);
+  return (isNaN(hours) ? 0 : hours) * 60 * 60 * 1e3 + (isNaN(minutes) ? 0 : minutes) * 60 * 1e3 + (isNaN(seconds) ? 0 : seconds) * 1e3;
+};
+var millisecondsToHours = (ms) => ms / (1e3 * 60 * 60);
+var hoursToMilliseconds = (hours) => hours * (1e3 * 60 * 60);
+var formatMillisecondsAsTimeSpent = (ms) => {
+  if (!ms || ms < 0) return "0h 0min";
+  const totalMinutes = Math.floor(ms / (1e3 * 60));
+  const hours = Math.floor(totalMinutes / 60);
+  const minutes = totalMinutes % 60;
+  let result = "";
+  if (hours > 0) result += `${hours}h`;
+  if (minutes > 0 || hours === 0) result += (hours > 0 ? " " : "") + `${minutes}min`;
+  return result;
+};
+function formatDuration(duration) {
+  if (!duration) return "-";
+  const [hours, minutes, seconds] = duration.split(":").map(Number);
+  let result = "";
+  if (hours) result += `${hours}h`;
+  if (minutes) result += (result ? " " : "") + `${minutes}m`;
+  if (seconds) result += (result ? " " : "") + `${seconds}s`;
+  return result || "0m";
+}
+var formatDurationNumber = (durationHours) => {
+  if (durationHours == null || durationHours === 0) return "\u2014";
+  if (durationHours > 8760) return "Unknown";
+  if (durationHours < 0) return "Error";
+  const hours = Math.floor(durationHours);
+  const minutes = Math.floor(durationHours % 1 * 60);
+  if (durationHours < 1) return `${minutes}m`;
+  if (hours < 24) {
+    if (minutes === 0) return `${hours}h`;
+    return `${hours}h ${minutes}m`;
+  }
+  const days = Math.floor(hours / 24);
+  const remainingHours = hours % 24;
+  if (remainingHours === 0) return `${days}d`;
+  return `${days}d ${remainingHours}h`;
+};
+function toHHmm(value, fallback) {
+  if (!value || value.length < 5) return fallback;
+  return value.slice(0, 5);
+}
+function toHHmmss(value) {
+  const trimmed = value.trim();
+  if (!trimmed) return null;
+  return trimmed.length === 5 ? `${trimmed}:00` : trimmed;
+}
+var isoToDateInput = (isoString) => {
+  if (!isoString) return "";
+  try {
+    return new Date(isoString).toISOString().split("T")[0];
+  } catch {
+    return "";
+  }
+};
+var dateInputToIso = (dateString) => {
+  if (!dateString) return "";
+  const parsed = /* @__PURE__ */ new Date(dateString + "T00:00:00Z");
+  return Number.isNaN(parsed.getTime()) ? "" : parsed.toISOString();
+};
+function dateOnlyToIsoUtc(value) {
+  if (!value) return void 0;
+  const parsed = value.includes("T") ? new Date(value) : /* @__PURE__ */ new Date(`${value}T00:00:00Z`);
+  return Number.isNaN(parsed.getTime()) ? void 0 : parsed.toISOString();
+}
+function nowLocalDateTimeInputValue() {
+  return dateFns.format(/* @__PURE__ */ new Date(), "yyyy-MM-dd'T'HH:mm");
+}
+function localDateTimeInputToIsoUtc(value) {
+  if (!value) return void 0;
+  const parsed = new Date(value);
+  if (!dateFns.isValid(parsed)) return void 0;
+  return parsed.toISOString();
+}
+function ensureUtcIso(value) {
+  return /[Zz]|[+-]\d{2}:?\d{2}$/.test(value) ? value : value + "Z";
+}
+function isoUtcToLocalDateTimeInput(value, fallback = "") {
+  if (!value) return fallback;
+  const parsed = new Date(ensureUtcIso(value));
+  if (!dateFns.isValid(parsed)) return fallback;
+  return dateFns.format(parsed, "yyyy-MM-dd'T'HH:mm");
+}
+var getDateRange = (timePeriod, dateFormat = DATE_FORMAT) => {
+  const today = /* @__PURE__ */ new Date();
+  switch (timePeriod) {
+    case "month":
+      return { startDate: dateFns.format(dateFns.subMonths(today, 1), dateFormat), endDate: dateFns.format(today, dateFormat) };
+    case "quarter":
+      return { startDate: dateFns.format(dateFns.subMonths(today, 3), dateFormat), endDate: dateFns.format(today, dateFormat) };
+    case "year":
+      return { startDate: dateFns.format(dateFns.subYears(today, 1), dateFormat), endDate: dateFns.format(today, dateFormat) };
+    case "week":
+    default:
+      return { startDate: dateFns.format(dateFns.subDays(today, 7), dateFormat), endDate: dateFns.format(today, dateFormat) };
+  }
+};
+function computeDateRange(days) {
+  const to = (/* @__PURE__ */ new Date()).toISOString();
+  const from = new Date(Date.now() - days * 864e5).toISOString();
+  return { from, to };
+}
+function currentMonthRangeUtc(today = /* @__PURE__ */ new Date()) {
+  const year = today.getUTCFullYear();
+  const month = today.getUTCMonth();
+  return {
+    fromUtc: new Date(Date.UTC(year, month, 1)).toISOString(),
+    beforeUtc: new Date(Date.UTC(year, month + 1, 1)).toISOString()
+  };
+}
+function getCurrentOffsetMinutes(iana) {
+  try {
+    const parts = new Intl.DateTimeFormat("en", {
+      timeZone: iana,
+      timeZoneName: "longOffset"
+    }).formatToParts(/* @__PURE__ */ new Date());
+    const label = parts.find((p) => p.type === "timeZoneName")?.value ?? "";
+    if (label === "GMT" || label === "UTC") return 0;
+    const m = label.match(/GMT([+-])(\d{2}):(\d{2})/);
+    if (!m) return null;
+    const sign = m[1] === "+" ? 1 : -1;
+    return sign * (parseInt(m[2], 10) * 60 + parseInt(m[3], 10));
+  } catch {
+    return null;
+  }
+}
+
+exports.AUDIT_DATE_FORMAT = AUDIT_DATE_FORMAT;
+exports.DATE_FORMAT = DATE_FORMAT;
+exports.DAY_DATE_FORMAT = DAY_DATE_FORMAT;
+exports.DAY_MONTH_FORMAT = DAY_MONTH_FORMAT;
+exports.DAY_MONTH_YEAR_FORMAT = DAY_MONTH_YEAR_FORMAT;
+exports.DISPLAY_DATE_FORMAT = DISPLAY_DATE_FORMAT;
+exports.SHORT_DATETIME_FORMAT = SHORT_DATETIME_FORMAT;
+exports.TIME_FORMAT = TIME_FORMAT;
+exports.addDaysToIsoDate = addDaysToIsoDate;
+exports.computeDateRange = computeDateRange;
+exports.currentMonthRangeUtc = currentMonthRangeUtc;
+exports.dateInputToIso = dateInputToIso;
+exports.dateOnlyToIsoUtc = dateOnlyToIsoUtc;
+exports.ensureUtcIso = ensureUtcIso;
+exports.formatDate = formatDate;
+exports.formatDateSafe = formatDateSafe;
+exports.formatDateString = formatDateString;
+exports.formatDateWithOrdinal = formatDateWithOrdinal;
+exports.formatDuration = formatDuration;
+exports.formatDurationNumber = formatDurationNumber;
+exports.formatMillisecondsAsTimeSpent = formatMillisecondsAsTimeSpent;
+exports.formatTimeAgo = formatTimeAgo;
+exports.getCurrentOffsetMinutes = getCurrentOffsetMinutes;
+exports.getDateRange = getDateRange;
+exports.getMonthEndIso = getMonthEndIso;
+exports.getMonthStartIso = getMonthStartIso;
+exports.getTodayIsoDate = getTodayIsoDate;
+exports.hoursToMilliseconds = hoursToMilliseconds;
+exports.isDateOnlyString = isDateOnlyString;
+exports.isoToDateInput = isoToDateInput;
+exports.isoUtcToLocalDateTimeInput = isoUtcToLocalDateTimeInput;
+exports.localDateTimeInputToIsoUtc = localDateTimeInputToIsoUtc;
+exports.millisecondsToHours = millisecondsToHours;
+exports.nowLocalDateTimeInputValue = nowLocalDateTimeInputValue;
+exports.parseIsoDateLocal = parseIsoDateLocal;
+exports.timespanToMilliseconds = timespanToMilliseconds;
+exports.toDateOnlyString = toDateOnlyString;
+exports.toHHmm = toHHmm;
+exports.toHHmmss = toHHmmss;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/date/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/date/constants.ts","../../src/date/iso.ts","../../src/date/format.ts","../../src/date/duration.ts","../../src/date/wire.ts","../../src/date/range.ts"],"names":["format","isValid","parseISO","year","month","day","subMonths","subYears","subDays"],"mappings":";;;;;AASO,IAAM,WAAA,GAAc;AAGpB,IAAM,iBAAA,GAAoB;AAG1B,IAAM,mBAAA,GAAsB;AAG5B,IAAM,eAAA,GAAkB;AAGxB,IAAM,gBAAA,GAAmB;AAGzB,IAAM,qBAAA,GAAwB;AAG9B,IAAM,WAAA,GAAc;AAGpB,IAAM,qBAAA,GAAwB;ACzB9B,IAAM,gBAAA,GAAmB,CAAC,KAAA,KAAoC;AACnE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,qBAAA,CAAsB,KAAK,KAAK,CAAA;AACtE;AAMO,IAAM,UAAA,GAAa,CAAC,IAAA,EAAY,UAAA,GAAqB,WAAA,KAAwB;AAClF,EAAA,OAAOA,cAAA,CAAO,MAAM,UAAU,CAAA;AAChC;AAGO,IAAM,kBAAkB,MAAc;AAC3C,EAAA,OAAO,UAAA,iBAAW,IAAI,IAAA,EAAM,CAAA;AAC9B;AAGO,IAAM,gBAAA,GAAmB,CAAC,IAAA,KAC/B,UAAA,CAAW,IAAI,IAAA,CAAK,IAAA,CAAK,WAAA,EAAY,EAAG,IAAA,CAAK,QAAA,EAAS,EAAG,CAAC,CAAC;AAGtD,IAAM,cAAA,GAAiB,CAAC,IAAA,KAC7B,UAAA,CAAW,IAAI,IAAA,CAAK,IAAA,CAAK,WAAA,EAAY,EAAG,IAAA,CAAK,QAAA,EAAS,GAAI,CAAA,EAAG,CAAC,CAAC;AAO1D,IAAM,iBAAA,GAAoB,CAAC,KAAA,KAAkD;AAClF,EAAA,IAAI,CAAC,KAAA,IAAS,CAAC,gBAAA,CAAiB,KAAK,GAAG,OAAO,IAAA;AAC/C,EAAA,MAAM,CAAC,IAAA,EAAM,KAAA,EAAO,GAAG,CAAA,GAAI,MAAM,KAAA,CAAM,GAAG,CAAA,CAAE,GAAA,CAAI,MAAM,CAAA;AACtD,EAAA,MAAM,IAAI,IAAI,IAAA,CAAK,IAAA,EAAM,KAAA,GAAQ,GAAG,GAAG,CAAA;AACvC,EAAA,OAAOC,eAAA,CAAQ,CAAC,CAAA,GAAI,CAAA,GAAI,IAAA;AAC1B;AAQO,IAAM,gBAAA,GAAmB,CAAC,OAAA,EAAiB,IAAA,KAAyB;AACzE,EAAA,MAAM,IAAA,GAAO,kBAAkB,OAAO,CAAA;AACtC,EAAA,IAAI,CAAC,MAAM,OAAO,OAAA;AAClB,EAAA,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,OAAA,EAAQ,GAAI,IAAI,CAAA;AAClC,EAAA,OAAO,WAAW,IAAI,CAAA;AACxB;AAUO,IAAM,gBAAA,GAAmB,CAAC,KAAA,KAA6C;AAC5E,EAAA,IAAI,CAAC,OAAO,OAAO,EAAA;AAGnB,EAAA,MAAM,QAAA,GAAW,KAAA,CAAM,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA;AACnC,EAAA,OAAO,gBAAA,CAAiB,QAAQ,CAAA,GAAI,QAAA,GAAW,EAAA;AACjD;AC1DO,IAAM,gBAAA,GAAmB,CAAC,IAAA,EAAsB,UAAA,GAAqB,WAAA,KAAwB;AAClG,EAAA,IAAI,CAAC,MAAM,OAAO,GAAA;AAClB,EAAA,MAAM,MAAA,GAASC,iBAAS,IAAI,CAAA;AAC5B,EAAA,IAAI,CAACD,eAAAA,CAAQ,MAAM,CAAA,EAAG,OAAO,GAAA;AAC7B,EAAA,OAAOD,cAAAA,CAAO,QAAQ,UAAU,CAAA;AAClC;AASO,IAAM,iBAAiB,CAC5B,IAAA,EACA,SAAA,GAAoB,WAAA,EACpB,WAAmB,QAAA,KACR;AACX,EAAA,IAAI,CAAC,MAAM,OAAO,QAAA;AAClB,EAAA,IAAI;AACF,IAAA,MAAM,UAAU,OAAO,IAAA,KAAS,QAAA,GAAWE,gBAAA,CAAS,IAAI,CAAA,GAAI,IAAA;AAC5D,IAAA,IAAI,CAACD,eAAAA,CAAQ,OAAO,CAAA,EAAG,OAAO,QAAA;AAC9B,IAAA,OAAOD,cAAAA,CAAO,SAAS,SAAS,CAAA;AAAA,EAClC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,QAAA;AAAA,EACT;AACF;AAGA,IAAM,gBAAA,GAAmB,CAAC,GAAA,KAAwB;AAChD,EAAA,IAAI,GAAA,GAAM,CAAA,IAAK,GAAA,GAAM,EAAA,EAAI,OAAO,IAAA;AAChC,EAAA,QAAQ,MAAM,EAAA;AAAI,IAChB,KAAK,CAAA;AACH,MAAA,OAAO,IAAA;AAAA,IACT,KAAK,CAAA;AACH,MAAA,OAAO,IAAA;AAAA,IACT,KAAK,CAAA;AACH,MAAA,OAAO,IAAA;AAAA,IACT;AACE,MAAA,OAAO,IAAA;AAAA;AAEb,CAAA;AAQO,IAAM,qBAAA,GAAwB,CAAC,IAAA,KAAmD;AACvF,EAAA,IAAI,CAAC,MAAM,OAAO,eAAA;AAElB,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI,OAAO,SAAS,QAAA,EAAU;AAC5B,IAAA,IAAI,gBAAA,CAAiB,IAAI,CAAA,EAAG;AAC1B,MAAA,MAAM,CAACG,KAAAA,EAAMC,MAAAA,EAAOC,IAAG,CAAA,GAAI,KAAK,KAAA,CAAM,GAAG,CAAA,CAAE,GAAA,CAAI,MAAM,CAAA;AACrD,MAAA,OAAA,GAAU,IAAI,IAAA,CAAKF,KAAAA,EAAMC,MAAAA,GAAQ,GAAGC,IAAG,CAAA;AAAA,IACzC,CAAA,MAAO;AACL,MAAA,OAAA,GAAUH,iBAAS,IAAI,CAAA;AAAA,IACzB;AAAA,EACF,CAAA,MAAO;AACL,IAAA,OAAA,GAAU,IAAA;AAAA,EACZ;AAEA,EAAA,IAAI,CAACD,eAAAA,CAAQ,OAAO,CAAA,EAAG,OAAO,cAAA;AAE9B,EAAA,MAAM,GAAA,GAAM,QAAQ,OAAA,EAAQ;AAC5B,EAAA,MAAM,KAAA,GAAQD,cAAAA,CAAO,OAAA,EAAS,KAAK,CAAA;AACnC,EAAA,MAAM,IAAA,GAAO,QAAQ,WAAA,EAAY;AACjC,EAAA,OAAO,CAAA,EAAG,GAAG,CAAA,EAAG,gBAAA,CAAiB,GAAG,CAAC,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA;AACxD;AAQO,IAAM,aAAA,GAAgB,CAAC,IAAA,KAAmD;AAC/E,EAAA,IAAI,CAAC,MAAM,OAAO,EAAA;AAElB,EAAA,MAAM,UAAU,OAAO,IAAA,KAAS,QAAA,GAAWE,gBAAA,CAAS,IAAI,CAAA,GAAI,IAAA;AAC5D,EAAA,IAAI,CAACD,eAAAA,CAAQ,OAAO,CAAA,EAAG,OAAO,EAAA;AAE9B,EAAA,MAAM,GAAA,uBAAU,IAAA,EAAK;AACrB,EAAA,MAAM,OAAA,GAAU,KAAK,KAAA,CAAA,CAAO,GAAA,CAAI,SAAQ,GAAI,OAAA,CAAQ,OAAA,EAAQ,IAAK,GAAI,CAAA;AAGrE,EAAA,IAAI,OAAA,GAAU,IAAI,OAAO,UAAA;AAEzB,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,CAAM,OAAA,GAAU,EAAE,CAAA;AACvC,EAAA,IAAI,OAAA,GAAU,EAAA,EAAI,OAAO,CAAA,EAAG,OAAO,CAAA,KAAA,CAAA;AAEnC,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,OAAA,GAAU,EAAE,CAAA;AACrC,EAAA,IAAI,KAAA,GAAQ,EAAA,EAAI,OAAO,CAAA,EAAG,KAAK,CAAA,KAAA,CAAA;AAE/B,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,KAAA,GAAQ,EAAE,CAAA;AAClC,EAAA,IAAI,IAAA,GAAO,CAAA,EAAG,OAAO,CAAA,EAAG,IAAI,CAAA,KAAA,CAAA;AAE5B,EAAA,OAAO,WAAW,OAAO,CAAA;AAC3B;;;ACxGO,IAAM,sBAAA,GAAyB,CAAC,QAAA,KAA6B;AAClE,EAAA,IAAI,CAAC,UAAU,OAAO,CAAA;AAEtB,EAAA,MAAM,CAAC,CAAA,GAAI,GAAA,EAAK,CAAA,GAAI,GAAA,EAAK,IAAI,GAAG,CAAA,GAAI,QAAA,CAAS,KAAA,CAAM,GAAG,CAAA;AACtD,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,CAAA,IAAK,GAAA,EAAK,EAAE,CAAA;AACnC,EAAA,MAAM,OAAA,GAAU,QAAA,CAAS,CAAA,IAAK,GAAA,EAAK,EAAE,CAAA;AACrC,EAAA,MAAM,OAAA,GAAU,QAAA,CAAS,CAAA,IAAK,GAAA,EAAK,EAAE,CAAA;AAErC,EAAA,OAAA,CACG,MAAM,KAAK,CAAA,GAAI,IAAI,KAAA,IAAS,EAAA,GAAK,KAAK,GAAA,GAAA,CACtC,KAAA,CAAM,OAAO,CAAA,GAAI,CAAA,GAAI,WAAW,EAAA,GAAK,GAAA,GAAA,CACrC,MAAM,OAAO,CAAA,GAAI,IAAI,OAAA,IAAW,GAAA;AAErC;AAGO,IAAM,mBAAA,GAAsB,CAAC,EAAA,KAAuB,EAAA,IAAM,MAAO,EAAA,GAAK,EAAA;AAGtE,IAAM,mBAAA,GAAsB,CAAC,KAAA,KAA0B,KAAA,IAAS,MAAO,EAAA,GAAK,EAAA;AAG5E,IAAM,6BAAA,GAAgC,CAAC,EAAA,KAAuB;AACnE,EAAA,IAAI,CAAC,EAAA,IAAM,EAAA,GAAK,CAAA,EAAG,OAAO,SAAA;AAE1B,EAAA,MAAM,YAAA,GAAe,IAAA,CAAK,KAAA,CAAM,EAAA,IAAM,MAAO,EAAA,CAAG,CAAA;AAChD,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,YAAA,GAAe,EAAE,CAAA;AAC1C,EAAA,MAAM,UAAU,YAAA,GAAe,EAAA;AAE/B,EAAA,IAAI,MAAA,GAAS,EAAA;AACb,EAAA,IAAI,KAAA,GAAQ,CAAA,EAAG,MAAA,IAAU,CAAA,EAAG,KAAK,CAAA,CAAA,CAAA;AACjC,EAAA,IAAI,OAAA,GAAU,CAAA,IAAK,KAAA,KAAU,CAAA,EAAG,MAAA,IAAA,CAAW,QAAQ,CAAA,GAAI,GAAA,GAAM,EAAA,IAAM,CAAA,EAAG,OAAO,CAAA,GAAA,CAAA;AAC7E,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,eAAe,QAAA,EAA2B;AACxD,EAAA,IAAI,CAAC,UAAU,OAAO,GAAA;AACtB,EAAA,MAAM,CAAC,KAAA,EAAO,OAAA,EAAS,OAAO,CAAA,GAAI,SAAS,KAAA,CAAM,GAAG,CAAA,CAAE,GAAA,CAAI,MAAM,CAAA;AAChE,EAAA,IAAI,MAAA,GAAS,EAAA;AACb,EAAA,IAAI,KAAA,EAAO,MAAA,IAAU,CAAA,EAAG,KAAK,CAAA,CAAA,CAAA;AAC7B,EAAA,IAAI,SAAS,MAAA,IAAA,CAAW,MAAA,GAAS,GAAA,GAAM,EAAA,IAAM,GAAG,OAAO,CAAA,CAAA,CAAA;AACvD,EAAA,IAAI,SAAS,MAAA,IAAA,CAAW,MAAA,GAAS,GAAA,GAAM,EAAA,IAAM,GAAG,OAAO,CAAA,CAAA,CAAA;AACvD,EAAA,OAAO,MAAA,IAAU,IAAA;AACnB;AAMO,IAAM,oBAAA,GAAuB,CAAC,aAAA,KAA0C;AAC7E,EAAA,IAAI,aAAA,IAAiB,IAAA,IAAQ,aAAA,KAAkB,CAAA,EAAG,OAAO,QAAA;AAGzD,EAAA,IAAI,aAAA,GAAgB,MAAM,OAAO,SAAA;AAEjC,EAAA,IAAI,aAAA,GAAgB,GAAG,OAAO,OAAA;AAE9B,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,aAAa,CAAA;AACtC,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,CAAO,aAAA,GAAgB,IAAK,EAAE,CAAA;AAEnD,EAAA,IAAI,aAAA,GAAgB,CAAA,EAAG,OAAO,CAAA,EAAG,OAAO,CAAA,CAAA,CAAA;AAExC,EAAA,IAAI,QAAQ,EAAA,EAAI;AACd,IAAA,IAAI,OAAA,KAAY,CAAA,EAAG,OAAO,CAAA,EAAG,KAAK,CAAA,CAAA,CAAA;AAClC,IAAA,OAAO,CAAA,EAAG,KAAK,CAAA,EAAA,EAAK,OAAO,CAAA,CAAA,CAAA;AAAA,EAC7B;AAEA,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,KAAA,GAAQ,EAAE,CAAA;AAClC,EAAA,MAAM,iBAAiB,KAAA,GAAQ,EAAA;AAC/B,EAAA,IAAI,cAAA,KAAmB,CAAA,EAAG,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,CAAA;AACxC,EAAA,OAAO,CAAA,EAAG,IAAI,CAAA,EAAA,EAAK,cAAc,CAAA,CAAA,CAAA;AACnC;AAOO,SAAS,MAAA,CAAO,OAAkC,QAAA,EAA0B;AACjF,EAAA,IAAI,CAAC,KAAA,IAAS,KAAA,CAAM,MAAA,GAAS,GAAG,OAAO,QAAA;AACvC,EAAA,OAAO,KAAA,CAAM,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA;AACzB;AAQO,SAAS,SAAS,KAAA,EAA8B;AACrD,EAAA,MAAM,OAAA,GAAU,MAAM,IAAA,EAAK;AAC3B,EAAA,IAAI,CAAC,SAAS,OAAO,IAAA;AACrB,EAAA,OAAO,OAAA,CAAQ,MAAA,KAAW,CAAA,GAAI,CAAA,EAAG,OAAO,CAAA,GAAA,CAAA,GAAQ,OAAA;AAClD;ACrFO,IAAM,cAAA,GAAiB,CAAC,SAAA,KAA0C;AACvE,EAAA,IAAI,CAAC,WAAW,OAAO,EAAA;AACvB,EAAA,IAAI;AACF,IAAA,OAAO,IAAI,KAAK,SAAS,CAAA,CAAE,aAAY,CAAE,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAA;AAAA,EACvD,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,EAAA;AAAA,EACT;AACF;AAGO,IAAM,cAAA,GAAiB,CAAC,UAAA,KAA+B;AAC5D,EAAA,IAAI,CAAC,YAAY,OAAO,EAAA;AACxB,EAAA,MAAM,MAAA,mBAAS,IAAI,IAAA,CAAK,UAAA,GAAa,YAAY,CAAA;AACjD,EAAA,OAAO,MAAA,CAAO,MAAM,MAAA,CAAO,OAAA,EAAS,CAAA,GAAI,EAAA,GAAK,OAAO,WAAA,EAAY;AAClE;AAWO,SAAS,iBAAiB,KAAA,EAAsD;AACrF,EAAA,IAAI,CAAC,OAAO,OAAO,MAAA;AACnB,EAAA,MAAM,MAAA,GAAS,KAAA,CAAM,QAAA,CAAS,GAAG,CAAA,GAAI,IAAI,IAAA,CAAK,KAAK,CAAA,mBAAI,IAAI,IAAA,CAAK,CAAA,EAAG,KAAK,CAAA,UAAA,CAAY,CAAA;AACpF,EAAA,OAAO,MAAA,CAAO,MAAM,MAAA,CAAO,OAAA,EAAS,CAAA,GAAI,MAAA,GAAY,OAAO,WAAA,EAAY;AACzE;AAOO,SAAS,0BAAA,GAAqC;AACnD,EAAA,OAAOD,cAAAA,iBAAO,IAAI,IAAA,EAAK,EAAG,oBAAoB,CAAA;AAChD;AAQO,SAAS,2BAA2B,KAAA,EAAsD;AAC/F,EAAA,IAAI,CAAC,OAAO,OAAO,MAAA;AACnB,EAAA,MAAM,MAAA,GAAS,IAAI,IAAA,CAAK,KAAK,CAAA;AAC7B,EAAA,IAAI,CAACC,eAAAA,CAAQ,MAAM,CAAA,EAAG,OAAO,MAAA;AAC7B,EAAA,OAAO,OAAO,WAAA,EAAY;AAC5B;AAQO,SAAS,aAAa,KAAA,EAAuB;AAClD,EAAA,OAAO,wBAAA,CAAyB,IAAA,CAAK,KAAK,CAAA,GAAI,QAAQ,KAAA,GAAQ,GAAA;AAChE;AAUO,SAAS,0BAAA,CAA2B,KAAA,EAAkC,QAAA,GAAW,EAAA,EAAY;AAClG,EAAA,IAAI,CAAC,OAAO,OAAO,QAAA;AACnB,EAAA,MAAM,MAAA,GAAS,IAAI,IAAA,CAAK,YAAA,CAAa,KAAK,CAAC,CAAA;AAC3C,EAAA,IAAI,CAACA,eAAAA,CAAQ,MAAM,CAAA,EAAG,OAAO,QAAA;AAC7B,EAAA,OAAOD,cAAAA,CAAO,QAAQ,oBAAoB,CAAA;AAC5C;AC7EO,IAAM,YAAA,GAAe,CAAC,UAAA,EAAoB,UAAA,GAAqB,WAAA,KAA2B;AAC/F,EAAA,MAAM,KAAA,uBAAY,IAAA,EAAK;AACvB,EAAA,QAAQ,UAAA;AAAY,IAClB,KAAK,OAAA;AACH,MAAA,OAAO,EAAE,SAAA,EAAWA,cAAAA,CAAOM,iBAAA,CAAU,KAAA,EAAO,CAAC,CAAA,EAAG,UAAU,CAAA,EAAG,OAAA,EAASN,cAAAA,CAAO,KAAA,EAAO,UAAU,CAAA,EAAE;AAAA,IAClG,KAAK,SAAA;AACH,MAAA,OAAO,EAAE,SAAA,EAAWA,cAAAA,CAAOM,iBAAA,CAAU,KAAA,EAAO,CAAC,CAAA,EAAG,UAAU,CAAA,EAAG,OAAA,EAASN,cAAAA,CAAO,KAAA,EAAO,UAAU,CAAA,EAAE;AAAA,IAClG,KAAK,MAAA;AACH,MAAA,OAAO,EAAE,SAAA,EAAWA,cAAAA,CAAOO,gBAAA,CAAS,KAAA,EAAO,CAAC,CAAA,EAAG,UAAU,CAAA,EAAG,OAAA,EAASP,cAAAA,CAAO,KAAA,EAAO,UAAU,CAAA,EAAE;AAAA,IACjG,KAAK,MAAA;AAAA,IACL;AACE,MAAA,OAAO,EAAE,SAAA,EAAWA,cAAAA,CAAOQ,eAAA,CAAQ,KAAA,EAAO,CAAC,CAAA,EAAG,UAAU,CAAA,EAAG,OAAA,EAASR,cAAAA,CAAO,KAAA,EAAO,UAAU,CAAA,EAAE;AAAA;AAEpG;AAGO,SAAS,iBAAiB,IAAA,EAA4C;AAC3E,EAAA,MAAM,EAAA,GAAA,iBAAK,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAClC,EAAA,MAAM,IAAA,GAAO,IAAI,IAAA,CAAK,IAAA,CAAK,KAAI,GAAI,IAAA,GAAO,KAAU,CAAA,CAAE,WAAA,EAAY;AAClE,EAAA,OAAO,EAAE,MAAM,EAAA,EAAG;AACpB;AAOO,SAAS,oBAAA,CAAqB,KAAA,mBAAc,IAAI,IAAA,EAAK,EAA2C;AACrG,EAAA,MAAM,IAAA,GAAO,MAAM,cAAA,EAAe;AAClC,EAAA,MAAM,KAAA,GAAQ,MAAM,WAAA,EAAY;AAChC,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,IAAI,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,MAAM,KAAA,EAAO,CAAC,CAAC,CAAA,CAAE,WAAA,EAAY;AAAA,IACxD,SAAA,EAAW,IAAI,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,IAAA,EAAM,KAAA,GAAQ,CAAA,EAAG,CAAC,CAAC,CAAA,CAAE,WAAA;AAAY,GAChE;AACF;AAUO,SAAS,wBAAwB,IAAA,EAA6B;AACnE,EAAA,IAAI;AACF,IAAA,MAAM,KAAA,GAAQ,IAAI,IAAA,CAAK,cAAA,CAAe,IAAA,EAAM;AAAA,MAC1C,QAAA,EAAU,IAAA;AAAA,MACV,YAAA,EAAc;AAAA,KACf,CAAA,CAAE,aAAA,iBAAc,IAAI,MAAM,CAAA;AAC3B,IAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,CAAC,MAAM,CAAA,CAAE,IAAA,KAAS,cAAc,CAAA,EAAG,KAAA,IAAS,EAAA;AACrE,IAAA,IAAI,KAAA,KAAU,KAAA,IAAS,KAAA,KAAU,KAAA,EAAO,OAAO,CAAA;AAC/C,IAAA,MAAM,CAAA,GAAI,KAAA,CAAM,KAAA,CAAM,0BAA0B,CAAA;AAChD,IAAA,IAAI,CAAC,GAAG,OAAO,IAAA;AACf,IAAA,MAAM,IAAA,GAAO,CAAA,CAAE,CAAC,CAAA,KAAM,MAAM,CAAA,GAAI,CAAA,CAAA;AAChC,IAAA,OAAO,IAAA,IAAQ,QAAA,CAAS,CAAA,CAAE,CAAC,CAAA,EAAG,EAAE,CAAA,GAAI,EAAA,GAAK,QAAA,CAAS,CAAA,CAAE,CAAC,CAAA,EAAG,EAAE,CAAA,CAAA;AAAA,EAC5D,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF","file":"index.cjs","sourcesContent":["/**\n * Shared date/time format tokens (date-fns syntax).\n *\n * These are the canonical formats used across the EthisysCore monolith and\n * plugins. Change a value here for a global locale requirement rather than\n * hardcoding a format string at a call site.\n */\n\n/** ISO wire format `yyyy-MM-dd` — the standard date-only format throughout the app. */\nexport const DATE_FORMAT = \"yyyy-MM-dd\";\n\n/** Audit-log timestamp, e.g. `5 March 2026, 14:30`. */\nexport const AUDIT_DATE_FORMAT = \"d MMMM yyyy, HH:mm\";\n\n/** User-facing date display, e.g. `5 Mar 2026`. */\nexport const DISPLAY_DATE_FORMAT = \"d MMM yyyy\";\n\n/** Weekday + day + month, e.g. `Monday, 5 March`. */\nexport const DAY_DATE_FORMAT = \"EEEE, d MMMM\";\n\n/** Abbreviated day + month, e.g. `Mar 5`. */\nexport const DAY_MONTH_FORMAT = \"MMM d\";\n\n/** Abbreviated day + month + year, e.g. `Mar 5, 2026`. */\nexport const DAY_MONTH_YEAR_FORMAT = \"MMM d, yyyy\";\n\n/** 12-hour time, e.g. `2:30 PM`. */\nexport const TIME_FORMAT = \"h:mm a\";\n\n/** Short datetime, e.g. `Mar 5, 2:30 PM`. */\nexport const SHORT_DATETIME_FORMAT = \"MMM d, h:mm a\";\n","import { format, isValid } from \"date-fns\";\n\nimport { DATE_FORMAT } from \"./constants\";\n\n/** Type guard: is `value` a bare `yyyy-MM-dd` date-only string? */\nexport const isDateOnlyString = (value: unknown): value is string => {\n  return typeof value === \"string\" && /^\\d{4}-\\d{2}-\\d{2}$/.test(value);\n};\n\n/**\n * Formats a `Date`, defaulting to the standard application ISO date format\n * (`yyyy-MM-dd`). Pass `dateFormat` to override.\n */\nexport const formatDate = (date: Date, dateFormat: string = DATE_FORMAT): string => {\n  return format(date, dateFormat);\n};\n\n/** Today's date as a `yyyy-MM-dd` ISO string (local calendar day). */\nexport const getTodayIsoDate = (): string => {\n  return formatDate(new Date());\n};\n\n/** First day of the given date's month, as a `yyyy-MM-dd` ISO string. */\nexport const getMonthStartIso = (date: Date): string =>\n  formatDate(new Date(date.getFullYear(), date.getMonth(), 1));\n\n/** Last day of the given date's month, as a `yyyy-MM-dd` ISO string. */\nexport const getMonthEndIso = (date: Date): string =>\n  formatDate(new Date(date.getFullYear(), date.getMonth() + 1, 0));\n\n/**\n * Parses a date-only `yyyy-MM-dd` string as a LOCAL date. Returns `null` when\n * the value is not a date-only string or is not a valid calendar date. Avoids\n * the `new Date(\"yyyy-MM-dd\")` UTC parse, which shifts the day in non-UTC zones.\n */\nexport const parseIsoDateLocal = (value: string | null | undefined): Date | null => {\n  if (!value || !isDateOnlyString(value)) return null;\n  const [year, month, day] = value.split(\"-\").map(Number);\n  const d = new Date(year, month - 1, day);\n  return isValid(d) ? d : null;\n};\n\n/**\n * Adds `days` to an ISO `yyyy-MM-dd` date and returns the result as a `yyyy-MM-dd`\n * string. Parses and formats in local time (via `parseIsoDateLocal` / `formatDate`)\n * so the arithmetic can't drift across a day boundary in non-UTC timezones/DST.\n * Returns the input unchanged when it is not a valid date-only string.\n */\nexport const addDaysToIsoDate = (isoDate: string, days: number): string => {\n  const base = parseIsoDateLocal(isoDate);\n  if (!base) return isoDate;\n  base.setDate(base.getDate() + days);\n  return formatDate(base);\n};\n\n/**\n * Extracts a date-only string (`yyyy-MM-dd`) from a date string.\n * - Date-only strings (`2024-05-15`) are returned as-is.\n * - ISO datetime strings (`2024-05-15T00:00:00+05:30`) have the date portion\n *   extracted directly from the string to preserve the original calendar date\n *   without timezone conversion.\n * - Returns empty string for null, undefined, or unparseable values.\n */\nexport const toDateOnlyString = (value: string | null | undefined): string => {\n  if (!value) return \"\";\n  // Extract the yyyy-MM-dd portion before the \"T\" separator to avoid timezone\n  // conversion that can shift the date by a day.\n  const datepart = value.split(\"T\")[0];\n  return isDateOnlyString(datepart) ? datepart : \"\";\n};\n","import { format, isValid, parseISO } from \"date-fns\";\n\nimport { DATE_FORMAT } from \"./constants\";\nimport { formatDate, isDateOnlyString } from \"./iso\";\n\n/**\n * Formats a date string, defaulting to the standard application format\n * (`yyyy-MM-dd`). Uses `parseISO` to safely handle ISO strings. Pass\n * `dateFormat` to override. Returns `\"-\"` for empty, missing, or unparseable\n * input rather than throwing.\n */\nexport const formatDateString = (date?: string | null, dateFormat: string = DATE_FORMAT): string => {\n  if (!date) return \"-\";\n  const parsed = parseISO(date);\n  if (!isValid(parsed)) return \"-\";\n  return format(parsed, dateFormat);\n};\n\n/**\n * Safely formats a date string or `Date`. Handles null, undefined, and invalid\n * dates by returning a fallback string.\n * @param date - The date to format (string, Date, null, or undefined)\n * @param formatStr - The desired output format (defaults to `DATE_FORMAT`)\n * @param fallback - Returned when the date is invalid or missing (defaults to `\"—\"`)\n */\nexport const formatDateSafe = (\n  date: string | Date | null | undefined,\n  formatStr: string = DATE_FORMAT,\n  fallback: string = \"—\",\n): string => {\n  if (!date) return fallback;\n  try {\n    const dateObj = typeof date === \"string\" ? parseISO(date) : date;\n    if (!isValid(dateObj)) return fallback;\n    return format(dateObj, formatStr);\n  } catch {\n    return fallback;\n  }\n};\n\n/** Returns the ordinal suffix for a day of month (`st`, `nd`, `rd`, `th`). */\nconst getOrdinalSuffix = (day: number): string => {\n  if (day > 3 && day < 21) return \"th\";\n  switch (day % 10) {\n    case 1:\n      return \"st\";\n    case 2:\n      return \"nd\";\n    case 3:\n      return \"rd\";\n    default:\n      return \"th\";\n  }\n};\n\n/**\n * Formats a date string or `Date` to a format like `31st Aug 2025`.\n * Handles date-only strings (`yyyy-MM-dd`) as local dates to avoid timezone shifts.\n * @param date - Date string (`yyyy-MM-dd`) or `Date`\n * @returns Formatted date string with ordinal suffix\n */\nexport const formatDateWithOrdinal = (date: string | Date | null | undefined): string => {\n  if (!date) return \"Not specified\";\n\n  let dateObj: Date;\n  if (typeof date === \"string\") {\n    if (isDateOnlyString(date)) {\n      const [year, month, day] = date.split(\"-\").map(Number);\n      dateObj = new Date(year, month - 1, day);\n    } else {\n      dateObj = parseISO(date);\n    }\n  } else {\n    dateObj = date;\n  }\n\n  if (!isValid(dateObj)) return \"Invalid date\";\n\n  const day = dateObj.getDate();\n  const month = format(dateObj, \"MMM\");\n  const year = dateObj.getFullYear();\n  return `${day}${getOrdinalSuffix(day)} ${month} ${year}`;\n};\n\n/**\n * Formats a date as a relative time string (e.g. `2h ago`, `Just now`).\n * Optimised for short labels in dropdowns; anything older than a week falls\n * back to the standard date format.\n * @param date - ISO string or `Date`\n */\nexport const formatTimeAgo = (date: string | Date | null | undefined): string => {\n  if (!date) return \"\";\n\n  const dateObj = typeof date === \"string\" ? parseISO(date) : date;\n  if (!isValid(dateObj)) return \"\";\n\n  const now = new Date();\n  const seconds = Math.floor((now.getTime() - dateObj.getTime()) / 1000);\n\n  // Future dates (shouldn't normally happen, but safety first).\n  if (seconds < 60) return \"Just now\";\n\n  const minutes = Math.floor(seconds / 60);\n  if (minutes < 60) return `${minutes}m ago`;\n\n  const hours = Math.floor(minutes / 60);\n  if (hours < 24) return `${hours}h ago`;\n\n  const days = Math.floor(hours / 24);\n  if (days < 7) return `${days}d ago`;\n\n  return formatDate(dateObj);\n};\n","/**\n * Pure duration / timespan helpers — no external dependencies.\n *\n * Cover the two duration shapes that flow across the EthisysCore wire: a\n * `\"HH:mm:ss\"` timespan string (.NET `TimeSpan`) and a millisecond count.\n */\n\n/** Converts a `\"HH:mm:ss\"` timespan string to milliseconds. */\nexport const timespanToMilliseconds = (timespan: string): number => {\n  if (!timespan) return 0;\n\n  const [h = \"0\", m = \"0\", s = \"0\"] = timespan.split(\":\");\n  const hours = parseInt(h || \"0\", 10);\n  const minutes = parseInt(m || \"0\", 10);\n  const seconds = parseInt(s || \"0\", 10);\n\n  return (\n    (isNaN(hours) ? 0 : hours) * 60 * 60 * 1000 +\n    (isNaN(minutes) ? 0 : minutes) * 60 * 1000 +\n    (isNaN(seconds) ? 0 : seconds) * 1000\n  );\n};\n\n/** Converts milliseconds to hours (as a float). */\nexport const millisecondsToHours = (ms: number): number => ms / (1000 * 60 * 60);\n\n/** Converts hours to milliseconds. */\nexport const hoursToMilliseconds = (hours: number): number => hours * (1000 * 60 * 60);\n\n/** Formats a milliseconds count as `4h 15min`. */\nexport const formatMillisecondsAsTimeSpent = (ms: number): string => {\n  if (!ms || ms < 0) return \"0h 0min\";\n\n  const totalMinutes = Math.floor(ms / (1000 * 60));\n  const hours = Math.floor(totalMinutes / 60);\n  const minutes = totalMinutes % 60;\n\n  let result = \"\";\n  if (hours > 0) result += `${hours}h`;\n  if (minutes > 0 || hours === 0) result += (hours > 0 ? \" \" : \"\") + `${minutes}min`;\n  return result;\n};\n\n/** Formats a `\"HH:mm:ss\"` duration string as human readable (e.g. `2h 30m 0s`). */\nexport function formatDuration(duration?: string): string {\n  if (!duration) return \"-\";\n  const [hours, minutes, seconds] = duration.split(\":\").map(Number);\n  let result = \"\";\n  if (hours) result += `${hours}h`;\n  if (minutes) result += (result ? \" \" : \"\") + `${minutes}m`;\n  if (seconds) result += (result ? \" \" : \"\") + `${seconds}s`;\n  return result || \"0m\";\n}\n\n/**\n * Formats a fractional-hours number as a compact human-readable duration\n * (`45m`, `2h 30m`, `3d 4h`). Defensively caps unreasonable values.\n */\nexport const formatDurationNumber = (durationHours?: number | null): string => {\n  if (durationHours == null || durationHours === 0) return \"—\";\n\n  // Defensive: cap at a reasonable max (1 year = 8760 hours).\n  if (durationHours > 8760) return \"Unknown\";\n  // Negative duration is also suspicious.\n  if (durationHours < 0) return \"Error\";\n\n  const hours = Math.floor(durationHours);\n  const minutes = Math.floor((durationHours % 1) * 60);\n\n  if (durationHours < 1) return `${minutes}m`;\n\n  if (hours < 24) {\n    if (minutes === 0) return `${hours}h`;\n    return `${hours}h ${minutes}m`;\n  }\n\n  const days = Math.floor(hours / 24);\n  const remainingHours = hours % 24;\n  if (remainingHours === 0) return `${days}d`;\n  return `${days}d ${remainingHours}h`;\n};\n\n/**\n * Trims an API-supplied `\"HH:mm:ss\"` down to the `\"HH:mm\"` string used by\n * MUI `TimePicker`-backed forms. Returns the supplied fallback when the value\n * is missing or shorter than five characters.\n */\nexport function toHHmm(value: string | null | undefined, fallback: string): string {\n  if (!value || value.length < 5) return fallback;\n  return value.slice(0, 5);\n}\n\n/**\n * Serialises a non-empty `\"HH:mm\"` / `\"HH:mm:ss\"` value back to the canonical\n * `\"HH:mm:ss\"` API format. Returns `null` for empty input so callers can block\n * the save rather than silently persisting midnight — an empty TimePicker\n * (cleared via keyboard) is an unsaved edit, not a legitimate `00:00:00` value.\n */\nexport function toHHmmss(value: string): string | null {\n  const trimmed = value.trim();\n  if (!trimmed) return null;\n  return trimmed.length === 5 ? `${trimmed}:00` : trimmed;\n}\n","import { format, isValid } from \"date-fns\";\n\n// ---------------------------------------------------------------------------\n// Wire-boundary helpers\n// ---------------------------------------------------------------------------\n//\n// HTML's `<input type=\"date\">` and `<input type=\"datetime-local\">` emit naive\n// local strings with NO timezone suffix. Sending those raw to a .NET backend\n// that deserialises into `DateTimeOffset` parses them using the BE process's\n// local offset (UTC on most container hosts), silently misinterpreting the\n// user's wall-clock as UTC and shifting the stored timestamp by the user's\n// offset (e.g. losing the first hour of the local day during BST). These\n// helpers bridge cleanly between the input shapes and full ISO-8601 UTC.\n//\n// All are pure and timezone-aware via the runtime `Date` object.\n\n/** Converts an ISO date string to date-input format (`yyyy-MM-dd`). */\nexport const isoToDateInput = (isoString: string | undefined): string => {\n  if (!isoString) return \"\";\n  try {\n    return new Date(isoString).toISOString().split(\"T\")[0];\n  } catch {\n    return \"\";\n  }\n};\n\n/** Converts date-input format (`yyyy-MM-dd`) to a UTC ISO string at midnight UTC. */\nexport const dateInputToIso = (dateString: string): string => {\n  if (!dateString) return \"\";\n  const parsed = new Date(dateString + \"T00:00:00Z\");\n  return Number.isNaN(parsed.getTime()) ? \"\" : parsed.toISOString();\n};\n\n/**\n * Normalises a date-only value from `<input type=\"date\">` (`yyyy-MM-dd`) into a\n * canonical UTC ISO-8601 timestamp at midnight UTC, e.g.\n * `2026-07-14` → `2026-07-14T00:00:00.000Z`. Use at the API-payload boundary\n * for fields the BE types as `DateTimeOffset` — a bare date-only string risks\n * ambiguous/failed deserialisation. A value that is already a full ISO\n * timestamp is passed through unchanged. Empty/invalid → `undefined` so callers\n * omit the field (BE clears it).\n */\nexport function dateOnlyToIsoUtc(value: string | null | undefined): string | undefined {\n  if (!value) return undefined;\n  const parsed = value.includes(\"T\") ? new Date(value) : new Date(`${value}T00:00:00Z`);\n  return Number.isNaN(parsed.getTime()) ? undefined : parsed.toISOString();\n}\n\n/**\n * Returns the current local wall-clock as a `yyyy-MM-ddTHH:mm` string — the\n * format an `<input type=\"datetime-local\">` element expects. Minute precision;\n * seconds and timezone deliberately omitted.\n */\nexport function nowLocalDateTimeInputValue(): string {\n  return format(new Date(), \"yyyy-MM-dd'T'HH:mm\");\n}\n\n/**\n * Converts a naive local-time string from `<input type=\"datetime-local\">`\n * (shape `yyyy-MM-ddTHH:mm` or `yyyy-MM-ddTHH:mm:ss`) into a full ISO-8601 UTC\n * string with `Z` suffix that .NET `DateTimeOffset` cannot ambiguously\n * interpret. Empty / undefined inputs pass through as `undefined`.\n */\nexport function localDateTimeInputToIsoUtc(value: string | null | undefined): string | undefined {\n  if (!value) return undefined;\n  const parsed = new Date(value);\n  if (!isValid(parsed)) return undefined;\n  return parsed.toISOString();\n}\n\n/**\n * Ensures an ISO-8601 string is treated as UTC by appending a `Z` suffix when\n * no explicit offset or UTC indicator is present. The backend may emit\n * timestamps like `2026-05-26T06:21:00` (no Z), which JS would otherwise parse\n * as local time.\n */\nexport function ensureUtcIso(value: string): string {\n  return /[Zz]|[+-]\\d{2}:?\\d{2}$/.test(value) ? value : value + \"Z\";\n}\n\n/**\n * Converts an ISO-8601 string (with or without explicit offset) into the naive\n * local-time shape `yyyy-MM-ddTHH:mm` expected by `<input type=\"datetime-local\">`.\n * Returns the supplied fallback (default empty string) when the input is\n * missing or unparseable. When `value` carries no offset or `Z` suffix it is\n * treated as UTC before converting to local time, so the edit form displays the\n * correct time regardless of the user's timezone.\n */\nexport function isoUtcToLocalDateTimeInput(value: string | null | undefined, fallback = \"\"): string {\n  if (!value) return fallback;\n  const parsed = new Date(ensureUtcIso(value));\n  if (!isValid(parsed)) return fallback;\n  return format(parsed, \"yyyy-MM-dd'T'HH:mm\");\n}\n","import { format, subDays, subMonths, subYears } from \"date-fns\";\n\nimport { DATE_FORMAT } from \"./constants\";\n\nexport interface DateRange {\n  startDate: string;\n  endDate: string;\n}\n\n/**\n * Returns a `{ startDate, endDate }` date range for a named relative period,\n * formatted with `dateFormat` (defaults to the ISO date-only format). Unknown\n * periods fall back to the last week.\n * @param timePeriod - one of `week` | `month` | `quarter` | `year`\n * @param dateFormat - output format for both bounds (defaults to `DATE_FORMAT`)\n */\nexport const getDateRange = (timePeriod: string, dateFormat: string = DATE_FORMAT): DateRange => {\n  const today = new Date();\n  switch (timePeriod) {\n    case \"month\":\n      return { startDate: format(subMonths(today, 1), dateFormat), endDate: format(today, dateFormat) };\n    case \"quarter\":\n      return { startDate: format(subMonths(today, 3), dateFormat), endDate: format(today, dateFormat) };\n    case \"year\":\n      return { startDate: format(subYears(today, 1), dateFormat), endDate: format(today, dateFormat) };\n    case \"week\":\n    default:\n      return { startDate: format(subDays(today, 7), dateFormat), endDate: format(today, dateFormat) };\n  }\n};\n\n/** Computes an ISO timestamp range from a number of days back to now. */\nexport function computeDateRange(days: number): { from: string; to: string } {\n  const to = new Date().toISOString();\n  const from = new Date(Date.now() - days * 86_400_000).toISOString();\n  return { from, to };\n}\n\n/**\n * Returns the current calendar month as a half-open UTC range `[fromUtc, beforeUtc)`,\n * suitable for \"this month\" count filters. `fromUtc` is the first instant of the\n * month; `beforeUtc` is the first instant of the next month (exclusive).\n */\nexport function currentMonthRangeUtc(today: Date = new Date()): { fromUtc: string; beforeUtc: string } {\n  const year = today.getUTCFullYear();\n  const month = today.getUTCMonth();\n  return {\n    fromUtc: new Date(Date.UTC(year, month, 1)).toISOString(),\n    beforeUtc: new Date(Date.UTC(year, month + 1, 1)).toISOString(),\n  };\n}\n\n/**\n * Computes the current UTC-offset minutes for a given IANA zone name using the\n * runtime's `Intl` implementation. Returns `null` when the zone is unknown.\n *\n * Used by timezone auto-populate fallbacks so a browser reporting an IANA zone\n * that isn't in the backend seed (e.g. `Europe/London` during BST) can still\n * match against a seeded zone sharing the same current offset.\n */\nexport function getCurrentOffsetMinutes(iana: string): number | null {\n  try {\n    const parts = new Intl.DateTimeFormat(\"en\", {\n      timeZone: iana,\n      timeZoneName: \"longOffset\",\n    }).formatToParts(new Date());\n    const label = parts.find((p) => p.type === \"timeZoneName\")?.value ?? \"\";\n    if (label === \"GMT\" || label === \"UTC\") return 0;\n    const m = label.match(/GMT([+-])(\\d{2}):(\\d{2})/);\n    if (!m) return null;\n    const sign = m[1] === \"+\" ? 1 : -1;\n    return sign * (parseInt(m[2], 10) * 60 + parseInt(m[3], 10));\n  } catch {\n    return null;\n  }\n}\n"]}