numora 1.0.4 → 2.0.1

package/dist/types.d.ts

@@ -0,0 +1,34 @@
+export declare enum FormatOn {
+    Blur = "blur",
+    Change = "change"
+}
+export declare enum ThousandStyle {
+    None = "none",
+    Thousand = "thousand",
+    Lakh = "lakh",
+    Wan = "wan"
+}
+export interface FormattingOptions {
+    formatOn?: FormatOn;
+    thousandSeparator?: string;
+    ThousandStyle?: ThousandStyle;
+    enableCompactNotation?: boolean;
+    enableNegative?: boolean;
+    enableLeadingZeros?: boolean;
+    decimalSeparator?: string;
+    decimalMinLength?: number;
+    rawValueMode?: boolean;
+}
+export interface CaretPositionInfo {
+    selectionStart?: number;
+    selectionEnd?: number;
+    endOffset?: number;
+}
+export interface SeparatorOptions {
+    decimalSeparator?: string;
+    thousandSeparator?: string;
+}
+export interface Separators {
+    decimalSeparator: string;
+    thousandSeparator?: string;
+}

package/dist/utils/escape-reg-exp.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared utility functions used across multiple features.
+ */
+/**
+ * Escapes special regex characters in a string.
+ * This is used when building regex patterns from user-provided separator characters.
+ *
+ * @param str - The string to escape
+ * @returns The escaped string safe for use in regex patterns
+ *
+ * @example
+ * escapeRegExp(".") // Returns: "\\."
+ * escapeRegExp("$") // Returns: "\\$"
+ * escapeRegExp("1,234") // Returns: "1\\,234"
+ */
+export declare function escapeRegExp(str: string): string;

package/dist/utils/event-handlers.d.ts

@@ -1,23 +1,24 @@
-/**
- * Handles the input change event to ensure the value does not exceed the maximum number of decimal places,
- * replaces commas with dots, and removes invalid non-numeric characters.
- *
- * @param e - The event triggered by the input.
- * @param maxDecimals - The maximum number of decimal places allowed.
- */
-export declare function handleOnChangeNumericInput(e: Event, maxDecimals: number): void;
+import { type FormattingOptions, type CaretPositionInfo } from '@/types';
 /**
  * Handles the keydown event to prevent the user from entering a second decimal point.
+ * Also tracks selection info for Delete/Backspace keys to enable proper cursor positioning.
+ * In 'change' mode with formatting, skips cursor over thousand separators on delete/backspace.
  *
  * @param e - The keyboard event triggered by the input.
+ * @param formattingOptions - Optional formatting options for separator skipping
+ * @returns Caret position info if Delete/Backspace was pressed, undefined otherwise
  */
-export declare function handleOnKeyDownNumericInput(e: KeyboardEvent): void;
+export declare function handleOnKeyDownNumoraInput(e: KeyboardEvent, formattingOptions?: FormattingOptions): CaretPositionInfo | undefined;
 /**
- * Handles the paste event to ensure the value does not exceed the maximum number of decimal places,
+ * Handles the input change event to ensure the value does not exceed the maximum number of decimal places,
  * replaces commas with dots, and removes invalid non-numeric characters.
+ * Also handles cursor positioning for Delete/Backspace keys.
+ * Optionally formats with thousand separators in real-time if formatOn is 'change'.
  *
- * @param e - The clipboard event triggered by the input.
- * @param maxDecimals - The maximum number of decimal places allowed.
- * @returns The sanitized value after the paste event.
+ * @param e - The event triggered by the input.
+ * @param decimalMaxLength - The maximum number of decimal places allowed.
+ * @param caretPositionBeforeChange - Optional caret position info from keydown handler
+ * @param formattingOptions - Optional formatting options for real-time formatting
  */
