powiaina_num.js 0.2.0-alpha.2.9 → 0.2.0-alpha.3.1

package/README.md

@@ -1,72 +1,98 @@
-# PowiainaNum.js
-
-A JavaScript library that handles arithmetic for numbers as large as {10,9e15,1,1,1,2}.
-
-This reaches level f<sub>ω<sup>3</sup>+1</sub>.
-
-Internally, it is represented as an sign,layer, small and array. Sign is 1 or -1. It's 10{oper.arrow, oper.expans, oper.megota}, If arrow count or expans count is Infinite, the count replaces from the next operators.
-
-Some codes snippet from [ExpantaNum.js by Naruyoko](https://github.com/Naruyoko/ExpantaNum.js)
-
-Functions are as follows `abs, neg, add, sub, mul, div, rec, pow, sqrt, cbrt, root, log10, log, cmp, isFinite, isInfinite, isNaN`(some missing items that have not been fully developed)
-
-## Using
-
-The library exports a class,
-Create a PowiainaNum.js object like this:
-
-```javascript
-import PowiainaNum from "powiaina_num.js"; // static import 
-const { default: PowiainaNum } = await import("powiaina_num.js") // dynamic import
-
-let a = new PowiainaNum(); // create PN.js number with NaN
-let b = new PowiainaNum(3); // create PN.js number with number 3
-let c = new PowiainaNum("1e114514"); // create PN.js number with number 10^114514
-
-let d = new PowiainaNum(c); // create PN.js number from a PN.js number
-```
-
-Javascript operators will not work such as `+`, `-`, etc.
-You should call the equivalent functions instead.
-
-```javascript
-let a = new PowiainaNum(114514);
-let b = new PowiainaNum(1919810);
-
-// Calculate a+b:
-let c = a.add(b); // 1919810+114514
-
-// Calculate a-b:
-let c = a.sub(b);
-
-a.mul(b); // a*b
-a.div(b); // a/b
-a.pow(b); // a^b
-
-a.log10(); // log10(a)
-
-// comparing PN.js numbers
-
-a.lt(b); // a is less than b
-a.gt(b); // a is greater than b
-a.eq(b); // a is equals to b
-```
-
-## Future ideas
-
-Extend `Operator` to nearly infinite keys to reach level f<sub>ω<sup>ω</sup></sub>
-
-```typescript
-interface Operator {
-  /*P3*/ arrow: number;
-  /*P4*/ expans: number;
-  /*P5*/ megota: number;
-  /*P6*/ powiaina: number;
-  P7: number;
-  .....
-
-  repeat: number;
-
-  valuereplaced?: -1 | 0 | 1 | 2 | ...
-}
-```
+# PowiainaNum.js
+
+A JavaScript library that handles arithmetic for numbers as large as {10,9e15,1,1,1,2}.
+
+This reaches level f<sub>ω<sup>3</sup>+1</sub>.
+
+Internally, it is represented as an sign, array, small, and layer. Sign is 1 or -1. . Layer is a non-negative integer. 
+
+The operator interface is `interface {arrow: number; expans: number; megota: number; repeat: number;}`, which respents {10, {10, ...{10, X, arrow, expans, megota}..., arrow, expans, megota}, arrow, expans, megota} (repeat means counts of 10's);
+
+The array is `Operator[]`
+
+when $$f(x) = \{10, 10, 10, 10, 10, x\}$$
+$$g_{a,b,c}(x) = \{10,x,a,b,c\}$$
+$$o_x = \text{last }x\text{th operator of array}  $$
+They together respents $s_{ign}\times f^{l_{ayer}} g_{o_1.arrow, o_1.expans, o_1.megota} g_{o_2.arrow, o_2.expans, o_2.megota} ...$
+
+If arrow count or expans count is Infinite, the count replaces to the next operators.
+
+Some codes snippet from [ExpantaNum.js by Naruyoko](https://github.com/Naruyoko/ExpantaNum.js)
+
+Functions are as follows `abs, neg, add, sub, mul, div, rec, pow, pow10, pow_base, sqrt, cbrt, root, log10, log, cmp, rec, gamma, mod, exp, ln, slog, factorial, tetrate_10, isFinite, isInfinite, isNaN, tetrate, lambertw, toString, toJSON, floor, ceil, round, trunc, clampMax, clampMin`(some missing items that have not been fully developed)
+
+## Using
+
+The library exports a class,
+Create a PowiainaNum.js object like this:
+
+```javascript
+import PowiainaNum from "powiaina_num.js"; // static import 
+const { default: PowiainaNum } = await import("powiaina_num.js") // dynamic import
+
+let a = new PowiainaNum(); // create PN.js number with NaN
+let b = new PowiainaNum(3); // create PN.js number with number 3
+let c = new PowiainaNum("1e114514"); // create PN.js number with number 10^114514
+
+let d = new PowiainaNum(c); // create PN.js number from a PN.js number
+
+let e = new PowiainaNum([[0,23.2352],[1,2],[2,6],[3,0],[4,1],[5,4]]); // You can also use a pair number array which from ExpantaNum.js
+
+let f = new PowiainaNum("(10^^^)^114514 e1919810") // ExpantaNum.js string form 
+
+let g = new PowiainaNum("10{!}e1919810") // 10{!} = 10{x}10, x points to e1919810, 10{!} = J in ExpantaNum.js
+let h = new PowiainaNum("10{1,2}ee114514") // {10, ee114514, 1, 2}
+let i = new PowiainaNum("10{1,514,114}ee114514") // {10, ee114514, 1, 514, 114}
+let j = new PowiainaNum("/10{1,514,114}ee114514") // Very small numbers ({10, ee114514, 1, 514, 114})^-1
+let k = new PowiainaNum("(e^114514)1919810") // break_eternity.js (e^x) form
+```
+
+In browser, you can download `dist/PowiainaNum.min.js` or use 
+```html
+<script src="https://unpkg.com/powiaina_num.js@alpha"></script>
+```
+
+Javascript operators will not work such as `+`, `-`, etc.
+You should call the equivalent functions instead.
+
+```javascript
+let a = new PowiainaNum(114514);
+let b = new PowiainaNum(1919810);
+
+// Calculate a+b:
+let c = a.add(b); // 1919810+114514
+
+// Calculate a-b:
+let c = a.sub(b);
+
+a.mul(b); // a*b
+a.div(b); // a/b
+a.pow(b); // a^b
+
+a.log10(); // log10(a)
+
+// comparing PN.js numbers
+
+a.lt(b); // a is less than b
+a.gt(b); // a is greater than b
+a.eq(b); // a is equals to b
+```
+
+## Future ideas
+
+Extend `Operator` to nearly infinite keys to reach level f<sub>ω<sup>ω</sup></sub>
+
+```typescript
+interface Operator {
+  /*P3*/ arrow: number;
+  /*P4*/ expans: number;
+  /*P5*/ megota: number;
+  /*P6*/ powiaina: number;
+  P7: number;
+  .....
+
+  repeat: number;
+
+  valuereplaced?: -1 | 0 | 1 | 2 | ...
+}
+```