@burdenoff/microfe-crewfoundry 2026.1013.1 → 2026.1029.1

package/dist/crewfoundry/utils/dateUtils.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Local-calendar date utilities for the CrewFoundry MFE.
+ *
+ * The native `new Date('YYYY-MM-DD')` constructor parses date-only strings
+ * as UTC midnight, which silently breaks user-facing date math for callers
+ * in non-UTC timezones (a deadline picked as "today" in PST is already
+ * 17-20 hours in the past by local noon). These helpers parse and compare
+ * as local-calendar-day values instead.
+ */
+/**
+ * Parse a YYYY-MM-DD or ISO-8601 timestamp as local-midnight on that
+ * calendar day. Two input shapes are accepted because the same field
+ * can arrive either way depending on the source:
+ *
+ * - 'YYYY-MM-DD' — what the date input sends on save (local calendar day).
+ * - 'YYYY-MM-DDTHH:mm:ss.sssZ' (or with an offset) — what the GraphQL
+ *   server returns for `DateTime` columns (UTC instant).
+ *
+ * For full timestamps we extract the date portion BEFORE constructing the
+ * Date, so a UTC midnight instant displays as the same calendar day in
+ * any timezone (a deadline stored as 2026-09-29T00:00:00Z is meant to be
+ * 2026-09-29, not whatever the user's timezone shifts it to).
+ *
+ * Returns null if the input isn't a well-formed date-only or ISO string,
+ * an unparseable Date, an out-of-range date component (e.g. 2026-02-30),
+ * or an empty value. Callers that want a raw Date back should check the
+ * result.
+ */
+export declare function parseLocalDate(dateStr: string | null | undefined): Date | null;
+/**
+ * Whole-day difference between two dates, compared as local calendar days.
+ *
+ * Both inputs are interpreted at their local midnight. The result is the
+ * signed integer count of calendar days from `from` to `to` (negative if
+ * `to` is earlier). The inputs must already be valid Dates — this helper
+ * does no validity checking; call parseLocalDate first for YYYY-MM-DD
+ * strings.
+ */
+export declare function localDayDiff(from: Date, to: Date): number;
+/**
+ * Local-calendar today as a YYYY-MM-DD string. Recomputed on every call;
+ * callers that need the picker `min` value pass this through a prop and
+ * accept that the prop won't refresh across midnight without a re-render
+ * trigger (typing in the form is sufficient in practice).
+ */
+export declare function localTodayString(): string;
+/**
+ * Format an ISO timestamp (or YYYY-MM-DD) as a short local date, e.g.
+ * "Oct 29, 2026". Returns an em dash for empty or unparseable input.
+ */
+export declare function formatDate(value: string | null | undefined): string;
+//# sourceMappingURL=dateUtils.d.ts.map

package/dist/crewfoundry/utils/dateUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateUtils.d.ts","sourceRoot":"","sources":["../../../src/crewfoundry/utils/dateUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAe9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,MAAM,CAIzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAKnE"}

package/dist/crewfoundry/utils/dateUtils.js

@@ -0,0 +1,31 @@
+//#region src/crewfoundry/utils/dateUtils.ts
+function e(e) {
+	if (!e) return null;
+	let t = /^\d{4}-\d{2}-\d{2}/.exec(e);
+	if (!t) return null;
+	let [n, r, i] = t[0].split("-").map((e) => Number(e));
+	if (!Number.isFinite(n) || !Number.isFinite(r) || !Number.isFinite(i)) return null;
+	let a = new Date(n, r - 1, i);
+	return a.getFullYear() !== n || a.getMonth() !== r - 1 || a.getDate() !== i ? null : a;
+}
+function t(e, t) {
+	let n = new Date(e.getFullYear(), e.getMonth(), e.getDate()), r = new Date(t.getFullYear(), t.getMonth(), t.getDate());
+	return Math.round((r.getTime() - n.getTime()) / 864e5);
+}
+function n() {
+	let e = /* @__PURE__ */ new Date();
+	return `${e.getFullYear()}-${String(e.getMonth() + 1).padStart(2, "0")}-${String(e.getDate()).padStart(2, "0")}`;
+}
+function r(e) {
+	if (!e) return "—";
+	let t = new Date(e);
+	return Number.isNaN(t.getTime()) ? "—" : t.toLocaleDateString(void 0, {
+		month: "short",
+		day: "numeric",
+		year: "numeric"
+	});
+}
+//#endregion
+export { r as formatDate, t as localDayDiff, n as localTodayString, e as parseLocalDate };
+
+//# sourceMappingURL=dateUtils.js.map

