@gsknnft/bigint-buffer 1.4.3 → 1.4.5

package/package.json

@@ -1,132 +1,132 @@
-{
-  "name": "@gsknnft/bigint-buffer",
-  "version": "1.4.3",
-  "description": "bigint to buffer conversion with native support and built-in conversion helpers",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
-  "browser": "dist/browser.js",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./conversion": {
-      "types": "./dist/conversion/index.d.ts",
-      "import": "./dist/conversion/index.js",
-      "require": "./dist/conversion/index.cjs"
-    }
-  },
-  "files": [
-    "dist/",
-    "helper/",
-    "src/",
-    "binding.gyp",
-    "build/",
-    "README.md",
-    "LICENSE"
-  ],
-  "workspaces": [],
-  "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest watch",
-    "coverage": "vitest cover ./test/index.js",
-    "lint": "eslint . --ext .ts,.js",
-    "install": "node-gyp rebuild",
-    "prepublishOnly": "rm -rf build/Makefile; rm build/gyp-*; rm build/*.mk; rm build/*.Makefile; rm *.tgz",
-    "clean:js": "npm clean && rm -rf build/* dist/*",
-    "test:browser": "vite test --browser",
-    "test:node": "mocha build/src/**/*.spec.js --timeout 40000",
-    "declare": "tsc -p . --declaration --emitDeclarationOnly --outDir dist/types",
-    "benchmark": "node -r ts-node/register src/index.bench.ts",
-    "typedoc": "typedoc --out docs $(pwd)/src $(pwd)/helper --target es6 --mode file --tsconfig ./tsconfig.json --excludePrivate --excludeProtected --excludeNotExported --exclude '**/*+(spec|bench).ts'",
-    "rebuild:native": "node-gyp rebuild",
-    "build": "vite build && npm run declare && tsc -p . && cpy \"index.d.ts\" ../dist --cwd dist/types && cpy \"conversion/index.d.ts\" ../dist/conversion --cwd dist/types",
-    "compile": "vite build && npm run declare && tsc -p . && cpy \"index.d.ts\" ../dist/types --cwd dist/types && cpy \"conversion/index.d.ts\" ../dist/conversion --cwd dist/types",
-    "check": "eslint src/**/*.ts src/conversion/**/*.ts src/index.spec.ts src/conversion/test/**/*.ts",
-    "test:vitest": "vitest",
-    "test:all": "npm run test && npm run benchmark",
-    "clean": "rm -rf build/* dist/* node_modules package-lock.json pnpm-lock.yaml",
-    "fix": "eslint . --ext .ts,.js --fix && prettier --write .",
-    "pretest": "npm run compile",
-    "posttest": "npm run check"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/gsknnft/bigint-buffer.git"
-  },
-  "bugs": {
-    "url": "https://github.com/gsknnft/bigint-buffer/issues"
-  },
-  "homepage": "https://github.com/gsknnft/bigintbuffer",
-  "keywords": [
-    "bigint",
-    "bignum",
-    "tc39-bigint",
-    "napi"
-  ],
-  "license": "Apache-2.0",
-  "pnpm": {
-    "overrides": {
-      "tmp": "0.2.5"
-    }
-  },
-  "optionalDependencies": {
-    "bindings": "^1.5.0"
-  },
-  "devDependencies": {
-    "@rollup/plugin-commonjs": "^29.0.0",
-    "@rollup/plugin-esm-shim": "0.1.8",
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-replace": "6.0.3",
-    "@rollup/plugin-typescript": "^12.1.4",
-    "rollup-plugin-polyfill-node": "^0.13.0",
-    "@types/benchmark": "^2.1.5",
-    "@types/bn.js": "^5.2.0",
-    "@types/chai": "^5.2.3",
-    "@types/mocha": "^10.0.10",
-    "@types/node": "^24.10.1",
-    "@vitest/coverage-v8": "4.0.14",
-    "assertion-error": "^2.0.1",
-    "benchmark": "^2.1.4",
-    "bindings": "1.5.0",
-    "bn.js": "^5.2.2",
-    "cpy-cli": "^6.0.0",
-    "cross-env": "^10.1.0",
-    "eslint": "^9.39.1",
-    "globals": "^16.5.0",
-    "jiti": "^2.6.1",
-    "karma": "^6.4.4",
-    "karma-chrome-launcher": "^3.2.0",
-    "karma-env-preprocessor": "^0.1.1",
-    "karma-mocha": "^2.0.1",
-    "karma-mocha-reporter": "^2.2.5",
-    "karma-webpack": "^5.0.1",
-    "microtime": "^3.0.0",
-    "mkdirp": "^3.0.1",
-    "prettier": "^3.2.2",
-    "rollup": "^4.53.3",
-    "ts-loader": "^9.5.4",
-    "ts-node": "^10.9.2",
-    "typedoc": "^0.28.14",
-    "typescript": "5.9.3",
-    "typescript-eslint": "^8.48.0",
-    "undici-types": "^7.16.0",
-    "vite": "7.2.4",
-    "vitest": "^4.0.14",
-    "webpack": "5.103.0",
-    "webpack-cli": "6.0.1"
-  },
-  "engines": {
-    "node": ">=18.0.0",
-    "npm": ">=9.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "contributors": [
-    "Gordon Skinner <gsknnft@gmail.com> (https://github.com/gsknnft)",
-    "Michael Wei <mwei@vmware.com> (https://github.com/no2chem)"
-  ]
-}
+{
+  "name": "@gsknnft/bigint-buffer",
+  "version": "1.4.5",
+  "description": "bigint to buffer conversion with native support and built-in conversion helpers",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "browser": "dist/browser.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./conversion": {
+      "types": "./dist/conversion/index.d.ts",
+      "import": "./dist/conversion/index.js",
+      "require": "./dist/conversion/index.cjs"
+    }
+  },
+  "files": [
+    "dist/",
+    "helper/",
+    "src/",
+    "binding.gyp",
+    "build/",
+    "README.md",
+    "LICENSE"
+  ],
+  "workspaces": [],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "coverage": "vitest cover ./test/index.js",
+    "lint": "eslint . --ext .ts,.js",
+    "prepublishOnly": "rm -rf build/Makefile; rm build/gyp-*; rm build/*.mk; rm build/*.Makefile; rm *.tgz",
+    "clean:js": "npm clean && rm -rf build/* dist/*",
+    "test:browser": "vite test --browser",
+    "test:node": "vitest run",
+    "postinstall": "node-gyp rebuild",
+    "declare": "tsc -p . --declaration --emitDeclarationOnly --outDir dist/types",
+    "benchmark": "node -r ts-node/register src/index.bench.ts",
+    "typedoc": "typedoc --out docs $(pwd)/src $(pwd)/helper --target es6 --mode file --tsconfig ./tsconfig.json --excludePrivate --excludeProtected --excludeNotExported --exclude '**/*+(spec|bench).ts'",
+    "rebuild": "node-gyp rebuild && npm run build",
+    "build": "vite build && npm run declare && tsc -p . && cpy \"index.d.ts\" ../dist --cwd dist/types && cpy \"conversion/index.d.ts\" ../dist/conversion --cwd dist/types",
+    "compile": "vite build && npm run declare && tsc -p . && cpy \"index.d.ts\" ../dist/types --cwd dist/types && cpy \"conversion/index.d.ts\" ../dist/conversion --cwd dist/types",
+    "check": "eslint src/**/*.ts src/conversion/**/*.ts src/index.spec.ts src/conversion/test/**/*.ts",
+    "test:vitest": "vitest",
+    "test:all": "npm run test && npm run benchmark",
+    "clean": "rm -rf build/* dist/* node_modules package-lock.json pnpm-lock.yaml",
+    "fix": "eslint . --ext .ts,.js --fix && prettier --write .",
+    "pretest": "npm run compile",
+    "posttest": "npm run check"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gsknnft/bigint-buffer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/gsknnft/bigint-buffer/issues"
+  },
+  "homepage": "https://github.com/gsknnft/bigintbuffer",
+  "keywords": [
+    "bigint",
+    "bignum",
+    "tc39-bigint",
+    "napi"
+  ],
+  "license": "Apache-2.0",
+  "pnpm": {
+    "overrides": {
+      "tmp": "0.2.5"
+    }
+  },
+  "dependencies": {
+    "bindings": "^1.5.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-esm-shim": "0.1.8",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-replace": "6.0.3",
+    "@rollup/plugin-typescript": "^12.1.4",
+    "rollup-plugin-polyfill-node": "^0.13.0",
+    "@types/benchmark": "^2.1.5",
+    "@types/bn.js": "^5.2.0",
+    "@types/chai": "^5.2.3",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^24.10.1",
+    "@vitest/coverage-v8": "4.0.14",
+    "assertion-error": "^2.0.1",
+    "benchmark": "^2.1.4",
+    "bindings": "1.5.0",
+    "bn.js": "^5.2.2",
+    "cpy-cli": "^6.0.0",
+    "cross-env": "^10.1.0",
+    "eslint": "^9.39.1",
+    "globals": "^16.5.0",
+    "jiti": "^2.6.1",
+    "karma": "^6.4.4",
+    "karma-chrome-launcher": "^3.2.0",
+    "karma-env-preprocessor": "^0.1.1",
+    "karma-mocha": "^2.0.1",
+    "karma-mocha-reporter": "^2.2.5",
+    "karma-webpack": "^5.0.1",
+    "microtime": "^3.0.0",
+    "mkdirp": "^3.0.1",
+    "prettier": "^3.2.2",
+    "rollup": "^4.53.3",
+    "ts-loader": "^9.5.4",
+    "ts-node": "^10.9.2",
+    "typedoc": "^0.28.14",
+    "typescript": "5.9.3",
+    "typescript-eslint": "^8.48.0",
+    "undici-types": "^7.16.0",
+    "vite": "7.2.4",
+    "vitest": "^4.0.14",
+    "webpack": "5.103.0",
+    "webpack-cli": "6.0.1"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "npm": ">=9.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "contributors": [
+    "Gordon Skinner <gsknnft@gmail.com> (https://github.com/gsknnft)",
+    "Michael Wei <mwei@vmware.com> (https://github.com/no2chem)"
+  ]
+}

