is-kit 1.7.1 → 1.7.3

package/README.md

@@ -371,7 +371,7 @@ https://is-kit-docs.vercel.app/
 
 ## 👨‍💻 Development
 
-Requires Node 22 and pnpm 10.12.4.
+Requires Node 22 and pnpm 10.33.4.
 
 - `pnpm lint`
 - `pnpm build`

package/dist/index.d.mts

@@ -345,12 +345,13 @@ declare const isNull: Predicate<null>;
  */
 declare const isPrimitive: Guard<string | number | bigint | boolean | symbol | null | undefined>;
 
+type AnyFunction = (...args: never[]) => unknown;
 /**
  * Checks whether a value is a function.
  *
- * @returns Predicate narrowing to `Function`.
+ * @returns Predicate narrowing to a callable value.
  */
-declare const isFunction: Predicate<Function>;
+declare const isFunction: Predicate<AnyFunction>;
 /**
  * Checks for non-null objects (including arrays, dates, etc.).
  *
@@ -452,13 +453,13 @@ declare const isError: Predicate<Error>;
  *
  * @returns Predicate narrowing to `URL` when supported; otherwise always false.
  */
-declare const isURL: Predicate<URL>;
+declare const isURL: Guard<URL>;
 /**
  * Checks whether a value is a `Blob` (in environments with Blob available).
  *
  * @returns Predicate narrowing to `Blob` when supported; otherwise always false.
  */
-declare const isBlob: Predicate<Blob>;
+declare const isBlob: Guard<Blob>;
 /**
  * Creates a guard that checks whether a value is an instance of `constructor`.
  *

package/dist/index.d.ts

@@ -345,12 +345,13 @@ declare const isNull: Predicate<null>;
  */
 declare const isPrimitive: Guard<string | number | bigint | boolean | symbol | null | undefined>;
 
+type AnyFunction = (...args: never[]) => unknown;
 /**
  * Checks whether a value is a function.
  *
- * @returns Predicate narrowing to `Function`.
+ * @returns Predicate narrowing to a callable value.
  */
-declare const isFunction: Predicate<Function>;
+declare const isFunction: Predicate<AnyFunction>;
 /**
  * Checks for non-null objects (including arrays, dates, etc.).
  *
@@ -452,13 +453,13 @@ declare const isError: Predicate<Error>;
  *
  * @returns Predicate narrowing to `URL` when supported; otherwise always false.
  */
-declare const isURL: Predicate<URL>;
+declare const isURL: Guard<URL>;
 /**
  * Checks whether a value is a `Blob` (in environments with Blob available).
  *
  * @returns Predicate narrowing to `Blob` when supported; otherwise always false.
  */