-export declare function handleOnPasteNumericInput(e: ClipboardEvent, maxDecimals: number): string;
+export declare function handleOnChangeNumoraInput(e: Event, decimalMaxLength: number, caretPositionBeforeChange?: CaretPositionInfo, formattingOptions?: FormattingOptions): void;
+export declare function handleOnPasteNumoraInput(e: ClipboardEvent, decimalMaxLength: number, formattingOptions?: FormattingOptions): string;

package/dist/utils/input-pattern.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Builds an input pattern that allows optional negative sign and a single custom decimal separator.
+ * The separator is escaped so any character can be safely used.
+ */
+export declare function getNumoraPattern(decimalSeparator: string, enableNegative: boolean): string;

package/dist/validation.d.ts

@@ -0,0 +1,20 @@
+import { FormatOn } from './types';
+import { ThousandStyle } from './types';
+export interface NumoraInputValidationOptions {
+    decimalMaxLength?: number;
+    decimalMinLength?: number;
+    formatOn?: FormatOn;
+    thousandSeparator?: string;
+    thousandStyle?: ThousandStyle;
+    decimalSeparator?: string;
+    enableCompactNotation?: boolean;
+    enableNegative?: boolean;
+    enableLeadingZeros?: boolean;
+    rawValueMode?: boolean;
+    onChange?: (value: string) => void;
+}
+/**
+ * Validates all NumoraInput constructor parameters.
+ * Throws descriptive errors for invalid values.
+ */
+export declare function validateNumoraInputOptions(options: NumoraInputValidationOptions): void;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "numora",
-  "version": "1.0.4",
-  "description": "Framework-agnostic headless finance input library",
-  "homepage": "https://numora.netlify.app/",
+  "version": "2.0.1",
+  "description": "Precision-first numeric input library for DeFi and financial applications",
+  "homepage": "https://numora.xyz/",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -19,11 +19,6 @@
     "type": "git",
     "url": "https://github.com/Sharqiewicz/numora"
   },
-  "scripts": {
-    "build": "vite build && tsc --emitDeclarationOnly",
-    "test": "vitest run",
-    "dev": "vite build --watch"
-  },
   "keywords": [
     "numeric input",
     "currency input",
@@ -61,5 +56,10 @@
     "typescript": "^5.8.2",
     "vite": "^6.2.2",
     "vitest": "^3.0.9"
+  },
+  "scripts": {
+    "build": "vite build && tsc --emitDeclarationOnly",
+    "test": "vitest run",
+    "dev": "vite build --watch"
   }
-}
+}

package/dist/NumericInput.d.ts

@@ -1,21 +0,0 @@
-interface NumericInputOptions extends Partial<HTMLInputElement> {
-    maxDecimals?: number;
-    onChange?: (value: string) => void;
-}
-export declare class NumericInput {
-    private element;
-    private options;
-    constructor(container: HTMLElement, { maxDecimals, onChange, ...rest }: NumericInputOptions);
-    private createInputElement;
-    private setupEventListeners;
-    private handleChange;
-    private handleKeyDown;
-    private handlePaste;
-    getValue(): string;
-    setValue(value: string): void;
-    disable(): void;
-    enable(): void;
-    addEventListener(event: string, callback: EventListenerOrEventListenerObject): void;
-    removeEventListener(event: string, callback: EventListenerOrEventListenerObject): void;
-}
-export {};

package/dist/utils/decimals.d.ts

@@ -1,13 +0,0 @@
-export declare const replaceCommasWithDots: (value: string) => string;
-/**
- * Checks if the input already has a decimal point and prevents the user from entering another one.
- */
-export declare const alreadyHasDecimal: (e: KeyboardEvent) => boolean;
-/**
- * Trims a string representation of a number to a maximum number of decimal places.
- *
- * @param value - The string to trim.
- * @param maxDecimals - The maximum number of decimal places to allow.
- * @returns The trimmed string.
- */
-export declare const trimToMaxDecimals: (value: string, maxDecimals: number) => string;

package/dist/utils/sanitization.d.ts

@@ -1 +0,0 @@
-export declare const sanitizeNumericInput: (value: string) => string;