nfx-ui 0.5.2 → 0.6.1

package/dist/utils.d.ts

@@ -14,6 +14,12 @@ declare interface ApiErrorBody {
     traceId?: string;
 }
 
+/**
+ * 数组类型。Array type.
+ * @example Array<string> => string[]
+ */
+declare type Array_2<T> = T[];
+
 /** 可实例化的构造函数类型。Instantiable constructor type. */
 declare type Constructor<T extends object = object> = new (...args: unknown[]) => T;
 
@@ -28,6 +34,12 @@ declare type Constructor<T extends object = object> = new (...args: unknown[]) =
  */
 export declare function createMap<T extends string, V = T>(list: ReadonlyArray<T>, valueMapper?: (item: T, index: number) => V): Record<T, V>;
 
+/**
+ * 可为 null、undefined 或空字符串。Emptyable: T | null | undefined | "".
+ * @example Emptyable<string> => string | null | undefined | ""
+ */
+declare type Emptyable<T> = T | null | undefined | "";
+
 /**
  * 构造失败结果（非 Error 会包装为 Error）。Create a failed result; non-Error wrapped in Error.
  * @param e - 错误或任意值。Error or any value.
@@ -164,6 +176,12 @@ export declare const isValidEmail: (email: string) => boolean;
  */
 export declare const isValidPhoneNumber: (phoneNumber: string) => boolean;
 
+/**
+ * 可为 undefined。Maybe: T | undefined.
+ * @example Maybe<number> => number | undefined
+ */
+declare type Maybe<T> = T | undefined;
+
 /**
  * 按 id 将 items 合并进数组：insert 仅插入新 id，upsert 覆盖同 id 并插入新 id；可 prepend 或 append
  * Merge items into array by id: insert = only new ids, upsert = overwrite same id + insert new; place = prepend | append.
@@ -174,16 +192,16 @@ export declare const isValidPhoneNumber: (phoneNumber: string) => boolean;
  * @param mode - insert 不覆盖已有 id；upsert 覆盖同 id
  * @returns 合并后的新数组
  */
-export declare function mergeById<T>(arr: T[], items: T[], idOf: (x: T) => string, place: "prepend" | "append", mode: "insert" | "upsert"): T[];
+export declare function mergeById<T>(arr: Array_2<T>, items: Array_2<T>, idOf: (x: T) => string, place: "prepend" | "append", mode: "insert" | "upsert"): Array_2<T>;
 
 /**
- * 可为 null 或 undefined。T | null | undefined.
+ * 可为 null 或 undefined。Nilable: T | null | undefined.
  * @example Nilable<boolean> => boolean | null | undefined
  */
 declare type Nilable<T> = T | null | undefined;
 
 /**
- * 可为 null 或 undefined。T | null | undefined.
+ * 可为 null 或 undefined。Nilable: T | null | undefined.
  * @example Nilable<boolean> => boolean | null | undefined
  */
 declare type Nilable_2<T> = T | null | undefined;
@@ -196,6 +214,12 @@ declare type Nilable_2<T> = T | null | undefined;
  */
 export declare function normalizeAddress(address: string): string;
 
+/**
+ * 可为 null。Nullable: T | null.
+ * @example Nullable<string> => string | null
+ */
+declare type Nullable<T> = T | null;
+
 /**
  * 构造成功结果。Create a successful result.
  * @param v - 结果值。Result value.
@@ -253,7 +277,7 @@ export declare function pollUntil<T>(fetcher: () => Promise<T>, isOK: (data: T)
  * @param idOf - 取 id 的函数
  * @returns 若无变化返回原数组，否则返回新数组
  */
-export declare function pruneArray<T>(arr: T[], ids: ReadonlySet<string>, idOf: (x: T) => string): T[];
+export declare function pruneArray<T>(arr: Array_2<T>, ids: ReadonlySet<string>, idOf: (x: T) => string): Array_2<T>;
 
 export declare function removeItem(key: string): void;
 
@@ -276,6 +300,82 @@ export declare type Result<T> = [T, null] | [null, Error];
  */
 export declare const rgbToRgba: (rgb: string, alpha: number) => string;
 
