@salve-software/react-native-nitro-input-mask 1.0.0 → 1.1.0

package/README.md

@@ -2,9 +2,9 @@
 
 Native input masks for React Native — zero JS flicker, built on [Nitro Modules](https://github.com/mrousavy/nitro).
 
-[![npm version](https://img.shields.io/npm/v/react-native-nitro-input-mask.svg)](https://www.npmjs.com/package/react-native-nitro-input-mask)
-[![npm downloads](https://img.shields.io/npm/dm/react-native-nitro-input-mask.svg)](https://www.npmjs.com/package/react-native-nitro-input-mask)
-[![License](https://img.shields.io/npm/l/react-native-nitro-input-mask.svg)](./LICENSE)
+[![npm version](https://img.shields.io/npm/v/@salve-software/react-native-nitro-input-mask.svg)](https://www.npmjs.com/package/@salve-software/react-native-nitro-input-mask)
+[![npm downloads](https://img.shields.io/npm/dm/@salve-software/react-native-nitro-input-mask.svg)](https://www.npmjs.com/package/@salve-software/react-native-nitro-input-mask)
+[![License](https://img.shields.io/npm/l/@salve-software/react-native-nitro-input-mask.svg)](./LICENSE)
 
 <p align="center">
   <img src="./assets/demo.gif" width="320" />
@@ -64,17 +64,25 @@ Drop-in replacement for `<TextInput />`. Accepts all standard `TextInputProps` p
 
 ```tsx
 import React, { useState } from 'react'
-import { NitroInputMask } from 'react-native-nitro-input-mask'
+import type { MaskResult } from '@salve-software/react-native-nitro-input-mask'
+import { NitroInputMask } from '@salve-software/react-native-nitro-input-mask'
 
 function PhoneInput() {
-  const [value, setValue] = useState('')
+  const [display, setDisplay] = useState('')
+  const [digits, setDigits] = useState('')
+
+  function handleChange({ masked, raw }: MaskResult) {
+    setDisplay(masked) // '(555) 123-4567'
+    setDigits(raw)     // '5551234567'
+  }
 
   return (
     <NitroInputMask
       maskOptions={{ mask: '(999) 999-9999' }}
       placeholder="(555) 000-0000"
       keyboardType="numeric"
-      onChangeText={setValue}
+      value={display}
+      onChangeText={handleChange}
     />
   )
 }
@@ -86,7 +94,7 @@ function PhoneInput() {
   maskType="money"
   maskOptions={{ unit: '$ ', precision: 2 }}
   keyboardType="numeric"
-  onChangeText={setValue}
+  onChangeText={({ masked, raw }) => { /* ... */ }}
 />
 
 // Date
@@ -94,7 +102,7 @@ function PhoneInput() {
   maskType="datetime"
   maskOptions={{ format: 'MM/DD/YYYY' }}
   keyboardType="numeric"
-  onChangeText={setValue}
+  onChangeText={({ masked, raw }) => { /* ... */ }}
 />
 
 // Credit card
@@ -102,7 +110,7 @@ function PhoneInput() {
   maskType="credit-card"
   maskOptions={{ issuer: 'visa-or-mastercard' }}
   keyboardType="numeric"
-  onChangeText={setValue}
+  onChangeText={({ masked, raw }) => { /* ... */ }}
 />
 ```
 
@@ -111,27 +119,28 @@ function PhoneInput() {
 Apply a mask to any string — useful for formatting values in lists, previews, etc.
 
 ```tsx
-import { NitroInputMaskService } from 'react-native-nitro-input-mask'
+import { NitroInputMaskService } from '@salve-software/react-native-nitro-input-mask'
 
-NitroInputMaskService.applyMask({
+const { masked, raw } = NitroInputMaskService.applyMask({
   value: '5551234567',
   maskOptions: { mask: '(999) 999-9999' },
 })
-// '(555) 123-4567'
+// masked: '(555) 123-4567'
+// raw:    '5551234567'
 
-NitroInputMaskService.applyMask({
+const { masked: maskedMoney } = NitroInputMaskService.applyMask({
   value: '123456',
   maskType: 'money',
   maskOptions: { unit: '$ ', precision: 2 },
 })
-// '$ 1,234.56'
+// maskedMoney: '$ 1,234.56'
 
-NitroInputMaskService.applyMask({
+const { masked: maskedDate } = NitroInputMaskService.applyMask({
   value: '06252025',
   maskType: 'datetime',
   maskOptions: { format: 'MM/DD/YYYY' },
 })
-// '06/25/2025'
+// maskedDate: '06/25/2025'
 ```
 
 ## Mask Syntax
@@ -150,6 +159,12 @@ NitroInputMaskService.applyMask({
 
 Extends React Native's [`TextInputProps`](https://reactnative.dev/docs/textinput#props).
 
+| Prop | Type | Description |
+|---|---|---|
+| `maskType` | `'custom' \| 'money' \| 'datetime' \| 'credit-card'` | Mask type (default `'custom'`) |
+| `maskOptions` | See table below | Options for the chosen mask type |
+| `onChangeText` | `(result: MaskResult) => void` | Fires on every edit with `{ masked, raw }`. Overrides React Native's default `(text: string) => void`. |
+
 | maskType | maskOptions | Docs |
 |---|---|---|
 | `'custom'` (default) | `{ mask: string }` | [docs/custom.md](./docs/custom.md) |
@@ -165,7 +180,12 @@ Extends React Native's [`TextInputProps`](https://reactnative.dev/docs/textinput
 | `maskType` | `'custom' \| 'money' \| 'datetime' \| 'credit-card'` | Mask type (default `'custom'`) |
 | `maskOptions` | See table above | Options for the chosen mask type |
 
-Returns the masked `string`.
+Returns `MaskResult`:
+
+| Field | Type | Description |
+|---|---|---|
+| `masked` | `string` | Formatted string as displayed to the user |
+| `raw` | `string` | Unformatted input. For money masks, this is digit-only. |
 
 ## Contributing
 

package/android/src/main/java/com/nitroinputmask/NitroInputMaskServiceModule.kt

@@ -3,15 +3,16 @@ package com.nitroinputmask
 import androidx.annotation.Keep
 import com.facebook.proguard.annotations.DoNotStrip
 import com.margelo.nitro.nitroinputmask.HybridNitroInputMaskServiceSpec
+import com.margelo.nitro.nitroinputmask.MaskResult
 import com.margelo.nitro.nitroinputmask.NitroMaskOptions
 import com.nitroinputmask.engine.MaskEngineFactory
 
 @Keep
 @DoNotStrip
 class HybridNitroInputMaskServiceModule : HybridNitroInputMaskServiceSpec() {
-  override fun applyMask(value: String, maskType: String, options: NitroMaskOptions): String {
+  override fun applyMask(value: String, maskType: String, options: NitroMaskOptions): MaskResult {
     val engine = MaskEngineFactory.build(maskType, options)
-    val (masked, _) = engine.apply(value)
-    return masked
+    val (masked, raw) = engine.apply(value)
+    return MaskResult(masked = masked, raw = raw)
   }
 }

package/ios/NitroInputMaskServiceModule.swift

@@ -3,9 +3,9 @@ import NitroModules
 class HybridNitroInputMaskServiceModule: HybridNitroInputMaskServiceSpec_base,
   HybridNitroInputMaskServiceSpec_protocol
 {
-  func applyMask(value: String, maskType: String, options: NitroMaskOptions) throws -> String {
+  func applyMask(value: String, maskType: String, options: NitroMaskOptions) throws -> MaskResult {
     let engine = MaskEngineFactory.build(maskType: maskType, options: options)
-    let (masked, _) = engine.apply(input: value)
-    return masked
+    let (masked, raw) = engine.apply(input: value)
+    return MaskResult(masked: masked, raw: raw)
   }
 }

package/lib/commonjs/classes/NitroInputMaskService/NitroInputMaskService.class.js

@@ -12,23 +12,25 @@ var _nitroModule = require("../../nitro-module");
  * plain function call — no component or ref required.
  *
  * @example
- * const masked = NitroInputMaskService.applyMask({
+ * const { masked, raw } = NitroInputMaskService.applyMask({
  *   value: '12345678901',
  *   maskOptions: { mask: '999.999.999-99' },
  * })
- * // '123.456.789-01'
+ * // masked: '123.456.789-01'
+ * // raw:    '12345678901'
  *
  * @example
- * const masked = NitroInputMaskService.applyMask({
+ * const { masked, raw } = NitroInputMaskService.applyMask({
  *   value: '123456',
  *   maskType: 'money',
  *   maskOptions: { unit: 'R$ ', precision: 2 },
  * })
- * // 'R$ 1.234,56'
+ * // masked: 'R$ 1.234,56'
+ * // raw:    '123456'  (digit-only string for money masks)
  */
 class NitroInputMaskService {
   /**
-   * Applies a mask to a string and returns the masked result.
+   * Applies a mask to a string and returns both the masked and raw values.
    *
    * For `custom` masks, tokens are:
    * - `9` — digit (0–9)
@@ -40,16 +42,17 @@ class NitroInputMaskService {
    * @param props.value       - The raw string to mask.
    * @param props.maskType    - The mask type: `'custom'` (default), `'money'`, `'datetime'`, `'credit-card'`.
    * @param props.maskOptions - Options specific to the chosen mask type.
-   * @returns The masked string.
+   * @returns `{ masked, raw }` — the formatted string and the unformatted input.
+   *          For money masks, `raw` is a digit-only string.
    *
    * @throws If `value` exceeds 1000 characters or `custom` mask exceeds 200 characters.
    *
    * @example
-   * NitroInputMaskService.applyMask({
+   * const { masked } = NitroInputMaskService.applyMask({
    *   value: '11987654321',
    *   maskOptions: { mask: '(99) 99999-9999' },
    * })
-   * // '(11) 98765-4321'
+   * // masked: '(11) 98765-4321'
    */
   static applyMask = props => {
     const {
@@ -60,9 +63,15 @@ class NitroInputMaskService {
     const resolvedValue = String(value ?? '');
     const resolvedMaskType = maskType ?? 'custom';
     const resolvedOptions = maskOptions ?? {};
+    if (resolvedValue.length > 1000) {
+      throw new Error('NitroInputMaskService: value exceeds maximum allowed length');
+    }
     if (resolvedMaskType === 'custom') {
       const mask = String(resolvedOptions.mask ?? '');
-      if (!mask) return resolvedValue;
+      if (!mask) return {
+        masked: resolvedValue,
+        raw: resolvedValue
+      };
       if (resolvedValue.length > 1000 || mask.length > 200) {
         throw new Error('NitroInputMaskService: value or mask exceeds maximum allowed length');
       }

package/lib/commonjs/classes/NitroInputMaskService/NitroInputMaskService.class.js.map

@@ -1 +1 @@
-{"version":3,"names":["_nitroModule","require","NitroInputMaskService","applyMask","props","value","maskType","maskOptions","resolvedValue","String","resolvedMaskType","resolvedOptions","mask","length","Error","getNitroServiceModule","exports"],"sourceRoot":"../../../../src","sources":["classes/NitroInputMaskService/NitroInputMaskService.class.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,qBAAqB,CAAC;EACjC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,OAAOC,SAAS,GAAIC,KAAsB,IAAa;IACrD,MAAM;MAAEC,KAAK;MAAEC,QAAQ;MAAEC;IAAY,CAAC,GAAGH,KAGxC;IAED,MAAMI,aAAa,GAAGC,MAAM,CAACJ,KAAK,IAAI,EAAE,CAAC;IACzC,MAAMK,gBAAgB,GAAGJ,QAAQ,IAAI,QAAQ;IAC7C,MAAMK,eAAe,GAAGJ,WAAW,IAAI,CAAC,CAAC;IAEzC,IAAIG,gBAAgB,KAAK,QAAQ,EAAE;MACjC,MAAME,IAAI,GAAGH,MAAM,CAAEE,eAAe,CAAuBC,IAAI,IAAI,EAAE,CAAC;MACtE,IAAI,CAACA,IAAI,EAAE,OAAOJ,aAAa;MAC/B,IAAIA,aAAa,CAACK,MAAM,GAAG,IAAI,IAAID,IAAI,CAACC,MAAM,GAAG,GAAG,EAAE;QACpD,MAAM,IAAIC,KAAK,CAAC,qEAAqE,CAAC;MACxF;IACF;IAEA,OAAO,IAAAC,kCAAqB,EAAC,CAAC,CAACZ,SAAS,CAACK,aAAa,EAAEE,gBAAgB,EAAEC,eAAe,CAAC;EAC5F,CAAC;AACH;AAACK,OAAA,CAAAd,qBAAA,GAAAA,qBAAA","ignoreList":[]}
+{"version":3,"names":["_nitroModule","require","NitroInputMaskService","applyMask","props","value","maskType","maskOptions","resolvedValue","String","resolvedMaskType","resolvedOptions","length","Error","mask","masked","raw","getNitroServiceModule","exports"],"sourceRoot":"../../../../src","sources":["classes/NitroInputMaskService/NitroInputMaskService.class.ts"],"mappings":";;;;;;AAEA,IAAAA,YAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,qBAAqB,CAAC;EACjC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,OAAOC,SAAS,GAAIC,KAAsB,IAAiB;IACzD,MAAM;MAAEC,KAAK;MAAEC,QAAQ;MAAEC;IAAY,CAAC,GAAGH,KAGxC;IAED,MAAMI,aAAa,GAAGC,MAAM,CAACJ,KAAK,IAAI,EAAE,CAAC;IACzC,MAAMK,gBAAgB,GAAGJ,QAAQ,IAAI,QAAQ;IAC7C,MAAMK,eAAe,GAAGJ,WAAW,IAAI,CAAC,CAAC;IAEzC,IAAIC,aAAa,CAACI,MAAM,GAAG,IAAI,EAAE;MAC/B,MAAM,IAAIC,KAAK,CAAC,6DAA6D,CAAC;IAChF;IAEA,IAAIH,gBAAgB,KAAK,QAAQ,EAAE;MACjC,MAAMI,IAAI,GAAGL,MAAM,CAAEE,eAAe,CAAuBG,IAAI,IAAI,EAAE,CAAC;MACtE,IAAI,CAACA,IAAI,EAAE,OAAO;QAAEC,MAAM,EAAEP,aAAa;QAAEQ,GAAG,EAAER;MAAc,CAAC;MAC/D,IAAIA,aAAa,CAACI,MAAM,GAAG,IAAI,IAAIE,IAAI,CAACF,MAAM,GAAG,GAAG,EAAE;QACpD,MAAM,IAAIC,KAAK,CAAC,qEAAqE,CAAC;MACxF;IACF;IAEA,OAAO,IAAAI,kCAAqB,EAAC,CAAC,CAACd,SAAS,CAACK,aAAa,EAAEE,gBAAgB,EAAEC,eAAe,CAAC;EAC5F,CAAC;AACH;AAACO,OAAA,CAAAhB,qBAAA,GAAAA,qBAAA","ignoreList":[]}

package/lib/commonjs/components/NitroInputMask/index.js

@@ -13,27 +13,43 @@ const NitroInputMask = props => {
   const {
     maskType,
     maskOptions,
+    onChangeText,
     value,
     ...rest
   } = props;
-  const resolvedMaskType = maskType ?? 'custom';
   const reactId = (0, _react.useId)();
+  const resolvedMaskType = maskType ?? 'custom';
+  const resolvedOptions = maskOptions ?? {};
   const id = `nitro-input-mask-${reactId}`;
-  const maskOptionsJson = JSON.stringify(maskOptions ?? {});
+  const maskOptionsJson = JSON.stringify(resolvedOptions);
+  const stableOptions = (0, _react.useMemo)(() => JSON.parse(maskOptionsJson), [maskOptionsJson]);
+  const valueFromUserInput = (0, _react.useRef)(false);
   (0, _react.useEffect)(() => {
-    _nitroModule.nitroModule.attach(id, resolvedMaskType, maskOptions ?? {});
+    _nitroModule.nitroModule.attach(id, resolvedMaskType, stableOptions);
     if (value != null) _nitroModule.nitroModule.setValue(id, String(value));
     return () => _nitroModule.nitroModule.detach(id);
   }, []);
   (0, _react.useEffect)(() => {
-    _nitroModule.nitroModule.updateMask(id, resolvedMaskType, maskOptions ?? {});
+    _nitroModule.nitroModule.updateMask(id, resolvedMaskType, stableOptions);
   }, [resolvedMaskType, maskOptionsJson]);
   (0, _react.useEffect)(() => {
     if (value == null) return;
+    if (valueFromUserInput.current) {
+      valueFromUserInput.current = false;
+      return;
+    }
     _nitroModule.nitroModule.setValue(id, String(value));
   }, [value]);
+  const handleChangeText = (0, _react.useCallback)(text => {
+    valueFromUserInput.current = true;
+    if (onChangeText) {
+      const result = (0, _nitroModule.getNitroServiceModule)().applyMask(text, resolvedMaskType, stableOptions);
+      onChangeText(result);
+    }
+  }, [onChangeText, resolvedMaskType, stableOptions]);
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TextInput, {
     ...rest,
+    onChangeText: handleChangeText,
     nativeID: id
   });
 };

package/lib/commonjs/components/NitroInputMask/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_nitroModule","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","NitroInputMask","props","maskType","maskOptions","value","rest","resolvedMaskType","reactId","useId","id","maskOptionsJson","JSON","stringify","useEffect","nitroModule","attach","setValue","String","detach","updateMask","jsx","TextInput","nativeID","exports"],"sourceRoot":"../../../../src","sources":["components/NitroInputMask/index.tsx"],"mappings":";;;;;;AACA,IAAAA,MAAA,GAAAC,uBAAA,CAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AACA,IAAAE,YAAA,GAAAF,OAAA;AAAiD,IAAAG,WAAA,GAAAH,OAAA;AAAA,SAAAD,wBAAAK,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAP,uBAAA,YAAAA,CAAAK,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAE1C,MAAMkB,cAAc,GAAIC,KAA0B,IAAK;EAC5D,MAAM;IAAEC,QAAQ;IAAEC,WAAW;IAAEC,KAAK;IAAE,GAAGC;EAAK,CAAC,GAAGJ,KAGjD;EAED,MAAMK,gBAAgB,GAAGJ,QAAQ,IAAI,QAAQ;EAC7C,MAAMK,OAAO,GAAG,IAAAC,YAAK,EAAC,CAAC;EACvB,MAAMC,EAAE,GAAG,oBAAoBF,OAAO,EAAE;EAExC,MAAMG,eAAe,GAAGC,IAAI,CAACC,SAAS,CAACT,WAAW,IAAI,CAAC,CAAC,CAAC;EAEzD,IAAAU,gBAAS,EAAC,MAAM;IACdC,wBAAW,CAACC,MAAM,CAACN,EAAE,EAAEH,gBAAgB,EAAEH,WAAW,IAAI,CAAC,CAAC,CAAC;IAC3D,IAAIC,KAAK,IAAI,IAAI,EAAEU,wBAAW,CAACE,QAAQ,CAACP,EAAE,EAAEQ,MAAM,CAACb,KAAK,CAAC,CAAC;IAC1D,OAAO,MAAMU,wBAAW,CAACI,MAAM,CAACT,EAAE,CAAC;EACrC,CAAC,EAAE,EAAE,CAAC;EAEN,IAAAI,gBAAS,EAAC,MAAM;IACdC,wBAAW,CAACK,UAAU,CAACV,EAAE,EAAEH,gBAAgB,EAAEH,WAAW,IAAI,CAAC,CAAC,CAAC;EACjE,CAAC,EAAE,CAACG,gBAAgB,EAAEI,eAAe,CAAC,CAAC;EAEvC,IAAAG,gBAAS,EAAC,MAAM;IACd,IAAIT,KAAK,IAAI,IAAI,EAAE;IACnBU,wBAAW,CAACE,QAAQ,CAACP,EAAE,EAAEQ,MAAM,CAACb,KAAK,CAAC,CAAC;EACzC,CAAC,EAAE,CAACA,KAAK,CAAC,CAAC;EAEX,oBACE,IAAAxB,WAAA,CAAAwC,GAAA,EAAC1C,YAAA,CAAA2C,SAAS;IAAA,GACJhB,IAAI;IACRiB,QAAQ,EAAEb;EAAG,CACd,CAAC;AAEN,CAAC;AAAAc,OAAA,CAAAvB,cAAA,GAAAA,cAAA","ignoreList":[]}
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_nitroModule","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","NitroInputMask","props","maskType","maskOptions","onChangeText","value","rest","reactId","useId","resolvedMaskType","resolvedOptions","id","maskOptionsJson","JSON","stringify","stableOptions","useMemo","parse","valueFromUserInput","useRef","useEffect","nitroModule","attach","setValue","String","detach","updateMask","current","handleChangeText","useCallback","text","result","getNitroServiceModule","applyMask","jsx","TextInput","nativeID","exports"],"sourceRoot":"../../../../src","sources":["components/NitroInputMask/index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/types/MaskResult.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=MaskResult.js.map

package/lib/commonjs/types/MaskResult.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/MaskResult.ts"],"mappings":"","ignoreList":[]}

package/lib/module/classes/NitroInputMaskService/NitroInputMaskService.class.js

@@ -9,23 +9,25 @@ import { getNitroServiceModule } from '../../nitro-module';
  * plain function call — no component or ref required.
  *
  * @example
- * const masked = NitroInputMaskService.applyMask({
+ * const { masked, raw } = NitroInputMaskService.applyMask({
  *   value: '12345678901',
  *   maskOptions: { mask: '999.999.999-99' },
  * })
- * // '123.456.789-01'
+ * // masked: '123.456.789-01'
+ * // raw:    '12345678901'
  *
  * @example
- * const masked = NitroInputMaskService.applyMask({
+ * const { masked, raw } = NitroInputMaskService.applyMask({
  *   value: '123456',
  *   maskType: 'money',
  *   maskOptions: { unit: 'R$ ', precision: 2 },
  * })
- * // 'R$ 1.234,56'
+ * // masked: 'R$ 1.234,56'
+ * // raw:    '123456'  (digit-only string for money masks)
  */
 export class NitroInputMaskService {
   /**
-   * Applies a mask to a string and returns the masked result.
+   * Applies a mask to a string and returns both the masked and raw values.
    *
    * For `custom` masks, tokens are:
    * - `9` — digit (0–9)
@@ -37,16 +39,17 @@ export class NitroInputMaskService {
    * @param props.value       - The raw string to mask.
    * @param props.maskType    - The mask type: `'custom'` (default), `'money'`, `'datetime'`, `'credit-card'`.
    * @param props.maskOptions - Options specific to the chosen mask type.
-   * @returns The masked string.
+   * @returns `{ masked, raw }` — the formatted string and the unformatted input.
+   *          For money masks, `raw` is a digit-only string.
    *
    * @throws If `value` exceeds 1000 characters or `custom` mask exceeds 200 characters.
    *
    * @example
-   * NitroInputMaskService.applyMask({
+   * const { masked } = NitroInputMaskService.applyMask({
    *   value: '11987654321',
    *   maskOptions: { mask: '(99) 99999-9999' },
    * })
-   * // '(11) 98765-4321'
+   * // masked: '(11) 98765-4321'
    */
   static applyMask = props => {
     const {
@@ -57,9 +60,15 @@ export class NitroInputMaskService {
     const resolvedValue = String(value ?? '');
     const resolvedMaskType = maskType ?? 'custom';
     const resolvedOptions = maskOptions ?? {};
+    if (resolvedValue.length > 1000) {
+      throw new Error('NitroInputMaskService: value exceeds maximum allowed length');
+    }
     if (resolvedMaskType === 'custom') {
       const mask = String(resolvedOptions.mask ?? '');
-      if (!mask) return resolvedValue;
+      if (!mask) return {
+        masked: resolvedValue,
+        raw: resolvedValue
+      };
       if (resolvedValue.length > 1000 || mask.length > 200) {
         throw new Error('NitroInputMaskService: value or mask exceeds maximum allowed length');
       }

package/lib/module/classes/NitroInputMaskService/NitroInputMaskService.class.js.map

@@ -1 +1 @@
-{"version":3,"names":["getNitroServiceModule","NitroInputMaskService","applyMask","props","value","maskType","maskOptions","resolvedValue","String","resolvedMaskType","resolvedOptions","mask","length","Error"],"sourceRoot":"../../../../src","sources":["classes/NitroInputMaskService/NitroInputMaskService.class.ts"],"mappings":";;AACA,SAASA,qBAAqB,QAAQ,oBAAoB;;AAE1D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,qBAAqB,CAAC;EACjC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,OAAOC,SAAS,GAAIC,KAAsB,IAAa;IACrD,MAAM;MAAEC,KAAK;MAAEC,QAAQ;MAAEC;IAAY,CAAC,GAAGH,KAGxC;IAED,MAAMI,aAAa,GAAGC,MAAM,CAACJ,KAAK,IAAI,EAAE,CAAC;IACzC,MAAMK,gBAAgB,GAAGJ,QAAQ,IAAI,QAAQ;IAC7C,MAAMK,eAAe,GAAGJ,WAAW,IAAI,CAAC,CAAC;IAEzC,IAAIG,gBAAgB,KAAK,QAAQ,EAAE;MACjC,MAAME,IAAI,GAAGH,MAAM,CAAEE,eAAe,CAAuBC,IAAI,IAAI,EAAE,CAAC;MACtE,IAAI,CAACA,IAAI,EAAE,OAAOJ,aAAa;MAC/B,IAAIA,aAAa,CAACK,MAAM,GAAG,IAAI,IAAID,IAAI,CAACC,MAAM,GAAG,GAAG,EAAE;QACpD,MAAM,IAAIC,KAAK,CAAC,qEAAqE,CAAC;MACxF;IACF;IAEA,OAAOb,qBAAqB,CAAC,CAAC,CAACE,SAAS,CAACK,aAAa,EAAEE,gBAAgB,EAAEC,eAAe,CAAC;EAC5F,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["getNitroServiceModule","NitroInputMaskService","applyMask","props","value","maskType","maskOptions","resolvedValue","String","resolvedMaskType","resolvedOptions","length","Error","mask","masked","raw"],"sourceRoot":"../../../../src","sources":["classes/NitroInputMaskService/NitroInputMaskService.class.ts"],"mappings":";;AAEA,SAASA,qBAAqB,QAAQ,oBAAoB;;AAE1D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,qBAAqB,CAAC;EACjC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,OAAOC,SAAS,GAAIC,KAAsB,IAAiB;IACzD,MAAM;MAAEC,KAAK;MAAEC,QAAQ;MAAEC;IAAY,CAAC,GAAGH,KAGxC;IAED,MAAMI,aAAa,GAAGC,MAAM,CAACJ,KAAK,IAAI,EAAE,CAAC;IACzC,MAAMK,gBAAgB,GAAGJ,QAAQ,IAAI,QAAQ;IAC7C,MAAMK,eAAe,GAAGJ,WAAW,IAAI,CAAC,CAAC;IAEzC,IAAIC,aAAa,CAACI,MAAM,GAAG,IAAI,EAAE;MAC/B,MAAM,IAAIC,KAAK,CAAC,6DAA6D,CAAC;IAChF;IAEA,IAAIH,gBAAgB,KAAK,QAAQ,EAAE;MACjC,MAAMI,IAAI,GAAGL,MAAM,CAAEE,eAAe,CAAuBG,IAAI,IAAI,EAAE,CAAC;MACtE,IAAI,CAACA,IAAI,EAAE,OAAO;QAAEC,MAAM,EAAEP,aAAa;QAAEQ,GAAG,EAAER;MAAc,CAAC;MAC/D,IAAIA,aAAa,CAACI,MAAM,GAAG,IAAI,IAAIE,IAAI,CAACF,MAAM,GAAG,GAAG,EAAE;QACpD,MAAM,IAAIC,KAAK,CAAC,qEAAqE,CAAC;MACxF;IACF;IAEA,OAAOZ,qBAAqB,CAAC,CAAC,CAACE,SAAS,CAACK,aAAa,EAAEE,gBAAgB,EAAEC,eAAe,CAAC;EAC5F,CAAC;AACH","ignoreList":[]}

package/lib/module/components/NitroInputMask/index.js

@@ -1,34 +1,50 @@
 "use strict";
 
-import React, { useEffect, useId } from 'react';
+import React, { useCallback, useEffect, useId, useMemo, useRef } from 'react';
 import { TextInput } from 'react-native';
-import { nitroModule } from '../../nitro-module';
+import { nitroModule, getNitroServiceModule } from '../../nitro-module';
 import { jsx as _jsx } from "react/jsx-runtime";
 export const NitroInputMask = props => {
   const {
     maskType,
     maskOptions,
+    onChangeText,
     value,
     ...rest
   } = props;
-  const resolvedMaskType = maskType ?? 'custom';
   const reactId = useId();
+  const resolvedMaskType = maskType ?? 'custom';
+  const resolvedOptions = maskOptions ?? {};
   const id = `nitro-input-mask-${reactId}`;
-  const maskOptionsJson = JSON.stringify(maskOptions ?? {});
+  const maskOptionsJson = JSON.stringify(resolvedOptions);
+  const stableOptions = useMemo(() => JSON.parse(maskOptionsJson), [maskOptionsJson]);
+  const valueFromUserInput = useRef(false);
   useEffect(() => {
-    nitroModule.attach(id, resolvedMaskType, maskOptions ?? {});
+    nitroModule.attach(id, resolvedMaskType, stableOptions);
     if (value != null) nitroModule.setValue(id, String(value));
     return () => nitroModule.detach(id);
   }, []);
   useEffect(() => {
-    nitroModule.updateMask(id, resolvedMaskType, maskOptions ?? {});
+    nitroModule.updateMask(id, resolvedMaskType, stableOptions);
   }, [resolvedMaskType, maskOptionsJson]);
   useEffect(() => {
     if (value == null) return;
+    if (valueFromUserInput.current) {
+      valueFromUserInput.current = false;
+      return;
+    }
     nitroModule.setValue(id, String(value));
   }, [value]);
+  const handleChangeText = useCallback(text => {
+    valueFromUserInput.current = true;
+    if (onChangeText) {
+      const result = getNitroServiceModule().applyMask(text, resolvedMaskType, stableOptions);
+      onChangeText(result);
+    }
+  }, [onChangeText, resolvedMaskType, stableOptions]);
   return /*#__PURE__*/_jsx(TextInput, {
     ...rest,
+    onChangeText: handleChangeText,
     nativeID: id
   });
 };

package/lib/module/components/NitroInputMask/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","useEffect","useId","TextInput","nitroModule","jsx","_jsx","NitroInputMask","props","maskType","maskOptions","value","rest","resolvedMaskType","reactId","id","maskOptionsJson","JSON","stringify","attach","setValue","String","detach","updateMask","nativeID"],"sourceRoot":"../../../../src","sources":["components/NitroInputMask/index.tsx"],"mappings":";;AACA,OAAOA,KAAK,IAAIC,SAAS,EAAEC,KAAK,QAAQ,OAAO;AAC/C,SAASC,SAAS,QAAQ,cAAc;AACxC,SAASC,WAAW,QAAQ,oBAAoB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAEjD,OAAO,MAAMC,cAAc,GAAIC,KAA0B,IAAK;EAC5D,MAAM;IAAEC,QAAQ;IAAEC,WAAW;IAAEC,KAAK;IAAE,GAAGC;EAAK,CAAC,GAAGJ,KAGjD;EAED,MAAMK,gBAAgB,GAAGJ,QAAQ,IAAI,QAAQ;EAC7C,MAAMK,OAAO,GAAGZ,KAAK,CAAC,CAAC;EACvB,MAAMa,EAAE,GAAG,oBAAoBD,OAAO,EAAE;EAExC,MAAME,eAAe,GAAGC,IAAI,CAACC,SAAS,CAACR,WAAW,IAAI,CAAC,CAAC,CAAC;EAEzDT,SAAS,CAAC,MAAM;IACdG,WAAW,CAACe,MAAM,CAACJ,EAAE,EAAEF,gBAAgB,EAAEH,WAAW,IAAI,CAAC,CAAC,CAAC;IAC3D,IAAIC,KAAK,IAAI,IAAI,EAAEP,WAAW,CAACgB,QAAQ,CAACL,EAAE,EAAEM,MAAM,CAACV,KAAK,CAAC,CAAC;IAC1D,OAAO,MAAMP,WAAW,CAACkB,MAAM,CAACP,EAAE,CAAC;EACrC,CAAC,EAAE,EAAE,CAAC;EAENd,SAAS,CAAC,MAAM;IACdG,WAAW,CAACmB,UAAU,CAACR,EAAE,EAAEF,gBAAgB,EAAEH,WAAW,IAAI,CAAC,CAAC,CAAC;EACjE,CAAC,EAAE,CAACG,gBAAgB,EAAEG,eAAe,CAAC,CAAC;EAEvCf,SAAS,CAAC,MAAM;IACd,IAAIU,KAAK,IAAI,IAAI,EAAE;IACnBP,WAAW,CAACgB,QAAQ,CAACL,EAAE,EAAEM,MAAM,CAACV,KAAK,CAAC,CAAC;EACzC,CAAC,EAAE,CAACA,KAAK,CAAC,CAAC;EAEX,oBACEL,IAAA,CAACH,SAAS;IAAA,GACJS,IAAI;IACRY,QAAQ,EAAET;EAAG,CACd,CAAC;AAEN,CAAC","ignoreList":[]}
+{"version":3,"names":["React","useCallback","useEffect","useId","useMemo","useRef","TextInput","nitroModule","getNitroServiceModule","jsx","_jsx","NitroInputMask","props","maskType","maskOptions","onChangeText","value","rest","reactId","resolvedMaskType","resolvedOptions","id","maskOptionsJson","JSON","stringify","stableOptions","parse","valueFromUserInput","attach","setValue","String","detach","updateMask","current","handleChangeText","text","result","applyMask","nativeID"],"sourceRoot":"../../../../src","sources":["components/NitroInputMask/index.tsx"],"mappings":";;AAEA,OAAOA,KAAK,IAAIC,WAAW,EAAEC,SAAS,EAAEC,KAAK,EAAEC,OAAO,EAAEC,MAAM,QAAQ,OAAO;AAC7E,SAASC,SAAS,QAAQ,cAAc;AACxC,SAASC,WAAW,EAAEC,qBAAqB,QAAQ,oBAAoB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAExE,OAAO,MAAMC,cAAc,GAAIC,KAA0B,IAAK;EAC5D,MAAM;IAAEC,QAAQ;IAAEC,WAAW;IAAEC,YAAY;IAAEC,KAAK;IAAE,GAAGC;EAAK,CAAC,GAAGL,KAAK;EAErE,MAAMM,OAAO,GAAGf,KAAK,CAAC,CAAC;EAEvB,MAAMgB,gBAAgB,GAAGN,QAAQ,IAAI,QAAQ;EAC7C,MAAMO,eAAe,GAAIN,WAAW,IAAI,CAAC,CAA6B;EACtE,MAAMO,EAAE,GAAG,oBAAoBH,OAAO,EAAE;EACxC,MAAMI,eAAe,GAAGC,IAAI,CAACC,SAAS,CAACJ,eAAe,CAAC;EAEvD,MAAMK,aAA+B,GAAGrB,OAAO,CAAC,MAAMmB,IAAI,CAACG,KAAK,CAACJ,eAAe,CAAC,EAAE,CAACA,eAAe,CAAC,CAAC;EACrG,MAAMK,kBAAkB,GAAGtB,MAAM,CAAC,KAAK,CAAC;EAExCH,SAAS,CAAC,MAAM;IACdK,WAAW,CAACqB,MAAM,CAACP,EAAE,EAAEF,gBAAgB,EAAEM,aAAa,CAAC;IACvD,IAAIT,KAAK,IAAI,IAAI,EAAET,WAAW,CAACsB,QAAQ,CAACR,EAAE,EAAES,MAAM,CAACd,KAAK,CAAC,CAAC;IAC1D,OAAO,MAAMT,WAAW,CAACwB,MAAM,CAACV,EAAE,CAAC;EACrC,CAAC,EAAE,EAAE,CAAC;EAENnB,SAAS,CAAC,MAAM;IACdK,WAAW,CAACyB,UAAU,CAACX,EAAE,EAAEF,gBAAgB,EAAEM,aAAa,CAAC;EAC7D,CAAC,EAAE,CAACN,gBAAgB,EAAEG,eAAe,CAAC,CAAC;EAEvCpB,SAAS,CAAC,MAAM;IACd,IAAIc,KAAK,IAAI,IAAI,EAAE;IAEnB,IAAIW,kBAAkB,CAACM,OAAO,EAAE;MAC9BN,kBAAkB,CAACM,OAAO,GAAG,KAAK;MAClC;IACF;IAEA1B,WAAW,CAACsB,QAAQ,CAACR,EAAE,EAAES,MAAM,CAACd,KAAK,CAAC,CAAC;EACzC,CAAC,EAAE,CAACA,KAAK,CAAC,CAAC;EAEX,MAAMkB,gBAAgB,GAAGjC,WAAW,CAAEkC,IAAY,IAAK;IACrDR,kBAAkB,CAACM,OAAO,GAAG,IAAI;IAEjC,IAAIlB,YAAY,EAAE;MAChB,MAAMqB,MAAM,GAAG5B,qBAAqB,CAAC,CAAC,CAAC6B,SAAS,CAACF,IAAI,EAAEhB,gBAAgB,EAAEM,aAAa,CAAC;MACvFV,YAAY,CAACqB,MAAM,CAAC;IACtB;EACF,CAAC,EAAE,CAACrB,YAAY,EAAEI,gBAAgB,EAAEM,aAAa,CAAC,CAAC;EAEnD,oBACEf,IAAA,CAACJ,SAAS;IAAA,GACJW,IAAI;IACRF,YAAY,EAAEmB,gBAAiB;IAC/BI,QAAQ,EAAEjB;EAAG,CACd,CAAC;AAEN,CAAC","ignoreList":[]}

package/lib/module/types/MaskResult.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=MaskResult.js.map

package/lib/module/types/MaskResult.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/MaskResult.ts"],"mappings":"","ignoreList":[]}

package/lib/typescript/src/classes/NitroInputMaskService/NitroInputMaskService.class.d.ts

@@ -1,4 +1,5 @@
 import type { IApplyMaskProps } from './types';
+import type { MaskResult } from '../../types';
 /**
  * Standalone service for applying input masks natively.
  *
@@ -6,23 +7,25 @@ import type { IApplyMaskProps } from './types';
  * plain function call — no component or ref required.
  *
  * @example
- * const masked = NitroInputMaskService.applyMask({
+ * const { masked, raw } = NitroInputMaskService.applyMask({
  *   value: '12345678901',
  *   maskOptions: { mask: '999.999.999-99' },
  * })
- * // '123.456.789-01'
+ * // masked: '123.456.789-01'
+ * // raw:    '12345678901'
  *
  * @example
- * const masked = NitroInputMaskService.applyMask({
+ * const { masked, raw } = NitroInputMaskService.applyMask({
  *   value: '123456',
  *   maskType: 'money',
  *   maskOptions: { unit: 'R$ ', precision: 2 },
  * })
- * // 'R$ 1.234,56'
+ * // masked: 'R$ 1.234,56'
+ * // raw:    '123456'  (digit-only string for money masks)
  */
 export declare class NitroInputMaskService {
     /**
-     * Applies a mask to a string and returns the masked result.
+     * Applies a mask to a string and returns both the masked and raw values.
      *
      * For `custom` masks, tokens are:
      * - `9` — digit (0–9)
@@ -34,17 +37,18 @@ export declare class NitroInputMaskService {
      * @param props.value       - The raw string to mask.
      * @param props.maskType    - The mask type: `'custom'` (default), `'money'`, `'datetime'`, `'credit-card'`.
      * @param props.maskOptions - Options specific to the chosen mask type.
-     * @returns The masked string.
+     * @returns `{ masked, raw }` — the formatted string and the unformatted input.
+     *          For money masks, `raw` is a digit-only string.
      *
      * @throws If `value` exceeds 1000 characters or `custom` mask exceeds 200 characters.
      *
      * @example
-     * NitroInputMaskService.applyMask({
+     * const { masked } = NitroInputMaskService.applyMask({
      *   value: '11987654321',
      *   maskOptions: { mask: '(99) 99999-9999' },
      * })
-     * // '(11) 98765-4321'
+     * // masked: '(11) 98765-4321'
      */
-    static applyMask: (props: IApplyMaskProps) => string;
+    static applyMask: (props: IApplyMaskProps) => MaskResult;
 }
 //# sourceMappingURL=NitroInputMaskService.class.d.ts.map

package/lib/typescript/src/classes/NitroInputMaskService/NitroInputMaskService.class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NitroInputMaskService.class.d.ts","sourceRoot":"","sources":["../../../../../src/classes/NitroInputMaskService/NitroInputMaskService.class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,qBAAqB;IAChC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,SAAS,GAAI,OAAO,eAAe,KAAG,MAAM,CAmBlD;CACF"}
+{"version":3,"file":"NitroInputMaskService.class.d.ts","sourceRoot":"","sources":["../../../../../src/classes/NitroInputMaskService/NitroInputMaskService.class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,qBAAqB;IAChC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,SAAS,GAAI,OAAO,eAAe,KAAG,UAAU,CAuBtD;CACF"}

package/lib/typescript/src/components/NitroInputMask/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/NitroInputMask/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAA2B,MAAM,OAAO,CAAC;AAIhD,eAAO,MAAM,cAAc,GAAI,OAAO,mBAAmB,sBAiCxD,CAAA;AAED,mBAAmB,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/NitroInputMask/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,KAAyD,MAAM,OAAO,CAAC;AAI9E,eAAO,MAAM,cAAc,GAAI,OAAO,mBAAmB,sBAkDxD,CAAA;AAED,mBAAmB,SAAS,CAAC"}

package/lib/typescript/src/components/NitroInputMask/types/NitroInputMaskProps.d.ts

@@ -1,4 +1,21 @@
 import type { TextInputProps } from 'react-native';
-import type { MaskConfig } from '../../../types';
-export type NitroInputMaskProps = TextInputProps & MaskConfig;
+import type { MaskConfig, MaskResult } from '../../../types';
+export type NitroInputMaskProps = Omit<TextInputProps, 'onChangeText'> & MaskConfig & {
+    /**
+     * Called on every edit with both the masked display value and the raw
+     * unformatted value, giving consumers a single callback for both.
+     *
+     * For money masks, `raw` is a digit-only string.
+     *
+     * @example
+     * <NitroInputMask
+     *   maskOptions={{ mask: '(999) 999-9999' }}
+     *   onChangeText={({ masked, raw }) => {
+     *     setDisplay(masked)
+     *     setDigits(raw)
+     *   }}
+     * />
+     */
+    onChangeText?: (result: MaskResult) => void;
+};
 //# sourceMappingURL=NitroInputMaskProps.d.ts.map

package/lib/typescript/src/components/NitroInputMask/types/NitroInputMaskProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NitroInputMaskProps.d.ts","sourceRoot":"","sources":["../../../../../../src/components/NitroInputMask/types/NitroInputMaskProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,UAAU,CAAC"}
+{"version":3,"file":"NitroInputMaskProps.d.ts","sourceRoot":"","sources":["../../../../../../src/components/NitroInputMask/types/NitroInputMaskProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,GAAG,UAAU,GAAG;IACpF;;;;;;;;;;;;;;OAcG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;CAC5C,CAAA"}

package/lib/typescript/src/specs/nitro-input-mask-service.nitro.d.ts

@@ -1,9 +1,13 @@
 import type { HybridObject } from 'react-native-nitro-modules';
 import type { NitroMaskOptions } from './nitro-input-mask.nitro';
+export interface MaskResult {
+    masked: string;
+    raw: string;
+}
 export interface NitroInputMaskService extends HybridObject<{
     ios: 'swift';
     android: 'kotlin';
 }> {
-    applyMask(value: string, maskType: string, options: NitroMaskOptions): string;
+    applyMask(value: string, maskType: string, options: NitroMaskOptions): MaskResult;
 }
 //# sourceMappingURL=nitro-input-mask-service.nitro.d.ts.map

package/lib/typescript/src/specs/nitro-input-mask-service.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nitro-input-mask-service.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/nitro-input-mask-service.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEhE,MAAM,WAAW,qBAAsB,SAAQ,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;IAC9F,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAA;CAC9E"}
+{"version":3,"file":"nitro-input-mask-service.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/nitro-input-mask-service.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAKhE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,qBAAsB,SAAQ,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;IAC9F,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,UAAU,CAAA;CAClF"}

package/lib/typescript/src/types/MaskResult.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The result returned by `NitroInputMaskService.applyMask()` and
+ * delivered to `<NitroInputMask onChangeText />`.
+ *
+ * - `masked` — the formatted string as displayed to the user (e.g. `"(555) 123-4567"`)
+ * - `raw`    — the unformatted input stripped of mask literals.
+ *              For money masks this is a digit-only string (e.g. `"123456"`).
+ */
+export type MaskResult = {
+    masked: string;
+    raw: string;
+};
+//# sourceMappingURL=MaskResult.d.ts.map

package/lib/typescript/src/types/MaskResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaskResult.d.ts","sourceRoot":"","sources":["../../../../src/types/MaskResult.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA"}

package/lib/typescript/src/types/index.d.ts

@@ -1,5 +1,6 @@
 export type * from './CustomMaskOptions';
 export type * from './MaskConfig';
+export type * from './MaskResult';
 export type * from './MoneyMaskOptions';
 export type * from './CreditCardMaskOptions';
 export type * from './DatetimeMaskOptions';