is-kit 1.1.5 → 1.1.7

package/README.md

@@ -120,13 +120,30 @@ 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`.
+
 ```ts
-import { isPrimitive, isNumber } from 'is-kit';
+import {
+  isPrimitive,
+  isNumber,
+  isInteger,
+  isSafeInteger,
+  isPositive,
+  isNegative,
+} 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(0); // false
+isNegative(-0); // false
 ```
 
 ## Core Ideas

package/dist/index.d.mts

@@ -188,6 +188,35 @@ 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 boolean.
  *
@@ -425,4 +454,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, 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 };

package/dist/index.d.ts

@@ -188,6 +188,35 @@ 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 boolean.
  *
@@ -425,4 +454,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, 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 };

package/dist/index.js

@@ -39,16 +39,20 @@ __export(index_exports, {
   isError: () => isError,
   isFiniteNumber: () => isFiniteNumber,
   isFunction: () => isFunction,
+  isInteger: () => isInteger,
   isIterable: () => isIterable,
   isMap: () => isMap,
+  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,
@@ -234,6 +238,16 @@ var isNumberPrimitive = define(
 );
 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 isBoolean = define((value) => typeof value === "boolean");
 var isBigInt = define((value) => typeof value === "bigint");
 var isSymbol = define((value) => typeof value === "symbol");
@@ -271,7 +285,10 @@ function tupleOf(...guards) {
 
 // src/core/combinators/one-of.ts
 function oneOf(...guards) {
-  return (input) => guards.some((guard) => guard(input));
+  const predicates = toBooleanPredicates(
+    guards
+  );
+  return (input) => predicates.some((guard) => guard(input));
 }
 
 // src/core/combinators/record.ts
@@ -371,16 +388,20 @@ function narrowKeyTo(guard, key) {
   isError,
   isFiniteNumber,
   isFunction,
+  isInteger,
   isIterable,
   isMap,
+  isNegative,
   isNull,
   isNumber,
   isNumberPrimitive,
   isObject,
   isPlainObject,
+  isPositive,
   isPrimitive,
   isPromiseLike,
   isRegExp,
+  isSafeInteger,
   isSet,
   isString,
   isSymbol,

package/dist/index.mjs

@@ -155,6 +155,16 @@ var isNumberPrimitive = define(
 );
 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 isBoolean = define((value) => typeof value === "boolean");
 var isBigInt = define((value) => typeof value === "bigint");
 var isSymbol = define((value) => typeof value === "symbol");
@@ -192,7 +202,10 @@ function tupleOf(...guards) {
 
 // src/core/combinators/one-of.ts
 function oneOf(...guards) {
-  return (input) => guards.some((guard) => guard(input));
+  const predicates = toBooleanPredicates(
+    guards
+  );
+  return (input) => predicates.some((guard) => guard(input));
 }
 
 // src/core/combinators/record.ts
@@ -291,16 +304,20 @@ export {
   isError,
   isFiniteNumber,
   isFunction,
+  isInteger,
   isIterable,
   isMap,
+  isNegative,
   isNull,
   isNumber,
   isNumberPrimitive,
   isObject,
   isPlainObject,
+  isPositive,
   isPrimitive,
   isPromiseLike,
   isRegExp,
+  isSafeInteger,
   isSet,
   isString,
   isSymbol,

package/package.json

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