@pezkuwi/util 14.0.13 → 14.0.15

package/build/bi/consts.js

@@ -1,91 +0,0 @@
-import { BigInt } from '@pezkuwi/x-bigint';
-/**
- * @name _0n
- * @summary BigInt constant for 0.
- */
-export const _0n = /*#__PURE__*/ BigInt(0);
-/**
- * @name _1n
- * @summary BigInt constant for 1.
- */
-export const _1n = /*#__PURE__*/ BigInt(1);
-/**
- * @name _2n
- * @summary BigInt constant for 2.
- */
-export const _2n = /*#__PURE__*/ BigInt(2);
-/**
- * @name _3n
- * @summary BigInt constant for 3.
- */
-export const _3n = /*#__PURE__*/ BigInt(3);
-/**
- * @name _4n
- * @summary BigInt constant for 4.
- */
-export const _4n = /*#__PURE__*/ BigInt(4);
-/**
- * @name _5n
- * @summary BigInt constant for 5.
- */
-export const _5n = /*#__PURE__*/ BigInt(5);
-/**
- * @name _6n
- * @summary BigInt constant for 6.
- */
-export const _6n = /*#__PURE__*/ BigInt(6);
-/**
- * @name _7n
- * @summary BigInt constant for 7.
- */
-export const _7n = /*#__PURE__*/ BigInt(7);
-/**
- * @name _8n
- * @summary BigInt constant for 8.
- */
-export const _8n = /*#__PURE__*/ BigInt(8);
-/**
- * @name _9n
- * @summary BigInt constant for 9.
- */
-export const _9n = /*#__PURE__*/ BigInt(9);
-/**
- * @name _10n
- * @summary BigInt constant for 10.
- */
-export const _10n = /*#__PURE__*/ BigInt(10);
-/**
- * @name _100n
- * @summary BigInt constant for 100.
- */
-export const _100n = /*#__PURE__*/ BigInt(100);
-/**
- * @name _1000n
- * @summary BigInt constant for 1000.
- */
-export const _1000n = /*#__PURE__*/ BigInt(1_000);
-/**
- * @name _1Mn
- * @summary BigInt constant for 1,000,000 (million).
- */
-export const _1Mn = /*#__PURE__*/ BigInt(1_000_000);
-/**
-* @name _1Bn
-* @summary BigInt constant for 1,000,000,000 (billion).
-*/
-export const _1Bn = /*#__PURE__*/ BigInt(1_000_000_000);
-/**
-* @name _1Qn
-* @summary BigInt constant for 1,000,000,000,000,000,000 (quitillion).
-*/
-export const _1Qn = _1Bn * _1Bn;
-/**
-* @name _2pow53n
-* @summary BigInt constant for MAX_SAFE_INTEGER
-*/
-export const _2pow53n = /*#__PURE__*/ BigInt(Number.MAX_SAFE_INTEGER);
-/**
- * @name _sqrt2pow53n
- * @summary BigInt constant for Math.sqrt(MAX_SAFE_INTEGER)
- */
-export const _sqrt2pow53n = /*#__PURE__*/ BigInt(94906265);

package/build/bi/helpers.d.ts

@@ -1,2 +0,0 @@
-/** @internal */
-export declare function createCmp<T>(cmp: (a: T, b: T) => boolean): (...items: T[]) => T;

package/build/bi/helpers.js

@@ -1,16 +0,0 @@
-/** @internal */
-export function createCmp(cmp) {
-    return (...items) => {
-        const count = items.length;
-        if (count === 0) {
-            throw new Error('Must provide one or more arguments');
-        }
-        let result = items[0];
-        for (let i = 1; i < count; i++) {
-            if (cmp(items[i], result)) {
-                result = items[i];
-            }
-        }
-        return result;
-    };
-}

package/build/bi/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * @summary Utility methods to convert to and from `bigint` objects
- */
-export { nMax, nMin } from './min.js';
-export { nSqrt } from './sqrt.js';
-export { nToBigInt } from './toBigInt.js';
-export { nToHex } from './toHex.js';
-export { nToU8a } from './toU8a.js';
-export * from './consts.js';