+/**
+ * 将 Nilable 数组规范为数组：null/undefined 转为 [] 或 defaultValue。返回类型 Array&lt;T&gt;（即 T[]）。
+ * Normalize Nilable array to array: null/undefined to [] or defaultValue. Returns Array&lt;T&gt; (i.e. T[]).
+ * @param value - 可能为 null 或 undefined 的数组 (array that may be null or undefined)
+ * @param defaultValue - 可选，当 value 为 null/undefined 时使用；缺省为 [] (optional default when value is null/undefined; default is [])
+ * @returns value ?? defaultValue ?? [] (never null/undefined)
+ * @example safeArray(product.tags) // product.tags ?? []
+ * @example safeArray(product.tags, ['default'])
+ */
+export declare function safeArray<T>(value: Nilable_2<Array_2<T>>, defaultValue?: Array_2<T>): Array_2<T>;
+
+/**
+ * 将 Nilable 规范为 Maybe：null 转为 undefined，undefined 与 T 原样返回。返回类型 Maybe&lt;T&gt;。等同 value ?? undefined。
+ * Normalize Nilable to Maybe: convert null to undefined; undefined and T unchanged. Returns Maybe&lt;T&gt;. Same as value ?? undefined.
+ * @param value - 可能为 null 或 undefined 的值 (value that may be null or undefined)
+ * @returns 若为 null 或 undefined 则 undefined，否则原值 (undefined if null/undefined, otherwise value)
+ * @example safeMaybe(product.price) // 代替 product.price ?? undefined
+ */
+export declare function safeMaybe<T>(value: Nilable_2<T>): Maybe<T>;
+
+/**
+ * 将 Emptyable 字符串规范为 Nilable：空字符串转为 undefined，null/undefined/非空串原样。返回类型 Nilable&lt;T&gt;。常用于表单、接口字段。
+ * Normalize Emptyable string to Nilable: "" to undefined; null, undefined, non-empty string unchanged. Returns Nilable&lt;T&gt;. For form/API fields.
+ * @param value - 可能为 null、undefined 或空字符串 (value that may be null, undefined or "")
+ * @returns 若为 "" 则 undefined，否则原值 (undefined if "", otherwise value)
+ * @example safeNilable(product.remark) // "" 也视为「无值」
+ */
+export declare function safeNilable<T extends string>(value: Emptyable<T>): Nilable_2<T>;
+
+/**
+ * 将 Nilable 规范为 Nullable：undefined 转为 null，null 与 T 原样返回。返回类型 Nullable&lt;T&gt;。
+ * Normalize Nilable to Nullable: convert undefined to null; null and T unchanged. Returns Nullable&lt;T&gt;.
+ * @param value - 可能为 null 或 undefined 的值 (value that may be null or undefined)
+ * @returns 若为 undefined 则 null，否则原值 (null if undefined, otherwise value)
+ * @example safeNullable(apiResponse.data) // undefined → null，便于区分「未设置」与「空」
+ */
+export declare function safeNullable<T>(value: Nilable_2<T>): Nullable<T>;
+
+/**
+ * 安全取数字：null/undefined/NaN 转为 undefined，合法数字原样。返回类型 Maybe&lt;number&gt;。
+ * Safe number: null/undefined/NaN to undefined; valid number unchanged. Returns Maybe&lt;number&gt;.
+ * @param value - 可能为 null、undefined 或非数字 (value that may be null, undefined or NaN)
+ * @returns 若为 null、undefined 或 NaN 则 undefined，否则数字 (undefined if null/undefined/NaN, otherwise number)
+ * @example safeNum(product.price) // 用于严格「有值才用」的场景
+ */
+export declare function safeNum(value: Nilable_2<number>): Maybe<number>;
+
+/**
+ * 若值为 null/undefined 则返回默认值，否则返回原值。等同 value ?? defaultValue。
+ * Return defaultValue when value is null/undefined, otherwise value. Same as value ?? defaultValue.
+ * @param value - 可能为 null 或 undefined 的值 (value that may be null or undefined)
+ * @param defaultValue - 默认值 (default value)
+ * @returns value ?? defaultValue
+ * @example safeOr(product.stock, 0)
+ * @example safeOr(product.name, '')
+ */
+export declare function safeOr<T, D>(value: Nilable_2<T>, defaultValue: D): T | D;
+
+/**
+ * 将 Emptyable 字符串规范为 Stringable：null/undefined/"" 转为 ""。返回类型 Stringable&lt;string&gt;（即 string，"" 为兜底）。
+ * Normalize Emptyable string to Stringable: null/undefined/"" to "". Returns Stringable&lt;string&gt; (string with "" as fallback).
+ * @param value - 可能为 null、undefined 或空字符串 (value that may be null, undefined or "")
+ * @returns 若为 null、undefined 或 "" 则 ""，否则原值 ("" if null/undefined/"", otherwise value)
+ * @example safeStringable(product.name) // 代替 product.name ?? ""
+ */
+export declare function safeStringable<T extends string>(value: Emptyable<T>): Stringable<T>;
+
+/**
+ * 将 Nilable 数值规范为 Zeroable：null/undefined 转为 0。返回类型 Zeroable&lt;number&gt;（即 number，0 为兜底）。
+ * Normalize Nilable number to Zeroable: null/undefined to 0. Returns Zeroable&lt;number&gt; (number with 0 as fallback).
+ * @param value - 可能为 null 或 undefined 的数值 (number that may be null or undefined)
+ * @returns value ?? 0 (never null/undefined)
+ * @example safeZeroable(product.stock) // 代替 product.stock ?? 0
+ */
+export declare function safeZeroable(value: Nilable_2<number>): Zeroable<number>;
+
 export declare function setItem(key: string, value: string): void;
 
 /**
@@ -297,6 +397,12 @@ export declare function setItem(key: string, value: string): void;
  */
 export declare const singleton: <T extends object>(className: Constructor<T>) => Constructor<T>;
 
