Math Rounding Utilities for TypeScript

Introduction

This TypeScript library adds missing math rounding utilities, in a type-safe manner.

Quick Start

# run this from your Terminal
npm install @safelytyped/math-rounding

1// add this import to your Typescript code
2import { roundDown } from "@safelytyped/math-rounding";

VS Code users: once you've added a single import anywhere in your project, you'll then be able to auto-import anything else that this library exports.

Exported Functions

roundDown()

Use roundDown() to round a number down to the precision you require.

1import { roundDown } from "@safelytyped/math-rounding";
2
3// res == 1.99
4const res = roundDown(2, 1.9999);

roundUp()

Use roundUp() to round a number up to the precision you require.

1import { roundUp } from "@safelytyped/math-rounding";
2
3// res == 2
4const res = roundUp(2, 1.99999);

roundTo()

Use roundTo() if you want to inject your own rounding function.

1import { roundTo } from "@safelytyped/math-rounding";
2
3// roundedDownRes == 1.99
4const roundedDownRes = roundDown(
5    Math.trunc,
6    2,
7    1.99999
8);
9
10// roundedUpRes == 2
11const roundedDownRes = roundDown(
12    Math.ceil,
13    2,
14    1.99999
15);

Why Another Math Rounding Package?

I found myself needing rounding functions in CSS Color that Javascript's stock Math module doesn't provide. I've published them as a separate package so that I can reuse them in other packages in the future.

But this isn't the world's first package to add missing Math rounding functions to Javascript / Typescript ... so why have I built it?

The main reason is that it follows the SafelyTyped philosophy of function parameter order:

• required modifier params come first,
• then the main input value

I find that this makes partial functions a little more readable, such as:

1import { roundDown } from "@safelytyped/ts-math-rounding";
2
3const roundDown2 = (x: number) => roundDown(2, x);

Documentation

Here's a link to all the documentation about this project.

Admin Paperwork

• Our CHANGELOG
• Our software license

For Contributors

• How to contribute
• Our Code of Conduct
• Our NPM scripts

Credits

• Current Maintainers
• All contributors to date

Follow us on Twitter!