@mt-gloss/utils 0.1.150 → 0.1.152

package/index.d.ts

@@ -4,8 +4,11 @@ export { formatValue, getValueFontSize, pickMetricTier } from './lib/formatValue
 export type { FormatValueOptions, FormattedValue, MetricTier, PickMetricTierResult } from './lib/formatValue';
 export { formatCurrency } from './lib/formatCurrency';
 export type { FormatCurrencyOptions } from './lib/formatCurrency';
+export { hexToRgba, lerpHex } from './lib/color';
+export { getTransitionStyle, interpolate, parseNumericValue } from './lib/cssAnimation';
 export { daysBetween } from './lib/daysBetween';
 export type { DaysBetweenOptions, DaysBetweenRounding } from './lib/daysBetween';
+export { toLocalCalendarDate } from './lib/toLocalCalendarDate';
 export { formatTrend } from './lib/formatTrend';
 export type { TrendDirection, FormattedTrend } from './lib/formatTrend';
 export { formatDateRange, formatMarketDates, isMarketActive, isSameDay, isInRange, generateMarketId } from './lib/dateHelpers';

package/index.js

@@ -1,38 +1,38 @@
-import { D as A, y as O, P as V, n as x, o as Y, R as w, T as G, d as z, t as k, f as B, b as C, k as H, l as Z, c as K, h as X, x as j, g as q, q as W, j as J, m as Q, u as tt, i as et, v as nt, p as rt, a as at, r as ot, s as st, e as it, w as ut } from "./formatting-dHqp6ksD.js";
-const g = "NEXT_PUBLIC_V1_1_STATUS_MODE";
-function d() {
-  return typeof globalThis < "u" && globalThis.__GLOSS_FLAGS__?.v1_1_status_mode === !0 ? !0 : typeof process < "u" && process.env ? process.env[g] === "true" : !1;
-}
-const $ = {
-  env: g,
-  check: d
-}, m = "NEXT_PUBLIC_V1_1_EDGE_HOVER_RESIZE";
-function D() {
-  return typeof globalThis < "u" && globalThis.__GLOSS_FLAGS__?.v1_1_edge_hover_resize === !0 ? !0 : typeof process < "u" && process.env ? process.env[m] === "true" : !1;
+import { D as G, y as z, P as H, n as k, o as B, R as Z, T as j, d as K, t as X, f as q, b as W, k as J, l as Q, c as tt, h as et, x as nt, g as rt, q as at, j as ot, m as st, u as it, i as ut, v as ct, p as lt, a as ft, r as gt, s as mt, e as dt, w as ht } from "./formatting-dHqp6ksD.js";
+const m = "NEXT_PUBLIC_V1_1_STATUS_MODE";
+function h() {
+  return typeof globalThis < "u" && globalThis.__GLOSS_FLAGS__?.v1_1_status_mode === !0 ? !0 : typeof process < "u" && process.env ? process.env[m] === "true" : !1;
 }
 const p = {
   env: m,
-  check: D
+  check: h
+}, d = "NEXT_PUBLIC_V1_1_EDGE_HOVER_RESIZE";
+function $() {
+  return typeof globalThis < "u" && globalThis.__GLOSS_FLAGS__?.v1_1_edge_hover_resize === !0 ? !0 : typeof process < "u" && process.env ? process.env[d] === "true" : !1;
+}
+const M = {
+  env: d,
+  check: $
 };
-function _(t, { prefix: e = "", suffix: n = "", abbreviated: o = !0, kThreshold: a = 1e3 } = {}) {
+function D(t, { prefix: e = "", suffix: n = "", abbreviated: r = !0, kThreshold: o = 1e3 } = {}) {
   if (t == null) {
-    const c = e ? `${e} —${n}` : `—${n}`;
-    return { display: c.trim(), full: c.trim(), length: c.trim().length };
+    const l = e ? `${e} —${n}` : `—${n}`;
+    return { display: l.trim(), full: l.trim(), length: l.trim().length };
   }
-  const r = typeof t == "number" ? t : parseFloat(String(t).replace(/,/g, ""));
-  if (isNaN(r)) {
+  const a = typeof t == "number" ? t : parseFloat(String(t).replace(/,/g, ""));
+  if (isNaN(a)) {
     const u = `${e}${t}${n}`;
     return { display: u, full: u, length: u.length };
   }
   let s;
-  o !== !1 && Math.abs(r) >= 1e6 ? s = (r / 1e6).toFixed(1).replace(/\.0$/, "") + "M" : o !== !1 && Math.abs(r) >= a ? s = (r / 1e3).toFixed(1).replace(/\.0$/, "") + "K" : s = r.toLocaleString("en-US");
-  const i = `${e}${s}${n}`, f = `${e}${r.toLocaleString("en-US")}${n}`;
-  return { display: i, full: f, length: i.length };
+  r !== !1 && Math.abs(a) >= 1e6 ? s = (a / 1e6).toFixed(1).replace(/\.0$/, "") + "M" : r !== !1 && Math.abs(a) >= o ? s = (a / 1e3).toFixed(1).replace(/\.0$/, "") + "K" : s = a.toLocaleString("en-US");
+  const i = `${e}${s}${n}`, c = `${e}${a.toLocaleString("en-US")}${n}`;
+  return { display: i, full: c, length: i.length };
 }
 function E(t, e) {
   return (e ?? 1) >= 2 ? t <= 4 || t <= 6 ? 30 : t <= 8 ? 24 : 20 : t <= 5 ? 28 : t <= 8 ? 20 : 17;
 }
-const l = {
+const f = {
   1: 5,
   // "$2.7K", "12K", "$5", "100%"
   2: 8,
@@ -40,111 +40,151 @@ const l = {
   3: 12
   // "$1,234,567"
 };
-function h(t) {
-  return t <= 1 ? l[1] : t >= 3 ? l[3] : l[t] ?? l[1];
+function _(t) {
+  return t <= 1 ? f[1] : t >= 3 ? f[3] : f[t] ?? f[1];
 }
-function M(t, e = {}, n = 1) {
-  const o = h(n), a = e.prefix ?? "", r = e.suffix ?? "", s = typeof t == "number" ? t : parseFloat(String(t ?? "").replace(/,/g, ""));
+function T(t, e = {}, n = 1) {
+  const r = _(n), o = e.prefix ?? "", a = e.suffix ?? "", s = typeof t == "number" ? t : parseFloat(String(t ?? "").replace(/,/g, ""));
   if (t != null && !Number.isNaN(s)) {
-    const f = `${a}${s.toLocaleString("en-US", { minimumFractionDigits: Number.isInteger(s) ? 0 : 2, maximumFractionDigits: 2 })}${r}`;
-    if (f.length <= o) return { formatted: f, tier: "wide", length: f.length };
-    const u = `${a}${Math.round(s).toLocaleString("en-US")}${r}`;
-    if (u.length <= o) return { formatted: u, tier: "medium", length: u.length };
+    const c = `${o}${s.toLocaleString("en-US", { minimumFractionDigits: Number.isInteger(s) ? 0 : 2, maximumFractionDigits: 2 })}${a}`;
+    if (c.length <= r) return { formatted: c, tier: "wide", length: c.length };
+    const u = `${o}${Math.round(s).toLocaleString("en-US")}${a}`;
+    if (u.length <= r) return { formatted: u, tier: "medium", length: u.length };
   }
-  const i = _(t, { ...e, abbreviated: !0 });
-  return i.display.length <= o ? { formatted: i.display, tier: "narrow", length: i.display.length } : { formatted: i.display, tier: "very-narrow", length: i.display.length };
+  const i = D(t, { ...e, abbreviated: !0 });
+  return i.display.length <= r ? { formatted: i.display, tier: "narrow", length: i.display.length } : { formatted: i.display, tier: "very-narrow", length: i.display.length };
 }
-function y(t, { notation: e = "standard", fractionDigits: n, currency: o = "USD" } = {}) {
-  const a = { style: "currency", currency: o };
+function y(t, { notation: e = "standard", fractionDigits: n, currency: r = "USD" } = {}) {
+  const o = { style: "currency", currency: r };
   if (e === "compact")
-    a.notation = "compact", a.compactDisplay = "short", n !== void 0 && (a.minimumFractionDigits = n, a.maximumFractionDigits = n);
+    o.notation = "compact", o.compactDisplay = "short", n !== void 0 && (o.minimumFractionDigits = n, o.maximumFractionDigits = n);
   else {
-    const r = n ?? 2;
-    a.minimumFractionDigits = r, a.maximumFractionDigits = r;
+    const a = n ?? 2;
+    o.minimumFractionDigits = a, o.maximumFractionDigits = a;
   }
-  return new Intl.NumberFormat("en-US", a).format(t);
+  return new Intl.NumberFormat("en-US", o).format(t);
+}
+function g(t) {
+  const e = t.replace("#", "");
+  return [
+    parseInt(e.slice(0, 2), 16),
+    parseInt(e.slice(2, 4), 16),
+    parseInt(e.slice(4, 6), 16)
+  ];
+}
+function b(t, e) {
+  const n = t.replace("#", "");
+  if (!/^[0-9a-fA-F]{6}$/.test(n))
+    return `rgba(0,0,0,${e})`;
+  const [r, o, a] = g(t);
+  return `rgba(${r},${o},${a},${e})`;
+}
+function F(t, e, n) {
+  const r = Math.max(0, Math.min(1, n)), [o, a, s] = g(t), [i, c, u] = g(e);
+  return `rgb(${Math.round(o + (i - o) * r)}, ${Math.round(a + (c - a) * r)}, ${Math.round(
+    s + (u - s) * r
+  )})`;
+}
+function R(t, e = 200, n = "cubic-bezier(0, 0, 0.2, 1)") {
+  return t.map((r) => `${r} ${e}ms ${n}`).join(", ");
+}
+function P(t, e, n) {
+  return t + (e - t) * n;
+}
+function I(t) {
+  const e = t.match(/^([-\d.]+)(.*)$/);
+  return e ? { value: parseFloat(e[1]), unit: e[2] || "" } : { value: 0, unit: "" };
 }
 const S = 1e3 * 60 * 60 * 24;
-function T(t, e, n = {}) {
-  const { rounding: o = "round", inclusive: a = !1, min: r, absolute: s = !0 } = n, i = e.getTime() - t.getTime(), u = (s ? Math.abs(i) : i) / S;
-  let c = o === "ceil" ? Math.ceil(u) : o === "floor" ? Math.floor(u) : o === "round" ? Math.round(u) : u;
-  return a && (c += 1), r !== void 0 && (c = Math.max(c, r)), c;
+function L(t, e, n = {}) {
+  const { rounding: r = "round", inclusive: o = !1, min: a, absolute: s = !0 } = n, i = e.getTime() - t.getTime(), u = (s ? Math.abs(i) : i) / S;
+  let l = r === "ceil" ? Math.ceil(u) : r === "floor" ? Math.floor(u) : r === "round" ? Math.round(u) : u;
+  return o && (l += 1), a !== void 0 && (l = Math.max(l, a)), l;
+}
+function U(t) {
+  return new Date(t.getUTCFullYear(), t.getUTCMonth(), t.getUTCDate());
 }
-function R(t) {
+function v(t) {
   if (t == null || t === 0)
     return { text: "0%", direction: "flat" };
   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 F(t, e) {
+function N(t, e) {
   if (!t || !e) return "";
-  const n = t.toLocaleDateString("en-US", { month: "short" }), o = e.toLocaleDateString("en-US", { month: "short" }), a = t.getDate(), r = e.getDate(), s = t.getFullYear(), i = e.getFullYear();
-  return t.getTime() === e.getTime() || n === o && a === r && s === i ? `${n} ${a}, ${s}` : n === o && s === i ? `${n} ${a}–${r}` : s === i ? `${n} ${a} – ${o} ${r}` : `${n} ${a}, ${s} – ${o} ${r}, ${i}`;
+  const n = t.toLocaleDateString("en-US", { month: "short" }), r = e.toLocaleDateString("en-US", { month: "short" }), o = t.getDate(), a = e.getDate(), s = t.getFullYear(), i = e.getFullYear();
+  return t.getTime() === e.getTime() || n === r && o === a && s === i ? `${n} ${o}, ${s}` : n === r && s === i ? `${n} ${o}–${a}` : s === i ? `${n} ${o} – ${r} ${a}` : `${n} ${o}, ${s} – ${r} ${a}, ${i}`;
 }
-function P(t, e) {
-  const n = t.toLocaleDateString("en-US", { month: "short" }), o = e.toLocaleDateString("en-US", { month: "short" }), a = t.getDate(), r = e.getDate();
-  return n === o ? `${n} ${a}–${r}` : `${n} ${a} – ${o} ${r}`;
+function A(t, e) {
+  const n = t.toLocaleDateString("en-US", { month: "short" }), r = e.toLocaleDateString("en-US", { month: "short" }), o = t.getDate(), a = e.getDate();
+  return n === r ? `${n} ${o}–${a}` : `${n} ${o} – ${r} ${a}`;
 }
-function b(t, e = /* @__PURE__ */ new Date()) {
+function V(t, e = /* @__PURE__ */ new Date()) {
   return !t?.startDate || !t?.endDate ? !1 : e >= t.startDate && e <= t.endDate;
 }
-function L(t, e) {
+function x(t, e) {
   return !t || !e ? !1 : t.getFullYear() === e.getFullYear() && t.getMonth() === e.getMonth() && t.getDate() === e.getDate();
 }
-function I(t, e, n) {
+function O(t, e, n) {
   if (!t || !e || !n) return !1;
-  const o = t.getTime(), a = e.getTime(), r = n.getTime();
-  return o >= Math.min(a, r) && o <= Math.max(a, r);
+  const r = t.getTime(), o = e.getTime(), a = n.getTime();
+  return r >= Math.min(o, a) && r <= Math.max(o, a);
 }
-function U() {
+function Y() {
   return `custom-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
 }
 export {
-  A as DEFAULT_MARKET_PRESETS,
-  O as DEFAULT_PINNED,
-  V as PERIOD_OPTIONS,
-  x as PRESET_ID_MAP,
-  Y as PRESET_ID_REVERSE_MAP,
-  w as ROLLING_OPTIONS,
-  G as TODAY_PRESET,
-  m as V1_1_EDGE_HOVER_RESIZE_ENV,
-  g as V1_1_STATUS_MODE_ENV,
-  T as daysBetween,
-  z as detectPreset,
-  k as findPreset,
+  G as DEFAULT_MARKET_PRESETS,
+  z as DEFAULT_PINNED,
+  H as PERIOD_OPTIONS,
+  k as PRESET_ID_MAP,
+  B as PRESET_ID_REVERSE_MAP,
+  Z as ROLLING_OPTIONS,
+  j as TODAY_PRESET,
+  d as V1_1_EDGE_HOVER_RESIZE_ENV,
+  m as V1_1_STATUS_MODE_ENV,
+  L as daysBetween,
+  K as detectPreset,
+  X as findPreset,
   y as formatCurrency,
-  F as formatDateRange,
-  B as formatDateRangeSmart,
-  C as formatDateRangeWithPreset,
-  H as formatDuration,
-  P as formatMarketDates,
-  Z as formatPreset,
-  K as formatShortYear,
-  X as formatSingleDate,
-  R as formatTrend,
-  _ as formatValue,
-  U as generateMarketId,
-  j as getAllPresets,
-  q as getDateRangeDisplayInfo,
-  W as getDateRangeForPreset,
-  J as getDurationDays,
-  Q as getPresetDateRange,
-  tt as getPresetLabel,
+  N as formatDateRange,
+  q as formatDateRangeSmart,
+  W as formatDateRangeWithPreset,
+  J as formatDuration,
+  A as formatMarketDates,
+  Q as formatPreset,
+  tt as formatShortYear,
+  et as formatSingleDate,
+  v as formatTrend,
+  D as formatValue,
+  Y as generateMarketId,
+  nt as getAllPresets,
+  rt as getDateRangeDisplayInfo,
+  at as getDateRangeForPreset,
+  ot as getDurationDays,
+  st as getPresetDateRange,
+  it as getPresetLabel,
+  R as getTransitionStyle,
   E as getValueFontSize,
-  D as isEdgeHoverResizeEnabled,
-  I as isInRange,
-  b as isMarketActive,
-  L as isSameDay,
-  d as isStatusModeEnabled,
-  et as isValidDateRangeFormat,
-  nt as normalizePresetId,
-  rt as parseDateRange,
-  M as pickMetricTier,
-  at as resolveEvent,
-  ot as resolvePreset,
-  st as smartDateFormat,
-  it as stripLeadingZeros,
-  ut as toUppercasePresetId,
-  p as v1_1_edge_hover_resize,
-  $ as v1_1_status_mode
+  b as hexToRgba,
+  P as interpolate,
+  $ as isEdgeHoverResizeEnabled,
+  O as isInRange,
+  V as isMarketActive,
+  x as isSameDay,
+  h as isStatusModeEnabled,
+  ut as isValidDateRangeFormat,
+  F as lerpHex,
+  ct as normalizePresetId,
+  lt as parseDateRange,
+  I as parseNumericValue,
+  T as pickMetricTier,
+  ft as resolveEvent,
+  gt as resolvePreset,
+  mt as smartDateFormat,
+  dt as stripLeadingZeros,
+  U as toLocalCalendarDate,
+  ht as toUppercasePresetId,
+  M as v1_1_edge_hover_resize,
+  p as v1_1_status_mode
 };

package/lib/color.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Convert a 6-digit hex color to an `rgba(r,g,b,a)` string.
+ *
+ * Guards against malformed input: a value that is not exactly 6 hex digits
+ * (after stripping a leading `#`) returns a safe transparent fallback
+ * `rgba(0,0,0,${alpha})` rather than throwing. Callers should pre-resolve
+ * semantic color names to hex before calling.
+ *
+ * @example
+ * import { hexToRgba } from '@mt-gloss/utils';
+ * hexToRgba('#10b981', 0.2) // 'rgba(16,185,129,0.2)'
+ * hexToRgba('nope', 0.5)    // 'rgba(0,0,0,0.5)'
+ */
+export declare function hexToRgba(hex: string, alpha: number): string;
+/**
+ * Linearly interpolate between two `#rrggbb` hex colors, returning `rgb(r, g, b)`.
+ *
+ * `t` is clamped to `[0, 1]`; `t = 0` yields `from`, `t = 1` yields `to`.
+ * Channels are rounded to the nearest integer.
+ *
+ * @example
+ * import { lerpHex } from '@mt-gloss/utils';
+ * lerpHex('#000000', '#ffffff', 0.5) // 'rgb(128, 128, 128)'
+ */
+export declare function lerpHex(from: string, to: string, t: number): string;
+//# sourceMappingURL=color.d.ts.map

package/lib/cssAnimation.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Build a CSS `transition` shorthand from a list of properties.
+ *
+ * Defaults (`200ms`, `cubic-bezier(0, 0, 0.2, 1)`) are inlined literals rather
+ * than `@mt-gloss/tokens` reads: `utils` is a leaf package and must not depend
+ * on `tokens`. The values mirror the `durations.normal` / `easings.easeOut`
+ * design tokens; callers that need a tokenized curve pass it explicitly.
+ *
+ * @example
+ * import { getTransitionStyle } from '@mt-gloss/utils';
+ * getTransitionStyle(['opacity', 'transform']) // 'opacity 200ms cubic-bezier(0, 0, 0.2, 1), transform 200ms cubic-bezier(0, 0, 0.2, 1)'
+ * getTransitionStyle(['width'], 300, 'linear') // 'width 300ms linear'
+ */
+export declare function getTransitionStyle(properties: string[], duration?: number, easing?: string): string;
+/**
+ * Linearly interpolate between two numbers by `progress` (0–1, unclamped).
+ *
+ * @example
+ * import { interpolate } from '@mt-gloss/utils';
+ * interpolate(0, 100, 0.25) // 25
+ */
+export declare function interpolate(from: number, to: number, progress: number): number;
+/**
+ * Parse a CSS dimension string (e.g. `"8px"`) into its numeric value and unit.
+ * Unparseable input yields `{ value: 0, unit: '' }`.
+ *
+ * @example
+ * import { parseNumericValue } from '@mt-gloss/utils';
+ * parseNumericValue('8px')  // { value: 8, unit: 'px' }
+ * parseNumericValue('1.5e') // { value: 1.5, unit: 'e' }
+ */
+export declare function parseNumericValue(value: string): {
+    value: number;
+    unit: string;
+};
+//# sourceMappingURL=cssAnimation.d.ts.map

package/lib/toLocalCalendarDate.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Re-project a date onto **local midnight of its UTC calendar date**.
+ *
+ * Order dates arrive from the BFF as date-only ISO strings (e.g. `"2026-03-09"`).
+ * `new Date("2026-03-09")` parses this as **UTC midnight**, which in timezones
+ * west of UTC falls on the *previous* local calendar day (e.g. March 8 at
+ * 19:00 EST). To bucket an order by its intended calendar day regardless of the
+ * viewer's timezone, both the dashboard's table filter and its chart grouping
+ * extract the date's **UTC** year/month/day and rebuild a `Date` at **local**
+ * midnight of those components. Doing this on both surfaces guarantees the
+ * table filter (which uses local-midnight boundaries) and the chart's UTC
+ * date-grouping agree on which day an order belongs to.
+ *
+ * Regress this and table totals silently disagree with chart bars: the only
+ * orders affected are those whose date sits on a UTC-vs-local day boundary, so
+ * nothing throws — the two surfaces just stop matching.
+ *
+ * Purity note: the input `Date` only needs to carry the right instant; this
+ * helper reads its UTC Y/M/D and nothing else. String parsing and null handling
+ * stay with the caller — one consumer coerces with `new Date(str)`, another with
+ * date-fns `parseISO` — and both delegate the projection here.
+ *
+ * @example
+ * ```ts
+ * import { toLocalCalendarDate } from '@mt-gloss/utils';
+ *
+ * // A date-only ISO string parses as UTC midnight; the helper re-keys it to
+ * // local midnight of the SAME calendar date — timezone-independent.
+ * const d = toLocalCalendarDate(new Date('2026-03-09'));
+ * d.getFullYear(); // 2026
+ * d.getMonth();    // 2  (March, 0-indexed)
+ * d.getDate();     // 9  — never the 8th, even west of UTC
+ * ```
+ */
+export declare function toLocalCalendarDate(date: Date): Date;
+//# sourceMappingURL=toLocalCalendarDate.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mt-gloss/utils",
-  "version": "0.1.150",
+  "version": "0.1.152",
   "type": "module",
   "publishConfig": {
     "access": "public"