package/dist/crewfoundry/utils/dateUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateUtils.js","names":[],"sources":["../../../src/crewfoundry/utils/dateUtils.ts"],"sourcesContent":["/**\n * Local-calendar date utilities for the CrewFoundry MFE.\n *\n * The native `new Date('YYYY-MM-DD')` constructor parses date-only strings\n * as UTC midnight, which silently breaks user-facing date math for callers\n * in non-UTC timezones (a deadline picked as \"today\" in PST is already\n * 17-20 hours in the past by local noon). These helpers parse and compare\n * as local-calendar-day values instead.\n */\n\n/**\n * Parse a YYYY-MM-DD or ISO-8601 timestamp as local-midnight on that\n * calendar day. Two input shapes are accepted because the same field\n * can arrive either way depending on the source:\n *\n * - 'YYYY-MM-DD' — what the date input sends on save (local calendar day).\n * - 'YYYY-MM-DDTHH:mm:ss.sssZ' (or with an offset) — what the GraphQL\n *   server returns for `DateTime` columns (UTC instant).\n *\n * For full timestamps we extract the date portion BEFORE constructing the\n * Date, so a UTC midnight instant displays as the same calendar day in\n * any timezone (a deadline stored as 2026-09-29T00:00:00Z is meant to be\n * 2026-09-29, not whatever the user's timezone shifts it to).\n *\n * Returns null if the input isn't a well-formed date-only or ISO string,\n * an unparseable Date, an out-of-range date component (e.g. 2026-02-30),\n * or an empty value. Callers that want a raw Date back should check the\n * result.\n */\nexport function parseLocalDate(dateStr: string | null | undefined): Date | null {\n  if (!dateStr) return null;\n  // Extract the YYYY-MM-DD prefix: handles both date-only inputs and\n  // full ISO timestamps (YYYY-MM-DDTHH:mm:ss...).\n  const dateOnlyMatch = /^\\d{4}-\\d{2}-\\d{2}/.exec(dateStr);\n  if (!dateOnlyMatch) return null;\n  const [year, month, day] = dateOnlyMatch[0].split('-').map((part) => Number(part));\n  if (!Number.isFinite(year) || !Number.isFinite(month) || !Number.isFinite(day)) {\n    return null;\n  }\n  const date = new Date(year, month - 1, day);\n  if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {\n    return null;\n  }\n  return date;\n}\n\n/**\n * Whole-day difference between two dates, compared as local calendar days.\n *\n * Both inputs are interpreted at their local midnight. The result is the\n * signed integer count of calendar days from `from` to `to` (negative if\n * `to` is earlier). The inputs must already be valid Dates — this helper\n * does no validity checking; call parseLocalDate first for YYYY-MM-DD\n * strings.\n */\nexport function localDayDiff(from: Date, to: Date): number {\n  const fromMidnight = new Date(from.getFullYear(), from.getMonth(), from.getDate());\n  const toMidnight = new Date(to.getFullYear(), to.getMonth(), to.getDate());\n  return Math.round((toMidnight.getTime() - fromMidnight.getTime()) / 86_400_000);\n}\n\n/**\n * Local-calendar today as a YYYY-MM-DD string. Recomputed on every call;\n * callers that need the picker `min` value pass this through a prop and\n * accept that the prop won't refresh across midnight without a re-render\n * trigger (typing in the form is sufficient in practice).\n */\nexport function localTodayString(): string {\n  const now = new Date();\n  return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}`;\n}\n\n/**\n * Format an ISO timestamp (or YYYY-MM-DD) as a short local date, e.g.\n * \"Oct 29, 2026\". Returns an em dash for empty or unparseable input.\n */\nexport function formatDate(value: string | null | undefined): string {\n  if (!value) return '—';\n  const date = new Date(value);\n  if (Number.isNaN(date.getTime())) return '—';\n  return date.toLocaleDateString(undefined, { month: 'short', day: 'numeric', year: 'numeric' });\n}\n"],"mappings":";AA6BA,SAAgB,EAAe,GAAiD;AAC9E,KAAI,CAAC,EAAS,QAAO;CAGrB,IAAM,IAAgB,qBAAqB,KAAK,EAAQ;AACxD,KAAI,CAAC,EAAe,QAAO;CAC3B,IAAM,CAAC,GAAM,GAAO,KAAO,EAAc,GAAG,MAAM,IAAI,CAAC,KAAK,MAAS,OAAO,EAAK,CAAC;AAClF,KAAI,CAAC,OAAO,SAAS,EAAK,IAAI,CAAC,OAAO,SAAS,EAAM,IAAI,CAAC,OAAO,SAAS,EAAI,CAC5E,QAAO;CAET,IAAM,IAAO,IAAI,KAAK,GAAM,IAAQ,GAAG,EAAI;AAI3C,QAHI,EAAK,aAAa,KAAK,KAAQ,EAAK,UAAU,KAAK,IAAQ,KAAK,EAAK,SAAS,KAAK,IAC9E,OAEF;;AAYT,SAAgB,EAAa,GAAY,GAAkB;CACzD,IAAM,IAAe,IAAI,KAAK,EAAK,aAAa,EAAE,EAAK,UAAU,EAAE,EAAK,SAAS,CAAC,EAC5E,IAAa,IAAI,KAAK,EAAG,aAAa,EAAE,EAAG,UAAU,EAAE,EAAG,SAAS,CAAC;AAC1E,QAAO,KAAK,OAAO,EAAW,SAAS,GAAG,EAAa,SAAS,IAAI,MAAW;;AASjF,SAAgB,IAA2B;CACzC,IAAM,oBAAM,IAAI,MAAM;AACtB,QAAO,GAAG,EAAI,aAAa,CAAC,GAAG,OAAO,EAAI,UAAU,GAAG,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,OAAO,EAAI,SAAS,CAAC,CAAC,SAAS,GAAG,IAAI;;AAOtH,SAAgB,EAAW,GAA0C;AACnE,KAAI,CAAC,EAAO,QAAO;CACnB,IAAM,IAAO,IAAI,KAAK,EAAM;AAE5B,QADI,OAAO,MAAM,EAAK,SAAS,CAAC,GAAS,MAClC,EAAK,mBAAmB,KAAA,GAAW;EAAE,OAAO;EAAS,KAAK;EAAW,MAAM;EAAW,CAAC"}