meticulous-ui 3.2.0 → 3.2.2

package/README.md

@@ -393,6 +393,7 @@ import blue from 'meticulous-ui/colors/blue';
 
 | Function            | Signature               | Description                                                         |
 | ------------------- | ----------------------- | ------------------------------------------------------------------- |
+| `capFirstLetter`    | `(str) → string`        | Takes a string and returns with first letter capitalised            |
 | `capitalize`        | `(str) → string`        | Uppercases first character, lowercases the rest                     |
 | `titleCase`         | `(str) → string`        | Capitalizes the first letter of every word                          |
 | `camelCase`         | `(str) → string`        | Converts to `camelCase` from spaces, hyphens, or underscores        |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meticulous-ui",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "license": "MIT",
   "description": "A comprehensive React UI component library with a wide range of customizable components, icons, colors, and utilities for building modern web applications.",
   "main": "./index.js",

package/utils/addDays.js

@@ -0,0 +1,7 @@
+const n = (e, a) => {
+  const t = e instanceof Date ? new Date(e) : new Date(e);
+  return t.setDate(t.getDate() + a), t;
+};
+export {
+  n as default
+};

package/utils/capFirstLetter.js

@@ -0,0 +1,4 @@
+const t = (e) => typeof e != "string" || e.length === 0 ? e : e.charAt(0).toUpperCase() + e.slice(1);
+export {
+  t as default
+};

package/utils/clamp.js

@@ -0,0 +1,4 @@
+const c = (a, t, m) => Math.min(Math.max(a, t), m);
+export {
+  c as default
+};

package/utils/countdown.js

@@ -0,0 +1,12 @@
+const a = (t) => {
+  const n = t instanceof Date ? t : new Date(t), o = Math.max(0, n.getTime() - Date.now());
+  return {
+    days: Math.floor(o / 864e5),
+    hours: Math.floor(o % 864e5 / 36e5),
+    minutes: Math.floor(o % 36e5 / 6e4),
+    seconds: Math.floor(o % 6e4 / 1e3)
+  };
+};
+export {
+  a as default
+};

package/utils/differenceInDays.js

@@ -0,0 +1,7 @@
+const o = (e, t) => {
+  const n = e instanceof Date ? e : new Date(e), a = t instanceof Date ? t : new Date(t);
+  return Math.round((a.getTime() - n.getTime()) / 864e5);
+};
+export {
+  o as default
+};

package/utils/formatCompactNumber.js

@@ -0,0 +1,6 @@
+const r = (t, o = "en-US") => typeof t != "number" ? t : new Intl.NumberFormat(o, { notation: "compact", compactDisplay: "short" }).format(
+  t
+);
+export {
+  r as default
+};

package/utils/formatCurrency.js

@@ -0,0 +1,4 @@
+const n = (r, e = "USD", t = "en-US") => typeof r != "number" ? r : new Intl.NumberFormat(t, { style: "currency", currency: e }).format(r);
+export {
+  n as default
+};

package/utils/formatDate.js

@@ -0,0 +1,7 @@
+const a = (e, t = "en-US") => {
+  const n = e instanceof Date ? e : new Date(e);
+  return isNaN(n) ? "" : new Intl.DateTimeFormat(t, { year: "numeric", month: "long", day: "numeric" }).format(n);
+};
+export {
+  a as default
+};

package/utils/formatNumber.js

@@ -0,0 +1,4 @@
+const t = (r, e = "en-US") => typeof r != "number" ? r : new Intl.NumberFormat(e).format(r);
+export {
+  t as default
+};

package/utils/formatTime.js

@@ -0,0 +1,7 @@
+const r = (t, n = "en-US") => {
+  const e = t instanceof Date ? t : new Date(t);
+  return isNaN(e) ? "" : new Intl.DateTimeFormat(n, { hour: "numeric", minute: "2-digit", hour12: !0 }).format(e);
+};
+export {
+  r as default
+};

package/utils/getGreetingByTime.js

@@ -0,0 +1,7 @@
+const o = () => {
+  const e = (/* @__PURE__ */ new Date()).getHours();
+  return e < 12 ? "Good morning" : e < 17 ? "Good afternoon" : "Good evening";
+};
+export {
+  o as default
+};

package/utils/index.js

