numora 2.0.5 → 3.0.1

package/dist/utils/format-utils.d.ts

@@ -1,28 +1,28 @@
 import { type FormattingOptions } from '@/types';
 /**
- * Processes and formats a numeric input value by sanitizing, trimming decimals, and applying formatting.
- * This is a pure function that doesn't require DOM elements or events.
+ * Formats a value from user input events (onChange, onBlur) by sanitizing, trimming decimals, and applying formatting.
+ * The behavior adapts based on formatOn mode - removes separators in 'change' mode since they'll be re-added.
  *
- * @param rawValue - The raw input value to process
+ * @param rawValue - The raw input value from the user event
  * @param decimalMaxLength - Maximum number of decimal places allowed
  * @param formattingOptions - Optional formatting options
  * @param shouldRemoveThousandSeparators - Whether to remove thousand separators during sanitization (default: determined by formatOn)
  * @returns Object with formatted value and raw value (raw value is the value before formatting)
  */
-export declare function processAndFormatValue(rawValue: string, decimalMaxLength: number, formattingOptions?: FormattingOptions, shouldRemoveThousandSeparators?: boolean): {
+export declare function formatInputValue(rawValue: string, decimalMaxLength: number, formattingOptions?: FormattingOptions, shouldRemoveThousandSeparators?: boolean): {
     formatted: string;
     raw: string;
 };
 /**
- * Formats a value for display using the provided formatting options.
- * This is a pure function that can be used without DOM events.
+ * Formats a value for display (e.g., initial values, controlled values).
+ * Assumes the value might already contain thousand separators, so removes them before processing.
  *
- * @param value - The value to format
+ * @param value - The value to format for display
  * @param decimalMaxLength - Maximum number of decimal places allowed
  * @param formattingOptions - Optional formatting options
  * @returns Object with formatted value and raw value
  */
-export declare function formatValue(value: string, decimalMaxLength: number, formattingOptions?: FormattingOptions): {
+export declare function formatValueForDisplay(value: string, decimalMaxLength: number, formattingOptions?: FormattingOptions): {
     formatted: string;
     raw: string;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "numora",
-  "version": "2.0.5",
+  "version": "3.0.1",
   "description": "Precision-first numeric input library for DeFi and financial applications",
   "homepage": "https://numora.xyz/",
   "main": "dist/index.js",