@grapadigital/shared-app-modules 0.0.83 → 0.0.84

package/dist/utils.d.ts

@@ -1,3 +1,39 @@
+/**
+ * Formata um número em notação compacta usando o locale pt-BR.
+ *
+ * Converte números grandes para formas abreviadas, como "mil", "mi" e "bi",
+ * seguindo o padrão brasileiro de formatação.
+ *
+ * @param {number} value - O número a ser formatado.
+ * @returns {string} O número formatado em notação compacta.
+ *
+ * @example
+ * formatCompactNumber(950); // "950"
+ * formatCompactNumber(1200); // "1,2 mil"
+ * formatCompactNumber(1500000); // "1,5 mi"
+ * formatCompactNumber(2300000000); // "2,3 bi"
+ * formatCompactNumber(1234.5678); // "1,235 mil"
+ */
+export declare const formatCompactNumber: (value: number) => string;
+
+/**
+ * Formata um número como porcentagem em notação compacta usando o locale pt-BR.
+ *
+ * O valor deve ser informado em formato decimal, onde 1 = 100%.
+ * A API automaticamente multiplica por 100 ao usar `style: "percent"`.
+ *
+ * @param {number} value - O valor decimal a ser formatado como porcentagem.
+ * @returns {string} A porcentagem formatada em notação compacta.
+ *
+ * @example
+ * formatCompactPercent(0.25); // "25%"
+ * formatCompactPercent(0.1234); // "12,34%"
+ * formatCompactPercent(1); // "100%"
+ * formatCompactPercent(12); // "1,2 mil%"
+ * formatCompactPercent(0.0005); // "0,05%"
+ */
+export declare const formatCompactPercent: (value: number) => string;
+
 export declare function formatCurrency(value: number): string;
 
 /**

package/dist/utils.js

@@ -1,29 +1,29 @@
-function t(e) {
+function n(e) {
   return !isNaN(Number(e));
 }
-function u(e) {
+function a(e) {
   const r = e.replace(/[^0-9]/g, "");
   return Number(r) / 100;
 }
-function a(e) {
+function u(e) {
   return e.toLocaleString("pt-BR", {
     style: "currency",
     currency: "BRL"
   });
 }
-const i = (e) => {
-  const r = t(e) ? e : Number(e);
+const m = (e) => {
+  const r = n(e) ? e : Number(e);
   return `${parseInt(String(r * 100))}%`;
-}, l = (e) => {
+}, i = (e) => {
   const r = +String(e).replace("%", "");
-  if (!t(r)) return !1;
-  const n = r / 100;
-  return +String(n).split(".")[0] >= 1 ? 1 : n;
+  if (!n(r)) return !1;
+  const t = r / 100;
+  return +String(t).split(".")[0] >= 1 ? 1 : t;
 };
 function o(e) {
   return e.replace(/\D/g, "").replace(/^(\d{3})(\d{3})(\d{3})(\d{2})$/, "$1.$2.$3-$4");
 }
-function m(e) {
+function l(e) {
   return e.replace(/\D/g, "").replace(/^(\d{2})(\d{3})(\d{3})(\d{1})$/, "$1.$2.$3-$4");
 }
 function s(e) {
@@ -32,21 +32,36 @@ function s(e) {
     "$1.$2.$3/$4-$5"
   );
 }
-function d(e) {
+function p(e) {
   return e.replace(/\D/g, "").replace(/^(\d{5})(\d{3})$/, "$1-$2");
 }
-function p(e) {
+function d(e) {
   return e.replace(/\D/g, "");
 }
+const $ = (e) => new Intl.NumberFormat("pt-BR", {
+  style: "decimal",
+  notation: "compact",
+  compactDisplay: "short",
+  minimumFractionDigits: 0,
+  maximumFractionDigits: 3
+}).format(e), f = (e) => new Intl.NumberFormat("pt-BR", {
+  style: "percent",
+  notation: "compact",
+  compactDisplay: "short",
+  minimumFractionDigits: 0,
+  maximumFractionDigits: 2
+}).format(e);
 export {
-  a as formatCurrency,
-  i as formatPercentage,
-  t as isNumber,
+  $ as formatCompactNumber,
+  f as formatCompactPercent,
+  u as formatCurrency,
+  m as formatPercentage,
+  n as isNumber,
   s as maskCNPJ,
   o as maskCPF,
-  m as maskRG,
-  d as maskZipCode,
-  u as preFormatCurrency,
-  l as preFormatPercentage,
-  p as unmask
+  l as maskRG,
+  p as maskZipCode,
+  a as preFormatCurrency,
+  i as preFormatPercentage,
+  d as unmask
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@grapadigital/shared-app-modules",
   "private": false,
-  "version": "0.0.83",
+  "version": "0.0.84",
   "files": [
     "dist"
   ],