@pezkuwi/util 14.0.10 → 14.0.11

package/cjs/extractTime.d.ts

@@ -0,0 +1,14 @@
+import type { Time } from './types.js';
+/**
+ * @name extractTime
+ * @summary Convert a quantity of seconds to Time array representing accumulated {days, minutes, hours, seconds, milliseconds}
+ * @example
+ * <BR>
+ *
+ * ```javascript
+ * import { extractTime } from '@pezkuwi/util';
+ *
+ * const { days, minutes, hours, seconds, milliseconds } = extractTime(6000); // 0, 0, 10, 0, 0
+ * ```
+ */
+export declare function extractTime(milliseconds?: number): Time;

package/cjs/extractTime.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTime = extractTime;
+const MIN_MS = 60 * 1000;
+const HR_MS = MIN_MS * 60;
+const DAY_MS = HR_MS * 24;
+const ZERO = { days: 0, hours: 0, milliseconds: 0, minutes: 0, seconds: 0 };
+/** @internal */
+function add(a, b) {
+    return {
+        days: (a.days || 0) + b.days,
+        hours: (a.hours || 0) + b.hours,
+        milliseconds: (a.milliseconds || 0) + b.milliseconds,
+        minutes: (a.minutes || 0) + b.minutes,
+        seconds: (a.seconds || 0) + b.seconds
+    };
+}
+/** @internal */
+function extractSecs(ms) {
+    const s = ms / 1000;
+    if (s < 60) {
+        const seconds = ~~s;
+        return add({ seconds }, extractTime(ms - (seconds * 1000)));
+    }
+    const m = s / 60;
+    if (m < 60) {
+        const minutes = ~~m;
+        return add({ minutes }, extractTime(ms - (minutes * MIN_MS)));
+    }
+    const h = m / 60;
+    if (h < 24) {
+        const hours = ~~h;
+        return add({ hours }, extractTime(ms - (hours * HR_MS)));
+    }
+    const days = ~~(h / 24);
+    return add({ days }, extractTime(ms - (days * DAY_MS)));
+}
+/**
+ * @name extractTime
+ * @summary Convert a quantity of seconds to Time array representing accumulated {days, minutes, hours, seconds, milliseconds}
+ * @example
+ * <BR>
+ *
+ * ```javascript
+ * import { extractTime } from '@pezkuwi/util';
+ *
+ * const { days, minutes, hours, seconds, milliseconds } = extractTime(6000); // 0, 0, 10, 0, 0
+ * ```
+ */
+function extractTime(milliseconds) {
+    return !milliseconds
+        ? ZERO
+        : milliseconds < 1000
+            ? add({ milliseconds }, ZERO)
+            : extractSecs(milliseconds);
+}

package/cjs/float/index.d.ts

@@ -0,0 +1 @@
+export { floatToU8a } from './toU8a.js';

package/cjs/float/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.floatToU8a = void 0;
+var toU8a_js_1 = require("./toU8a.js");
+Object.defineProperty(exports, "floatToU8a", { enumerable: true, get: function () { return toU8a_js_1.floatToU8a; } });

package/cjs/float/toU8a.d.ts

@@ -0,0 +1,11 @@
+interface Options {
+    bitLength?: 32 | 64;
+    isLe?: boolean;
+}
+/**
+ * @name floatToU8a
+ * @description Converts a float into a U8a representation (While we don't use BE in SCALE
+ * we still allow for either representation, although, as elsewhere, isLe is default)
+ */
+export declare function floatToU8a(value?: String | string | number | Number, { bitLength, isLe }?: Options): Uint8Array;
+export {};

package/cjs/float/toU8a.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.floatToU8a = floatToU8a;
+/**
+ * @name floatToU8a
+ * @description Converts a float into a U8a representation (While we don't use BE in SCALE
+ * we still allow for either representation, although, as elsewhere, isLe is default)
+ */
+function floatToU8a(value = 0.0, { bitLength = 32, isLe = true } = {}) {
+    if (bitLength !== 32 && bitLength !== 64) {
+        throw new Error('Invalid bitLength provided, expected 32 or 64');
+    }
+    const result = new Uint8Array(bitLength / 8);
+    const dv = new DataView(result.buffer, result.byteOffset);
+    if (bitLength === 32) {
+        dv.setFloat32(0, Number(value), isLe);
+    }
+    else {
+        dv.setFloat64(0, Number(value), isLe);
+    }
+    return result;
+}

package/cjs/format/formatBalance.d.ts

