@thi.ng/hex 2.3.22 → 2.3.24

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-12-03T12:13:31Z
+- **Last updated**: 2023-12-11T10:07:09Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -53,7 +53,7 @@ For Node.js REPL:
 const hex = await import("@thi.ng/hex");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 578 bytes
+Package sizes (brotli'd, pre-treeshake): ESM: 631 bytes
 
 ## Dependencies
 

package/index.js

@@ -1,191 +1,76 @@
-const P32 = 0x100000000;
-/**
- * Hex digits
- */
-export const HEX = "0123456789abcdef";
-/**
- * Returns 4bit uint as hex string
- *
- * @param x -
- */
-export const U4 = (x) => HEX[x & 0xf];
-/**
- * Returns 8bit uint as hex string
- *
- * @param x -
- */
-export const U8 = (x) => HEX[(x >>> 4) & 0xf] + HEX[x & 0xf];
-/**
- * Returns hex string of 8bit uint, read from given byte array at index `i`.
- *
- * @param x -
- * @param i -
- */
-export const U8A = (x, i) => U8(x[i]);
-/**
- * Returns 16bit uint as hex string
- *
- * @param x -
- */
-export const U16 = (x) => U8(x >>> 8) + U8(x & 0xff);
-/**
- * Returns hex string of 16bit uint, read in big-endian order from given byte
- * array at index `i`.
- *
- * @param x -
- * @param i -
- */
-export const U16BE = (x, i) => U8(x[i]) + U8(x[i + 1]);
-/**
- * Returns hex string of 16bit uint, read in litte-endian order from given byte
- * array at index `i`.
- *
- * @param x -
- * @param i -
- */
-export const U16LE = (x, i) => U8(x[i + 1]) + U8(x[i]);
-/**
- * Returns 24bit uint as hex string
- *
- * @param x -
- */
-export const U24 = (x) => U8(x >>> 16) + U16(x);
-/**
- * Returns hex string of 24bit uint, read in big-endian order from given byte
- * array at index `i`.
- *
- * @param x -
- * @param i -
- */
-export const U24BE = (x, i) => U8(x[i]) + U16BE(x, i + 1);
-/**
- * Returns hex string of 24bit uint, read in litte-endian order from given byte
- * array at index `i`.
- *
- * @param x -
- * @param i -
- */
-export const U24LE = (x, i) => U8(x[i + 2]) + U16LE(x, i);
-/**
- * Returns 32bit uint as hex string
- *
- * @param x -
- */
-export const U32 = (x) => U16(x >>> 16) + U16(x);
-/**
- * Returns hex string of 32bit uint, read in big-endian order from given byte
- * array at index `i`.
- *
- * @param x -
- * @param i -
- */
-export const U32BE = (x, i) => U16BE(x, i) + U16BE(x, i + 2);
-/**
- * Returns hex string of 32bit uint, read in litte-endian order from given byte
- * array at index `i`.
- *
- * @param x -
- * @param i -
- */
-export const U32LE = (x, i) => U16LE(x, i + 2) + U16LE(x, i);
-/**
- * Returns 48bit uint as hex string
- *
- * @param x -
- */
-export const U48 = (x) => U48HL(x / P32, x % P32);
-/**
- * Similar to {@link U48}, but takes the 64bit arg as 2x 32bit values.
- *
- * @param hi -
- * @param lo -
- */
-export const U48HL = (hi, lo) => U16(hi) + U32(lo);
-/**
- * Returns hex string of 48bit uint, read in big-endian order from given byte
- * array at index `i`.
- *
- * @param x -
- * @param i -
- */
-export const U48BE = (x, i) => U16BE(x, i) + U32BE(x, i + 2);
-/**
- * Returns hex string of 48bit uint, read in litte-endian order from given byte
- * array at index `i`.
- *
- * @param x -
- * @param i -
- */
-export const U48LE = (x, i) => U16LE(x, i + 4) + U32LE(x, i);
-/**
- * Returns 64bit uint as hex string.
- *
- * @remarks
- * Note: JS numbers are only integer precise up to `2**53 - 1`. Use
- * {@link U64BE} or {@link U64LE} for byte array based values (full 64bit range
- * supported). Alternatively, use `BigInt(x).toString(16)`.
- *
- * Also see {@link U64BIG} for `bigint` version.
- *
- * @param x -
- */
-export const U64 = (x) => U64HL(x / P32, x % P32);
-/**
- * Returns 64bit bigint as hex string.
- *
- * @param x
- */
-export const U64BIG = (x) => U64HL(Number(x >> BigInt(32)), Number(x & BigInt(P32 - 1)));
-/**
- * Similar to {@link U64}, but takes the 64bit arg as 2x 32bit values.
- *
- * @param hi -
- * @param lo -
- */
-export const U64HL = (hi, lo) => U32(hi) + U32(lo);
-/**
- * Returns hex string of 64bit uint, read in big-endian order from given byte
- * array at index `i`.
- *
- * @param x -
- * @param i -
- */
-export const U64BE = (x, i) => U32BE(x, i) + U32BE(x, i + 4);
-/**
- * Returns hex string of 64bit uint, read in litte-endian order from given byte
- * array at index `i`.
- *
- * @param x -
- * @param i -
- */
-export const U64LE = (x, i) => U32LE(x, i + 4) + U32LE(x, i);
-/**
- * Returns UUID formatted string of given byte array from optional start index
- * `i` (default: 0). Array must have min. length 16 (starting from `i`).
- *
- * @param id -
- * @param i -
- */
-export const uuid = (id, i = 0) => 
-// prettier-ignore
-`${U32BE(id, i)}-${U16BE(id, i + 4)}-${U16BE(id, i + 6)}-${U16BE(id, i + 8)}-${U48BE(id, i + 10)}`;
-export const hexdump = (bytes, addr, len, width, ascii) => hexdumpLines(bytes, addr, len, width, ascii).join("\n");
-export const hexdumpLines = (bytes, addr, len, width = 16, ascii = true) => {
-    len = Math.min(len, bytes.length - addr);
-    let res = [];
-    while (len > 0) {
-        const row = [...bytes.subarray(addr, addr + Math.min(len, width))];
-        const pad = len < width && ascii ? new Array(width - len).fill("  ") : [];
-        res.push([
-            U32(addr),
-            ...row.map(U8),
-            ...pad,
-            row
-                .map((x) => x >= 0x20 && x < 0x80 ? String.fromCharCode(x) : ".")
-                .join(""),
-        ].join(" "));
-        addr += width;
-        len -= width;
-    }
-    return res;
+const P32 = 4294967296;
+const HEX = "0123456789abcdef";
+const U4 = (x) => HEX[x & 15];
+const U8 = (x) => HEX[x >>> 4 & 15] + HEX[x & 15];
+const U8A = (x, i) => U8(x[i]);
+const U16 = (x) => U8(x >>> 8) + U8(x & 255);
+const U16BE = (x, i) => U8(x[i]) + U8(x[i + 1]);
+const U16LE = (x, i) => U8(x[i + 1]) + U8(x[i]);
+const U24 = (x) => U8(x >>> 16) + U16(x);
+const U24BE = (x, i) => U8(x[i]) + U16BE(x, i + 1);
+const U24LE = (x, i) => U8(x[i + 2]) + U16LE(x, i);
+const U32 = (x) => U16(x >>> 16) + U16(x);
+const U32BE = (x, i) => U16BE(x, i) + U16BE(x, i + 2);
+const U32LE = (x, i) => U16LE(x, i + 2) + U16LE(x, i);
+const U48 = (x) => U48HL(x / P32, x % P32);
+const U48HL = (hi, lo) => U16(hi) + U32(lo);
+const U48BE = (x, i) => U16BE(x, i) + U32BE(x, i + 2);
+const U48LE = (x, i) => U16LE(x, i + 4) + U32LE(x, i);
+const U64 = (x) => U64HL(x / P32, x % P32);
+const U64BIG = (x) => U64HL(Number(x >> BigInt(32)), Number(x & BigInt(P32 - 1)));
+const U64HL = (hi, lo) => U32(hi) + U32(lo);
+const U64BE = (x, i) => U32BE(x, i) + U32BE(x, i + 4);
+const U64LE = (x, i) => U32LE(x, i + 4) + U32LE(x, i);
+const uuid = (id, i = 0) => (
+  // prettier-ignore
+  `${U32BE(id, i)}-${U16BE(id, i + 4)}-${U16BE(id, i + 6)}-${U16BE(id, i + 8)}-${U48BE(id, i + 10)}`
+);
+const hexdump = (bytes, addr, len, width, ascii) => hexdumpLines(bytes, addr, len, width, ascii).join("\n");
+const hexdumpLines = (bytes, addr, len, width = 16, ascii = true) => {
+  len = Math.min(len, bytes.length - addr);
+  let res = [];
+  while (len > 0) {
+    const row = [...bytes.subarray(addr, addr + Math.min(len, width))];
+    const pad = len < width && ascii ? new Array(width - len).fill("  ") : [];
+    res.push(
+      [
+        U32(addr),
+        ...row.map(U8),
+        ...pad,
+        row.map(
+          (x) => x >= 32 && x < 128 ? String.fromCharCode(x) : "."
+        ).join("")
+      ].join(" ")
+    );
+    addr += width;
+    len -= width;
+  }
+  return res;
+};
+export {
+  HEX,
+  U16,
+  U16BE,
+  U16LE,
+  U24,
+  U24BE,
+  U24LE,
+  U32,
+  U32BE,
+  U32LE,
+  U4,
+  U48,
+  U48BE,
+  U48HL,
+  U48LE,
+  U64,
+  U64BE,
+  U64BIG,
+  U64HL,
+  U64LE,
+  U8,
+  U8A,
+  hexdump,
+  hexdumpLines,
+  uuid
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/hex",
-  "version": "2.3.22",
+  "version": "2.3.24",
   "description": "Hex string formatters for 4/8/16/24/32/48/64bit words",
   "type": "module",
   "module": "./index.js",
@@ -24,7 +24,9 @@
   "author": "Karsten Schmidt (https://thi.ng)",
   "license": "Apache-2.0",
   "scripts": {
-    "build": "yarn clean && tsc --declaration",
+    "build": "yarn build:esbuild && yarn build:decl",
+    "build:decl": "tsc --declaration --emitDeclarationOnly",
+    "build:esbuild": "esbuild --format=esm --platform=neutral --target=es2022 --tsconfig=tsconfig.json --outdir=. src/**/*.ts",
     "clean": "rimraf --glob '*.js' '*.d.ts' '*.map' doc",
     "doc": "typedoc --excludePrivate --excludeInternal --out doc src/index.ts",
     "doc:ae": "mkdir -p .ae/doc .ae/temp && api-extractor run --local --verbose",
@@ -34,7 +36,7 @@
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.38.3",
-    "@thi.ng/testament": "^0.4.3",
+    "esbuild": "^0.19.8",
     "rimraf": "^5.0.5",
     "tools": "^0.0.1",
     "typedoc": "^0.25.4",
@@ -68,5 +70,5 @@
     ],
     "year": 2020
   },
-  "gitHead": "04d1de79f256d7a53c6b5fd157b37f49bc88e11d\n"
+  "gitHead": "5e7bafedfc3d53bc131469a28de31dd8e5b4a3ff\n"
 }