currency-fomatter 1.3.3 → 1.4.0

package/README.md

@@ -27,6 +27,11 @@ yarn add currency-fomatter
 - Negative number support
 - Custom input component support
 - Full TypeScript support
+- **Standalone utility functions** (`formatCurrency`, `parseCurrency`)
+- **Compact format** (`formatCompact` - 1K, 1M, 1B)
+- **Locale presets** (en-US, vi-VN, de-DE, ja-JP, etc.)
+- **React hook** (`useCurrencyFormat`) for easy state management
+- **ref forwarding** for form library integration
 
 ## Basic Usage
 
@@ -161,6 +166,8 @@ const CustomInput = (props) => (
 | `displayType` | `"input" \| "text"` | `"input"` | Render as input or text |
 | `customInput` | `React.ComponentType` | - | Custom input component |
 | `renderText` | `(value, props) => ReactNode` | - | Custom text renderer |
+| `name` | `string` | - | Field name (included in ValueObject) |
+| `getInputRef` | `(el: HTMLInputElement) => void` | - | Callback to get input element ref |
 
 ### Thousand Spacing Options
 
@@ -171,15 +178,341 @@ const CustomInput = (props) => (
 | `"2s"` | Indian system (Lakhs/Crores) | `12,34,567` |
 | `"4"` | Groups of 4 | `123,4567` |
 
+## Utility Functions
+
+### formatCurrency
+
+Format a number/string without rendering a component:
+
+```tsx
+import { formatCurrency } from "currency-fomatter";
+
+// Basic usage
+formatCurrency(1234567.89);
+// Output: "1,234,567.89"
+
+// With options
+formatCurrency(1234567.89, {
+  prefix: "$",
+  decimalScale: 2,
+  fixedDecimalScale: true,
+  thousandSeparator: ",",
+});
+// Output: "$1,234,567.89"
+
+// Indian format
+formatCurrency(1234567, {
+  prefix: "₹",
+  thousandSpacing: "2s",
+});
+// Output: "₹12,34,567"
+```
+
+### parseCurrency
+
+Parse a formatted currency string back to numeric values:
+
+```tsx
+import { parseCurrency } from "currency-fomatter";
+
+const result = parseCurrency("$1,234.56", {
+  prefix: "$",
+  thousandSeparator: ",",
+});
+// result = {
+//   value: "1234.56",
+//   floatValue: 1234.56,
+//   formattedValue: "$1,234.56"
+// }
+
+// Euro format
+const euroResult = parseCurrency("1.234,56€", {
+  suffix: "€",
+  thousandSeparator: ".",
+  decimalSeparator: ",",
+});
+// euroResult.floatValue = 1234.56
+```
+
+### formatCompact
+
+Format large numbers in compact notation (1K, 1M, 1B):
+
+```tsx
+import { formatCompact } from "currency-fomatter";
+
+// Basic usage
+formatCompact(1234567);
+// Output: "1.23M"
+
+formatCompact(2500000000);
+// Output: "2.5B"
+
+// With currency prefix
+formatCompact(1500000, { prefix: "$", decimalScale: 1 });
+// Output: "$1.5M"
+
+// Vietnamese format
+formatCompact(1500000000, {
+  compactDisplay: {
+    thousand: " nghìn",
+    million: " triệu",
+    billion: " tỷ",
+  },
+  suffix: " ₫",
+});
+// Output: "1.5 tỷ ₫"
+
+// Parse compact format back to number
+import { parseCompact } from "currency-fomatter";
+
+parseCompact("2.5M");
+// Output: { value: "2500000", floatValue: 2500000 }
+```
+
+## Locale Support
+
+### Dynamic Locale Detection (Recommended)
+
+Uses browser's `Intl.NumberFormat` to auto-detect format for ANY locale:
+
+```tsx
+import {
+  detectLocaleFormat,
+  createLocaleConfig,
+  getAutoLocaleConfig,
+  formatWithIntl,
+} from "currency-fomatter";
+
+// Auto-detect user's browser locale
+const autoConfig = getAutoLocaleConfig("USD");
+// Automatically detects separators, prefix/suffix based on user's browser
+
+// Detect format for any locale (no hardcoding!)
+const thaiFormat = detectLocaleFormat("th-TH", "THB");
+// { thousandSeparator: ",", decimalSeparator: ".", prefix: "฿", ... }
+
+const arabicFormat = detectLocaleFormat("ar-SA", "SAR");
+// Correctly detects Arabic number formatting
+
+// Create complete config dynamically
+const config = createLocaleConfig("es-MX", "MXN");
+// Full config with compactDisplay labels from Intl
+
+// Direct Intl formatting (most accurate)
+formatWithIntl(1234567.89, "de-DE", { style: "currency", currency: "EUR" });
+// Output: "1.234.567,89 €"
+```
+
+### Use with CurrencyFormat
+
+```tsx
+import { getFormatOptionsFromLocale, CurrencyFormat } from "currency-fomatter";
+
+// Works with ANY locale - dynamic detection fallback
+<CurrencyFormat
+  value={1234567}
+  {...getFormatOptionsFromLocale("th-TH", { currency: "THB" })}
+/>
+
+// Auto-detect from browser
+import { getAutoLocaleConfig } from "currency-fomatter";
+
+const { prefix, suffix, thousandSeparator, decimalSeparator } = getAutoLocaleConfig("USD");
+<CurrencyFormat value={1234.56} prefix={prefix} suffix={suffix} ... />
+```
+
+### Static Presets (Fallback)
+
+Pre-configured locales for common countries:
+
+```tsx
+import { localePresets, getLocaleConfig } from "currency-fomatter";
+
+// Available presets: en-US, vi-VN, de-DE, ja-JP, en-IN, fr-FR, zh-CN, ko-KR, pt-BR, en-GB
+
+const vnConfig = getLocaleConfig("vi-VN");
+// Uses preset if available, falls back to dynamic detection
+
+<CurrencyFormat
+  value={1234567}
+  {...getFormatOptionsFromLocale("vi-VN")}
+/>
+// Output: 1.234.567 ₫
+```
+
+### Custom Locale Registry
+
+Register your own locale configurations:
+
+```tsx
+import { registerLocale, unregisterLocale, getLocaleConfig } from "currency-fomatter";
+
+// Register custom locale
+registerLocale("my-company", {
+  locale: "my-company",
+  prefix: "₿ ",
+  thousandSeparator: " ",
+  decimalSeparator: ",",
+  decimalScale: 8,
+});
+
+// Use it
+const config = getLocaleConfig("my-company");
+
+// Unregister when done
+unregisterLocale("my-company");
+```
+
+## useCurrencyFormat Hook
+
+A React hook for easy currency state management:
+
+```tsx
+import { useCurrencyFormat, CurrencyFormat } from "currency-fomatter";
+
+function PriceInput() {
+  const {
+    value,           // number: 1234.56
+    formattedValue,  // string: "$1,234.56"
+    setValue,        // (num: number | string) => void
+    inputProps,      // Props to spread on CurrencyFormat
+    reset,           // Reset to initial value
+    clear,           // Clear value
+  } = useCurrencyFormat({
+    locale: "en-US",
+    initialValue: 1000,
+  });
+
+  return (
+    <div>
+      <CurrencyFormat {...inputProps} />
+      <p>Raw value: {value}</p>
+      <p>Formatted: {formattedValue}</p>
+      <button onClick={() => setValue(2000)}>Set $2000</button>
+      <button onClick={reset}>Reset</button>
+      <button onClick={clear}>Clear</button>
+    </div>
+  );
+}
+```
+
+### Hook with Custom Options
+
+```tsx
+const { inputProps, formattedValue } = useCurrencyFormat({
+  locale: "vi-VN",
+  initialValue: 1000000,
+  decimalScale: 0,
+});
+
+// formattedValue = "1.000.000 ₫"
+```
+
+### Hook without Locale
+
+```tsx
+const { inputProps, value } = useCurrencyFormat({
+  initialValue: 99.99,
+  prefix: "$",
+  decimalScale: 2,
+  fixedDecimalScale: true,
+});
+```
+
+## Using with Form Libraries
+
+### react-hook-form
+
+The component supports `ref` forwarding for seamless integration:
+
+```tsx
+import { useForm } from "react-hook-form";
+import { CurrencyFormat } from "currency-fomatter";
+
+function MyForm() {
+  const { register, handleSubmit, setValue } = useForm();
+
+  return (
+    <form onSubmit={handleSubmit(onSubmit)}>
+      <CurrencyFormat
+        {...register("price")}
+        name="price"
+        thousandSeparator=","
+        prefix="$"
+        onValueChange={(values, sourceInfo) => {
+          // Only update form when user interacts, not on prop changes
+          if (sourceInfo?.source === "event") {
+            setValue("price", values.floatValue);
+          }
+        }}
+      />
+    </form>
+  );
+}
+```
+
+### Multiple Fields
+
+Use the `name` prop to identify fields in shared handlers:
+
+```tsx
+function PriceForm() {
+  const [prices, setPrices] = useState({ min: 0, max: 0 });
+
+  const handleValueChange = (values, sourceInfo) => {
+    if (values.name) {
+      setPrices(prev => ({
+        ...prev,
+        [values.name]: values.floatValue
+      }));
+    }
+  };
+
+  return (
+    <>
+      <CurrencyFormat
+        name="min"
+        value={prices.min}
+        onValueChange={handleValueChange}
+        prefix="$"
+      />
+      <CurrencyFormat
+        name="max"
+        value={prices.max}
+        onValueChange={handleValueChange}
+        prefix="$"
+      />
+    </>
+  );
+}
+```
+
 ## TypeScript
 
 The package includes full TypeScript support with exported types:
 
 ```tsx
 import CurrencyFormat, {
+  // Component props
   CurrencyFormatProps,
   ValueObject,
   ThousandSpacing,
+
+  // Utility function types
+  FormatCurrencyOptions,
+  ParseCurrencyOptions,
+  CompactDisplayOptions,
+  FormatCompactOptions,
+
+  // Hook types
+  UseCurrencyFormatOptions,
+  UseCurrencyFormatReturn,
+
+  // Locale types
+  LocaleConfig,
+
+  // Callback types
   FormatFunction,
   IsAllowedFunction,
   OnValueChangeFunction,
@@ -190,6 +523,30 @@ interface ValueObject {
   formattedValue: string;  // Formatted display value
   value: string;           // Unformatted numeric string
   floatValue: number;      // Parsed float value
+  name?: string;           // Field name (if provided)
+}
+
+// onValueChange callback signature
+type OnValueChangeFunction = (
+  values: ValueObject,
+  sourceInfo?: {
+    event?: ChangeEvent<HTMLInputElement>;
+    source: "event" | "prop";  // "event" = user input, "prop" = value prop changed
+  }
+) => void;
+
+// Locale config type
+interface LocaleConfig {
+  locale: string;
+  currency?: string;
+  currencySymbol?: string;
+  prefix?: string;
+  suffix?: string;
+  thousandSeparator?: string | boolean;
+  decimalSeparator?: string;
+  thousandSpacing?: ThousandSpacing;
+  decimalScale?: number;
+  compactDisplay?: CompactDisplayOptions;
 }
 ```
 

package/dist/cjs/components/currency/hooks.d.ts

@@ -0,0 +1,52 @@
+import { FormatCurrencyOptions, ValueObject } from "./utils";
+import { LocaleConfig } from "./locales";
+export interface UseCurrencyFormatOptions extends FormatCurrencyOptions {
+    locale?: string;
+    initialValue?: number | string;
+}
+export interface UseCurrencyFormatReturn {
+    /** Raw numeric value as number */
+    value: number;
+    /** Raw numeric value as string (preserves precision) */
+    valueAsString: string;
+    /** Formatted display value */
+    formattedValue: string;
+    /** Set value from number or string */
+    setValue: (value: number | string) => void;
+    /** Set value from formatted string (parses it first) */
+    setFormattedValue: (formatted: string) => void;
+    /** Format options derived from locale or props */
+    formatOptions: FormatCurrencyOptions;
+    /** Props to spread on CurrencyFormat component */
+    inputProps: {
+        value: number | string;
+        onValueChange: (values: ValueObject) => void;
+        decimalSeparator: string;
+        thousandSeparator: string | boolean;
+        prefix: string;
+        suffix: string;
+        decimalScale?: number;
+        fixedDecimalScale?: boolean;
+        allowNegative?: boolean;
+    };
+    /** Reset to initial value */
+    reset: () => void;
+    /** Clear value */
+    clear: () => void;
+}
+/**
+ * Hook for managing currency format state
+ * Makes it easy to use currency formatting in forms
+ *
+ * @example
+ * ```tsx
+ * const { value, formattedValue, inputProps } = useCurrencyFormat({
+ *   locale: "en-US",
+ *   initialValue: 1000,
+ * });
+ *
+ * return <CurrencyFormat {...inputProps} />;
+ * ```
+ */
+export declare function useCurrencyFormat(options?: UseCurrencyFormatOptions): UseCurrencyFormatReturn;
+export type { LocaleConfig };

package/dist/cjs/components/currency/hooks.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCurrencyFormat = void 0;
+var react_1 = require("react");
+var utils_1 = require("./utils");
+var locales_1 = require("./locales");
+/**
+ * Hook for managing currency format state
+ * Makes it easy to use currency formatting in forms
+ *
+ * @example
+ * ```tsx
+ * const { value, formattedValue, inputProps } = useCurrencyFormat({
+ *   locale: "en-US",
+ *   initialValue: 1000,
+ * });
+ *
+ * return <CurrencyFormat {...inputProps} />;
+ * ```
+ */
+function useCurrencyFormat(options) {
+    if (options === void 0) { options = {}; }
+    var locale = options.locale, _a = options.initialValue, initialValue = _a === void 0 ? 0 : _a, decimalSeparatorProp = options.decimalSeparator, thousandSeparatorProp = options.thousandSeparator, prefixProp = options.prefix, suffixProp = options.suffix, decimalScaleProp = options.decimalScale, fixedDecimalScaleProp = options.fixedDecimalScale, allowNegativeProp = options.allowNegative, thousandSpacingProp = options.thousandSpacing;
+    // Get locale config if locale is provided
+    var localeOptions = (0, react_1.useMemo)(function () { return (locale ? (0, locales_1.getFormatOptionsFromLocale)(locale) : undefined); }, [locale]);
+    // Merge options: prop values override locale values
+    var formatOptions = (0, react_1.useMemo)(function () {
+        var _a, _b, _c, _d, _e, _f;
+        var base = localeOptions || {};
+        return {
+            decimalSeparator: (_a = decimalSeparatorProp !== null && decimalSeparatorProp !== void 0 ? decimalSeparatorProp : base.decimalSeparator) !== null && _a !== void 0 ? _a : ".",
+            thousandSeparator: (_b = thousandSeparatorProp !== null && thousandSeparatorProp !== void 0 ? thousandSeparatorProp : base.thousandSeparator) !== null && _b !== void 0 ? _b : ",",
+            prefix: (_c = prefixProp !== null && prefixProp !== void 0 ? prefixProp : base.prefix) !== null && _c !== void 0 ? _c : "",
+            suffix: (_d = suffixProp !== null && suffixProp !== void 0 ? suffixProp : base.suffix) !== null && _d !== void 0 ? _d : "",
+            decimalScale: decimalScaleProp !== null && decimalScaleProp !== void 0 ? decimalScaleProp : base.decimalScale,
+            fixedDecimalScale: fixedDecimalScaleProp !== null && fixedDecimalScaleProp !== void 0 ? fixedDecimalScaleProp : base.fixedDecimalScale,
+            allowNegative: (_e = allowNegativeProp !== null && allowNegativeProp !== void 0 ? allowNegativeProp : base.allowNegative) !== null && _e !== void 0 ? _e : true,
+            thousandSpacing: (_f = thousandSpacingProp !== null && thousandSpacingProp !== void 0 ? thousandSpacingProp : base.thousandSpacing) !== null && _f !== void 0 ? _f : "3",
+        };
+    }, [
+        localeOptions,
+        decimalSeparatorProp,
+        thousandSeparatorProp,
+        prefixProp,
+        suffixProp,
+        decimalScaleProp,
+        fixedDecimalScaleProp,
+        allowNegativeProp,
+        thousandSpacingProp,
+    ]);
+    // Parse initial value
+    var parseInitialValue = (0, react_1.useCallback)(function (val) {
+        if (typeof val === "number") {
+            return isNaN(val) ? "" : val.toString();
+        }
+        return val;
+    }, []);
+    // State
+    var _b = (0, react_1.useState)(function () {
+        return parseInitialValue(initialValue);
+    }), valueAsString = _b[0], setValueAsString = _b[1];
+    // Derived values
+    var value = (0, react_1.useMemo)(function () { return (valueAsString === "" ? NaN : parseFloat(valueAsString)); }, [valueAsString]);
+    var formattedValue = (0, react_1.useMemo)(function () { return (0, utils_1.formatCurrency)(valueAsString, formatOptions); }, [valueAsString, formatOptions]);
+    // Setters
+    var setValue = (0, react_1.useCallback)(function (newValue) {
+        if (typeof newValue === "number") {
+            setValueAsString(isNaN(newValue) ? "" : newValue.toString());
+        }
+        else {
+            // Parse if it looks formatted
+            var parseOptions = {
+                decimalSeparator: formatOptions.decimalSeparator,
+                thousandSeparator: formatOptions.thousandSeparator,
+                prefix: formatOptions.prefix,
+                suffix: formatOptions.suffix,
+            };
+            var parsed = (0, utils_1.parseCurrency)(newValue, parseOptions);
+            setValueAsString(parsed.value);
+        }
+    }, [formatOptions]);
+    var setFormattedValue = (0, react_1.useCallback)(function (formatted) {
+        var parseOptions = {
+            decimalSeparator: formatOptions.decimalSeparator,
+            thousandSeparator: formatOptions.thousandSeparator,
+            prefix: formatOptions.prefix,
+            suffix: formatOptions.suffix,
+        };
+        var parsed = (0, utils_1.parseCurrency)(formatted, parseOptions);
+        setValueAsString(parsed.value);
+    }, [formatOptions]);
+    var reset = (0, react_1.useCallback)(function () {
+        setValueAsString(parseInitialValue(initialValue));
+    }, [initialValue, parseInitialValue]);
+    var clear = (0, react_1.useCallback)(function () {
+        setValueAsString("");
+    }, []);
+    // Handle value change from CurrencyFormat component
+    var handleValueChange = (0, react_1.useCallback)(function (values) {
+        setValueAsString(values.value);
+    }, []);
+    // Props to spread on CurrencyFormat
+    var inputProps = (0, react_1.useMemo)(function () {
+        var _a;
+        return ({
+            value: valueAsString === "" ? "" : parseFloat(valueAsString),
+            onValueChange: handleValueChange,
+            decimalSeparator: formatOptions.decimalSeparator || ".",
+            thousandSeparator: (_a = formatOptions.thousandSeparator) !== null && _a !== void 0 ? _a : ",",
+            prefix: formatOptions.prefix || "",
+            suffix: formatOptions.suffix || "",
+            decimalScale: formatOptions.decimalScale,
+            fixedDecimalScale: formatOptions.fixedDecimalScale,
+            allowNegative: formatOptions.allowNegative,
+        });
+    }, [valueAsString, handleValueChange, formatOptions]);
+    return {
+        value: value,
+        valueAsString: valueAsString,
+        formattedValue: formattedValue,
+        setValue: setValue,
+        setFormattedValue: setFormattedValue,
+        formatOptions: formatOptions,
+        inputProps: inputProps,
+        reset: reset,
+        clear: clear,
+    };
+}
+exports.useCurrencyFormat = useCurrencyFormat;
+//# sourceMappingURL=hooks.js.map

package/dist/cjs/components/currency/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../src/components/currency/hooks.ts"],"names":[],"mappings":";;;AAAA,+BAAuD;AACvD,iCAMiB;AACjB,qCAAqE;AAsCrE;;;;;;;;;;;;;GAaG;AACH,SAAgB,iBAAiB,CAC/B,OAAsC;IAAtC,wBAAA,EAAA,YAAsC;IAGpC,IAAA,MAAM,GAUJ,OAAO,OAVH,EACN,KASE,OAAO,aATO,EAAhB,YAAY,mBAAG,CAAC,KAAA,EACE,oBAAoB,GAQpC,OAAO,iBAR6B,EACnB,qBAAqB,GAOtC,OAAO,kBAP+B,EAChC,UAAU,GAMhB,OAAO,OANS,EACV,UAAU,GAKhB,OAAO,OALS,EACJ,gBAAgB,GAI5B,OAAO,aAJqB,EACX,qBAAqB,GAGtC,OAAO,kBAH+B,EACzB,iBAAiB,GAE9B,OAAO,cAFuB,EACf,mBAAmB,GAClC,OAAO,gBAD2B,CAC1B;IAEZ,0CAA0C;IAC1C,IAAM,aAAa,GAAG,IAAA,eAAO,EAC3B,cAAM,OAAA,CAAC,MAAM,CAAC,CAAC,CAAC,IAAA,oCAA0B,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAzD,CAAyD,EAC/D,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,oDAAoD;IACpD,IAAM,aAAa,GAAG,IAAA,eAAO,EAAwB;;QACnD,IAAM,IAAI,GAAG,aAAa,IAAI,EAAE,CAAC;QACjC,OAAO;YACL,gBAAgB,EAAE,MAAA,oBAAoB,aAApB,oBAAoB,cAApB,oBAAoB,GAAI,IAAI,CAAC,gBAAgB,mCAAI,GAAG;YACtE,iBAAiB,EAAE,MAAA,qBAAqB,aAArB,qBAAqB,cAArB,qBAAqB,GAAI,IAAI,CAAC,iBAAiB,mCAAI,GAAG;YACzE,MAAM,EAAE,MAAA,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,IAAI,CAAC,MAAM,mCAAI,EAAE;YACvC,MAAM,EAAE,MAAA,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,IAAI,CAAC,MAAM,mCAAI,EAAE;YACvC,YAAY,EAAE,gBAAgB,aAAhB,gBAAgB,cAAhB,gBAAgB,GAAI,IAAI,CAAC,YAAY;YACnD,iBAAiB,EAAE,qBAAqB,aAArB,qBAAqB,cAArB,qBAAqB,GAAI,IAAI,CAAC,iBAAiB;YAClE,aAAa,EAAE,MAAA,iBAAiB,aAAjB,iBAAiB,cAAjB,iBAAiB,GAAI,IAAI,CAAC,aAAa,mCAAI,IAAI;YAC9D,eAAe,EAAE,MAAA,mBAAmB,aAAnB,mBAAmB,cAAnB,mBAAmB,GAAI,IAAI,CAAC,eAAe,mCAAI,GAAG;SACpE,CAAC;IACJ,CAAC,EAAE;QACD,aAAa;QACb,oBAAoB;QACpB,qBAAqB;QACrB,UAAU;QACV,UAAU;QACV,gBAAgB;QAChB,qBAAqB;QACrB,iBAAiB;QACjB,mBAAmB;KACpB,CAAC,CAAC;IAEH,sBAAsB;IACtB,IAAM,iBAAiB,GAAG,IAAA,mBAAW,EACnC,UAAC,GAAoB;QACnB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;YAC3B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;SACzC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EACD,EAAE,CACH,CAAC;IAEF,QAAQ;IACF,IAAA,KAAoC,IAAA,gBAAQ,EAAS;QACzD,OAAA,iBAAiB,CAAC,YAAY,CAAC;IAA/B,CAA+B,CAChC,EAFM,aAAa,QAAA,EAAE,gBAAgB,QAErC,CAAC;IAEF,iBAAiB;IACjB,IAAM,KAAK,GAAG,IAAA,eAAO,EACnB,cAAM,OAAA,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EAAxD,CAAwD,EAC9D,CAAC,aAAa,CAAC,CAChB,CAAC;IAEF,IAAM,cAAc,GAAG,IAAA,eAAO,EAC5B,cAAM,OAAA,IAAA,sBAAc,EAAC,aAAa,EAAE,aAAa,CAAC,EAA5C,CAA4C,EAClD,CAAC,aAAa,EAAE,aAAa,CAAC,CAC/B,CAAC;IAEF,UAAU;IACV,IAAM,QAAQ,GAAG,IAAA,mBAAW,EAC1B,UAAC,QAAyB;QACxB,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE;YAChC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;SAC9D;aAAM;YACL,8BAA8B;YAC9B,IAAM,YAAY,GAAyB;gBACzC,gBAAgB,EAAE,aAAa,CAAC,gBAAgB;gBAChD,iBAAiB,EAAE,aAAa,CAAC,iBAAiB;gBAClD,MAAM,EAAE,aAAa,CAAC,MAAM;gBAC5B,MAAM,EAAE,aAAa,CAAC,MAAM;aAC7B,CAAC;YACF,IAAM,MAAM,GAAG,IAAA,qBAAa,EAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YACrD,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SAChC;IACH,CAAC,EACD,CAAC,aAAa,CAAC,CAChB,CAAC;IAEF,IAAM,iBAAiB,GAAG,IAAA,mBAAW,EACnC,UAAC,SAAiB;QAChB,IAAM,YAAY,GAAyB;YACzC,gBAAgB,EAAE,aAAa,CAAC,gBAAgB;YAChD,iBAAiB,EAAE,aAAa,CAAC,iBAAiB;YAClD,MAAM,EAAE,aAAa,CAAC,MAAM;YAC5B,MAAM,EAAE,aAAa,CAAC,MAAM;SAC7B,CAAC;QACF,IAAM,MAAM,GAAG,IAAA,qBAAa,EAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACtD,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,EACD,CAAC,aAAa,CAAC,CAChB,CAAC;IAEF,IAAM,KAAK,GAAG,IAAA,mBAAW,EAAC;QACxB,gBAAgB,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;IACpD,CAAC,EAAE,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAEtC,IAAM,KAAK,GAAG,IAAA,mBAAW,EAAC;QACxB,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,oDAAoD;IACpD,IAAM,iBAAiB,GAAG,IAAA,mBAAW,EAAC,UAAC,MAAmB;QACxD,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,oCAAoC;IACpC,IAAM,UAAU,GAAG,IAAA,eAAO,EACxB;;QAAM,OAAA,CAAC;YACL,KAAK,EAAE,aAAa,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC;YAC5D,aAAa,EAAE,iBAAiB;YAChC,gBAAgB,EAAE,aAAa,CAAC,gBAAgB,IAAI,GAAG;YACvD,iBAAiB,EAAE,MAAA,aAAa,CAAC,iBAAiB,mCAAI,GAAG;YACzD,MAAM,EAAE,aAAa,CAAC,MAAM,IAAI,EAAE;YAClC,MAAM,EAAE,aAAa,CAAC,MAAM,IAAI,EAAE;YAClC,YAAY,EAAE,aAAa,CAAC,YAAY;YACxC,iBAAiB,EAAE,aAAa,CAAC,iBAAiB;YAClD,aAAa,EAAE,aAAa,CAAC,aAAa;SAC3C,CAAC,CAAA;KAAA,EACF,CAAC,aAAa,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAClD,CAAC;IAEF,OAAO;QACL,KAAK,OAAA;QACL,aAAa,eAAA;QACb,cAAc,gBAAA;QACd,QAAQ,UAAA;QACR,iBAAiB,mBAAA;QACjB,aAAa,eAAA;QACb,UAAU,YAAA;QACV,KAAK,OAAA;QACL,KAAK,OAAA;KACN,CAAC;AACJ,CAAC;AApJD,8CAoJC"}

package/dist/cjs/components/currency/index.d.ts

@@ -1,13 +1,22 @@
-import { ComponentType, InputHTMLAttributes, FocusEvent, KeyboardEvent, ChangeEvent, MouseEvent, ReactNode } from "react";
+import React, { ComponentType, InputHTMLAttributes, FocusEvent, KeyboardEvent, ChangeEvent, MouseEvent, ReactNode } from "react";
 import { ThousandSpacing, ValueObject } from "./utils";
-export type { ThousandSpacing, ValueObject } from "./utils";
+export type { ThousandSpacing, ValueObject, FormatCurrencyOptions, ParseCurrencyOptions, CompactDisplayOptions, FormatCompactOptions, } from "./utils";
+export { formatCurrency, parseCurrency, formatCompact, parseCompact, defaultCompactDisplay, } from "./utils";
+export { useCurrencyFormat } from "./hooks";
+export type { UseCurrencyFormatOptions, UseCurrencyFormatReturn } from "./hooks";
+export { localePresets, getLocaleConfig, getFormatOptionsFromLocale, detectLocaleFormat, getCompactLabels, createLocaleConfig, getAutoLocaleConfig, formatWithIntl, registerLocale, unregisterLocale, } from "./locales";
+export type { LocaleConfig } from "./locales";
 export type FormatFunction = (value: string) => string;
 export type RemoveFormattingFunction = (value: string) => string;
 export type IsAllowedFunction = (values: ValueObject) => boolean;
-export type OnValueChangeFunction = (values: ValueObject) => void;
+export type OnValueChangeFunction = (values: ValueObject, sourceInfo?: {
+    event?: ChangeEvent<HTMLInputElement>;
+    source: "event" | "prop";
+}) => void;
 export type RenderTextFunction = (value: string, otherProps: Record<string, unknown>) => ReactNode;
 export interface CurrencyFormatProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "onChange" | "onKeyDown" | "onMouseUp" | "onFocus" | "onBlur"> {
     value?: string | number;
+    name?: string;
     format?: string | FormatFunction;
     decimalScale?: number;
     decimalSeparator?: string;
@@ -31,6 +40,7 @@ export interface CurrencyFormatProps extends Omit<InputHTMLAttributes<HTMLInputE
     displayType?: "input" | "text";
     customInput?: ComponentType<InputHTMLAttributes<HTMLInputElement>>;
     renderText?: RenderTextFunction;
+    getInputRef?: (el: HTMLInputElement | null) => void;
 }
-declare function CurrencyFormat(props: CurrencyFormatProps): JSX.Element | null;
+declare const CurrencyFormat: React.ForwardRefExoticComponent<CurrencyFormatProps & React.RefAttributes<HTMLInputElement>>;
 export default CurrencyFormat;