is-kit 1.9.0 → 1.11.0

package/README.md

@@ -116,6 +116,7 @@ This is the core idea of `is-kit`:
 If you are new to the library, these are the pieces to remember:
 
 - `define<T>(fn)` turns a boolean check into a typed guard.
+- `lazy(factory)` defers a guard definition so recursive structures can refer to themselves.
 - `predicateToRefine(fn)` upgrades an existing predicate so it can participate in narrowing chains.
 - `struct({...})` builds an object-shape guard.
 - `safeParse(guard, value)` gives you a small tagged result object.
@@ -224,7 +225,31 @@ import { oneOfValues } from 'is-kit';
 const isStatus = oneOfValues('draft', 'published', 'archived');
 ```
 
-### 6. Handle null and undefined explicitly
+### 6. Validate recursive structures
+
+Use `lazy` when a guard needs to refer to itself. The factory runs on first use,
+and the resulting guard is cached.
+
+```ts
+import { arrayOf, isString, lazy, typedStruct } from 'is-kit';
+import type { Predicate } from 'is-kit';
+
+type Tree = {
+  readonly value: string;
+  readonly children: readonly Tree[];
+};
+
+const isTree: Predicate<Tree> = lazy(() =>
+  typedStruct<Tree>()({
+    value: isString,
+    children: arrayOf(isTree)
+  })
+);
+```
+
+`lazy` does not detect circular references in the input value.
+
+### 7. Handle null and undefined explicitly
 
 Use the nullish helpers to say exactly what is allowed.
 
@@ -245,7 +270,18 @@ const isDefinedString = required(optional(isString));
 const isNonNullString = nonNull(nullable(isString));
 ```
 
-### 7. Parse or assert unknown input
+For a plain "is it `null` or `undefined`?" check, reach for `isNil` instead of
+hand-rolling `isNull(x) || isUndefined(x)`:
+
+```ts
+import { isNil } from 'is-kit';
+
+isNil(null); // true
+isNil(undefined); // true
+isNil(0); // false
+```
+
+### 8. Parse or assert unknown input
 
 Use `safeParse` when you want a result object, and `assert` when invalid data should stop execution.
 
