@alwatr/is-number 5.4.0 → 5.6.0

package/CHANGELOG.md

@@ -3,6 +3,27 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [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
+
+* update username casing in changelog entries ([9722ac9](https://github.com/Alwatr/nanolib/commit/9722ac9a078438a4e8ebfa5826ea70e0e3a52ca6)) by @
+
+### Dependencies update
+
+* bump the development-dependencies group across 1 directory with 11 updates ([720c395](https://github.com/Alwatr/nanolib/commit/720c3954da55c929fe8fb16957121f4c51fb7f0c)) by @dependabot[bot]
+
 ## [5.4.0](https://github.com/Alwatr/nanolib/compare/@alwatr/is-number@1.1.8...@alwatr/is-number@5.4.0) (2025-02-18)
 
 ## 5.3.0 (2025-02-03)
@@ -107,7 +128,7 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 ### Miscellaneous Chores
 
-- include LICENSE and LEGAL files to publish ([09f366f](https://github.com/Alwatr/nanolib/commit/09f366f680bfa9fb26acb2cd1ccbc68c5a9e9ad8)) by @AliMD
+- include LICENSE and LEGAL files to publish ([09f366f](https://github.com/Alwatr/nanolib/commit/09f366f680bfa9fb26acb2cd1ccbc68c5a9e9ad8)) by @alimd
 
 ## [1.1.3](https://github.com/Alwatr/nanolib/compare/@alwatr/is-number@1.1.2...@alwatr/is-number@1.1.3) (2024-10-11)
 
@@ -136,7 +157,7 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 ### Miscellaneous Chores
 
 - **is-number:** change the license to AGPL-3.0 ([3ad68cb](https://github.com/Alwatr/nanolib/commit/3ad68cb43659fe2af8358ff1393e0085e85b8857)) by @ArmanAsadian
-- Update build and lint scripts ([392d0b7](https://github.com/Alwatr/nanolib/commit/392d0b71f446bce336b0256119a80f07aff794ba)) by @AliMD
+- Update build and lint scripts ([392d0b7](https://github.com/Alwatr/nanolib/commit/392d0b71f446bce336b0256119a80f07aff794ba)) by @alimd
 
 ### Dependencies update
 
@@ -151,7 +172,7 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 ### Dependencies update
 
 - bump the development-dependencies group across 1 directory with 10 updates ([9ed98ff](https://github.com/Alwatr/nanolib/commit/9ed98ffd0668d5a36e255c82edab3af53bffda8f)) by @dependabot[bot]
-- update ([c36ed50](https://github.com/Alwatr/nanolib/commit/c36ed50f68da2f5608ccd96119963a16cfacb4ce)) by @AliMD
+- update ([c36ed50](https://github.com/Alwatr/nanolib/commit/c36ed50f68da2f5608ccd96119963a16cfacb4ce)) by @alimd
 
 ## [1.0.9](https://github.com/Alwatr/nanolib/compare/@alwatr/is-number@1.0.8...@alwatr/is-number@1.0.9) (2024-08-31)
 
@@ -163,7 +184,7 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 ### Dependencies update
 
-- update all dependencies ([1e0c30e](https://github.com/Alwatr/nanolib/commit/1e0c30e6a3a8e19deb5185814e24ab6c08dca573)) by @AliMD
+- update all dependencies ([1e0c30e](https://github.com/Alwatr/nanolib/commit/1e0c30e6a3a8e19deb5185814e24ab6c08dca573)) by @alimd
 
 ## [1.0.7](https://github.com/Alwatr/nanolib/compare/@alwatr/is-number@1.0.6...@alwatr/is-number@1.0.7) (2024-07-04)
 
@@ -175,7 +196,7 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 ### Dependencies update
 
-- upgrade ([6dbd300](https://github.com/Alwatr/nanolib/commit/6dbd300642c9bcc9e7d0b281e244bf1b06eb1c38)) by @AliMD
+- upgrade ([6dbd300](https://github.com/Alwatr/nanolib/commit/6dbd300642c9bcc9e7d0b281e244bf1b06eb1c38)) by @alimd
 
 ## [1.0.5](https://github.com/Alwatr/nanolib/compare/@alwatr/is-number@1.0.4...@alwatr/is-number@1.0.5) (2024-04-25)
 
@@ -189,7 +210,7 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 ### Miscellaneous Chores
 
-- **deps:** update ([1a45030](https://github.com/Alwatr/nanolib/commit/1a450305440b710a300787d4ca24b1ed8c6a39d7)) by @AliMD
+- **deps:** update ([1a45030](https://github.com/Alwatr/nanolib/commit/1a450305440b710a300787d4ca24b1ed8c6a39d7)) by @alimd
 
 ## [1.0.2](https://github.com/Alwatr/nanolib/compare/@alwatr/is-number@1.0.1...@alwatr/is-number@1.0.2) (2024-01-24)
 
@@ -203,9 +224,9 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 ### Bug Fixes
 
-- **is-number:** Remove Number.isFinite polyfill ([aa149f3](https://github.com/Alwatr/nanolib/commit/aa149f302f96d961b058fc3a9d70399c1023cbe3)) by @AliMD
+- **is-number:** Remove Number.isFinite polyfill ([aa149f3](https://github.com/Alwatr/nanolib/commit/aa149f302f96d961b058fc3a9d70399c1023cbe3)) by @alimd
 
 ### Features
 
 - **is-number:** extract from @alwatr/util ([1c8a676](https://github.com/Alwatr/nanolib/commit/1c8a676ccefcad12436f41b96eeb39c60cc09040)) by @njfamirm
-- **is-number:** Update is-number package description and add Number.isFinite polyfill ([a7c8e38](https://github.com/Alwatr/nanolib/commit/a7c8e38eb3e939199cf5637feaf08ac0ed98e2e6)) by @AliMD
+- **is-number:** Update is-number package description and add Number.isFinite polyfill ([a7c8e38](https://github.com/Alwatr/nanolib/commit/a7c8e38eb3e939199cf5637feaf08ac0ed98e2e6)) by @alimd

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.4.0 */
+/* @alwatr/is-number v5.6.0 */
 "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.4.0");
+__dev_mode__: import_package_tracer.packageTracer.add("@alwatr/is-number", "5.6.0");
+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.4.0 */
+/* @alwatr/is-number v5.6.0 */
 
 // src/main.ts
 import { packageTracer } from "@alwatr/package-tracer";
-__dev_mode__: packageTracer.add("@alwatr/is-number", "5.4.0");
+__dev_mode__: packageTracer.add("@alwatr/is-number", "5.6.0");
+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.4.0",
+  "version": "5.6.0",
   "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.4.0"
+    "@alwatr/package-tracer": "^5.5.1"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "^5.4.0",
+    "@alwatr/nano-build": "^5.5.1",
     "@alwatr/prettier-config": "^5.0.0",
     "@alwatr/tsconfig-base": "^5.0.0",
     "jest": "^29.7.0",
-    "typescript": "^5.7.3"
+    "typescript": "^5.8.2"
   },
-  "gitHead": "074be0d0fe780bf929e163045f8f598cd2697636"
+  "gitHead": "21cb1fe0f26a580944d9e72a313fc99308cd8be7"
 }

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);
+  });
+});