is-kit 1.1.7 → 1.1.8

package/README.md

@@ -120,7 +120,7 @@ When validating complex shapes, reach for `struct` — and friends like `arrayOf
 
 Built-in primitives: `isString`, `isNumber` (finite), `isBoolean`, `isBigInt`, `isSymbol`, `isUndefined`, `isNull` — and a preset `isPrimitive` for any primitive.
 
-Numeric helpers are included for common cases: `isInteger`, `isSafeInteger`, `isPositive`, `isNegative`.
+Numeric helpers are included for common cases: `isInteger`, `isSafeInteger`, `isPositive`, `isNegative`, `isZero`, `isNaN`, `isInfiniteNumber`.
 
 ```ts
 import {
@@ -130,6 +130,9 @@ import {
   isSafeInteger,
   isPositive,
   isNegative,
+  isZero,
+  isNaN,
+  isInfiniteNumber,
 } from 'is-kit';
 
 // Any primitive
@@ -142,8 +145,16 @@ isPrimitive({}); // false
 isNumber(10); // true
 isInteger(42); // true
 isSafeInteger(2 ** 53); // false
+isPositive(3); // true
 isPositive(0); // false
+isNegative(-3); // true
 isNegative(-0); // false
+isZero(0); // true
+isZero(1); // false
+isNaN(NaN); // true
+isNaN(0); // false
+isInfiniteNumber(Infinity); // true
+isInfiniteNumber(1); // false
 ```
 
 ## Core Ideas

package/dist/index.d.mts

@@ -178,6 +178,19 @@ declare const isString: Predicate<string>;
  * @returns Predicate narrowing to `number` (primitive-only).
  */
 declare const isNumberPrimitive: Predicate<number>;
+/**
+ * Checks whether a value is `NaN`.
+ *
+ * Equivalent to `Number.isNaN(value)` without coercion.
+ * @returns Predicate narrowing to `number` (`NaN` only).
+ */
+declare const isNaN: Predicate<number>;
+/**
+ * Checks whether a value is an infinite number (±Infinity).
+ *
+ * @returns Predicate narrowing to `number` (Infinity or -Infinity).
+ */
+declare const isInfiniteNumber: Predicate<number>;
 /**
  * Checks whether a number is finite.
  * @returns Refinement that accepts only finite numbers.
@@ -217,6 +230,12 @@ declare const isPositive: Predicate<number>;
  * @returns Predicate narrowing to negative `number`.
  */
 declare const isNegative: Predicate<number>;
+/**
+ * Checks whether a value is a finite number that equals zero (including `-0`).
+ *
+ * @returns Predicate narrowing to zero `number`.
+ */
+declare const isZero: Predicate<number>;
 /**
  * Checks whether a value is a boolean.
  *
@@ -454,4 +473,4 @@ declare function narrowKeyTo<A, K extends keyof A>(guard: Guard<A>, key: K): <co
  */
 declare const toBooleanPredicates: (guards: readonly Guard<unknown>[]) => ReadonlyArray<(value: unknown) => boolean>;
 
-export { type ChainResult, type Guard, type GuardedOf, type GuardedWithin, type InferSchema, type OutOfGuards, type ParseResult, type Predicate, type Primitive, type Refine, type RefineChain, type Refinement, type Schema, and, andAll, arrayOf, define, equals, equalsBy, equalsKey, guardIn, isArray, isArrayBuffer, isAsyncIterable, isBigInt, isBlob, isBoolean, isDataView, isDate, isError, isFiniteNumber, isFunction, isInteger, isIterable, isMap, isNegative, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPositive, isPrimitive, isPromiseLike, isRegExp, isSafeInteger, isSet, isString, isSymbol, isTypedArray, isURL, isUndefined, isWeakMap, isWeakSet, narrowKeyTo, nonNull, not, nullable, nullish, oneOf, oneOfValues, optional, or, predicateToRefine, recordOf, required, safeParse, safeParseWith, struct, toBooleanPredicates, tupleOf };
+export { type ChainResult, type Guard, type GuardedOf, type GuardedWithin, type InferSchema, type OutOfGuards, type ParseResult, type Predicate, type Primitive, type Refine, type RefineChain, type Refinement, type Schema, and, andAll, arrayOf, define, equals, equalsBy, equalsKey, guardIn, isArray, isArrayBuffer, isAsyncIterable, isBigInt, isBlob, isBoolean, isDataView, isDate, isError, isFiniteNumber, isFunction, isInfiniteNumber, isInteger, isIterable, isMap, isNaN, isNegative, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPositive, isPrimitive, isPromiseLike, isRegExp, isSafeInteger, isSet, isString, isSymbol, isTypedArray, isURL, isUndefined, isWeakMap, isWeakSet, isZero, narrowKeyTo, nonNull, not, nullable, nullish, oneOf, oneOfValues, optional, or, predicateToRefine, recordOf, required, safeParse, safeParseWith, struct, toBooleanPredicates, tupleOf };

package/dist/index.d.ts

@@ -178,6 +178,19 @@ declare const isString: Predicate<string>;
  * @returns Predicate narrowing to `number` (primitive-only).
  */
 declare const isNumberPrimitive: Predicate<number>;
+/**
+ * Checks whether a value is `NaN`.
+ *
+ * Equivalent to `Number.isNaN(value)` without coercion.
+ * @returns Predicate narrowing to `number` (`NaN` only).
+ */
+declare const isNaN: Predicate<number>;
+/**
+ * Checks whether a value is an infinite number (±Infinity).
+ *
+ * @returns Predicate narrowing to `number` (Infinity or -Infinity).
+ */
+declare const isInfiniteNumber: Predicate<number>;
 /**
  * Checks whether a number is finite.
  * @returns Refinement that accepts only finite numbers.
@@ -217,6 +230,12 @@ declare const isPositive: Predicate<number>;
  * @returns Predicate narrowing to negative `number`.
  */
 declare const isNegative: Predicate<number>;
+/**
+ * Checks whether a value is a finite number that equals zero (including `-0`).
+ *
+ * @returns Predicate narrowing to zero `number`.
+ */
+declare const isZero: Predicate<number>;
 /**
  * Checks whether a value is a boolean.
  *
@@ -454,4 +473,4 @@ declare function narrowKeyTo<A, K extends keyof A>(guard: Guard<A>, key: K): <co
  */
 declare const toBooleanPredicates: (guards: readonly Guard<unknown>[]) => ReadonlyArray<(value: unknown) => boolean>;
 
-export { type ChainResult, type Guard, type GuardedOf, type GuardedWithin, type InferSchema, type OutOfGuards, type ParseResult, type Predicate, type Primitive, type Refine, type RefineChain, type Refinement, type Schema, and, andAll, arrayOf, define, equals, equalsBy, equalsKey, guardIn, isArray, isArrayBuffer, isAsyncIterable, isBigInt, isBlob, isBoolean, isDataView, isDate, isError, isFiniteNumber, isFunction, isInteger, isIterable, isMap, isNegative, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPositive, isPrimitive, isPromiseLike, isRegExp, isSafeInteger, isSet, isString, isSymbol, isTypedArray, isURL, isUndefined, isWeakMap, isWeakSet, narrowKeyTo, nonNull, not, nullable, nullish, oneOf, oneOfValues, optional, or, predicateToRefine, recordOf, required, safeParse, safeParseWith, struct, toBooleanPredicates, tupleOf };
+export { type ChainResult, type Guard, type GuardedOf, type GuardedWithin, type InferSchema, type OutOfGuards, type ParseResult, type Predicate, type Primitive, type Refine, type RefineChain, type Refinement, type Schema, and, andAll, arrayOf, define, equals, equalsBy, equalsKey, guardIn, isArray, isArrayBuffer, isAsyncIterable, isBigInt, isBlob, isBoolean, isDataView, isDate, isError, isFiniteNumber, isFunction, isInfiniteNumber, isInteger, isIterable, isMap, isNaN, isNegative, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPositive, isPrimitive, isPromiseLike, isRegExp, isSafeInteger, isSet, isString, isSymbol, isTypedArray, isURL, isUndefined, isWeakMap, isWeakSet, isZero, narrowKeyTo, nonNull, not, nullable, nullish, oneOf, oneOfValues, optional, or, predicateToRefine, recordOf, required, safeParse, safeParseWith, struct, toBooleanPredicates, tupleOf };

package/dist/index.js

@@ -39,9 +39,11 @@ __export(index_exports, {
   isError: () => isError,
   isFiniteNumber: () => isFiniteNumber,
   isFunction: () => isFunction,
+  isInfiniteNumber: () => isInfiniteNumber,
   isInteger: () => isInteger,
   isIterable: () => isIterable,
   isMap: () => isMap,
+  isNaN: () => isNaN,
   isNegative: () => isNegative,
   isNull: () => isNull,
   isNumber: () => isNumber,
@@ -61,6 +63,7 @@ __export(index_exports, {
   isUndefined: () => isUndefined,
   isWeakMap: () => isWeakMap,
   isWeakSet: () => isWeakSet,
+  isZero: () => isZero,
   narrowKeyTo: () => narrowKeyTo,
   nonNull: () => nonNull,
   not: () => not,
@@ -236,6 +239,11 @@ var isString = define((value) => typeof value === "string");
 var isNumberPrimitive = define(
   (value) => typeof value === "number"
 );
+var isNaN = define(Number.isNaN);
+var isInfiniteNumber = and(
+  isNumberPrimitive,
+  predicateToRefine((n) => n === Infinity || n === -Infinity)
+);
 var isFiniteNumber = predicateToRefine(Number.isFinite);
 var isNumber = and(isNumberPrimitive, isFiniteNumber);
 var isInteger = define(Number.isInteger);
@@ -248,6 +256,10 @@ var isNegative = and(
   isNumber,
   predicateToRefine((n) => n < 0)
 );
+var isZero = and(
+  isNumber,
+  predicateToRefine((n) => n === 0)
+);
 var isBoolean = define((value) => typeof value === "boolean");
 var isBigInt = define((value) => typeof value === "bigint");
 var isSymbol = define((value) => typeof value === "symbol");
@@ -388,9 +400,11 @@ function narrowKeyTo(guard, key) {
   isError,
   isFiniteNumber,
   isFunction,
+  isInfiniteNumber,
   isInteger,
   isIterable,
   isMap,
+  isNaN,
   isNegative,
   isNull,
   isNumber,
@@ -410,6 +424,7 @@ function narrowKeyTo(guard, key) {
   isUndefined,
   isWeakMap,
   isWeakSet,
+  isZero,
   narrowKeyTo,
   nonNull,
   not,

package/dist/index.mjs

@@ -153,6 +153,11 @@ var isString = define((value) => typeof value === "string");
 var isNumberPrimitive = define(
   (value) => typeof value === "number"
 );
+var isNaN = define(Number.isNaN);
+var isInfiniteNumber = and(
+  isNumberPrimitive,
+  predicateToRefine((n) => n === Infinity || n === -Infinity)
+);
 var isFiniteNumber = predicateToRefine(Number.isFinite);
 var isNumber = and(isNumberPrimitive, isFiniteNumber);
 var isInteger = define(Number.isInteger);
@@ -165,6 +170,10 @@ var isNegative = and(
   isNumber,
   predicateToRefine((n) => n < 0)
 );
+var isZero = and(
+  isNumber,
+  predicateToRefine((n) => n === 0)
+);
 var isBoolean = define((value) => typeof value === "boolean");
 var isBigInt = define((value) => typeof value === "bigint");
 var isSymbol = define((value) => typeof value === "symbol");
@@ -304,9 +313,11 @@ export {
   isError,
   isFiniteNumber,
   isFunction,
+  isInfiniteNumber,
   isInteger,
   isIterable,
   isMap,
+  isNaN,
   isNegative,
   isNull,
   isNumber,
@@ -326,6 +337,7 @@ export {
   isUndefined,
   isWeakMap,
   isWeakSet,
+  isZero,
   narrowKeyTo,
   nonNull,
   not,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "is-kit",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "Make 'isXXX' easier. Let's make your code type safe and more readable!",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",