is-kit 1.1.6 → 1.1.8

package/README.md

@@ -120,13 +120,41 @@ 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`, `isZero`, `isNaN`, `isInfiniteNumber`.
+
 ```ts
-import { isPrimitive, isNumber } from 'is-kit';
+import {
+  isPrimitive,
+  isNumber,
+  isInteger,
+  isSafeInteger,
+  isPositive,
+  isNegative,
+  isZero,
+  isNaN,
+  isInfiniteNumber,
+} from 'is-kit';
 
+// Any primitive
 isPrimitive('x'); // true
 isPrimitive(123); // true
 isPrimitive(NaN); // true (use isNumber for finite only)
 isPrimitive({}); // false
+
+// Numeric helpers
+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.
@@ -188,6 +201,41 @@ declare const isFiniteNumber: Refine<number, number>;
  * @returns Predicate narrowing to finite `number`.
  */
 declare const isNumber: Predicate<number>;
+/**
+ * Checks whether a value is an integer number.
+ *
+ * Equivalent to `Number.isInteger(value)`.
+ * @returns Predicate narrowing to integer `number`.
+ */
+declare const isInteger: Predicate<number>;
+/**
+ * Checks whether a value is a safe integer.
+ *
+ * Equivalent to `Number.isSafeInteger(value)`.
+ * @returns Predicate narrowing to safe-integer `number`.
+ */
+declare const isSafeInteger: Predicate<number>;
+/**
+ * Checks whether a value is a positive finite number (> 0).
+ *
+ * Uses `isNumber` internally to exclude NaN and ±Infinity.
+ * @returns Predicate narrowing to positive `number`.
+ */
+declare const isPositive: Predicate<number>;
+/**
+ * Checks whether a value is a negative finite number (< 0).
+ *
+ * Uses `isNumber` internally to exclude NaN and ±Infinity.
+ * Note: `-0` is not considered negative (consistent with `< 0`).
+ * @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.
  *
@@ -425,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, isIterable, isMap, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPrimitive, isPromiseLike, isRegExp, 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.
@@ -188,6 +201,41 @@ declare const isFiniteNumber: Refine<number, number>;
  * @returns Predicate narrowing to finite `number`.
  */
 declare const isNumber: Predicate<number>;
+/**
+ * Checks whether a value is an integer number.
+ *
+ * Equivalent to `Number.isInteger(value)`.
+ * @returns Predicate narrowing to integer `number`.
+ */
+declare const isInteger: Predicate<number>;
+/**
+ * Checks whether a value is a safe integer.
+ *
+ * Equivalent to `Number.isSafeInteger(value)`.
+ * @returns Predicate narrowing to safe-integer `number`.
+ */
+declare const isSafeInteger: Predicate<number>;
+/**
+ * Checks whether a value is a positive finite number (> 0).
+ *
+ * Uses `isNumber` internally to exclude NaN and ±Infinity.
+ * @returns Predicate narrowing to positive `number`.
+ */
+declare const isPositive: Predicate<number>;
+/**
+ * Checks whether a value is a negative finite number (< 0).
+ *
+ * Uses `isNumber` internally to exclude NaN and ±Infinity.
+ * Note: `-0` is not considered negative (consistent with `< 0`).
+ * @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.
  *
@@ -425,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, isIterable, isMap, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPrimitive, isPromiseLike, isRegExp, 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,16 +39,22 @@ __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,
   isNumberPrimitive: () => isNumberPrimitive,
   isObject: () => isObject,
   isPlainObject: () => isPlainObject,
+  isPositive: () => isPositive,
   isPrimitive: () => isPrimitive,
   isPromiseLike: () => isPromiseLike,
   isRegExp: () => isRegExp,
+  isSafeInteger: () => isSafeInteger,
   isSet: () => isSet,
   isString: () => isString,
   isSymbol: () => isSymbol,
@@ -57,6 +63,7 @@ __export(index_exports, {
   isUndefined: () => isUndefined,
   isWeakMap: () => isWeakMap,
   isWeakSet: () => isWeakSet,
+  isZero: () => isZero,
   narrowKeyTo: () => narrowKeyTo,
   nonNull: () => nonNull,
   not: () => not,
@@ -232,8 +239,27 @@ 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);
+var isSafeInteger = define(Number.isSafeInteger);
+var isPositive = and(
+  isNumber,
+  predicateToRefine((n) => n > 0)
+);
+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");
@@ -374,16 +400,22 @@ function narrowKeyTo(guard, key) {
   isError,
   isFiniteNumber,
   isFunction,
+  isInfiniteNumber,
+  isInteger,
   isIterable,
   isMap,
+  isNaN,
+  isNegative,
   isNull,
   isNumber,
   isNumberPrimitive,
   isObject,
   isPlainObject,
+  isPositive,
   isPrimitive,
   isPromiseLike,
   isRegExp,
+  isSafeInteger,
   isSet,
   isString,
   isSymbol,
@@ -392,6 +424,7 @@ function narrowKeyTo(guard, key) {
   isUndefined,
   isWeakMap,
   isWeakSet,
+  isZero,
   narrowKeyTo,
   nonNull,
   not,

package/dist/index.mjs

@@ -153,8 +153,27 @@ 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);
+var isSafeInteger = define(Number.isSafeInteger);
+var isPositive = and(
+  isNumber,
+  predicateToRefine((n) => n > 0)
+);
+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");
@@ -294,16 +313,22 @@ export {
   isError,
   isFiniteNumber,
   isFunction,
+  isInfiniteNumber,
+  isInteger,
   isIterable,
   isMap,
+  isNaN,
+  isNegative,
   isNull,
   isNumber,
   isNumberPrimitive,
   isObject,
   isPlainObject,
+  isPositive,
   isPrimitive,
   isPromiseLike,
   isRegExp,
+  isSafeInteger,
   isSet,
   isString,
   isSymbol,
@@ -312,6 +337,7 @@ export {
   isUndefined,
   isWeakMap,
   isWeakSet,
+  isZero,
   narrowKeyTo,
   nonNull,
   not,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "is-kit",
-  "version": "1.1.6",
+  "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",