@mt-gloss/utils 0.0.9 → 0.0.11

package/formatting-dHqp6ksD.js

@@ -0,0 +1,436 @@
+import { startOfMonth as Y, startOfYear as p, subYears as k, endOfYear as q, startOfQuarter as V, subDays as u, startOfDay as Q, endOfDay as H } from "date-fns";
+const j = [
+  // Rolling periods (most specific first)
+  { id: "today", label: "Today", priority: 100 },
+  { id: "7d", label: "7D", priority: 90 },
+  { id: "30d", label: "30D", priority: 89 },
+  { id: "60d", label: "60D", priority: 88 },
+  { id: "90d", label: "90D", priority: 87 },
+  // To-date periods
+  { id: "mtd", label: "MTD", priority: 80 },
+  { id: "qtd", label: "QTD", priority: 79 },
+  { id: "ytd", label: "YTD", priority: 78 },
+  { id: "lytd", label: "LYTD", priority: 77 },
+  // Calendar periods (full periods)
+  { id: "this-week", label: "This Week", priority: 70 },
+  { id: "last-week", label: "Last Week", priority: 69 },
+  { id: "this-month", label: "This Month", priority: 68 },
+  { id: "last-month", label: "Last Month", priority: 67 },
+  { id: "this-quarter", label: "This Quarter", priority: 66 },
+  { id: "last-quarter", label: "Last Quarter", priority: 65 },
+  { id: "this-year", label: "This Year", priority: 64 },
+  { id: "last-year", label: "Last Year", priority: 63 }
+];
+function g(e, r) {
+  return e.getFullYear() === r.getFullYear() && e.getMonth() === r.getMonth() && e.getDate() === r.getDate();
+}
+function M(e, r, t = /* @__PURE__ */ new Date(), a = []) {
+  const s = new Date(t);
+  s.setHours(0, 0, 0, 0);
+  const n = new Date(e);
+  n.setHours(0, 0, 0, 0);
+  const i = new Date(r);
+  i.setHours(0, 0, 0, 0);
+  const l = [
+    ...j,
+    ...a.map((o) => ({ ...o, priority: o.priority ?? 50 }))
+  ].sort((o, c) => c.priority - o.priority);
+  for (const o of l) {
+    if (o.startDate && o.endDate) {
+      const d = new Date(o.startDate);
+      d.setHours(0, 0, 0, 0);
+      const D = new Date(o.endDate);
+      if (D.setHours(0, 0, 0, 0), g(n, d) && g(i, D))
+        return { id: o.id, label: o.label };
+      continue;
+    }
+    const c = F(o.id, s);
+    if (c && g(n, c.start) && g(i, c.end))
+      return { id: o.id, label: o.label };
+  }
+  return null;
+}
+function K(e, r, t = /* @__PURE__ */ new Date(), a = {}) {
+  const {
+    preferPresetLabel: s = !0,
+    showPresetDates: n = !1,
+    customPresets: i = []
+  } = a, l = y(e, r, t);
+  if (!s)
+    return l;
+  const o = M(e, r, t, i);
+  return o ? n ? `${o.label} (${l})` : o.label : l;
+}
+function Z(e, r, t = /* @__PURE__ */ new Date(), a = []) {
+  const s = y(e, r, t), n = M(e, r, t, a);
+  return {
+    display: n ? n.label : s,
+    formatted: s,
+    preset: n
+  };
+}
+const $ = "’";
+function B(e) {
+  const r = e.getFullYear(), t = String(r).slice(-2);
+  return `${$}${t}`;
+}
+function J(e) {
+  if (e == null || e === "") return e;
+  if (/^\d+$/.test(e)) {
+    const r = e.replace(/^0+/, "");
+    return r === "" ? "0" : r;
+  }
+  return e;
+}
+function y(e, r, t = /* @__PURE__ */ new Date(), a = {}) {
+  const { shortYear: s = !1 } = a, n = t.getFullYear(), i = e.getMonth() + 1, l = e.getDate(), o = e.getFullYear(), c = r.getMonth() + 1, d = r.getDate(), D = r.getFullYear(), I = e.getTime() === r.getTime(), N = i === c && o === D, R = o === D, C = o === n, O = D === n, m = (A, _) => {
+    if (_) return "";
+    const b = String(A).slice(-2);
+    return s ? ` ${$}${b}` : `/${b}`;
+  }, h = m(o, C), f = m(D, O);
+  return I ? `${i}/${l}${h}` : N ? `${i}/${l}–${d}${f}` : R ? `${i}/${l} – ${c}/${d}${f}` : `${i}/${l}${h} – ${c}/${d}${f}`;
+}
+function T(e, r = /* @__PURE__ */ new Date()) {
+  const t = r.getFullYear(), a = e.getMonth() + 1, s = e.getDate(), n = e.getFullYear(), i = n !== t ? `/${String(n).slice(-2)}` : "";
+  return `${a}/${s}${i}`;
+}
+function x(e, r = /* @__PURE__ */ new Date()) {
+  const t = r.getFullYear(), a = Math.floor(t / 100) * 100, s = e.replace(/[\u2013\u2014]/g, "-").trim(), n = s.split(/\s+-\s+/);
+  if (n.length === 2) {
+    const o = w(n[0].trim(), t, a), c = w(n[1].trim(), t, a);
+    return { start: o, end: c };
+  }
+  const i = s.match(/^(\d{1,2})\/(\d{1,2})-(\d{1,2})(?:\/(\d{2}))?$/);
+  if (i) {
+    const o = parseInt(i[1], 10) - 1, c = parseInt(i[2], 10), d = parseInt(i[3], 10), D = i[4] ? a + parseInt(i[4], 10) : t;
+    return {
+      start: new Date(D, o, c),
+      end: new Date(D, o, d)
+    };
+  }
+  const l = w(s, t, a);
+  return { start: l, end: l };
+}
+function w(e, r, t) {
+  const a = e.match(/^(\d{1,2})\/(\d{1,2})(?:\/(\d{2}))?$/);
+  if (!a)
+    throw new Error(`Invalid date format: "${e}"`);
+  const s = parseInt(a[1], 10) - 1, n = parseInt(a[2], 10), i = a[3] ? t + parseInt(a[3], 10) : r;
+  return new Date(i, s, n);
+}
+function tt(e) {
+  try {
+    const r = x(e);
+    return r.start instanceof Date && !isNaN(r.start.getTime()) && r.end instanceof Date && !isNaN(r.end.getTime());
+  } catch {
+    return !1;
+  }
+}
+function U(e, r) {
+  return Math.round((r.getTime() - e.getTime()) / 864e5) + 1;
+}
+function et(e, r) {
+  const t = U(e, r);
+  return t === 1 ? "1 day" : t < 14 ? `${t} days` : t < 60 ? `${Math.round(t / 7)} weeks` : t < 365 ? `${Math.round(t / 30)} months` : `${(t / 365).toFixed(1)} years`;
+}
+function at(e, r = /* @__PURE__ */ new Date()) {
+  const { start: t, end: a } = F(e, r);
+  return { formatted: y(t, a, r), start: t, end: a };
+}
+function F(e, r = /* @__PURE__ */ new Date()) {
+  const t = new Date(r);
+  t.setHours(0, 0, 0, 0);
+  let a = new Date(t), s = new Date(t);
+  switch (e.toLowerCase()) {
+    case "today":
+      break;
+    case "7d":
+      a.setDate(a.getDate() - 6);
+      break;
+    case "30d":
+      a.setDate(a.getDate() - 29);
+      break;
+    case "60d":
+      a.setDate(a.getDate() - 59);
+      break;
+    case "90d":
+      a.setDate(a.getDate() - 89);
+      break;
+    case "mtd": {
+      a = new Date(t.getFullYear(), t.getMonth(), 1);
+      break;
+    }
+    case "qtd": {
+      const n = Math.floor(t.getMonth() / 3);
+      a = new Date(t.getFullYear(), n * 3, 1);
+      break;
+    }
+    case "ytd":
+      a = new Date(t.getFullYear(), 0, 1);
+      break;
+    case "lytd":
+      a = new Date(t.getFullYear() - 1, 0, 1), s = new Date(t.getFullYear() - 1, t.getMonth(), t.getDate());
+      break;
+    case "this-week": {
+      const n = t.getDay();
+      a.setDate(t.getDate() - n);
+      break;
+    }
+    case "last-week": {
+      const n = t.getDay();
+      s.setDate(t.getDate() - n - 1), a = new Date(s), a.setDate(a.getDate() - 6);
+      break;
+    }
+    case "this-month":
+      a = new Date(t.getFullYear(), t.getMonth(), 1), s = new Date(t.getFullYear(), t.getMonth() + 1, 0);
+      break;
+    case "last-month":
+      a = new Date(t.getFullYear(), t.getMonth() - 1, 1), s = new Date(t.getFullYear(), t.getMonth(), 0);
+      break;
+    case "this-quarter": {
+      const n = Math.floor(t.getMonth() / 3);
+      a = new Date(t.getFullYear(), n * 3, 1), s = new Date(t.getFullYear(), n * 3 + 3, 0);
+      break;
+    }
+    case "last-quarter": {
+      const n = Math.floor(t.getMonth() / 3) - 1, i = n < 0 ? t.getFullYear() - 1 : t.getFullYear(), l = n < 0 ? 3 : n;
+      a = new Date(i, l * 3, 1), s = new Date(i, l * 3 + 3, 0);
+      break;
+    }
+    case "this-year":
+      a = new Date(t.getFullYear(), 0, 1), s = new Date(t.getFullYear(), 11, 31);
+      break;
+    case "last-year":
+      a = new Date(t.getFullYear() - 1, 0, 1), s = new Date(t.getFullYear() - 1, 11, 31);
+      break;
+  }
+  return { start: a, end: s };
+}
+const P = [
+  { id: "7d", label: "7D" },
+  { id: "30d", label: "30D" },
+  { id: "60d", label: "60D" },
+  { id: "90d", label: "90D" }
+], L = [
+  { id: "mtd", label: "MTD" },
+  { id: "qtd", label: "QTD" },
+  { id: "ytd", label: "YTD" },
+  { id: "lytd", label: "LYTD" }
+], S = {
+  id: "today",
+  label: "Today"
+}, rt = [
+  // Past events
+  {
+    id: "atlanta-jan",
+    label: "Atlanta Market",
+    startDate: new Date(2026, 0, 7),
+    endDate: new Date(2026, 0, 14),
+    location: "Atlanta, GA"
+  },
+  {
+    id: "dallas-jan",
+    label: "Dallas Total Home",
+    startDate: new Date(2026, 0, 17),
+    endDate: new Date(2026, 0, 22),
+    location: "Dallas, TX"
+  },
+  // Current event (overlaps with today -- Feb 20, 2026)
+  {
+    id: "vegas-feb",
+    label: "Las Vegas Market",
+    startDate: new Date(2026, 1, 15),
+    endDate: new Date(2026, 1, 24),
+    location: "Las Vegas, NV"
+  },
+  // Future events
+  {
+    id: "ny-mar",
+    label: "NY Now Spring",
+    startDate: new Date(2026, 2, 8),
+    endDate: new Date(2026, 2, 12),
+    location: "New York, NY"
+  },
+  {
+    id: "chicago-apr",
+    label: "Chicago Gift Show",
+    startDate: new Date(2026, 3, 18),
+    endDate: new Date(2026, 3, 22),
+    location: "Chicago, IL"
+  }
+], E = {
+  TODAY: "today",
+  MTD: "mtd",
+  QTD: "qtd",
+  YTD: "ytd",
+  LYTD: "lytd",
+  "30D": "30d",
+  "60D": "60d",
+  "90D": "90d",
+  "7D": "7d"
+}, z = Object.fromEntries(
+  Object.entries(E).map(([e, r]) => [r, e])
+);
+function G(e, r = /* @__PURE__ */ new Date()) {
+  const t = e?.toLowerCase(), a = r;
+  let s, n = a;
+  switch (t) {
+    case "today":
+      s = Q(a), n = H(a);
+      break;
+    case "7d":
+      s = u(a, 6), n = a;
+      break;
+    case "30d":
+      s = u(a, 29), n = a;
+      break;
+    case "60d":
+      s = u(a, 59), n = a;
+      break;
+    case "90d":
+      s = u(a, 89), n = a;
+      break;
+    case "mtd":
+      s = Y(a), n = a;
+      break;
+    case "qtd":
+      s = V(a), n = a;
+      break;
+    case "ytd":
+      s = p(a), n = a;
+      break;
+    case "lytd":
+      s = p(k(a, 1)), n = q(k(a, 1));
+      break;
+    default:
+      s = Y(a), n = a;
+  }
+  return { start: s, end: n };
+}
+function W(e) {
+  const r = e?.toLowerCase();
+  if (r === "today")
+    return S;
+  const t = P.find((s) => s.id === r);
+  if (t) return t;
+  const a = L.find((s) => s.id === r);
+  return a || null;
+}
+function nt(e) {
+  if (!e) return "Select...";
+  if (e.toLowerCase() === "custom") return "Custom";
+  const r = W(e);
+  return r ? r.label : e;
+}
+function st(e) {
+  return e ? E[e.toUpperCase()] || e.toLowerCase() : null;
+}
+function ot(e) {
+  return e ? z[e.toLowerCase()] || e.toUpperCase() : null;
+}
+function it() {
+  return [S, ...P, ...L];
+}
+const lt = "mtd";
+function ct(e, r) {
+  const t = e.toLowerCase();
+  return G(t, r ?? /* @__PURE__ */ new Date());
+}
+const v = [
+  {
+    id: "lv-market-26",
+    name: "Las Vegas Market '26",
+    start: new Date(2026, 1, 15),
+    // Feb 15 2026
+    end: new Date(2026, 1, 24),
+    // Feb 24 2026
+    location: "Las Vegas, NV"
+  },
+  {
+    id: "asd-show-26",
+    name: "ASD Show '26",
+    start: new Date(2026, 2, 2),
+    // Mar 2 2026
+    end: new Date(2026, 2, 5),
+    // Mar 5 2026
+    location: "Las Vegas, NV"
+  },
+  // Additional 2026 season events from DEFAULT_MARKET_PRESETS coverage
+  {
+    id: "atlanta-jan-26",
+    name: "Atlanta Market '26",
+    start: new Date(2026, 0, 7),
+    // Jan 7 2026
+    end: new Date(2026, 0, 14),
+    // Jan 14 2026
+    location: "Atlanta, GA"
+  },
+  {
+    id: "dallas-jan-26",
+    name: "Dallas Total Home '26",
+    start: new Date(2026, 0, 17),
+    // Jan 17 2026
+    end: new Date(2026, 0, 22),
+    // Jan 22 2026
+    location: "Dallas, TX"
+  },
+  {
+    id: "ny-now-spring-26",
+    name: "NY Now Spring '26",
+    start: new Date(2026, 2, 8),
+    // Mar 8 2026
+    end: new Date(2026, 2, 12),
+    // Mar 12 2026
+    location: "New York, NY"
+  },
+  {
+    id: "chicago-gift-26",
+    name: "Chicago Gift Show '26",
+    start: new Date(2026, 3, 18),
+    // Apr 18 2026
+    end: new Date(2026, 3, 22),
+    // Apr 22 2026
+    location: "Chicago, IL"
+  }
+];
+function Dt(e) {
+  const r = e.toLowerCase().trim(), t = v.find((a) => a.name.toLowerCase() === r);
+  if (!t)
+    throw new Error(`Unknown event: "${e}"`);
+  return { start: t.start, end: t.end };
+}
+function dt(e, r = "medium") {
+  return r === "short" ? `${e.getMonth() + 1}/${e.getDate()}` : T(e);
+}
+export {
+  rt as D,
+  v as E,
+  L as P,
+  P as R,
+  S as T,
+  Dt as a,
+  K as b,
+  B as c,
+  M as d,
+  J as e,
+  y as f,
+  Z as g,
+  T as h,
+  tt as i,
+  U as j,
+  et as k,
+  at as l,
+  F as m,
+  E as n,
+  z as o,
+  x as p,
+  G as q,
+  ct as r,
+  dt as s,
+  W as t,
+  nt as u,
+  st as v,
+  ot as w,
+  it as x,
+  lt as y
+};