package/build/bi/index.js

@@ -1,9 +0,0 @@
-/**
- * @summary Utility methods to convert to and from `bigint` objects
- */
-export { nMax, nMin } from './min.js';
-export { nSqrt } from './sqrt.js';
-export { nToBigInt } from './toBigInt.js';
-export { nToHex } from './toHex.js';
-export { nToU8a } from './toU8a.js';
-export * from './consts.js';

package/build/bi/min.d.ts

@@ -1,10 +0,0 @@
-/**
- * @name nMax
- * @summary Finds and returns the highest value in an array of bigint.
- */
-export declare const nMax: (...items: bigint[]) => bigint;
-/**
- * @name nMin
- * @summary Finds and returns the lowest value in an array of bigint.
- */
-export declare const nMin: (...items: bigint[]) => bigint;

package/build/bi/min.js

@@ -1,11 +0,0 @@
-import { createCmp } from './helpers.js';
-/**
- * @name nMax
- * @summary Finds and returns the highest value in an array of bigint.
- */
-export const nMax = /*#__PURE__*/ createCmp((a, b) => a > b);
-/**
- * @name nMin
- * @summary Finds and returns the lowest value in an array of bigint.
- */
-export const nMin = /*#__PURE__*/ createCmp((a, b) => a < b);

package/build/bi/sqrt.d.ts

@@ -1,7 +0,0 @@
-import type { BN } from '../bn/index.js';
-import type { ToBigInt, ToBn } from '../types.js';
-/**
- * @name nSqrt
- * @summary Calculates the integer square root of a bigint
- */
-export declare function nSqrt<ExtToBn extends ToBn | ToBigInt>(value: ExtToBn | BN | bigint | string | number | null): bigint;

package/build/bi/sqrt.js

@@ -1,29 +0,0 @@
-import { BigInt } from '@pezkuwi/x-bigint';
-import { _0n, _1n, _2pow53n, _sqrt2pow53n } from './consts.js';
-import { nToBigInt } from './toBigInt.js';
-/**
- * @name nSqrt
- * @summary Calculates the integer square root of a bigint
- */
-export function nSqrt(value) {
-    const n = nToBigInt(value);
-    if (n < _0n) {
-        throw new Error('square root of negative numbers is not supported');
-    }
-    // https://stackoverflow.com/questions/53683995/javascript-big-integer-square-root/
-    // shortcut <= 2^53 - 1 to use the JS utils
-    if (n <= _2pow53n) {
-        // ~~ is more performant that Math.floor
-        return BigInt(~~Math.sqrt(Number(n)));
-    }
-    // Use sqrt(MAX_SAFE_INTEGER) as starting point. since we already know the
-    // output will be larger than this, we expect this to be a safe start
-    let x0 = _sqrt2pow53n;
-    while (true) {
-        const x1 = ((n / x0) + x0) >> _1n;
-        if (x0 === x1 || (x0 === (x1 - _1n))) {
-            return x0;
-        }
-        x0 = x1;
-    }
-}

package/build/bi/toBigInt.d.ts

@@ -1,7 +0,0 @@
-import type { BN } from '../bn/bn.js';
-import type { ToBigInt, ToBn } from '../types.js';
-/**
- * @name nToBigInt
- * @summary Creates a bigInt value from a BN, bigint, string (base 10 or hex) or number input.
- */
-export declare function nToBigInt<ExtToBn extends ToBigInt | ToBn>(value?: ExtToBn | BN | bigint | string | number | null): bigint;

package/build/bi/toBigInt.js