@@ -0,0 +1,54 @@
+import type { BN } from '../bn/bn.js';
+import type { SiDef, ToBn } from '../types.js';
+interface Defaults {
+    decimals: number;
+    unit: string;
+}
+interface SetDefaults {
+    decimals?: number[] | number;
+    unit?: string[] | string;
+}
+interface Options {
+    /**
+     * @description The number of decimals
+     */
+    decimals?: number;
+    /**
+     * @description Format the number with this specific unit
+     */
+    forceUnit?: string;
+    /**
+     * @description Returns value using all available decimals
+     */
+    withAll?: boolean;
+    /**
+     * @description Format with SI, i.e. m/M/etc. (default = true)
+     */
+    withSi?: boolean;
+    /**
+     * @description Format with full SI, i.e. mili/Mega/etc.
+     */
+    withSiFull?: boolean;
+    /**
+     * @description Add the unit (useful in Balance formats)
+     */
+    withUnit?: boolean | string;
+    /**
+     * @description Returns all trailing zeros, otherwise removes (default = true)
+     */
+    withZero?: boolean;
+    /**
+     * @description The locale to use
+     */
+    locale?: string;
+}
+interface BalanceFormatter {
+    <ExtToBn extends ToBn>(input?: number | string | BN | bigint | ExtToBn, options?: Options): string;
+    calcSi(text: string, decimals?: number): SiDef;
+    findSi(type: string): SiDef;
+    getDefaults(): Defaults;
+    getOptions(decimals?: number): SiDef[];
+    setDefaults(defaults: SetDefaults): void;
+}
+export declare const formatBalance: BalanceFormatter;
+export {};

package/cjs/format/formatBalance.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatBalance = void 0;
+const toBn_js_1 = require("../bn/toBn.js");
+const boolean_js_1 = require("../is/boolean.js");
+const formatDecimal_js_1 = require("./formatDecimal.js");
+const getSeparator_js_1 = require("./getSeparator.js");
+const si_js_1 = require("./si.js");
+const DEFAULT_DECIMALS = 0;
+const DEFAULT_UNIT = si_js_1.SI[si_js_1.SI_MID].text;
+let defaultDecimals = DEFAULT_DECIMALS;
+let defaultUnit = DEFAULT_UNIT;
+function _formatBalance(input, { decimals = defaultDecimals, forceUnit, locale = 'en', withAll = false, withSi = true, withSiFull = false, withUnit = true, withZero = true } = {}) {
+    // we only work with string inputs here - convert anything
+    // into the string-only value
+    let text = (0, toBn_js_1.bnToBn)(input).toString();
+    if (text.length === 0 || text === '0') {
+        return '0';
+    }
+    // strip the negative sign so we can work with clean groupings, re-add this in the
+    // end when we return the result (from here on we work with positive numbers)
+    let sign = '';
+    if (text[0].startsWith('-')) {
+        sign = '-';
+        text = text.substring(1);
+    }
+    // We start at midpoint (8) minus 1 - this means that values display as
+    // 123.4567 instead of 0.1234 k (so we always have the most relevant).
+    const si = (0, si_js_1.calcSi)(text, decimals, forceUnit);
+    const mid = text.length - (decimals + si.power);
+    const pre = mid <= 0 ? '0' : text.substring(0, mid);
+    // get the post from the midpoint onward and then first add max decimals
+    // before trimming to the correct (calculated) amount of decimals again
+    let post = text
+        .padStart(mid < 0 ? decimals : 1, '0')
+        .substring(mid < 0 ? 0 : mid)
+        .padEnd(withAll ? Math.max(decimals, 4) : 4, '0')
+        .substring(0, withAll ? Math.max(4, decimals + si.power) : 4);
+    // remove all trailing 0's (if required via flag)
+    if (!withZero) {
+        let end = post.length - 1;
+        // This looks inefficient, however it is better to do the checks and
+        // only make one final slice than it is to do it in multiples
+        do {
+            if (post[end] === '0') {
+                end--;
+            }
+        } while (post[end] === '0');
+        post = post.substring(0, end + 1);
+    }
+    // the display unit
+    const unit = (0, boolean_js_1.isBoolean)(withUnit)
+        ? si_js_1.SI[si_js_1.SI_MID].text
+        : withUnit;
+    // format the units for display based on the flags
+    const units = withSi || withSiFull
+        ? si.value === '-'
+            ? withUnit
+                ? ` ${unit}`
+                : ''
+            : ` ${withSiFull ? `${si.text}${withUnit ? ' ' : ''}` : si.value}${withUnit ? unit : ''}`
+        : '';
+    const { decimal, thousand } = (0, getSeparator_js_1.getSeparator)(locale);
+    return `${sign}${(0, formatDecimal_js_1.formatDecimal)(pre, thousand)}${post && `${decimal}${post}`}${units}`;
+}
+exports.formatBalance = _formatBalance;
+exports.formatBalance.calcSi = (text, decimals = defaultDecimals) => (0, si_js_1.calcSi)(text, decimals);
+exports.formatBalance.findSi = si_js_1.findSi;
+exports.formatBalance.getDefaults = () => {
+    return {
+        decimals: defaultDecimals,
+        unit: defaultUnit
+    };
+};
+exports.formatBalance.getOptions = (decimals = defaultDecimals) => {
+    return si_js_1.SI.filter(({ power }) => power < 0
+        ? (decimals + power) >= 0
+        : true);
+};
+exports.formatBalance.setDefaults = ({ decimals, unit }) => {
+    defaultDecimals = (Array.isArray(decimals)
+        ? decimals[0]
+        : decimals) ?? defaultDecimals;
+    defaultUnit = (Array.isArray(unit)
+        ? unit[0]
+        : unit) ?? defaultUnit;
+    si_js_1.SI[si_js_1.SI_MID].text = defaultUnit;
+};

