ox 0.0.1 → 0.1.0

package/_types/Hex.d.ts

@@ -0,0 +1,711 @@
+import * as Bytes from './Bytes.js';
+import * as Errors from './Errors.js';
+import * as internal_bytes from './internal/bytes.js';
+import * as internal from './internal/hex.js';
+/** Root type for a Hex string. */
+export type Hex = `0x${string}`;
+/**
+ * Asserts if the given value is {@link ox#Hex.Hex}.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.assert('abc')
+ * // @error: InvalidHexValueTypeError:
+ * // @error: Value `"abc"` of type `string` is an invalid hex type.
+ * // @error: Hex types must be represented as `"0x\${string}"`.
+ * ```
+ *
+ * @param value - The value to assert.
+ * @param options - Options.
+ */
+export declare function assert(value: unknown, options?: assert.Options): asserts value is Hex;
+export declare namespace assert {
+    var parseError: (error: unknown) => assert.ErrorType;
+}
+export declare namespace assert {
+    type Options = {
+        /** Checks if the {@link ox#Hex.Hex} value contains invalid hexadecimal characters. @default false */
+        strict?: boolean | undefined;
+    };
+    type ErrorType = InvalidHexTypeError | InvalidHexValueError | Errors.GlobalErrorType;
+}
+/**
+ * Concatenates two or more {@link ox#Hex.Hex}.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.concat('0x123', '0x456')
+ * // @log: '0x123456'
+ * ```
+ *
+ * @param values - The {@link ox#Hex.Hex} values to concatenate.
+ * @returns The concatenated {@link ox#Hex.Hex} value.
+ */
+export declare function concat(...values: readonly Hex[]): Hex;
+export declare namespace concat {
+    var parseError: (error: unknown) => concat.ErrorType;
+}
+export declare namespace concat {
+    type ErrorType = Errors.GlobalErrorType;
+}
+/**
+ * Instantiates a {@link ox#Hex.Hex} value from a hex string or {@link ox#Bytes.Bytes} value.
+ *
+ * :::tip
+ *
+ * To instantiate from a **Boolean**, **String**, or **Number**, use one of the following:
+ *
+ * - `Hex.fromBoolean`
+ *
+ * - `Hex.fromString`
+ *
+ * - `Hex.fromNumber`
+ *
+ * :::
+ *
+ * @example
+ * ```ts twoslash
+ * import { Bytes, Hex } from 'ox'
+ *
+ * Hex.from('0x48656c6c6f20576f726c6421')
+ * // @log: '0x48656c6c6f20576f726c6421'
+ *
+ * Hex.from(Bytes.from([72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100, 33]))
+ * // @log: '0x48656c6c6f20576f726c6421'
+ * ```
+ *
+ * @param value - The {@link ox#Bytes.Bytes} value to encode.
+ * @returns The encoded {@link ox#Hex.Hex} value.
+ */
+export declare function from(value: Hex | Bytes.Bytes | readonly number[]): Hex;
+export declare namespace from {
+    var parseError: (error: unknown) => from.ErrorType;
+}
+export declare namespace from {
+    type Options = {
+        /** The size (in bytes) of the output hex value. */
+        size?: number | undefined;
+    };
+    type ErrorType = fromBytes.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Encodes a boolean into a {@link ox#Hex.Hex} value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.fromBoolean(true)
+ * // @log: '0x1'
+ *
+ * Hex.fromBoolean(false)
+ * // @log: '0x0'
+ *
+ * Hex.fromBoolean(true, { size: 32 })
+ * // @log: '0x0000000000000000000000000000000000000000000000000000000000000001'
+ * ```
+ *
+ * @param value - The boolean value to encode.
+ * @param options - Options.
+ * @returns The encoded {@link ox#Hex.Hex} value.
+ */
+export declare function fromBoolean(value: boolean, options?: fromBoolean.Options): Hex;
+export declare namespace fromBoolean {
+    var parseError: (error: unknown) => fromBoolean.ErrorType;
+}
+export declare namespace fromBoolean {
+    type Options = {
+        /** The size (in bytes) of the output hex value. */
+        size?: number | undefined;
+    };
+    type ErrorType = internal.assertSize.ErrorType | padLeft.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Encodes a {@link ox#Bytes.Bytes} value into a {@link ox#Hex.Hex} value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Bytes, Hex } from 'ox'
+ *
+ * Hex.fromBytes(Bytes.from([72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100, 33]))
+ * // @log: '0x48656c6c6f20576f726c6421'
+ * ```
+ *
+ * @param value - The {@link ox#Bytes.Bytes} value to encode.
+ * @param options - Options.
+ * @returns The encoded {@link ox#Hex.Hex} value.
+ */
+export declare function fromBytes(value: Bytes.Bytes, options?: fromBytes.Options): Hex;
+export declare namespace fromBytes {
+    var parseError: (error: unknown) => fromBytes.ErrorType;
+}
+export declare namespace fromBytes {
+    type Options = {
+        /** The size (in bytes) of the output hex value. */
+        size?: number | undefined;
+    };
+    type ErrorType = internal.assertSize.ErrorType | padRight.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Encodes a number or bigint into a {@link ox#Hex.Hex} value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.fromNumber(420)
+ * // @log: '0x1a4'
+ *
+ * Hex.fromNumber(420, { size: 32 })
+ * // @log: '0x00000000000000000000000000000000000000000000000000000000000001a4'
+ * ```
+ *
+ * @param value - The number or bigint value to encode.
+ * @param options - Options.
+ * @returns The encoded {@link ox#Hex.Hex} value.
+ */
+export declare function fromNumber(value: number | bigint, options?: fromNumber.Options): Hex;
+export declare namespace fromNumber {
+    var parseError: (error: unknown) => fromNumber.ErrorType;
+}
+export declare namespace fromNumber {
+    type Options = {
+        /** Whether or not the number of a signed representation. */
+        signed?: boolean | undefined;
+        /** The size (in bytes) of the output hex value. */
+        size: number;
+    } | {
+        signed?: undefined;
+        /** The size (in bytes) of the output hex value. */
+        size?: number | undefined;
+    };
+    type ErrorType = IntegerOutOfRangeError | padLeft.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Encodes a string into a {@link ox#Hex.Hex} value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ * Hex.fromString('Hello World!')
+ * // '0x48656c6c6f20576f726c6421'
+ *
+ * Hex.fromString('Hello World!', { size: 32 })
+ * // '0x48656c6c6f20576f726c64210000000000000000000000000000000000000000'
+ * ```
+ *
+ * @param value - The string value to encode.
+ * @param options - Options.
+ * @returns The encoded {@link ox#Hex.Hex} value.
+ */
+export declare function fromString(value: string, options?: fromString.Options): Hex;
+export declare namespace fromString {
+    var parseError: (error: unknown) => fromString.ErrorType;
+}
+export declare namespace fromString {
+    type Options = {
+        /** The size (in bytes) of the output hex value. */
+        size?: number | undefined;
+    };
+    type ErrorType = fromBytes.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Checks if two {@link ox#Hex.Hex} values are equal.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.isEqual('0xdeadbeef', '0xdeadbeef')
+ * // @log: true
+ *
+ * Hex.isEqual('0xda', '0xba')
+ * // @log: false
+ * ```
+ *
+ * @param hexA - The first {@link ox#Hex.Hex} value.
+ * @param hexB - The second {@link ox#Hex.Hex} value.
+ * @returns `true` if the two {@link ox#Hex.Hex} values are equal, `false` otherwise.
+ */
+export declare function isEqual(hexA: Hex, hexB: Hex): boolean;
+export declare namespace isEqual {
+    var parseError: (error: unknown) => isEqual.ErrorType;
+}
+export declare namespace isEqual {
+    type ErrorType = Bytes.fromHex.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Pads a {@link ox#Hex.Hex} value to the left with zero bytes until it reaches the given `size` (default: 32 bytes).
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.padLeft('0x1234', 4)
+ * // @log: '0x00001234'
+ * ```
+ *
+ * @param value - The {@link ox#Hex.Hex} value to pad.
+ * @param size - The size (in bytes) of the output hex value.
+ * @returns The padded {@link ox#Hex.Hex} value.
+ */
+export declare function padLeft(value: Hex, size?: number | undefined): padLeft.ReturnType;
+export declare namespace padLeft {
+    var parseError: (error: unknown) => padLeft.ErrorType;
+}
+export declare namespace padLeft {
+    type ReturnType = Hex;
+    type ErrorType = internal.pad.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Pads a {@link ox#Hex.Hex} value to the right with zero bytes until it reaches the given `size` (default: 32 bytes).
+ *
+ * @example
+ * ```ts
+ * import { Hex } from 'ox'
+ *
+ * Hex.padRight('0x1234', 4)
+ * // @log: '0x12340000'
+ * ```
+ *
+ * @param value - The {@link ox#Hex.Hex} value to pad.
+ * @param size - The size (in bytes) of the output hex value.
+ * @returns The padded {@link ox#Hex.Hex} value.
+ */
+export declare function padRight(value: Hex, size?: number | undefined): padRight.ReturnType;
+export declare namespace padRight {
+    var parseError: (error: unknown) => padRight.ErrorType;
+}
+export declare namespace padRight {
+    type ReturnType = Hex;
+    type ErrorType = internal.pad.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Generates a random {@link ox#Hex.Hex} value of the specified length.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * const hex = Hex.random(32)
+ * // @log: '0x...'
+ * ```
+ *
+ * @returns Random {@link ox#Hex.Hex} value.
+ */
+export declare function random(length: number): Hex;
+export declare namespace random {
+    var parseError: (error: unknown) => random.ErrorType;
+}
+export declare namespace random {
+    type ErrorType = Errors.GlobalErrorType;
+}
+/**
+ * Returns a section of a {@link ox#Bytes.Bytes} value given a start/end bytes offset.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.slice('0x0123456789', 1, 4)
+ * // @log: '0x234567'
+ * ```
+ *
+ * @param value - The {@link ox#Hex.Hex} value to slice.
+ * @param start - The start offset (in bytes).
+ * @param end - The end offset (in bytes).
+ * @param options - Options.
+ * @returns The sliced {@link ox#Hex.Hex} value.
+ */
+export declare function slice(value: Hex, start?: number | undefined, end?: number | undefined, options?: slice.Options): Hex;
+export declare namespace slice {
+    var parseError: (error: unknown) => slice.ErrorType;
+}
+export declare namespace slice {
+    type Options = {
+        /** Asserts that the sliced value is the same size as the given start/end offsets. */
+        strict?: boolean | undefined;
+    };
+    type ErrorType = internal.assertStartOffset.ErrorType | internal.assertEndOffset.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Retrieves the size of a {@link ox#Hex.Hex} value (in bytes).
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.size('0xdeadbeef')
+ * // @log: 4
+ * ```
+ *
+ * @param value - The {@link ox#Hex.Hex} value to get the size of.
+ * @returns The size of the {@link ox#Hex.Hex} value (in bytes).
+ */
+export declare function size(value: Hex): number;
+export declare namespace size {
+    var parseError: (error: unknown) => size.ErrorType;
+}
+export declare namespace size {
+    type ErrorType = Errors.GlobalErrorType;
+}
+/**
+ * Trims leading zeros from a {@link ox#Hex.Hex} value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.trimLeft('0x00000000deadbeef')
+ * // @log: '0xdeadbeef'
+ * ```
+ *
+ * @param value - The {@link ox#Hex.Hex} value to trim.
+ * @returns The trimmed {@link ox#Hex.Hex} value.
+ */
+export declare function trimLeft(value: Hex): trimLeft.ReturnType;
+export declare namespace trimLeft {
+    var parseError: (error: unknown) => trimLeft.ErrorType;
+}
+export declare namespace trimLeft {
+    type ReturnType = Hex;
+    type ErrorType = internal.trim.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Trims trailing zeros from a {@link ox#Hex.Hex} value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.trimRight('0xdeadbeef00000000')
+ * // @log: '0xdeadbeef'
+ * ```
+ *
+ * @param value - The {@link ox#Hex.Hex} value to trim.
+ * @returns The trimmed {@link ox#Hex.Hex} value.
+ */
+export declare function trimRight(value: Hex): trimRight.ReturnType;
+export declare namespace trimRight {
+    var parseError: (error: unknown) => trimRight.ErrorType;
+}
+export declare namespace trimRight {
+    type ReturnType = Hex;
+    type ErrorType = internal.trim.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Decodes a {@link ox#Hex.Hex} value into a BigInt.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.toBigInt('0x1a4')
+ * // @log: 420n
+ *
+ * Hex.toBigInt('0x00000000000000000000000000000000000000000000000000000000000001a4', { size: 32 })
+ * // @log: 420n
+ * ```
+ *
+ * @param hex - The {@link ox#Hex.Hex} value to decode.
+ * @param options - Options.
+ * @returns The decoded BigInt.
+ */
+export declare function toBigInt(hex: Hex, options?: toBigInt.Options): bigint;
+export declare namespace toBigInt {
+    var parseError: (error: unknown) => toBigInt.ErrorType;
+}
+export declare namespace toBigInt {
+    type Options = {
+        /** Whether or not the number of a signed representation. */
+        signed?: boolean | undefined;
+        /** Size (in bytes) of the hex value. */
+        size?: number | undefined;
+    };
+    type ErrorType = internal.assertSize.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Decodes a {@link ox#Hex.Hex} value into a boolean.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.toBoolean('0x01')
+ * // @log: true
+ *
+ * Hex.toBoolean('0x0000000000000000000000000000000000000000000000000000000000000001', { size: 32 })
+ * // @log: true
+ * ```
+ *
+ * @param hex - The {@link ox#Hex.Hex} value to decode.
+ * @param options - Options.
+ * @returns The decoded boolean.
+ */
+export declare function toBoolean(hex: Hex, options?: toBoolean.Options): boolean;
+export declare namespace toBoolean {
+    var parseError: (error: unknown) => toBoolean.ErrorType;
+}
+export declare namespace toBoolean {
+    type Options = {
+        /** Size (in bytes) of the hex value. */
+        size?: number | undefined;
+    };
+    type ErrorType = internal.assertSize.ErrorType | trimLeft.ErrorType | InvalidHexBooleanError | Errors.GlobalErrorType;
+}
+/**
+ * Decodes a {@link ox#Hex.Hex} value into a {@link ox#Bytes.Bytes}.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * const data = Hex.toBytes('0x48656c6c6f20776f726c6421')
+ * // @log: Uint8Array([72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100, 33])
+ * ```
+ *
+ * @param hex - The {@link ox#Hex.Hex} value to decode.
+ * @param options - Options.
+ * @returns The decoded {@link ox#Bytes.Bytes}.
+ */
+export declare function toBytes(hex: Hex, options?: toBytes.Options): Bytes.Bytes;
+export declare namespace toBytes {
+    var parseError: (error: unknown) => toBytes.ErrorType;
+}
+export declare namespace toBytes {
+    type Options = {
+        /** Size (in bytes) of the hex value. */
+        size?: number | undefined;
+    };
+    type ErrorType = Bytes.fromHex.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Decodes a {@link ox#Hex.Hex} value into a number.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.toNumber('0x1a4')
+ * // @log: 420
+ *
+ * Hex.toNumber('0x00000000000000000000000000000000000000000000000000000000000001a4', { size: 32 })
+ * // @log: 420
+ * ```
+ *
+ * @param hex - The {@link ox#Hex.Hex} value to decode.
+ * @param options - Options.
+ * @returns The decoded number.
+ */
+export declare function toNumber(hex: Hex, options?: toNumber.Options): number;
+export declare namespace toNumber {
+    var parseError: (error: unknown) => toNumber.ErrorType;
+}
+export declare namespace toNumber {
+    type Options = toBigInt.Options;
+    type ErrorType = toBigInt.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Decodes a {@link ox#Hex.Hex} value into a string.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.toString('0x48656c6c6f20576f726c6421')
+ * // @log: 'Hello world!'
+ *
+ * Hex.toString('0x48656c6c6f20576f726c64210000000000000000000000000000000000000000', {
+ *  size: 32,
+ * })
+ * // @log: 'Hello world'
+ * ```
+ *
+ * @param hex - The {@link ox#Hex.Hex} value to decode.
+ * @param options - Options.
+ * @returns The decoded string.
+ */
+export declare function toString(hex: Hex, options?: toString.Options): string;
+export declare namespace toString {
+    var parseError: (error: unknown) => toString.ErrorType;
+}
+export declare namespace toString {
+    type Options = {
+        /** Size (in bytes) of the hex value. */
+        size?: number | undefined;
+    };
+    type ErrorType = internal_bytes.assertSize.ErrorType | Bytes.fromHex.ErrorType | Bytes.trimRight.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Checks if the given value is {@link ox#Hex.Hex}.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Bytes, Hex } from 'ox'
+ *
+ * Hex.validate('0xdeadbeef')
+ * // @log: true
+ *
+ * Hex.validate(Bytes.from([1, 2, 3]))
+ * // @log: false
+ * ```
+ *
+ * @param value - The value to check.
+ * @param options - Options.
+ * @returns `true` if the value is a {@link ox#Hex.Hex}, `false` otherwise.
+ */
+export declare function validate(value: unknown, options?: validate.Options): value is Hex;
+export declare namespace validate {
+    var parseError: (error: unknown) => validate.ErrorType;
+}
+export declare namespace validate {
+    type Options = {
+        /** Checks if the {@link ox#Hex.Hex} value contains invalid hexadecimal characters. @default false */
+        strict?: boolean | undefined;
+    };
+    type ErrorType = Errors.GlobalErrorType;
+}
+/**
+ * Thrown when the provided integer is out of range, and cannot be represented as a hex value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.fromNumber(420182738912731283712937129)
+ * // @error: Hex.IntegerOutOfRangeError: Number \`4.2018273891273126e+26\` is not in safe unsigned integer range (`0` to `9007199254740991`)
+ * ```
+ */
+export declare class IntegerOutOfRangeError extends Errors.BaseError {
+    readonly name = "Hex.IntegerOutOfRangeError";
+    constructor({ max, min, signed, size, value, }: {
+        max?: string | undefined;
+        min: string;
+        signed?: boolean | undefined;
+        size?: number | undefined;
+        value: string;
+    });
+}
+/**
+ * Thrown when the provided hex value cannot be represented as a boolean.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.toBoolean('0xa')
+ * // @error: Hex.InvalidHexBooleanError: Hex value `"0xa"` is not a valid boolean.
+ * // @error: The hex value must be `"0x0"` (false) or `"0x1"` (true).
+ * ```
+ */
+export declare class InvalidHexBooleanError extends Errors.BaseError {
+    readonly name = "Hex.InvalidHexBooleanError";
+    constructor(hex: Hex);
+}
+/**
+ * Thrown when the provided value is not a valid hex type.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.assert(1)
+ * // @error: Hex.InvalidHexTypeError: Value `1` of type `number` is an invalid hex type.
+ * ```
+ */
+export declare class InvalidHexTypeError extends Errors.BaseError {
+    readonly name = "Hex.InvalidHexTypeError";
+    constructor(value: unknown);
+}
+/**
+ * Thrown when the provided hex value is invalid.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.assert('0x0123456789abcdefg')
+ * // @error: Hex.InvalidHexValueError: Value `0x0123456789abcdefg` is an invalid hex value.
+ * // @error: Hex values must start with `"0x"` and contain only hexadecimal characters (0-9, a-f, A-F).
+ * ```
+ */
+export declare class InvalidHexValueError extends Errors.BaseError {
+    readonly name = "Hex.InvalidHexValueError";
+    constructor(value: unknown);
+}
+/**
+ * Thrown when the provided hex value is an odd length.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Bytes } from 'ox'
+ *
+ * Bytes.fromHex('0xabcde')
+ * // @error: Hex.InvalidLengthError: Hex value `"0xabcde"` is an odd length (5 nibbles).
+ * ```
+ */
+export declare class InvalidLengthError extends Errors.BaseError {
+    readonly name = "Hex.InvalidLengthError";
+    constructor(value: Hex);
+}
+/**
+ * Thrown when the size of the value exceeds the expected max size.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.fromString('Hello World!', { size: 8 })
+ * // @error: Hex.SizeOverflowError: Size cannot exceed `8` bytes. Given size: `12` bytes.
+ * ```
+ */
+export declare class SizeOverflowError extends Errors.BaseError {
+    readonly name = "Hex.SizeOverflowError";
+    constructor({ givenSize, maxSize }: {
+        givenSize: number;
+        maxSize: number;
+    });
+}
+/**
+ * Thrown when the slice offset exceeds the bounds of the value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.slice('0x0123456789', 6)
+ * // @error: Hex.SliceOffsetOutOfBoundsError: Slice starting at offset `6` is out-of-bounds (size: `5`).
+ * ```
+ */
+export declare class SliceOffsetOutOfBoundsError extends Errors.BaseError {
+    readonly name = "Hex.SliceOffsetOutOfBoundsError";
+    constructor({ offset, position, size, }: {
+        offset: number;
+        position: 'start' | 'end';
+        size: number;
+    });
+}
+/**
+ * Thrown when the size of the value exceeds the pad size.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hex } from 'ox'
+ *
+ * Hex.padLeft('0x1a4e12a45a21323123aaa87a897a897a898a6567a578a867a98778a667a85a875a87a6a787a65a675a6a9', 32)
+ * // @error: Hex.SizeExceedsPaddingSizeError: Hex size (`43`) exceeds padding size (`32`).
+ * ```
+ */
+export declare class SizeExceedsPaddingSizeError extends Errors.BaseError {
+    readonly name = "Hex.SizeExceedsPaddingSizeError";
+    constructor({ size, targetSize, type, }: {
+        size: number;
+        targetSize: number;
+        type: 'Hex' | 'Bytes';
+    });
+}
+//# sourceMappingURL=Hex.d.ts.map