@@ -1,62 +1,99 @@
-import r from "./capitalize.js";
-import o from "./camelCase.js";
-import m from "./chunk.js";
-import t from "./compose.js";
-import i from "./deepClone.js";
-import p from "./flattenObject.js";
-import e from "./generateInitials.js";
-import f from "./groupBy.js";
-import a from "./hasEqualProps.js";
-import s from "./isEmpty.js";
-import n from "./isEqual.js";
-import l from "./isNonEmptyArray.js";
-import c from "./kebabCase.js";
-import u from "./keyBy.js";
-import y from "./maskEmail.js";
-import k from "./maskPhone.js";
-import E from "./mergeDeep.js";
-import d from "./omit.js";
-import C from "./pick.js";
-import g from "./randomInt.js";
-import B from "./randomValue.js";
-import b from "./removeExtraSpaces.js";
-import h from "./slugify.js";
-import q from "./snakeCase.js";
-import x from "./sortBy.js";
-import I from "./titleCase.js";
-import P from "./truncate.js";
-import j from "./uniqueBy.js";
-const mr = {
+import r from "./capFirstLetter.js";
+import o from "./capitalize.js";
+import m from "./camelCase.js";
+import t from "./chunk.js";
+import i from "./clamp.js";
+import p from "./compose.js";
+import f from "./deepClone.js";
+import e from "./flattenObject.js";
+import a from "./formatCompactNumber.js";
+import n from "./formatCurrency.js";
+import s from "./formatDate.js";
+import c from "./formatNumber.js";
+import u from "./formatTime.js";
+import y from "./generateInitials.js";
+import l from "./getGreetingByTime.js";
+import d from "./groupBy.js";
+import g from "./hasEqualProps.js";
+import k from "./addDays.js";
+import C from "./countdown.js";
+import B from "./differenceInDays.js";
+import E from "./isEmpty.js";
+import b from "./isEqual.js";
+import D from "./isNonEmptyArray.js";
+import T from "./isPast.js";
+import h from "./isToday.js";
+import q from "./kebabCase.js";
+import x from "./keyBy.js";
+import I from "./maskEmail.js";
+import N from "./maskPhone.js";
+import P from "./mergeDeep.js";
+import w from "./omit.js";
+import A from "./percentage.js";
+import j from "./pick.js";
+import v from "./randomBetween.js";
+import z from "./randomInt.js";
+import F from "./randomValue.js";
+import G from "./removeExtraSpaces.js";
+import L from "./roundTo.js";
+import O from "./slugify.js";
+import S from "./snakeCase.js";
+import V from "./sortBy.js";
+import H from "./timeAgo.js";
+import J from "./titleCase.js";
+import K from "./truncate.js";
+import M from "./uniqueBy.js";
+const Gr = {
+  // string
   capFirstLetter: r,
-  capitalize: r,
-  camelCase: o,
-  chunk: m,
-  compose: t,
-  deepClone: i,
-  flattenObject: p,
-  generateInitials: e,
-  groupBy: f,
-  hasEqualProps: a,
-  isEmpty: s,
-  isEqual: n,
-  isNonEmptyArray: l,
-  kebabCase: c,
-  keyBy: u,
-  maskEmail: y,
-  maskPhone: k,
-  mergeDeep: E,
-  omit: d,
-  pick: C,
-  randomInt: g,
-  randomValue: B,
-  removeExtraSpaces: b,
-  slugify: h,
-  snakeCase: q,
-  sortBy: x,
-  titleCase: I,
-  truncate: P,
-  uniqueBy: j
+  capitalize: o,
+  camelCase: m,
+  generateInitials: y,
+  kebabCase: q,
+  maskEmail: I,
+  maskPhone: N,
+  removeExtraSpaces: G,
+  slugify: O,
+  snakeCase: S,
+  titleCase: J,
+  truncate: K,
+  // number
+  clamp: i,
+  formatCompactNumber: a,
+  formatCurrency: n,
+  formatNumber: c,
+  percentage: A,
+  randomBetween: v,
+  randomInt: z,
+  randomValue: F,
+  roundTo: L,
+  // date-time
+  addDays: k,
+  countdown: C,
+  differenceInDays: B,
+  formatDate: s,
+  formatTime: u,
+  getGreetingByTime: l,
+  isPast: T,
+  isToday: h,
+  timeAgo: H,
+  // object / array
+  chunk: t,
+  compose: p,
+  deepClone: f,
+  flattenObject: e,
+  groupBy: d,
+  hasEqualProps: g,
+  isEmpty: E,
+  isEqual: b,
+  isNonEmptyArray: D,
+  keyBy: x,
+  mergeDeep: P,
+  omit: w,
+  pick: j,
+  sortBy: V,
+  uniqueBy: M
 };
 export {
-  mr as default
+  Gr as default
 };

package/utils/isPast.js

@@ -0,0 +1,4 @@
+const n = (t) => (t instanceof Date ? t : new Date(t)).getTime() < Date.now();
+export {
+  n as default
+};

package/utils/isToday.js

@@ -0,0 +1,7 @@
+const a = (t) => {
+  const e = t instanceof Date ? t : new Date(t), n = /* @__PURE__ */ new Date();
+  return e.getFullYear() === n.getFullYear() && e.getMonth() === n.getMonth() && e.getDate() === n.getDate();
+};
+export {
+  a as default
+};

package/utils/percentage.js

@@ -0,0 +1,7 @@
+const t = (r, e, n = 2) => typeof r != "number" || typeof e != "number" || e === 0 ? 0 : o(r / e * 100, n), o = (r, e) => {
+  const n = Math.pow(10, e);
+  return Math.round(r * n) / n;
+};
+export {
+  t as default
+};

package/utils/randomBetween.js

@@ -0,0 +1,4 @@
+const t = (a, e) => Math.random() * (e - a) + a;
+export {
+  t as default
+};

package/utils/roundTo.js

@@ -0,0 +1,8 @@
+const e = (t, r = 0) => {
+  if (typeof t != "number") return t;
+  const o = Math.pow(10, r);
+  return Math.round(t * o) / o;
+};
+export {
+  e as default
+};

package/utils/timeAgo.js

@@ -0,0 +1,15 @@
+const f = (a) => {
+  const u = a instanceof Date ? a : new Date(a), n = Math.floor((Date.now() - u.getTime()) / 1e3), t = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
+  if (Math.abs(n) < 60) return t.format(-Math.round(n), "second");
+  const o = Math.round(n / 60);
+  if (Math.abs(o) < 60) return t.format(-o, "minute");
+  const r = Math.round(o / 60);
+  if (Math.abs(r) < 24) return t.format(-r, "hour");
+  const e = Math.round(r / 24);
+  if (Math.abs(e) < 30) return t.format(-e, "day");
+  const s = Math.round(e / 30);
+  return Math.abs(s) < 12 ? t.format(-s, "month") : t.format(-Math.round(s / 12), "year");
+};
+export {
+  f as default
+};