package/index.d.ts

@@ -1,3 +1,4 @@
+export { isStatusModeEnabled, v1_1_status_mode, V1_1_STATUS_MODE_ENV } from './lib/featureFlags';
 export type { PresetDefinition, MarketPreset, DateRange, MarketEvent } from './lib/types';
 export { formatValue, getValueFontSize } from './lib/formatValue';
 export type { FormatValueOptions, FormattedValue } from './lib/formatValue';
@@ -6,4 +7,6 @@ export type { TrendDirection, FormattedTrend } from './lib/formatTrend';
 export { formatDateRange, formatMarketDates, isMarketActive, isSameDay, isInRange, generateMarketId } from './lib/dateHelpers';
 export { detectPreset, formatDateRangeWithPreset, getDateRangeDisplayInfo, formatShortYear, stripLeadingZeros, formatSingleDate, parseDateRange, isValidDateRangeFormat, getDurationDays, formatDuration, formatPreset, getPresetDateRange, formatDateRange as formatDateRangeSmart } from './lib/smartDateFormat';
 export { ROLLING_OPTIONS, PERIOD_OPTIONS, TODAY_PRESET, DEFAULT_MARKET_PRESETS, PRESET_ID_MAP, PRESET_ID_REVERSE_MAP, getDateRangeForPreset, findPreset, getPresetLabel, normalizePresetId, toUppercasePresetId, getAllPresets, DEFAULT_PINNED } from './lib/presets';
