@mt-gloss/utils 0.1.148 → 0.1.150

package/index.d.ts

@@ -2,6 +2,10 @@ export { isStatusModeEnabled, v1_1_status_mode, V1_1_STATUS_MODE_ENV, isEdgeHove
 export type { PresetDefinition, MarketPreset, DateRange, MarketEvent } from './lib/types';
 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 { daysBetween } from './lib/daysBetween';
+export type { DaysBetweenOptions, DaysBetweenRounding } from './lib/daysBetween';
 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 U, y as N, P as v, n as A, o as O, R as V, T as G, d as Y, t as x, f as z, b as k, k as w, l as H, c as B, h as C, x as Z, g as K, q as X, j, m as q, u as W, i as J, v as Q, p as tt, a as et, r as nt, s as rt, e as at, w as st } from "./formatting-dHqp6ksD.js";
+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 _() {
+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: _
+  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;
 }
-const S = {
+const p = {
   env: m,
   check: D
 };
-function d(t, { prefix: e = "", suffix: n = "", abbreviated: a = !0, kThreshold: s = 1e3 } = {}) {
+function _(t, { prefix: e = "", suffix: n = "", abbreviated: o = !0, kThreshold: a = 1e3 } = {}) {
   if (t == null) {
-    const l = e ? `${e} —${n}` : `—${n}`;
-    return { display: l.trim(), full: l.trim(), length: l.trim().length };
+    const c = e ? `${e} —${n}` : `—${n}`;
+    return { display: c.trim(), full: c.trim(), length: c.trim().length };
   }
   const r = typeof t == "number" ? t : parseFloat(String(t).replace(/,/g, ""));
   if (isNaN(r)) {
     const u = `${e}${t}${n}`;
     return { display: u, full: u, length: u.length };
   }
-  let o;
-  a !== !1 && Math.abs(r) >= 1e6 ? o = (r / 1e6).toFixed(1).replace(/\.0$/, "") + "M" : a !== !1 && Math.abs(r) >= s ? o = (r / 1e3).toFixed(1).replace(/\.0$/, "") + "K" : o = r.toLocaleString("en-US");
-  const i = `${e}${o}${n}`, c = `${e}${r.toLocaleString("en-US")}${n}`;
-  return { display: i, full: c, length: i.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 };
 }
 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 f = {
+const l = {
   1: 5,
   // "$2.7K", "12K", "$5", "100%"
   2: 8,
@@ -41,92 +41,110 @@ const f = {
   // "$1,234,567"
 };
 function h(t) {
-  return t <= 1 ? f[1] : t >= 3 ? f[3] : f[t] ?? f[1];
+  return t <= 1 ? l[1] : t >= 3 ? l[3] : l[t] ?? l[1];
 }
-function p(t, e = {}, n = 1) {
-  const a = h(n), s = e.prefix ?? "", r = e.suffix ?? "", o = typeof t == "number" ? t : parseFloat(String(t ?? "").replace(/,/g, ""));
-  if (t != null && !Number.isNaN(o)) {
-    const c = `${s}${o.toLocaleString("en-US", { minimumFractionDigits: Number.isInteger(o) ? 0 : 2, maximumFractionDigits: 2 })}${r}`;
-    if (c.length <= a) return { formatted: c, tier: "wide", length: c.length };
-    const u = `${s}${Math.round(o).toLocaleString("en-US")}${r}`;
-    if (u.length <= a) return { formatted: u, tier: "medium", length: u.length };
+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, ""));
+  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 i = d(t, { ...e, abbreviated: !0 });
-  return i.display.length <= a ? { formatted: i.display, tier: "narrow", length: i.display.length } : { formatted: i.display, tier: "very-narrow", length: i.display.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 };
 }
-function T(t) {
+function y(t, { notation: e = "standard", fractionDigits: n, currency: o = "USD" } = {}) {
+  const a = { style: "currency", currency: o };
+  if (e === "compact")
+    a.notation = "compact", a.compactDisplay = "short", n !== void 0 && (a.minimumFractionDigits = n, a.maximumFractionDigits = n);
+  else {
+    const r = n ?? 2;
+    a.minimumFractionDigits = r, a.maximumFractionDigits = r;
+  }
+  return new Intl.NumberFormat("en-US", a).format(t);
+}
+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 R(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 y(t, e) {
+function F(t, e) {
   if (!t || !e) return "";
-  const n = t.toLocaleDateString("en-US", { month: "short" }), a = e.toLocaleDateString("en-US", { month: "short" }), s = t.getDate(), r = e.getDate(), o = t.getFullYear(), i = e.getFullYear();
-  return t.getTime() === e.getTime() || n === a && s === r && o === i ? `${n} ${s}, ${o}` : n === a && o === i ? `${n} ${s}–${r}` : o === i ? `${n} ${s} – ${a} ${r}` : `${n} ${s}, ${o} – ${a} ${r}, ${i}`;
+  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}`;
 }
-function M(t, e) {
-  const n = t.toLocaleDateString("en-US", { month: "short" }), a = e.toLocaleDateString("en-US", { month: "short" }), s = t.getDate(), r = e.getDate();
-  return n === a ? `${n} ${s}–${r}` : `${n} ${s} – ${a} ${r}`;
+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 R(t, e = /* @__PURE__ */ new Date()) {
+function b(t, e = /* @__PURE__ */ new Date()) {
   return !t?.startDate || !t?.endDate ? !1 : e >= t.startDate && e <= t.endDate;
 }
-function P(t, e) {
+function L(t, e) {
   return !t || !e ? !1 : t.getFullYear() === e.getFullYear() && t.getMonth() === e.getMonth() && t.getDate() === e.getDate();
 }
-function F(t, e, n) {
+function I(t, e, n) {
   if (!t || !e || !n) return !1;
-  const a = t.getTime(), s = e.getTime(), r = n.getTime();
-  return a >= Math.min(s, r) && a <= Math.max(s, r);
+  const o = t.getTime(), a = e.getTime(), r = n.getTime();
+  return o >= Math.min(a, r) && o <= Math.max(a, r);
 }
-function L() {
+function U() {
   return `custom-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
 }
 export {
-  U as DEFAULT_MARKET_PRESETS,
-  N as DEFAULT_PINNED,
-  v as PERIOD_OPTIONS,
-  A as PRESET_ID_MAP,
-  O as PRESET_ID_REVERSE_MAP,
-  V as ROLLING_OPTIONS,
+  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,
-  Y as detectPreset,
-  x as findPreset,
-  y as formatDateRange,
-  z as formatDateRangeSmart,
-  k as formatDateRangeWithPreset,
-  w as formatDuration,
-  M as formatMarketDates,
-  H as formatPreset,
-  B as formatShortYear,
-  C as formatSingleDate,
-  T as formatTrend,
-  d as formatValue,
-  L as generateMarketId,
-  Z as getAllPresets,
-  K as getDateRangeDisplayInfo,
-  X as getDateRangeForPreset,
-  j as getDurationDays,
-  q as getPresetDateRange,
-  W as getPresetLabel,
+  T as daysBetween,
+  z as detectPreset,
+  k 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,
   E as getValueFontSize,
   D as isEdgeHoverResizeEnabled,
-  F as isInRange,
-  R as isMarketActive,
-  P as isSameDay,
-  _ as isStatusModeEnabled,
-  J as isValidDateRangeFormat,
-  Q as normalizePresetId,
-  tt as parseDateRange,
-  p as pickMetricTier,
-  et as resolveEvent,
-  nt as resolvePreset,
-  rt as smartDateFormat,
-  at as stripLeadingZeros,
-  st as toUppercasePresetId,
-  S as v1_1_edge_hover_resize,
+  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
 };

package/lib/daysBetween.d.ts

@@ -0,0 +1,36 @@
+export type DaysBetweenRounding = 'ceil' | 'floor' | 'round' | 'none';
+export interface DaysBetweenOptions {
+    /** Rounding applied to the raw day fraction. `'none'` returns the fraction. Default `'round'`. */
+    rounding?: DaysBetweenRounding;
+    /** Add `+1` AFTER rounding to count both endpoints (e.g. `floor(x) + 1`). Default `false`. */
+    inclusive?: boolean;
+    /** Clamp the final result up to this floor (e.g. `1` to reproduce `… || 1`). Default none. */
+    min?: number;
+    /** `Math.abs` the millisecond diff so argument order is irrelevant. Default `true`. */
+    absolute?: boolean;
+}
+/**
+ * Day span between two dates, with explicit rounding/inclusivity/clamping.
+ *
+ * One configurable helper for the dashboard's several day-span computations,
+ * each of which carries a distinct mode. Order of operations is load-bearing:
+ * round → `+1` (inclusive) → `Math.max(min)`.
+ *
+ * Rules:
+ * - `rounding: 'none'` returns the raw fractional day count (callers that threshold on a non-integer).
+ * - `inclusive: true` adds `1` after rounding (counts both endpoints).
+ * - `min` clamps the final value up (e.g. `min: 1` turns a `0`-day span into `1`).
+ * - `absolute: true` (default) uses `|end − start|`; pass `false` for a signed difference.
+ *
+ * @example
+ * ```ts
+ * import { daysBetween } from '@mt-gloss/utils';
+ *
+ * const a = new Date('2026-01-01'), b = new Date('2026-01-04');
+ * daysBetween(a, b);                                    // 3
+ * daysBetween(a, b, { rounding: 'floor', inclusive: true }); // 4 (both endpoints)
+ * daysBetween(a, a, { rounding: 'ceil', min: 1 });      // 1
+ * ```
+ */
+export declare function daysBetween(start: Date, end: Date, opts?: DaysBetweenOptions): number;
+//# sourceMappingURL=daysBetween.d.ts.map

package/lib/formatCurrency.d.ts

@@ -0,0 +1,35 @@
+export interface FormatCurrencyOptions {
+    /** `'standard'` (default) → grouped full amount; `'compact'` → `$22K` / `$1.2M`. */
+    notation?: 'standard' | 'compact';
+    /**
+     * Sets BOTH the minimum and maximum fraction digits.
+     * - standard: defaults to `2` (`$1,234.56`); pass `0` for whole dollars (`$18,000`).
+     * - compact: when omitted, uses Intl's compact default (`$1.2M`, never `$1.20M`).
+     */
+    fractionDigits?: number;
+    /** ISO 4217 currency code. Default `'USD'`. */
+    currency?: string;
+}
+/**
+ * Format a number as a localized currency string (pure, `en-US`).
+ *
+ * Subsumes the dashboard's three string currency formatters: the default
+ * 2-decimal grouped form, the compact `$K`/`$M` form, and the whole-dollar
+ * pace form — each selected via options, behavior-preserving.
+ *
+ * Rules:
+ * - `notation: 'standard'` (default): `minimumFractionDigits === maximumFractionDigits === fractionDigits` (default `2`).
+ * - `notation: 'compact'`: `compactDisplay: 'short'`; fraction digits left to Intl unless `fractionDigits` is passed.
+ * - Locale is fixed to `en-US`; `currency` defaults to `USD`.
+ *
+ * @example
+ * ```ts
+ * import { formatCurrency } from '@mt-gloss/utils';
+ *
+ * formatCurrency(1234.5);                            // '$1,234.50'
+ * formatCurrency(1200000, { notation: 'compact' });  // '$1.2M'
+ * formatCurrency(18000, { fractionDigits: 0 });      // '$18,000'
+ * ```
+ */
+export declare function formatCurrency(value: number, { notation, fractionDigits, currency }?: FormatCurrencyOptions): string;
+//# sourceMappingURL=formatCurrency.d.ts.map

package/package.json

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