powiaina_num.js 0.2.0-alpha.3.2 → 0.2.0-alpha.3.4

package/dist/types/index.d.ts

@@ -18,6 +18,10 @@ export default class PowiainaNum implements IPowiainaNum {
     small: boolean;
     sign: -1 | 0 | 1;
     layer: number;
+    /**
+     * Constructor of PowiainaNum class,
+     * If no arguments, return `PowiainaNum.NaN`.
+     */
     constructor(arg1?: PowiainaNumSource);
     /**
      * Addition
@@ -31,6 +35,9 @@ export default class PowiainaNum implements IPowiainaNum {
     static mul(t: PowiainaNumSource, other: PowiainaNumSource): PowiainaNum;
     div(other: PowiainaNumSource): PowiainaNum;
     static div(t: PowiainaNumSource, other: PowiainaNumSource): PowiainaNum;
+    /**
+     * @returns 10 to the power of `this`
+     */
     pow10(): PowiainaNum;
     pow(x: PowiainaNumSource): PowiainaNum;
     pow_base(x: PowiainaNumSource): PowiainaNum;
@@ -50,6 +57,26 @@ export default class PowiainaNum implements IPowiainaNum {
     log(base?: PowiainaNumSource): PowiainaNum;
     static log(t: PowiainaNumSource, base?: PowiainaNumSource): PowiainaNum;
     ln(): PowiainaNum;
+    /**
+     * plog10, beware unexpected errors.
+     */
+    plog10(): PowiainaNum;
+    /**
+     * plog10, beware unexpected errors.
+     */
+    static plog10(t: PowiainaNumSource): PowiainaNum;
+    /**
+     * plog, beware unexpected errors.
+     */
+    plog(base?: PowiainaNumSource): PowiainaNum;
+    /**
+     * plog, beware unexpected errors.
+     */
+    static plog(t: PowiainaNumSource, base?: PowiainaNumSource): PowiainaNum;
+    /**
+     * pln, beware unexpected errors.
+     */
+    pln(): PowiainaNum;
     static exp(x: PowiainaNumSource): PowiainaNum;
     exp(): PowiainaNum;
     mod(x: PowiainaNumSource): PowiainaNum;
@@ -77,10 +104,39 @@ export default class PowiainaNum implements IPowiainaNum {
     lambertw(princ?: boolean): PowiainaNum;
     static lambertw(x: PowiainaNumSource, principal?: boolean): PowiainaNum;
     static tetrate_10(other2: PowiainaNumSource): PowiainaNum;
-    max(x: PowiainaNumSource): PowiainaNum;
-    min(x: PowiainaNumSource): PowiainaNum;
-    maxabs(x: PowiainaNumSource): PowiainaNum;
-    minabs(x: PowiainaNumSource): PowiainaNum;
+    arrow(arrows2: PowiainaNumSource): (other: PowiainaNumSource, depth?: number) => PowiainaNum;
+    chain(other: PowiainaNumSource, arrows: PowiainaNumSource): PowiainaNum;
+    /**
+     * Select the largest number of arguments.
+     */
+    static max(...args: PowiainaNumSource[]): PowiainaNum;
+    /**
+     * Select the smallest number of arguments.
+     */
+    static min(...args: PowiainaNumSource[]): PowiainaNum;
+    /**
+     * Restrict a number be not lower than a number
+     *
+     * It's also an alias of `PowiainaNum.max`.
+     * @returns restricted number
+     */
+    static clampMin(...args: PowiainaNumSource[]): PowiainaNum;
+    /**
+     * Restrict a number be not higher than a number
+     *
+     * It's also an alias of `PowiainaNum.min`.
+     * @returns restricted number
+     */
+    static clampMax(...args: PowiainaNumSource[]): PowiainaNum;
+    max(...args: PowiainaNumSource[]): PowiainaNum;
+    min(...args: PowiainaNumSource[]): PowiainaNum;
+    /**
+     * Compare what PowiainaNum's absolute value is max
+     * @param args
+     * @returns absolute value max number's absolute value
+     */
+    maxabs(...args: PowiainaNumSource[]): PowiainaNum;
+    minabs(...args: PowiainaNumSource[]): PowiainaNum;
     cmpabs(x: PowiainaNumSource): -1 | 0 | 1 | 2;
     neg(): PowiainaNum;
     rec(): PowiainaNum;
@@ -111,6 +167,7 @@ export default class PowiainaNum implements IPowiainaNum {
     lte(other: PowiainaNumSource): boolean;
     gt(other: PowiainaNumSource): boolean;
     gte(other: PowiainaNumSource): boolean;
+    static sign(a: PowiainaNum): -1 | 0 | 1;
     isNaN(): boolean;
     isZero(): boolean;
     isFinite(): boolean;
@@ -125,6 +182,7 @@ export default class PowiainaNum implements IPowiainaNum {
      * @returns normalized number
      */
     normalize(): PowiainaNum;
+    private static arrowMSI;
     /**
      * @returns number will return the index of the operator in array. return as x.5 if it's between the xth and x+1th operators.
      */
@@ -163,22 +221,99 @@ export default class PowiainaNum implements IPowiainaNum {
     static fromString(input: string): PowiainaNum;
     static fromObject(powlikeObject: IPowiainaNum | ExpantaNumArray): PowiainaNum;
     /**
-     * A property arary value for version 0.1.x PowiainaNum.
+     * A property array value for version 0.1.x PowiainaNum.
      */
     get arr01(): [number, ...([number, number, number, number] | ["x", number, number, number] | [number, number, "x", number])[]];
+    /**
+     * Zero
+     */
     static readonly ZERO: PowiainaNum;
+    /**
+     * One
+     */
     static readonly ONE: PowiainaNum;
+    /**
+     * The value of the largest integer n such that n and n + 1 are both
+     * exactly representable as a Number value = 9007199254740991 = 2^53 − 1.
+     */
     static readonly MSI: PowiainaNum;
+    /**
+     * MSI's reciprocate value, = 1/9007199254740991.
+     */
     static readonly MSI_REC: PowiainaNum;
+    /**
+     * 10^(MSI) = 10^9007199254740991.
+     */
     static readonly E_MSI: PowiainaNum;
+    /**
+     * 10^(MSI) 's reciprocate value, = 10^-9007199254740991.
+     */
     static readonly E_MSI_REC: PowiainaNum;
+    /**
+     * Tetrated MSI, = 10↑↑9007199254740991.
+     */
     static readonly TETRATED_MSI: PowiainaNum;
+    /**
+     * Pentated MSI, = 10↑↑↑9007199254740991.
+     */
     static readonly PENTATED_MSI: PowiainaNum;
+    /**
+     * Tritri, = 3↑↑↑3 = power tower with height 7625597484987 base 3.
+     */
     static readonly TRITRI: PowiainaNum;
+    /**
+     * The Graham's Number, = G^64(4)
+     *
+     * = 3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{
+     * 3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3{3↑↑↑↑3
+     * }3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3
+     * }3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3}3
+     */
     static readonly GRAHAMS_NUMBER: PowiainaNum;
+    /**
+     * Positive Infinity.
+     */
     static readonly POSITIVE_INFINITY: PowiainaNum;
+    /**
+     * Negative Infinity.
+     */
     static readonly NEGATIVE_INFINITY: PowiainaNum;
     static readonly NaN: PowiainaNum;
+    /**
+     * The mathematical constant e. This is Euler's number, the base of natural logarithms.
+     */
+    static readonly E: PowiainaNum;
+    /**
+     * The natural logarithm of 2 = ln(2).
+     */
+    static readonly LN2: PowiainaNum;
+    /**
+     * The natural logarithm of 10.
+     */
+    static readonly LN10: PowiainaNum;
+    /**
+     * The base-2 logarithm of e = log_2(e).
+     */
+    static readonly LOG2E: PowiainaNum;
+    /**
+     * The base-10 logarithm of e = log_10(e).
+     */
+    static readonly LOG10E: PowiainaNum;
+    /**
+     * Pi(). This is the ratio of the circumference of a circle to its diameter.
+     */
+    static readonly PI: PowiainaNum;
+    /**
+     * The square root of 0.5, or, equivalently, one divided by the square root of 2.
+     *
+     * = (√2)/2 = √(0.5)
+     */
+    static readonly SQRT1_2: PowiainaNum;
+    /**
+     * The square root of 2 = √2.
+     */
+    static readonly SQRT2: PowiainaNum;
     static readonly maxOps = 100;
+    static arrowFuncMap: Map<string, PowiainaNum>;
 }
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "powiaina_num.js",
-  "version": "0.2.0-alpha.3.2",
+  "version": "0.2.0-alpha.3.4",
   "description": "A JavaScript library that handles arithmetic for numbers as large as {10,9e15,1,1,1,2}.",
   "type": "module",
   "main": "dist/PowiainaNum.cjs.js",