@alwatr/is-number 5.5.0 → 5.6.1

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [5.6.1](https://github.com/Alwatr/nanolib/compare/@alwatr/is-number@5.6.0...@alwatr/is-number@5.6.1) (2025-04-01)
+
+**Note:** Version bump only for package @alwatr/is-number
+
+## [5.6.0](https://github.com/Alwatr/nanolib/compare/@alwatr/is-number@5.5.0...@alwatr/is-number@5.6.0) (2025-03-18)
+
+### Features
+
+* **is-number:** add polyfill for Number.isFinite to check finite numbers ([27c60b1](https://github.com/Alwatr/nanolib/commit/27c60b16e69e87fd62dee25ee21012651b9ba7ca)) by @alimd
+* **is-number:** add toNumber function to convert various values to numbers ([3f4a9d1](https://github.com/Alwatr/nanolib/commit/3f4a9d1d316ba685c47cafdee031e231ef0d40c5)) by @alimd
+
+### Code Refactoring
+
+* **is-number:** enhance isNumber function to handle additional cases and improve documentation ([16f16b4](https://github.com/Alwatr/nanolib/commit/16f16b41c487f874f94dd64aaa778c618879db82)) by @alimd
+
 ## [5.5.0](https://github.com/Alwatr/nanolib/compare/@alwatr/is-number@5.4.0...@alwatr/is-number@5.5.0) (2025-03-06)
 
 ### Miscellaneous Chores

package/README.md

@@ -1,35 +1,68 @@
 # is-number
 
-A simple utility to Check the value is number or can convert to a number, for example string ' 123 ' can be converted to 123.
+A lightweight, high-performance utility to check if a value is a number or can be converted to a number.
 
 ## Installation
 
 ```bash
 yarn add @alwatr/is-number
+# or
+npm install @alwatr/is-number
 ```
 
 ## Usage
 
 ```typescript
-import {isNumber} from '@alwatr/is-number';
-
-isNumber('1'); // true
+import {isNumber, toNumber, isFiniteNumber} from '@alwatr/is-number';
+
+// Check if a value is a number
+isNumber(123);       // true
+isNumber('123');     // true
+isNumber('abc');     // false
+
+// Convert a value to a number if possible
+toNumber(123);       // 123
+toNumber('123');     // 123 
+toNumber('abc');     // null
+
+// Check if a value is a finite number (without type coercion)
+isFiniteNumber(123); // true
+isFiniteNumber(Infinity); // false
+isFiniteNumber('123'); // false (no coercion)
 ```
 
+## API
+
+### isNumber(value: unknown): boolean
+
+Checks if the value is a number or can be converted to a number.
+
+### toNumber(value: unknown): number | null
+
+Converts the value to a number if possible, otherwise returns `null`.
+
+### isFiniteNumber(value: unknown): boolean
+
+A cross-browser polyfill for `Number.isFinite`. Unlike the global `isFinite`,
+this doesn't coerce values to numbers before checking.
+
 ## Why is this needed?
 
+JavaScript type behavior can be confusing. This library helps to simplify number validation:
+
 ```ts
-console.log(typeof '123'); //=> 'string'
-console.log(+[]); //=> 0
-console.log(+''); //=> 0
-console.log(+'   '); //=> 0
-console.log(typeof NaN); //=> 'number'
-console.log(typeof Infinity); //=> 'number'
+console.log(typeof '123');     // 'string'
+console.log(+[]);              // 0
+console.log(+'');              // 0
+console.log(+'   ');           // 0
+console.log(typeof NaN);       // 'number'
+console.log(typeof Infinity);  // 'number'
 ```
 
-### True
+### isNumber Examples
+
+#### Returns `true`
 
-<!-- prettier-ignore -->
 ```ts
 isNumber(5e3);               // true
 isNumber(0xff);              // true
@@ -44,13 +77,11 @@ isNumber('1');               // true
 isNumber('1.1');             // true
 isNumber('5e3');             // true
 isNumber('012');             // true
-isNumber(parseInt('012'));   // true
-isNumber(parseFloat('012')); // true
+isNumber(' 123 ');           // true
 ```
 
-### False
+#### Returns `false`
 
-<!-- prettier-ignore -->
 ```ts
 isNumber(Infinity);          // false
 isNumber(NaN);               // false
@@ -59,12 +90,47 @@ isNumber(undefined);         // false
 isNumber('');                // false
 isNumber('   ');             // false
 isNumber('foo');             // false
+isNumber('123foo');          // false
 isNumber([1]);               // false
 isNumber([]);                // false
 isNumber(function () {});    // false
 isNumber({});                // false
 ```
 
+### toNumber Examples
+
+#### Returns a number
+
+```ts
+toNumber(5e3);               // 5000
+toNumber(0xff);              // 255
+toNumber(-1.1);              // -1.1
+toNumber(0);                 // 0
+toNumber(1);                 // 1
+toNumber('-1.1');            // -1.1
+toNumber('0');               // 0
+toNumber('0xff');            // 255
+toNumber('5e3');             // 5000
+toNumber(' 123 ');           // 123
+```
+
+#### Returns `null`
+
+```ts
+toNumber(Infinity);          // null
+toNumber(NaN);               // null
+toNumber(null);              // null
+toNumber(undefined);         // null
+toNumber('');                // null
+toNumber('   ');             // null
+toNumber('foo');             // null
+toNumber('123foo');          // null
+toNumber([1]);               // null
+toNumber([]);                // null
+toNumber(function () {});    // null
+toNumber({});                // null
+```
+
 ## Sponsors
 
 The following companies, organizations, and individuals support Nanolib ongoing maintenance and development. Become a Sponsor to get your logo on our README and website.

package/dist/main.cjs

@@ -1,4 +1,4 @@
-/* @alwatr/is-number v5.5.0 */
+/* @alwatr/is-number v5.6.1 */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -21,22 +21,47 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/main.ts
 var main_exports = {};
 __export(main_exports, {
-  isNumber: () => isNumber
+  isFiniteNumber: () => isFiniteNumber,
+  isNumber: () => isNumber,
+  toNumber: () => toNumber
 });
 module.exports = __toCommonJS(main_exports);
 var import_package_tracer = require("@alwatr/package-tracer");
-__dev_mode__: import_package_tracer.packageTracer.add("@alwatr/is-number", "5.5.0");
+__dev_mode__: import_package_tracer.packageTracer.add("@alwatr/is-number", "5.6.1");
+function isFiniteNumber(value) {
+  if (typeof Number.isFinite === "function") {
+    return Number.isFinite(value);
+  }
+  return typeof value === "number" && isFinite(value);
+}
 function isNumber(value) {
   if (typeof value === "number") {
     return value - value === 0;
   }
-  if (typeof value === "string" && value.trim() !== "") {
-    return Number.isFinite ? Number.isFinite(+value) : isFinite(+value);
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed === "") return false;
+    const num = +trimmed;
+    return isFiniteNumber(num);
   }
   return false;
 }
+function toNumber(value) {
+  if (typeof value === "number") {
+    return value - value === 0 ? value : null;
+  }
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed === "") return null;
+    const num = +trimmed;
+    return isFiniteNumber(num) ? num : null;
+  }
+  return null;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  isNumber
+  isFiniteNumber,
+  isNumber,
+  toNumber
 });
 //# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/main.ts"],
-  "sourcesContent": ["import {packageTracer} from '@alwatr/package-tracer';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\n/**\n * Check the value is number or can convert to a number, for example string ' 123 ' can be converted to 123\n *\n * @param value - the value must check numeric.\n *\n * @return true if the value is number or can convert to a number, otherwise false.\n *\n * @example\n * ```ts\n * isNumber(123); // true\n * isNumber('123'); // true\n * isNumber(' 123 '); // true\n * isNumber(''); // false\n * isNumber('  '); // false\n * isNumber(' 123a '); // false\n * isNumber(' 123 a '); // false\n * ```\n */\nexport function isNumber(value: unknown): boolean {\n  if (typeof value === 'number') {\n    return value - value === 0;\n  }\n  if (typeof value === 'string' && value.trim() !== '') {\n    return Number.isFinite ? Number.isFinite(+value) : isFinite(+value);\n  }\n  return false;\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAA4B;AAE5B,aAAc,qCAAc,IAAI,qBAAkB,OAAmB;AAoB9D,SAAS,SAAS,OAAyB;AAChD,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,QAAQ,UAAU;AAAA,EAC3B;AACA,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,IAAI;AACpD,WAAO,OAAO,WAAW,OAAO,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,KAAK;AAAA,EACpE;AACA,SAAO;AACT;",
+  "sourcesContent": ["import {packageTracer} from '@alwatr/package-tracer';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\n/**\n * Polyfill for Number.isFinite - properly checks if a value is a finite number\n * without type coercion.\n *\n * @param value - The value to check\n * @returns true if the value is a finite number, false otherwise\n */\nexport function isFiniteNumber(value: unknown): boolean {\n  // Use native implementation if available\n  if (typeof Number.isFinite === 'function') {\n    return Number.isFinite(value);\n  }\n  // Fallback implementation\n  return typeof value === 'number' && isFinite(value);\n}\n\n/**\n * Check if the value is a number or can be converted to a number.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a number or can be converted to a number, otherwise `false`.\n *\n * @example\n * ```ts\n * isNumber(123);        // true\n * isNumber('123');      // true\n * isNumber(' 123 ');    // true\n * isNumber('0xff');     // true\n * isNumber('-1.1');     // true\n * isNumber('');         // false\n * isNumber('  ');       // false\n * isNumber(' 123a ');   // false\n * isNumber(NaN);        // false\n * isNumber(Infinity);   // false\n * isNumber({});         // false\n * isNumber([]);         // false\n * isNumber(null);       // false\n * isNumber(undefined);  // false\n * ```\n */\nexport function isNumber(value: unknown): boolean {\n  // Handle number type\n  if (typeof value === 'number') {\n    return value - value === 0;\n  }\n\n  // Handle string type\n  if (typeof value === 'string') {\n    const trimmed = value.trim();\n    if (trimmed === '') return false;\n\n    // Use unary plus for fastest string-to-number conversion\n    const num = +trimmed;\n    return isFiniteNumber(num);\n  }\n\n  return false;\n}\n\n/**\n * Convert a value to a number if possible.\n *\n * @param value - The value to convert.\n * @returns The converted number if valid, otherwise `null`.\n *\n * @example\n * ```ts\n * toNumber(123);        // 123\n * toNumber('123');      // 123\n * toNumber(' 123 ');    // 123\n * toNumber('0xff');     // 255\n * toNumber('-1.1');     // -1.1\n * toNumber('');         // null\n * toNumber('  ');       // null\n * toNumber('123a');     // null\n * toNumber(NaN);        // null\n * toNumber(Infinity);   // null\n * toNumber({});         // null\n * toNumber([]);         // null\n * toNumber(null);       // null\n * toNumber(undefined);  // null\n * ```\n */\nexport function toNumber(value: unknown): number | null {\n  // Handle number type\n  if (typeof value === 'number') {\n    return value - value === 0 ? value : null;\n  }\n\n  // Handle string type\n  if (typeof value === 'string') {\n    const trimmed = value.trim();\n    if (trimmed === '') return null;\n\n    const num = +trimmed;\n    return isFiniteNumber(num) ? num : null;\n  }\n\n  return null;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAA4B;AAE5B,aAAc,qCAAc,IAAI,qBAAkB,OAAmB;AAS9D,SAAS,eAAe,OAAyB;AAEtD,MAAI,OAAO,OAAO,aAAa,YAAY;AACzC,WAAO,OAAO,SAAS,KAAK;AAAA,EAC9B;AAEA,SAAO,OAAO,UAAU,YAAY,SAAS,KAAK;AACpD;AA0BO,SAAS,SAAS,OAAyB;AAEhD,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,QAAQ,UAAU;AAAA,EAC3B;AAGA,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,UAAU,MAAM,KAAK;AAC3B,QAAI,YAAY,GAAI,QAAO;AAG3B,UAAM,MAAM,CAAC;AACb,WAAO,eAAe,GAAG;AAAA,EAC3B;AAEA,SAAO;AACT;AA0BO,SAAS,SAAS,OAA+B;AAEtD,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,QAAQ,UAAU,IAAI,QAAQ;AAAA,EACvC;AAGA,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,UAAU,MAAM,KAAK;AAC3B,QAAI,YAAY,GAAI,QAAO;AAE3B,UAAM,MAAM,CAAC;AACb,WAAO,eAAe,GAAG,IAAI,MAAM;AAAA,EACrC;AAEA,SAAO;AACT;",
   "names": []
 }

package/dist/main.d.ts

@@ -1,20 +1,59 @@
 /**
- * Check the value is number or can convert to a number, for example string ' 123 ' can be converted to 123
+ * Polyfill for Number.isFinite - properly checks if a value is a finite number
+ * without type coercion.
  *
- * @param value - the value must check numeric.
+ * @param value - The value to check
+ * @returns true if the value is a finite number, false otherwise
+ */
+export declare function isFiniteNumber(value: unknown): boolean;
+/**
+ * Check if the value is a number or can be converted to a number.
  *
- * @return true if the value is number or can convert to a number, otherwise false.
+ * @param value - The value to check.
+ * @returns `true` if the value is a number or can be converted to a number, otherwise `false`.
  *
  * @example
  * ```ts
- * isNumber(123); // true
- * isNumber('123'); // true
- * isNumber(' 123 '); // true
- * isNumber(''); // false
- * isNumber('  '); // false
- * isNumber(' 123a '); // false
- * isNumber(' 123 a '); // false
+ * isNumber(123);        // true
+ * isNumber('123');      // true
+ * isNumber(' 123 ');    // true
+ * isNumber('0xff');     // true
+ * isNumber('-1.1');     // true
+ * isNumber('');         // false
+ * isNumber('  ');       // false
+ * isNumber(' 123a ');   // false
+ * isNumber(NaN);        // false
+ * isNumber(Infinity);   // false
+ * isNumber({});         // false
+ * isNumber([]);         // false
+ * isNumber(null);       // false
+ * isNumber(undefined);  // false
  * ```
  */
 export declare function isNumber(value: unknown): boolean;
+/**
+ * Convert a value to a number if possible.
+ *
+ * @param value - The value to convert.
+ * @returns The converted number if valid, otherwise `null`.
+ *
+ * @example
+ * ```ts
+ * toNumber(123);        // 123
+ * toNumber('123');      // 123
+ * toNumber(' 123 ');    // 123
+ * toNumber('0xff');     // 255
+ * toNumber('-1.1');     // -1.1
+ * toNumber('');         // null
+ * toNumber('  ');       // null
+ * toNumber('123a');     // null
+ * toNumber(NaN);        // null
+ * toNumber(Infinity);   // null
+ * toNumber({});         // null
+ * toNumber([]);         // null
+ * toNumber(null);       // null
+ * toNumber(undefined);  // null
+ * ```
+ */
+export declare function toNumber(value: unknown): number | null;
 //# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQhD"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOtD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAiBhD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAgBtD"}

package/dist/main.mjs

@@ -1,18 +1,41 @@
-/* @alwatr/is-number v5.5.0 */
+/* @alwatr/is-number v5.6.1 */
 
 // src/main.ts
 import { packageTracer } from "@alwatr/package-tracer";
-__dev_mode__: packageTracer.add("@alwatr/is-number", "5.5.0");
+__dev_mode__: packageTracer.add("@alwatr/is-number", "5.6.1");
+function isFiniteNumber(value) {
+  if (typeof Number.isFinite === "function") {
+    return Number.isFinite(value);
+  }
+  return typeof value === "number" && isFinite(value);
+}
 function isNumber(value) {
   if (typeof value === "number") {
     return value - value === 0;
   }
-  if (typeof value === "string" && value.trim() !== "") {
-    return Number.isFinite ? Number.isFinite(+value) : isFinite(+value);
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed === "") return false;
+    const num = +trimmed;
+    return isFiniteNumber(num);
   }
   return false;
 }
+function toNumber(value) {
+  if (typeof value === "number") {
+    return value - value === 0 ? value : null;
+  }
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed === "") return null;
+    const num = +trimmed;
+    return isFiniteNumber(num) ? num : null;
+  }
+  return null;
+}
 export {
-  isNumber
+  isFiniteNumber,
+  isNumber,
+  toNumber
 };
 //# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/main.ts"],
-  "sourcesContent": ["import {packageTracer} from '@alwatr/package-tracer';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\n/**\n * Check the value is number or can convert to a number, for example string ' 123 ' can be converted to 123\n *\n * @param value - the value must check numeric.\n *\n * @return true if the value is number or can convert to a number, otherwise false.\n *\n * @example\n * ```ts\n * isNumber(123); // true\n * isNumber('123'); // true\n * isNumber(' 123 '); // true\n * isNumber(''); // false\n * isNumber('  '); // false\n * isNumber(' 123a '); // false\n * isNumber(' 123 a '); // false\n * ```\n */\nexport function isNumber(value: unknown): boolean {\n  if (typeof value === 'number') {\n    return value - value === 0;\n  }\n  if (typeof value === 'string' && value.trim() !== '') {\n    return Number.isFinite ? Number.isFinite(+value) : isFinite(+value);\n  }\n  return false;\n}\n"],
-  "mappings": ";;;AAAA,SAAQ,qBAAoB;AAE5B,aAAc,eAAc,IAAI,qBAAkB,OAAmB;AAoB9D,SAAS,SAAS,OAAyB;AAChD,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,QAAQ,UAAU;AAAA,EAC3B;AACA,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,IAAI;AACpD,WAAO,OAAO,WAAW,OAAO,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,KAAK;AAAA,EACpE;AACA,SAAO;AACT;",
+  "sourcesContent": ["import {packageTracer} from '@alwatr/package-tracer';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\n/**\n * Polyfill for Number.isFinite - properly checks if a value is a finite number\n * without type coercion.\n *\n * @param value - The value to check\n * @returns true if the value is a finite number, false otherwise\n */\nexport function isFiniteNumber(value: unknown): boolean {\n  // Use native implementation if available\n  if (typeof Number.isFinite === 'function') {\n    return Number.isFinite(value);\n  }\n  // Fallback implementation\n  return typeof value === 'number' && isFinite(value);\n}\n\n/**\n * Check if the value is a number or can be converted to a number.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a number or can be converted to a number, otherwise `false`.\n *\n * @example\n * ```ts\n * isNumber(123);        // true\n * isNumber('123');      // true\n * isNumber(' 123 ');    // true\n * isNumber('0xff');     // true\n * isNumber('-1.1');     // true\n * isNumber('');         // false\n * isNumber('  ');       // false\n * isNumber(' 123a ');   // false\n * isNumber(NaN);        // false\n * isNumber(Infinity);   // false\n * isNumber({});         // false\n * isNumber([]);         // false\n * isNumber(null);       // false\n * isNumber(undefined);  // false\n * ```\n */\nexport function isNumber(value: unknown): boolean {\n  // Handle number type\n  if (typeof value === 'number') {\n    return value - value === 0;\n  }\n\n  // Handle string type\n  if (typeof value === 'string') {\n    const trimmed = value.trim();\n    if (trimmed === '') return false;\n\n    // Use unary plus for fastest string-to-number conversion\n    const num = +trimmed;\n    return isFiniteNumber(num);\n  }\n\n  return false;\n}\n\n/**\n * Convert a value to a number if possible.\n *\n * @param value - The value to convert.\n * @returns The converted number if valid, otherwise `null`.\n *\n * @example\n * ```ts\n * toNumber(123);        // 123\n * toNumber('123');      // 123\n * toNumber(' 123 ');    // 123\n * toNumber('0xff');     // 255\n * toNumber('-1.1');     // -1.1\n * toNumber('');         // null\n * toNumber('  ');       // null\n * toNumber('123a');     // null\n * toNumber(NaN);        // null\n * toNumber(Infinity);   // null\n * toNumber({});         // null\n * toNumber([]);         // null\n * toNumber(null);       // null\n * toNumber(undefined);  // null\n * ```\n */\nexport function toNumber(value: unknown): number | null {\n  // Handle number type\n  if (typeof value === 'number') {\n    return value - value === 0 ? value : null;\n  }\n\n  // Handle string type\n  if (typeof value === 'string') {\n    const trimmed = value.trim();\n    if (trimmed === '') return null;\n\n    const num = +trimmed;\n    return isFiniteNumber(num) ? num : null;\n  }\n\n  return null;\n}\n"],
+  "mappings": ";;;AAAA,SAAQ,qBAAoB;AAE5B,aAAc,eAAc,IAAI,qBAAkB,OAAmB;AAS9D,SAAS,eAAe,OAAyB;AAEtD,MAAI,OAAO,OAAO,aAAa,YAAY;AACzC,WAAO,OAAO,SAAS,KAAK;AAAA,EAC9B;AAEA,SAAO,OAAO,UAAU,YAAY,SAAS,KAAK;AACpD;AA0BO,SAAS,SAAS,OAAyB;AAEhD,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,QAAQ,UAAU;AAAA,EAC3B;AAGA,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,UAAU,MAAM,KAAK;AAC3B,QAAI,YAAY,GAAI,QAAO;AAG3B,UAAM,MAAM,CAAC;AACb,WAAO,eAAe,GAAG;AAAA,EAC3B;AAEA,SAAO;AACT;AA0BO,SAAS,SAAS,OAA+B;AAEtD,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,QAAQ,UAAU,IAAI,QAAQ;AAAA,EACvC;AAGA,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,UAAU,MAAM,KAAK;AAC3B,QAAI,YAAY,GAAI,QAAO;AAE3B,UAAM,MAAM,CAAC;AACb,WAAO,eAAe,GAAG,IAAI,MAAM;AAAA,EACrC;AAEA,SAAO;AACT;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alwatr/is-number",
-  "version": "5.5.0",
+  "version": "5.6.1",
   "description": "A simple utility to Check the value is number or can convert to a number, for example string ' 123 ' can be converted to 123.",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
   "keywords": [
@@ -86,14 +86,14 @@
     "clean": "rm -rfv dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@alwatr/package-tracer": "^5.5.0"
+    "@alwatr/package-tracer": "^5.5.2"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "^5.5.0",
+    "@alwatr/nano-build": "^5.5.2",
     "@alwatr/prettier-config": "^5.0.0",
     "@alwatr/tsconfig-base": "^5.0.0",
     "jest": "^29.7.0",
     "typescript": "^5.8.2"
   },
-  "gitHead": "fdf8e6de77cca359465110a75ff18faff0649a95"
+  "gitHead": "2756475ba2fa108bae7af6d8d9747e0c7815dfa2"
 }

