use-mask-input 3.10.3 → 3.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "use-mask-input",
-  "version": "3.10.3",
+  "version": "3.11.0",
   "private": false,
   "description": "A react Hook for build elegant input masks. Compatible with React Hook Form",
   "license": "MIT",

package/src/core/maskEngine.ts

@@ -45,3 +45,31 @@ export function applyMaskToElement(
     maskInstance.mask(element);
   }
 }
+
+/**
+ * Formats a raw value using the given mask, without needing a mounted element.
+ * Useful for displaying already-persisted (unmasked) values in the UI.
+ *
+ * @param value - The raw value to format
+ * @param mask - The mask pattern
+ * @param options - Optional configuration options
+ * @returns The masked value
+ */
+export function formatWithMask(value: string, mask: Mask, options?: Options): string {
+  const inputmaskInstance = moduleInterop(inputmask);
+  return inputmaskInstance.format(value, getMaskOptions(mask, options));
+}
+
+/**
+ * Removes the mask from a formatted value, without needing a mounted element.
+ * Useful for sanitizing input before sending it to the backend.
+ *
+ * @param value - The masked value to unformat
+ * @param mask - The mask pattern
+ * @param options - Optional configuration options
+ * @returns The raw, unmasked value
+ */
+export function unformatWithMask(value: string, mask: Mask, options?: Options): string {
+  const inputmaskInstance = moduleInterop(inputmask);
+  return inputmaskInstance.unmask(value, getMaskOptions(mask, options));
+}

package/src/index.tsx

@@ -7,6 +7,8 @@ export {
   withTanStackFormMask,
 } from './api';
 
+export { formatWithMask, unformatWithMask } from './core';
+
 export type {
   Input,
   Mask,