@thi.ng/leb128 3.0.88 → 3.1.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-04-13T16:05:36Z
+- **Last updated**: 2024-04-20T14:42:45Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,16 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [3.1.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/leb128@3.1.0) (2024-04-20)
+
+#### 🚀 Features
+
+- update docs, add encode[SU]LEB128Into() fns ([44f927b](https://github.com/thi-ng/umbrella/commit/44f927b))
+  - update/fix doc strings
+  - retroactively document new functions by @jtenner's PR ([#460](https://github.com/thi-ng/umbrella/issues/460))
+    - add encodeSLEB128Into()
+    - add encodeULEB128Into()
+
 ### [3.0.47](https://github.com/thi-ng/umbrella/tree/@thi.ng/leb128@3.0.47) (2023-11-09)
 
 #### ♻️ Refactoring

package/README.md

@@ -39,8 +39,9 @@ environments. The source code of the actual implementation (written in
 All public functions throw an error if the WASM module could not be
 initialized.
 
-All encodeInto functions will check the bounds of the target array to
-make sure all the bytes can be written.
+The `encodeSLEB128Into()` and `encodeULEB128Into()` functions will check the
+bounds of the target array to ensure all bytes can be written and will
+throw an error if the result would go out of bounds.
 
 References:
 
@@ -77,10 +78,10 @@ import * as leb from "@thi.ng/leb128";
 Browser ESM import:
 
 ```html
-<script type="module" src="https://cdn.skypack.dev/@thi.ng/leb128"></script>
+<script type="module" src="https://esm.run/@thi.ng/leb128"></script>
 ```
 
-[Skypack documentation](https://docs.skypack.dev/)
+[JSDelivr documentation](https://www.jsdelivr.com/)
 
 For Node.js REPL:
 
@@ -100,29 +101,35 @@ Package sizes (brotli'd, pre-treeshake): ESM: 968 bytes
 
 [Generated API docs](https://docs.thi.ng/umbrella/leb128/)
 
-```ts
+```ts tangle:export/readme1.ts
 import * as leb from "@thi.ng/leb128";
 
 // if WASM is unavailable, the encode/decode functions will throw an error
-enc = leb.encodeULEB128(Number.MAX_SAFE_INTEGER);
+let encoded = leb.encodeULEB128(Number.MAX_SAFE_INTEGER);
+
+console.log(encoded);
 // Uint8Array [ 255, 255, 255, 255, 255, 255, 255, 15 ]
 
 // decoding returns tuple of [value (bigint), bytes consumed]
-leb.decodeULEB128(enc);
+console.log(leb.decodeULEB128(encoded));
 // [ 9007199254740991n, 8 ]
 
 // encode signed int
-enc = leb.encodeSLEB128(Number.MIN_SAFE_INTEGER);
+encoded = leb.encodeSLEB128(Number.MIN_SAFE_INTEGER);
+
+console.log(encoded)
 // Uint8Array [ 129, 128, 128, 128, 128, 128, 128, 112 ]
 
-leb.decodeSLEB128(enc);
+console.log(leb.decodeSLEB128(encoded));
 // [ -9007199254740991n, 8 ]
 
 // when writing into an existing buffer, there needs to be enough bytes to write the value
 const target = new Uint8Array(10);
 const count = leb.encodeULEB128Into(target, Number.MAX_SAFE_INTEGER);
+
 console.log(target);
 // Uint8Array [ 255, 255, 255, 255, 255, 255, 255, 15, 0, 0 ]
+
 console.log(count);
 // 8
 ```

package/index.d.ts

@@ -1,23 +1,23 @@
 /**
- * Encodes signed integer `x` into LEB128 varint format and returns
- * encoded bytes.
+ * Encodes signed integer `x` into LEB128 varint format and returns encoded
+ * bytes. Values will be coerced to i64 range prior to encoding.
  *
  * @param x -
  */
 export declare const encodeSLEB128: (x: bigint | number) => Uint8Array;
 /**
- * Takes Uint8Array with LEB128 encoded signed varint and an optional
- * start index to decode from. Returns 2-tuple of decoded value and
- * number of bytes consumed. Consumes up to 10 bytes from `src`.
+ * Takes an `Uint8Array` with LEB128 encoded signed varint and an optional start
+ * index to decode from. Returns 2-tuple of decoded value and number of bytes
+ * consumed. Consumes up to 10 bytes from `src`.
  *
  * @param src -
  * @param idx -
  */
 export declare const decodeSLEB128: (src: Uint8Array, idx?: number) => [bigint, number];
 /**
- * Takes a destination Uint8Array, a signed integer `x`, and an optional
- * position to encode an LEB128 formatted byte sequence into the destination.
- * Returns the number of bytes written.
+ * Takes a destination `Uint8Array`, a signed integer `x`, and an optional
+ * index/position to encode an LEB128 formatted byte sequence into the
+ * destination. Returns the number of bytes written.
  *
  * @remarks
  * Also see {@link encodeSLEB128}.
@@ -28,16 +28,16 @@ export declare const decodeSLEB128: (src: Uint8Array, idx?: number) => [bigint,
  */
 export declare const encodeSLEB128Into: (dst: Uint8Array, x: bigint | number, pos?: number) => number;
 /**
- * Encodes unsigned integer `x` into LEB128 varint format and returns
- * encoded bytes. Values < 0 will be encoded as zero.
+ * Encodes unsigned integer `x` into LEB128 varint format and returns encoded
+ * bytes. Values will be coerced to u64 range prior to encoding.
  *
  * @param x -
  */
 export declare const encodeULEB128: (x: bigint | number) => Uint8Array;
 /**
- * Takes Uint8Array with LEB128 encoded unsigned varint and an optional
- * start index to decode from. Returns 2-tuple of decoded value and
- * number of bytes consumed. Consumes up to 10 bytes from `src`.
+ * Takes an `Uint8Array` with LEB128 encoded unsigned varint and an optional
+ * start index to decode from. Returns 2-tuple of decoded value and number of
+ * bytes consumed. Consumes up to 10 bytes from `src`.
  *
  * @param src -
  * @param idx -

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/leb128",
-  "version": "3.0.88",
+  "version": "3.1.0",
   "description": "WASM based LEB128 encoder / decoder (signed & unsigned)",
   "type": "module",
   "module": "./index.js",
@@ -40,9 +40,9 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/checks": "^3.6.1",
-    "@thi.ng/errors": "^2.5.4",
-    "@thi.ng/transducers-binary": "^2.1.116"
+    "@thi.ng/checks": "^3.6.2",
+    "@thi.ng/errors": "^2.5.5",
+    "@thi.ng/transducers-binary": "^2.1.117"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.43.0",
@@ -85,5 +85,5 @@
     "alias": "leb",
     "year": 2019
   },
-  "gitHead": "fd7ab12d565809a2300783881c62b883dbd25c23\n"
+  "gitHead": "8339d05ecc857e529c7325a9839c0063b89e728d\n"
 }