@@ -1,25 +0,0 @@
-import { BigInt } from '@pezkuwi/x-bigint';
-import { hexToBigInt } from '../hex/toBigInt.js';
-import { isBn } from '../is/bn.js';
-import { isHex } from '../is/hex.js';
-import { isToBigInt } from '../is/toBigInt.js';
-import { isToBn } from '../is/toBn.js';
-/**
- * @name nToBigInt
- * @summary Creates a bigInt value from a BN, bigint, string (base 10 or hex) or number input.
- */
-export function nToBigInt(value) {
-    return typeof value === 'bigint'
-        ? value
-        : !value
-            ? BigInt(0)
-            : isHex(value)
-                ? hexToBigInt(value.toString())
-                : isBn(value)
-                    ? BigInt(value.toString())
-                    : isToBigInt(value)
-                        ? value.toBigInt()
-                        : isToBn(value)
-                            ? BigInt(value.toBn().toString())
-                            : BigInt(value);
-}

package/build/bi/toHex.d.ts

@@ -1,7 +0,0 @@
-import type { BN } from '../bn/bn.js';
-import type { HexString, NumberOptions, ToBigInt, ToBn } from '../types.js';
-/**
- * @name nToHex
- * @summary Creates a hex value from a bigint object.
- */
-export declare function nToHex<ExtToBn extends ToBn | ToBigInt>(value?: ExtToBn | BN | bigint | number | null, { bitLength, isLe, isNegative }?: NumberOptions): HexString;

package/build/bi/toHex.js

@@ -1,9 +0,0 @@
-import { u8aToHex } from '../u8a/index.js';
-import { nToU8a } from './toU8a.js';
-/**
- * @name nToHex
- * @summary Creates a hex value from a bigint object.
- */
-export function nToHex(value, { bitLength = -1, isLe = false, isNegative = false } = {}) {
-    return u8aToHex(nToU8a(value || 0, { bitLength, isLe, isNegative }));
-}

package/build/bi/toU8a.d.ts

@@ -1,7 +0,0 @@
-import type { BN } from '../bn/bn.js';
-import type { NumberOptions, ToBigInt, ToBn } from '../types.js';
-/**
- * @name nToU8a
- * @summary Creates a Uint8Array object from a bigint.
- */
-export declare function nToU8a<ExtToBn extends ToBn | ToBigInt>(value?: ExtToBn | BN | bigint | number | null, { bitLength, isLe, isNegative }?: NumberOptions): Uint8Array;

package/build/bi/toU8a.js

@@ -1,49 +0,0 @@
-import { BigInt } from '@pezkuwi/x-bigint';
-import { _0n, _1n } from './consts.js';
-import { nToBigInt } from './toBigInt.js';
-const DIV = BigInt(256);
-const NEG_MASK = BigInt(0xff);
-function toU8a(value, isLe, isNegative) {
-    const arr = [];
-    const withSigned = isNegative && (value < _0n);
-    if (withSigned) {
-        value = (value + _1n) * -_1n;
-    }
-    while (value !== _0n) {
-        const mod = value % DIV;
-        const val = Number(withSigned
-            ? mod ^ NEG_MASK
-            : mod);
-        if (isLe) {
-            arr.push(val);
-        }
-        else {
-            arr.unshift(val);
-        }
-        value = (value - mod) / DIV;
-    }
-    return Uint8Array.from(arr);
-}
-/**
- * @name nToU8a
- * @summary Creates a Uint8Array object from a bigint.
- */
-export function nToU8a(value, { bitLength = -1, isLe = true, isNegative = false } = {}) {
-    const valueBi = nToBigInt(value);
-    if (valueBi === _0n) {
-        return bitLength === -1
-            ? new Uint8Array(1)
-            : new Uint8Array(Math.ceil((bitLength || 0) / 8));
-    }
-    const u8a = toU8a(valueBi, isLe, isNegative);
-    if (bitLength === -1) {
-        return u8a;
-    }
-    const byteLength = Math.ceil((bitLength || 0) / 8);
-    const output = new Uint8Array(byteLength);
-    if (isNegative) {
-        output.fill(0xff);
-    }
-    output.set(u8a, isLe ? 0 : byteLength - u8a.length);
-    return output;
-}

package/build/bn/bn.d.ts

@@ -1,2 +0,0 @@
-import BN from 'bn.js';
-export { BN };

package/build/bn/bn.js

@@ -1,2 +0,0 @@
-import BN from 'bn.js';
-export { BN };