package/cjs/format/formatDate.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @name formatDate
+ * @description Formats a date in CCYY-MM-DD HH:MM:SS format
+ */
+export declare function formatDate(date: Date): string;

package/cjs/format/formatDate.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDate = formatDate;
+/** @internal */
+function zeroPad(value) {
+    return value.toString().padStart(2, '0');
+}
+/**
+ * @name formatDate
+ * @description Formats a date in CCYY-MM-DD HH:MM:SS format
+ */
+function formatDate(date) {
+    const year = date.getFullYear().toString();
+    const month = zeroPad((date.getMonth() + 1));
+    const day = zeroPad(date.getDate());
+    const hour = zeroPad(date.getHours());
+    const minute = zeroPad(date.getMinutes());
+    const second = zeroPad(date.getSeconds());
+    return `${year}-${month}-${day} ${hour}:${minute}:${second}`;
+}

package/cjs/format/formatDecimal.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @name formatDecimal
+ * @description Formats a number into string format with thousand separators
+ */
+export declare function formatDecimal(value: string, separator?: string): string;

package/cjs/format/formatDecimal.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDecimal = formatDecimal;
+const NUMBER_REGEX = new RegExp('(\\d+?)(?=(\\d{3})+(?!\\d)|$)', 'g');
+/**
+ * @name formatDecimal
+ * @description Formats a number into string format with thousand separators
+ */
+function formatDecimal(value, separator = ',') {
+    // We can do this by adjusting the regx, however for the sake of clarity
+    // we rather strip and re-add the negative sign in the output
+    const isNegative = value[0].startsWith('-');
+    const matched = isNegative
+        ? value.substring(1).match(NUMBER_REGEX)
+        : value.match(NUMBER_REGEX);
+    return matched
+        ? `${isNegative ? '-' : ''}${matched.join(separator)}`
+        : value;
+}

package/cjs/format/formatElapsed.d.ts

@@ -0,0 +1,7 @@
+import type { BN } from '../bn/bn.js';
+import type { ToBn } from '../types.js';
+/**
+ * @name formatElapsed
+ * @description Formats an elapsed value into s, m, h or day segments
+ */
+export declare function formatElapsed<ExtToBn extends ToBn>(now?: Date | null, value?: bigint | BN | ExtToBn | Date | number | null): string;

package/cjs/format/formatElapsed.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatElapsed = formatElapsed;
+const toBn_js_1 = require("../bn/toBn.js");
+/** @internal */
+function formatValue(elapsed) {
+    if (elapsed < 15) {
+        return `${elapsed.toFixed(1)}s`;
+    }
+    else if (elapsed < 60) {
+        return `${elapsed | 0}s`;
+    }
+    else if (elapsed < 3600) {
+        return `${elapsed / 60 | 0}m`;
+    }
+    return `${elapsed / 3600 | 0}h`;
+}
+/**
+ * @name formatElapsed
+ * @description Formats an elapsed value into s, m, h or day segments
+ */
+function formatElapsed(now, value) {
+    const tsNow = now?.getTime() || 0;
+    const tsValue = value instanceof Date
+        ? value.getTime()
+        : (0, toBn_js_1.bnToBn)(value).toNumber();
+    return (tsNow && tsValue)
+        ? formatValue(Math.max(Math.abs(tsNow - tsValue), 0) / 1000)
+        : '0.0s';
+}

