@mt-gloss/utils 0.1.64 → 0.1.66

package/index.d.ts

@@ -1,7 +1,7 @@
 export { isStatusModeEnabled, v1_1_status_mode, V1_1_STATUS_MODE_ENV, isEdgeHoverResizeEnabled, v1_1_edge_hover_resize, V1_1_EDGE_HOVER_RESIZE_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';
+export { formatValue, getValueFontSize, pickMetricTier } from './lib/formatValue';
+export type { FormatValueOptions, FormattedValue, MetricTier, PickMetricTierResult } 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';

package/index.js

@@ -1,109 +1,134 @@
-import { D as v, y as F, P as I, n as O, o as U, R as V, T as b, d as A, t as N, f as Y, b as G, k as z, l as k, c as H, h as Z, x, g as B, q as C, j as K, m as X, u as j, i as q, v as W, p as J, a as Q, r as w, s as ee, e as te, w as ne } from "./formatting-dHqp6ksD.js";
-const l = "NEXT_PUBLIC_V1_1_STATUS_MODE";
+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";
+const g = "NEXT_PUBLIC_V1_1_STATUS_MODE";
 function _() {
-  return typeof globalThis < "u" && globalThis.__GLOSS_FLAGS__?.v1_1_status_mode === !0 ? !0 : typeof process < "u" && process.env ? process.env[l] === "true" : !1;
+  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: l,
+  env: g,
   check: _
-}, f = "NEXT_PUBLIC_V1_1_EDGE_HOVER_RESIZE";
+}, 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[f] === "true" : !1;
+  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 = {
-  env: f,
+  env: m,
   check: D
 };