package/build/bn/consts.d.ts

@@ -1,91 +0,0 @@
-import { BN } from './bn.js';
-/**
- * @name BN_ZERO
- * @summary BN constant for 0.
- */
-export declare const BN_ZERO: BN;
-/**
- * @name BN_ONE
- * @summary BN constant for 1.
- */
-export declare const BN_ONE: BN;
-/**
- * @name BN_TWO
- * @summary BN constant for 2.
- */
-export declare const BN_TWO: BN;
-/**
- * @name BN_THREE
- * @summary BN constant for 3.
- */
-export declare const BN_THREE: BN;
-/**
- * @name BN_FOUR
- * @summary BN constant for 4.
- */
-export declare const BN_FOUR: BN;
-/**
- * @name BN_FIVE
- * @summary BN constant for 5.
- */
-export declare const BN_FIVE: BN;
-/**
- * @name BN_SIX
- * @summary BN constant for 6.
- */
-export declare const BN_SIX: BN;
-/**
- * @name BN_SEVEN
- * @summary BN constant for 7.
- */
-export declare const BN_SEVEN: BN;
-/**
- * @name BN_EIGHT
- * @summary BN constant for 8.
- */
-export declare const BN_EIGHT: BN;
-/**
- * @name BN_NINE
- * @summary BN constant for 9.
- */
-export declare const BN_NINE: BN;
-/**
- * @name BN_TEN
- * @summary BN constant for 10.
- */
-export declare const BN_TEN: BN;
-/**
- * @name BN_HUNDRED
- * @summary BN constant for 100.
- */
-export declare const BN_HUNDRED: BN;
-/**
- * @name BN_THOUSAND
- * @summary BN constant for 1,000.
- */
-export declare const BN_THOUSAND: BN;
-/**
- * @name BN_MILLION
- * @summary BN constant for 1,000,000.
- */
-export declare const BN_MILLION: BN;
-/**
- * @name BN_BILLION
- * @summary BN constant for 1,000,000,000.
- */
-export declare const BN_BILLION: BN;
-/**
- * @name BN_QUINTILL
- * @summary BN constant for 1,000,000,000,000,000,000.
- */
-export declare const BN_QUINTILL: BN;
-/**
- * @name BN_MAX_INTEGER
- * @summary BN constant for MAX_SAFE_INTEGER
- */
-export declare const BN_MAX_INTEGER: BN;
-/**
- * @name BN_SQRT_MAX_INTEGER
- * @summary BN constant for Math.sqrt(MAX_SAFE_INTEGER)
- */
-export declare const BN_SQRT_MAX_INTEGER: BN;

package/build/bn/consts.js