package/cjs/format/formatNumber.d.ts

@@ -0,0 +1,14 @@
+import type { BN } from '../bn/bn.js';
+import type { ToBn } from '../types.js';
+interface Options {
+    /**
+     * @description The locale to use
+     */
+    locale?: string;
+}
+/**
+ * @name formatNumber
+ * @description Formats a number into string format with thousand separators
+ */
+export declare function formatNumber<ExtToBn extends ToBn>(value?: ExtToBn | BN | bigint | number | null, { locale }?: Options): string;
+export {};

package/cjs/format/formatNumber.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatNumber = formatNumber;
+const toBn_js_1 = require("../bn/toBn.js");
+const formatDecimal_js_1 = require("./formatDecimal.js");
+const getSeparator_js_1 = require("./getSeparator.js");
+/**
+ * @name formatNumber
+ * @description Formats a number into string format with thousand separators
+ */
+function formatNumber(value, { locale = 'en' } = {}) {
+    const { thousand } = (0, getSeparator_js_1.getSeparator)(locale);
+    return (0, formatDecimal_js_1.formatDecimal)((0, toBn_js_1.bnToBn)(value).toString(), thousand);
+}

package/cjs/format/getSeparator.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Get the decimal and thousand separator of a locale
+ * @param locale
+ * @returns {decimal: string, thousand: string}
+ */
+export declare function getSeparator(locale?: string): {
+    thousand: string;
+    decimal: string;
+};

package/cjs/format/getSeparator.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSeparator = getSeparator;
+/**
+ * Get the decimal and thousand separator of a locale
+ * @param locale
+ * @returns {decimal: string, thousand: string}
+ */
+function getSeparator(locale) {
+    return {
+        decimal: (0.1).toLocaleString(locale, { useGrouping: false }).charAt(1),
+        thousand: (1000).toLocaleString(locale, { useGrouping: true }).replace(/\d/g, '').charAt(0)
+    };
+}

package/cjs/format/index.d.ts

@@ -0,0 +1,6 @@
+export { formatBalance } from './formatBalance.js';
+export { formatDate } from './formatDate.js';
+export { formatDecimal } from './formatDecimal.js';
+export { formatElapsed } from './formatElapsed.js';
+export { formatNumber } from './formatNumber.js';
+export { calcSi, findSi } from './si.js';

package/cjs/format/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findSi = exports.calcSi = exports.formatNumber = exports.formatElapsed = exports.formatDecimal = exports.formatDate = exports.formatBalance = void 0;
+var formatBalance_js_1 = require("./formatBalance.js");
+Object.defineProperty(exports, "formatBalance", { enumerable: true, get: function () { return formatBalance_js_1.formatBalance; } });
+var formatDate_js_1 = require("./formatDate.js");
+Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return formatDate_js_1.formatDate; } });
+var formatDecimal_js_1 = require("./formatDecimal.js");
+Object.defineProperty(exports, "formatDecimal", { enumerable: true, get: function () { return formatDecimal_js_1.formatDecimal; } });
+var formatElapsed_js_1 = require("./formatElapsed.js");
+Object.defineProperty(exports, "formatElapsed", { enumerable: true, get: function () { return formatElapsed_js_1.formatElapsed; } });
+var formatNumber_js_1 = require("./formatNumber.js");
+Object.defineProperty(exports, "formatNumber", { enumerable: true, get: function () { return formatNumber_js_1.formatNumber; } });
+var si_js_1 = require("./si.js");
+Object.defineProperty(exports, "calcSi", { enumerable: true, get: function () { return si_js_1.calcSi; } });
+Object.defineProperty(exports, "findSi", { enumerable: true, get: function () { return si_js_1.findSi; } });

package/cjs/format/si.d.ts

@@ -0,0 +1,9 @@
+import type { SiDef } from '../types.js';
+/** @internal */
+export declare const SI_MID = 8;
+/** @internal */
+export declare const SI: SiDef[];
+/** @internal */
+export declare function findSi(type: string): SiDef;
+/** @internal */
+export declare function calcSi(text: string, decimals: number, forceUnit?: string): SiDef;

