@undp/data-viz 2.3.17 → 2.4.0

package/dist/index.d.ts

@@ -1237,6 +1237,7 @@ declare interface GraphSettingsDataType {
     showVoronoiTesselation?: boolean;
     mapOverlay?: MapOverlayDataType;
     useVoronoiInteraction?: boolean;
+    locale?: string;
 }
 
 export declare function GraphTitle(props: Props_68): JSX.Element | null;
@@ -1340,6 +1341,8 @@ declare interface GroupedBarChartProps {
     naLabel?: string;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Configures playback and slider controls for animating the chart over time. The data must have a key date for it to work properly. */
@@ -1517,25 +1520,16 @@ declare interface MultiLineChartDataType {
 }
 
 /**
- * Formats a number into a human-readable string, optionally with a prefix and/or suffix.
+ * Formats a number into a human-readable string, optionally with prefix/suffix
+ * and locale-aware formatting.
  *
- * - Adds suffixes like `K`, `M`, `B`, and `T` for large numbers.
- * - If the number is less than 10,000 and an integer, it is returned as-is.
- * - If `value` is `null` or `undefined`, returns `"NA"`.
- *
- * @param value - The number to format.
- * @param precision - Optional no of digits after decimal.
- * @param prefix - Optional string to prepend.
- * @param suffix - Optional string to append.
- * @returns A formatted string.
- *
- * @example
- * numberFormattingFunction(5000); // "5000"
- * numberFormattingFunction(125000); // "125K"
- * numberFormattingFunction(3.14159, '$'); // "$3.14"
- * numberFormattingFunction(null); // "NA"
+ * Supports:
+ * - Compact notation (K, M, B, T)
+ * - Locale formatting via Intl.NumberFormat
+ * - Prefix and suffix
+ * - NA fallback
  */
-export declare function numberFormattingFunction(value: number | string | undefined | null, naLabel?: string, precision?: number, prefix?: string, suffix?: string): string;
+export declare function numberFormattingFunction(value: number | string | undefined | null, naLabel?: string, precision?: number, prefix?: string, suffix?: string, locale?: string): string;
 
 /**
  * Represents a parameter to be embedded in a URL.
@@ -1694,6 +1688,8 @@ declare interface Props {
     animate?: boolean | AnimateDataType;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Configures playback and slider controls for animating the chart over time. The data must have a key date for it to work properly. */
@@ -1817,6 +1813,8 @@ declare interface Props_10 {
     curveType?: CurveTypes;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Enable graph download option as png */
@@ -1922,6 +1920,10 @@ declare interface Props_11 {
     curveType?: CurveTypes;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
+    /** Defines how “NA” values should be displayed/labelled in the graph */
+    naLabel?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Enable graph download option as png */
@@ -2094,6 +2096,8 @@ declare interface Props_13 {
     customLayers?: CustomLayerDataType[];
     /** Configures playback and slider controls for animating the chart over time. The data must have a key date for it to work properly. */
     timeline?: TimelineDataType;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Enable graph download option as png */
     graphDownload?: boolean;
     /** Enable data download option as a csv */
@@ -2201,6 +2205,8 @@ declare interface Props_14 {
     customLayers?: CustomLayerDataType[];
     /** Configures playback and slider controls for animating the chart over time. The data must have a key date for it to work properly. */
     timeline?: TimelineDataType;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Enable graph download option as png */
     graphDownload?: boolean;
     /** Enable data download option as a csv */
@@ -2429,6 +2435,8 @@ declare interface Props_16 {
     mapProperty?: string;
     /** Configures playback and slider controls for animating the chart over time. The data must have a key date for it to work properly. */
     timeline?: TimelineDataType;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Enable graph download option as png */
     graphDownload?: boolean;
     /** Enable data download option as a csv */
@@ -2514,6 +2522,8 @@ declare interface Props_17 {
     scaleType?: Exclude<ScaleDataType, 'linear'>;
     /** Toggle visibility of color scale. */
     showColorScale?: boolean;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Toggle if color scale is collapsed by default. */
     collapseColorScaleByDefault?: boolean;
     /** The max altitude of the atmosphere, in terms of globe radius units. */
@@ -2714,6 +2724,8 @@ declare interface Props_2 {
     dimmedOpacity?: number;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Enable graph download option as png */
     graphDownload?: boolean;
     /** Enable data download option as a csv */
@@ -2889,6 +2901,8 @@ declare interface Props_21 {
     animate?: boolean | AnimateDataType;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Configures playback and slider controls for animating the chart over time. The data must have a key date for it to work properly. */
@@ -3117,6 +3131,8 @@ declare interface Props_23 {
     timeline?: TimelineDataType;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Enable graph download option as png */
@@ -3214,6 +3230,8 @@ declare interface Props_24 {
     curveType?: CurveTypes;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Toggles if the graph animates in when loaded.  */
@@ -3273,6 +3291,8 @@ declare interface Props_25 {
     value: number | string;
     /** Sub text next to main text */
     year?: number | string;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Language setting  */
     language?: Languages;
     /** Color theme */
@@ -3318,6 +3338,10 @@ declare interface Props_26 {
     suffix?: string;
     /** Sub text next to main text */
     year?: number | string;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
+    /** Defines how “NA” values should be displayed/labelled in the graph */
+    naLabel?: string;
     /** Data points that need to counted for aggregation.  */
     countOnly?: (string | number)[];
     /** Method for aggregating the data to show as a single number in the card. If the data type of value in data object is string then only count is applicable. */
@@ -3396,6 +3420,8 @@ declare interface Props_27 {
     animate?: boolean | AnimateDataType;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Enable graph download option as png */
     graphDownload?: boolean;
     /** Enable data download option as a csv */
@@ -3467,10 +3493,14 @@ declare interface Props_28 {
     showColorScale?: boolean;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Defines how “NA” values should be displayed/labelled in the graph */
+    naLabel?: string;
     /** Enable graph download option as png */
     graphDownload?: boolean;
     /** Enable data download option as a csv */
     dataDownload?: boolean;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Language setting  */
     language?: Languages;
     /** Color theme */
@@ -3549,6 +3579,10 @@ declare interface Props_29 {
     colorDomain: number[] | string[];
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
+    /** Defines how “NA” values should be displayed/labelled in the graph */
+    naLabel?: string;
     /** Enable graph download option as png */
     graphDownload?: boolean;
     /** Enable data download option as a csv */
@@ -3638,6 +3672,10 @@ declare interface Props_3 {
     dataDownload?: boolean;
     /** Reset selection on double-click. Only applicable when used in a dashboard context with filters. */
     resetSelectionOnDoubleClick?: boolean;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
+    /** Defines how “NA” values should be displayed/labelled in the graph */
+    naLabel?: string;
     /** Tooltip content. If the type is string then this uses the [handlebar](../?path=/docs/misc-handlebars-templates-and-custom-helpers--docs) template to display the data */
     tooltip?: string | ((_d: any) => React.ReactNode);
     /** Details displayed on the modal when user clicks of a data point. If the type is string then this uses the [handlebar](../?path=/docs/misc-handlebars-templates-and-custom-helpers--docs) template to display the data */
@@ -3697,6 +3735,8 @@ declare interface Props_30 {
     theme?: 'light' | 'dark';
     /** Unique ID for the graph */
     graphID?: string;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
 }
 
 declare interface Props_31 {
@@ -3841,6 +3881,8 @@ declare interface Props_32 {
     showDataMinMax?: boolean;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Enable graph download option as png */
@@ -3944,6 +3986,8 @@ declare interface Props_33 {
     animate?: boolean | AnimateDataType;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Enable graph download option as png */
@@ -4045,6 +4089,8 @@ declare interface Props_34 {
     animate?: boolean | AnimateDataType;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Configures playback and slider controls for animating the chart over time. The data must have a key date for it to work properly. */
@@ -4140,6 +4186,8 @@ declare interface Props_35 {
     hideAxisLine?: boolean;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Enable graph download option as png */
     graphDownload?: boolean;
     /** Enable data download option as a csv */
@@ -4253,6 +4301,8 @@ declare interface Props_36 {
     animate?: boolean | AnimateDataType;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Enable graph download option as png */
@@ -4352,6 +4402,8 @@ declare interface Props_37 {
     animate?: boolean | AnimateDataType;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Enable graph download option as png */
@@ -4453,6 +4505,8 @@ declare interface Props_38 {
     resetSelectionOnDoubleClick?: boolean;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Enable graph download option as png */
@@ -4597,6 +4651,8 @@ declare interface Props_4 {
     animate?: boolean | AnimateDataType;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Configures playback and slider controls for animating the chart over time. The data must have a key date for it to work properly. */
@@ -4856,6 +4912,8 @@ declare interface Props_5 {
     radius?: number;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Enable graph download option as png */
@@ -5026,6 +5084,10 @@ declare interface Props_6 {
     curveType?: CurveTypes;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
+    /** Defines how “NA” values should be displayed/labelled in the graph */
+    naLabel?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Enable graph download option as png */
@@ -5073,6 +5135,7 @@ declare interface Props_62 {
     colorLegendTitle?: string;
     width?: number;
     className?: string;
+    locale?: string;
 }
 
 declare interface Props_63 {
@@ -5084,6 +5147,8 @@ declare interface Props_63 {
     naColor?: string;
     className?: string;
     showNAColor: boolean;
+    locale?: string;
+    naLabel: string;
 }
 
 declare interface Props_64 {
@@ -5235,6 +5300,8 @@ declare interface Props_7 {
     curveType?: CurveTypes;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Enable graph download option as png */
@@ -5334,6 +5401,8 @@ declare interface Props_8 {
     curveType?: CurveTypes;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Enable graph download option as png */
@@ -5449,6 +5518,10 @@ declare interface Props_9 {
     curveType?: CurveTypes;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
+    /** Defines how “NA” values should be displayed/labelled in the graph */
+    naLabel?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Enable graph download option as png */
@@ -5694,6 +5767,8 @@ declare interface StackedBarChartProps {
     animate?: boolean | AnimateDataType;
     /** Specifies the number of decimal places to display in the value. */
     precision?: number;
+    /** Locale for number formatting. Must matches what `Intl.NumberFormat` expects. */
+    locale?: string;
     /** Optional SVG <g> element or function that renders custom content behind or in front of the graph. */
     customLayers?: CustomLayerDataType[];
     /** Configures playback and slider controls for animating the chart over time. The data must have a key date for it to work properly. */

package/dist/index.js

@@ -1,5 +1,5 @@
 import { GroupedBarGraph as e, SimpleBarGraph as t, StackedBarGraph as a } from "./BarGraph.js";
-import { C as m } from "./index-C6VwVS8W.js";
+import { C as m } from "./index-B0Awa_de.js";
 import { DonutChart as x } from "./DonutChart.js";
 import { DumbbellChart as h } from "./DumbbellChart.js";
 import { BeeSwarmChart as i } from "./BeeSwarmChart.js";
@@ -67,10 +67,10 @@ import { GraphHeader as To } from "./GraphHeader.js";
 import { FootNote as Ao } from "./FootNote.js";
 import { GraphDescription as vo } from "./GraphDescription.js";
 import { GraphTitle as ko } from "./GraphTitle.js";
-import { S as Io } from "./Source-Djkz-7jX.js";
+import { S as Io } from "./Source-QGk8vhkS.js";
 import { c as Oo } from "./checkIfNullOrUndefined-DmfiKkNw.js";
 import { g as No, a as Uo, b as Eo, c as Jo, r as qo } from "./removeOutliers-BqW0sPqj.js";
-import { n as Ro } from "./numberFormattingFunction-14YCbkN2.js";
+import { n as Ro } from "./numberFormattingFunction-DqMf_v1m.js";
 import { g as zo } from "./getTextColorBasedOnBgColor-CDY808zi.js";
 import { g as Xo } from "./getJenks-DTCcQSDi.js";
 import { i as Zo } from "./imageDownload-Diofs_vY.js";

package/dist/numberFormattingFunction-Cn9R7CM9.cjs

@@ -0,0 +1,2 @@
+"use strict";const i=require("./checkIfNullOrUndefined-BCW3Y1ML.cjs");function g(n,f,r,m,u,s){if(i.checkIfNullOrUndefined(n))return f||"NA";const o=(e,c)=>new Intl.NumberFormat(s||"en",{minimumFractionDigits:0,maximumFractionDigits:c,useGrouping:!1}).format(e);if(typeof n=="string")return`${m||""}${n}${u||""}`;if(i.checkIfNullOrUndefined(n))return f||"NA";const t=n,d=e=>{const c=["","K","M","B","T"],a=Math.floor(Math.log10(Math.abs(e))/3);if(a===0)return o(e,r===0?0:r||2);const $=e/Math.pow(10,a*3);return o($,r===0?0:r||2)+c[a]};if(t<1e4&&t>-1e4&&Number.isInteger(t))return`${m||""}${o(t,0)}${u||""}`;const h=Math.abs(t)<1e3?o(t,r===0?0:r||2):d(t);return`${m||""}${h}${u||""}`}exports.numberFormattingFunction=g;
+//# sourceMappingURL=numberFormattingFunction-Cn9R7CM9.cjs.map

package/dist/numberFormattingFunction-Cn9R7CM9.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"numberFormattingFunction-Cn9R7CM9.cjs","sources":["../src/Utils/numberFormattingFunction.ts"],"sourcesContent":["import { checkIfNullOrUndefined } from './checkIfNullOrUndefined';\r\n\r\n/**\r\n * Formats a number into a human-readable string, optionally with prefix/suffix\r\n * and locale-aware formatting.\r\n *\r\n * Supports:\r\n * - Compact notation (K, M, B, T)\r\n * - Locale formatting via Intl.NumberFormat\r\n * - Prefix and suffix\r\n * - NA fallback\r\n */\r\nexport function numberFormattingFunction(\r\n  value: number | string | undefined | null,\r\n  naLabel?: string,\r\n  precision?: number,\r\n  prefix?: string,\r\n  suffix?: string,\r\n  locale?: string,\r\n) {\r\n  if (checkIfNullOrUndefined(value)) return naLabel || 'NA';\r\n  const formatWithLocale = (num: number, precisionValue: number) => {\r\n    return new Intl.NumberFormat(locale || 'en', {\r\n      minimumFractionDigits: 0,\r\n      maximumFractionDigits: precisionValue,\r\n      useGrouping: false,\r\n    }).format(num);\r\n  };\r\n\r\n  if (typeof value === 'string') {\r\n    return `${prefix || ''}${value}${suffix || ''}`;\r\n  }\r\n\r\n  if (checkIfNullOrUndefined(value)) {\r\n    return naLabel || 'NA';\r\n  }\r\n\r\n  const num = value as number;\r\n\r\n  const formatCompact = (n: number) => {\r\n    const suffixes = ['', 'K', 'M', 'B', 'T'];\r\n    const tier = Math.floor(Math.log10(Math.abs(n)) / 3);\r\n\r\n    if (tier === 0) {\r\n      return formatWithLocale(n, precision === 0 ? 0 : precision || 2);\r\n    }\r\n\r\n    const scaled = n / Math.pow(10, tier * 3);\r\n\r\n    const formatted = formatWithLocale(scaled, precision === 0 ? 0 : precision || 2);\r\n\r\n    return formatted + suffixes[tier];\r\n  };\r\n\r\n  // Small numbers (no compacting)\r\n  if (num < 10000 && num > -10000 && Number.isInteger(num)) {\r\n    return `${prefix || ''}${formatWithLocale(num, 0)}${suffix || ''}`;\r\n  }\r\n\r\n  const formattedNumber =\r\n    Math.abs(num) < 1000\r\n      ? formatWithLocale(num, precision === 0 ? 0 : precision || 2)\r\n      : formatCompact(num);\r\n\r\n  return `${prefix || ''}${formattedNumber}${suffix || ''}`;\r\n}\r\n"],"names":["numberFormattingFunction","value","naLabel","precision","prefix","suffix","locale","checkIfNullOrUndefined","formatWithLocale","num","precisionValue","Intl","NumberFormat","minimumFractionDigits","maximumFractionDigits","useGrouping","format","formatCompact","n","suffixes","tier","Math","floor","log10","abs","scaled","pow","Number","isInteger","formattedNumber"],"mappings":"sEAYO,SAASA,EACdC,EACAC,EACAC,EACAC,EACAC,EACAC,EACA,CACA,GAAIC,yBAAuBN,CAAK,EAAG,OAAOC,GAAW,KACrD,MAAMM,EAAmBA,CAACC,EAAaC,IAC9B,IAAIC,KAAKC,aAAaN,GAAU,KAAM,CAC3CO,sBAAuB,EACvBC,sBAAuBJ,EACvBK,YAAa,EAAA,CACd,EAAEC,OAAOP,CAAG,EAGf,GAAI,OAAOR,GAAU,SACnB,MAAO,GAAGG,GAAU,EAAE,GAAGH,CAAK,GAAGI,GAAU,EAAE,GAG/C,GAAIE,EAAAA,uBAAuBN,CAAK,EAC9B,OAAOC,GAAW,KAGpB,MAAMO,EAAMR,EAENgB,EAAiBC,GAAc,CACnC,MAAMC,EAAW,CAAC,GAAI,IAAK,IAAK,IAAK,GAAG,EAClCC,EAAOC,KAAKC,MAAMD,KAAKE,MAAMF,KAAKG,IAAIN,CAAC,CAAC,EAAI,CAAC,EAEnD,GAAIE,IAAS,EACX,OAAOZ,EAAiBU,EAAGf,IAAc,EAAI,EAAIA,GAAa,CAAC,EAGjE,MAAMsB,EAASP,EAAIG,KAAKK,IAAI,GAAIN,EAAO,CAAC,EAIxC,OAFkBZ,EAAiBiB,EAAQtB,IAAc,EAAI,EAAIA,GAAa,CAAC,EAE5DgB,EAASC,CAAI,CAClC,EAGA,GAAIX,EAAM,KAASA,EAAM,MAAUkB,OAAOC,UAAUnB,CAAG,EACrD,MAAO,GAAGL,GAAU,EAAE,GAAGI,EAAiBC,EAAK,CAAC,CAAC,GAAGJ,GAAU,EAAE,GAGlE,MAAMwB,EACJR,KAAKG,IAAIf,CAAG,EAAI,IACZD,EAAiBC,EAAKN,IAAc,EAAI,EAAIA,GAAa,CAAC,EAC1Dc,EAAcR,CAAG,EAEvB,MAAO,GAAGL,GAAU,EAAE,GAAGyB,CAAe,GAAGxB,GAAU,EAAE,EACzD"}

package/dist/numberFormattingFunction-DqMf_v1m.js

@@ -0,0 +1,28 @@
+import { c } from "./checkIfNullOrUndefined-DmfiKkNw.js";
+function N(n, s, r, e, a, i) {
+  if (c(n)) return s || "NA";
+  const m = (o, u) => new Intl.NumberFormat(i || "en", {
+    minimumFractionDigits: 0,
+    maximumFractionDigits: u,
+    useGrouping: !1
+  }).format(o);
+  if (typeof n == "string")
+    return `${e || ""}${n}${a || ""}`;
+  if (c(n))
+    return s || "NA";
+  const t = n, $ = (o) => {
+    const u = ["", "K", "M", "B", "T"], f = Math.floor(Math.log10(Math.abs(o)) / 3);
+    if (f === 0)
+      return m(o, r === 0 ? 0 : r || 2);
+    const h = o / Math.pow(10, f * 3);
+    return m(h, r === 0 ? 0 : r || 2) + u[f];
+  };
+  if (t < 1e4 && t > -1e4 && Number.isInteger(t))
+    return `${e || ""}${m(t, 0)}${a || ""}`;
+  const g = Math.abs(t) < 1e3 ? m(t, r === 0 ? 0 : r || 2) : $(t);
+  return `${e || ""}${g}${a || ""}`;
+}
+export {
+  N as n
+};
+//# sourceMappingURL=numberFormattingFunction-DqMf_v1m.js.map

package/dist/numberFormattingFunction-DqMf_v1m.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numberFormattingFunction-DqMf_v1m.js","sources":["../src/Utils/numberFormattingFunction.ts"],"sourcesContent":["import { checkIfNullOrUndefined } from './checkIfNullOrUndefined';\r\n\r\n/**\r\n * Formats a number into a human-readable string, optionally with prefix/suffix\r\n * and locale-aware formatting.\r\n *\r\n * Supports:\r\n * - Compact notation (K, M, B, T)\r\n * - Locale formatting via Intl.NumberFormat\r\n * - Prefix and suffix\r\n * - NA fallback\r\n */\r\nexport function numberFormattingFunction(\r\n  value: number | string | undefined | null,\r\n  naLabel?: string,\r\n  precision?: number,\r\n  prefix?: string,\r\n  suffix?: string,\r\n  locale?: string,\r\n) {\r\n  if (checkIfNullOrUndefined(value)) return naLabel || 'NA';\r\n  const formatWithLocale = (num: number, precisionValue: number) => {\r\n    return new Intl.NumberFormat(locale || 'en', {\r\n      minimumFractionDigits: 0,\r\n      maximumFractionDigits: precisionValue,\r\n      useGrouping: false,\r\n    }).format(num);\r\n  };\r\n\r\n  if (typeof value === 'string') {\r\n    return `${prefix || ''}${value}${suffix || ''}`;\r\n  }\r\n\r\n  if (checkIfNullOrUndefined(value)) {\r\n    return naLabel || 'NA';\r\n  }\r\n\r\n  const num = value as number;\r\n\r\n  const formatCompact = (n: number) => {\r\n    const suffixes = ['', 'K', 'M', 'B', 'T'];\r\n    const tier = Math.floor(Math.log10(Math.abs(n)) / 3);\r\n\r\n    if (tier === 0) {\r\n      return formatWithLocale(n, precision === 0 ? 0 : precision || 2);\r\n    }\r\n\r\n    const scaled = n / Math.pow(10, tier * 3);\r\n\r\n    const formatted = formatWithLocale(scaled, precision === 0 ? 0 : precision || 2);\r\n\r\n    return formatted + suffixes[tier];\r\n  };\r\n\r\n  // Small numbers (no compacting)\r\n  if (num < 10000 && num > -10000 && Number.isInteger(num)) {\r\n    return `${prefix || ''}${formatWithLocale(num, 0)}${suffix || ''}`;\r\n  }\r\n\r\n  const formattedNumber =\r\n    Math.abs(num) < 1000\r\n      ? formatWithLocale(num, precision === 0 ? 0 : precision || 2)\r\n      : formatCompact(num);\r\n\r\n  return `${prefix || ''}${formattedNumber}${suffix || ''}`;\r\n}\r\n"],"names":["numberFormattingFunction","value","naLabel","precision","prefix","suffix","locale","checkIfNullOrUndefined","formatWithLocale","num","precisionValue","Intl","NumberFormat","minimumFractionDigits","maximumFractionDigits","useGrouping","format","formatCompact","n","suffixes","tier","Math","floor","log10","abs","scaled","pow","Number","isInteger","formattedNumber"],"mappings":";AAYO,SAASA,EACdC,GACAC,GACAC,GACAC,GACAC,GACAC,GACA;AACA,MAAIC,EAAuBN,CAAK,EAAG,QAAOC,KAAW;AACrD,QAAMM,IAAmBA,CAACC,GAAaC,MAC9B,IAAIC,KAAKC,aAAaN,KAAU,MAAM;AAAA,IAC3CO,uBAAuB;AAAA,IACvBC,uBAAuBJ;AAAAA,IACvBK,aAAa;AAAA,EAAA,CACd,EAAEC,OAAOP,CAAG;AAGf,MAAI,OAAOR,KAAU;AACnB,WAAO,GAAGG,KAAU,EAAE,GAAGH,CAAK,GAAGI,KAAU,EAAE;AAG/C,MAAIE,EAAuBN,CAAK;AAC9B,WAAOC,KAAW;AAGpB,QAAMO,IAAMR,GAENgB,IAAgBA,CAACC,MAAc;AACnC,UAAMC,IAAW,CAAC,IAAI,KAAK,KAAK,KAAK,GAAG,GAClCC,IAAOC,KAAKC,MAAMD,KAAKE,MAAMF,KAAKG,IAAIN,CAAC,CAAC,IAAI,CAAC;AAEnD,QAAIE,MAAS;AACX,aAAOZ,EAAiBU,GAAGf,MAAc,IAAI,IAAIA,KAAa,CAAC;AAGjE,UAAMsB,IAASP,IAAIG,KAAKK,IAAI,IAAIN,IAAO,CAAC;AAIxC,WAFkBZ,EAAiBiB,GAAQtB,MAAc,IAAI,IAAIA,KAAa,CAAC,IAE5DgB,EAASC,CAAI;AAAA,EAClC;AAGA,MAAIX,IAAM,OAASA,IAAM,QAAUkB,OAAOC,UAAUnB,CAAG;AACrD,WAAO,GAAGL,KAAU,EAAE,GAAGI,EAAiBC,GAAK,CAAC,CAAC,GAAGJ,KAAU,EAAE;AAGlE,QAAMwB,IACJR,KAAKG,IAAIf,CAAG,IAAI,MACZD,EAAiBC,GAAKN,MAAc,IAAI,IAAIA,KAAa,CAAC,IAC1Dc,EAAcR,CAAG;AAEvB,SAAO,GAAGL,KAAU,EAAE,GAAGyB,CAAe,GAAGxB,KAAU,EAAE;AACzD;"}

package/dist/{proxy--_f6k3NR.js → proxy-BsxtcZKa.js}

@@ -1,5 +1,5 @@
 import { createContext as yt, useRef as mt, useLayoutEffect as br, useEffect as We, useContext as O, useId as Vr, useCallback as Os, useMemo as Zt, Fragment as js, createElement as Ar, useInsertionEffect as Ns, forwardRef as Dr, Component as Mr } from "react";
-import { j as ye } from "./index-CHPV5EwG-BCLAYDCV.js";
+import { j as ye } from "./index-CHPV5EwG-BzibaIRc.js";
 const Us = yt({});
 function Cr(t) {
   const e = mt(null);
@@ -4778,4 +4778,4 @@ export {
   Fa as r,
   Cr as u
 };
-//# sourceMappingURL=proxy--_f6k3NR.js.map
+//# sourceMappingURL=proxy-BsxtcZKa.js.map