numora

A precision-first numeric input library for any web application. Zero dependencies, TypeScript-first, framework agnostic.

Packages

Package	Version	Description
numora		Core - vanilla JS/TypeScript
numora-react		React component wrapper

Install

# Core (vanilla JS/TypeScript)
npm install numora
# React
npm install numora-react

Quick example

import{NumoraInput}from'numora';constinput=newNumoraInput(document.querySelector('#amount'),{decimalMaxLength: 2,thousandSeparator: ',',onChange: (value)=>console.log(value),});

import{NumoraInput}from'numora-react';<NumoraInputmaxDecimals={2}thousandSeparator=","onChange={(e)=>console.log(e.target.value)}/>

Features

• Sanitization - filters invalid characters, mobile keyboard artifacts, and non-numeric input
• Formatting - thousand separators with Thousand/Lakh/Wan grouping styles, format on blur or change
• Decimals - configurable min/max decimal places, custom decimal separator
• Compact Notation - expands "1k" → "1000", "1.5m" → "1500000" on paste/setValue
• Scientific Notation - automatically expands "1.5e-7" → "0.00000015"
• Leading Zeros - configurable leading zero behavior

Documentation

Full documentation, live demo, and examples at numora.xyz.

License

MIT - Kacper Szarkiewicz