sm-crypto-wasm 0.7.0 → 0.7.1

package/dist/asn1/decode.d.ts

@@ -13,62 +13,153 @@
  * - 单对象解析一律拒绝尾部多余字节（红线 #3）。
  *
  * 每个节点保留 `raw`（输入缓冲上的视图），供 CMS 验签与证书 TBS 直接使用。
+ *
+ * ASN.1 DER/BER parser.
+ *
+ * Covers the BER/DER subset needed by X.509 and CMS:
+ * - definite-length (short and long form);
+ * - BER indefinite-length (`0x80` + EOC `00 00`), allowed **only in `parseBer`**;
+ * - high tag numbers (`0x1f` + base128);
+ * - recursive constructed / primitive handling.
+ *
+ * Strictness:
+ * - `parseDer` rejects indefinite length, non-minimal length encodings, EOC and
+ *   trailing bytes;
+ * - `parseBer` relaxes length encoding and allows indefinite length, but still
+ *   rejects truncation and trailing bytes;
+ * - single-object parsing always rejects trailing bytes (red line #3).
+ *
+ * Every node keeps `raw` (a view onto the input buffer) so that CMS signature
+ * verification and certificate TBS hashing can use it directly.
  */
 import { type Asn1Node } from './types.js';
-/** 解析选项。 */
+/**
+ * 解析选项。
+ *
+ * Parse options.
+ */
 export interface ParseOptions {
-    /** 允许 BER indefinite-length。仅 CMS 路径应开启。 */
+    /**
+     * 允许 BER indefinite-length。仅 CMS 路径应开启。
+     *
+     * Allow BER indefinite-length; only the CMS path should enable this.
+     */
     allowIndefinite?: boolean;
-    /** 是否严格校验长度编码的最小形式（DER 默认开启）。 */
+    /**
+     * 是否严格校验长度编码的最小形式（DER 默认开启）。
+     *
+     * Whether to enforce minimal length encoding (on by default for DER).
+     */
     strictLength?: boolean;
 }
 /**
  * 解析单个 DER 对象。
  *
  * @throws Asn1Error 截断、超出深度、非 DER 编码、或根节点后有多余字节。
+ *
+ * Parses a single DER object.
+ *
+ * @throws Asn1Error On truncation, excessive depth, non-DER encoding, or trailing
+ *   bytes after the root node.
  */
 export declare function parseDer(buf: Uint8Array): Asn1Node;
 /**
  * 解析单个 BER 对象（允许 indefinite-length）。
  *
  * @throws Asn1Error 截断、超出深度、或根节点后有多余字节。
+ *
+ * Parses a single BER object (indefinite-length allowed).
+ *
+ * @throws Asn1Error On truncation, excessive depth, or trailing bytes after the
+ *   root node.
  */
 export declare function parseBer(buf: Uint8Array): Asn1Node;
 /**
  * 解析连续的多个 DER 对象（证书 bundle / CMS 文件）。
  *
  * 返回按出现顺序排列的节点；允许空输入并返回空数组。
+ *
+ * Parses a sequence of consecutive DER objects (a certificate bundle or a CMS file).
+ *
+ * Returns the nodes in order of appearance; empty input is allowed and yields an
+ * empty array.
  */
 export declare function parseDerAll(buf: Uint8Array): Asn1Node[];
-/** 解析连续的多个 BER 对象（允许 indefinite-length）。 */
+/**
+ * 解析连续的多个 BER 对象（允许 indefinite-length）。
+ *
+ * Parses a sequence of consecutive BER objects (indefinite-length allowed).
+ */
 export declare function parseBerAll(buf: Uint8Array): Asn1Node[];
 /**
  * 读取 INTEGER（二进制补码，支持负数）。
  *
  * @throws Asn1Error 节点不是 INTEGER。
+ *
+ * Reads an INTEGER (two's complement, negative values supported).
+ *
+ * @throws Asn1Error When the node is not an INTEGER.
  */
 export declare function readInteger(node: Asn1Node, what?: string): bigint;
-/** 读取 BOOLEAN（DER 中 TRUE 必须为 0xFF）。 */
+/**
+ * 读取 BOOLEAN（DER 中 TRUE 必须为 0xFF）。
+ *
+ * Reads a BOOLEAN (DER requires TRUE to be 0xFF).
+ */
 export declare function readBoolean(node: Asn1Node, what?: string): boolean;
-/** BIT STRING 内容。 */
+/**
+ * BIT STRING 内容。
+ *
+ * Contents of a BIT STRING.
+ */
 export interface BitString {
-    /** 去掉 unused bits 后的有效字节（尾部未用位保留，由调用方屏蔽）。 */
+    /**
+     * 去掉 unused bits 后的有效字节（尾部未用位保留，由调用方屏蔽）。
+     *
+     * The payload bytes, with the unused-bits header removed (the trailing unused
+     * bits stay in place and must be masked by the caller).
+     */
     readonly bytes: Uint8Array;
-    /** 末尾未使用位数（0..7）。 */
+    /**
+     * 末尾未使用位数（0..7）。
+     *
+     * Number of unused trailing bits (0..7).
+     */
     readonly unusedBits: number;
 }
-/** 读取 BIT STRING。 */
+/**
+ * 读取 BIT STRING。
+ *
+ * Reads a BIT STRING.
+ */
 export declare function readBitString(node: Asn1Node, what?: string): BitString;
-/** 读取 OCTET STRING。 */
+/**
+ * 读取 OCTET STRING。
+ *
+ * Reads an OCTET STRING.
+ */
 export declare function readOctetString(node: Asn1Node, what?: string): Uint8Array;
-/** 读取 OBJECT IDENTIFIER。 */
+/**
+ * 读取 OBJECT IDENTIFIER。
+ *
+ * Reads an OBJECT IDENTIFIER.
+ */
 export declare function readOid(node: Asn1Node, what?: string): string;
-/** 读取 UTCTime / GeneralizedTime。 */
+/**
+ * 读取 UTCTime / GeneralizedTime。
+ *
+ * Reads a UTCTime / GeneralizedTime.
+ */
 export declare function readTime(node: Asn1Node, what?: string): Date;
 /**
  * 读取 ASN.1 字符串。
  *
  * 支持 UTF8String / PrintableString / IA5String / NumericString /
  * TeletexString / BMPString / UniversalString；其他类型抛 `Asn1Error`。
+ *
+ * Reads an ASN.1 string.
+ *
+ * Supports UTF8String / PrintableString / IA5String / NumericString /
+ * TeletexString / BMPString / UniversalString; other types throw `Asn1Error`.
  */
 export declare function readString(node: Asn1Node, what?: string): string;

package/dist/asn1/decode.js

@@ -13,16 +13,44 @@
  * - 单对象解析一律拒绝尾部多余字节（红线 #3）。
  *
  * 每个节点保留 `raw`（输入缓冲上的视图），供 CMS 验签与证书 TBS 直接使用。
+ *
+ * ASN.1 DER/BER parser.
+ *
+ * Covers the BER/DER subset needed by X.509 and CMS:
+ * - definite-length (short and long form);
+ * - BER indefinite-length (`0x80` + EOC `00 00`), allowed **only in `parseBer`**;
+ * - high tag numbers (`0x1f` + base128);
+ * - recursive constructed / primitive handling.
+ *
+ * Strictness:
+ * - `parseDer` rejects indefinite length, non-minimal length encodings, EOC and
+ *   trailing bytes;
+ * - `parseBer` relaxes length encoding and allows indefinite length, but still
+ *   rejects truncation and trailing bytes;
+ * - single-object parsing always rejects trailing bytes (red line #3).
+ *
+ * Every node keeps `raw` (a view onto the input buffer) so that CMS signature
+ * verification and certificate TBS hashing can use it directly.
  */
 import { decodeOid } from './oid.js';
 import { parseTime } from './time.js';
 import { Asn1Class, Asn1Error, UniversalTag } from './types.js';
-/** constructed 嵌套深度上限，防栈溢出与恶意深嵌套。 */
+/**
+ * constructed 嵌套深度上限，防栈溢出与恶意深嵌套。
+ *
+ * Upper bound on constructed nesting depth, to avoid stack overflow and hostile
+ * deeply nested input.
+ */
 const MAX_DEPTH = 64;
 /**
  * 解析单个 DER 对象。
  *
  * @throws Asn1Error 截断、超出深度、非 DER 编码、或根节点后有多余字节。
+ *
+ * Parses a single DER object.
+ *
+ * @throws Asn1Error On truncation, excessive depth, non-DER encoding, or trailing
+ *   bytes after the root node.
  */
 export function parseDer(buf) {
     return parseSingle(buf, { allowIndefinite: false, strictLength: true }, 'parseDer');
@@ -31,6 +59,11 @@ export function parseDer(buf) {
  * 解析单个 BER 对象（允许 indefinite-length）。
  *
  * @throws Asn1Error 截断、超出深度、或根节点后有多余字节。
+ *
+ * Parses a single BER object (indefinite-length allowed).
+ *
+ * @throws Asn1Error On truncation, excessive depth, or trailing bytes after the
+ *   root node.
  */
 export function parseBer(buf) {
     return parseSingle(buf, { allowIndefinite: true, strictLength: false }, 'parseBer');
@@ -39,14 +72,28 @@ export function parseBer(buf) {
  * 解析连续的多个 DER 对象（证书 bundle / CMS 文件）。
  *
  * 返回按出现顺序排列的节点；允许空输入并返回空数组。
+ *
+ * Parses a sequence of consecutive DER objects (a certificate bundle or a CMS file).
+ *
+ * Returns the nodes in order of appearance; empty input is allowed and yields an
+ * empty array.
  */
 export function parseDerAll(buf) {
     return parseAll(buf, { allowIndefinite: false, strictLength: true }, 'parseDerAll');
 }
-/** 解析连续的多个 BER 对象（允许 indefinite-length）。 */
+/**
+ * 解析连续的多个 BER 对象（允许 indefinite-length）。
+ *
+ * Parses a sequence of consecutive BER objects (indefinite-length allowed).
+ */
 export function parseBerAll(buf) {
     return parseAll(buf, { allowIndefinite: true, strictLength: false }, 'parseBerAll');
 }
+/**
+ * 解析根节点，并要求输入完全被消费。
+ *
+ * Parses the root node and requires the whole input to be consumed.
+ */
 function parseSingle(buf, opts, where) {
     const reader = new Reader(buf, opts, where);
     const node = reader.readNode(0);
@@ -55,6 +102,11 @@ function parseSingle(buf, opts, where) {
     }
     return node;
 }
+/**
+ * 解析所有顶层对象，直到输入耗尽。
+ *
+ * Parses every top-level object until the input is exhausted.
+ */
 function parseAll(buf, opts, where) {
     const reader = new Reader(buf, opts, where);
     const nodes = [];
@@ -63,6 +115,11 @@ function parseAll(buf, opts, where) {
     }
     return nodes;
 }
+/**
+ * 游标式 TLV 读取器（持有单一输入缓冲与位置）。
+ *
+ * Cursor-style TLV reader over a single input buffer.
+ */
 class Reader {
     buf;
     opts;
@@ -73,16 +130,30 @@ class Reader {
         this.opts = opts;
         this.where = where;
     }
+    /**
+     * 距输入末尾还剩多少字节。
+     *
+     * Number of bytes left before the end of the input.
+     */
     remaining() {
         return this.buf.length - this.pos;
     }
+    /**
+     * 读取一个字节，越界则报错。
+     *
+     * Reads one byte, throwing on out-of-bounds.
+     */
     byte() {
         if (this.pos >= this.buf.length) {
             throw new Asn1Error(`${this.where}: truncated at offset ${this.pos}`);
         }
         return this.buf[this.pos++];
     }
-    /** 读取一个完整 TLV。 */
+    /**
+     * 读取一个完整 TLV。
+     *
+     * Reads one complete TLV.
+     */
     readNode(depth) {
         if (depth > MAX_DEPTH) {
             throw new Asn1Error(`${this.where}: nesting deeper than ${MAX_DEPTH}`);
@@ -93,6 +164,8 @@ class Reader {
         const constructed = (first & 0x20) !== 0;
         const tag = (first & 0x1f) === 0x1f ? this.readHighTag() : first & 0x1f;
         // EndOfContent 只能作为 indefinite-length 的结束标记出现。
+        //
+        // EndOfContent may only appear as the terminator of an indefinite-length value.
         if (cls === Asn1Class.Universal && tag === UniversalTag.EndOfContent && !constructed) {
             const lb = this.byte();
             if (lb !== 0)
@@ -120,6 +193,8 @@ class Reader {
         const contentStart = this.pos;
         if (indefinite) {
             // indefinite：一直读到 EOC（00 00）。
+            //
+            // Indefinite: keep reading until the EOC (00 00).
             const children = [];
             for (;;) {
                 if (this.remaining() < 2) {
@@ -176,7 +251,11 @@ class Reader {
             raw: this.buf.subarray(start, this.pos),
         };
     }
-    /** 高 tag number：后续字节 base128。 */
+    /**
+     * 高 tag number：后续字节 base128。
+     *
+     * High tag number: subsequent bytes are base128.
+     */
     readHighTag() {
         let value = 0;
         let count = 0;
@@ -194,7 +273,11 @@ class Reader {
                 return value;
         }
     }
-    /** 长格式长度（`n` 为 1..4）。 */
+    /**
+     * 长格式长度（`n` 为 1..4）。
+     *
+     * Long-form length (`n` is 1..4).
+     */
     readLongLength(n) {
         if (n === 0)
             throw new Asn1Error(`${this.where}: reserved length encoding 0x80`);
@@ -220,10 +303,16 @@ class Reader {
     }
 }
 // ----------------- 常用值读取 -----------------
+//
+// ----------------- Common value readers -----------------
 /**
  * 读取 INTEGER（二进制补码，支持负数）。
  *
  * @throws Asn1Error 节点不是 INTEGER。
+ *
+ * Reads an INTEGER (two's complement, negative values supported).
+ *
+ * @throws Asn1Error When the node is not an INTEGER.
  */
 export function readInteger(node, what = 'INTEGER') {
     if (node.cls !== Asn1Class.Universal || node.tag !== UniversalTag.Integer) {
@@ -240,7 +329,11 @@ export function readInteger(node, what = 'INTEGER') {
     }
     return value;
 }
-/** 读取 BOOLEAN（DER 中 TRUE 必须为 0xFF）。 */
+/**
+ * 读取 BOOLEAN（DER 中 TRUE 必须为 0xFF）。
+ *
+ * Reads a BOOLEAN (DER requires TRUE to be 0xFF).
+ */
 export function readBoolean(node, what = 'BOOLEAN') {
     if (node.cls !== Asn1Class.Universal || node.tag !== UniversalTag.Boolean) {
         throw new Asn1Error(`${what}: expected BOOLEAN`);
@@ -249,7 +342,11 @@ export function readBoolean(node, what = 'BOOLEAN') {
         throw new Asn1Error(`${what}: BOOLEAN must be 1 byte`);
     return node.value[0] !== 0;
 }
-/** 读取 BIT STRING。 */
+/**
+ * 读取 BIT STRING。
+ *
+ * Reads a BIT STRING.
+ */
 export function readBitString(node, what = 'BIT STRING') {
     if (node.cls !== Asn1Class.Universal || node.tag !== UniversalTag.BitString) {
         throw new Asn1Error(`${what}: expected BIT STRING`);
@@ -261,21 +358,33 @@ export function readBitString(node, what = 'BIT STRING') {
         throw new Asn1Error(`${what}: invalid unused-bit count ${unusedBits}`);
     return { bytes: node.value.subarray(1), unusedBits };
 }
-/** 读取 OCTET STRING。 */
+/**
+ * 读取 OCTET STRING。
+ *
+ * Reads an OCTET STRING.
+ */
 export function readOctetString(node, what = 'OCTET STRING') {
     if (node.cls !== Asn1Class.Universal || node.tag !== UniversalTag.OctetString) {
         throw new Asn1Error(`${what}: expected OCTET STRING`);
     }
     return node.value;
 }
-/** 读取 OBJECT IDENTIFIER。 */
+/**
+ * 读取 OBJECT IDENTIFIER。
+ *
+ * Reads an OBJECT IDENTIFIER.
+ */
 export function readOid(node, what = 'OBJECT IDENTIFIER') {
     if (node.cls !== Asn1Class.Universal || node.tag !== UniversalTag.ObjectIdentifier) {
         throw new Asn1Error(`${what}: expected OBJECT IDENTIFIER`);
     }
     return decodeOid(node.value);
 }
-/** 读取 UTCTime / GeneralizedTime。 */
+/**
+ * 读取 UTCTime / GeneralizedTime。
+ *
+ * Reads a UTCTime / GeneralizedTime.
+ */
 export function readTime(node, what = 'Time') {
     if (node.cls !== Asn1Class.Universal) {
         throw new Asn1Error(`${what}: expected UTCTime or GeneralizedTime`);
@@ -291,6 +400,11 @@ export function readTime(node, what = 'Time') {
  *
  * 支持 UTF8String / PrintableString / IA5String / NumericString /
  * TeletexString / BMPString / UniversalString；其他类型抛 `Asn1Error`。
+ *
+ * Reads an ASN.1 string.
+ *
+ * Supports UTF8String / PrintableString / IA5String / NumericString /
+ * TeletexString / BMPString / UniversalString; other types throw `Asn1Error`.
  */
 export function readString(node, what = 'string') {
     if (node.cls !== Asn1Class.Universal) {
@@ -330,6 +444,11 @@ export function readString(node, what = 'string') {
             throw new Asn1Error(`${what}: unsupported string tag ${node.tag}`);
     }
 }
+/**
+ * 字节 → 单字节字符（低 8 位），用于 ASCII 类字符串。
+ *
+ * Bytes to one-code-unit string, used for ASCII-like string types.
+ */
 function latin1(bytes) {
     let out = '';
     for (let i = 0; i < bytes.length; i++)

package/dist/asn1/encode.d.ts

@@ -8,55 +8,149 @@
  * - BOOLEAN TRUE 编码为 0xFF；
  * - INTEGER 使用最小补码编码；
  * - 输出始终是 definite-length（BER indefinite 只在解析侧接受）。
+ *
+ * ASN.1 DER encoder and builders.
+ *
+ * Rules:
+ * - `encode()` rebuilds the leading byte from `cls + constructed + tag` (fixing the
+ *   legacy implementation dropping the constructed bit) and recurses into children
+ *   of constructed nodes;
+ * - SET OF is sorted by encoded bytes (a DER requirement);
+ * - BOOLEAN TRUE is encoded as 0xFF;
+ * - INTEGER uses minimal two's-complement encoding;
+ * - output is always definite-length (BER indefinite is only accepted when parsing).
  */
 import { Asn1Class, type Asn1Node } from './types.js';
-/** 编码单个节点为 DER 字节。 */
+/**
+ * 编码单个节点为 DER 字节。
+ *
+ * Encodes a single node to DER bytes.
+ */
 export declare function encode(node: Asn1Node): Uint8Array;
 /**
  * `encode` 的旧名（兼容 `src/pem/asn1.ts` 的历史导出）。
  *
  * @deprecated 使用 `encode`。
+ *
+ * Legacy alias of `encode` (kept for the historical exports of `src/pem/asn1.ts`).
+ *
+ * @deprecated Use `encode`.
  */
 export declare const encodeDer: typeof encode;
-/** 编码 tag 首字节（含高 tag number 的 base128 展开）。 */
+/**
+ * 编码 tag 首字节（含高 tag number 的 base128 展开）。
+ *
+ * Encodes the tag's leading byte (including base128 expansion of high tag numbers).
+ */
 export declare function encodeTag(cls: Asn1Class, constructed: boolean, tag: number): Uint8Array;
-/** 编码 definite-length。 */
+/**
+ * 编码 definite-length。
+ *
+ * Encodes a definite length.
+ */
 export declare function encodeLength(length: number): Uint8Array;
-/** 构造 SEQUENCE。 */
+/**
+ * 构造 SEQUENCE。
+ *
+ * Builds a SEQUENCE.
+ */
 export declare function seq(children: readonly Asn1Node[]): Asn1Node;
-/** 构造 SET（保持给定顺序；ASN.1 SET 的排序语义由调用方负责）。 */
+/**
+ * 构造 SET（保持给定顺序；ASN.1 SET 的排序语义由调用方负责）。
+ *
+ * Builds a SET, keeping the given order; ordering semantics are the caller's job.
+ */
 export declare function set(children: readonly Asn1Node[]): Asn1Node;
-/** 构造 SET OF（按 DER 编码字节排序）。 */
+/**
+ * 构造 SET OF（按 DER 编码字节排序）。
+ *
+ * Builds a SET OF, sorted by encoded DER bytes.
+ */
 export declare function setOf(children: readonly Asn1Node[]): Asn1Node;
-/** 构造 `[tag] EXPLICIT` 包装。 */
+/**
+ * 构造 `[tag] EXPLICIT` 包装。
+ *
+ * Builds a `[tag] EXPLICIT` wrapper.
+ */
 export declare function explicit(tag: number, inner: Asn1Node): Asn1Node;
 /**
  * 构造 `[tag] IMPLICIT` 包装：只替换外层标签，内容保持不变。
+ *
+ * Builds a `[tag] IMPLICIT` wrapper: only the outer tag is replaced, the content is
+ * kept unchanged.
  */
 export declare function implicit(tag: number, inner: Asn1Node, cls?: Asn1Class): Asn1Node;
-/** 构造 BIT STRING。`unusedBits` 为末尾未使用位数（0..7）。 */
+/**
+ * 构造 BIT STRING。`unusedBits` 为末尾未使用位数（0..7）。
+ *
+ * Builds a BIT STRING; `unusedBits` is the number of unused trailing bits (0..7).
+ */
 export declare function bitString(bytes: Uint8Array, unusedBits?: number): Asn1Node;
-/** 构造 OCTET STRING。 */
+/**
+ * 构造 OCTET STRING。
+ *
+ * Builds an OCTET STRING.
+ */
 export declare function octetString(bytes: Uint8Array): Asn1Node;
-/** 构造 BOOLEAN。 */
+/**
+ * 构造 BOOLEAN。
+ *
+ * Builds a BOOLEAN.
+ */
 export declare function boolean(value: boolean): Asn1Node;
-/** 构造 NULL。 */
+/**
+ * 构造 NULL。
+ *
+ * Builds a NULL.
+ */
 export declare function nullValue(): Asn1Node;
-/** 构造 INTEGER（最小补码编码）。 */
+/**
+ * 构造 INTEGER（最小补码编码）。
+ *
+ * Builds an INTEGER (minimal two's-complement encoding).
+ */
 export declare function integer(value: bigint | number): Asn1Node;
-/** 构造 OBJECT IDENTIFIER。 */
+/**
+ * 构造 OBJECT IDENTIFIER。
+ *
+ * Builds an OBJECT IDENTIFIER.
+ */
 export declare function oid(value: string): Asn1Node;
-/** 构造 UTF8String。 */
+/**
+ * 构造 UTF8String。
+ *
+ * Builds a UTF8String.
+ */
 export declare function utf8String(value: string): Asn1Node;
-/** 构造 PrintableString（仅允许 A-Z a-z 0-9 与 `'()+,-./:=?` 和空格）。 */
+/**
+ * 构造 PrintableString（仅允许 A-Z a-z 0-9 与 `'()+,-./:=?` 和空格）。
+ *
+ * Builds a PrintableString (only A-Z a-z 0-9 and `'()+,-./:=?` plus space allowed).
+ */
 export declare function printableString(value: string): Asn1Node;
-/** 构造 IA5String（仅 ASCII）。 */
+/**
+ * 构造 IA5String（仅 ASCII）。
+ *
+ * Builds an IA5String (ASCII only).
+ */
 export declare function ia5String(value: string): Asn1Node;
-/** 构造 UTCTime（1950–2049）。 */
+/**
+ * 构造 UTCTime（1950–2049）。
+ *
+ * Builds a UTCTime (years 1950–2049).
+ */
 export declare function utcTime(date: Date): Asn1Node;
-/** 构造 GeneralizedTime。 */
+/**
+ * 构造 GeneralizedTime。
+ *
+ * Builds a GeneralizedTime.
+ */
 export declare function generalizedTime(date: Date): Asn1Node;
-/** 按 RFC 5280 自动选择 UTCTime / GeneralizedTime。 */
+/**
+ * 按 RFC 5280 自动选择 UTCTime / GeneralizedTime。
+ *
+ * Picks UTCTime / GeneralizedTime automatically as RFC 5280 requires.
+ */
 export declare function time(date: Date): Asn1Node;
 /**
  * INTEGER 最小补码编码。
@@ -64,5 +158,12 @@ export declare function time(date: Date): Asn1Node;
  * - 0 → `00`；
  * - 正数：最高位为 1 时前置 `00`；
  * - 负数：选择最少字节数 n 使 `-2^(8n-1) <= v`，按 2^(8n) 取模。
+ *
+ * Minimal two's-complement INTEGER encoding.
+ *
+ * - 0 → `00`;
+ * - positive: prepend `00` when the top bit would otherwise be set;
+ * - negative: pick the fewest bytes n such that `-2^(8n-1) <= v`, then reduce modulo
+ *   2^(8n).
  */
 export declare function encodeIntegerValue(v: bigint): Uint8Array;