-declare const isBlob: Predicate<Blob>;
+declare const isBlob: Guard<Blob>;
 /**
  * Creates a guard that checks whether a value is an instance of `constructor`.
  *

package/dist/index.js

@@ -123,12 +123,19 @@ var OBJECT_TAG_ERROR = "[object Error]";
 var getTag = (value) => objectToString.call(value);
 
 // src/core/object.ts
+var defineOptionalInstanceGuard = (constructor) => constructor === void 0 ? define(() => false) : define(
+  (value) => typeof constructor === "function" && value instanceof constructor
+);
 var isFunction = define(
   (value) => typeof value === "function"
 );
 var isObject = define(
   (value) => typeof value === "object" && value !== null
 );
+var readObjectProperty = (value, key) => {
+  if (!isObject(value) && !isFunction(value)) return void 0;
+  return value[key];
+};
 var isPlainObject = define((value) => {
   if (!isObject(value)) return false;
   const proto = Object.getPrototypeOf(value);
@@ -153,18 +160,15 @@ var isWeakMap = define(
 var isWeakSet = define(
   (value) => getTag(value) === OBJECT_TAG_WEAK_SET
 );
-var isPromiseLike = define((value) => {
-  if (!isObject(value) && !isFunction(value)) return false;
-  return isFunction(value.then);
-});
-var isIterable = define((value) => {
-  if (!isObject(value) && !isFunction(value)) return false;
-  return isFunction(value[Symbol.iterator]);
-});
-var isAsyncIterable = define((value) => {
-  if (!isObject(value) && !isFunction(value)) return false;
-  return isFunction(value[Symbol.asyncIterator]);
-});
+var isPromiseLike = define(
+  (value) => isFunction(readObjectProperty(value, "then"))
+);
+var isIterable = define(
+  (value) => isFunction(readObjectProperty(value, Symbol.iterator))
+);
+var isAsyncIterable = define(
+  (value) => isFunction(readObjectProperty(value, Symbol.asyncIterator))
+);
 var isArrayBuffer = define(
   (value) => getTag(value) === OBJECT_TAG_ARRAY_BUFFER
 );
@@ -177,8 +181,12 @@ var isTypedArray = define(
 var isError = define(
   (value) => value instanceof Error || getTag(value) === OBJECT_TAG_ERROR
 );
-var isURL = typeof URL !== "undefined" ? define((value) => value instanceof URL) : define(() => false);
-var isBlob = typeof Blob !== "undefined" ? define((value) => value instanceof Blob) : define(() => false);
+var isURL = defineOptionalInstanceGuard(
+  typeof URL === "undefined" ? void 0 : URL
+);
+var isBlob = defineOptionalInstanceGuard(
+  typeof Blob === "undefined" ? void 0 : Blob
+);
 var isInstanceOf = (constructor) => define((value) => value instanceof constructor);
 
 // src/core/equals.ts
@@ -445,7 +453,7 @@ function setOf(valueGuard) {
 var isOptionalSchemaField = define(
   // WHY: Optional fields are represented as a small tagged object so `struct`
   // can distinguish schema metadata from plain predicate functions up front.
-  (field) => isObject(field) && field.optional === true && typeof field.guard === "function"
+  (field) => isObject(field) && field.optional === true && isFunction(field.guard)
 );
 var hasRequiredKeys = (obj, entries) => (
   // WHY: Required fields must be own properties; inherited values should not

package/dist/index.mjs

@@ -24,12 +24,19 @@ var OBJECT_TAG_ERROR = "[object Error]";
 var getTag = (value) => objectToString.call(value);
 
 // src/core/object.ts
+var defineOptionalInstanceGuard = (constructor) => constructor === void 0 ? define(() => false) : define(
+  (value) => typeof constructor === "function" && value instanceof constructor
+);
 var isFunction = define(
   (value) => typeof value === "function"
 );
 var isObject = define(
   (value) => typeof value === "object" && value !== null
 );
+var readObjectProperty = (value, key) => {
+  if (!isObject(value) && !isFunction(value)) return void 0;
+  return value[key];
+};
 var isPlainObject = define((value) => {
   if (!isObject(value)) return false;
   const proto = Object.getPrototypeOf(value);
@@ -54,18 +61,15 @@ var isWeakMap = define(
 var isWeakSet = define(
   (value) => getTag(value) === OBJECT_TAG_WEAK_SET
 );
-var isPromiseLike = define((value) => {
-  if (!isObject(value) && !isFunction(value)) return false;
-  return isFunction(value.then);
-});
-var isIterable = define((value) => {
-  if (!isObject(value) && !isFunction(value)) return false;
-  return isFunction(value[Symbol.iterator]);
-});
-var isAsyncIterable = define((value) => {
-  if (!isObject(value) && !isFunction(value)) return false;
-  return isFunction(value[Symbol.asyncIterator]);
-});
+var isPromiseLike = define(
+  (value) => isFunction(readObjectProperty(value, "then"))
+);
+var isIterable = define(
+  (value) => isFunction(readObjectProperty(value, Symbol.iterator))
+);
+var isAsyncIterable = define(
+  (value) => isFunction(readObjectProperty(value, Symbol.asyncIterator))
+);
 var isArrayBuffer = define(
   (value) => getTag(value) === OBJECT_TAG_ARRAY_BUFFER
 );
@@ -78,8 +82,12 @@ var isTypedArray = define(
 var isError = define(
   (value) => value instanceof Error || getTag(value) === OBJECT_TAG_ERROR
 );
-var isURL = typeof URL !== "undefined" ? define((value) => value instanceof URL) : define(() => false);
-var isBlob = typeof Blob !== "undefined" ? define((value) => value instanceof Blob) : define(() => false);
+var isURL = defineOptionalInstanceGuard(
+  typeof URL === "undefined" ? void 0 : URL
+);
+var isBlob = defineOptionalInstanceGuard(
+  typeof Blob === "undefined" ? void 0 : Blob
+);
 var isInstanceOf = (constructor) => define((value) => value instanceof constructor);
 
 // src/core/equals.ts
@@ -346,7 +354,7 @@ function setOf(valueGuard) {
 var isOptionalSchemaField = define(
   // WHY: Optional fields are represented as a small tagged object so `struct`
   // can distinguish schema metadata from plain predicate functions up front.
-  (field) => isObject(field) && field.optional === true && typeof field.guard === "function"
+  (field) => isObject(field) && field.optional === true && isFunction(field.guard)
 );
 var hasRequiredKeys = (obj, entries) => (
   // WHY: Required fields must be own properties; inherited values should not

package/package.json

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