@@ -1,91 +0,0 @@
-import { BN } from './bn.js';
-/**
- * @name BN_ZERO
- * @summary BN constant for 0.
- */
-export const BN_ZERO = /*#__PURE__*/ new BN(0);
-/**
- * @name BN_ONE
- * @summary BN constant for 1.
- */
-export const BN_ONE = /*#__PURE__*/ new BN(1);
-/**
- * @name BN_TWO
- * @summary BN constant for 2.
- */
-export const BN_TWO = /*#__PURE__*/ new BN(2);
-/**
- * @name BN_THREE
- * @summary BN constant for 3.
- */
-export const BN_THREE = /*#__PURE__*/ new BN(3);
-/**
- * @name BN_FOUR
- * @summary BN constant for 4.
- */
-export const BN_FOUR = /*#__PURE__*/ new BN(4);
-/**
- * @name BN_FIVE
- * @summary BN constant for 5.
- */
-export const BN_FIVE = /*#__PURE__*/ new BN(5);
-/**
- * @name BN_SIX
- * @summary BN constant for 6.
- */
-export const BN_SIX = /*#__PURE__*/ new BN(6);
-/**
- * @name BN_SEVEN
- * @summary BN constant for 7.
- */
-export const BN_SEVEN = /*#__PURE__*/ new BN(7);
-/**
- * @name BN_EIGHT
- * @summary BN constant for 8.
- */
-export const BN_EIGHT = /*#__PURE__*/ new BN(8);
-/**
- * @name BN_NINE
- * @summary BN constant for 9.
- */
-export const BN_NINE = /*#__PURE__*/ new BN(9);
-/**
- * @name BN_TEN
- * @summary BN constant for 10.
- */
-export const BN_TEN = /*#__PURE__*/ new BN(10);
-/**
- * @name BN_HUNDRED
- * @summary BN constant for 100.
- */
-export const BN_HUNDRED = /*#__PURE__*/ new BN(100);
-/**
- * @name BN_THOUSAND
- * @summary BN constant for 1,000.
- */
-export const BN_THOUSAND = /*#__PURE__*/ new BN(1_000);
-/**
- * @name BN_MILLION
- * @summary BN constant for 1,000,000.
- */
-export const BN_MILLION = /*#__PURE__*/ new BN(1_000_000);
-/**
- * @name BN_BILLION
- * @summary BN constant for 1,000,000,000.
- */
-export const BN_BILLION = /*#__PURE__*/ new BN(1_000_000_000);
-/**
- * @name BN_QUINTILL
- * @summary BN constant for 1,000,000,000,000,000,000.
- */
-export const BN_QUINTILL = BN_BILLION.mul(BN_BILLION);
-/**
- * @name BN_MAX_INTEGER
- * @summary BN constant for MAX_SAFE_INTEGER
- */
-export const BN_MAX_INTEGER = /*#__PURE__*/ new BN(Number.MAX_SAFE_INTEGER);
-/**
- * @name BN_SQRT_MAX_INTEGER
- * @summary BN constant for Math.sqrt(MAX_SAFE_INTEGER)
- */
-export const BN_SQRT_MAX_INTEGER = /*#__PURE__*/ new BN(94906265);

package/build/bn/fromHex.d.ts

@@ -1 +0,0 @@
-export { hexToBn as bnFromHex } from '../hex/toBn.js';

package/build/bn/fromHex.js

@@ -1 +0,0 @@
-export { hexToBn as bnFromHex } from '../hex/toBn.js';

package/build/bn/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * @summary Utility methods to convert to and from `BN` objects
- */
-export { BN } from './bn.js';
-export { bnFromHex } from './fromHex.js';
-export { bnMax, bnMin } from './min.js';
-export { bnSqrt } from './sqrt.js';
-export { bnToBn } from './toBn.js';
-export { bnToHex } from './toHex.js';
-export { bnToU8a } from './toU8a.js';
-export * from './consts.js';

package/build/bn/index.js

@@ -1,11 +0,0 @@
-/**
- * @summary Utility methods to convert to and from `BN` objects
- */
-export { BN } from './bn.js';
-export { bnFromHex } from './fromHex.js';
-export { bnMax, bnMin } from './min.js';
-export { bnSqrt } from './sqrt.js';
-export { bnToBn } from './toBn.js';
-export { bnToHex } from './toHex.js';
-export { bnToU8a } from './toU8a.js';
-export * from './consts.js';

package/build/bn/min.d.ts

@@ -1,29 +0,0 @@
-import type { BN } from './bn.js';
-/**
- * @name bnMax
- * @summary Finds and returns the highest value in an array of BNs.
- * @example
- * <BR>
- *
- * ```javascript
- * import BN from 'bn.js';
- * import { bnMax } from '@pezkuwi/util';
- *
- * bnMax([new BN(1), new BN(3), new BN(2)]).toString(); // => '3'
- * ```
- */
-export declare const bnMax: (...items: BN[]) => BN;
-/**
- * @name bnMin
- * @summary Finds and returns the smallest value in an array of BNs.
- * @example
- * <BR>
- *
- * ```javascript
- * import BN from 'bn.js';
- * import { bnMin } from '@pezkuwi/util';
- *
- * bnMin([new BN(1), new BN(3), new BN(2)]).toString(); // => '1'
- * ```
- */
-export declare const bnMin: (...items: BN[]) => BN;

package/build/bn/min.js

