@mt-gloss/utils 0.0.3

package/index.d.ts

@@ -0,0 +1,9 @@
+export type { PresetDefinition, MarketPreset, DateRange, MarketEvent } from './lib/types';
+export { formatValue, getValueFontSize } from './lib/formatValue';
+export type { FormatValueOptions, FormattedValue } from './lib/formatValue';
+export { formatTrend } from './lib/formatTrend';
+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';
+//# sourceMappingURL=index.d.ts.map

package/index.js

@@ -0,0 +1,418 @@
+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 } = {}) {
+  if (t == null) {
+    const u = r ? `${r} —${e}` : `—${e}`;
+    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 };
+  }
+  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 };
+}
+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 X(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 };
+}
+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 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 J(t, r = /* @__PURE__ */ new Date()) {
+  return !t?.startDate || !t?.endDate ? !1 : r >= t.startDate && r <= t.endDate;
+}
+function v(t, r) {
+  return !t || !r ? !1 : t.getFullYear() === r.getFullYear() && t.getMonth() === r.getMonth() && t.getDate() === r.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 et() {
+  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,
+  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
+};

package/lib/dateHelpers.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Pure Date Helper Functions
+ *
+ * Extracted from TimeFrame/dateUtils.ts -- contains ONLY pure functions
+ * with zero side effects (no localStorage, no TTL, no window access).
+ *
+ * Side-effect functions (loadPreferences, savePreferences, custom market CRUD)
+ * remain in the app's TimeFrame/dateUtils.ts.
+ */
+/**
+ * Format date range for display
+ * Rules:
+ * - Same day: "Jan 19, 2026"
+ * - Same month: "Jan 1-19"
+ * - Different months, same year: "Jan 1 - Feb 5"
+ * - Different years: "Jan 1, 2025 - Feb 5, 2026"
+ */
+export declare function formatDateRange(start: Date | null, end: Date | null): string;
+/**
+ * Format market dates for display
+ */
+export declare function formatMarketDates(start: Date, end: Date): string;
+/**
+ * Check if a market is currently active
+ */
+export declare function isMarketActive(market: {
+    startDate?: Date;
+    endDate?: Date;
+} | null, referenceDate?: Date): boolean;
+/**
+ * Check if two dates are the same day
+ */
+export declare function isSameDay(date1: Date | null, date2: Date | null): boolean;
+/**
+ * Check if a date is within a range
+ */
+export declare function isInRange(date: Date | null, start: Date | null, end: Date | null): boolean;
+/**
+ * Generate a unique ID for a new custom market
+ */
+export declare function generateMarketId(): string;
+//# sourceMappingURL=dateHelpers.d.ts.map

package/lib/formatTrend.d.ts

@@ -0,0 +1,24 @@
+export type TrendDirection = 'up' | 'down' | 'flat';
+export interface FormattedTrend {
+    text: string;
+    direction: TrendDirection;
+}
+/**
+ * Format trend percentage per spec rules.
+ *
+ * Rules:
+ * - null/undefined/0: returns '0%' with 'flat' direction
+ * - |value| >= 3: round to whole number (e.g. 30.3 -> '30%')
+ * - |value| < 3 and > 0: show one decimal (e.g. 1.2 -> '1.2%')
+ * - direction: 'up' if positive, 'down' if negative, 'flat' if zero
+ *
+ * @example
+ * ```ts
+ * import { formatTrend } from '@mt-gloss/utils';
+ *
+ * const result = formatTrend(12.5);
+ * // result.text === '13%', result.direction === 'up'
+ * ```
+ */
+export declare function formatTrend(value: number | null | undefined): FormattedTrend;
+//# sourceMappingURL=formatTrend.d.ts.map

package/lib/formatValue.d.ts

@@ -0,0 +1,40 @@
+export interface FormatValueOptions {
+    prefix?: string;
+    suffix?: string;
+    abbreviated?: boolean;
+    kThreshold?: number;
+}
+export interface FormattedValue {
+    display: string;
+    full: string;
+    length: number;
+}
+/**
+ * Smart value abbreviation with K/M suffixes and full-value hover.
+ *
+ * Rules:
+ * - |num| >= 1,000,000: divide by 1M, 1 decimal, suffix M (strip trailing .0)
+ * - |num| >= 1,000: divide by 1K, 1 decimal, suffix K (strip trailing .0)
+ * - Otherwise: full number with locale commas
+ *
+ * @example
+ * ```ts
+ * import { formatValue } from '@mt-gloss/utils';
+ *
+ * const result = formatValue(125430, { prefix: '$', abbreviated: true });
+ * // result.display === '$125.4K'
+ * ```
+ */
+export declare function formatValue(raw: number | string | null | undefined, { prefix, suffix, abbreviated, kThreshold }?: FormatValueOptions): FormattedValue;
+/**
+ * Determine font size based on formatted display length and column span.
+ *
+ * @example
+ * ```ts
+ * import { getValueFontSize } from '@mt-gloss/utils';
+ *
+ * const fontSize = getValueFontSize(5, 1); // 28
+ * ```
+ */
+export declare function getValueFontSize(length: number, colSpan?: number | null): number;
+//# sourceMappingURL=formatValue.d.ts.map

package/lib/presets.d.ts

@@ -0,0 +1,49 @@
+import { PresetDefinition, MarketPreset, DateRange } from './types';
+export declare const ROLLING_OPTIONS: PresetDefinition[];
+export declare const PERIOD_OPTIONS: PresetDefinition[];
+export declare const TODAY_PRESET: PresetDefinition;
+export declare const DEFAULT_MARKET_PRESETS: MarketPreset[];
+export declare const PRESET_ID_MAP: Record<string, string>;
+export declare const PRESET_ID_REVERSE_MAP: Record<string, string>;
+/**
+ * Get date range for a preset ID
+ * @param {string} presetId - Preset ID (case insensitive)
+ * @param {Date} referenceDate - Reference date (defaults to now)
+ * @returns {{ start: Date, end: Date }} Date range
+ */
+export declare function getDateRangeForPreset(presetId: string, referenceDate?: Date): DateRange;
+/**
+ * Find a preset by ID
+ * @param {string} id - Preset ID (case insensitive)
+ * @returns {object|null} Preset object or null
+ */
+export declare function findPreset(id: string): PresetDefinition | null;
+/**
+ * Get human-readable display label for a preset ID.
+ * Handles uppercase IDs (from onChange payload) and lowercase IDs.
+ * @param {string} presetId - Preset ID (e.g., 'MTD', 'mtd', '30D', 'custom', 'today')
+ * @returns {string} Display label (e.g., 'MTD', '30D', 'Today', 'Custom', or the raw ID as fallback)
+ */
+export declare function getPresetLabel(presetId: string | null | undefined): string;
+/**
+ * Normalize preset ID to lowercase
+ * @param {string} id - Preset ID
+ * @returns {string|null} Normalized ID
+ */
+export declare function normalizePresetId(id: string | null | undefined): string | null;
+/**
+ * Convert preset ID to uppercase (for backward compatibility)
+ * @param {string} id - Preset ID
+ * @returns {string|null} Uppercase ID
+ */
+export declare function toUppercasePresetId(id: string | null | undefined): string | null;
+/**
+ * Get all presets as a flat array
+ * @returns {Array} All presets
+ */
+export declare function getAllPresets(): PresetDefinition[];
+/**
+ * Default pinned preset (single global default)
+ */
+export declare const DEFAULT_PINNED: string;
+//# sourceMappingURL=presets.d.ts.map

package/lib/smartDateFormat.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Date Range Formatting Utility
+ *
+ * Formats date ranges with minimal text while maintaining clarity.
+ * Designed for use with date pickers and time frame selectors.
+ *
+ * @module dateRangeFormat
+ */
+interface CustomPreset {
+    id: string;
+    label: string;
+    startDate?: Date;
+    endDate?: Date;
+    priority?: number;
+}
+interface PresetMatch {
+    id: string;
+    label: string;
+}
+interface DateRangeDisplayInfo {
+    display: string;
+    formatted: string;
+    preset: PresetMatch | null;
+}
+interface FormatDateRangeOptions {
+    shortYear?: boolean;
+}
+interface FormatWithPresetOptions {
+    preferPresetLabel?: boolean;
+    showPresetDates?: boolean;
+    customPresets?: CustomPreset[];
+}
+interface DateRangeResult {
+    start: Date;
+    end: Date;
+}
+interface FormatPresetResult extends DateRangeResult {
+    formatted: string;
+}
+/**
+ * Detect if a date range matches a known preset
+ */
+export declare function detectPreset(start: Date, end: Date, referenceDate?: Date, customPresets?: CustomPreset[]): PresetMatch | null;
+/**
+ * Format a date range, returning preset label if it matches a known preset
+ */
+export declare function formatDateRangeWithPreset(start: Date, end: Date, referenceDate?: Date, options?: FormatWithPresetOptions): string;
+/**
+ * Get display info for a date range (both label and formatted date)
+ */
+export declare function getDateRangeDisplayInfo(start: Date, end: Date, referenceDate?: Date, customPresets?: CustomPreset[]): DateRangeDisplayInfo;
+/**
+ * Format a date's year as curly-apostrophe + 2-digit year string.
+ * e.g., 2026 -> '\u201926', 2025 -> '\u201925'
+ */
+export declare function formatShortYear(date: Date): string;
+/**
+ * Strip leading zeros from numeric-only strings.
+ * Preserves at least one character (so "0" stays "0", "000" becomes "0").
+ * Non-numeric-prefixed strings pass through unchanged.
+ * Null/undefined return as-is.
+ */
+export declare function stripLeadingZeros(value: string | null | undefined): string | null | undefined;
+/**
+ * Format a date range with minimal redundancy
+ */
+export declare function formatDateRange(start: Date, end: Date, referenceDate?: Date, options?: FormatDateRangeOptions): string;
+/**
+ * Format a single date with minimal redundancy
+ */
+export declare function formatSingleDate(date: Date, referenceDate?: Date): string;
+/**
+ * Parse a formatted date range string back to Date objects
+ */
+export declare function parseDateRange(formatted: string, referenceDate?: Date): DateRangeResult;
+/**
+ * Validate that a string is a valid formatted date range
+ */
+export declare function isValidDateRangeFormat(formatted: string): boolean;
+/**
+ * Get the duration in days between two dates
+ */
+export declare function getDurationDays(start: Date, end: Date): number;
+/**
+ * Format duration as human-readable string
+ */
+export declare function formatDuration(start: Date, end: Date): string;
+/**
+ * Format a preset identifier to its date range string
+ */
+export declare function formatPreset(presetId: string, referenceDate?: Date): FormatPresetResult;
+/**
+ * Get date range for a preset identifier
+ */
+export declare function getPresetDateRange(presetId: string, referenceDate?: Date): DateRangeResult;
+declare const _default: {
+    formatDateRange: typeof formatDateRange;
+    formatSingleDate: typeof formatSingleDate;
+    formatDateRangeWithPreset: typeof formatDateRangeWithPreset;
+    formatShortYear: typeof formatShortYear;
+    detectPreset: typeof detectPreset;
+    getDateRangeDisplayInfo: typeof getDateRangeDisplayInfo;
+    parseDateRange: typeof parseDateRange;
+    isValidDateRangeFormat: typeof isValidDateRangeFormat;
+    getDurationDays: typeof getDurationDays;
+    formatDuration: typeof formatDuration;
+    stripLeadingZeros: typeof stripLeadingZeros;
+    formatPreset: typeof formatPreset;
+    getPresetDateRange: typeof getPresetDateRange;
+};
+export default _default;
+//# sourceMappingURL=smartDateFormat.d.ts.map

package/lib/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Definition for a date range preset (e.g., "Last 7 Days", "This Month").
+ */
+export interface PresetDefinition {
+    id: string;
+    label: string;
+    getRange?: () => [Date, Date];
+    category?: string;
+    pinned?: boolean;
+}
+/**
+ * A market-specific preset that extends the base preset with location and date data.
+ */
+export interface MarketPreset extends PresetDefinition {
+    startDate: Date;
+    endDate: Date;
+    location: string;
+}
+/**
+ * A simple date range with optional label.
+ */
+export interface DateRange {
+    start: Date;
+    end: Date;
+    label?: string;
+}
+/**
+ * A market event with date range and location metadata.
+ */
+export interface MarketEvent {
+    id: string;
+    name: string;
+    location: string;
+    startDate: Date;
+    endDate: Date;
+    category?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@mt-gloss/utils",
+  "version": "0.0.3",
+  "type": "module",
+  "main": "./index.js",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      }
+    }
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "lib/**/*.d.ts",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "date-fns": "^3.0.0 || ^4.0.0"
+  }
+}