numora-react 3.1.0 → 3.3.0

package/README.md

@@ -3,69 +3,17 @@
 [![npm version](https://img.shields.io/npm/v/numora-react.svg)](https://www.npmjs.com/package/numora-react)
 [![npm downloads](https://img.shields.io/npm/dm/numora-react.svg)](https://www.npmjs.com/package/numora-react)
 
-React component wrapper for [Numora](https://github.com/Sharqiewicz/numora) - a precision-first numeric input library for DeFi and financial applications.
+React component wrapper for [numora](../core/README.md) - a precision-first numeric input library.
 
-## Features
-
-| Feature | Description |
-|---------|-------------|
-| **React Component** | Drop-in replacement for `<input>` with numeric formatting |
-| **Decimal Precision Control** | Configure maximum decimal places with `maxDecimals` prop |
-| **Thousand Separators** | Customizable thousand separators with `thousandSeparator` prop |
-| **Grouping Styles** | Support for different grouping styles (`thousand`, `lakh`, `wan`) |
-| **Format on Blur/Change** | Choose when to apply formatting: on blur or on change |
-| **Compact Notation Expansion** | When enabled via `enableCompactNotation`, expands compact notation during paste (e.g., `"1k"` → `"1000"`, `"1.5m"` → `"1500000"`) |
-| **Scientific Notation Expansion** | Always automatically expands scientific notation (e.g., `"1.5e-7"` → `"0.00000015"`, `"2e+5"` → `"200000"`) |
-| **Paste Event Handling** | Intelligent paste handling with automatic sanitization, formatting, and cursor positioning |
-| **Cursor Position Preservation** | Smart cursor positioning that works with thousand separators, even during formatting |
-| **Thousand Separator Skipping** | On delete/backspace, cursor automatically skips over thousand separators for better UX |
-| **Mobile Keyboard Optimization** | Automatic `inputmode="decimal"` for mobile numeric keyboards |
-| **Mobile Keyboard Filtering** | Automatically filters non-breaking spaces and Unicode whitespace artifacts from mobile keyboards |
-| **Non-numeric Character Filtering** | Automatic removal of invalid characters |
-| **Comma/Dot Conversion** | When `thousandStyle` is not set (or `None`), typing comma or dot automatically converts to the configured decimal separator |
-| **TypeScript Support** | Full TypeScript definitions included |
-| **Ref Forwarding** | Supports React ref forwarding for direct input access |
-| **Standard Input Props** | Accepts all standard HTMLInputElement props |
-
-**Note:** Some advanced features from the core package (like `decimalMinLength`, `enableNegative`, `enableLeadingZeros`, `rawValueMode`) are not yet exposed through the React component props. For full control, consider using the core `numora` package directly.
-
-## Comparison
-
-| Feature | numora-react | react-number-format | Native Number Input |
-|---------|--------------|---------------------|---------------------|
-| **React Component** | ✅ Yes | ✅ Yes | ⚠️ Basic |
-| **Decimal Precision Control** | ✅ Max | ✅ Max | ❌ Limited |
-| **Thousand Separators** | ✅ Customizable | ✅ Yes | ❌ No |
-| **Custom Decimal Separator** | ✅ Yes | ✅ Yes | ❌ No (always `.`) |
-| **Formatting Options** | ✅ Blur/Change modes | ✅ Multiple modes | ❌ No |
-| **Cursor Preservation** | ✅ Advanced | ✅ Basic | ❌ N/A |
-| **Mobile Support** | ✅ Yes | ✅ Yes | ⚠️ Limited |
-| **TypeScript Support** | ✅ Yes | ✅ Yes | ⚠️ Partial |
-| **Dependencies** | ⚠️ React + numora | ⚠️ React required | ✅ None |
-| **Framework Support** | ✅ React | ❌ React only | ✅ All |
-| **Scientific Notation** | ✅ Auto-expand | ⚠️ Limited | ❌ No |
-| **Compact Notation** | ✅ Yes (on paste when enabled) | ❌ No | ❌ No |
-| **Paste Handling** | ✅ Intelligent | ✅ Yes | ⚠️ Basic |
-| **Ref Forwarding** | ✅ Yes | ✅ Yes | ✅ Yes |
-| **Grouping Styles** | ✅ Thousand/Lakh/Wan | ⚠️ Thousand only | ❌ No |
-| **Comma/Dot Conversion** | ✅ Yes | ⚠️ Limited | ❌ No |
-
-## Installation
+## Install
 
 ```bash
 npm install numora-react
-# or
-yarn add numora-react
-# or
-pnpm add numora-react
+# or pnpm add numora-react / yarn add numora-react
 ```
 
-**Note:** `numora-react` depends on `numora` core package, which will be installed automatically.
-
 ## Usage
 
-### Basic Example
-
 ```tsx
 import { NumoraInput } from 'numora-react';
 
@@ -73,304 +21,43 @@ function App() {
   return (
     <NumoraInput
       maxDecimals={2}
-      onChange={(e) => {
-        console.log('Value:', e.target.value);
-      }}
-    />
-  );
-}
-```
-
-### Advanced Example
-
-```tsx
-import { NumoraInput } from 'numora-react';
-import { useRef } from 'react';
-
-function PaymentForm() {
-  const inputRef = useRef<HTMLInputElement>(null);
-
-  return (
-    <NumoraInput
-      ref={inputRef}
-      maxDecimals={18}
-      formatOn="change"
       thousandSeparator=","
       thousandStyle="thousand"
-      enableCompactNotation={true} // Enable compact notation expansion on paste
-      placeholder="Enter amount"
-      className="payment-input"
-      onChange={(e) => {
-        const value = e.target.value;
-        console.log('Formatted value:', value);
-      }}
-      onFocus={(e) => {
-        console.log('Input focused');
-      }}
-      onBlur={(e) => {
-        console.log('Input blurred');
-      }}
-    />
-  );
-}
-```
-
-### Compact Notation Example
-
-```tsx
-import { NumoraInput } from 'numora-react';
-
-function App() {
-  return (
-    <NumoraInput
-      maxDecimals={18}
-      enableCompactNotation={true} // Enable compact notation expansion
-      onChange={(e) => {
-        console.log('Value:', e.target.value);
-      }}
-    />
-  );
-}
-
-// When user pastes "1.5k", it automatically expands to "1500"
-// Scientific notation like "1.5e-7" is always automatically expanded
-```
-
-### Scientific Notation Example
-
-```tsx
-import { NumoraInput } from 'numora-react';
-
-function App() {
-  return (
-    <NumoraInput
-      maxDecimals={18}
-      onChange={(e) => {
-        console.log('Value:', e.target.value);
-      }}
-    />
-  );
-}
-
-// Scientific notation is ALWAYS automatically expanded
-// User can paste "1.5e-7" and it becomes "0.00000015"
-// User can paste "2e+5" and it becomes "200000"
-```
-
-### With Form Libraries
-
-#### React Hook Form
-
-`NumoraInput` works seamlessly with react-hook-form. The recommended approach is to use the `Controller` component, which is react-hook-form's official pattern for controlled components.
-
-**Recommended: Controller Pattern**
-```tsx
-import { useForm, Controller } from 'react-hook-form';
-import { NumoraInput } from 'numora-react';
-
-function Form() {
-  const { control, handleSubmit, setValue } = useForm();
-
-  return (
-    <form onSubmit={handleSubmit((data) => console.log(data))}>
-      <Controller
-        control={control}
-        name="amount"
-        render={({ field: { onChange, name, value } }) => (
-          <NumoraInput
-            name={name}
-            value={value || ''}
-            onChange={onChange}
-            maxDecimals={2}
-            thousandSeparator=","
-          />
-        )}
-      />
-      <button type="button" onClick={() => setValue('amount', '1000')}>
-        Set to 1000
-      </button>
-      <button type="submit">Submit</button>
-    </form>
-  );
-}
-```
-
-**Storing Raw Values** (for calculations):
-If you need to store raw values (without thousand separators) in your form state:
-
-```tsx
-<Controller
-  control={control}
-  name="amount"
-  render={({ field }) => (
-    <NumoraInput
-      value={field.value || ''}
-      onChange={(e) => {
-        // Store raw value - better for calculations
-        field.onChange((e.target as any).rawValue);
-      }}
-      maxDecimals={2}
-      thousandSeparator=","
+      onChange={(e) => console.log(e.target.value)}
     />
-  )}
-/>
-```
-
-**Alternative: Register Pattern** (uncontrolled, basic forms only):
-```tsx
-import { useForm } from 'react-hook-form';
-import { NumoraInput } from 'numora-react';
-
-function Form() {
-  const { register, handleSubmit } = useForm();
-
-  return (
-    <form onSubmit={handleSubmit((data) => console.log(data))}>
-      <NumoraInput
-        {...register('amount')}
-        maxDecimals={2}
-        thousandSeparator=","
-      />
-      <button type="submit">Submit</button>
-    </form>
   );
 }
 ```
 
-**Note:** 
-- `numora-react` does not require `react-hook-form` as a dependency. It works with react-hook-form when it's present in your project.
-- The `Controller` pattern is recommended because it works seamlessly with `setValue()`, validation, and all react-hook-form features.
-- `NumoraInput` provides both formatted (`e.target.value`) and raw (`e.target.rawValue`) values in the onChange event.
-
-#### Formik
-
-```tsx
-import { useFormik } from 'formik';
-import { NumoraInput } from 'numora-react';
-
-function Form() {
-  const formik = useFormik({
-    initialValues: { amount: '' },
-    onSubmit: (values) => {
-      console.log(values);
-    },
-  });
-
-  return (
-    <form onSubmit={formik.handleSubmit}>
-      <NumoraInput
-        name="amount"
-        value={formik.values.amount}
-        onChange={formik.handleChange}
-        onBlur={formik.handleBlur}
-        maxDecimals={2}
-        thousandSeparator=","
-      />
-      <button type="submit">Submit</button>
-    </form>
-  );
-}
-```
-
-### Controlled Component
-
-```tsx
-import { NumoraInput } from 'numora-react';
-import { useState } from 'react';
-
-function ControlledInput() {
-  const [value, setValue] = useState('');
-
-  return (
-    <NumoraInput
-      value={value}
-      onChange={(e) => setValue(e.target.value)}
-      maxDecimals={2}
-      thousandSeparator=","
-    />
-  );
-}
-```
-
-### Uncontrolled Component
-
-```tsx
-import { NumoraInput } from 'numora-react';
-import { useRef } from 'react';
-
-function UncontrolledInput() {
-  const inputRef = useRef<HTMLInputElement>(null);
-
-  const handleSubmit = () => {
-    const value = inputRef.current?.value;
-    console.log('Value:', value);
-  };
+## Features
 
-  return (
-    <>
-      <NumoraInput
-        ref={inputRef}
-        maxDecimals={2}
-        thousandSeparator=","
-      />
-      <button onClick={handleSubmit}>Get Value</button>
-    </>
-  );
-}
-```
+- [Sanitization](https://numora.xyz/docs/numora-react/features/sanitization) - filters invalid characters and mobile keyboard artifacts
+- [Formatting](https://numora.xyz/docs/numora-react/features/formatting) - thousand separators (Thousand/Lakh/Wan), format on blur or change
+- [Decimals](https://numora.xyz/docs/numora-react/features/decimals) - configurable max decimal places and custom decimal separator
+- [Compact Notation](https://numora.xyz/docs/numora-react/features/compact-notation) - expands "1k" → "1000" on paste (opt-in)
+- [Scientific Notation](https://numora.xyz/docs/numora-react/features/scientific-notation) - always expands "1.5e-7" → "0.00000015" automatically
+- [Leading Zeros](https://numora.xyz/docs/numora-react/features/leading-zeros) - configurable leading zero behavior
+- [React Hook Form](https://numora.xyz/docs/numora-react/integrations/react-hook-form) - seamless integration via the `Controller` pattern
+- Ref forwarding, controlled and uncontrolled modes, all standard input props
 
 ## Props
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `maxDecimals` | `number` | `2` | Maximum number of decimal places allowed |
-| `formatOn` | `'blur' \| 'change'` | `'blur'` | When to apply formatting: `'blur'` or `'change'` |
-| `thousandSeparator` | `string` | `','` | Character used as thousand separator |
-| `thousandStyle` | `'thousand' \| 'lakh' \| 'wan'` | `'thousand'` | Grouping style for thousand separators |
-| `enableCompactNotation` | `boolean` | `false` | Enable compact notation expansion (e.g., `"1k"` → `"1000"`) on paste |
-| `onChange` | `(e: ChangeEvent<HTMLInputElement> \| ClipboardEvent<HTMLInputElement>) => void` | `undefined` | Callback when value changes |
-| `additionalStyle` | `string` | `undefined` | Additional CSS styles (deprecated, use `style` prop) |
-
-All standard HTMLInputElement props are also supported (e.g., `placeholder`, `className`, `disabled`, `id`, `onFocus`, `onBlur`, etc.), except:
-- `type` - Always set to `'text'` (required for formatting)
-- `inputMode` - Always set to `'decimal'` (for mobile keyboards)
-
-**Note:** Scientific notation expansion (e.g., `"1.5e-7"` → `"0.00000015"`) always happens automatically and is not configurable.
-
-## API Reference
-
-### NumoraInput
-
-A React component that wraps the core Numora functionality in a React-friendly API.
+| `maxDecimals` | `number` | `2` | Maximum decimal places allowed |
+| `formatOn` | `'blur' \| 'change'` | `'blur'` | When to apply formatting |
+| `thousandSeparator` | `string` | `','` | Thousand separator character |
+| `thousandStyle` | `'thousand' \| 'lakh' \| 'wan'` | `'thousand'` | Grouping style |
+| `enableCompactNotation` | `boolean` | `false` | Expand compact notation on paste |
+| `onChange` | `(e: ChangeEvent<HTMLInputElement>) => void` | `undefined` | Called when value changes |
 
-**Props:** See [Props](#props) section above.
+All standard `HTMLInputElement` props are supported except `type` (always `'text'`) and `inputMode` (always `'decimal'`).
 
-**Ref:** The component forwards refs to the underlying `<input>` element.
-
-## TypeScript
-
-Full TypeScript support is included. The component is typed with proper interfaces:
-
-```tsx
-import { NumoraInput } from 'numora-react';
-
-// All props are fully typed
-const input = (
-  <NumoraInput
-    maxDecimals={18} // ✅ TypeScript knows this is a number
-    formatOn="change" // ✅ TypeScript knows valid values
-    enableCompactNotation={true} // ✅ TypeScript knows this is boolean
-    onChange={(e) => {
-      // ✅ e is properly typed as ChangeEvent<HTMLInputElement>
-      console.log(e.target.value);
-    }}
-  />
-);
-```
+Both `e.target.value` (formatted) and `e.target.rawValue` (unformatted) are available in `onChange`.
 
-## Related Packages
+## Documentation
 
-- [`numora`](../core/README.md) - Core framework-agnostic library with full feature set and display formatting utilities
+Full docs and live demo at [numora.xyz/docs/numora-react](https://numora.xyz/docs/numora-react).
 
 ## License
 

package/dist/index.cjs

@@ -62,7 +62,7 @@ function createSyntheticChangeEvent(input) {
     };
 }
 const NumoraInput = react.forwardRef((props, ref) => {
-    const { maxDecimals = 2, onChange, onPaste, onBlur, onKeyDown, onFocus, onRawValueChange, formatOn = numora.FormatOn.Blur, thousandSeparator = ',', thousandStyle = numora.ThousandStyle.Thousand, decimalSeparator = '.', decimalMinLength, enableCompactNotation = false, enableNegative = false, enableLeadingZeros = false, rawValueMode = false, value: controlledValue, defaultValue, ...rest } = props;
+    const { maxDecimals = 2, onChange, onPaste, onBlur, onKeyDown, onFocus, onRawValueChange, formatOn = numora.FormatOn.Blur, thousandSeparator, thousandStyle = numora.ThousandStyle.Thousand, decimalSeparator, decimalMinLength, enableCompactNotation = false, enableNegative = false, enableLeadingZeros = false, rawValueMode = false, value: controlledValue, defaultValue, ...rest } = props;
     numora.validateNumoraInputOptions({
         decimalMaxLength: maxDecimals,
         decimalMinLength,
@@ -80,17 +80,20 @@ const NumoraInput = react.forwardRef((props, ref) => {
     const lastCaretPosRef = react.useRef(null);
     // Memoize to give callbacks a stable reference - avoids recreating all
     // useCallback functions on every render when primitive props haven't changed.
-    const formattingOptions = react.useMemo(() => ({
-        formatOn,
-        thousandSeparator,
-        ThousandStyle: thousandStyle,
-        decimalSeparator,
-        decimalMinLength,
-        enableCompactNotation,
-        enableNegative,
-        enableLeadingZeros,
-        rawValueMode,
-    }), [formatOn, thousandSeparator, thousandStyle, decimalSeparator, decimalMinLength,
+    const formattingOptions = react.useMemo(() => {
+        const resolved = numora.resolveLocaleOptions({ thousandSeparator, thousandStyle, decimalSeparator });
+        return {
+            formatOn,
+            thousandSeparator: resolved.thousandSeparator,
+            ThousandStyle: resolved.thousandStyle,
+            decimalSeparator: resolved.decimalSeparator,
+            decimalMinLength,
+            enableCompactNotation,
+            enableNegative,
+            enableLeadingZeros,
+            rawValueMode,
+        };
+    }, [formatOn, thousandSeparator, thousandStyle, decimalSeparator, decimalMinLength,
         enableCompactNotation, enableNegative, enableLeadingZeros, rawValueMode]);
     const getInitialValue = () => {
         const valueToFormat = controlledValue !== undefined ? controlledValue : defaultValue;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/handlers.ts","../src/index.tsx"],"sourcesContent":["import type React from 'react';\nimport {\n  handleOnChangeNumoraInput,\n  handleOnKeyDownNumoraInput,\n  handleOnPasteNumoraInput,\n  formatValueForDisplay,\n  type CaretPositionInfo,\n  type FormattingOptions,\n  FormatOn,\n} from 'numora';\n\ntype ChangeResult = {\n  value: string;\n  rawValue?: string;\n};\n\ntype PasteResult = ChangeResult;\ntype BlurResult = ChangeResult;\n\ntype BaseOptions = {\n  decimalMaxLength: number;\n  caretPositionBeforeChange?: CaretPositionInfo;\n  formattingOptions: FormattingOptions & { rawValueMode?: boolean };\n};\n\nexport function handleNumoraOnChange(\n  e: React.ChangeEvent<HTMLInputElement>,\n  options: BaseOptions\n): ChangeResult {\n  const { formatted, raw } = handleOnChangeNumoraInput(\n    e.nativeEvent as unknown as Event,\n    options.decimalMaxLength,\n    options.caretPositionBeforeChange,\n    options.formattingOptions\n  );\n\n  return {\n    value: formatted,\n    rawValue: raw,\n  };\n}\n\nexport function handleNumoraOnPaste(\n  e: React.ClipboardEvent<HTMLInputElement>,\n  options: Omit<BaseOptions, 'caretPositionBeforeChange'>\n): PasteResult {\n  const { formatted, raw } = handleOnPasteNumoraInput(\n    e.nativeEvent as ClipboardEvent,\n    options.decimalMaxLength,\n    options.formattingOptions\n  );\n\n  return {\n    value: formatted,\n    rawValue: raw,\n  };\n}\n\nexport function handleNumoraOnKeyDown(\n  e: React.KeyboardEvent<HTMLInputElement>,\n  formattingOptions: FormattingOptions\n): CaretPositionInfo | undefined {\n  return handleOnKeyDownNumoraInput(\n    e.nativeEvent as unknown as KeyboardEvent,\n    formattingOptions\n  );\n}\n\nexport function handleNumoraOnBlur(\n  e: React.FocusEvent<HTMLInputElement>,\n  options: {\n    decimalMaxLength: number;\n    formattingOptions: FormattingOptions & { rawValueMode?: boolean };\n  }\n): BlurResult {\n  if (options.formattingOptions.formatOn === FormatOn.Blur) {\n    const { formatted, raw } = formatValueForDisplay(\n      e.target.value,\n      options.decimalMaxLength,\n      { ...options.formattingOptions, formatOn: FormatOn.Change }\n    );\n    return {\n      value: formatted,\n      rawValue: raw,\n    };\n  }\n\n  return {\n    value: e.target.value,\n    rawValue: undefined,\n  };\n}\n","import {\n  useRef,\n  useState,\n  useEffect,\n  useLayoutEffect,\n  forwardRef,\n  useCallback,\n  useMemo,\n  ClipboardEvent,\n  ChangeEvent,\n  FocusEvent,\n  KeyboardEvent,\n  InputHTMLAttributes\n} from 'react';\nimport {\n  FormatOn,\n  ThousandStyle,\n  formatValueForDisplay,\n  removeThousandSeparators,\n  validateNumoraInputOptions,\n  type CaretPositionInfo,\n  type FormattingOptions,\n} from 'numora';\nimport {\n  handleNumoraOnBlur,\n  handleNumoraOnChange,\n  handleNumoraOnKeyDown,\n  handleNumoraOnPaste,\n} from './handlers';\n\nexport interface NumoraHTMLInputElement extends HTMLInputElement {\n  rawValue?: string;\n}\n\nexport type NumoraInputChangeEvent = Omit<ChangeEvent<HTMLInputElement>, 'target'> & {\n  target: NumoraHTMLInputElement;\n};\n\n/**\n * Creates a complete synthetic change event from a real HTMLInputElement.\n * Used when a change needs to be signalled without an actual DOM change event\n * (e.g. after paste with preventDefault, or after a controlled-value reformat).\n */\nfunction createSyntheticChangeEvent(input: HTMLInputElement): NumoraInputChangeEvent {\n  const nativeEvent = new Event('change', { bubbles: true, cancelable: false });\n  return {\n    nativeEvent,\n    target: input as NumoraHTMLInputElement,\n    currentTarget: input,\n    type: 'change',\n    bubbles: true,\n    cancelable: false,\n    defaultPrevented: false,\n    eventPhase: Event.AT_TARGET,\n    isTrusted: false,\n    timeStamp: Date.now(),\n    isDefaultPrevented: () => false,\n    isPropagationStopped: () => false,\n    persist: () => {},\n    preventDefault: () => {},\n    stopPropagation: () => {},\n    stopImmediatePropagation: () => {},\n  } as unknown as NumoraInputChangeEvent;\n}\n\nexport interface NumoraInputProps\n  extends Omit<\n    InputHTMLAttributes<HTMLInputElement>,\n    'onChange' | 'type' | 'inputMode' | 'onFocus' | 'onBlur'\n  > {\n  maxDecimals?: number;\n  onChange?: (e: NumoraInputChangeEvent) => void;\n  onFocus?: (e: FocusEvent<HTMLInputElement>) => void;\n  onBlur?: (e: FocusEvent<HTMLInputElement>) => void;\n  /** Called with the raw (unformatted) numeric string on every value change. */\n  onRawValueChange?: (rawValue: string | undefined) => void;\n\n  formatOn?: FormatOn;\n  thousandSeparator?: string;\n  thousandStyle?: ThousandStyle;\n  decimalSeparator?: string;\n  decimalMinLength?: number;\n\n  enableCompactNotation?: boolean;\n  enableNegative?: boolean;\n  enableLeadingZeros?: boolean;\n  rawValueMode?: boolean;\n}\n\nconst NumoraInput = forwardRef<HTMLInputElement, NumoraInputProps>((props, ref) => {\n  const {\n    maxDecimals = 2,\n    onChange,\n    onPaste,\n    onBlur,\n    onKeyDown,\n    onFocus,\n    onRawValueChange,\n    formatOn = FormatOn.Blur,\n    thousandSeparator = ',',\n    thousandStyle = ThousandStyle.Thousand,\n    decimalSeparator = '.',\n    decimalMinLength,\n    enableCompactNotation = false,\n    enableNegative = false,\n    enableLeadingZeros = false,\n    rawValueMode = false,\n    value: controlledValue,\n    defaultValue,\n    ...rest\n  } = props;\n\n  validateNumoraInputOptions({\n    decimalMaxLength: maxDecimals,\n    decimalMinLength,\n    formatOn,\n    thousandSeparator,\n    thousandStyle,\n    decimalSeparator,\n    enableCompactNotation,\n    enableNegative,\n    enableLeadingZeros,\n    rawValueMode,\n  });\n\n  const internalInputRef = useRef<HTMLInputElement>(null);\n  const caretInfoRef = useRef<CaretPositionInfo | undefined>(undefined);\n  const lastCaretPosRef = useRef<number | null>(null);\n\n  // Memoize to give callbacks a stable reference - avoids recreating all\n  // useCallback functions on every render when primitive props haven't changed.\n  const formattingOptions: FormattingOptions = useMemo(() => ({\n    formatOn,\n    thousandSeparator,\n    ThousandStyle: thousandStyle,\n    decimalSeparator,\n    decimalMinLength,\n    enableCompactNotation,\n    enableNegative,\n    enableLeadingZeros,\n    rawValueMode,\n  }), [formatOn, thousandSeparator, thousandStyle, decimalSeparator, decimalMinLength,\n    enableCompactNotation, enableNegative, enableLeadingZeros, rawValueMode]);\n\n  const getInitialValue = (): string => {\n    const valueToFormat = controlledValue !== undefined ? controlledValue : defaultValue;\n    if (valueToFormat !== undefined) {\n      const { formatted } = formatValueForDisplay(String(valueToFormat), maxDecimals, formattingOptions);\n      return formatted;\n    }\n    return '';\n  };\n\n  const [displayValue, setDisplayValue] = useState<string>(getInitialValue);\n\n  // Track the current displayValue via a ref so the controlled-value useEffect\n  // can compare against it without adding displayValue as a dependency (which\n  // would cause the effect to re-run on every keystroke).\n  const displayValueRef = useRef<string>(displayValue);\n  displayValueRef.current = displayValue;\n\n  // Sync external ref with internal ref\n  useLayoutEffect(() => {\n    if (!ref) return;\n    if (typeof ref === 'function') {\n      ref(internalInputRef.current);\n    } else {\n      ref.current = internalInputRef.current;\n    }\n  }, [ref]);\n\n  // When the controlled value or formatting options change, reformat the display.\n  // Uses displayValueRef (not displayValue in deps) to avoid re-running on every keystroke.\n  // Does NOT call onChange - that would create a circular loop with react-hook-form Controller.\n  useEffect(() => {\n    if (controlledValue !== undefined) {\n      const { formatted, raw } = formatValueForDisplay(String(controlledValue), maxDecimals, formattingOptions);\n      if (formatted !== displayValueRef.current) {\n        setDisplayValue(formatted);\n\n        if (internalInputRef.current) {\n          (internalInputRef.current as NumoraHTMLInputElement).rawValue = raw;\n        }\n        onRawValueChange?.(raw);\n      }\n    }\n  }, [controlledValue, maxDecimals, formattingOptions, onRawValueChange]);\n\n  // Restore cursor position after render.\n  // No dependency array is intentional: this must run after every render so it catches\n  // the re-render triggered by setDisplayValue in handleChange/handlePaste.\n  // lastCaretPosRef is a ref (not reactive), so it cannot be a dependency.\n  useLayoutEffect(() => {\n    if (internalInputRef.current && lastCaretPosRef.current !== null) {\n      const input = internalInputRef.current;\n      const pos = lastCaretPosRef.current;\n      input.setSelectionRange(pos, pos);\n      lastCaretPosRef.current = null;\n    }\n  });\n\n  const handleChange = useCallback((e: ChangeEvent<HTMLInputElement>) => {\n    const { value, rawValue } = handleNumoraOnChange(e, {\n      decimalMaxLength: maxDecimals,\n      caretPositionBeforeChange: caretInfoRef.current,\n      formattingOptions,\n    });\n\n    if (internalInputRef.current) {\n      const cursorPos = internalInputRef.current.selectionStart;\n      if (cursorPos !== null && cursorPos !== undefined) {\n        lastCaretPosRef.current = cursorPos;\n      }\n    }\n\n    caretInfoRef.current = undefined;\n\n    (e.target as NumoraHTMLInputElement).rawValue = rawValue;\n    onRawValueChange?.(rawValue);\n\n    setDisplayValue(value);\n\n    if (onChange) {\n      onChange(e as unknown as NumoraInputChangeEvent);\n    }\n  }, [maxDecimals, formattingOptions, onChange, onRawValueChange]);\n\n  const handleKeyDown = useCallback((e: KeyboardEvent<HTMLInputElement>) => {\n    const coreCaretInfo = handleNumoraOnKeyDown(e, formattingOptions);\n\n    if (!coreCaretInfo && internalInputRef.current) {\n      const selectionStart = internalInputRef.current.selectionStart ?? 0;\n      const selectionEnd = internalInputRef.current.selectionEnd ?? 0;\n      caretInfoRef.current = {\n        selectionStart,\n        selectionEnd,\n      };\n    } else {\n      caretInfoRef.current = coreCaretInfo;\n    }\n\n    if (onKeyDown) {\n      onKeyDown(e);\n    }\n  }, [formattingOptions, onKeyDown]);\n\n  const handlePaste = useCallback((e: ClipboardEvent<HTMLInputElement>) => {\n    const { value, rawValue } = handleNumoraOnPaste(e, {\n      decimalMaxLength: maxDecimals,\n      formattingOptions,\n    });\n\n    lastCaretPosRef.current = (e.target as HTMLInputElement).selectionStart;\n    (e.target as NumoraHTMLInputElement).rawValue = rawValue;\n    onRawValueChange?.(rawValue);\n\n    setDisplayValue(value);\n\n    if (onPaste) {\n      onPaste(e);\n    }\n\n    // Paste calls e.preventDefault() internally, so React's onChange never fires.\n    // We synthesise a proper change event so consumers see a typed ChangeEvent.\n    if (onChange) {\n      onChange(createSyntheticChangeEvent(e.target as HTMLInputElement));\n    }\n  }, [maxDecimals, formattingOptions, onPaste, onChange, onRawValueChange]);\n\n  const handleFocus = useCallback((e: FocusEvent<HTMLInputElement>) => {\n    if (\n      formattingOptions.formatOn === FormatOn.Blur &&\n      formattingOptions.thousandSeparator &&\n      formattingOptions.ThousandStyle !== ThousandStyle.None\n    ) {\n      // Read directly from the DOM element to avoid a stale displayValue closure\n      // and to eliminate displayValue from the deps array (which would recreate\n      // this callback on every keystroke).\n      const currentValue = (e.target as HTMLInputElement).value;\n      setDisplayValue(removeThousandSeparators(currentValue, formattingOptions.thousandSeparator!));\n    }\n\n    if (onFocus) {\n      onFocus(e);\n    }\n  }, [formattingOptions, onFocus]);\n\n  const handleBlur = useCallback((e: FocusEvent<HTMLInputElement>) => {\n    const { value, rawValue } = handleNumoraOnBlur(e, {\n      decimalMaxLength: maxDecimals,\n      formattingOptions,\n    });\n\n    (e.target as NumoraHTMLInputElement).rawValue = rawValue;\n    onRawValueChange?.(rawValue);\n    setDisplayValue(value);\n\n    if (onBlur) {\n      onBlur(e);\n    }\n  }, [maxDecimals, formattingOptions, onBlur, onRawValueChange]);\n\n  return (\n    <input\n      {...rest}\n      ref={internalInputRef}\n      value={displayValue}\n      onChange={handleChange}\n      onKeyDown={handleKeyDown}\n      onPaste={handlePaste}\n      onFocus={handleFocus}\n      onBlur={handleBlur}\n      type=\"text\"\n      inputMode=\"decimal\"\n      spellCheck={false}\n      autoComplete=\"off\"\n    />\n  );\n});\n\nNumoraInput.displayName = 'NumoraInput';\n\nexport { NumoraInput };\nexport { FormatOn, ThousandStyle } from 'numora';\nexport type { FormattingOptions, CaretPositionInfo } from 'numora';\n"],"names":["handleOnChangeNumoraInput","handleOnPasteNumoraInput","handleOnKeyDownNumoraInput","FormatOn","formatValueForDisplay","forwardRef","ThousandStyle","validateNumoraInputOptions","useRef","useMemo","useState","useLayoutEffect","useEffect","useCallback","removeThousandSeparators","_jsx"],"mappings":";;;;;;AAyBM,SAAU,oBAAoB,CAClC,CAAsC,EACtC,OAAoB,EAAA;IAEpB,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAGA,gCAAyB,CAClD,CAAC,CAAC,WAA+B,EACjC,OAAO,CAAC,gBAAgB,EACxB,OAAO,CAAC,yBAAyB,EACjC,OAAO,CAAC,iBAAiB,CAC1B;IAED,OAAO;AACL,QAAA,KAAK,EAAE,SAAS;AAChB,QAAA,QAAQ,EAAE,GAAG;KACd;AACH;AAEM,SAAU,mBAAmB,CACjC,CAAyC,EACzC,OAAuD,EAAA;IAEvD,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAGC,+BAAwB,CACjD,CAAC,CAAC,WAA6B,EAC/B,OAAO,CAAC,gBAAgB,EACxB,OAAO,CAAC,iBAAiB,CAC1B;IAED,OAAO;AACL,QAAA,KAAK,EAAE,SAAS;AAChB,QAAA,QAAQ,EAAE,GAAG;KACd;AACH;AAEM,SAAU,qBAAqB,CACnC,CAAwC,EACxC,iBAAoC,EAAA;IAEpC,OAAOC,iCAA0B,CAC/B,CAAC,CAAC,WAAuC,EACzC,iBAAiB,CAClB;AACH;AAEM,SAAU,kBAAkB,CAChC,CAAqC,EACrC,OAGC,EAAA;IAED,IAAI,OAAO,CAAC,iBAAiB,CAAC,QAAQ,KAAKC,eAAQ,CAAC,IAAI,EAAE;AACxD,QAAA,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAGC,4BAAqB,CAC9C,CAAC,CAAC,MAAM,CAAC,KAAK,EACd,OAAO,CAAC,gBAAgB,EACxB,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,QAAQ,EAAED,eAAQ,CAAC,MAAM,EAAE,CAC5D;QACD,OAAO;AACL,YAAA,KAAK,EAAE,SAAS;AAChB,YAAA,QAAQ,EAAE,GAAG;SACd;IACH;IAEA,OAAO;AACL,QAAA,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK;AACrB,QAAA,QAAQ,EAAE,SAAS;KACpB;AACH;;ACrDA;;;;AAIG;AACH,SAAS,0BAA0B,CAAC,KAAuB,EAAA;AACzD,IAAA,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC7E,OAAO;QACL,WAAW;AACX,QAAA,MAAM,EAAE,KAA+B;AACvC,QAAA,aAAa,EAAE,KAAK;AACpB,QAAA,IAAI,EAAE,QAAQ;AACd,QAAA,OAAO,EAAE,IAAI;AACb,QAAA,UAAU,EAAE,KAAK;AACjB,QAAA,gBAAgB,EAAE,KAAK;QACvB,UAAU,EAAE,KAAK,CAAC,SAAS;AAC3B,QAAA,SAAS,EAAE,KAAK;AAChB,QAAA,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;AACrB,QAAA,kBAAkB,EAAE,MAAM,KAAK;AAC/B,QAAA,oBAAoB,EAAE,MAAM,KAAK;AACjC,QAAA,OAAO,EAAE,MAAK,EAAE,CAAC;AACjB,QAAA,cAAc,EAAE,MAAK,EAAE,CAAC;AACxB,QAAA,eAAe,EAAE,MAAK,EAAE,CAAC;AACzB,QAAA,wBAAwB,EAAE,MAAK,EAAE,CAAC;KACE;AACxC;AA0BA,MAAM,WAAW,GAAGE,gBAAU,CAAqC,CAAC,KAAK,EAAE,GAAG,KAAI;AAChF,IAAA,MAAM,EACJ,WAAW,GAAG,CAAC,EACf,QAAQ,EACR,OAAO,EACP,MAAM,EACN,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,QAAQ,GAAGF,eAAQ,CAAC,IAAI,EACxB,iBAAiB,GAAG,GAAG,EACvB,aAAa,GAAGG,oBAAa,CAAC,QAAQ,EACtC,gBAAgB,GAAG,GAAG,EACtB,gBAAgB,EAChB,qBAAqB,GAAG,KAAK,EAC7B,cAAc,GAAG,KAAK,EACtB,kBAAkB,GAAG,KAAK,EAC1B,YAAY,GAAG,KAAK,EACpB,KAAK,EAAE,eAAe,EACtB,YAAY,EACZ,GAAG,IAAI,EACR,GAAG,KAAK;AAET,IAAAC,iCAA0B,CAAC;AACzB,QAAA,gBAAgB,EAAE,WAAW;QAC7B,gBAAgB;QAChB,QAAQ;QACR,iBAAiB;QACjB,aAAa;QACb,gBAAgB;QAChB,qBAAqB;QACrB,cAAc;QACd,kBAAkB;QAClB,YAAY;AACb,KAAA,CAAC;AAEF,IAAA,MAAM,gBAAgB,GAAGC,YAAM,CAAmB,IAAI,CAAC;AACvD,IAAA,MAAM,YAAY,GAAGA,YAAM,CAAgC,SAAS,CAAC;AACrE,IAAA,MAAM,eAAe,GAAGA,YAAM,CAAgB,IAAI,CAAC;;;AAInD,IAAA,MAAM,iBAAiB,GAAsBC,aAAO,CAAC,OAAO;QAC1D,QAAQ;QACR,iBAAiB;AACjB,QAAA,aAAa,EAAE,aAAa;QAC5B,gBAAgB;QAChB,gBAAgB;QAChB,qBAAqB;QACrB,cAAc;QACd,kBAAkB;QAClB,YAAY;KACb,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB;QACjF,qBAAqB,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,CAAC,CAAC;IAE3E,MAAM,eAAe,GAAG,MAAa;AACnC,QAAA,MAAM,aAAa,GAAG,eAAe,KAAK,SAAS,GAAG,eAAe,GAAG,YAAY;AACpF,QAAA,IAAI,aAAa,KAAK,SAAS,EAAE;AAC/B,YAAA,MAAM,EAAE,SAAS,EAAE,GAAGL,4BAAqB,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,WAAW,EAAE,iBAAiB,CAAC;AAClG,YAAA,OAAO,SAAS;QAClB;AACA,QAAA,OAAO,EAAE;AACX,IAAA,CAAC;IAED,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAGM,cAAQ,CAAS,eAAe,CAAC;;;;AAKzE,IAAA,MAAM,eAAe,GAAGF,YAAM,CAAS,YAAY,CAAC;AACpD,IAAA,eAAe,CAAC,OAAO,GAAG,YAAY;;IAGtCG,qBAAe,CAAC,MAAK;AACnB,QAAA,IAAI,CAAC,GAAG;YAAE;AACV,QAAA,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE;AAC7B,YAAA,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC;QAC/B;aAAO;AACL,YAAA,GAAG,CAAC,OAAO,GAAG,gBAAgB,CAAC,OAAO;QACxC;AACF,IAAA,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;;;;IAKTC,eAAS,CAAC,MAAK;AACb,QAAA,IAAI,eAAe,KAAK,SAAS,EAAE;AACjC,YAAA,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAGR,4BAAqB,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,iBAAiB,CAAC;AACzG,YAAA,IAAI,SAAS,KAAK,eAAe,CAAC,OAAO,EAAE;gBACzC,eAAe,CAAC,SAAS,CAAC;AAE1B,gBAAA,IAAI,gBAAgB,CAAC,OAAO,EAAE;AAC3B,oBAAA,gBAAgB,CAAC,OAAkC,CAAC,QAAQ,GAAG,GAAG;gBACrE;AACA,gBAAA,gBAAgB,GAAG,GAAG,CAAC;YACzB;QACF;IACF,CAAC,EAAE,CAAC,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;;;;;IAMvEO,qBAAe,CAAC,MAAK;QACnB,IAAI,gBAAgB,CAAC,OAAO,IAAI,eAAe,CAAC,OAAO,KAAK,IAAI,EAAE;AAChE,YAAA,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO;AACtC,YAAA,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO;AACnC,YAAA,KAAK,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC;AACjC,YAAA,eAAe,CAAC,OAAO,GAAG,IAAI;QAChC;AACF,IAAA,CAAC,CAAC;AAEF,IAAA,MAAM,YAAY,GAAGE,iBAAW,CAAC,CAAC,CAAgC,KAAI;QACpE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,oBAAoB,CAAC,CAAC,EAAE;AAClD,YAAA,gBAAgB,EAAE,WAAW;YAC7B,yBAAyB,EAAE,YAAY,CAAC,OAAO;YAC/C,iBAAiB;AAClB,SAAA,CAAC;AAEF,QAAA,IAAI,gBAAgB,CAAC,OAAO,EAAE;AAC5B,YAAA,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,cAAc;YACzD,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS,EAAE;AACjD,gBAAA,eAAe,CAAC,OAAO,GAAG,SAAS;YACrC;QACF;AAEA,QAAA,YAAY,CAAC,OAAO,GAAG,SAAS;AAE/B,QAAA,CAAC,CAAC,MAAiC,CAAC,QAAQ,GAAG,QAAQ;AACxD,QAAA,gBAAgB,GAAG,QAAQ,CAAC;QAE5B,eAAe,CAAC,KAAK,CAAC;QAEtB,IAAI,QAAQ,EAAE;YACZ,QAAQ,CAAC,CAAsC,CAAC;QAClD;IACF,CAAC,EAAE,CAAC,WAAW,EAAE,iBAAiB,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AAEhE,IAAA,MAAM,aAAa,GAAGA,iBAAW,CAAC,CAAC,CAAkC,KAAI;QACvE,MAAM,aAAa,GAAG,qBAAqB,CAAC,CAAC,EAAE,iBAAiB,CAAC;AAEjE,QAAA,IAAI,CAAC,aAAa,IAAI,gBAAgB,CAAC,OAAO,EAAE;YAC9C,MAAM,cAAc,GAAG,gBAAgB,CAAC,OAAO,CAAC,cAAc,IAAI,CAAC;YACnE,MAAM,YAAY,GAAG,gBAAgB,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC;YAC/D,YAAY,CAAC,OAAO,GAAG;gBACrB,cAAc;gBACd,YAAY;aACb;QACH;aAAO;AACL,YAAA,YAAY,CAAC,OAAO,GAAG,aAAa;QACtC;QAEA,IAAI,SAAS,EAAE;YACb,SAAS,CAAC,CAAC,CAAC;QACd;AACF,IAAA,CAAC,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;AAElC,IAAA,MAAM,WAAW,GAAGA,iBAAW,CAAC,CAAC,CAAmC,KAAI;QACtE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,CAAC,EAAE;AACjD,YAAA,gBAAgB,EAAE,WAAW;YAC7B,iBAAiB;AAClB,SAAA,CAAC;QAEF,eAAe,CAAC,OAAO,GAAI,CAAC,CAAC,MAA2B,CAAC,cAAc;AACtE,QAAA,CAAC,CAAC,MAAiC,CAAC,QAAQ,GAAG,QAAQ;AACxD,QAAA,gBAAgB,GAAG,QAAQ,CAAC;QAE5B,eAAe,CAAC,KAAK,CAAC;QAEtB,IAAI,OAAO,EAAE;YACX,OAAO,CAAC,CAAC,CAAC;QACZ;;;QAIA,IAAI,QAAQ,EAAE;YACZ,QAAQ,CAAC,0BAA0B,CAAC,CAAC,CAAC,MAA0B,CAAC,CAAC;QACpE;AACF,IAAA,CAAC,EAAE,CAAC,WAAW,EAAE,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AAEzE,IAAA,MAAM,WAAW,GAAGA,iBAAW,CAAC,CAAC,CAA+B,KAAI;AAClE,QAAA,IACE,iBAAiB,CAAC,QAAQ,KAAKV,eAAQ,CAAC,IAAI;AAC5C,YAAA,iBAAiB,CAAC,iBAAiB;AACnC,YAAA,iBAAiB,CAAC,aAAa,KAAKG,oBAAa,CAAC,IAAI,EACtD;;;;AAIA,YAAA,MAAM,YAAY,GAAI,CAAC,CAAC,MAA2B,CAAC,KAAK;YACzD,eAAe,CAACQ,+BAAwB,CAAC,YAAY,EAAE,iBAAiB,CAAC,iBAAkB,CAAC,CAAC;QAC/F;QAEA,IAAI,OAAO,EAAE;YACX,OAAO,CAAC,CAAC,CAAC;QACZ;AACF,IAAA,CAAC,EAAE,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;AAEhC,IAAA,MAAM,UAAU,GAAGD,iBAAW,CAAC,CAAC,CAA+B,KAAI;QACjE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,kBAAkB,CAAC,CAAC,EAAE;AAChD,YAAA,gBAAgB,EAAE,WAAW;YAC7B,iBAAiB;AAClB,SAAA,CAAC;AAED,QAAA,CAAC,CAAC,MAAiC,CAAC,QAAQ,GAAG,QAAQ;AACxD,QAAA,gBAAgB,GAAG,QAAQ,CAAC;QAC5B,eAAe,CAAC,KAAK,CAAC;QAEtB,IAAI,MAAM,EAAE;YACV,MAAM,CAAC,CAAC,CAAC;QACX;IACF,CAAC,EAAE,CAAC,WAAW,EAAE,iBAAiB,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAE9D,QACEE,6BACM,IAAI,EACR,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAC,MAAM,EACX,SAAS,EAAC,SAAS,EACnB,UAAU,EAAE,KAAK,EACjB,YAAY,EAAC,KAAK,EAAA,CAClB;AAEN,CAAC;AAED,WAAW,CAAC,WAAW,GAAG,aAAa;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":["../src/handlers.ts","../src/index.tsx"],"sourcesContent":["import type React from 'react';\nimport {\n  handleOnChangeNumoraInput,\n  handleOnKeyDownNumoraInput,\n  handleOnPasteNumoraInput,\n  formatValueForDisplay,\n  type CaretPositionInfo,\n  type FormattingOptions,\n  FormatOn,\n} from 'numora';\n\ntype ChangeResult = {\n  value: string;\n  rawValue?: string;\n};\n\ntype PasteResult = ChangeResult;\ntype BlurResult = ChangeResult;\n\ntype BaseOptions = {\n  decimalMaxLength: number;\n  caretPositionBeforeChange?: CaretPositionInfo;\n  formattingOptions: FormattingOptions & { rawValueMode?: boolean };\n};\n\nexport function handleNumoraOnChange(\n  e: React.ChangeEvent<HTMLInputElement>,\n  options: BaseOptions\n): ChangeResult {\n  const { formatted, raw } = handleOnChangeNumoraInput(\n    e.nativeEvent as unknown as Event,\n    options.decimalMaxLength,\n    options.caretPositionBeforeChange,\n    options.formattingOptions\n  );\n\n  return {\n    value: formatted,\n    rawValue: raw,\n  };\n}\n\nexport function handleNumoraOnPaste(\n  e: React.ClipboardEvent<HTMLInputElement>,\n  options: Omit<BaseOptions, 'caretPositionBeforeChange'>\n): PasteResult {\n  const { formatted, raw } = handleOnPasteNumoraInput(\n    e.nativeEvent as ClipboardEvent,\n    options.decimalMaxLength,\n    options.formattingOptions\n  );\n\n  return {\n    value: formatted,\n    rawValue: raw,\n  };\n}\n\nexport function handleNumoraOnKeyDown(\n  e: React.KeyboardEvent<HTMLInputElement>,\n  formattingOptions: FormattingOptions\n): CaretPositionInfo | undefined {\n  return handleOnKeyDownNumoraInput(\n    e.nativeEvent as unknown as KeyboardEvent,\n    formattingOptions\n  );\n}\n\nexport function handleNumoraOnBlur(\n  e: React.FocusEvent<HTMLInputElement>,\n  options: {\n    decimalMaxLength: number;\n    formattingOptions: FormattingOptions & { rawValueMode?: boolean };\n  }\n): BlurResult {\n  if (options.formattingOptions.formatOn === FormatOn.Blur) {\n    const { formatted, raw } = formatValueForDisplay(\n      e.target.value,\n      options.decimalMaxLength,\n      { ...options.formattingOptions, formatOn: FormatOn.Change }\n    );\n    return {\n      value: formatted,\n      rawValue: raw,\n    };\n  }\n\n  return {\n    value: e.target.value,\n    rawValue: undefined,\n  };\n}\n","import {\n  useRef,\n  useState,\n  useEffect,\n  useLayoutEffect,\n  forwardRef,\n  useCallback,\n  useMemo,\n  ClipboardEvent,\n  ChangeEvent,\n  FocusEvent,\n  KeyboardEvent,\n  InputHTMLAttributes\n} from 'react';\nimport {\n  FormatOn,\n  ThousandStyle,\n  resolveLocaleOptions,\n  formatValueForDisplay,\n  removeThousandSeparators,\n  validateNumoraInputOptions,\n  type CaretPositionInfo,\n  type FormattingOptions,\n} from 'numora';\nimport {\n  handleNumoraOnBlur,\n  handleNumoraOnChange,\n  handleNumoraOnKeyDown,\n  handleNumoraOnPaste,\n} from './handlers';\n\nexport interface NumoraHTMLInputElement extends HTMLInputElement {\n  rawValue?: string;\n}\n\nexport type NumoraInputChangeEvent = Omit<ChangeEvent<HTMLInputElement>, 'target'> & {\n  target: NumoraHTMLInputElement;\n};\n\n/**\n * Creates a complete synthetic change event from a real HTMLInputElement.\n * Used when a change needs to be signalled without an actual DOM change event\n * (e.g. after paste with preventDefault, or after a controlled-value reformat).\n */\nfunction createSyntheticChangeEvent(input: HTMLInputElement): NumoraInputChangeEvent {\n  const nativeEvent = new Event('change', { bubbles: true, cancelable: false });\n  return {\n    nativeEvent,\n    target: input as NumoraHTMLInputElement,\n    currentTarget: input,\n    type: 'change',\n    bubbles: true,\n    cancelable: false,\n    defaultPrevented: false,\n    eventPhase: Event.AT_TARGET,\n    isTrusted: false,\n    timeStamp: Date.now(),\n    isDefaultPrevented: () => false,\n    isPropagationStopped: () => false,\n    persist: () => {},\n    preventDefault: () => {},\n    stopPropagation: () => {},\n    stopImmediatePropagation: () => {},\n  } as unknown as NumoraInputChangeEvent;\n}\n\nexport interface NumoraInputProps\n  extends Omit<\n    InputHTMLAttributes<HTMLInputElement>,\n    'onChange' | 'type' | 'inputMode' | 'onFocus' | 'onBlur'\n  > {\n  maxDecimals?: number;\n  onChange?: (e: NumoraInputChangeEvent) => void;\n  onFocus?: (e: FocusEvent<HTMLInputElement>) => void;\n  onBlur?: (e: FocusEvent<HTMLInputElement>) => void;\n  /** Called with the raw (unformatted) numeric string on every value change. */\n  onRawValueChange?: (rawValue: string | undefined) => void;\n\n  formatOn?: FormatOn;\n  thousandSeparator?: string;\n  thousandStyle?: ThousandStyle;\n  decimalSeparator?: string;\n  decimalMinLength?: number;\n\n  enableCompactNotation?: boolean;\n  enableNegative?: boolean;\n  enableLeadingZeros?: boolean;\n  rawValueMode?: boolean;\n}\n\nconst NumoraInput = forwardRef<HTMLInputElement, NumoraInputProps>((props, ref) => {\n  const {\n    maxDecimals = 2,\n    onChange,\n    onPaste,\n    onBlur,\n    onKeyDown,\n    onFocus,\n    onRawValueChange,\n    formatOn = FormatOn.Blur,\n    thousandSeparator,\n    thousandStyle = ThousandStyle.Thousand,\n    decimalSeparator,\n    decimalMinLength,\n    enableCompactNotation = false,\n    enableNegative = false,\n    enableLeadingZeros = false,\n    rawValueMode = false,\n    value: controlledValue,\n    defaultValue,\n    ...rest\n  } = props;\n\n  validateNumoraInputOptions({\n    decimalMaxLength: maxDecimals,\n    decimalMinLength,\n    formatOn,\n    thousandSeparator,\n    thousandStyle,\n    decimalSeparator,\n    enableCompactNotation,\n    enableNegative,\n    enableLeadingZeros,\n    rawValueMode,\n  });\n\n  const internalInputRef = useRef<HTMLInputElement>(null);\n  const caretInfoRef = useRef<CaretPositionInfo | undefined>(undefined);\n  const lastCaretPosRef = useRef<number | null>(null);\n\n  // Memoize to give callbacks a stable reference - avoids recreating all\n  // useCallback functions on every render when primitive props haven't changed.\n  const formattingOptions: FormattingOptions = useMemo(() => {\n    const resolved = resolveLocaleOptions({ thousandSeparator, thousandStyle, decimalSeparator });\n\n    return {\n      formatOn,\n      thousandSeparator: resolved.thousandSeparator,\n      ThousandStyle: resolved.thousandStyle,\n      decimalSeparator: resolved.decimalSeparator,\n      decimalMinLength,\n      enableCompactNotation,\n      enableNegative,\n      enableLeadingZeros,\n      rawValueMode,\n    };\n  }, [formatOn, thousandSeparator, thousandStyle, decimalSeparator, decimalMinLength,\n    enableCompactNotation, enableNegative, enableLeadingZeros, rawValueMode]);\n\n  const getInitialValue = (): string => {\n    const valueToFormat = controlledValue !== undefined ? controlledValue : defaultValue;\n    if (valueToFormat !== undefined) {\n      const { formatted } = formatValueForDisplay(String(valueToFormat), maxDecimals, formattingOptions);\n      return formatted;\n    }\n    return '';\n  };\n\n  const [displayValue, setDisplayValue] = useState<string>(getInitialValue);\n\n  // Track the current displayValue via a ref so the controlled-value useEffect\n  // can compare against it without adding displayValue as a dependency (which\n  // would cause the effect to re-run on every keystroke).\n  const displayValueRef = useRef<string>(displayValue);\n  displayValueRef.current = displayValue;\n\n  // Sync external ref with internal ref\n  useLayoutEffect(() => {\n    if (!ref) return;\n    if (typeof ref === 'function') {\n      ref(internalInputRef.current);\n    } else {\n      ref.current = internalInputRef.current;\n    }\n  }, [ref]);\n\n  // When the controlled value or formatting options change, reformat the display.\n  // Uses displayValueRef (not displayValue in deps) to avoid re-running on every keystroke.\n  // Does NOT call onChange - that would create a circular loop with react-hook-form Controller.\n  useEffect(() => {\n    if (controlledValue !== undefined) {\n      const { formatted, raw } = formatValueForDisplay(String(controlledValue), maxDecimals, formattingOptions);\n      if (formatted !== displayValueRef.current) {\n        setDisplayValue(formatted);\n\n        if (internalInputRef.current) {\n          (internalInputRef.current as NumoraHTMLInputElement).rawValue = raw;\n        }\n        onRawValueChange?.(raw);\n      }\n    }\n  }, [controlledValue, maxDecimals, formattingOptions, onRawValueChange]);\n\n  // Restore cursor position after render.\n  // No dependency array is intentional: this must run after every render so it catches\n  // the re-render triggered by setDisplayValue in handleChange/handlePaste.\n  // lastCaretPosRef is a ref (not reactive), so it cannot be a dependency.\n  useLayoutEffect(() => {\n    if (internalInputRef.current && lastCaretPosRef.current !== null) {\n      const input = internalInputRef.current;\n      const pos = lastCaretPosRef.current;\n      input.setSelectionRange(pos, pos);\n      lastCaretPosRef.current = null;\n    }\n  });\n\n  const handleChange = useCallback((e: ChangeEvent<HTMLInputElement>) => {\n    const { value, rawValue } = handleNumoraOnChange(e, {\n      decimalMaxLength: maxDecimals,\n      caretPositionBeforeChange: caretInfoRef.current,\n      formattingOptions,\n    });\n\n    if (internalInputRef.current) {\n      const cursorPos = internalInputRef.current.selectionStart;\n      if (cursorPos !== null && cursorPos !== undefined) {\n        lastCaretPosRef.current = cursorPos;\n      }\n    }\n\n    caretInfoRef.current = undefined;\n\n    (e.target as NumoraHTMLInputElement).rawValue = rawValue;\n\n    onRawValueChange?.(rawValue);\n\n    setDisplayValue(value);\n\n    if (onChange) {\n      onChange(e as unknown as NumoraInputChangeEvent);\n    }\n  }, [maxDecimals, formattingOptions, onChange, onRawValueChange]);\n\n  const handleKeyDown = useCallback((e: KeyboardEvent<HTMLInputElement>) => {\n    const coreCaretInfo = handleNumoraOnKeyDown(e, formattingOptions);\n\n    if (!coreCaretInfo && internalInputRef.current) {\n      const selectionStart = internalInputRef.current.selectionStart ?? 0;\n      const selectionEnd = internalInputRef.current.selectionEnd ?? 0;\n      caretInfoRef.current = {\n        selectionStart,\n        selectionEnd,\n      };\n    } else {\n      caretInfoRef.current = coreCaretInfo;\n    }\n\n    if (onKeyDown) {\n      onKeyDown(e);\n    }\n  }, [formattingOptions, onKeyDown]);\n\n  const handlePaste = useCallback((e: ClipboardEvent<HTMLInputElement>) => {\n    const { value, rawValue } = handleNumoraOnPaste(e, {\n      decimalMaxLength: maxDecimals,\n      formattingOptions,\n    });\n\n    lastCaretPosRef.current = (e.target as HTMLInputElement).selectionStart;\n    (e.target as NumoraHTMLInputElement).rawValue = rawValue;\n\n    onRawValueChange?.(rawValue);\n\n    setDisplayValue(value);\n\n    if (onPaste) {\n      onPaste(e);\n    }\n\n    // Paste calls e.preventDefault() internally, so React's onChange never fires.\n    // We synthesise a proper change event so consumers see a typed ChangeEvent.\n    if (onChange) {\n      onChange(createSyntheticChangeEvent(e.target as HTMLInputElement));\n    }\n  }, [maxDecimals, formattingOptions, onPaste, onChange, onRawValueChange]);\n\n  const handleFocus = useCallback((e: FocusEvent<HTMLInputElement>) => {\n    if (\n      formattingOptions.formatOn === FormatOn.Blur &&\n      formattingOptions.thousandSeparator &&\n      formattingOptions.ThousandStyle !== ThousandStyle.None\n    ) {\n      // Read directly from the DOM element to avoid a stale displayValue closure\n      // and to eliminate displayValue from the deps array (which would recreate\n      // this callback on every keystroke).\n      const currentValue = (e.target as HTMLInputElement).value;\n      setDisplayValue(removeThousandSeparators(currentValue, formattingOptions.thousandSeparator!));\n    }\n\n    if (onFocus) {\n      onFocus(e);\n    }\n  }, [formattingOptions, onFocus]);\n\n  const handleBlur = useCallback((e: FocusEvent<HTMLInputElement>) => {\n    const { value, rawValue } = handleNumoraOnBlur(e, {\n      decimalMaxLength: maxDecimals,\n      formattingOptions,\n    });\n\n    (e.target as NumoraHTMLInputElement).rawValue = rawValue;\n\n    onRawValueChange?.(rawValue);\n    setDisplayValue(value);\n\n    if (onBlur) {\n      onBlur(e);\n    }\n  }, [maxDecimals, formattingOptions, onBlur, onRawValueChange]);\n\n  return (\n    <input\n      {...rest}\n      ref={internalInputRef}\n      value={displayValue}\n      onChange={handleChange}\n      onKeyDown={handleKeyDown}\n      onPaste={handlePaste}\n      onFocus={handleFocus}\n      onBlur={handleBlur}\n      type=\"text\"\n      inputMode=\"decimal\"\n      spellCheck={false}\n      autoComplete=\"off\"\n    />\n  );\n});\n\nNumoraInput.displayName = 'NumoraInput';\n\nexport { NumoraInput };\nexport { FormatOn, ThousandStyle } from 'numora';\nexport type { FormattingOptions, CaretPositionInfo } from 'numora';\n"],"names":["handleOnChangeNumoraInput","handleOnPasteNumoraInput","handleOnKeyDownNumoraInput","FormatOn","formatValueForDisplay","forwardRef","ThousandStyle","validateNumoraInputOptions","useRef","useMemo","resolveLocaleOptions","useState","useLayoutEffect","useEffect","useCallback","removeThousandSeparators","_jsx"],"mappings":"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"}

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { jsx } from 'react/jsx-runtime';
 import { forwardRef, useRef, useMemo, useState, useLayoutEffect, useEffect, useCallback } from 'react';
-import { handleOnChangeNumoraInput, handleOnKeyDownNumoraInput, handleOnPasteNumoraInput, FormatOn, formatValueForDisplay, ThousandStyle, validateNumoraInputOptions, removeThousandSeparators } from 'numora';
+import { handleOnChangeNumoraInput, handleOnKeyDownNumoraInput, handleOnPasteNumoraInput, FormatOn, formatValueForDisplay, ThousandStyle, validateNumoraInputOptions, resolveLocaleOptions, removeThousandSeparators } from 'numora';
 export { FormatOn, ThousandStyle } from 'numora';
 
 function handleNumoraOnChange(e, options) {
@@ -61,7 +61,7 @@ function createSyntheticChangeEvent(input) {
     };
 }
 const NumoraInput = forwardRef((props, ref) => {
-    const { maxDecimals = 2, onChange, onPaste, onBlur, onKeyDown, onFocus, onRawValueChange, formatOn = FormatOn.Blur, thousandSeparator = ',', thousandStyle = ThousandStyle.Thousand, decimalSeparator = '.', decimalMinLength, enableCompactNotation = false, enableNegative = false, enableLeadingZeros = false, rawValueMode = false, value: controlledValue, defaultValue, ...rest } = props;
+    const { maxDecimals = 2, onChange, onPaste, onBlur, onKeyDown, onFocus, onRawValueChange, formatOn = FormatOn.Blur, thousandSeparator, thousandStyle = ThousandStyle.Thousand, decimalSeparator, decimalMinLength, enableCompactNotation = false, enableNegative = false, enableLeadingZeros = false, rawValueMode = false, value: controlledValue, defaultValue, ...rest } = props;
     validateNumoraInputOptions({
         decimalMaxLength: maxDecimals,
         decimalMinLength,
@@ -79,17 +79,20 @@ const NumoraInput = forwardRef((props, ref) => {
     const lastCaretPosRef = useRef(null);
     // Memoize to give callbacks a stable reference - avoids recreating all
     // useCallback functions on every render when primitive props haven't changed.
-    const formattingOptions = useMemo(() => ({
-        formatOn,
-        thousandSeparator,
-        ThousandStyle: thousandStyle,
-        decimalSeparator,
-        decimalMinLength,
-        enableCompactNotation,
-        enableNegative,
-        enableLeadingZeros,
-        rawValueMode,
-    }), [formatOn, thousandSeparator, thousandStyle, decimalSeparator, decimalMinLength,
+    const formattingOptions = useMemo(() => {
+        const resolved = resolveLocaleOptions({ thousandSeparator, thousandStyle, decimalSeparator });
+        return {
+            formatOn,
+            thousandSeparator: resolved.thousandSeparator,
+            ThousandStyle: resolved.thousandStyle,
+            decimalSeparator: resolved.decimalSeparator,
+            decimalMinLength,
+            enableCompactNotation,
+            enableNegative,
+            enableLeadingZeros,
+            rawValueMode,
+        };
+    }, [formatOn, thousandSeparator, thousandStyle, decimalSeparator, decimalMinLength,
         enableCompactNotation, enableNegative, enableLeadingZeros, rawValueMode]);
     const getInitialValue = () => {
         const valueToFormat = controlledValue !== undefined ? controlledValue : defaultValue;

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/handlers.ts","../src/index.tsx"],"sourcesContent":["import type React from 'react';\nimport {\n  handleOnChangeNumoraInput,\n  handleOnKeyDownNumoraInput,\n  handleOnPasteNumoraInput,\n  formatValueForDisplay,\n  type CaretPositionInfo,\n  type FormattingOptions,\n  FormatOn,\n} from 'numora';\n\ntype ChangeResult = {\n  value: string;\n  rawValue?: string;\n};\n\ntype PasteResult = ChangeResult;\ntype BlurResult = ChangeResult;\n\ntype BaseOptions = {\n  decimalMaxLength: number;\n  caretPositionBeforeChange?: CaretPositionInfo;\n  formattingOptions: FormattingOptions & { rawValueMode?: boolean };\n};\n\nexport function handleNumoraOnChange(\n  e: React.ChangeEvent<HTMLInputElement>,\n  options: BaseOptions\n): ChangeResult {\n  const { formatted, raw } = handleOnChangeNumoraInput(\n    e.nativeEvent as unknown as Event,\n    options.decimalMaxLength,\n    options.caretPositionBeforeChange,\n    options.formattingOptions\n  );\n\n  return {\n    value: formatted,\n    rawValue: raw,\n  };\n}\n\nexport function handleNumoraOnPaste(\n  e: React.ClipboardEvent<HTMLInputElement>,\n  options: Omit<BaseOptions, 'caretPositionBeforeChange'>\n): PasteResult {\n  const { formatted, raw } = handleOnPasteNumoraInput(\n    e.nativeEvent as ClipboardEvent,\n    options.decimalMaxLength,\n    options.formattingOptions\n  );\n\n  return {\n    value: formatted,\n    rawValue: raw,\n  };\n}\n\nexport function handleNumoraOnKeyDown(\n  e: React.KeyboardEvent<HTMLInputElement>,\n  formattingOptions: FormattingOptions\n): CaretPositionInfo | undefined {\n  return handleOnKeyDownNumoraInput(\n    e.nativeEvent as unknown as KeyboardEvent,\n    formattingOptions\n  );\n}\n\nexport function handleNumoraOnBlur(\n  e: React.FocusEvent<HTMLInputElement>,\n  options: {\n    decimalMaxLength: number;\n    formattingOptions: FormattingOptions & { rawValueMode?: boolean };\n  }\n): BlurResult {\n  if (options.formattingOptions.formatOn === FormatOn.Blur) {\n    const { formatted, raw } = formatValueForDisplay(\n      e.target.value,\n      options.decimalMaxLength,\n      { ...options.formattingOptions, formatOn: FormatOn.Change }\n    );\n    return {\n      value: formatted,\n      rawValue: raw,\n    };\n  }\n\n  return {\n    value: e.target.value,\n    rawValue: undefined,\n  };\n}\n","import {\n  useRef,\n  useState,\n  useEffect,\n  useLayoutEffect,\n  forwardRef,\n  useCallback,\n  useMemo,\n  ClipboardEvent,\n  ChangeEvent,\n  FocusEvent,\n  KeyboardEvent,\n  InputHTMLAttributes\n} from 'react';\nimport {\n  FormatOn,\n  ThousandStyle,\n  formatValueForDisplay,\n  removeThousandSeparators,\n  validateNumoraInputOptions,\n  type CaretPositionInfo,\n  type FormattingOptions,\n} from 'numora';\nimport {\n  handleNumoraOnBlur,\n  handleNumoraOnChange,\n  handleNumoraOnKeyDown,\n  handleNumoraOnPaste,\n} from './handlers';\n\nexport interface NumoraHTMLInputElement extends HTMLInputElement {\n  rawValue?: string;\n}\n\nexport type NumoraInputChangeEvent = Omit<ChangeEvent<HTMLInputElement>, 'target'> & {\n  target: NumoraHTMLInputElement;\n};\n\n/**\n * Creates a complete synthetic change event from a real HTMLInputElement.\n * Used when a change needs to be signalled without an actual DOM change event\n * (e.g. after paste with preventDefault, or after a controlled-value reformat).\n */\nfunction createSyntheticChangeEvent(input: HTMLInputElement): NumoraInputChangeEvent {\n  const nativeEvent = new Event('change', { bubbles: true, cancelable: false });\n  return {\n    nativeEvent,\n    target: input as NumoraHTMLInputElement,\n    currentTarget: input,\n    type: 'change',\n    bubbles: true,\n    cancelable: false,\n    defaultPrevented: false,\n    eventPhase: Event.AT_TARGET,\n    isTrusted: false,\n    timeStamp: Date.now(),\n    isDefaultPrevented: () => false,\n    isPropagationStopped: () => false,\n    persist: () => {},\n    preventDefault: () => {},\n    stopPropagation: () => {},\n    stopImmediatePropagation: () => {},\n  } as unknown as NumoraInputChangeEvent;\n}\n\nexport interface NumoraInputProps\n  extends Omit<\n    InputHTMLAttributes<HTMLInputElement>,\n    'onChange' | 'type' | 'inputMode' | 'onFocus' | 'onBlur'\n  > {\n  maxDecimals?: number;\n  onChange?: (e: NumoraInputChangeEvent) => void;\n  onFocus?: (e: FocusEvent<HTMLInputElement>) => void;\n  onBlur?: (e: FocusEvent<HTMLInputElement>) => void;\n  /** Called with the raw (unformatted) numeric string on every value change. */\n  onRawValueChange?: (rawValue: string | undefined) => void;\n\n  formatOn?: FormatOn;\n  thousandSeparator?: string;\n  thousandStyle?: ThousandStyle;\n  decimalSeparator?: string;\n  decimalMinLength?: number;\n\n  enableCompactNotation?: boolean;\n  enableNegative?: boolean;\n  enableLeadingZeros?: boolean;\n  rawValueMode?: boolean;\n}\n\nconst NumoraInput = forwardRef<HTMLInputElement, NumoraInputProps>((props, ref) => {\n  const {\n    maxDecimals = 2,\n    onChange,\n    onPaste,\n    onBlur,\n    onKeyDown,\n    onFocus,\n    onRawValueChange,\n    formatOn = FormatOn.Blur,\n    thousandSeparator = ',',\n    thousandStyle = ThousandStyle.Thousand,\n    decimalSeparator = '.',\n    decimalMinLength,\n    enableCompactNotation = false,\n    enableNegative = false,\n    enableLeadingZeros = false,\n    rawValueMode = false,\n    value: controlledValue,\n    defaultValue,\n    ...rest\n  } = props;\n\n  validateNumoraInputOptions({\n    decimalMaxLength: maxDecimals,\n    decimalMinLength,\n    formatOn,\n    thousandSeparator,\n    thousandStyle,\n    decimalSeparator,\n    enableCompactNotation,\n    enableNegative,\n    enableLeadingZeros,\n    rawValueMode,\n  });\n\n  const internalInputRef = useRef<HTMLInputElement>(null);\n  const caretInfoRef = useRef<CaretPositionInfo | undefined>(undefined);\n  const lastCaretPosRef = useRef<number | null>(null);\n\n  // Memoize to give callbacks a stable reference - avoids recreating all\n  // useCallback functions on every render when primitive props haven't changed.\n  const formattingOptions: FormattingOptions = useMemo(() => ({\n    formatOn,\n    thousandSeparator,\n    ThousandStyle: thousandStyle,\n    decimalSeparator,\n    decimalMinLength,\n    enableCompactNotation,\n    enableNegative,\n    enableLeadingZeros,\n    rawValueMode,\n  }), [formatOn, thousandSeparator, thousandStyle, decimalSeparator, decimalMinLength,\n    enableCompactNotation, enableNegative, enableLeadingZeros, rawValueMode]);\n\n  const getInitialValue = (): string => {\n    const valueToFormat = controlledValue !== undefined ? controlledValue : defaultValue;\n    if (valueToFormat !== undefined) {\n      const { formatted } = formatValueForDisplay(String(valueToFormat), maxDecimals, formattingOptions);\n      return formatted;\n    }\n    return '';\n  };\n\n  const [displayValue, setDisplayValue] = useState<string>(getInitialValue);\n\n  // Track the current displayValue via a ref so the controlled-value useEffect\n  // can compare against it without adding displayValue as a dependency (which\n  // would cause the effect to re-run on every keystroke).\n  const displayValueRef = useRef<string>(displayValue);\n  displayValueRef.current = displayValue;\n\n  // Sync external ref with internal ref\n  useLayoutEffect(() => {\n    if (!ref) return;\n    if (typeof ref === 'function') {\n      ref(internalInputRef.current);\n    } else {\n      ref.current = internalInputRef.current;\n    }\n  }, [ref]);\n\n  // When the controlled value or formatting options change, reformat the display.\n  // Uses displayValueRef (not displayValue in deps) to avoid re-running on every keystroke.\n  // Does NOT call onChange - that would create a circular loop with react-hook-form Controller.\n  useEffect(() => {\n    if (controlledValue !== undefined) {\n      const { formatted, raw } = formatValueForDisplay(String(controlledValue), maxDecimals, formattingOptions);\n      if (formatted !== displayValueRef.current) {\n        setDisplayValue(formatted);\n\n        if (internalInputRef.current) {\n          (internalInputRef.current as NumoraHTMLInputElement).rawValue = raw;\n        }\n        onRawValueChange?.(raw);\n      }\n    }\n  }, [controlledValue, maxDecimals, formattingOptions, onRawValueChange]);\n\n  // Restore cursor position after render.\n  // No dependency array is intentional: this must run after every render so it catches\n  // the re-render triggered by setDisplayValue in handleChange/handlePaste.\n  // lastCaretPosRef is a ref (not reactive), so it cannot be a dependency.\n  useLayoutEffect(() => {\n    if (internalInputRef.current && lastCaretPosRef.current !== null) {\n      const input = internalInputRef.current;\n      const pos = lastCaretPosRef.current;\n      input.setSelectionRange(pos, pos);\n      lastCaretPosRef.current = null;\n    }\n  });\n\n  const handleChange = useCallback((e: ChangeEvent<HTMLInputElement>) => {\n    const { value, rawValue } = handleNumoraOnChange(e, {\n      decimalMaxLength: maxDecimals,\n      caretPositionBeforeChange: caretInfoRef.current,\n      formattingOptions,\n    });\n\n    if (internalInputRef.current) {\n      const cursorPos = internalInputRef.current.selectionStart;\n      if (cursorPos !== null && cursorPos !== undefined) {\n        lastCaretPosRef.current = cursorPos;\n      }\n    }\n\n    caretInfoRef.current = undefined;\n\n    (e.target as NumoraHTMLInputElement).rawValue = rawValue;\n    onRawValueChange?.(rawValue);\n\n    setDisplayValue(value);\n\n    if (onChange) {\n      onChange(e as unknown as NumoraInputChangeEvent);\n    }\n  }, [maxDecimals, formattingOptions, onChange, onRawValueChange]);\n\n  const handleKeyDown = useCallback((e: KeyboardEvent<HTMLInputElement>) => {\n    const coreCaretInfo = handleNumoraOnKeyDown(e, formattingOptions);\n\n    if (!coreCaretInfo && internalInputRef.current) {\n      const selectionStart = internalInputRef.current.selectionStart ?? 0;\n      const selectionEnd = internalInputRef.current.selectionEnd ?? 0;\n      caretInfoRef.current = {\n        selectionStart,\n        selectionEnd,\n      };\n    } else {\n      caretInfoRef.current = coreCaretInfo;\n    }\n\n    if (onKeyDown) {\n      onKeyDown(e);\n    }\n  }, [formattingOptions, onKeyDown]);\n\n  const handlePaste = useCallback((e: ClipboardEvent<HTMLInputElement>) => {\n    const { value, rawValue } = handleNumoraOnPaste(e, {\n      decimalMaxLength: maxDecimals,\n      formattingOptions,\n    });\n\n    lastCaretPosRef.current = (e.target as HTMLInputElement).selectionStart;\n    (e.target as NumoraHTMLInputElement).rawValue = rawValue;\n    onRawValueChange?.(rawValue);\n\n    setDisplayValue(value);\n\n    if (onPaste) {\n      onPaste(e);\n    }\n\n    // Paste calls e.preventDefault() internally, so React's onChange never fires.\n    // We synthesise a proper change event so consumers see a typed ChangeEvent.\n    if (onChange) {\n      onChange(createSyntheticChangeEvent(e.target as HTMLInputElement));\n    }\n  }, [maxDecimals, formattingOptions, onPaste, onChange, onRawValueChange]);\n\n  const handleFocus = useCallback((e: FocusEvent<HTMLInputElement>) => {\n    if (\n      formattingOptions.formatOn === FormatOn.Blur &&\n      formattingOptions.thousandSeparator &&\n      formattingOptions.ThousandStyle !== ThousandStyle.None\n    ) {\n      // Read directly from the DOM element to avoid a stale displayValue closure\n      // and to eliminate displayValue from the deps array (which would recreate\n      // this callback on every keystroke).\n      const currentValue = (e.target as HTMLInputElement).value;\n      setDisplayValue(removeThousandSeparators(currentValue, formattingOptions.thousandSeparator!));\n    }\n\n    if (onFocus) {\n      onFocus(e);\n    }\n  }, [formattingOptions, onFocus]);\n\n  const handleBlur = useCallback((e: FocusEvent<HTMLInputElement>) => {\n    const { value, rawValue } = handleNumoraOnBlur(e, {\n      decimalMaxLength: maxDecimals,\n      formattingOptions,\n    });\n\n    (e.target as NumoraHTMLInputElement).rawValue = rawValue;\n    onRawValueChange?.(rawValue);\n    setDisplayValue(value);\n\n    if (onBlur) {\n      onBlur(e);\n    }\n  }, [maxDecimals, formattingOptions, onBlur, onRawValueChange]);\n\n  return (\n    <input\n      {...rest}\n      ref={internalInputRef}\n      value={displayValue}\n      onChange={handleChange}\n      onKeyDown={handleKeyDown}\n      onPaste={handlePaste}\n      onFocus={handleFocus}\n      onBlur={handleBlur}\n      type=\"text\"\n      inputMode=\"decimal\"\n      spellCheck={false}\n      autoComplete=\"off\"\n    />\n  );\n});\n\nNumoraInput.displayName = 'NumoraInput';\n\nexport { NumoraInput };\nexport { FormatOn, ThousandStyle } from 'numora';\nexport type { FormattingOptions, CaretPositionInfo } from 'numora';\n"],"names":["_jsx"],"mappings":"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"}
+{"version":3,"file":"index.mjs","sources":["../src/handlers.ts","../src/index.tsx"],"sourcesContent":["import type React from 'react';\nimport {\n  handleOnChangeNumoraInput,\n  handleOnKeyDownNumoraInput,\n  handleOnPasteNumoraInput,\n  formatValueForDisplay,\n  type CaretPositionInfo,\n  type FormattingOptions,\n  FormatOn,\n} from 'numora';\n\ntype ChangeResult = {\n  value: string;\n  rawValue?: string;\n};\n\ntype PasteResult = ChangeResult;\ntype BlurResult = ChangeResult;\n\ntype BaseOptions = {\n  decimalMaxLength: number;\n  caretPositionBeforeChange?: CaretPositionInfo;\n  formattingOptions: FormattingOptions & { rawValueMode?: boolean };\n};\n\nexport function handleNumoraOnChange(\n  e: React.ChangeEvent<HTMLInputElement>,\n  options: BaseOptions\n): ChangeResult {\n  const { formatted, raw } = handleOnChangeNumoraInput(\n    e.nativeEvent as unknown as Event,\n    options.decimalMaxLength,\n    options.caretPositionBeforeChange,\n    options.formattingOptions\n  );\n\n  return {\n    value: formatted,\n    rawValue: raw,\n  };\n}\n\nexport function handleNumoraOnPaste(\n  e: React.ClipboardEvent<HTMLInputElement>,\n  options: Omit<BaseOptions, 'caretPositionBeforeChange'>\n): PasteResult {\n  const { formatted, raw } = handleOnPasteNumoraInput(\n    e.nativeEvent as ClipboardEvent,\n    options.decimalMaxLength,\n    options.formattingOptions\n  );\n\n  return {\n    value: formatted,\n    rawValue: raw,\n  };\n}\n\nexport function handleNumoraOnKeyDown(\n  e: React.KeyboardEvent<HTMLInputElement>,\n  formattingOptions: FormattingOptions\n): CaretPositionInfo | undefined {\n  return handleOnKeyDownNumoraInput(\n    e.nativeEvent as unknown as KeyboardEvent,\n    formattingOptions\n  );\n}\n\nexport function handleNumoraOnBlur(\n  e: React.FocusEvent<HTMLInputElement>,\n  options: {\n    decimalMaxLength: number;\n    formattingOptions: FormattingOptions & { rawValueMode?: boolean };\n  }\n): BlurResult {\n  if (options.formattingOptions.formatOn === FormatOn.Blur) {\n    const { formatted, raw } = formatValueForDisplay(\n      e.target.value,\n      options.decimalMaxLength,\n      { ...options.formattingOptions, formatOn: FormatOn.Change }\n    );\n    return {\n      value: formatted,\n      rawValue: raw,\n    };\n  }\n\n  return {\n    value: e.target.value,\n    rawValue: undefined,\n  };\n}\n","import {\n  useRef,\n  useState,\n  useEffect,\n  useLayoutEffect,\n  forwardRef,\n  useCallback,\n  useMemo,\n  ClipboardEvent,\n  ChangeEvent,\n  FocusEvent,\n  KeyboardEvent,\n  InputHTMLAttributes\n} from 'react';\nimport {\n  FormatOn,\n  ThousandStyle,\n  resolveLocaleOptions,\n  formatValueForDisplay,\n  removeThousandSeparators,\n  validateNumoraInputOptions,\n  type CaretPositionInfo,\n  type FormattingOptions,\n} from 'numora';\nimport {\n  handleNumoraOnBlur,\n  handleNumoraOnChange,\n  handleNumoraOnKeyDown,\n  handleNumoraOnPaste,\n} from './handlers';\n\nexport interface NumoraHTMLInputElement extends HTMLInputElement {\n  rawValue?: string;\n}\n\nexport type NumoraInputChangeEvent = Omit<ChangeEvent<HTMLInputElement>, 'target'> & {\n  target: NumoraHTMLInputElement;\n};\n\n/**\n * Creates a complete synthetic change event from a real HTMLInputElement.\n * Used when a change needs to be signalled without an actual DOM change event\n * (e.g. after paste with preventDefault, or after a controlled-value reformat).\n */\nfunction createSyntheticChangeEvent(input: HTMLInputElement): NumoraInputChangeEvent {\n  const nativeEvent = new Event('change', { bubbles: true, cancelable: false });\n  return {\n    nativeEvent,\n    target: input as NumoraHTMLInputElement,\n    currentTarget: input,\n    type: 'change',\n    bubbles: true,\n    cancelable: false,\n    defaultPrevented: false,\n    eventPhase: Event.AT_TARGET,\n    isTrusted: false,\n    timeStamp: Date.now(),\n    isDefaultPrevented: () => false,\n    isPropagationStopped: () => false,\n    persist: () => {},\n    preventDefault: () => {},\n    stopPropagation: () => {},\n    stopImmediatePropagation: () => {},\n  } as unknown as NumoraInputChangeEvent;\n}\n\nexport interface NumoraInputProps\n  extends Omit<\n    InputHTMLAttributes<HTMLInputElement>,\n    'onChange' | 'type' | 'inputMode' | 'onFocus' | 'onBlur'\n  > {\n  maxDecimals?: number;\n  onChange?: (e: NumoraInputChangeEvent) => void;\n  onFocus?: (e: FocusEvent<HTMLInputElement>) => void;\n  onBlur?: (e: FocusEvent<HTMLInputElement>) => void;\n  /** Called with the raw (unformatted) numeric string on every value change. */\n  onRawValueChange?: (rawValue: string | undefined) => void;\n\n  formatOn?: FormatOn;\n  thousandSeparator?: string;\n  thousandStyle?: ThousandStyle;\n  decimalSeparator?: string;\n  decimalMinLength?: number;\n\n  enableCompactNotation?: boolean;\n  enableNegative?: boolean;\n  enableLeadingZeros?: boolean;\n  rawValueMode?: boolean;\n}\n\nconst NumoraInput = forwardRef<HTMLInputElement, NumoraInputProps>((props, ref) => {\n  const {\n    maxDecimals = 2,\n    onChange,\n    onPaste,\n    onBlur,\n    onKeyDown,\n    onFocus,\n    onRawValueChange,\n    formatOn = FormatOn.Blur,\n    thousandSeparator,\n    thousandStyle = ThousandStyle.Thousand,\n    decimalSeparator,\n    decimalMinLength,\n    enableCompactNotation = false,\n    enableNegative = false,\n    enableLeadingZeros = false,\n    rawValueMode = false,\n    value: controlledValue,\n    defaultValue,\n    ...rest\n  } = props;\n\n  validateNumoraInputOptions({\n    decimalMaxLength: maxDecimals,\n    decimalMinLength,\n    formatOn,\n    thousandSeparator,\n    thousandStyle,\n    decimalSeparator,\n    enableCompactNotation,\n    enableNegative,\n    enableLeadingZeros,\n    rawValueMode,\n  });\n\n  const internalInputRef = useRef<HTMLInputElement>(null);\n  const caretInfoRef = useRef<CaretPositionInfo | undefined>(undefined);\n  const lastCaretPosRef = useRef<number | null>(null);\n\n  // Memoize to give callbacks a stable reference - avoids recreating all\n  // useCallback functions on every render when primitive props haven't changed.\n  const formattingOptions: FormattingOptions = useMemo(() => {\n    const resolved = resolveLocaleOptions({ thousandSeparator, thousandStyle, decimalSeparator });\n\n    return {\n      formatOn,\n      thousandSeparator: resolved.thousandSeparator,\n      ThousandStyle: resolved.thousandStyle,\n      decimalSeparator: resolved.decimalSeparator,\n      decimalMinLength,\n      enableCompactNotation,\n      enableNegative,\n      enableLeadingZeros,\n      rawValueMode,\n    };\n  }, [formatOn, thousandSeparator, thousandStyle, decimalSeparator, decimalMinLength,\n    enableCompactNotation, enableNegative, enableLeadingZeros, rawValueMode]);\n\n  const getInitialValue = (): string => {\n    const valueToFormat = controlledValue !== undefined ? controlledValue : defaultValue;\n    if (valueToFormat !== undefined) {\n      const { formatted } = formatValueForDisplay(String(valueToFormat), maxDecimals, formattingOptions);\n      return formatted;\n    }\n    return '';\n  };\n\n  const [displayValue, setDisplayValue] = useState<string>(getInitialValue);\n\n  // Track the current displayValue via a ref so the controlled-value useEffect\n  // can compare against it without adding displayValue as a dependency (which\n  // would cause the effect to re-run on every keystroke).\n  const displayValueRef = useRef<string>(displayValue);\n  displayValueRef.current = displayValue;\n\n  // Sync external ref with internal ref\n  useLayoutEffect(() => {\n    if (!ref) return;\n    if (typeof ref === 'function') {\n      ref(internalInputRef.current);\n    } else {\n      ref.current = internalInputRef.current;\n    }\n  }, [ref]);\n\n  // When the controlled value or formatting options change, reformat the display.\n  // Uses displayValueRef (not displayValue in deps) to avoid re-running on every keystroke.\n  // Does NOT call onChange - that would create a circular loop with react-hook-form Controller.\n  useEffect(() => {\n    if (controlledValue !== undefined) {\n      const { formatted, raw } = formatValueForDisplay(String(controlledValue), maxDecimals, formattingOptions);\n      if (formatted !== displayValueRef.current) {\n        setDisplayValue(formatted);\n\n        if (internalInputRef.current) {\n          (internalInputRef.current as NumoraHTMLInputElement).rawValue = raw;\n        }\n        onRawValueChange?.(raw);\n      }\n    }\n  }, [controlledValue, maxDecimals, formattingOptions, onRawValueChange]);\n\n  // Restore cursor position after render.\n  // No dependency array is intentional: this must run after every render so it catches\n  // the re-render triggered by setDisplayValue in handleChange/handlePaste.\n  // lastCaretPosRef is a ref (not reactive), so it cannot be a dependency.\n  useLayoutEffect(() => {\n    if (internalInputRef.current && lastCaretPosRef.current !== null) {\n      const input = internalInputRef.current;\n      const pos = lastCaretPosRef.current;\n      input.setSelectionRange(pos, pos);\n      lastCaretPosRef.current = null;\n    }\n  });\n\n  const handleChange = useCallback((e: ChangeEvent<HTMLInputElement>) => {\n    const { value, rawValue } = handleNumoraOnChange(e, {\n      decimalMaxLength: maxDecimals,\n      caretPositionBeforeChange: caretInfoRef.current,\n      formattingOptions,\n    });\n\n    if (internalInputRef.current) {\n      const cursorPos = internalInputRef.current.selectionStart;\n      if (cursorPos !== null && cursorPos !== undefined) {\n        lastCaretPosRef.current = cursorPos;\n      }\n    }\n\n    caretInfoRef.current = undefined;\n\n    (e.target as NumoraHTMLInputElement).rawValue = rawValue;\n\n    onRawValueChange?.(rawValue);\n\n    setDisplayValue(value);\n\n    if (onChange) {\n      onChange(e as unknown as NumoraInputChangeEvent);\n    }\n  }, [maxDecimals, formattingOptions, onChange, onRawValueChange]);\n\n  const handleKeyDown = useCallback((e: KeyboardEvent<HTMLInputElement>) => {\n    const coreCaretInfo = handleNumoraOnKeyDown(e, formattingOptions);\n\n    if (!coreCaretInfo && internalInputRef.current) {\n      const selectionStart = internalInputRef.current.selectionStart ?? 0;\n      const selectionEnd = internalInputRef.current.selectionEnd ?? 0;\n      caretInfoRef.current = {\n        selectionStart,\n        selectionEnd,\n      };\n    } else {\n      caretInfoRef.current = coreCaretInfo;\n    }\n\n    if (onKeyDown) {\n      onKeyDown(e);\n    }\n  }, [formattingOptions, onKeyDown]);\n\n  const handlePaste = useCallback((e: ClipboardEvent<HTMLInputElement>) => {\n    const { value, rawValue } = handleNumoraOnPaste(e, {\n      decimalMaxLength: maxDecimals,\n      formattingOptions,\n    });\n\n    lastCaretPosRef.current = (e.target as HTMLInputElement).selectionStart;\n    (e.target as NumoraHTMLInputElement).rawValue = rawValue;\n\n    onRawValueChange?.(rawValue);\n\n    setDisplayValue(value);\n\n    if (onPaste) {\n      onPaste(e);\n    }\n\n    // Paste calls e.preventDefault() internally, so React's onChange never fires.\n    // We synthesise a proper change event so consumers see a typed ChangeEvent.\n    if (onChange) {\n      onChange(createSyntheticChangeEvent(e.target as HTMLInputElement));\n    }\n  }, [maxDecimals, formattingOptions, onPaste, onChange, onRawValueChange]);\n\n  const handleFocus = useCallback((e: FocusEvent<HTMLInputElement>) => {\n    if (\n      formattingOptions.formatOn === FormatOn.Blur &&\n      formattingOptions.thousandSeparator &&\n      formattingOptions.ThousandStyle !== ThousandStyle.None\n    ) {\n      // Read directly from the DOM element to avoid a stale displayValue closure\n      // and to eliminate displayValue from the deps array (which would recreate\n      // this callback on every keystroke).\n      const currentValue = (e.target as HTMLInputElement).value;\n      setDisplayValue(removeThousandSeparators(currentValue, formattingOptions.thousandSeparator!));\n    }\n\n    if (onFocus) {\n      onFocus(e);\n    }\n  }, [formattingOptions, onFocus]);\n\n  const handleBlur = useCallback((e: FocusEvent<HTMLInputElement>) => {\n    const { value, rawValue } = handleNumoraOnBlur(e, {\n      decimalMaxLength: maxDecimals,\n      formattingOptions,\n    });\n\n    (e.target as NumoraHTMLInputElement).rawValue = rawValue;\n\n    onRawValueChange?.(rawValue);\n    setDisplayValue(value);\n\n    if (onBlur) {\n      onBlur(e);\n    }\n  }, [maxDecimals, formattingOptions, onBlur, onRawValueChange]);\n\n  return (\n    <input\n      {...rest}\n      ref={internalInputRef}\n      value={displayValue}\n      onChange={handleChange}\n      onKeyDown={handleKeyDown}\n      onPaste={handlePaste}\n      onFocus={handleFocus}\n      onBlur={handleBlur}\n      type=\"text\"\n      inputMode=\"decimal\"\n      spellCheck={false}\n      autoComplete=\"off\"\n    />\n  );\n});\n\nNumoraInput.displayName = 'NumoraInput';\n\nexport { NumoraInput };\nexport { FormatOn, ThousandStyle } from 'numora';\nexport type { FormattingOptions, CaretPositionInfo } from 'numora';\n"],"names":["_jsx"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "numora-react",
-  "version": "3.1.0",
+  "version": "3.3.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
@@ -16,7 +16,7 @@
   "peerDependencies": {
     "react": ">=16.8.0",
     "react-dom": ">=16.8.0",
-    "numora": ">=3.0.2"
+    "numora": ">=3.3.0"
   },
   "peerDependenciesMeta": {
     "react-dom": {
@@ -71,7 +71,7 @@
     "rollup-plugin-peer-deps-external": "^2.2.4",
     "tslib": "^2.8.1",
     "typescript": "^5.8.2",
-    "numora": "^3.1.0"
+    "numora": "^3.3.0"
   },
   "publishConfig": {
     "access": "public"

package/src/index.tsx

@@ -15,6 +15,7 @@ import {
 import {
   FormatOn,
   ThousandStyle,
+  resolveLocaleOptions,
   formatValueForDisplay,
   removeThousandSeparators,
   validateNumoraInputOptions,
@@ -97,9 +98,9 @@ const NumoraInput = forwardRef<HTMLInputElement, NumoraInputProps>((props, ref)
     onFocus,
     onRawValueChange,
     formatOn = FormatOn.Blur,
-    thousandSeparator = ',',
+    thousandSeparator,
     thousandStyle = ThousandStyle.Thousand,
-    decimalSeparator = '.',
+    decimalSeparator,
     decimalMinLength,
     enableCompactNotation = false,
     enableNegative = false,
@@ -129,17 +130,21 @@ const NumoraInput = forwardRef<HTMLInputElement, NumoraInputProps>((props, ref)
 
   // Memoize to give callbacks a stable reference - avoids recreating all
   // useCallback functions on every render when primitive props haven't changed.
-  const formattingOptions: FormattingOptions = useMemo(() => ({
-    formatOn,
-    thousandSeparator,
-    ThousandStyle: thousandStyle,
-    decimalSeparator,
-    decimalMinLength,
-    enableCompactNotation,
-    enableNegative,
-    enableLeadingZeros,
-    rawValueMode,
-  }), [formatOn, thousandSeparator, thousandStyle, decimalSeparator, decimalMinLength,
+  const formattingOptions: FormattingOptions = useMemo(() => {
+    const resolved = resolveLocaleOptions({ thousandSeparator, thousandStyle, decimalSeparator });
+
+    return {
+      formatOn,
+      thousandSeparator: resolved.thousandSeparator,
+      ThousandStyle: resolved.thousandStyle,
+      decimalSeparator: resolved.decimalSeparator,
+      decimalMinLength,
+      enableCompactNotation,
+      enableNegative,
+      enableLeadingZeros,
+      rawValueMode,
+    };
+  }, [formatOn, thousandSeparator, thousandStyle, decimalSeparator, decimalMinLength,
     enableCompactNotation, enableNegative, enableLeadingZeros, rawValueMode]);
 
   const getInitialValue = (): string => {
@@ -216,6 +221,7 @@ const NumoraInput = forwardRef<HTMLInputElement, NumoraInputProps>((props, ref)
     caretInfoRef.current = undefined;
 
     (e.target as NumoraHTMLInputElement).rawValue = rawValue;
+
     onRawValueChange?.(rawValue);
 
     setDisplayValue(value);
@@ -252,6 +258,7 @@ const NumoraInput = forwardRef<HTMLInputElement, NumoraInputProps>((props, ref)
 
     lastCaretPosRef.current = (e.target as HTMLInputElement).selectionStart;
     (e.target as NumoraHTMLInputElement).rawValue = rawValue;
+
     onRawValueChange?.(rawValue);
 
     setDisplayValue(value);
@@ -292,6 +299,7 @@ const NumoraInput = forwardRef<HTMLInputElement, NumoraInputProps>((props, ref)
     });
 
     (e.target as NumoraHTMLInputElement).rawValue = rawValue;
+
     onRawValueChange?.(rawValue);
     setDisplayValue(value);