@noble/post-quantum 0.6.0 → 0.6.1

package/src/utils.ts

@@ -12,6 +12,111 @@ import {
   isLE,
   randomBytes as randb,
 } from '@noble/hashes/utils.js';
+/**
+ * Bytes API type helpers for old + new TypeScript.
+ *
+ * TS 5.6 has `Uint8Array`, while TS 5.9+ made it generic `Uint8Array<ArrayBuffer>`.
+ * We can't use specific return type, because TS 5.6 will error.
+ * We can't use generic return type, because most TS 5.9 software will expect specific type.
+ *
+ * Maps typed-array input leaves to broad forms.
+ * These are compatibility adapters, not ownership guarantees.
+ *
+ * - `TArg` keeps byte inputs broad.
+ * - `TRet` marks byte outputs for TS 5.6 and TS 5.9+ compatibility.
+ */
+export type TypedArg<T> = T extends BigInt64Array
+  ? BigInt64Array
+  : T extends BigUint64Array
+    ? BigUint64Array
+    : T extends Float32Array
+      ? Float32Array
+      : T extends Float64Array
+        ? Float64Array
+        : T extends Int16Array
+          ? Int16Array
+          : T extends Int32Array
+            ? Int32Array
+            : T extends Int8Array
+              ? Int8Array
+              : T extends Uint16Array
+                ? Uint16Array
+                : T extends Uint32Array
+                  ? Uint32Array
+                  : T extends Uint8ClampedArray
+                    ? Uint8ClampedArray
+                    : T extends Uint8Array
+                      ? Uint8Array
+                      : never;
+/** Maps typed-array output leaves to narrow TS-compatible forms. */
+export type TypedRet<T> = T extends BigInt64Array
+  ? ReturnType<typeof BigInt64Array.of>
+  : T extends BigUint64Array
+    ? ReturnType<typeof BigUint64Array.of>
+    : T extends Float32Array
+      ? ReturnType<typeof Float32Array.of>
+      : T extends Float64Array
+        ? ReturnType<typeof Float64Array.of>
+        : T extends Int16Array
+          ? ReturnType<typeof Int16Array.of>
+          : T extends Int32Array
+            ? ReturnType<typeof Int32Array.of>
+            : T extends Int8Array
+              ? ReturnType<typeof Int8Array.of>
+              : T extends Uint16Array
+                ? ReturnType<typeof Uint16Array.of>
+                : T extends Uint32Array
+                  ? ReturnType<typeof Uint32Array.of>
+                  : T extends Uint8ClampedArray
+                    ? ReturnType<typeof Uint8ClampedArray.of>
+                    : T extends Uint8Array
+                      ? ReturnType<typeof Uint8Array.of>
+                      : never;
+/** Recursively adapts byte-carrying API input types. See {@link TypedArg}. */
+export type TArg<T> =
+  | T
+  | ([TypedArg<T>] extends [never]
+      ? T extends (...args: infer A) => infer R
+        ? ((...args: { [K in keyof A]: TRet<A[K]> }) => TArg<R>) & {
+            [K in keyof T]: T[K] extends (...args: any) => any ? T[K] : TArg<T[K]>;
+          }
+        : T extends [infer A, ...infer R]
+          ? [TArg<A>, ...{ [K in keyof R]: TArg<R[K]> }]
+          : T extends readonly [infer A, ...infer R]
+            ? readonly [TArg<A>, ...{ [K in keyof R]: TArg<R[K]> }]
+            : T extends (infer A)[]
+              ? TArg<A>[]
+              : T extends readonly (infer A)[]
+                ? readonly TArg<A>[]
+                : T extends Promise<infer A>
+                  ? Promise<TArg<A>>
+                  : T extends object
+                    ? { [K in keyof T]: TArg<T[K]> }
+                    : T
+      : TypedArg<T>);
+/** Recursively adapts byte-carrying API output types. See {@link TypedArg}. */
+export type TRet<T> = T extends unknown
+  ? T &
+      ([TypedRet<T>] extends [never]
+        ? T extends (...args: infer A) => infer R
+          ? ((...args: { [K in keyof A]: TArg<A[K]> }) => TRet<R>) & {
+              [K in keyof T]: T[K] extends (...args: any) => any ? T[K] : TRet<T[K]>;
+            }
+          : T extends [infer A, ...infer R]
+            ? [TRet<A>, ...{ [K in keyof R]: TRet<R[K]> }]
+            : T extends readonly [infer A, ...infer R]
+              ? readonly [TRet<A>, ...{ [K in keyof R]: TRet<R[K]> }]
+              : T extends (infer A)[]
+                ? TRet<A>[]
+                : T extends readonly (infer A)[]
+                  ? readonly TRet<A>[]
+                  : T extends Promise<infer A>
+                    ? Promise<TRet<A>>
+                    : T extends object
+                      ? { [K in keyof T]: TRet<T[K]> }
+                      : T
+        : TypedRet<T>)
+  : never;
 /**
  * Asserts that a value is a byte array and optionally checks its length.
  * Returns the original reference unchanged on success, and currently also accepts Node `Buffer`
@@ -43,6 +148,8 @@ export { concatBytesDoc as concatBytes };
  * Requires `globalThis.crypto.getRandomValues` and throws if that API is unavailable.
  * `bytesLength` is validated by the upstream helper as a non-negative integer before allocation,
  * so negative and fractional values both throw instead of truncating through JS `ToIndex`.
+ * @param bytesLength - Number of random bytes to generate.
+ * @returns Fresh random bytes.
  * @example
  * Generate a fresh random seed.
  * ```ts
@@ -63,7 +170,7 @@ export const randomBytes: typeof randb = randb;
  * equalBytes(new Uint8Array([1]), new Uint8Array([1]));
  * ```
  */
