nhb-toolbox 4.12.69 → 4.12.70

package/CHANGELOG.md

@@ -6,6 +6,14 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.12.70] - 2025-07-08
+
+- **Updated** numeric string related issues, specifically in `isNumber` & `isNumericString` and other helper functions.
+
+## [4.12.68-69] - 2025-07-05
+
+- **Updated Docs:** Added links to other npm packages.
+
 ## [4.12.67] - 2025-07-03
 
 - **Fixed** some import alias typo.

package/dist/cjs/guards/primitives.js

@@ -15,12 +15,12 @@ exports.isNonEmptyString = isNonEmptyString;
 exports.isFalsy = isFalsy;
 exports.isTruthy = isTruthy;
 /**
- * * Type guard to check if a value is a number.
- * @param value - The value to check.
- * @returns `true` if the value is a number, otherwise `false`.
+ * * Type guard to check whether a value is a finite number (excluding `NaN` and `Infinity`).
+ * @param value - The value to test.
+ * @returns `true` if the value is a finite number; otherwise `false`.
  */
 function isNumber(value) {
-    return typeof value === 'number' && !isNaN(value);
+    return typeof value === 'number' && Number.isFinite(value);
 }
 /**
  * * Type guard to check if a value is a string.

package/dist/cjs/guards/specials.js

@@ -107,16 +107,22 @@ function isIPAddress(value) {
 /**
  * * Type guard to check if the current environment matches a given string.
  * @param env - The expected environment (e.g., "production", "development").
- * @returns `true` if the current environment matches, otherwise `false`.
+ * @returns `true` if the value is a numeric string parsable by `Number()`, otherwise `false`.
  */
 function isEnvironment(env) {
     return process.env.NODE_ENV === env;
 }
 /**
- * * Type guard to check if a value is a numeric string.
- * @param value - The value to check.
- * @returns `true` if the value is a numeric string, otherwise `false`.
+ * * Type guard to check if a value is a string representing a finite number.
+ *
+ * Accepts strings like: `"42"`, `"  -5.5 "`, `"0.123"`, `"-0"`, `"1e5"`.
+ * Rejects strings like: `"NaN"`, `"Infinity"`, `"-Infinity"`, `"abc"`, `""`, `"42abc"`.
+ *
+ * @param value - The value to test.
+ * @returns `true` if the value is a string that fully represents a finite number.
  */
 function isNumericString(value) {
-    return (0, primitives_1.isString)(value) && /^\d+(\.\d+)?$/.test(value);
+    return ((0, primitives_1.isString)(value) &&
+        value?.trim() !== '' &&
+        Number.isFinite(Number(value)));
 }

package/dist/dts/guards/primitives.d.ts

@@ -1,8 +1,8 @@
 import type { FalsyPrimitive, NormalPrimitive, Primitive } from '../types/index';
 /**
- * * Type guard to check if a value is a number.
- * @param value - The value to check.
- * @returns `true` if the value is a number, otherwise `false`.
+ * * Type guard to check whether a value is a finite number (excluding `NaN` and `Infinity`).
+ * @param value - The value to test.
+ * @returns `true` if the value is a finite number; otherwise `false`.
  */
 export declare function isNumber(value: unknown): value is number;
 /**

package/dist/dts/guards/specials.d.ts

@@ -59,13 +59,17 @@ export declare function isIPAddress(value: unknown): value is string;
 /**
  * * Type guard to check if the current environment matches a given string.
  * @param env - The expected environment (e.g., "production", "development").
- * @returns `true` if the current environment matches, otherwise `false`.
+ * @returns `true` if the value is a numeric string parsable by `Number()`, otherwise `false`.
  */
 export declare function isEnvironment(env: string): boolean;
 /**
- * * Type guard to check if a value is a numeric string.
- * @param value - The value to check.
- * @returns `true` if the value is a numeric string, otherwise `false`.
+ * * Type guard to check if a value is a string representing a finite number.
+ *
+ * Accepts strings like: `"42"`, `"  -5.5 "`, `"0.123"`, `"-0"`, `"1e5"`.
+ * Rejects strings like: `"NaN"`, `"Infinity"`, `"-Infinity"`, `"abc"`, `""`, `"42abc"`.
+ *
+ * @param value - The value to test.
+ * @returns `true` if the value is a string that fully represents a finite number.
  */
 export declare function isNumericString(value: unknown): value is `${number}`;
 //# sourceMappingURL=specials.d.ts.map

package/dist/dts/guards/specials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"specials.d.ts","sourceRoot":"","sources":["../../../src/guards/specials.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAKvD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOtD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;GAGG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAMhC;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOrD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOxD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,MAAM,EAAE,CAEpE"}
+{"version":3,"file":"specials.d.ts","sourceRoot":"","sources":["../../../src/guards/specials.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAKvD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOtD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;GAGG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAMhC;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOrD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOxD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,MAAM,EAAE,CAMpE"}

package/dist/esm/guards/primitives.js

@@ -1,10 +1,10 @@
 /**
- * * Type guard to check if a value is a number.
- * @param value - The value to check.
- * @returns `true` if the value is a number, otherwise `false`.
+ * * Type guard to check whether a value is a finite number (excluding `NaN` and `Infinity`).
+ * @param value - The value to test.
+ * @returns `true` if the value is a finite number; otherwise `false`.
  */
 export function isNumber(value) {
-    return typeof value === 'number' && !isNaN(value);
+    return typeof value === 'number' && Number.isFinite(value);
 }
 /**
  * * Type guard to check if a value is a string.

package/dist/esm/guards/specials.js

@@ -93,16 +93,22 @@ export function isIPAddress(value) {
 /**
  * * Type guard to check if the current environment matches a given string.
  * @param env - The expected environment (e.g., "production", "development").
- * @returns `true` if the current environment matches, otherwise `false`.
+ * @returns `true` if the value is a numeric string parsable by `Number()`, otherwise `false`.
  */
 export function isEnvironment(env) {
     return process.env.NODE_ENV === env;
 }
 /**
- * * Type guard to check if a value is a numeric string.
- * @param value - The value to check.
- * @returns `true` if the value is a numeric string, otherwise `false`.
+ * * Type guard to check if a value is a string representing a finite number.
+ *
+ * Accepts strings like: `"42"`, `"  -5.5 "`, `"0.123"`, `"-0"`, `"1e5"`.
+ * Rejects strings like: `"NaN"`, `"Infinity"`, `"-Infinity"`, `"abc"`, `""`, `"42abc"`.
+ *
+ * @param value - The value to test.
+ * @returns `true` if the value is a string that fully represents a finite number.
  */
 export function isNumericString(value) {
-    return isString(value) && /^\d+(\.\d+)?$/.test(value);
+    return (isString(value) &&
+        value?.trim() !== '' &&
+        Number.isFinite(Number(value)));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.12.69",
+  "version": "4.12.70",
   "description": "A versatile collection of smart, efficient, and reusable utility functions and classes for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -52,7 +52,7 @@
     "globals": "^16.2.0",
     "globby": "^14.1.0",
     "jest": "^29.7.0",
-    "nhb-scripts": "^1.2.6",
+    "nhb-scripts": "^1.3.4",
     "prettier": "^3.5.3",
     "progress-estimator": "^0.3.1",
     "rimraf": "^6.0.1",
@@ -247,6 +247,7 @@
     "lint": "node scripts/lint.mjs",
     "fix": "node scripts/fix.mjs",
     "commit": "nhb-commit",
+    "module": "nhb-module",
     "count": "nhb-count",
     "types": "node scripts/types.mjs"
   }