@lvlte/ulp 1.0.0 → 1.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Eric Lavault (https://github.com/lvlte)
+Copyright (c) 2025 Eric Lavault <lvlte.code@gmail.com> (https://github.com/lvlte)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/cjs/index.d.ts

@@ -12,12 +12,14 @@ export declare const FLOAT64_MIN: number;
  */
 export declare function eps(x?: number): number;
 /**
- * Exponent of a normalized floating-point number x (`Math.log2()` not precise
- * enough for large numbers).
- *
- * NB. This function assumes `x` is a finite, strictly positive number.
+ * @borrows eps as ulp
+ */
+export declare const ulp: typeof eps;
+/**
+ * Exponent of a normalized floating-point number x.
  *
  * @param x The input number
- * @returns The largest integer `y` such that `2^y ≤ x`.
+ * @returns The largest integer `y` such that `2^y ≤ |x|`, or `NaN` if x is not
+ * a finite number / if x is ±0.
  */
 export declare function exponent(x: number): number;

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FLOAT64_MIN = void 0;
+exports.ulp = exports.FLOAT64_MIN = void 0;
 exports.eps = eps;
 exports.exponent = exponent;
 const modf_1 = require("@lvlte/modf");
@@ -11,11 +11,18 @@ function eps(x = 1) {
         if (x <= exports.FLOAT64_MIN) {
             return Number.MIN_VALUE;
         }
-        return Math.pow(2, (exponent(x) - 52));
+        return Math.pow(2, (_exponent(x) - 52));
     }
     return NaN;
 }
+exports.ulp = eps;
 function exponent(x) {
+    if (Number.isFinite(x) && x !== 0) {
+        return _exponent(Math.abs(x));
+    }
+    return NaN;
+}
+function _exponent(x) {
     const [ipart, fpart] = (0, modf_1.modf)(x);
     if (ipart > 0) {
         return ipart.toString(2).split('.', 1)[0].length - 1;

package/dist/index.d.ts

@@ -12,12 +12,14 @@ export declare const FLOAT64_MIN: number;
  */
 export declare function eps(x?: number): number;
 /**
- * Exponent of a normalized floating-point number x (`Math.log2()` not precise
- * enough for large numbers).
- *
- * NB. This function assumes `x` is a finite, strictly positive number.
+ * @borrows eps as ulp
+ */
+export declare const ulp: typeof eps;
+/**
+ * Exponent of a normalized floating-point number x.
  *
  * @param x The input number
- * @returns The largest integer `y` such that `2^y ≤ x`.
+ * @returns The largest integer `y` such that `2^y ≤ |x|`, or `NaN` if x is not
+ * a finite number / if x is ±0.
  */
 export declare function exponent(x: number): number;

package/dist/index.js

@@ -6,11 +6,18 @@ export function eps(x = 1) {
         if (x <= FLOAT64_MIN) {
             return Number.MIN_VALUE;
         }
-        return Math.pow(2, (exponent(x) - 52));
+        return Math.pow(2, (_exponent(x) - 52));
     }
     return NaN;
 }
+export const ulp = eps;
 export function exponent(x) {
+    if (Number.isFinite(x) && x !== 0) {
+        return _exponent(Math.abs(x));
+    }
+    return NaN;
+}
+function _exponent(x) {
     const [ipart, fpart] = modf(x);
     if (ipart > 0) {
         return ipart.toString(2).split('.', 1)[0].length - 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lvlte/ulp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Compute the unit in last place of a given IEEE-754 64-bit number",
   "license": "MIT",
   "author": "Eric Lavault <lvlte.code@gmail.com>",