-function m(e, { prefix: t = "", suffix: n = "", abbreviated: a = !0, kThreshold: s = 1e3 } = {}) {
-  if (e == null) {
-    const c = t ? `${t} —${n}` : `—${n}`;
-    return { display: c.trim(), full: c.trim(), length: c.trim().length };
+function d(t, { prefix: e = "", suffix: n = "", abbreviated: a = !0, kThreshold: s = 1e3 } = {}) {
+  if (t == null) {
+    const l = e ? `${e} —${n}` : `—${n}`;
+    return { display: l.trim(), full: l.trim(), length: l.trim().length };
   }
-  const r = typeof e == "number" ? e : parseFloat(String(e).replace(/,/g, ""));
+  const r = typeof t == "number" ? t : parseFloat(String(t).replace(/,/g, ""));
   if (isNaN(r)) {
-    const u = `${t}${e}${n}`;
+    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 = `${t}${o}${n}`, g = `${t}${r.toLocaleString("en-US")}${n}`;
-  return { display: i, full: g, length: i.length };
+  const i = `${e}${o}${n}`, c = `${e}${r.toLocaleString("en-US")}${n}`;
+  return { display: i, full: c, length: i.length };
 }
-function h(e, t) {
-  return (t ?? 1) >= 2 ? e <= 4 || e <= 6 ? 30 : e <= 8 ? 24 : 20 : e <= 5 ? 28 : e <= 8 ? 20 : 17;
+function E(t, e) {
+  return (e ?? 1) >= 2 ? t <= 4 || t <= 6 ? 30 : t <= 8 ? 24 : 20 : t <= 5 ? 28 : t <= 8 ? 20 : 17;
 }
-function E(e) {
-  if (e == null || e === 0)
+const f = {
+  1: 5,
+  // "$2.7K", "12K", "$5", "100%"
+  2: 8,
+  // "$2,720", "$12.5K"
+  3: 12,
+  // "$1,234,567"
+  4: 16
+  // "$1,234,567.89"
+};
+function h(t) {
+  return t <= 1 ? f[1] : t >= 4 ? f[4] : f[t] ?? f[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 };
+  }
+  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 };
+}
+function T(t) {
+  if (t == null || t === 0)
     return { text: "0%", direction: "flat" };
-  const t = e > 0 ? "up" : e < 0 ? "down" : "flat", n = Math.abs(e);
-  return { text: n >= 3 ? `${Math.round(n)}%` : `${n.toFixed(1)}%`, direction: t };
+  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 d(e, t) {
-  if (!e || !t) return "";
-  const n = e.toLocaleDateString("en-US", { month: "short" }), a = t.toLocaleDateString("en-US", { month: "short" }), s = e.getDate(), r = t.getDate(), o = e.getFullYear(), i = t.getFullYear();
-  return e.getTime() === t.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}`;
+function y(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}`;
 }
-function p(e, t) {
-  const n = e.toLocaleDateString("en-US", { month: "short" }), a = t.toLocaleDateString("en-US", { month: "short" }), s = e.getDate(), r = t.getDate();
+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 T(e, t = /* @__PURE__ */ new Date()) {
-  return !e?.startDate || !e?.endDate ? !1 : t >= e.startDate && t <= e.endDate;
+function R(t, e = /* @__PURE__ */ new Date()) {
+  return !t?.startDate || !t?.endDate ? !1 : e >= t.startDate && e <= t.endDate;
 }
-function P(e, t) {
-  return !e || !t ? !1 : e.getFullYear() === t.getFullYear() && e.getMonth() === t.getMonth() && e.getDate() === t.getDate();
+function P(t, e) {
+  return !t || !e ? !1 : t.getFullYear() === e.getFullYear() && t.getMonth() === e.getMonth() && t.getDate() === e.getDate();
 }
-function R(e, t, n) {
-  if (!e || !t || !n) return !1;
-  const a = e.getTime(), s = t.getTime(), r = n.getTime();
+function F(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);
 }
-function M() {
+function L() {
   return `custom-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
 }
 export {
-  v as DEFAULT_MARKET_PRESETS,
-  F as DEFAULT_PINNED,
-  I as PERIOD_OPTIONS,
-  O as PRESET_ID_MAP,
-  U as PRESET_ID_REVERSE_MAP,
+  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,
-  b as TODAY_PRESET,
-  f as V1_1_EDGE_HOVER_RESIZE_ENV,
-  l as V1_1_STATUS_MODE_ENV,
-  A as detectPreset,
-  N as findPreset,
-  d as formatDateRange,
-  Y as formatDateRangeSmart,
-  G as formatDateRangeWithPreset,
-  z as formatDuration,
-  p as formatMarketDates,
-  k as formatPreset,
-  H as formatShortYear,
-  Z as formatSingleDate,
-  E as formatTrend,
-  m as formatValue,
-  M as generateMarketId,
-  x as getAllPresets,
-  B as getDateRangeDisplayInfo,
-  C as getDateRangeForPreset,
-  K as getDurationDays,
-  X as getPresetDateRange,
-  j as getPresetLabel,
-  h as getValueFontSize,
+  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,
+  E as getValueFontSize,
   D as isEdgeHoverResizeEnabled,
-  R as isInRange,
-  T as isMarketActive,
+  F as isInRange,
+  R as isMarketActive,
   P as isSameDay,
   _ as isStatusModeEnabled,
-  q as isValidDateRangeFormat,
-  W as normalizePresetId,
-  J as parseDateRange,
-  Q as resolveEvent,
-  w as resolvePreset,
-  ee as smartDateFormat,
-  te as stripLeadingZeros,
-  ne as toUppercasePresetId,
+  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,
   $ as v1_1_status_mode
 };

package/lib/formatValue.d.ts

@@ -37,4 +37,34 @@ export declare function formatValue(raw: number | string | null | undefined, { p
  * ```
  */
 export declare function getValueFontSize(length: number, colSpan?: number | null): number;
+export type MetricTier = 'wide' | 'medium' | 'narrow' | 'very-narrow';
+export interface PickMetricTierResult {
+    /** The display string at the chosen tier (e.g. `$2.7K`). */
+    formatted: string;
+    /** Which tier of the ladder produced `formatted`. Drives data-tier in MetricCard. */
+    tier: MetricTier;
+    /** `formatted.length`, for downstream `getValueFontSize`. */
+    length: number;
+}
+/**
+ * Walk Wide → Medium → Narrow → VeryNarrow and return the first format whose
+ * length fits CHAR_BUDGETS[colSpan]. Synchronous, prop-driven, content-aware.
+ *
+ * - Wide:        full locale string with decimals  (e.g. `$2,720.00`)
+ * - Medium:      full locale string, no decimals   (e.g. `$2,720`)
+ * - Narrow:      alpha-suffix abbreviated         (e.g. `$2.7K`)
+ * - VeryNarrow:  alpha-suffix abbreviated; the SCSS title-clamp toggle
+ *                fires on this tier even if VeryNarrow's string === Narrow's
+ *
+ * NOT a measurement loop. NO ResizeObserver. NO getBoundingClientRect.
+ *
+ * @example
+ * ```ts
+ * import { pickMetricTier } from '@mt-gloss/utils';
+ *
+ * const r = pickMetricTier(2720, { prefix: '$' }, 1);
+ * // r.tier === 'narrow', r.formatted === '$2.7K'
+ * ```
+ */
+export declare function pickMetricTier(value: number | string | null | undefined, options?: FormatValueOptions, colSpan?: number): PickMetricTierResult;
 //# sourceMappingURL=formatValue.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mt-gloss/utils",
-  "version": "0.1.64",
+  "version": "0.1.66",
   "type": "module",
   "publishConfig": {
     "access": "restricted"