+/**
+ * 可为空字符串的类型。Stringable: T | ""，T 为 string 子类型。
+ * @example Stringable<string> => string | ""
+ */
+declare type Stringable<T extends string> = T | "";
+
 /**
  * 若值为 null/undefined 则抛出 Promise 使 React Suspense 挂起，否则返回该值。
  * If value is null/undefined, throw a promise to suspend (React Suspense); otherwise return value.
@@ -371,4 +477,10 @@ export declare type WithRetryOptions = Options & {
  */
 export declare function withRetryResult<T>(fn: (bail: (e: Error) => void, attempt: number) => Promise<T>, opts?: WithRetryOptions): Promise<Result<T>>;
 
+/**
+ * 可为 0 的数值类型。Zeroable: T | 0，T 为 number 子类型。
+ * @example Zeroable<number> => number | 0
+ */
+declare type Zeroable<T extends number> = T | 0;
+
 export { }

package/dist/utils.mjs

@@ -30,106 +30,106 @@ function U(t, r, e, o, n) {
   if (r.length === 0) return t;
   switch (n) {
     case "insert":
-      return w(t, r, e, o);
+      return b(t, r, e, o);
     case "upsert":
-      return S(t, r, e, o);
+      return w(t, r, e, o);
   }
 }
-function w(t, r, e, o) {
-  const n = new Set(t.map(e)), i = r.filter((s) => {
-    const a = e(s);
+function b(t, r, e, o) {
+  const n = new Set(t.map(e)), s = r.filter((i) => {
+    const a = e(i);
     return n.has(a) ? !1 : (n.add(a), !0);
   });
-  return i.length === 0 ? t : o === "prepend" ? [...i, ...t] : [...t, ...i];
+  return s.length === 0 ? t : o === "prepend" ? [...s, ...t] : [...t, ...s];
 }
-function S(t, r, e, o) {
+function w(t, r, e, o) {
   const n = /* @__PURE__ */ new Map();
-  t.forEach((u, c) => n.set(e(u), c));
-  let i = !1;
-  const s = t.slice();
+  t.forEach((u, f) => n.set(e(u), f));
+  let s = !1;
+  const i = t.slice();
   for (const u of r) {
-    const c = e(u), f = n.get(c);
-    f !== void 0 && s[f] !== u && (s[f] = u, i = !0);
+    const f = e(u), c = n.get(f);
+    c !== void 0 && i[c] !== u && (i[c] = u, s = !0);
   }
   const a = [];
   for (const u of r) {
-    const c = e(u);
-    n.has(c) || a.push(u);
+    const f = e(u);
+    n.has(f) || a.push(u);
   }
-  return a.length > 0 ? (i = !0, o === "prepend" ? [...a, ...s] : [...s, ...a]) : i ? s : t;
+  return a.length > 0 ? (s = !0, o === "prepend" ? [...a, ...i] : [...i, ...a]) : s ? i : t;
 }
 function H(t, r, e) {
   let o = !1;
-  const n = t.filter((i) => {
-    const s = !r.has(e(i));
-    return s || (o = !0), s;
+  const n = t.filter((s) => {
+    const i = !r.has(e(s));
+    return i || (o = !0), i;
   });
   return o ? n : t;
 }
 const V = (t, r) => {
   const e = t.match(/rgba?\((\d+),\s*(\d+),\s*(\d+)(?:,\s*[\d.]+)?\)/);
   if (e) {
-    const [, o, n, i] = e;
-    return `rgba(${o}, ${n}, ${i}, ${r})`;
+    const [, o, n, s] = e;
+    return `rgba(${o}, ${n}, ${s}, ${r})`;
   }
-  return b(t, r);
+  return S(t, r);
 }, K = (t, r) => {
   if (t.startsWith("rgba")) return t;
   const e = t.match(/rgb\((\d+),\s*(\d+),\s*(\d+)\)/);
   if (e) {
-    const [, o, n, i] = e;
-    return `rgba(${o}, ${n}, ${i}, ${r})`;
+    const [, o, n, s] = e;
+    return `rgba(${o}, ${n}, ${s}, ${r})`;
   }
   return console.warn("Invalid RGB color format:", t), t;
-}, b = (t, r) => {
+}, S = (t, r) => {
   if (t.indexOf("rgb") !== -1) return t;
   let e = 0, o = 0, n = 0;
   return t.startsWith("#") && (t = t.slice(1)), t.length === 3 ? (e = parseInt(t[0] + t[0], 16), o = parseInt(t[1] + t[1], 16), n = parseInt(t[2] + t[2], 16)) : t.length === 6 ? (e = parseInt(t.slice(0, 2), 16), o = parseInt(t.slice(2, 4), 16), n = parseInt(t.slice(4, 6), 16)) : console.warn("Unsupported HEX color format"), `rgba(${e}, ${o}, ${n}, ${r})`;
-}, Y = (t, r, e) => {
-  const o = (f) => {
-    const g = f.match(/^#?([\da-f]{2})([\da-f]{2})([\da-f]{2})$/i);
-    if (g) return [
-      parseInt(g[1], 16),
-      parseInt(g[2], 16),
-      parseInt(g[3], 16)
+}, O = (t, r, e) => {
+  const o = (c) => {
+    const d = c.match(/^#?([\da-f]{2})([\da-f]{2})([\da-f]{2})$/i);
+    if (d) return [
+      parseInt(d[1], 16),
+      parseInt(d[2], 16),
+      parseInt(d[3], 16)
     ];
-    const d = f.match(/^rgb\((\d{1,3}),\s*(\d{1,3}),\s*(\d{1,3})\)$/i);
-    return d ? [
-      parseInt(d[1]),
-      parseInt(d[2]),
-      parseInt(d[3])
+    const l = c.match(/^rgb\((\d{1,3}),\s*(\d{1,3}),\s*(\d{1,3})\)$/i);
+    return l ? [
+      parseInt(l[1]),
+      parseInt(l[2]),
+      parseInt(l[3])
     ] : [
       0,
       0,
       0
     ];
-  }, [n, i, s] = o(t), [a, u, c] = o(r);
-  return `rgb(${Math.round(n + (a - n) * e)}, ${Math.round(i + (u - i) * e)}, ${Math.round(s + (c - s) * e)})`;
-}, _ = (t) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(t);
-function O(t) {
+  }, [n, s, i] = o(t), [a, u, f] = o(r);
+  return `rgb(${Math.round(n + (a - n) * e)}, ${Math.round(s + (u - s) * e)}, ${Math.round(i + (f - i) * e)})`;
+}, Y = (t) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(t);
+function _(t) {
   return typeof t == "string" ? t : t == null ? "" : typeof t == "number" || typeof t == "boolean" ? String(t) : Array.isArray(t) ? t.map((r) => String(r)).join(", ") : typeof t == "object" ? JSON.stringify(t) : String(t);
 }
 function W(t) {
   return t == null ? "" : typeof t == "number" ? Number.isFinite(t) ? String(t) : "" : typeof t == "string" ? t : typeof t == "boolean" ? t ? "1" : "0" : Array.isArray(t) && t.length > 0 ? String(t[0]) : "";
 }
 function q(t, r, ...e) {
-  const o = {}, n = Array.isArray(r) ? r : [r, ...e], i = new Set(n);
-  for (const s of Object.keys(t)) i.has(s) || (o[s] = t[s]);
+  const o = {}, n = Array.isArray(r) ? r : [r, ...e], s = new Set(n);
+  for (const i of Object.keys(t)) s.has(i) || (o[i] = t[i]);
   return o;
 }
-var l = m.getInstance();
-const G = (t) => l.parseAndKeepRawInput(t).getCountryCode(), J = (t) => {
+var g = m.getInstance();
+const G = (t) => g.parseAndKeepRawInput(t).getCountryCode(), J = (t) => {
   if (!t || !t.replace(/\D/g, "").length) return !1;
   try {
-    const r = l.parseAndKeepRawInput(t);
-    return l.isValidNumber(r);
+    const r = g.parseAndKeepRawInput(t);
+    return g.isValidNumber(r);
   } catch {
     return !1;
   }
-}, I = (t) => [t, null], M = (t) => [null, t instanceof Error ? t : new Error(String(t))];
-async function A(t, r) {
+}, N = (t) => [t, null], I = (t) => [null, t instanceof Error ? t : new Error(String(t))];
+async function M(t, r) {
   try {
-    return I(await h(async (e, o) => {
+    return N(await h(async (e, o) => {
       try {
         return await t(e, o);
       } catch (n) {
@@ -137,41 +137,67 @@ async function A(t, r) {
       }
     }, r));
   } catch (e) {
-    return M(e);
+    return I(e);
   }
 }
 async function z(t, r, e) {
-  return A(async (o, n) => {
-    const i = await t();
-    if (!r(i)) throw new Error("Condition not satisfied");
-    return i;
+  return M(async (o, n) => {
+    const s = await t();
+    if (!r(s)) throw new Error("Condition not satisfied");
+    return s;
   }, e);
 }
 function L(t) {
   return Math.round(Number(t) * 100);
 }
-function D(t) {
+function A(t) {
   return (Number(t) / 100).toFixed(2);
 }
 function X(t) {
-  return Number(D(t));
+  return Number(A(t));
 }
-function x(t) {
+function Z(t) {
   return t < 1e3 ? t.toString() : t < 1e6 ? `${(t / 1e3).toFixed(1).replace(/\.0$/, "")}k+` : t < 1e9 ? `${(t / 1e6).toFixed(1).replace(/\.0$/, "")}M+` : `${(t / 1e9).toFixed(1).replace(/\.0$/, "")}B+`;
 }
-function Q(t) {
+function x(t) {
   let r = null;
   return async (...e) => r || (r = t(...e).finally(() => r = null), r);
 }
-function Z(t, r) {
+function Q(t, r) {
   const e = /* @__PURE__ */ new Map();
   return async (...o) => {
-    const n = r(...o), i = e.get(n);
-    if (i) return i;
-    const s = t(...o).finally(() => e.delete(n));
-    return e.set(n, s), s;
+    const n = r(...o), s = e.get(n);
+    if (s) return s;
+    const i = t(...o).finally(() => e.delete(n));
+    return e.set(n, i), i;
   };
 }
+function v(t) {
+  return t === void 0 ? null : t;
+}
+function tt(t) {
+  return t ?? void 0;
+}
+function rt(t) {
+  return t === "" ? void 0 : t;
+}
+function et(t, r) {
+  return t ?? r ?? [];
+}
+function nt(t) {
+  return t ?? 0;
+}
+function ot(t) {
+  return t == null || t === "" ? "" : t;
+}
+function it(t, r) {
+  return t ?? r;
+}
+function st(t) {
+  if (t == null) return;
+  const r = Number(t);
+  return Number.isNaN(r) ? void 0 : r;
+}
 function p(t, r) {
   if (Object.is(t, r)) return !0;
   if (typeof t != typeof r) return !1;
@@ -179,33 +205,33 @@ function p(t, r) {
   const e = Array.isArray(t), o = Array.isArray(r);
   if (e !== o) return !1;
   if (e && o)
-    return t.length !== r.length ? !1 : t.every((s, a) => p(s, r[a]));
-  const n = Object.keys(t).sort(), i = Object.keys(r).sort();
-  return n.length !== i.length || !n.every((s, a) => s === i[a]) ? !1 : n.every((s) => p(t[s], r[s]));
+    return t.length !== r.length ? !1 : t.every((i, a) => p(i, r[a]));
+  const n = Object.keys(t).sort(), s = Object.keys(r).sort();
+  return n.length !== s.length || !n.every((i, a) => i === s[a]) ? !1 : n.every((i) => p(t[i], r[i]));
 }
-const v = (t) => {
+const at = (t) => {
   let r, e = [];
   return new Proxy(t, { construct(o, n) {
     if (r || (r = new t(...n), e = n), !p(n, e)) throw new Error("Cannot create multiple instances with different parameters");
     return r;
   } });
 };
-function tt(t, r = 100) {
+function ut(t, r = 100) {
   if (t == null) throw new Promise((e) => setTimeout(e, r));
   return t;
 }
-const rt = (t) => {
+const ft = (t) => {
   if (!t) return "";
   const r = new Date(t);
   return isNaN(r.getTime()) ? "" : `${r.getFullYear()}/${(r.getMonth() + 1).toString().padStart(2, "0")}/${r.getDate().toString().padStart(2, "0")}`;
-}, et = (t) => {
+}, ct = (t) => {
   if (!t) return "Unknown";
   const r = new Date(t);
   if (isNaN(r.getTime())) return "Invalid date";
-  const e = (/* @__PURE__ */ new Date()).getTime() - r.getTime(), o = Math.floor(e / 1e3), n = Math.floor(o / 60), i = Math.floor(n / 60), s = Math.floor(i / 24), a = Math.floor(s / 30), u = Math.floor(s / 365);
-  return u > 0 ? `${u} year${u > 1 ? "s" : ""} ago` : a > 0 ? `${a} month${a > 1 ? "s" : ""} ago` : s > 0 ? `${s} day${s > 1 ? "s" : ""} ago` : i > 0 ? `${i} hour${i > 1 ? "s" : ""} ago` : n > 0 ? `${n} minute${n > 1 ? "s" : ""} ago` : "Just now";
+  const e = (/* @__PURE__ */ new Date()).getTime() - r.getTime(), o = Math.floor(e / 1e3), n = Math.floor(o / 60), s = Math.floor(n / 60), i = Math.floor(s / 24), a = Math.floor(i / 30), u = Math.floor(i / 365);
+  return u > 0 ? `${u} year${u > 1 ? "s" : ""} ago` : a > 0 ? `${a} month${a > 1 ? "s" : ""} ago` : i > 0 ? `${i} day${i > 1 ? "s" : ""} ago` : s > 0 ? `${s} hour${s > 1 ? "s" : ""} ago` : n > 0 ? `${n} minute${n > 1 ? "s" : ""} ago` : "Just now";
 };
-function nt(t) {
+function dt(t) {
   try {
     return new Date(t).toLocaleDateString(void 0, {
       month: "short",
@@ -217,28 +243,28 @@ function nt(t) {
     return t;
   }
 }
-const ot = (t) => {
+const lt = (t) => {
   try {
     const r = new Date(t);
     return isNaN(r.getTime()) ? t : `${r.getFullYear()}/${String(r.getMonth() + 1).padStart(2, "0")}/${String(r.getDate()).padStart(2, "0")} ${String(r.getHours()).padStart(2, "0")}:${String(r.getMinutes()).padStart(2, "0")}`;
   } catch {
     return t;
   }
-}, st = (t) => {
+}, gt = (t) => {
   try {
     const r = new Date(t);
     return isNaN(r.getTime()) ? t : `${String(r.getMonth() + 1).padStart(2, "0")}/${String(r.getDate()).padStart(2, "0")} ${String(r.getHours()).padStart(2, "0")}:${String(r.getMinutes()).padStart(2, "0")}`;
   } catch {
     return t;
   }
-}, it = (t) => {
+}, pt = (t) => {
   try {
     const r = new Date(t);
     return isNaN(r.getTime()) ? t : `${r.getFullYear()}/${String(r.getMonth() + 1).padStart(2, "0")}/${String(r.getDate()).padStart(2, "0")}`;
   } catch {
     return t;
   }
-}, at = (t) => {
+}, yt = (t) => {
   try {
     const r = new Date(t);
     return isNaN(r.getTime()) ? t : `${String(r.getHours()).padStart(2, "0")}:${String(r.getMinutes()).padStart(2, "0")}`;
@@ -246,48 +272,56 @@ const ot = (t) => {
     return t;
   }
 };
-function ut(t, r) {
+function mt(t, r) {
   return t.reduce((e, o, n) => (e[o] = r ? r(o, n) : o, e), {});
 }
 export {
-  ut as createMap,
-  M as err,
-  it as formatDate,
-  ot as formatDateTime,
-  rt as formatDisplayDate,
-  st as formatMonthDayTime,
-  x as formatNumberAbbreviated,
-  et as formatRelativeTime,
-  nt as formatTickDate,
-  at as formatTime,
+  mt as createMap,
+  I as err,
+  pt as formatDate,
+  lt as formatDateTime,
+  ft as formatDisplayDate,
+  gt as formatMonthDayTime,
+  Z as formatNumberAbbreviated,
+  ct as formatRelativeTime,
+  dt as formatTickDate,
+  yt as formatTime,
   $ as getApiError,
   P as getApiErrorMessage,
   G as getCountryCode,
   E as getItem,
-  b as hexToRGBA,
-  Y as interpolateColor,
-  _ as isValidEmail,
+  S as hexToRGBA,
+  O as interpolateColor,
+  Y as isValidEmail,
   J as isValidPhoneNumber,
   U as mergeById,
   F as normalizeAddress,
-  I as ok,
+  N as ok,
   q as omit,
-  Q as onceAsync,
-  Z as onceAsyncByKey,
+  x as onceAsync,
+  Q as onceAsyncByKey,
   z as pollUntil,
   H as pruneArray,
   T as removeItem,
   K as rgbToRgba,
+  et as safeArray,
+  tt as safeMaybe,
+  rt as safeNilable,
+  v as safeNullable,
+  st as safeNum,
+  it as safeOr,
+  ot as safeStringable,
+  nt as safeZeroable,
   C as setItem,
-  v as singleton,
-  tt as suspenseIfNull,
+  at as singleton,
+  ut as suspenseIfNull,
   L as toDatabasePrice,
-  D as toDisplayPrice,
+  A as toDisplayPrice,
   X as toDisplayPriceNumber,
   W as toNumberInputValue,
   V as toRgbaWithAlpha,
-  O as toTextInputValue,
-  A as withRetryResult
+  _ as toTextInputValue,
+  M as withRetryResult
 };
 
 //# sourceMappingURL=utils.mjs.map