-export function equalBytes(a: Uint8Array, b: Uint8Array): boolean {
+export function equalBytes(a: TArg<Uint8Array>, b: TArg<Uint8Array>): boolean {
   if (a.length !== b.length) return false;
   let diff = 0;
   for (let i = 0; i < a.length; i++) diff |= a[i] ^ b[i];
@@ -72,8 +179,7 @@ export function equalBytes(a: Uint8Array, b: Uint8Array): boolean {
 
 /**
  * Copies bytes into a fresh `Uint8Array`.
- * Returns a detached plain `Uint8Array`, and currently accepts broader array-like / iterable
- * inputs because it delegates directly to `Uint8Array.from(...)`.
+ * Returns a detached plain `Uint8Array` after validating that the input is real bytes.
  * @param bytes - Source bytes.
  * @returns Copy of the input bytes.
  * @example
@@ -82,8 +188,10 @@ export function equalBytes(a: Uint8Array, b: Uint8Array): boolean {
  * copyBytes(new Uint8Array([1, 2]));
  * ```
  */
-export function copyBytes(bytes: Uint8Array): Uint8Array {
-  return Uint8Array.from(bytes);
+export function copyBytes(bytes: TArg<Uint8Array>): TRet<Uint8Array> {
+  // `Uint8Array.from(...)` would also accept arrays / other typed arrays. Keep this helper strict
+  // because callers use it at byte-validation boundaries before mutating the detached copy.
+  return Uint8Array.from(abytes(bytes)) as TRet<Uint8Array>;
 }
 
 /**
@@ -92,6 +200,11 @@ export function copyBytes(bytes: Uint8Array): Uint8Array {
  * this boundary helper before aliasing them as host `Float64Array` lanes.
  * @param arr - Byte buffer whose length is a multiple of 8.
  * @returns The same buffer after in-place 64-bit lane byte swaps.
+ * @example
+ * Byte-swap one 64-bit lane in place.
+ * ```ts
+ * byteSwap64(new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]));
+ * ```
  */
 export function byteSwap64<T extends ArrayBufferView>(arr: T): T {
   const bytes = new Uint8Array(arr.buffer, arr.byteOffset, arr.byteLength);
@@ -111,6 +224,18 @@ export function byteSwap64<T extends ArrayBufferView>(arr: T): T {
   }
   return arr;
 }
+/**
+ * Byte-swaps 64-bit lanes on big-endian runtimes and returns the input unchanged on little-endian.
+ * This keeps Falcon's binary64 tables in canonical little-endian order before aliasing them as
+ * `Float64Array` lanes on the current host.
+ * @param arr - Buffer to pass through or swap in place.
+ * @returns The same buffer, normalized for Falcon's little-endian table layout.
+ * @example
+ * Normalize one host-endian buffer for Falcon's float tables.
+ * ```ts
+ * baswap64If(new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]));
+ * ```
+ */
 export const baswap64If: <T extends ArrayBufferView>(arr: T) => T = isLE
   ? (arr) => arr
   : byteSwap64;
@@ -126,13 +251,16 @@ export type CryptoKeys = {
    * @param seed - Optional seed bytes for deterministic key generation.
    * @returns Fresh secret/public keypair.
    */
-  keygen: (seed?: Uint8Array) => { secretKey: Uint8Array; publicKey: Uint8Array };
+  keygen: (seed?: TArg<Uint8Array>) => {
+    secretKey: TRet<Uint8Array>;
+    publicKey: TRet<Uint8Array>;
+  };
   /**
    * Derive one public key from a secret key.
    * @param secretKey - Secret key bytes.
    * @returns Public key bytes.
    */
-  getPublicKey: (secretKey: Uint8Array) => Uint8Array;
+  getPublicKey: (secretKey: TArg<Uint8Array>) => TRet<Uint8Array>;
 };
 
 /** Verification options shared by the signature APIs. */
@@ -175,7 +303,7 @@ export function validateOpts(opts: object): void {
  * validateVerOpts({ context: new Uint8Array([1]) });
  * ```
  */
-export function validateVerOpts(opts: VerOpts): void {
+export function validateVerOpts(opts: TArg<VerOpts>): void {
   validateOpts(opts);
   if (opts.context !== undefined) abytes(opts.context, undefined, 'opts.context');
 }
@@ -192,7 +320,7 @@ export function validateVerOpts(opts: VerOpts): void {
  * validateSigOpts({ extraEntropy: new Uint8Array([1]) });
  * ```
  */
-export function validateSigOpts(opts: SigOpts): void {
+export function validateSigOpts(opts: TArg<SigOpts>): void {
   validateVerOpts(opts);
   if (opts.extraEntropy !== false && opts.extraEntropy !== undefined)
     abytes(opts.extraEntropy, undefined, 'opts.extraEntropy');
@@ -209,7 +337,11 @@ export type Signer = CryptoKeys & {
    * @param opts - Optional signing options.
    * @returns Signature bytes.
    */
-  sign: (msg: Uint8Array, secretKey: Uint8Array, opts?: SigOpts) => Uint8Array;
+  sign: (
+    msg: TArg<Uint8Array>,
+    secretKey: TArg<Uint8Array>,
+    opts?: TArg<SigOpts>
+  ) => TRet<Uint8Array>;
   /**
    * Verify one signature.
    * @param sig - Signature bytes.
@@ -221,7 +353,12 @@ export type Signer = CryptoKeys & {
    * a verification failure and return `false`.
    * @throws On malformed API arguments or unsupported verification options.
    */
-  verify: (sig: Uint8Array, msg: Uint8Array, publicKey: Uint8Array, opts?: VerOpts) => boolean;
+  verify: (
+    sig: TArg<Uint8Array>,
+    msg: TArg<Uint8Array>,
+    publicKey: TArg<Uint8Array>,
+    opts?: TArg<VerOpts>
+  ) => boolean;
 };
 
 /** Generic key encapsulation mechanism interface. */
@@ -235,11 +372,11 @@ export type KEM = CryptoKeys & {
    * @returns Ciphertext plus shared secret.
    */
   encapsulate: (
-    publicKey: Uint8Array,
-    msg?: Uint8Array
+    publicKey: TArg<Uint8Array>,
+    msg?: TArg<Uint8Array>
   ) => {
-    cipherText: Uint8Array;
-    sharedSecret: Uint8Array;
+    cipherText: TRet<Uint8Array>;
+    sharedSecret: TRet<Uint8Array>;
   };
   /**
    * Recover the shared secret from a ciphertext and recipient secret key.
@@ -247,7 +384,7 @@ export type KEM = CryptoKeys & {
    * @param secretKey - Recipient secret key bytes.
    * @returns Decapsulated shared secret.
    */
-  decapsulate: (cipherText: Uint8Array, secretKey: Uint8Array) => Uint8Array;
+  decapsulate: (cipherText: TArg<Uint8Array>, secretKey: TArg<Uint8Array>) => TRet<Uint8Array>;
 };
 
 /** Bidirectional encoder/decoder interface. */
@@ -308,8 +445,9 @@ type SplitOut<T extends (number | BytesCoderLen<any>)[]> = {
 export function splitCoder<T extends (number | BytesCoderLen<any>)[]>(
   label: string,
   ...lengths: T
-): BytesCoder<SplitOut<T>> & { bytesLen: number } {
-  const getLength = (c: number | BytesCoderLen<any>) => (typeof c === 'number' ? c : c.bytesLen);
+): TRet<BytesCoder<SplitOut<T>> & { bytesLen: number }> {
+  const getLength = (c: TArg<number | BytesCoderLen<any>>) =>
+    typeof c === 'number' ? c : (c as BytesCoderLen<any>).bytesLen;
   const bytesLen: number = lengths.reduce((sum: number, a) => sum + getLength(a), 0);
   return {
     bytesLen,
@@ -326,7 +464,7 @@ export function splitCoder<T extends (number | BytesCoderLen<any>)[]>(
       }
       return res;
     },
-    decode: (buf: Uint8Array) => {
+    decode: (buf: TArg<Uint8Array>) => {
       abytes_(buf, bytesLen, label);
       const res = [];
       for (const c of lengths) {
@@ -359,30 +497,31 @@ export function splitCoder<T extends (number | BytesCoderLen<any>)[]>(
  * ).encode([1, 2]);
  * ```
  */
-export function vecCoder<T>(c: BytesCoderLen<T>, vecLen: number): BytesCoderLen<T[]> {
-  const bytesLen = vecLen * c.bytesLen;
+export function vecCoder<T>(c: TArg<BytesCoderLen<T>>, vecLen: number): TRet<BytesCoderLen<T[]>> {
+  const coder = c as BytesCoderLen<T>;
+  const bytesLen = vecLen * coder.bytesLen;
   return {
     bytesLen,
-    encode: (u: T[]): Uint8Array => {
+    encode: (u: TArg<T[]>): TRet<Uint8Array> => {
       if (u.length !== vecLen)
         throw new RangeError(`vecCoder.encode: wrong length=${u.length}. Expected: ${vecLen}`);
       const res = new Uint8Array(bytesLen);
       for (let i = 0, pos = 0; i < u.length; i++) {
-        const b = c.encode(u[i]);
+        const b = coder.encode(u[i] as T);
         res.set(b, pos);
         b.fill(0); // clean
         pos += b.length;
       }
-      return res;
+      return res as TRet<Uint8Array>;
     },
-    decode: (a: Uint8Array): T[] => {
+    decode: (a: TArg<Uint8Array>): TRet<T[]> => {
       abytes_(a, bytesLen);
       const r: T[] = [];
-      for (let i = 0; i < a.length; i += c.bytesLen)
-        r.push(c.decode(a.subarray(i, i + c.bytesLen)));
-      return r;
+      for (let i = 0; i < a.length; i += coder.bytesLen)
+        r.push(coder.decode(a.subarray(i, i + coder.bytesLen)));
+      return r as TRet<T[]>;
     },
-  };
+  } as any;
 }
 
 /**
@@ -407,6 +546,7 @@ export function cleanBytes(...list: (TypedArray | TypedArray[])[]): void {
  * Creates a 32-bit mask with the lowest `bits` bits set.
  * @param bits - Number of low bits to keep.
  * @returns Bit mask with `bits` ones.
+ * @throws On wrong argument ranges or values. {@link RangeError}
  * @example
  * Create a low-bit mask for packed-field operations.
  * ```ts
@@ -421,7 +561,7 @@ export function getMask(bits: number): number {
 }
 
 /** Shared empty byte array used as the default context. */
-export const EMPTY: Uint8Array = /* @__PURE__ */ Uint8Array.of();
+export const EMPTY: TRet<Uint8Array> = /* @__PURE__ */ Uint8Array.of();
 
 /**
  * Builds the domain-separated message payload for the pure sign/verify paths.
@@ -436,7 +576,7 @@ export const EMPTY: Uint8Array = /* @__PURE__ */ Uint8Array.of();
  * const payload = getMessage(new Uint8Array([1, 2]));
  * ```
  */
-export function getMessage(msg: Uint8Array, ctx: Uint8Array = EMPTY): Uint8Array {
+export function getMessage(msg: TArg<Uint8Array>, ctx: TArg<Uint8Array> = EMPTY): TRet<Uint8Array> {
   abytes_(msg);
   abytes_(ctx);
   if (ctx.length > 255) throw new RangeError('context should be 255 bytes or less');
@@ -503,9 +643,9 @@ export function checkHash(hash: CHash, requiredStrength: number = 0): void {
  */
 export function getMessagePrehash(
   hash: CHash,
-  msg: Uint8Array,
-  ctx: Uint8Array = EMPTY
-): Uint8Array {
+  msg: TArg<Uint8Array>,
+  ctx: TArg<Uint8Array> = EMPTY
+): TRet<Uint8Array> {
   abytes_(msg);
   abytes_(ctx);
   if (ctx.length > 255) throw new RangeError('context should be 255 bytes or less');

package/utils.d.ts

@@ -4,6 +4,46 @@
  */
 /*! noble-post-quantum - MIT License (c) 2024 Paul Miller (paulmillr.com) */
 import { type CHash, type TypedArray, abytes, concatBytes, randomBytes as randb } from '@noble/hashes/utils.js';
+/**
+ * Bytes API type helpers for old + new TypeScript.
+ *
+ * TS 5.6 has `Uint8Array`, while TS 5.9+ made it generic `Uint8Array<ArrayBuffer>`.
+ * We can't use specific return type, because TS 5.6 will error.
+ * We can't use generic return type, because most TS 5.9 software will expect specific type.
+ *
+ * Maps typed-array input leaves to broad forms.
+ * These are compatibility adapters, not ownership guarantees.
+ *
+ * - `TArg` keeps byte inputs broad.
+ * - `TRet` marks byte outputs for TS 5.6 and TS 5.9+ compatibility.
+ */
+export type TypedArg<T> = T extends BigInt64Array ? BigInt64Array : T extends BigUint64Array ? BigUint64Array : T extends Float32Array ? Float32Array : T extends Float64Array ? Float64Array : T extends Int16Array ? Int16Array : T extends Int32Array ? Int32Array : T extends Int8Array ? Int8Array : T extends Uint16Array ? Uint16Array : T extends Uint32Array ? Uint32Array : T extends Uint8ClampedArray ? Uint8ClampedArray : T extends Uint8Array ? Uint8Array : never;
+/** Maps typed-array output leaves to narrow TS-compatible forms. */
+export type TypedRet<T> = T extends BigInt64Array ? ReturnType<typeof BigInt64Array.of> : T extends BigUint64Array ? ReturnType<typeof BigUint64Array.of> : T extends Float32Array ? ReturnType<typeof Float32Array.of> : T extends Float64Array ? ReturnType<typeof Float64Array.of> : T extends Int16Array ? ReturnType<typeof Int16Array.of> : T extends Int32Array ? ReturnType<typeof Int32Array.of> : T extends Int8Array ? ReturnType<typeof Int8Array.of> : T extends Uint16Array ? ReturnType<typeof Uint16Array.of> : T extends Uint32Array ? ReturnType<typeof Uint32Array.of> : T extends Uint8ClampedArray ? ReturnType<typeof Uint8ClampedArray.of> : T extends Uint8Array ? ReturnType<typeof Uint8Array.of> : never;
+/** Recursively adapts byte-carrying API input types. See {@link TypedArg}. */
+export type TArg<T> = T | ([TypedArg<T>] extends [never] ? T extends (...args: infer A) => infer R ? ((...args: {
+    [K in keyof A]: TRet<A[K]>;
+}) => TArg<R>) & {
+    [K in keyof T]: T[K] extends (...args: any) => any ? T[K] : TArg<T[K]>;
+} : T extends [infer A, ...infer R] ? [TArg<A>, ...{
+    [K in keyof R]: TArg<R[K]>;
+}] : T extends readonly [infer A, ...infer R] ? readonly [TArg<A>, ...{
+    [K in keyof R]: TArg<R[K]>;
+}] : T extends (infer A)[] ? TArg<A>[] : T extends readonly (infer A)[] ? readonly TArg<A>[] : T extends Promise<infer A> ? Promise<TArg<A>> : T extends object ? {
+    [K in keyof T]: TArg<T[K]>;
+} : T : TypedArg<T>);
+/** Recursively adapts byte-carrying API output types. See {@link TypedArg}. */
+export type TRet<T> = T extends unknown ? T & ([TypedRet<T>] extends [never] ? T extends (...args: infer A) => infer R ? ((...args: {
+    [K in keyof A]: TArg<A[K]>;
+}) => TRet<R>) & {
+    [K in keyof T]: T[K] extends (...args: any) => any ? T[K] : TRet<T[K]>;
+} : T extends [infer A, ...infer R] ? [TRet<A>, ...{
+    [K in keyof R]: TRet<R[K]>;
+}] : T extends readonly [infer A, ...infer R] ? readonly [TRet<A>, ...{
+    [K in keyof R]: TRet<R[K]>;
+}] : T extends (infer A)[] ? TRet<A>[] : T extends readonly (infer A)[] ? readonly TRet<A>[] : T extends Promise<infer A> ? Promise<TRet<A>> : T extends object ? {
+    [K in keyof T]: TRet<T[K]>;
+} : T : TypedRet<T>) : never;
 /**
  * Asserts that a value is a byte array and optionally checks its length.
  * Returns the original reference unchanged on success, and currently also accepts Node `Buffer`
@@ -35,6 +75,8 @@ export { concatBytesDoc as concatBytes };
  * Requires `globalThis.crypto.getRandomValues` and throws if that API is unavailable.
  * `bytesLength` is validated by the upstream helper as a non-negative integer before allocation,
  * so negative and fractional values both throw instead of truncating through JS `ToIndex`.
+ * @param bytesLength - Number of random bytes to generate.
+ * @returns Fresh random bytes.
  * @example
  * Generate a fresh random seed.
  * ```ts
@@ -54,11 +96,10 @@ export declare const randomBytes: typeof randb;
  * equalBytes(new Uint8Array([1]), new Uint8Array([1]));
  * ```
  */
-export declare function equalBytes(a: Uint8Array, b: Uint8Array): boolean;
+export declare function equalBytes(a: TArg<Uint8Array>, b: TArg<Uint8Array>): boolean;
 /**
  * Copies bytes into a fresh `Uint8Array`.
- * Returns a detached plain `Uint8Array`, and currently accepts broader array-like / iterable
- * inputs because it delegates directly to `Uint8Array.from(...)`.
+ * Returns a detached plain `Uint8Array` after validating that the input is real bytes.
  * @param bytes - Source bytes.
  * @returns Copy of the input bytes.
  * @example
@@ -67,15 +108,32 @@ export declare function equalBytes(a: Uint8Array, b: Uint8Array): boolean;
  * copyBytes(new Uint8Array([1, 2]));
  * ```
  */
-export declare function copyBytes(bytes: Uint8Array): Uint8Array;
+export declare function copyBytes(bytes: TArg<Uint8Array>): TRet<Uint8Array>;
 /**
  * Byte-swaps each 64-bit lane in place.
  * Falcon's exact binary64 tables are stored as little-endian byte payloads, so BE runtimes need
  * this boundary helper before aliasing them as host `Float64Array` lanes.
  * @param arr - Byte buffer whose length is a multiple of 8.
  * @returns The same buffer after in-place 64-bit lane byte swaps.
+ * @example
+ * Byte-swap one 64-bit lane in place.
+ * ```ts
+ * byteSwap64(new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]));
+ * ```
  */
 export declare function byteSwap64<T extends ArrayBufferView>(arr: T): T;
+/**
+ * Byte-swaps 64-bit lanes on big-endian runtimes and returns the input unchanged on little-endian.
+ * This keeps Falcon's binary64 tables in canonical little-endian order before aliasing them as
+ * `Float64Array` lanes on the current host.
+ * @param arr - Buffer to pass through or swap in place.
+ * @returns The same buffer, normalized for Falcon's little-endian table layout.
+ * @example
+ * Normalize one host-endian buffer for Falcon's float tables.
+ * ```ts
+ * baswap64If(new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]));
+ * ```
+ */
 export declare const baswap64If: <T extends ArrayBufferView>(arr: T) => T;
 /** Shared key-generation surface for signers and KEMs. */
 export type CryptoKeys = {
@@ -94,16 +152,16 @@ export type CryptoKeys = {
      * @param seed - Optional seed bytes for deterministic key generation.
      * @returns Fresh secret/public keypair.
      */
-    keygen: (seed?: Uint8Array) => {
-        secretKey: Uint8Array;
-        publicKey: Uint8Array;
+    keygen: (seed?: TArg<Uint8Array>) => {
+        secretKey: TRet<Uint8Array>;
+        publicKey: TRet<Uint8Array>;
     };
     /**
      * Derive one public key from a secret key.
      * @param secretKey - Secret key bytes.
      * @returns Public key bytes.
      */
-    getPublicKey: (secretKey: Uint8Array) => Uint8Array;
+    getPublicKey: (secretKey: TArg<Uint8Array>) => TRet<Uint8Array>;
 };
 /** Verification options shared by the signature APIs. */
 export type VerOpts = {
@@ -138,7 +196,7 @@ export declare function validateOpts(opts: object): void;
  * validateVerOpts({ context: new Uint8Array([1]) });
  * ```
  */
-export declare function validateVerOpts(opts: VerOpts): void;
+export declare function validateVerOpts(opts: TArg<VerOpts>): void;
 /**
  * Validates common signing options.
  * `extraEntropy` is validated with `abytes(...)`; exact lengths and extra algorithm-specific
@@ -151,7 +209,7 @@ export declare function validateVerOpts(opts: VerOpts): void;
  * validateSigOpts({ extraEntropy: new Uint8Array([1]) });
  * ```
  */
-export declare function validateSigOpts(opts: SigOpts): void;
+export declare function validateSigOpts(opts: TArg<SigOpts>): void;
 /** Generic signature interface with key generation, signing, and verification. */
 export type Signer = CryptoKeys & {
     /** Public byte lengths for signatures and signing randomness. */
@@ -166,7 +224,7 @@ export type Signer = CryptoKeys & {
      * @param opts - Optional signing options.
      * @returns Signature bytes.
      */
-    sign: (msg: Uint8Array, secretKey: Uint8Array, opts?: SigOpts) => Uint8Array;
+    sign: (msg: TArg<Uint8Array>, secretKey: TArg<Uint8Array>, opts?: TArg<SigOpts>) => TRet<Uint8Array>;
     /**
      * Verify one signature.
      * @param sig - Signature bytes.
@@ -178,7 +236,7 @@ export type Signer = CryptoKeys & {
      * a verification failure and return `false`.
      * @throws On malformed API arguments or unsupported verification options.
      */
-    verify: (sig: Uint8Array, msg: Uint8Array, publicKey: Uint8Array, opts?: VerOpts) => boolean;
+    verify: (sig: TArg<Uint8Array>, msg: TArg<Uint8Array>, publicKey: TArg<Uint8Array>, opts?: TArg<VerOpts>) => boolean;
 };
 /** Generic key encapsulation mechanism interface. */
 export type KEM = CryptoKeys & {
@@ -194,9 +252,9 @@ export type KEM = CryptoKeys & {
      * @param msg - Optional caller-provided randomness/message seed.
      * @returns Ciphertext plus shared secret.
      */
-    encapsulate: (publicKey: Uint8Array, msg?: Uint8Array) => {
-        cipherText: Uint8Array;
-        sharedSecret: Uint8Array;
+    encapsulate: (publicKey: TArg<Uint8Array>, msg?: TArg<Uint8Array>) => {
+        cipherText: TRet<Uint8Array>;
+        sharedSecret: TRet<Uint8Array>;
     };
     /**
      * Recover the shared secret from a ciphertext and recipient secret key.
@@ -204,7 +262,7 @@ export type KEM = CryptoKeys & {
      * @param secretKey - Recipient secret key bytes.
      * @returns Decapsulated shared secret.
      */
-    decapsulate: (cipherText: Uint8Array, secretKey: Uint8Array) => Uint8Array;
+    decapsulate: (cipherText: TArg<Uint8Array>, secretKey: TArg<Uint8Array>) => TRet<Uint8Array>;
 };
 /** Bidirectional encoder/decoder interface. */
 export interface Coder<F, T> {
@@ -259,9 +317,9 @@ type SplitOut<T extends (number | BytesCoderLen<any>)[]> = {
  * splitCoder('demo', 1, 2).encode([new Uint8Array([1]), new Uint8Array([2, 3])]);
  * ```
  */
-export declare function splitCoder<T extends (number | BytesCoderLen<any>)[]>(label: string, ...lengths: T): BytesCoder<SplitOut<T>> & {
+export declare function splitCoder<T extends (number | BytesCoderLen<any>)[]>(label: string, ...lengths: T): TRet<BytesCoder<SplitOut<T>> & {
     bytesLen: number;
-};
+}>;
 /**
  * Builds a fixed-length vector coder from another fixed-length coder.
  * Element decoding receives `subarray(...)` views, so aliasing depends on the element coder.
@@ -281,7 +339,7 @@ export declare function splitCoder<T extends (number | BytesCoderLen<any>)[]>(la
  * ).encode([1, 2]);
  * ```
  */
-export declare function vecCoder<T>(c: BytesCoderLen<T>, vecLen: number): BytesCoderLen<T[]>;
+export declare function vecCoder<T>(c: TArg<BytesCoderLen<T>>, vecLen: number): TRet<BytesCoderLen<T[]>>;
 /**
  * Overwrites supported typed-array inputs with zeroes in place.
  * Accepts direct typed arrays and one-level arrays of them.
@@ -298,6 +356,7 @@ export declare function cleanBytes(...list: (TypedArray | TypedArray[])[]): void
  * Creates a 32-bit mask with the lowest `bits` bits set.
  * @param bits - Number of low bits to keep.
  * @returns Bit mask with `bits` ones.
+ * @throws On wrong argument ranges or values. {@link RangeError}
  * @example
  * Create a low-bit mask for packed-field operations.
  * ```ts
@@ -306,7 +365,7 @@ export declare function cleanBytes(...list: (TypedArray | TypedArray[])[]): void
  */
 export declare function getMask(bits: number): number;
 /** Shared empty byte array used as the default context. */
-export declare const EMPTY: Uint8Array;
+export declare const EMPTY: TRet<Uint8Array>;
 /**
  * Builds the domain-separated message payload for the pure sign/verify paths.
  * Context length `255` is valid; only `ctx.length > 255` is rejected.
@@ -320,7 +379,7 @@ export declare const EMPTY: Uint8Array;
  * const payload = getMessage(new Uint8Array([1, 2]));
  * ```
  */
-export declare function getMessage(msg: Uint8Array, ctx?: Uint8Array): Uint8Array;
+export declare function getMessage(msg: TArg<Uint8Array>, ctx?: TArg<Uint8Array>): TRet<Uint8Array>;
 /**
  * Validates that a hash exposes a NIST hash OID and enough collision resistance.
  * Current accepted surface is broader than the FIPS algorithm tables: any hash/XOF under the NIST
@@ -357,5 +416,5 @@ export declare function checkHash(hash: CHash, requiredStrength?: number): void;
  * getMessagePrehash(sha256, new Uint8Array([1, 2]));
  * ```
  */
-export declare function getMessagePrehash(hash: CHash, msg: Uint8Array, ctx?: Uint8Array): Uint8Array;
+export declare function getMessagePrehash(hash: CHash, msg: TArg<Uint8Array>, ctx?: TArg<Uint8Array>): TRet<Uint8Array>;
 //# sourceMappingURL=utils.d.ts.map

package/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["src/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["src/utils.ts"],"names":[],"mappings":"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"}