feat: add math module for high precision computing

[axetroy]

refs: #347 https://golang.org/pkg/math/big/
porting https://github.com/MikeMcl/big.js

Extra features: support BigInt as input params

This is a draft for high precision computing solution.

If you think this is a viable option, I will continue to complete the rest.

What content including this PR?

1. Add Big module at Math/big/mod.ts

2. Add common high-precision calculation methods. Base on Big module in Math/mod.ts.

   • plus(a, b)
   • minus(a, b)
   • mod(a, b)
   • abs(a)
   • round(value, dp, rm)
   • sqrt(value)
   • times(multiplicand, multiplier)
   • toExponential(value, dp)
   • toFixed(value, dp)
   • toPrecision(value, dp)
   • eq(a, b)
   • gt(a, b)
   • gte(a, b)
   • lt(a, b)
   • lte(a, b)
   • sum([ a, b, c, d, ... ])
   • min([ a, b, c, d, ... ])
   • max([ a, b, c, d, ... ])

Plan in the future

add complex sub-module for

• sin
• cos
• tan
• polar
• rect
• phase
• ...and more

[ry]

Please list where you've forked this code from, the license, author, and copyright header

[axetroy]

Should I add Deno copyright header behind the origin copyright header?

[ry]

This link is 404. Also please state the license "MIT License" in text.

I think this module might be better as an external one (deno.land/x) than in deno_std. The reason is that it's quite large and niche - which is going to slowly down my ability to review it. If you keep the same structure as deno_std, it can potentially be moved here later.

[axetroy]

In fact, you only need to review the core module. It only has a few hundred lines of code

The test case is basically from big.js

It contains a large number of test cases to ensure the availability and stability of this package.

[j-f1]

Would it make sense to import big.js directly from https://raw.githubusercontent.com/MikeMcl/big.js/master/big.mjs?

[axetroy]

Would it make sense to import big.js directly from https://raw.githubusercontent.com/MikeMcl/big.js/master/big.mjs?

I have considered this issue too, but it has external dependencies, ie vendor/big.mjs

it seems not to meet the original intention of deno_std.

And we have to write declaration file for this.

Of course, this is also a way to do. Depends on community opinion

[axetroy]

or we can wait for support d.ts file.
denoland/deno#1432 (comment)

In this case, we only need to introduce big.js and big.d.ts files. no more including test file.

[ry]

Would it make sense to import big.js directly from https://raw.githubusercontent.com/MikeMcl/big.js/master/big.mjs

Links to external code isn't allowed in deno_std

[ry]

I'd rather have this as an external module for now.

Please submit it to https://github.com/denoland/registry/blob/master/src/database.json

[axetroy]

move to https://github.com/axetroy/deno-math.

or maybe add to deno registry https://github.com/denoland/registry/pull/88