package/src/main.test.js

@@ -1,4 +1,4 @@
-import {isNumber} from '@alwatr/is-number';
+import {isNumber, toNumber, isFiniteNumber} from '@alwatr/is-number';
 
 describe('isNumber', () => {
   it('should return true for numbers', () => {
@@ -13,6 +13,9 @@ describe('isNumber', () => {
     expect(isNumber('0')).toBe(true);
     expect(isNumber('-123')).toBe(true);
     expect(isNumber('1.23')).toBe(true);
+    expect(isNumber(' 123 ')).toBe(true); // With spaces
+    expect(isNumber('0xff')).toBe(true); // Hex
+    expect(isNumber('5e3')).toBe(true); // Scientific notation
   });
 
   it('should return false for non-numeric strings', () => {
@@ -43,3 +46,74 @@ describe('isNumber', () => {
     expect(isNumber(-Infinity)).toBe(false);
   });
 });
+
+describe('toNumber', () => {
+  it('should convert numbers correctly', () => {
+    expect(toNumber(123)).toBe(123);
+    expect(toNumber(0)).toBe(0);
+    expect(toNumber(-123)).toBe(-123);
+    expect(toNumber(1.23)).toBe(1.23);
+  });
+
+  it('should convert numeric strings correctly', () => {
+    expect(toNumber('123')).toBe(123);
+    expect(toNumber('0')).toBe(0);
+    expect(toNumber('-123')).toBe(-123);
+    expect(toNumber('1.23')).toBe(1.23);
+    expect(toNumber(' 123 ')).toBe(123); // With spaces
+    expect(toNumber('0xff')).toBe(255); // Hex
+    expect(toNumber('5e3')).toBe(5000); // Scientific notation
+  });
+
+  it('should return null for non-numeric strings', () => {
+    expect(toNumber('abc')).toBeNull();
+    expect(toNumber('123abc')).toBeNull();
+    expect(toNumber('')).toBeNull();
+    expect(toNumber(' ')).toBeNull();
+  });
+
+  it('should return null for boolean values', () => {
+    expect(toNumber(true)).toBeNull();
+    expect(toNumber(false)).toBeNull();
+  });
+
+  it('should return null for null and undefined', () => {
+    expect(toNumber(null)).toBeNull();
+    expect(toNumber(undefined)).toBeNull();
+  });
+
+  it('should return null for objects and arrays', () => {
+    expect(toNumber({})).toBeNull();
+    expect(toNumber([])).toBeNull();
+  });
+
+  it('should return null for NaN and Infinity', () => {
+    expect(toNumber(NaN)).toBeNull();
+    expect(toNumber(Infinity)).toBeNull();
+    expect(toNumber(-Infinity)).toBeNull();
+  });
+});
+
+describe('isFiniteNumber', () => {
+  it('should return true for finite numbers', () => {
+    expect(isFiniteNumber(123)).toBe(true);
+    expect(isFiniteNumber(0)).toBe(true);
+    expect(isFiniteNumber(-123)).toBe(true);
+    expect(isFiniteNumber(1.23)).toBe(true);
+  });
+
+  it('should return false for NaN and Infinity', () => {
+    expect(isFiniteNumber(NaN)).toBe(false);
+    expect(isFiniteNumber(Infinity)).toBe(false);
+    expect(isFiniteNumber(-Infinity)).toBe(false);
+  });
+
+  it('should return false for non-number values without type coercion', () => {
+    expect(isFiniteNumber('123')).toBe(false);
+    expect(isFiniteNumber(true)).toBe(false);
+    expect(isFiniteNumber(null)).toBe(false);
+    expect(isFiniteNumber(undefined)).toBe(false);
+    expect(isFiniteNumber({})).toBe(false);
+    expect(isFiniteNumber([])).toBe(false);
+  });
+});