# Rolling Number

> @kitlangton/rolling-number: a small TypeScript library for interruptible rolling numbers with native browser animation playback, Intl.NumberFormat formatting (numbers and BigInt), and React and Solid adapters. MIT.

Install with `bun add @kitlangton/rolling-number` or `npm install @kitlangton/rolling-number`. Import `@kitlangton/rolling-number/styles.css` once. The unscoped "rolling-number" npm package is a different project.

## Docs

- [README](https://rolling.kitlangton.dev/index.md): install, DOM, React and Solid APIs, RollingText split-flap text, formatting, layout, motion blur and accessibility notes
- [Source repository](https://github.com/kitlangton/rolling-number): TypeScript source, tests and benchmarks
- [npm package](https://www.npmjs.com/package/@kitlangton/rolling-number)

## Optional

- [Design context](https://github.com/kitlangton/rolling-number/blob/main/CONTEXT.md): vocabulary for digit places, symbol roles and transitions
- [Research notes](https://github.com/kitlangton/rolling-number/blob/main/docs/research.md): renderer trade-offs and reference findings
- [Benchmark results](https://github.com/kitlangton/rolling-number/blob/main/perf/current.md): qualified DOM comparison with NumberFlow 0.6.2; run "bun run bench" locally