package/cjs/format/si.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SI = exports.SI_MID = void 0;
+exports.findSi = findSi;
+exports.calcSi = calcSi;
+/** @internal */
+exports.SI_MID = 8;
+/** @internal */
+exports.SI = [
+    { power: -24, text: 'yocto', value: 'y' },
+    { power: -21, text: 'zepto', value: 'z' },
+    { power: -18, text: 'atto', value: 'a' },
+    { power: -15, text: 'femto', value: 'f' },
+    { power: -12, text: 'pico', value: 'p' },
+    { power: -9, text: 'nano', value: 'n' },
+    { power: -6, text: 'micro', value: 'µ' },
+    { power: -3, text: 'milli', value: 'm' },
+    { power: 0, text: 'Unit', value: '-' }, // position 8
+    { power: 3, text: 'Kilo', value: 'k' },
+    { power: 6, text: 'Mill', value: 'M' }, // Mega, M
+    { power: 9, text: 'Bill', value: 'B' }, // Giga, G
+    { power: 12, text: 'Tril', value: 'T' }, // Tera, T
+    { power: 15, text: 'Peta', value: 'P' },
+    { power: 18, text: 'Exa', value: 'E' },
+    { power: 21, text: 'Zeta', value: 'Z' },
+    { power: 24, text: 'Yotta', value: 'Y' }
+];
+/** @internal */
+function findSi(type) {
+    // use a loop here, better RN support (which doesn't have [].find)
+    for (let i = 0, count = exports.SI.length; i < count; i++) {
+        if (exports.SI[i].value === type) {
+            return exports.SI[i];
+        }
+    }
+    return exports.SI[exports.SI_MID];
+}
+/** @internal */
+function calcSi(text, decimals, forceUnit) {
+    if (forceUnit) {
+        return findSi(forceUnit);
+    }
+    const siDefIndex = (exports.SI_MID - 1) + Math.ceil((text.length - decimals) / 3);
+    return exports.SI[siDefIndex] || exports.SI[siDefIndex < 0 ? 0 : exports.SI.length - 1];
+}

package/cjs/has.d.ts

@@ -0,0 +1,14 @@
+/** true if the environment has proper BigInt support */
+export declare const hasBigInt: boolean;
+/** true if the environment is CJS */
+export declare const hasCjs: boolean;
+/** true if the environment has __dirname available */
+export declare const hasDirname: boolean;
+/** true if the environment is ESM */
+export declare const hasEsm: boolean;
+/** true if the environment has WebAssembly available */
+export declare const hasWasm: boolean;
+/** true if the environment has support for Buffer (typically Node.js) */
+export declare const hasBuffer: boolean;
+/** true if the environment has process available (typically Node.js) */
+export declare const hasProcess: boolean;

package/cjs/has.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasProcess = exports.hasBuffer = exports.hasWasm = exports.hasEsm = exports.hasDirname = exports.hasCjs = exports.hasBigInt = void 0;
+const x_bigint_1 = require("@pezkuwi/x-bigint");
+const x_global_1 = require("@pezkuwi/x-global");
+/** true if the environment has proper BigInt support */
+exports.hasBigInt = typeof x_bigint_1.BigInt === 'function' && typeof x_bigint_1.BigInt.asIntN === 'function';
+/** true if the environment is CJS */
+exports.hasCjs = typeof require === 'function' && typeof module !== 'undefined';
+/** true if the environment has __dirname available */
+exports.hasDirname = typeof __dirname !== 'undefined';
+/** true if the environment is ESM */
+exports.hasEsm = !exports.hasCjs;
+/** true if the environment has WebAssembly available */
+exports.hasWasm = typeof WebAssembly !== 'undefined';
+/** true if the environment has support for Buffer (typically Node.js) */
+exports.hasBuffer = typeof x_global_1.xglobal.Buffer === 'function' && typeof x_global_1.xglobal.Buffer.isBuffer === 'function';
+/** true if the environment has process available (typically Node.js) */
+exports.hasProcess = typeof x_global_1.xglobal.process === 'object';

package/cjs/hex/addPrefix.d.ts

@@ -0,0 +1,16 @@
+import type { HexString } from '../types.js';
+/**
+ * @name hexAddPrefix
+ * @summary Adds the `0x` prefix to string values.
+ * @description
+ * Returns a `0x` prefixed string from the input value. If the input is already prefixed, it is returned unchanged.
+ * @example
+ * <BR>
+ *
+ * ```javascript
+ * import { hexAddPrefix } from '@pezkuwi/util';
+ *
+ * console.log('With prefix', hexAddPrefix('0a0b12')); // => 0x0a0b12
+ * ```
+ */
+export declare function hexAddPrefix(value?: string | null): HexString;