@@ -1,29 +0,0 @@
-import { createCmp } from '../bi/helpers.js';
-/**
- * @name bnMax
- * @summary Finds and returns the highest value in an array of BNs.
- * @example
- * <BR>
- *
- * ```javascript
- * import BN from 'bn.js';
- * import { bnMax } from '@pezkuwi/util';
- *
- * bnMax([new BN(1), new BN(3), new BN(2)]).toString(); // => '3'
- * ```
- */
-export const bnMax = /*#__PURE__*/ createCmp((a, b) => a.gt(b));
-/**
- * @name bnMin
- * @summary Finds and returns the smallest value in an array of BNs.
- * @example
- * <BR>
- *
- * ```javascript
- * import BN from 'bn.js';
- * import { bnMin } from '@pezkuwi/util';
- *
- * bnMin([new BN(1), new BN(3), new BN(2)]).toString(); // => '1'
- * ```
- */
-export const bnMin = /*#__PURE__*/ createCmp((a, b) => a.lt(b));

package/build/bn/sqrt.d.ts

@@ -1,16 +0,0 @@
-import type { ToBn } from '../types.js';
-import { BN } from './bn.js';
-/**
- * @name bnSqrt
- * @summary Calculates the integer square root of a BN
- * @example
- * <BR>
- *
- * ```javascript
- * import BN from 'bn.js';
- * import { bnSqrt } from '@pezkuwi/util';
- *
- * bnSqrt(new BN(16)).toString(); // => '4'
- * ```
- */
-export declare function bnSqrt<ExtToBn extends ToBn>(value: ExtToBn | BN | bigint | string | number | null): BN;

package/build/bn/sqrt.js

@@ -1,38 +0,0 @@
-import { BN } from './bn.js';
-import { BN_MAX_INTEGER, BN_ONE, BN_SQRT_MAX_INTEGER } from './consts.js';
-import { bnToBn } from './toBn.js';
-/**
- * @name bnSqrt
- * @summary Calculates the integer square root of a BN
- * @example
- * <BR>
- *
- * ```javascript
- * import BN from 'bn.js';
- * import { bnSqrt } from '@pezkuwi/util';
- *
- * bnSqrt(new BN(16)).toString(); // => '4'
- * ```
- */
-export function bnSqrt(value) {
-    const n = bnToBn(value);
-    if (n.isNeg()) {
-        throw new Error('square root of negative numbers is not supported');
-    }
-    // https://stackoverflow.com/questions/53683995/javascript-big-integer-square-root/
-    // shortcut <= 2^53 - 1 to use the JS utils
-    if (n.lte(BN_MAX_INTEGER)) {
-        // ~~ More performant version of Math.floor
-        return new BN(~~Math.sqrt(n.toNumber()));
-    }
-    // Use sqrt(MAX_SAFE_INTEGER) as starting point. since we already know the
-    // output will be larger than this, we expect this to be a safe start
-    let x0 = BN_SQRT_MAX_INTEGER.clone();
-    while (true) {
-        const x1 = n.div(x0).iadd(x0).ishrn(1);
-        if (x0.eq(x1) || x0.eq(x1.sub(BN_ONE))) {
-            return x0;
-        }
-        x0 = x1;
-    }
-}

package/build/bn/toBn.d.ts

@@ -1,19 +0,0 @@
-import type { ToBigInt, ToBn } from '../types.js';
-import { BN } from './bn.js';
-/**
- * @name bnToBn
- * @summary Creates a BN value from a BN, bigint, string (base 10 or hex) or number input.
- * @description
- * `null` inputs returns a `0x0` result, BN values returns the value, numbers returns a BN representation.
- * @example
- * <BR>
- *
- * ```javascript
- * import BN from 'bn.js';
- * import { bnToBn } from '@pezkuwi/util';
- *
- * bnToBn(0x1234); // => BN(0x1234)
- * bnToBn(new BN(0x1234)); // => BN(0x1234)
- * ```
- */
-export declare function bnToBn<ExtToBn extends ToBigInt | ToBn>(value?: ExtToBn | BN | bigint | string | number | null): BN;