+export { resolvePreset, resolveEvent, smartDateFormat } from './lib/dateInterpretation';
+export type { PresetId, EventRegistryEntry } from './lib/dateInterpretation';
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -1,418 +1,99 @@
-import { startOfMonth as w, startOfYear as p, subYears as Y, endOfYear as _, startOfQuarter as U, subDays as d, startOfDay as q, endOfDay as Q } from "date-fns";
-function G(t, { prefix: r = "", suffix: e = "", abbreviated: a = !0, kThreshold: o = 1e3 } = {}) {
+import { D as R, y, P as F, n as L, o as I, R as U, T as A, d as O, t as b, f as N, b as v, k as V, l as Y, c as G, h as k, x, g as z, q as K, j, m as q, u as B, i as C, v as W, p as X, a as Z, r as H, s as J, e as Q, w } from "./formatting-dHqp6ksD.js";
+const c = "NEXT_PUBLIC_V1_1_STATUS_MODE";
+function g() {
+  return typeof globalThis < "u" && globalThis.__GLOSS_FLAGS__?.v1_1_status_mode === !0 ? !0 : typeof process < "u" && process.env ? process.env[c] === "true" : !1;
+}
+const D = {
+  env: c,
+  check: g
+};
+function $(t, { prefix: e = "", suffix: n = "", abbreviated: r = !0, kThreshold: s = 1e3 } = {}) {
   if (t == null) {
-    const u = r ? `${r} —${e}` : `—${e}`;
+    const u = e ? `${e} —${n}` : `—${n}`;
     return { display: u.trim(), full: u.trim(), length: u.trim().length };
   }
-  const n = typeof t == "number" ? t : parseFloat(String(t).replace(/,/g, ""));
-  if (isNaN(n)) {
-    const c = `${r}${t}${e}`;
-    return { display: c, full: c, length: c.length };
+  const a = typeof t == "number" ? t : parseFloat(String(t).replace(/,/g, ""));
+  if (isNaN(a)) {
+    const l = `${e}${t}${n}`;
+    return { display: l, full: l, length: l.length };
   }
-  let s;
-  a !== !1 && Math.abs(n) >= 1e6 ? s = (n / 1e6).toFixed(1).replace(/\.0$/, "") + "M" : a !== !1 && Math.abs(n) >= o ? s = (n / 1e3).toFixed(1).replace(/\.0$/, "") + "K" : s = n.toLocaleString("en-US");
-  const l = `${r}${s}${e}`, i = `${r}${n.toLocaleString("en-US")}${e}`;
-  return { display: l, full: i, length: l.length };
+  let o;
+  r !== !1 && Math.abs(a) >= 1e6 ? o = (a / 1e6).toFixed(1).replace(/\.0$/, "") + "M" : r !== !1 && Math.abs(a) >= s ? o = (a / 1e3).toFixed(1).replace(/\.0$/, "") + "K" : o = a.toLocaleString("en-US");
+  const i = `${e}${o}${n}`, f = `${e}${a.toLocaleString("en-US")}${n}`;
+  return { display: i, full: f, length: i.length };
 }
-function K(t, r) {
-  return (r ?? 1) >= 2 ? t <= 4 || t <= 6 ? 30 : t <= 8 ? 24 : 20 : t <= 5 ? 28 : t <= 8 ? 20 : 17;
+function m(t, e) {
+  return (e ?? 1) >= 2 ? t <= 4 || t <= 6 ? 30 : t <= 8 ? 24 : 20 : t <= 5 ? 28 : t <= 8 ? 20 : 17;
 }
-function X(t) {
+function S(t) {
   if (t == null || t === 0)
     return { text: "0%", direction: "flat" };
-  const r = t > 0 ? "up" : t < 0 ? "down" : "flat", e = Math.abs(t);
-  return { text: e >= 3 ? `${Math.round(e)}%` : `${e.toFixed(1)}%`, direction: r };
+  const e = t > 0 ? "up" : t < 0 ? "down" : "flat", n = Math.abs(t);
+  return { text: n >= 3 ? `${Math.round(n)}%` : `${n.toFixed(1)}%`, direction: e };
 }
-function Z(t, r) {
-  if (!t || !r) return "";
-  const e = t.toLocaleDateString("en-US", { month: "short" }), a = r.toLocaleDateString("en-US", { month: "short" }), o = t.getDate(), n = r.getDate(), s = t.getFullYear(), l = r.getFullYear();
-  return t.getTime() === r.getTime() || e === a && o === n && s === l ? `${e} ${o}, ${s}` : e === a && s === l ? `${e} ${o}–${n}` : s === l ? `${e} ${o} – ${a} ${n}` : `${e} ${o}, ${s} – ${a} ${n}, ${l}`;
+function h(t, e) {
+  if (!t || !e) return "";
+  const n = t.toLocaleDateString("en-US", { month: "short" }), r = e.toLocaleDateString("en-US", { month: "short" }), s = t.getDate(), a = e.getDate(), o = t.getFullYear(), i = e.getFullYear();
+  return t.getTime() === e.getTime() || n === r && s === a && o === i ? `${n} ${s}, ${o}` : n === r && o === i ? `${n} ${s}–${a}` : o === i ? `${n} ${s} – ${r} ${a}` : `${n} ${s}, ${o} – ${r} ${a}, ${i}`;
 }
-function B(t, r) {
-  const e = t.toLocaleDateString("en-US", { month: "short" }), a = r.toLocaleDateString("en-US", { month: "short" }), o = t.getDate(), n = r.getDate();
-  return e === a ? `${e} ${o}–${n}` : `${e} ${o} – ${a} ${n}`;
+function _(t, e) {
+  const n = t.toLocaleDateString("en-US", { month: "short" }), r = e.toLocaleDateString("en-US", { month: "short" }), s = t.getDate(), a = e.getDate();
+  return n === r ? `${n} ${s}–${a}` : `${n} ${s} – ${r} ${a}`;
 }
-function J(t, r = /* @__PURE__ */ new Date()) {
-  return !t?.startDate || !t?.endDate ? !1 : r >= t.startDate && r <= t.endDate;
+function d(t, e = /* @__PURE__ */ new Date()) {
+  return !t?.startDate || !t?.endDate ? !1 : e >= t.startDate && e <= t.endDate;
 }
-function v(t, r) {
-  return !t || !r ? !1 : t.getFullYear() === r.getFullYear() && t.getMonth() === r.getMonth() && t.getDate() === r.getDate();
+function T(t, e) {
+  return !t || !e ? !1 : t.getFullYear() === e.getFullYear() && t.getMonth() === e.getMonth() && t.getDate() === e.getDate();
 }
-function tt(t, r, e) {
-  if (!t || !r || !e) return !1;
-  const a = t.getTime(), o = r.getTime(), n = e.getTime();
-  return a >= Math.min(o, n) && a <= Math.max(o, n);
+function M(t, e, n) {
+  if (!t || !e || !n) return !1;
+  const r = t.getTime(), s = e.getTime(), a = n.getTime();
+  return r >= Math.min(s, a) && r <= Math.max(s, a);
 }
-function et() {
+function P() {
   return `custom-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
 }
-const H = [
-  // Rolling periods (most specific first)
-  { id: "today", label: "Today", priority: 100 },
-  { id: "7d", label: "7D", priority: 90 },
-  { id: "30d", label: "30D", priority: 89 },
-  { id: "60d", label: "60D", priority: 88 },
-  { id: "90d", label: "90D", priority: 87 },
-  // To-date periods
-  { id: "mtd", label: "MTD", priority: 80 },
-  { id: "qtd", label: "QTD", priority: 79 },
-  { id: "ytd", label: "YTD", priority: 78 },
-  { id: "lytd", label: "LYTD", priority: 77 },
-  // Calendar periods (full periods)
-  { id: "this-week", label: "This Week", priority: 70 },
-  { id: "last-week", label: "Last Week", priority: 69 },
-  { id: "this-month", label: "This Month", priority: 68 },
-  { id: "last-month", label: "Last Month", priority: 67 },
-  { id: "this-quarter", label: "This Quarter", priority: 66 },
-  { id: "last-quarter", label: "Last Quarter", priority: 65 },
-  { id: "this-year", label: "This Year", priority: 64 },
-  { id: "last-year", label: "Last Year", priority: 63 }
-];
-function f(t, r) {
-  return t.getFullYear() === r.getFullYear() && t.getMonth() === r.getMonth() && t.getDate() === r.getDate();
-}
-function M(t, r, e = /* @__PURE__ */ new Date(), a = []) {
-  const o = new Date(e);
-  o.setHours(0, 0, 0, 0);
-  const n = new Date(t);
-  n.setHours(0, 0, 0, 0);
-  const s = new Date(r);
-  s.setHours(0, 0, 0, 0);
-  const l = [
-    ...H,
-    ...a.map((i) => ({ ...i, priority: i.priority ?? 50 }))
-  ].sort((i, c) => c.priority - i.priority);
-  for (const i of l) {
-    if (i.startDate && i.endDate) {
-      const u = new Date(i.startDate);
-      u.setHours(0, 0, 0, 0);
-      const D = new Date(i.endDate);
-      if (D.setHours(0, 0, 0, 0), f(n, u) && f(s, D))
-        return { id: i.id, label: i.label };
-      continue;
-    }
-    const c = T(i.id, o);
-    if (c && f(n, c.start) && f(s, c.end))
-      return { id: i.id, label: i.label };
-  }
-  return null;
-}
-function at(t, r, e = /* @__PURE__ */ new Date(), a = {}) {
-  const {
-    preferPresetLabel: o = !0,
-    showPresetDates: n = !1,
-    customPresets: s = []
-  } = a, l = m(t, r, e);
-  if (!o)
-    return l;
-  const i = M(t, r, e, s);
-  return i ? n ? `${i.label} (${l})` : i.label : l;
-}
-function rt(t, r, e = /* @__PURE__ */ new Date(), a = []) {
-  const o = m(t, r, e), n = M(t, r, e, a);
-  return {
-    display: n ? n.label : o,
-    formatted: o,
-    preset: n
-  };
-}
-const S = "’";
-function nt(t) {
-  const r = t.getFullYear(), e = String(r).slice(-2);
-  return `${S}${e}`;
-}
-function ot(t) {
-  if (t == null || t === "") return t;
-  if (/^\d+$/.test(t)) {
-    const r = t.replace(/^0+/, "");
-    return r === "" ? "0" : r;
-  }
-  return t;
-}
-function m(t, r, e = /* @__PURE__ */ new Date(), a = {}) {
-  const { shortYear: o = !1 } = a, n = e.getFullYear(), s = t.getMonth() + 1, l = t.getDate(), i = t.getFullYear(), c = r.getMonth() + 1, u = r.getDate(), D = r.getFullYear(), I = t.getTime() === r.getTime(), R = s === c && i === D, E = i === D, N = i === n, O = D === n, y = (C, A) => {
-    if (A) return "";
-    const b = String(C).slice(-2);
-    return o ? ` ${S}${b}` : `/${b}`;
-  }, $ = y(i, N), g = y(D, O);
-  return I ? `${s}/${l}${$}` : R ? `${s}/${l}–${u}${g}` : E ? `${s}/${l} – ${c}/${u}${g}` : `${s}/${l}${$} – ${c}/${u}${g}`;
-}
-function st(t, r = /* @__PURE__ */ new Date()) {
-  const e = r.getFullYear(), a = t.getMonth() + 1, o = t.getDate(), n = t.getFullYear(), s = n !== e ? `/${String(n).slice(-2)}` : "";
-  return `${a}/${o}${s}`;
-}
-function V(t, r = /* @__PURE__ */ new Date()) {
-  const e = r.getFullYear(), a = Math.floor(e / 100) * 100, o = t.replace(/[\u2013\u2014]/g, "-").trim(), n = o.split(/\s+-\s+/);
-  if (n.length === 2) {
-    const i = h(n[0].trim(), e, a), c = h(n[1].trim(), e, a);
-    return { start: i, end: c };
-  }
-  const s = o.match(/^(\d{1,2})\/(\d{1,2})-(\d{1,2})(?:\/(\d{2}))?$/);
-  if (s) {
-    const i = parseInt(s[1], 10) - 1, c = parseInt(s[2], 10), u = parseInt(s[3], 10), D = s[4] ? a + parseInt(s[4], 10) : e;
-    return {
-      start: new Date(D, i, c),
-      end: new Date(D, i, u)
-    };
-  }
-  const l = h(o, e, a);
-  return { start: l, end: l };
-}
-function h(t, r, e) {
-  const a = t.match(/^(\d{1,2})\/(\d{1,2})(?:\/(\d{2}))?$/);
-  if (!a)
-    throw new Error(`Invalid date format: "${t}"`);
-  const o = parseInt(a[1], 10) - 1, n = parseInt(a[2], 10), s = a[3] ? e + parseInt(a[3], 10) : r;
-  return new Date(s, o, n);
-}
-function it(t) {
-  try {
-    const r = V(t);
-    return r.start instanceof Date && !isNaN(r.start.getTime()) && r.end instanceof Date && !isNaN(r.end.getTime());
-  } catch {
-    return !1;
-  }
-}
-function x(t, r) {
-  return Math.round((r.getTime() - t.getTime()) / 864e5) + 1;
-}
-function lt(t, r) {
-  const e = x(t, r);
-  return e === 1 ? "1 day" : e < 14 ? `${e} days` : e < 60 ? `${Math.round(e / 7)} weeks` : e < 365 ? `${Math.round(e / 30)} months` : `${(e / 365).toFixed(1)} years`;
-}
-function ct(t, r = /* @__PURE__ */ new Date()) {
-  const { start: e, end: a } = T(t, r);
-  return { formatted: m(e, a, r), start: e, end: a };
-}
-function T(t, r = /* @__PURE__ */ new Date()) {
-  const e = new Date(r);
-  e.setHours(0, 0, 0, 0);
-  let a = new Date(e), o = new Date(e);
-  switch (t.toLowerCase()) {
-    case "today":
-      break;
-    case "7d":
-      a.setDate(a.getDate() - 6);
-      break;
-    case "30d":
-      a.setDate(a.getDate() - 29);
-      break;
-    case "60d":
-      a.setDate(a.getDate() - 59);
-      break;
-    case "90d":
-      a.setDate(a.getDate() - 89);
-      break;
-    case "mtd": {
-      a = new Date(e.getFullYear(), e.getMonth(), 1);
-      break;
-    }
-    case "qtd": {
-      const n = Math.floor(e.getMonth() / 3);
-      a = new Date(e.getFullYear(), n * 3, 1);
-      break;
-    }
-    case "ytd":
-      a = new Date(e.getFullYear(), 0, 1);
-      break;
-    case "lytd":
-      a = new Date(e.getFullYear() - 1, 0, 1), o = new Date(e.getFullYear() - 1, e.getMonth(), e.getDate());
-      break;
-    case "this-week": {
-      const n = e.getDay();
-      a.setDate(e.getDate() - n);
-      break;
-    }
-    case "last-week": {
-      const n = e.getDay();
-      o.setDate(e.getDate() - n - 1), a = new Date(o), a.setDate(a.getDate() - 6);
-      break;
-    }
-    case "this-month":
-      a = new Date(e.getFullYear(), e.getMonth(), 1), o = new Date(e.getFullYear(), e.getMonth() + 1, 0);
-      break;
-    case "last-month":
-      a = new Date(e.getFullYear(), e.getMonth() - 1, 1), o = new Date(e.getFullYear(), e.getMonth(), 0);
-      break;
-    case "this-quarter": {
-      const n = Math.floor(e.getMonth() / 3);
-      a = new Date(e.getFullYear(), n * 3, 1), o = new Date(e.getFullYear(), n * 3 + 3, 0);
-      break;
-    }
-    case "last-quarter": {
-      const n = Math.floor(e.getMonth() / 3) - 1, s = n < 0 ? e.getFullYear() - 1 : e.getFullYear(), l = n < 0 ? 3 : n;
-      a = new Date(s, l * 3, 1), o = new Date(s, l * 3 + 3, 0);
-      break;
-    }
-    case "this-year":
-      a = new Date(e.getFullYear(), 0, 1), o = new Date(e.getFullYear(), 11, 31);
-      break;
-    case "last-year":
-      a = new Date(e.getFullYear() - 1, 0, 1), o = new Date(e.getFullYear() - 1, 11, 31);
-      break;
-  }
-  return { start: a, end: o };
-}
-const F = [
-  { id: "7d", label: "7D" },
-  { id: "30d", label: "30D" },
-  { id: "60d", label: "60D" },
-  { id: "90d", label: "90D" }
-], k = [
-  { id: "mtd", label: "MTD" },
-  { id: "qtd", label: "QTD" },
-  { id: "ytd", label: "YTD" },
-  { id: "lytd", label: "LYTD" }
-], P = {
-  id: "today",
-  label: "Today"
-}, ut = [
-  // Past events
-  {
-    id: "atlanta-jan",
-    label: "Atlanta Market",
-    startDate: new Date(2026, 0, 7),
-    endDate: new Date(2026, 0, 14),
-    location: "Atlanta, GA"
-  },
-  {
-    id: "dallas-jan",
-    label: "Dallas Total Home",
-    startDate: new Date(2026, 0, 17),
-    endDate: new Date(2026, 0, 22),
-    location: "Dallas, TX"
-  },
-  // Current event (overlaps with today -- Feb 20, 2026)
-  {
-    id: "vegas-feb",
-    label: "Las Vegas Market",
-    startDate: new Date(2026, 1, 15),
-    endDate: new Date(2026, 1, 24),
-    location: "Las Vegas, NV"
-  },
-  // Future events
-  {
-    id: "ny-mar",
-    label: "NY Now Spring",
-    startDate: new Date(2026, 2, 8),
-    endDate: new Date(2026, 2, 12),
-    location: "New York, NY"
-  },
-  {
-    id: "chicago-apr",
-    label: "Chicago Gift Show",
-    startDate: new Date(2026, 3, 18),
-    endDate: new Date(2026, 3, 22),
-    location: "Chicago, IL"
-  }
-], L = {
-  TODAY: "today",
-  MTD: "mtd",
-  QTD: "qtd",
-  YTD: "ytd",
-  LYTD: "lytd",
-  "30D": "30d",
-  "60D": "60d",
-  "90D": "90d",
-  "7D": "7d"
-}, j = Object.fromEntries(
-  Object.entries(L).map(([t, r]) => [r, t])
-);
-function Dt(t, r = /* @__PURE__ */ new Date()) {
-  const e = t?.toLowerCase(), a = r;
-  let o, n = a;
-  switch (e) {
-    case "today":
-      o = q(a), n = Q(a);
-      break;
-    case "7d":
-      o = d(a, 6), n = a;
-      break;
-    case "30d":
-      o = d(a, 29), n = a;
-      break;
-    case "60d":
-      o = d(a, 59), n = a;
-      break;
-    case "90d":
-      o = d(a, 89), n = a;
-      break;
-    case "mtd":
-      o = w(a), n = a;
-      break;
-    case "qtd":
-      o = U(a), n = a;
-      break;
-    case "ytd":
-      o = p(a), n = a;
-      break;
-    case "lytd":
-      o = p(Y(a, 1)), n = _(Y(a, 1));
-      break;
-    default:
-      o = w(a), n = a;
-  }
-  return { start: o, end: n };
-}
-function z(t) {
-  const r = t?.toLowerCase();
-  if (r === "today")
-    return P;
-  const e = F.find((o) => o.id === r);
-  if (e) return e;
-  const a = k.find((o) => o.id === r);
-  return a || null;
-}
-function dt(t) {
-  if (!t) return "Select...";
-  if (t.toLowerCase() === "custom") return "Custom";
-  const r = z(t);
-  return r ? r.label : t;
-}
-function ft(t) {
-  return t ? L[t.toUpperCase()] || t.toLowerCase() : null;
-}
-function gt(t) {
-  return t ? j[t.toLowerCase()] || t.toUpperCase() : null;
-}
-function ht() {
-  return [P, ...F, ...k];
-}
-const mt = "mtd";
 export {
-  ut as DEFAULT_MARKET_PRESETS,
-  mt as DEFAULT_PINNED,
-  k as PERIOD_OPTIONS,
+  R as DEFAULT_MARKET_PRESETS,
+  y as DEFAULT_PINNED,
+  F as PERIOD_OPTIONS,
   L as PRESET_ID_MAP,
-  j as PRESET_ID_REVERSE_MAP,
-  F as ROLLING_OPTIONS,
-  P as TODAY_PRESET,
-  M as detectPreset,
-  z as findPreset,
-  Z as formatDateRange,
-  m as formatDateRangeSmart,
-  at as formatDateRangeWithPreset,
-  lt as formatDuration,
-  B as formatMarketDates,
-  ct as formatPreset,
-  nt as formatShortYear,
-  st as formatSingleDate,
-  X as formatTrend,
-  G as formatValue,
-  et as generateMarketId,
-  ht as getAllPresets,
-  rt as getDateRangeDisplayInfo,
-  Dt as getDateRangeForPreset,
-  x as getDurationDays,
-  T as getPresetDateRange,
-  dt as getPresetLabel,
-  K as getValueFontSize,
-  tt as isInRange,
-  J as isMarketActive,
-  v as isSameDay,
-  it as isValidDateRangeFormat,
-  ft as normalizePresetId,
-  V as parseDateRange,
-  ot as stripLeadingZeros,
-  gt as toUppercasePresetId
+  I as PRESET_ID_REVERSE_MAP,
+  U as ROLLING_OPTIONS,
+  A as TODAY_PRESET,
+  c as V1_1_STATUS_MODE_ENV,
+  O as detectPreset,
+  b as findPreset,
+  h as formatDateRange,
+  N as formatDateRangeSmart,
+  v as formatDateRangeWithPreset,
+  V as formatDuration,
+  _ as formatMarketDates,
+  Y as formatPreset,
+  G as formatShortYear,
+  k as formatSingleDate,
+  S as formatTrend,
+  $ as formatValue,
+  P as generateMarketId,
+  x as getAllPresets,
+  z as getDateRangeDisplayInfo,
+  K as getDateRangeForPreset,
+  j as getDurationDays,
+  q as getPresetDateRange,
+  B as getPresetLabel,
+  m as getValueFontSize,
+  M as isInRange,
+  d as isMarketActive,
+  T as isSameDay,
+  g as isStatusModeEnabled,
+  C as isValidDateRangeFormat,
+  W as normalizePresetId,
+  X as parseDateRange,
+  Z as resolveEvent,
+  H as resolvePreset,
+  J as smartDateFormat,
+  Q as stripLeadingZeros,
+  w as toUppercasePresetId,
+  D as v1_1_status_mode
 };

package/lib/dateInterpretation/events.d.ts

@@ -0,0 +1,9 @@
+import { EventRegistryEntry, DateRange } from './types';
+export declare const EVENT_REGISTRY: EventRegistryEntry[];
+/**
+ * Resolve an event name to its date range.
+ * Case-insensitive lookup against EVENT_REGISTRY entries by name.
+ * @throws {Error} if no matching event is found
+ */
+export declare function resolveEvent(name: string): DateRange;
+//# sourceMappingURL=events.d.ts.map

package/lib/dateInterpretation/formatting.d.ts

@@ -0,0 +1,18 @@
+import { formatDateRange as _formatDateRange } from '../smartDateFormat';
+import { FormatContext } from './types';
+/**
+ * Re-export formatDateRange from canonical smartDateFormat.
+ * @param start - Start date
+ * @param end - End date
+ * @param referenceDate - Optional reference date (defaults to now)
+ * @returns Human-readable date range string (e.g., "Jan 1 – Jan 31")
+ */
+export { _formatDateRange as formatDateRange };
+/**
+ * Format a single Date to a human-readable string.
+ * @param date - Date to format
+ * @param context - Verbosity context: 'short' | 'medium' | 'long'
+ * @returns Human-readable date string (e.g., "Jan 15", "Jan 15, 2026")
+ */
+export declare function smartDateFormat(date: Date, context?: FormatContext): string;
+//# sourceMappingURL=formatting.d.ts.map

package/lib/dateInterpretation/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @mt-gloss/utils/dateInterpretation
+ *
+ * Canonical module for date interpretation: preset math, event resolution,
+ * and smart formatting. Tree-shakable via subpath import.
+ *
+ * @example
+ * ```typescript
+ * import { resolvePreset, resolveEvent, smartDateFormat, formatDateRange } from '@mt-gloss/utils/dateInterpretation';
+ *
+ * const mtd = resolvePreset('MTD');           // { start: Date, end: Date }
+ * const event = resolveEvent("Las Vegas Market '26");
+ * const label = smartDateFormat(new Date());  // "Apr 16"
+ * ```
+ */
+export { resolvePreset } from './presets';
+export { resolveEvent, EVENT_REGISTRY } from './events';
+export { smartDateFormat, formatDateRange } from './formatting';
+export type { PresetId, DateRange, FormatContext, FormatOpts, EventRegistryEntry } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/dateInterpretation/index.js

@@ -0,0 +1,8 @@
+import { E as s, f as r, a as t, r as o, s as E } from "../../formatting-dHqp6ksD.js";
+export {
+  s as EVENT_REGISTRY,
+  r as formatDateRange,
+  t as resolveEvent,
+  o as resolvePreset,
+  E as smartDateFormat
+};

package/lib/dateInterpretation/presets.d.ts

@@ -0,0 +1,11 @@
+import { PresetId, DateRange } from './types';
+/**
+ * Resolve a preset ID to its { start, end } date range.
+ * @param preset - Preset ID (case-insensitive, e.g., 'MTD', 'mtd', '30D')
+ * @param referenceDate - Reference date (defaults to now)
+ * @returns DateRange with start and end as Date instances
+ *
+ * Unknown preset IDs fall back to MTD (month-to-date) per T-11-03 mitigation.
+ */
+export declare function resolvePreset(preset: PresetId | string, referenceDate?: Date): DateRange;
+//# sourceMappingURL=presets.d.ts.map

package/lib/dateInterpretation/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * dateInterpretation module types
+ *
+ * Local types for the @mt-gloss/utils/dateInterpretation subpath module.
+ * These extend/complement the global types in libs/utils/src/lib/types.ts.
+ */
+/**
+ * Preset union type — canonical IDs (uppercase for API surface, case-insensitive at runtime).
+ * Falls back to MTD for unknown preset IDs (T-11-03 mitigation: document fallback behavior).
+ */
+export type PresetId = 'MTD' | '30D' | '60D' | '90D' | 'QTD' | 'YTD' | 'LYTD' | 'TODAY' | '7D';
+/**
+ * Date range returned by resolver functions.
+ * Both start and end are guaranteed to be valid Date instances.
+ */
+export type DateRange = {
+    start: Date;
+    end: Date;
+};
+/**
+ * Context hint for smartDateFormat — controls verbosity of output string.
+ */
+export type FormatContext = 'short' | 'medium' | 'long';
+/**
+ * Options for formatting functions.
+ */
+export type FormatOpts = {
+    shortYear?: boolean;
+    separator?: string;
+};
+/**
+ * An entry in the hand-authored event registry.
+ */
+export interface EventRegistryEntry {
+    id: string;
+    name: string;
+    start: Date;
+    end: Date;
+    location?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/featureFlags/index.d.ts

@@ -0,0 +1,2 @@
+export { isStatusModeEnabled, v1_1_status_mode, V1_1_STATUS_MODE_ENV } from './v1_1_flags';
+//# sourceMappingURL=index.d.ts.map

package/lib/featureFlags/v1_1_flags.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Phase 10: v1.1 feature flags for Status Mode.
+ *
+ * Flag is OFF by default in production bundles.
+ * Enable via env var (server/build-time) or globalThis override (runtime/test).
+ */
+export declare const V1_1_STATUS_MODE_ENV = "NEXT_PUBLIC_V1_1_STATUS_MODE";
+/**
+ * Returns true when Status Mode rendering is enabled.
+ *
+ * Priority order:
+ * 1. globalThis.__GLOSS_FLAGS__.v1_1_status_mode === true (runtime override / tests)
+ * 2. process.env.NEXT_PUBLIC_V1_1_STATUS_MODE === 'true' (build-time env var)
+ * 3. false (default — flag OFF)
+ */
+export declare function isStatusModeEnabled(): boolean;
+export declare const v1_1_status_mode: {
+    env: string;
+    check: typeof isStatusModeEnabled;
+};
+//# sourceMappingURL=v1_1_flags.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mt-gloss/utils",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "type": "module",
   "publishConfig": {
     "access": "restricted"
@@ -19,11 +19,23 @@
         "default": "./index.js"
       },
       "default": "./index.js"
+    },
+    "./dateInterpretation": {
+      "import": {
+        "types": "./lib/dateInterpretation/index.d.ts",
+        "default": "./lib/dateInterpretation/index.js"
+      },
+      "require": {
+        "types": "./lib/dateInterpretation/index.d.ts",
+        "default": "./lib/dateInterpretation/index.js"
+      },
+      "default": "./lib/dateInterpretation/index.js"
     }
   },
   "files": [
-    "index.js",
-    "index.d.ts",
+    "*.js",
+    "*.d.ts",
+    "lib/**/*.js",
     "lib/**/*.d.ts",
     "README.md"
   ],