@@ -264,7 +300,7 @@ assert(isString, input, 'Expected a string');
 input.toUpperCase();
 ```
 
-### 8. Decode and validate JSON input
+### 9. Decode and validate JSON input
 
 Use `safeJsonParse` at a JSON text boundary. It decodes the text, treats the
 result as `unknown`, and only returns the value after the guard accepts it.
@@ -296,7 +332,7 @@ if (result.valid) {
 coercion and does not depend on a transport or schema format such as HTTP or
 OpenAPI.
 
-### 9. Narrow object keys
+### 10. Narrow object keys
 
 Use key helpers when the important part of a value is one property.
 
@@ -409,7 +445,7 @@ The library is organized around a few small building blocks:
 - **Object shapes**: `struct`, `optionalKey`, `hasKey`, `hasKeys`, `narrowKeyTo`
 - **Collections**: `arrayOf`, `nonEmptyArrayOf`, `tupleOf`, `setOf`, `mapOf`, `recordOf`
 - **Literals**: `oneOfValues`, `equals`, `equalsBy`, `equalsKey`
-- **Nullish handling**: `nullable`, `nonNull`, `nullish`, `optional`, `required`
+- **Nullish handling**: `isNil`, `nullable`, `nonNull`, `nullish`, `optional`, `required`
 - **Result helpers**: `safeParse`, `safeParseWith`, `safeJsonParse`, `assert`
 
 For the full API list and dedicated pages, use the docs site below.

package/dist/index.d.mts

@@ -133,6 +133,17 @@ declare const hasKeys: <const KS extends readonly [PropertyKey, ...PropertyKey[]
  */
 declare function narrowKeyTo<A, K extends keyof A>(guard: Guard<A>, key: K): <const T extends A[K]>(target: T) => Predicate<A & Record<K, T>>;
 
+/**
+ * Creates a predicate whose implementation is initialized on first use.
+ *
+ * The initialized predicate is cached after the factory returns successfully.
+ * Circular references in the input value are not detected.
+ *
+ * @param factory Function that creates the predicate when it is first evaluated.
+ * @returns Predicate that delegates to the lazily initialized implementation.
+ */
+declare function lazy<T>(factory: () => Predicate<T>): Predicate<T>;
+
 /**
  * Combines a precondition guard with an additional refinement to narrow the type.
  *
@@ -340,15 +351,34 @@ declare const isSymbol: Predicate<symbol>;
 /**
  * Checks whether a value is exactly `undefined`.
  *
+ * To accept `null` as well, use {@link isNil}.
+ *
  * @returns Predicate narrowing to `undefined`.
  */
 declare const isUndefined: Predicate<undefined>;
 /**
  * Checks whether a value is exactly `null`.
  *
+ * To accept `undefined` as well, use {@link isNil}.
+ *
  * @returns Predicate narrowing to `null`.
  */
 declare const isNull: Predicate<null>;
+/**
+ * Checks whether a value is `null` or `undefined` (nullish).
+ *
+ * Prefer this over hand-rolling `isNull(x) || isUndefined(x)`: it is the same
+ * check expressed once. To widen an existing guard so it also accepts nullish
+ * values, use {@link nullish} instead.
+ *
+ * @returns Predicate narrowing to `null | undefined`.
+ * @example
+ * isNil(null); // true
+ * isNil(undefined); // true
+ * isNil(0); // false
+ * @see or
+ */
+declare const isNil: Guard<null | undefined>;
 /**
  * Checks whether a value is a JavaScript primitive.
  *
@@ -474,6 +504,12 @@ declare const isURL: Guard<URL>;
  * @returns Predicate narrowing to `Blob` when supported; otherwise always false.
  */
 declare const isBlob: Guard<Blob>;
+/**
+ * Checks whether a value is a `File` (in environments with File available).
+ *
+ * @returns Predicate narrowing to `File` when supported; otherwise always false.
+ */
+declare const isFile: Guard<File>;
 /**
  * Creates a guard that checks whether a value is an instance of `constructor`.
  *
@@ -602,6 +638,7 @@ declare function tupleOf<const Fs extends readonly Predicate<unknown>[]>(...guar
     readonly [K in keyof Fs]: GuardedOf<Fs[K]>;
 }>;
 
+type BooleanPredicate<T> = (value: T) => boolean;
 /**
  * Checks whether every array element satisfies the provided predicate.
  *
@@ -609,7 +646,7 @@ declare function tupleOf<const Fs extends readonly Predicate<unknown>[]>(...guar
  * @param predicate Predicate applied to each element.
  * @returns Whether all elements satisfy `predicate`.
  */
-declare const everyArrayValue: (values: readonly unknown[], predicate: (value: unknown) => boolean) => boolean;
+declare const everyArrayValue: (values: readonly unknown[], predicate: BooleanPredicate<unknown>) => boolean;
 /**
  * Checks whether a tuple matches the provided element predicates in order.
  *
@@ -617,7 +654,7 @@ declare const everyArrayValue: (values: readonly unknown[], predicate: (value: u
  * @param predicates Predicates aligned to each tuple index.
  * @returns Whether lengths match and each index passes.
  */
-declare const everyTupleValue: (values: readonly unknown[], predicates: readonly ((value: unknown) => boolean)[]) => boolean;
+declare const everyTupleValue: (values: readonly unknown[], predicates: readonly BooleanPredicate<unknown>[]) => boolean;
 /**
  * Checks whether every set value satisfies the provided predicate.
  *
@@ -625,7 +662,7 @@ declare const everyTupleValue: (values: readonly unknown[], predicates: readonly
  * @param predicate Predicate applied to each value.
  * @returns Whether all set values satisfy `predicate`.
  */
-declare const everySetValue: (values: ReadonlySet<unknown>, predicate: (value: unknown) => boolean) => boolean;
+declare const everySetValue: (values: ReadonlySet<unknown>, predicate: BooleanPredicate<unknown>) => boolean;
 /**
  * Checks whether every map entry satisfies the provided key and value predicates.
  *
@@ -634,7 +671,7 @@ declare const everySetValue: (values: ReadonlySet<unknown>, predicate: (value: u
  * @param valuePredicate Predicate applied to each value.
  * @returns Whether all keys and values satisfy their predicates.
  */
-declare const everyMapEntry: (values: ReadonlyMap<unknown, unknown>, keyPredicate: (key: unknown) => boolean, valuePredicate: (value: unknown) => boolean) => boolean;
+declare const everyMapEntry: (values: ReadonlyMap<unknown, unknown>, keyPredicate: BooleanPredicate<unknown>, valuePredicate: BooleanPredicate<unknown>) => boolean;
 /**
  * Checks whether every own enumerable string key/value pair satisfies the provided predicates.
  *
@@ -643,7 +680,7 @@ declare const everyMapEntry: (values: ReadonlyMap<unknown, unknown>, keyPredicat
  * @param valuePredicate Predicate applied to each corresponding value.
  * @returns Whether all enumerable entries satisfy their predicates.
  */
-declare const everyOwnEnumerableEntry: (values: Record<string, unknown>, keyPredicate: (key: string) => boolean, valuePredicate: (value: unknown) => boolean) => boolean;
+declare const everyOwnEnumerableEntry: (values: Record<string, unknown>, keyPredicate: BooleanPredicate<string>, valuePredicate: BooleanPredicate<unknown>) => boolean;
 
 /**
  * Converts predicates to plain boolean predicates for iteration helpers.
@@ -653,4 +690,4 @@ declare const everyOwnEnumerableEntry: (values: Record<string, unknown>, keyPred
  */
 declare const toBooleanPredicates: <A>(predicates: readonly ((value: A) => boolean)[]) => ReadonlyArray<(value: A) => boolean>;
 
-export { type ChainResult, type Guard, type GuardedOf, type GuardedWithin, type InferSchema, type OptionalSchemaField, type OutOfGuards, type ParseResult, type Predicate, type Primitive, type Refine, type RefineChain, type Refinement, type Schema, type SchemaField, and, andAll, arrayOf, assert, define, equals, equalsBy, equalsKey, everyArrayValue, everyMapEntry, everyOwnEnumerableEntry, everySetValue, everyTupleValue, guardIn, hasKey, hasKeys, isArray, isArrayBuffer, isAsyncIterable, isBigInt, isBlob, isBoolean, isDataView, isDate, isError, isFiniteNumber, isFunction, isInfiniteNumber, isInstanceOf, isInteger, isIterable, isMap, isNaN, isNegative, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPositive, isPrimitive, isPromiseLike, isRegExp, isSafeInteger, isSet, isString, isSymbol, isTypedArray, isURL, isUndefined, isWeakMap, isWeakSet, isZero, mapOf, narrowKeyTo, nonEmptyArrayOf, nonNull, not, nullable, nullish, oneOf, oneOfValues, optional, optionalKey, or, predicateToRefine, recordOf, required, safeJsonParse, safeParse, safeParseWith, setOf, struct, toBooleanPredicates, tupleOf, typedStruct };
+export { type ChainResult, type Guard, type GuardedOf, type GuardedWithin, type InferSchema, type OptionalSchemaField, type OutOfGuards, type ParseResult, type Predicate, type Primitive, type Refine, type RefineChain, type Refinement, type Schema, type SchemaField, and, andAll, arrayOf, assert, define, equals, equalsBy, equalsKey, everyArrayValue, everyMapEntry, everyOwnEnumerableEntry, everySetValue, everyTupleValue, guardIn, hasKey, hasKeys, isArray, isArrayBuffer, isAsyncIterable, isBigInt, isBlob, isBoolean, isDataView, isDate, isError, isFile, isFiniteNumber, isFunction, isInfiniteNumber, isInstanceOf, isInteger, isIterable, isMap, isNaN, isNegative, isNil, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPositive, isPrimitive, isPromiseLike, isRegExp, isSafeInteger, isSet, isString, isSymbol, isTypedArray, isURL, isUndefined, isWeakMap, isWeakSet, isZero, lazy, mapOf, narrowKeyTo, nonEmptyArrayOf, nonNull, not, nullable, nullish, oneOf, oneOfValues, optional, optionalKey, or, predicateToRefine, recordOf, required, safeJsonParse, safeParse, safeParseWith, setOf, struct, toBooleanPredicates, tupleOf, typedStruct };

package/dist/index.d.ts

@@ -133,6 +133,17 @@ declare const hasKeys: <const KS extends readonly [PropertyKey, ...PropertyKey[]
  */
 declare function narrowKeyTo<A, K extends keyof A>(guard: Guard<A>, key: K): <const T extends A[K]>(target: T) => Predicate<A & Record<K, T>>;
 
+/**
+ * Creates a predicate whose implementation is initialized on first use.
+ *
+ * The initialized predicate is cached after the factory returns successfully.
+ * Circular references in the input value are not detected.
+ *
+ * @param factory Function that creates the predicate when it is first evaluated.
+ * @returns Predicate that delegates to the lazily initialized implementation.
+ */
+declare function lazy<T>(factory: () => Predicate<T>): Predicate<T>;
+
 /**
  * Combines a precondition guard with an additional refinement to narrow the type.
  *
@@ -340,15 +351,34 @@ declare const isSymbol: Predicate<symbol>;
 /**
  * Checks whether a value is exactly `undefined`.
  *
+ * To accept `null` as well, use {@link isNil}.
+ *
  * @returns Predicate narrowing to `undefined`.
  */
 declare const isUndefined: Predicate<undefined>;
 /**
  * Checks whether a value is exactly `null`.
  *
+ * To accept `undefined` as well, use {@link isNil}.
+ *
  * @returns Predicate narrowing to `null`.
  */
 declare const isNull: Predicate<null>;
+/**
+ * Checks whether a value is `null` or `undefined` (nullish).
+ *
+ * Prefer this over hand-rolling `isNull(x) || isUndefined(x)`: it is the same
+ * check expressed once. To widen an existing guard so it also accepts nullish
+ * values, use {@link nullish} instead.
+ *
+ * @returns Predicate narrowing to `null | undefined`.
+ * @example
+ * isNil(null); // true
+ * isNil(undefined); // true
+ * isNil(0); // false
+ * @see or
+ */
+declare const isNil: Guard<null | undefined>;
 /**
  * Checks whether a value is a JavaScript primitive.
  *
@@ -474,6 +504,12 @@ declare const isURL: Guard<URL>;
  * @returns Predicate narrowing to `Blob` when supported; otherwise always false.
  */
 declare const isBlob: Guard<Blob>;
+/**
+ * Checks whether a value is a `File` (in environments with File available).
+ *
+ * @returns Predicate narrowing to `File` when supported; otherwise always false.
+ */
+declare const isFile: Guard<File>;
 /**
  * Creates a guard that checks whether a value is an instance of `constructor`.
  *
@@ -602,6 +638,7 @@ declare function tupleOf<const Fs extends readonly Predicate<unknown>[]>(...guar
     readonly [K in keyof Fs]: GuardedOf<Fs[K]>;
 }>;
 
+type BooleanPredicate<T> = (value: T) => boolean;
 /**
  * Checks whether every array element satisfies the provided predicate.
  *
@@ -609,7 +646,7 @@ declare function tupleOf<const Fs extends readonly Predicate<unknown>[]>(...guar
  * @param predicate Predicate applied to each element.
  * @returns Whether all elements satisfy `predicate`.
  */
-declare const everyArrayValue: (values: readonly unknown[], predicate: (value: unknown) => boolean) => boolean;
+declare const everyArrayValue: (values: readonly unknown[], predicate: BooleanPredicate<unknown>) => boolean;
 /**
  * Checks whether a tuple matches the provided element predicates in order.
  *
@@ -617,7 +654,7 @@ declare const everyArrayValue: (values: readonly unknown[], predicate: (value: u
  * @param predicates Predicates aligned to each tuple index.
  * @returns Whether lengths match and each index passes.
  */
-declare const everyTupleValue: (values: readonly unknown[], predicates: readonly ((value: unknown) => boolean)[]) => boolean;
+declare const everyTupleValue: (values: readonly unknown[], predicates: readonly BooleanPredicate<unknown>[]) => boolean;
 /**
  * Checks whether every set value satisfies the provided predicate.
  *
@@ -625,7 +662,7 @@ declare const everyTupleValue: (values: readonly unknown[], predicates: readonly
  * @param predicate Predicate applied to each value.
  * @returns Whether all set values satisfy `predicate`.
  */
-declare const everySetValue: (values: ReadonlySet<unknown>, predicate: (value: unknown) => boolean) => boolean;
+declare const everySetValue: (values: ReadonlySet<unknown>, predicate: BooleanPredicate<unknown>) => boolean;
 /**
  * Checks whether every map entry satisfies the provided key and value predicates.
  *
@@ -634,7 +671,7 @@ declare const everySetValue: (values: ReadonlySet<unknown>, predicate: (value: u
  * @param valuePredicate Predicate applied to each value.
  * @returns Whether all keys and values satisfy their predicates.
  */
-declare const everyMapEntry: (values: ReadonlyMap<unknown, unknown>, keyPredicate: (key: unknown) => boolean, valuePredicate: (value: unknown) => boolean) => boolean;
+declare const everyMapEntry: (values: ReadonlyMap<unknown, unknown>, keyPredicate: BooleanPredicate<unknown>, valuePredicate: BooleanPredicate<unknown>) => boolean;
 /**
  * Checks whether every own enumerable string key/value pair satisfies the provided predicates.
  *
@@ -643,7 +680,7 @@ declare const everyMapEntry: (values: ReadonlyMap<unknown, unknown>, keyPredicat
  * @param valuePredicate Predicate applied to each corresponding value.
  * @returns Whether all enumerable entries satisfy their predicates.
  */
-declare const everyOwnEnumerableEntry: (values: Record<string, unknown>, keyPredicate: (key: string) => boolean, valuePredicate: (value: unknown) => boolean) => boolean;
+declare const everyOwnEnumerableEntry: (values: Record<string, unknown>, keyPredicate: BooleanPredicate<string>, valuePredicate: BooleanPredicate<unknown>) => boolean;
 
 /**
  * Converts predicates to plain boolean predicates for iteration helpers.
@@ -653,4 +690,4 @@ declare const everyOwnEnumerableEntry: (values: Record<string, unknown>, keyPred
  */
 declare const toBooleanPredicates: <A>(predicates: readonly ((value: A) => boolean)[]) => ReadonlyArray<(value: A) => boolean>;
 
-export { type ChainResult, type Guard, type GuardedOf, type GuardedWithin, type InferSchema, type OptionalSchemaField, type OutOfGuards, type ParseResult, type Predicate, type Primitive, type Refine, type RefineChain, type Refinement, type Schema, type SchemaField, and, andAll, arrayOf, assert, define, equals, equalsBy, equalsKey, everyArrayValue, everyMapEntry, everyOwnEnumerableEntry, everySetValue, everyTupleValue, guardIn, hasKey, hasKeys, isArray, isArrayBuffer, isAsyncIterable, isBigInt, isBlob, isBoolean, isDataView, isDate, isError, isFiniteNumber, isFunction, isInfiniteNumber, isInstanceOf, isInteger, isIterable, isMap, isNaN, isNegative, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPositive, isPrimitive, isPromiseLike, isRegExp, isSafeInteger, isSet, isString, isSymbol, isTypedArray, isURL, isUndefined, isWeakMap, isWeakSet, isZero, mapOf, narrowKeyTo, nonEmptyArrayOf, nonNull, not, nullable, nullish, oneOf, oneOfValues, optional, optionalKey, or, predicateToRefine, recordOf, required, safeJsonParse, safeParse, safeParseWith, setOf, struct, toBooleanPredicates, tupleOf, typedStruct };
+export { type ChainResult, type Guard, type GuardedOf, type GuardedWithin, type InferSchema, type OptionalSchemaField, type OutOfGuards, type ParseResult, type Predicate, type Primitive, type Refine, type RefineChain, type Refinement, type Schema, type SchemaField, and, andAll, arrayOf, assert, define, equals, equalsBy, equalsKey, everyArrayValue, everyMapEntry, everyOwnEnumerableEntry, everySetValue, everyTupleValue, guardIn, hasKey, hasKeys, isArray, isArrayBuffer, isAsyncIterable, isBigInt, isBlob, isBoolean, isDataView, isDate, isError, isFile, isFiniteNumber, isFunction, isInfiniteNumber, isInstanceOf, isInteger, isIterable, isMap, isNaN, isNegative, isNil, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPositive, isPrimitive, isPromiseLike, isRegExp, isSafeInteger, isSet, isString, isSymbol, isTypedArray, isURL, isUndefined, isWeakMap, isWeakSet, isZero, lazy, mapOf, narrowKeyTo, nonEmptyArrayOf, nonNull, not, nullable, nullish, oneOf, oneOfValues, optional, optionalKey, or, predicateToRefine, recordOf, required, safeJsonParse, safeParse, safeParseWith, setOf, struct, toBooleanPredicates, tupleOf, typedStruct };

package/dist/index.js

@@ -45,6 +45,7 @@ __export(index_exports, {
   isDataView: () => isDataView,
   isDate: () => isDate,
   isError: () => isError,
+  isFile: () => isFile,
   isFiniteNumber: () => isFiniteNumber,
   isFunction: () => isFunction,
   isInfiniteNumber: () => isInfiniteNumber,
@@ -54,6 +55,7 @@ __export(index_exports, {
   isMap: () => isMap,
   isNaN: () => isNaN,
   isNegative: () => isNegative,
+  isNil: () => isNil,
   isNull: () => isNull,
   isNumber: () => isNumber,
   isNumberPrimitive: () => isNumberPrimitive,
@@ -73,6 +75,7 @@ __export(index_exports, {
   isWeakMap: () => isWeakMap,
   isWeakSet: () => isWeakSet,
   isZero: () => isZero,
+  lazy: () => lazy,
   mapOf: () => mapOf,
   narrowKeyTo: () => narrowKeyTo,
   nonEmptyArrayOf: () => nonEmptyArrayOf,
@@ -111,6 +114,38 @@ function define(fn) {
   return (value) => !!fn(value);
 }
 
+// src/utils/guard-collections.ts
+var everyIterableValue = (values, predicate) => {
+  for (const value of values) {
+    if (!predicate(value)) return false;
+  }
+  return true;
+};
+var everyKeyValueEntry = (entries, predicate) => {
+  for (const [key, value] of entries) {
+    if (!predicate(key, value)) return false;
+  }
+  return true;
+};
+var everyArrayValue = (values, predicate) => everyIterableValue(values, predicate);
+var everyTupleValue = (values, predicates) => {
+  if (values.length !== predicates.length) return false;
+  for (let index = 0; index < predicates.length; index += 1) {
+    const predicate = predicates[index];
+    if (!predicate(values[index])) return false;
+  }
+  return true;
+};
+var everySetValue = (values, predicate) => everyIterableValue(values, predicate);
+var everyMapEntry = (values, keyPredicate, valuePredicate) => everyKeyValueEntry(
+  values,
+  (key, value) => keyPredicate(key) && valuePredicate(value)
+);
+var everyOwnEnumerableEntry = (values, keyPredicate, valuePredicate) => everyIterableValue(
+  Object.keys(values),
+  (key) => keyPredicate(key) && valuePredicate(values[key])
+);
+
 // src/utils/object-tags.ts
 var objectToString = Object.prototype.toString;
 var OBJECT_TAG_DATE = "[object Date]";
@@ -124,6 +159,9 @@ var OBJECT_TAG_DATA_VIEW = "[object DataView]";
 var OBJECT_TAG_ERROR = "[object Error]";
 var getTag = (value) => objectToString.call(value);
 
+// src/utils/to-boolean-predicates.ts
+var toBooleanPredicates = (predicates) => predicates;
+
 // src/core/object.ts
 var defineTagGuard = (tag) => define((value) => getTag(value) === tag);
 var defineOptionalInstanceGuard = (constructor) => constructor === void 0 ? define(() => false) : define(
@@ -176,6 +214,9 @@ var isURL = defineOptionalInstanceGuard(
 var isBlob = defineOptionalInstanceGuard(
   typeof Blob === "undefined" ? void 0 : Blob
 );
+var isFile = defineOptionalInstanceGuard(
+  typeof File === "undefined" ? void 0 : File
+);
 var isInstanceOf = (constructor) => define((value) => value instanceof constructor);
 
 // src/core/equals.ts
@@ -220,41 +261,14 @@ function narrowKeyTo(guard, key) {
   };
 }
 
-// src/utils/guard-collections.ts
-var everyArrayValue = (values, predicate) => {
-  for (const value of values) {
-    if (!predicate(value)) return false;
-  }
-  return true;
-};
-var everyTupleValue = (values, predicates) => {
-  if (values.length !== predicates.length) return false;
-  for (const [index, predicate] of predicates.entries()) {
-    if (!predicate(values[index])) return false;
-  }
-  return true;
-};
-var everySetValue = (values, predicate) => {
-  for (const value of values) {
-    if (!predicate(value)) return false;
-  }
-  return true;
-};
-var everyMapEntry = (values, keyPredicate, valuePredicate) => {
-  for (const [key, value] of values) {
-    if (!keyPredicate(key) || !valuePredicate(value)) return false;
-  }
-  return true;
-};
-var everyOwnEnumerableEntry = (values, keyPredicate, valuePredicate) => {
-  for (const key of Object.keys(values)) {
-    if (!keyPredicate(key) || !valuePredicate(values[key])) return false;
-  }
-  return true;
-};
-
-// src/utils/to-boolean-predicates.ts
-var toBooleanPredicates = (predicates) => predicates;
+// src/core/lazy.ts
+function lazy(factory) {
+  let predicate;
+  return (value) => {
+    predicate ??= factory();
+    return predicate(value);
+  };
+}
 
 // src/core/logic.ts
 function and(precondition, condition) {
@@ -362,6 +376,7 @@ var isBigInt = define((value) => typeof value === "bigint");
 var isSymbol = define((value) => typeof value === "symbol");
 var isUndefined = define((value) => value === void 0);
 var isNull = define((value) => value === null);
+var isNil = or(isNull, isUndefined);
 var isPrimitive = or(
   isString,
   isNumberPrimitive,
@@ -532,6 +547,7 @@ function tupleOf(...guards) {
   isDataView,
   isDate,
   isError,
+  isFile,
   isFiniteNumber,
   isFunction,
   isInfiniteNumber,
@@ -541,6 +557,7 @@ function tupleOf(...guards) {
   isMap,
   isNaN,
   isNegative,
+  isNil,
   isNull,
   isNumber,
   isNumberPrimitive,
@@ -560,6 +577,7 @@ function tupleOf(...guards) {
   isWeakMap,
   isWeakSet,
   isZero,
+  lazy,
   mapOf,
   narrowKeyTo,
   nonEmptyArrayOf,

package/dist/index.mjs

@@ -10,6 +10,38 @@ function define(fn) {
   return (value) => !!fn(value);
 }
 
+// src/utils/guard-collections.ts
+var everyIterableValue = (values, predicate) => {
+  for (const value of values) {
+    if (!predicate(value)) return false;
+  }
+  return true;
+};
+var everyKeyValueEntry = (entries, predicate) => {
+  for (const [key, value] of entries) {
+    if (!predicate(key, value)) return false;
+  }
+  return true;
+};
+var everyArrayValue = (values, predicate) => everyIterableValue(values, predicate);
+var everyTupleValue = (values, predicates) => {
+  if (values.length !== predicates.length) return false;
+  for (let index = 0; index < predicates.length; index += 1) {
+    const predicate = predicates[index];
+    if (!predicate(values[index])) return false;
+  }
+  return true;
+};
+var everySetValue = (values, predicate) => everyIterableValue(values, predicate);
+var everyMapEntry = (values, keyPredicate, valuePredicate) => everyKeyValueEntry(
+  values,
+  (key, value) => keyPredicate(key) && valuePredicate(value)
+);
+var everyOwnEnumerableEntry = (values, keyPredicate, valuePredicate) => everyIterableValue(
+  Object.keys(values),
+  (key) => keyPredicate(key) && valuePredicate(values[key])
+);
+
 // src/utils/object-tags.ts
 var objectToString = Object.prototype.toString;
 var OBJECT_TAG_DATE = "[object Date]";
@@ -23,6 +55,9 @@ var OBJECT_TAG_DATA_VIEW = "[object DataView]";
 var OBJECT_TAG_ERROR = "[object Error]";
 var getTag = (value) => objectToString.call(value);
 
+// src/utils/to-boolean-predicates.ts
+var toBooleanPredicates = (predicates) => predicates;
+
 // src/core/object.ts
 var defineTagGuard = (tag) => define((value) => getTag(value) === tag);
 var defineOptionalInstanceGuard = (constructor) => constructor === void 0 ? define(() => false) : define(
@@ -75,6 +110,9 @@ var isURL = defineOptionalInstanceGuard(
 var isBlob = defineOptionalInstanceGuard(
   typeof Blob === "undefined" ? void 0 : Blob
 );
+var isFile = defineOptionalInstanceGuard(
+  typeof File === "undefined" ? void 0 : File
+);
 var isInstanceOf = (constructor) => define((value) => value instanceof constructor);
 
 // src/core/equals.ts
@@ -119,41 +157,14 @@ function narrowKeyTo(guard, key) {
   };
 }
 
-// src/utils/guard-collections.ts
-var everyArrayValue = (values, predicate) => {
-  for (const value of values) {
-    if (!predicate(value)) return false;
-  }
-  return true;
-};
-var everyTupleValue = (values, predicates) => {
-  if (values.length !== predicates.length) return false;
-  for (const [index, predicate] of predicates.entries()) {
-    if (!predicate(values[index])) return false;
-  }
-  return true;
-};
-var everySetValue = (values, predicate) => {
-  for (const value of values) {
-    if (!predicate(value)) return false;
-  }
-  return true;
-};
-var everyMapEntry = (values, keyPredicate, valuePredicate) => {
-  for (const [key, value] of values) {
-    if (!keyPredicate(key) || !valuePredicate(value)) return false;
-  }
-  return true;
-};
-var everyOwnEnumerableEntry = (values, keyPredicate, valuePredicate) => {
-  for (const key of Object.keys(values)) {
-    if (!keyPredicate(key) || !valuePredicate(values[key])) return false;
-  }
-  return true;
-};
-
-// src/utils/to-boolean-predicates.ts
-var toBooleanPredicates = (predicates) => predicates;
+// src/core/lazy.ts
+function lazy(factory) {
+  let predicate;
+  return (value) => {
+    predicate ??= factory();
+    return predicate(value);
+  };
+}
 
 // src/core/logic.ts
 function and(precondition, condition) {
@@ -261,6 +272,7 @@ var isBigInt = define((value) => typeof value === "bigint");
 var isSymbol = define((value) => typeof value === "symbol");
 var isUndefined = define((value) => value === void 0);
 var isNull = define((value) => value === null);
+var isNil = or(isNull, isUndefined);
 var isPrimitive = or(
   isString,
   isNumberPrimitive,
@@ -430,6 +442,7 @@ export {
   isDataView,
   isDate,
   isError,
+  isFile,
   isFiniteNumber,
   isFunction,
   isInfiniteNumber,
@@ -439,6 +452,7 @@ export {
   isMap,
   isNaN,
   isNegative,
+  isNil,
   isNull,
   isNumber,
   isNumberPrimitive,
@@ -458,6 +472,7 @@ export {
   isWeakMap,
   isWeakSet,
   isZero,
+  lazy,
   mapOf,
   narrowKeyTo,
   nonEmptyArrayOf,

package/package.json

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