package/src/conversion/docs/README.md

@@ -2,7 +2,7 @@
 
 ***
 
-# bigint-conversion
+# bigint-conversion (v1.4.5)
 
 ## Type Aliases
 
@@ -32,3 +32,11 @@
 - [toBufferBE](functions/toBufferBE.md)
 - [toBufferLE](functions/toBufferLE.md)
 - [validateBigIntBuffer](functions/validateBigIntBuffer.md)
+- **New in 1.4.5:**
+	- [toFixedPoint](../src/ts/fixedPoint/index.ts)
+	- [fromFixedPoint](../src/ts/fixedPoint/index.ts)
+	- [addFixedPoint](../src/ts/fixedPoint/index.ts)
+	- [subtractFixedPoint](../src/ts/fixedPoint/index.ts)
+	- [averageFixedPoint](../src/ts/fixedPoint/index.ts)
+	- [compareFixedPoint](../src/ts/fixedPoint/index.ts)
+	- [FixedPoint type](../src/ts/fixedPoint/index.ts)

package/src/conversion/src/docs/index.md

@@ -3,7 +3,7 @@
 [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
 {{GITHUB_ACTIONS_BADGES}}
 
-# {{PKG_NAME}}
+# {{PKG_NAME}} v1.4.5
 
 Convert to/from non-negative integers represented with [ES-2020 native JS implementation of BigInt](https://tc39.es/ecma262/#sec-bigint-objects) from/to:
 
@@ -14,6 +14,11 @@ Convert to/from non-negative integers represented with [ES-2020 native JS implem
 
 It provides a common interface for the conversions that works for both **node.js** and **native javascript**.
 
+**New in 1.4.5:**
+- FixedPoint utilities for high-precision math and conversions
+- Native bindings included in `build/Release/` out of the box
+- Improved JS fallback for environments without native support
+
 > Note that there is not a directly visible `TypedArray()` constructor, but a set of typed array ones: `Int8Array()`, `Uint8Array()`, `Uint8ClampedArray()`, `Int16Array()`, `Uint16Array()`, `Int32Array()`, `Uint32Array()`, `Float32Array()`, `Float64Array()`, `BigInt64Array()`, `BigUint64Array()`.
 
 ## Usage

package/src/conversion/src/ts/fixedPoint/index.ts

@@ -0,0 +1,87 @@
+import { bigintToHex, hexToBigint } from "#pkg";
+
+export type FixedPoint = string;
+
+export const FIXED_POINT_DECIMALS = 9;
+export const FIXED_POINT_PATTERN = /^-?0x[0-9a-f]+$/i;
+export const ZERO_FIXED_POINT: FixedPoint = '0x0';
+
+const normalizeHex = (value: string): string =>
+  value.startsWith('0x') || value.startsWith('0X') ? value : `0x${value}`;
+
+const toHexString = (value: bigint): FixedPoint => {
+  if (value === 0n) {
+    return ZERO_FIXED_POINT;
+  }
+  const isNegative = value < 0n;
+  const absValue = isNegative ? -value : value;
+  const hexValue = bigintToHex(absValue);
+  return `${isNegative ? '-' : ''}0x${hexValue}`;
+};
+
+export const toBigIntValue = (value?: FixedPoint): bigint => {
+  if (!value) {
+    return 0n;
+  }
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    return 0n;
+  }
+  const isNegative = trimmed.startsWith('-');
+  const body = isNegative ? trimmed.slice(1) : trimmed;
+  const normalized = normalizeHex(body);
+  const bigValue = hexToBigint(normalized);
+  return isNegative ? -bigValue : bigValue;
+};
+
+export function toFixedPoint(
+  value: number,
+  decimals: number = FIXED_POINT_DECIMALS,
+): FixedPoint {
+  if (!Number.isFinite(value)) {
+    return ZERO_FIXED_POINT;
+  }
+  const scale = Math.pow(10, decimals);
+  const scaled = BigInt(Math.round(value * scale));
+  return toHexString(scaled);
+}
+
+export function fromFixedPoint(
+  value?: FixedPoint,
+  decimals: number = FIXED_POINT_DECIMALS,
+): number {
+  const bigValue = toBigIntValue(value);
+  if (bigValue === 0n) {
+    return 0;
+  }
+  const scale = Math.pow(10, decimals);
+  return Number(bigValue) / scale;
+}
+
+export function addFixedPoint(a: FixedPoint, b: FixedPoint): FixedPoint {
+  return toHexString(toBigIntValue(a) + toBigIntValue(b));
+}
+
+export function subtractFixedPoint(a: FixedPoint, b: FixedPoint): FixedPoint {
+  return toHexString(toBigIntValue(a) - toBigIntValue(b));
+}
+
+export function averageFixedPoint(values: FixedPoint[]): FixedPoint {
+  if (values.length === 0) {
+    return ZERO_FIXED_POINT;
+  }
+  const sum = values.reduce((acc, value) => acc + toBigIntValue(value), 0n);
+  return toHexString(sum / BigInt(values.length));
+}
+
+export function compareFixedPoint(a: FixedPoint, b: FixedPoint): number {
+  const diff = toBigIntValue(a) - toBigIntValue(b);
+  if (diff === 0n) {
+    return 0;
+  }
+  return diff > 0n ? 1 : -1;
+}
+
+export function fixedPointToBigInt(value?: FixedPoint): bigint {
+  return toBigIntValue(value);
+}

package/src/conversion/src/ts/index.ts

@@ -2,6 +2,21 @@ import { Buffer } from 'buffer';
 import path from 'path';
 import fs from 'fs';
 
+export {
+  toFixedPoint,
+  fromFixedPoint,
+  addFixedPoint,
+  subtractFixedPoint,
+  averageFixedPoint,
+  compareFixedPoint,
+  type FixedPoint,
+  FIXED_POINT_DECIMALS,
+  ZERO_FIXED_POINT,
+  fixedPointToBigInt,
+  toBigIntValue,
+} from './fixedPoint'
+
+
 interface ConverterInterface {
   toBigInt: (buf: Buffer, bigEndian?: boolean) => bigint;
   fromBigInt: (num: bigint, buf: Buffer, bigEndian?: boolean) => Buffer;