package/cjs/hex/addPrefix.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hexAddPrefix = hexAddPrefix;
+const hasPrefix_js_1 = require("./hasPrefix.js");
+/**
+ * @name hexAddPrefix
+ * @summary Adds the `0x` prefix to string values.
+ * @description
+ * Returns a `0x` prefixed string from the input value. If the input is already prefixed, it is returned unchanged.
+ * @example
+ * <BR>
+ *
+ * ```javascript
+ * import { hexAddPrefix } from '@pezkuwi/util';
+ *
+ * console.log('With prefix', hexAddPrefix('0a0b12')); // => 0x0a0b12
+ * ```
+ */
+function hexAddPrefix(value) {
+    return value && (0, hasPrefix_js_1.hexHasPrefix)(value)
+        ? value
+        : `0x${value && value.length % 2 === 1 ? '0' : ''}${value || ''}`;
+}

package/cjs/hex/fixLength.d.ts

@@ -0,0 +1,18 @@
+import type { HexString } from '../types.js';
+/**
+ * @name hexFixLength
+ * @summary Shifts a hex string to a specific bitLength
+ * @description
+ * Returns a `0x` prefixed string with the specified number of bits contained in the return value. (If bitLength is -1, length checking is not done). Values with more bits are trimmed to the specified length. Input values with less bits are returned as-is by default. When `withPadding` is set, shorter values are padded with `0`.
+ * @example
+ * <BR>
+ *
+ * ```javascript
+ * import { hexFixLength } from '@pezkuwi/util';
+ *
+ * console.log('fixed', hexFixLength('0x12', 16)); // => 0x12
+ * console.log('fixed', hexFixLength('0x12', 16, true)); // => 0x0012
+ * console.log('fixed', hexFixLength('0x0012', 8)); // => 0x12
+ * ```
+ */
+export declare function hexFixLength(value: string, bitLength?: number, withPadding?: boolean): HexString;

package/cjs/hex/fixLength.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hexFixLength = hexFixLength;
+const addPrefix_js_1 = require("./addPrefix.js");
+const stripPrefix_js_1 = require("./stripPrefix.js");
+/**
+ * @name hexFixLength
+ * @summary Shifts a hex string to a specific bitLength
+ * @description
+ * Returns a `0x` prefixed string with the specified number of bits contained in the return value. (If bitLength is -1, length checking is not done). Values with more bits are trimmed to the specified length. Input values with less bits are returned as-is by default. When `withPadding` is set, shorter values are padded with `0`.
+ * @example
+ * <BR>
+ *
+ * ```javascript
+ * import { hexFixLength } from '@pezkuwi/util';
+ *
+ * console.log('fixed', hexFixLength('0x12', 16)); // => 0x12
+ * console.log('fixed', hexFixLength('0x12', 16, true)); // => 0x0012
+ * console.log('fixed', hexFixLength('0x0012', 8)); // => 0x12
+ * ```
+ */
+function hexFixLength(value, bitLength = -1, withPadding = false) {
+    const strLength = Math.ceil(bitLength / 4);
+    const hexLength = strLength + 2;
+    return (0, addPrefix_js_1.hexAddPrefix)((bitLength === -1 || value.length === hexLength || (!withPadding && value.length < hexLength))
+        ? (0, stripPrefix_js_1.hexStripPrefix)(value)
+        : (value.length > hexLength)
+            ? (0, stripPrefix_js_1.hexStripPrefix)(value).slice(-1 * strLength)
+            : `${'0'.repeat(strLength)}${(0, stripPrefix_js_1.hexStripPrefix)(value)}`.slice(-1 * strLength));
+}

package/cjs/hex/hasPrefix.d.ts

@@ -0,0 +1,16 @@
+import type { HexString } from '../types.js';
+/**
+ * @name hexHasPrefix
+ * @summary Tests for the existence of a `0x` prefix.
+ * @description
+ * Checks for a valid hex input value and if the start matched `0x`
+ * @example
+ * <BR>
+ *
+ * ```javascript
+ * import { hexHasPrefix } from '@pezkuwi/util';
+ *
+ * console.log('has prefix', hexHasPrefix('0x1234')); // => true
+ * ```
+ */
+export declare function hexHasPrefix(value?: string | null): value is HexString;