is-what 3.9.0 → 3.11.2

package/.eslintignore

@@ -6,3 +6,4 @@ dist
 coverage
 
 test
+.eslintrc.js

package/README.md

@@ -1,10 +1,12 @@
 # is What? 🙉
 
+Very simple & small JS type check functions. It's fully TypeScript supported!
+
 ```
 npm i is-what
 ```
 
-Very simple & small JS type check functions. It's fully TypeScript supported!
+Or for deno available at: `"deno.land/x/is_what"`
 
 ## Motivation
 
@@ -110,7 +112,7 @@ getType(specialObject) // returns 'Object'
 
 is-what makes TypeScript know the type during if statements. This means that a check returns the type of the payload for TypeScript users.
 
-```TypeScript
+```ts
 function isNumber (payload: any): payload is number {
   // return boolean
 }
@@ -127,7 +129,7 @@ function fn (payload: string | number): number {
 
 `isPlainObject` and `isAnyObject` with TypeScript will declare the payload to be an object type with any props:
 
-```TypeScript
+```ts
 function isPlainObject (payload: any): payload is {[key: string]: any}
 function isAnyObject (payload: any): payload is {[key: string]: any}
 // The reason to return `{[key: string]: any}` is to be able to do
@@ -139,7 +141,7 @@ if (isPlainObject(payload) && payload.id) return payload.id
 
 If you want more control over which kind of objects are allowed you can use `isObjectLike<T>`:
 
-```TypeScript
+```ts
 import { isObjectLike } from 'is-what'
 // usage examples:
 isObjectLike<{specificKey: string}>(payload)
@@ -149,7 +151,7 @@ isObjectLike<object>(payload)
 
 `isObjectLike<T>` works like this under the hood:
 
-```TypeScript
+```ts
 function isObjectLike<T extends object> (payload: any): payload is T {
   return isAnyObject(payload)
 }

package/{build/rollup.js → build.js}

@@ -18,7 +18,7 @@ import typescript from 'rollup-plugin-typescript2'
 // ------------------------------------------------------------------------------------------
 // setup
 // ------------------------------------------------------------------------------------------
-const pkg = require('../package.json')
+const pkg = require('./package.json')
 const name = pkg.name
 const className = name.replace(/(^\w|-\w)/g, c => c.replace('-', '').toUpperCase())
 const external = Object.keys(pkg.dependencies || [])

package/dist/index.cjs.js

@@ -33,7 +33,7 @@ function isNull(payload) {
  * Returns whether the payload is a plain JavaScript object (excluding special classes or objects with other prototypes)
  *
  * @param {*} payload
- * @returns {payload is {[key: string]: any}}
+ * @returns {payload is Record<string, any>}
  */
 function isPlainObject(payload) {
     if (getType(payload) !== 'Object')
@@ -44,16 +44,25 @@ function isPlainObject(payload) {
  * Returns whether the payload is a plain JavaScript object (excluding special classes or objects with other prototypes)
  *
  * @param {*} payload
- * @returns {payload is {[key: string]: any}}
+ * @returns {payload is Record<string, any>}
  */
 function isObject(payload) {
     return isPlainObject(payload);
 }
+/**
+ * Returns whether the payload is a an empty object (excluding special classes or objects with other prototypes)
+ *
+ * @param {*} payload
+ * @returns {payload is { [K in any]: never }}
+ */
+function isEmptyObject(payload) {
+    return isPlainObject(payload) && Object.keys(payload).length === 0;
+}
 /**
  * Returns whether the payload is an any kind of object (including special classes or objects with different prototypes)
  *
  * @param {*} payload
- * @returns {payload is {[key: string]: any}}
+ * @returns {payload is Record<string, any>}
  */
 function isAnyObject(payload) {
     return getType(payload) === 'Object';
@@ -74,7 +83,7 @@ function isObjectLike(payload) {
  * Returns whether the payload is a function
  *
  * @param {*} payload
- * @returns {payload is Function}
+ * @returns {payload is AnyFunction}
  */
 function isFunction(payload) {
     return getType(payload) === 'Function';
@@ -82,12 +91,21 @@ function isFunction(payload) {
 /**
  * Returns whether the payload is an array
  *
- * @param {*} payload
- * @returns {payload is undefined}
+ * @param {any} payload
+ * @returns {payload is any[]}
  */
 function isArray(payload) {
     return getType(payload) === 'Array';
 }
+/**
+ * Returns whether the payload is a an empty array
+ *
+ * @param {*} payload
+ * @returns {payload is []}
+ */
+function isEmptyArray(payload) {
+    return isArray(payload) && payload.length === 0;
+}
 /**
  * Returns whether the payload is a string
  *
@@ -116,9 +134,9 @@ function isEmptyString(payload) {
     return payload === '';
 }
 /**
- * Returns whether the payload is a number
+ * Returns whether the payload is a number (but not NaN)
  *
- * This will return false for NaN
+ * This will return `false` for `NaN`!!
  *
  * @param {*} payload
  * @returns {payload is number}
@@ -148,7 +166,7 @@ function isRegExp(payload) {
  * Returns whether the payload is a Map
  *
  * @param {*} payload
- * @returns {payload is Map}
+ * @returns {payload is Map<any, any>}
  */
 function isMap(payload) {
     return getType(payload) === 'Map';
@@ -157,7 +175,7 @@ function isMap(payload) {
  * Returns whether the payload is a WeakMap
  *
  * @param {*} payload
- * @returns {payload is WeakMap}
+ * @returns {payload is WeakMap<any, any>}
  */
 function isWeakMap(payload) {
     return getType(payload) === 'WeakMap';
@@ -166,7 +184,7 @@ function isWeakMap(payload) {
  * Returns whether the payload is a Set
  *
  * @param {*} payload
- * @returns {payload is Set}
+ * @returns {payload is Set<any>}
  */
 function isSet(payload) {
     return getType(payload) === 'Set';
@@ -175,7 +193,7 @@ function isSet(payload) {
  * Returns whether the payload is a WeakSet
  *
  * @param {*} payload
- * @returns {payload is WeakSet}
+ * @returns {payload is WeakSet<any>}
  */
 function isWeakSet(payload) {
     return getType(payload) === 'WeakSet';
@@ -220,7 +238,7 @@ function isFile(payload) {
  * Returns whether the payload is a Promise
  *
  * @param {*} payload
- * @returns {payload is Promise}
+ * @returns {payload is Promise<any>}
  */
 function isPromise(payload) {
     return getType(payload) === 'Promise';
@@ -235,7 +253,7 @@ function isError(payload) {
     return getType(payload) === 'Error';
 }
 /**
- * Returns whether the payload is an Error
+ * Returns whether the payload is literally the value `NaN` (it's `NaN` and also a `number`)
  *
  * @param {*} payload
  * @returns {payload is typeof NaN}
@@ -295,6 +313,8 @@ exports.isArray = isArray;
 exports.isBlob = isBlob;
 exports.isBoolean = isBoolean;
 exports.isDate = isDate;
+exports.isEmptyArray = isEmptyArray;
+exports.isEmptyObject = isEmptyObject;
 exports.isEmptyString = isEmptyString;
 exports.isError = isError;
 exports.isFile = isFile;

package/dist/index.esm.js

@@ -29,7 +29,7 @@ function isNull(payload) {
  * Returns whether the payload is a plain JavaScript object (excluding special classes or objects with other prototypes)
  *
  * @param {*} payload
- * @returns {payload is {[key: string]: any}}
+ * @returns {payload is Record<string, any>}
  */
 function isPlainObject(payload) {
     if (getType(payload) !== 'Object')
@@ -40,16 +40,25 @@ function isPlainObject(payload) {
  * Returns whether the payload is a plain JavaScript object (excluding special classes or objects with other prototypes)
  *
  * @param {*} payload
- * @returns {payload is {[key: string]: any}}
+ * @returns {payload is Record<string, any>}
  */
 function isObject(payload) {
     return isPlainObject(payload);
 }
+/**
+ * Returns whether the payload is a an empty object (excluding special classes or objects with other prototypes)
+ *
+ * @param {*} payload
+ * @returns {payload is { [K in any]: never }}
+ */
+function isEmptyObject(payload) {
+    return isPlainObject(payload) && Object.keys(payload).length === 0;
+}
 /**
  * Returns whether the payload is an any kind of object (including special classes or objects with different prototypes)
  *
  * @param {*} payload
- * @returns {payload is {[key: string]: any}}
+ * @returns {payload is Record<string, any>}
  */
 function isAnyObject(payload) {
     return getType(payload) === 'Object';
@@ -70,7 +79,7 @@ function isObjectLike(payload) {
  * Returns whether the payload is a function
  *
  * @param {*} payload
- * @returns {payload is Function}
+ * @returns {payload is AnyFunction}
  */
 function isFunction(payload) {
     return getType(payload) === 'Function';
@@ -78,12 +87,21 @@ function isFunction(payload) {
 /**
  * Returns whether the payload is an array
  *
- * @param {*} payload
- * @returns {payload is undefined}
+ * @param {any} payload
+ * @returns {payload is any[]}
  */
 function isArray(payload) {
     return getType(payload) === 'Array';
 }
+/**
+ * Returns whether the payload is a an empty array
+ *
+ * @param {*} payload
+ * @returns {payload is []}
+ */
+function isEmptyArray(payload) {
+    return isArray(payload) && payload.length === 0;
+}
 /**
  * Returns whether the payload is a string
  *
@@ -112,9 +130,9 @@ function isEmptyString(payload) {
     return payload === '';
 }
 /**
- * Returns whether the payload is a number
+ * Returns whether the payload is a number (but not NaN)
  *
- * This will return false for NaN
+ * This will return `false` for `NaN`!!
  *
  * @param {*} payload
  * @returns {payload is number}
@@ -144,7 +162,7 @@ function isRegExp(payload) {
  * Returns whether the payload is a Map
  *
  * @param {*} payload
- * @returns {payload is Map}
+ * @returns {payload is Map<any, any>}
  */
 function isMap(payload) {
     return getType(payload) === 'Map';
@@ -153,7 +171,7 @@ function isMap(payload) {
  * Returns whether the payload is a WeakMap
  *
  * @param {*} payload
- * @returns {payload is WeakMap}
+ * @returns {payload is WeakMap<any, any>}
  */
 function isWeakMap(payload) {
     return getType(payload) === 'WeakMap';
@@ -162,7 +180,7 @@ function isWeakMap(payload) {
  * Returns whether the payload is a Set
  *
  * @param {*} payload
- * @returns {payload is Set}
+ * @returns {payload is Set<any>}
  */
 function isSet(payload) {
     return getType(payload) === 'Set';
@@ -171,7 +189,7 @@ function isSet(payload) {
  * Returns whether the payload is a WeakSet
  *
  * @param {*} payload
- * @returns {payload is WeakSet}
+ * @returns {payload is WeakSet<any>}
  */
 function isWeakSet(payload) {
     return getType(payload) === 'WeakSet';
@@ -216,7 +234,7 @@ function isFile(payload) {
  * Returns whether the payload is a Promise
  *
  * @param {*} payload
- * @returns {payload is Promise}
+ * @returns {payload is Promise<any>}
  */
 function isPromise(payload) {
     return getType(payload) === 'Promise';
@@ -231,7 +249,7 @@ function isError(payload) {
     return getType(payload) === 'Error';
 }
 /**
- * Returns whether the payload is an Error
+ * Returns whether the payload is literally the value `NaN` (it's `NaN` and also a `number`)
  *
  * @param {*} payload
  * @returns {payload is typeof NaN}
@@ -285,4 +303,4 @@ function isType(payload, type) {
     return getType(payload) === name || Boolean(payload && payload.constructor === type);
 }
 
-export { getType, isAnyObject, isArray, isBlob, isBoolean, isDate, isEmptyString, isError, isFile, isFullString, isFunction, isMap, isNaNValue, isNull, isNullOrUndefined, isNumber, isObject, isObjectLike, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isType, isUndefined, isWeakMap, isWeakSet };
+export { getType, isAnyObject, isArray, isBlob, isBoolean, isDate, isEmptyArray, isEmptyObject, isEmptyString, isError, isFile, isFullString, isFunction, isMap, isNaNValue, isNull, isNullOrUndefined, isNumber, isObject, isObjectLike, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isType, isUndefined, isWeakMap, isWeakSet };

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "is-what",
   "sideEffects": false,
-  "version": "3.9.0",
+  "version": "3.11.2",
   "description": "JS type check (TypeScript supported) functions like `isPlainObject() isArray()` etc. A simple & small integration.",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
   "typings": "types/index.d.ts",
   "scripts": {
-    "ava": "ava",
-    "test": "jest",
-    "test-w": "jest --watchAll",
+    "test": "ava",
+    "jest": "jest",
+    "jest-w": "jest --watchAll",
     "lint": "eslint . --ext .js,.jsx,.ts,.tsx",
-    "rollup": "rollup -c ./build/rollup.js",
-    "build": "npm run lint && npm run rollup && npm run test"
+    "rollup": "rollup -c ./build.js",
+    "build": "rm -rf types && rm -rf dist && npm run lint && npm run rollup && npm run test && npm run jest"
   },
   "repository": {
     "type": "git",
@@ -47,28 +47,33 @@
   "homepage": "https://github.com/mesqueeb/is-what#readme",
   "dependencies": {},
   "devDependencies": {
-    "@babel/core": "^7.9.0",
+    "@babel/core": "^7.11.5",
     "@types/babel-core": "^6.25.6",
-    "@types/jest": "^25.2.1",
-    "@typescript-eslint/eslint-plugin": "^2.27.0",
-    "@typescript-eslint/parser": "^2.27.0",
-    "ava": "^3.6.0",
+    "@types/jest": "^26.0.12",
+    "@typescript-eslint/eslint-plugin": "^4.0.1",
+    "@typescript-eslint/parser": "^4.0.1",
+    "ava": "^3.12.1",
     "babel-core": "^7.0.0-bridge.0",
-    "babel-jest": "^25.3.0",
+    "babel-jest": "^26.3.0",
     "babel-preset-env": "^1.7.0",
-    "eslint": "^6.8.0",
-    "eslint-config-prettier": "^6.10.1",
+    "eslint": "^7.8.1",
+    "eslint-config-prettier": "^6.11.0",
     "eslint-plugin-tree-shaking": "^1.8.0",
-    "jest": "^25.3.0",
-    "regenerator-runtime": "^0.13.5",
-    "rollup": "^1.32.1",
-    "rollup-plugin-typescript2": "^0.26.0",
+    "jest": "^26.4.2",
+    "regenerator-runtime": "^0.13.7",
+    "rollup": "^2.26.9",
+    "rollup-plugin-typescript2": "^0.27.2",
     "tsconfig-paths": "^3.9.0",
-    "ts-node": "^8.8.2",
-    "typescript": "^3.8.3"
+    "ts-node": "^9.0.0",
+    "typescript": "^4.0.2"
   },
   "ava": {
-    "extensions": ["ts"],
-    "require": ["tsconfig-paths/register", "ts-node/register"]
+    "extensions": [
+      "ts"
+    ],
+    "require": [
+      "tsconfig-paths/register",
+      "ts-node/register"
+    ]
   }
 }

package/src/index.ts

@@ -1,3 +1,6 @@
+export type AnyFunction = (...args: any[]) => any
+export type AnyClass = new (...args: any[]) => any
+
 /**
  * Returns the object type of the given payload
  *
@@ -32,9 +35,9 @@ export function isNull (payload: any): payload is null {
  * Returns whether the payload is a plain JavaScript object (excluding special classes or objects with other prototypes)
  *
  * @param {*} payload
- * @returns {payload is {[key: string]: any}}
+ * @returns {payload is Record<string, any>}
  */
-export function isPlainObject (payload: any): payload is { [key: string]: any } {
+export function isPlainObject (payload: any): payload is Record<string, any> {
   if (getType(payload) !== 'Object') return false
   return payload.constructor === Object && Object.getPrototypeOf(payload) === Object.prototype
 }
@@ -43,19 +46,29 @@ export function isPlainObject (payload: any): payload is { [key: string]: any }
  * Returns whether the payload is a plain JavaScript object (excluding special classes or objects with other prototypes)
  *
  * @param {*} payload
- * @returns {payload is {[key: string]: any}}
+ * @returns {payload is Record<string, any>}
  */
-export function isObject (payload: any): payload is { [key: string]: any } {
+export function isObject (payload: any): payload is Record<string, any> {
   return isPlainObject(payload)
 }
 
+/**
+ * Returns whether the payload is a an empty object (excluding special classes or objects with other prototypes)
+ *
+ * @param {*} payload
+ * @returns {payload is { [K in any]: never }}
+ */
+export function isEmptyObject (payload: any): payload is { [K in any]: never } {
+  return isPlainObject(payload) && Object.keys(payload).length === 0
+}
+
 /**
  * Returns whether the payload is an any kind of object (including special classes or objects with different prototypes)
  *
  * @param {*} payload
- * @returns {payload is {[key: string]: any}}
+ * @returns {payload is Record<string, any>}
  */
-export function isAnyObject (payload: any): payload is { [key: string]: any } {
+export function isAnyObject (payload: any): payload is Record<string, any> {
   return getType(payload) === 'Object'
 }
 
@@ -68,7 +81,7 @@ export function isAnyObject (payload: any): payload is { [key: string]: any } {
  * @param {*} payload
  * @returns {payload is T}
  */
-export function isObjectLike<T extends object> (payload: any): payload is T {
+export function isObjectLike<T extends Record<string, any>> (payload: any): payload is T {
   return isAnyObject(payload)
 }
 
@@ -76,22 +89,32 @@ export function isObjectLike<T extends object> (payload: any): payload is T {
  * Returns whether the payload is a function
  *
  * @param {*} payload
- * @returns {payload is Function}
+ * @returns {payload is AnyFunction}
  */
-export function isFunction (payload: any): payload is Function {
+export function isFunction (payload: any): payload is AnyFunction {
   return getType(payload) === 'Function'
 }
 
 /**
  * Returns whether the payload is an array
  *
- * @param {*} payload
- * @returns {payload is undefined}
+ * @param {any} payload
+ * @returns {payload is any[]}
  */
 export function isArray (payload: any): payload is any[] {
   return getType(payload) === 'Array'
 }
 
+/**
+ * Returns whether the payload is a an empty array
+ *
+ * @param {*} payload
+ * @returns {payload is []}
+ */
+export function isEmptyArray (payload: any): payload is [] {
+  return isArray(payload) && payload.length === 0
+}
+
 /**
  * Returns whether the payload is a string
  *
@@ -123,9 +146,9 @@ export function isEmptyString (payload: any): payload is string {
 }
 
 /**
- * Returns whether the payload is a number
+ * Returns whether the payload is a number (but not NaN)
  *
- * This will return false for NaN
+ * This will return `false` for `NaN`!!
  *
  * @param {*} payload
  * @returns {payload is number}
@@ -158,7 +181,7 @@ export function isRegExp (payload: any): payload is RegExp {
  * Returns whether the payload is a Map
  *
  * @param {*} payload
- * @returns {payload is Map}
+ * @returns {payload is Map<any, any>}
  */
 export function isMap (payload: any): payload is Map<any, any> {
   return getType(payload) === 'Map'
@@ -168,7 +191,7 @@ export function isMap (payload: any): payload is Map<any, any> {
  * Returns whether the payload is a WeakMap
  *
  * @param {*} payload
- * @returns {payload is WeakMap}
+ * @returns {payload is WeakMap<any, any>}
  */
 export function isWeakMap (payload: any): payload is WeakMap<any, any> {
   return getType(payload) === 'WeakMap'
@@ -178,7 +201,7 @@ export function isWeakMap (payload: any): payload is WeakMap<any, any> {
  * Returns whether the payload is a Set
  *
  * @param {*} payload
- * @returns {payload is Set}
+ * @returns {payload is Set<any>}
  */
 export function isSet (payload: any): payload is Set<any> {
   return getType(payload) === 'Set'
@@ -188,7 +211,7 @@ export function isSet (payload: any): payload is Set<any> {
  * Returns whether the payload is a WeakSet
  *
  * @param {*} payload
- * @returns {payload is WeakSet}
+ * @returns {payload is WeakSet<any>}
  */
 export function isWeakSet (payload: any): payload is WeakSet<any> {
   return getType(payload) === 'WeakSet'
@@ -238,7 +261,7 @@ export function isFile (payload: any): payload is File {
  * Returns whether the payload is a Promise
  *
  * @param {*} payload
- * @returns {payload is Promise}
+ * @returns {payload is Promise<any>}
  */
 export function isPromise (payload: any): payload is Promise<any> {
   return getType(payload) === 'Promise'
@@ -255,7 +278,7 @@ export function isError (payload: any): payload is Error {
 }
 
 /**
- * Returns whether the payload is an Error
+ * Returns whether the payload is literally the value `NaN` (it's `NaN` and also a `number`)
  *
  * @param {*} payload
  * @returns {payload is typeof NaN}
@@ -304,7 +327,7 @@ export function isNullOrUndefined (payload: any): payload is null | undefined {
  * @throws {TypeError} Will throw type error if type is an invalid type
  * @returns {payload is T}
  */
-export function isType<T extends Function> (payload: any, type: T): payload is T {
+export function isType<T extends AnyFunction | AnyClass> (payload: any, type: T): payload is T {
   if (!(type instanceof Function)) {
     throw new TypeError('Type must be a function')
   }

package/test/ava.ts

@@ -1,6 +1,7 @@
 import test from 'ava'
 import {
   isError,
+  isEmptyArray,
   isObject,
   isPlainObject,
   isAnyObject,
@@ -27,6 +28,7 @@ import {
   // isFile,
   isPromise,
   isNaNValue,
+  isEmptyObject,
 } from '../src/index'
 
 // const blob = Buffer.from([])
@@ -89,6 +91,41 @@ test('Basic false tests', t => {
   t.is(isNullOrUndefined(NaN), false)
 })
 
+test('isEmptyObject', t => {
+  t.is(isEmptyObject({}), true)
+  t.is(isEmptyObject(new Object()), true)
+
+  t.is(isEmptyObject('{}'), false)
+  t.is(isEmptyObject('{}'), false)
+  t.is(isEmptyObject(null), false)
+  t.is(isEmptyObject(new Date()), false)
+  t.is(isEmptyObject(new Error('')), false)
+  t.is(isEmptyObject(new Date()), false)
+  t.is(isEmptyObject(Symbol()), false)
+  t.is(isEmptyObject(new Map()), false)
+  t.is(isEmptyObject(new WeakMap()), false)
+  t.is(isEmptyObject(new Set()), false)
+  t.is(isEmptyObject(new WeakSet()), false)
+})
+
+test('isEmptyArray', t => {
+  t.is(isEmptyArray([]), true)
+  t.is(isEmptyArray(new Array()), true)
+  t.is(isEmptyArray(new Array(0)), true)
+  
+  t.is(isEmptyArray(new Array(1)), false)
+  t.is(isEmptyArray([undefined]), false)
+  t.is(isEmptyArray(null), false)
+  t.is(isEmptyArray(new Date()), false)
+  t.is(isEmptyArray(new Error('')), false)
+  t.is(isEmptyArray(new Date()), false)
+  t.is(isEmptyArray(Symbol()), false)
+  t.is(isEmptyArray(new Map()), false)
+  t.is(isEmptyArray(new WeakMap()), false)
+  t.is(isEmptyArray(new Set()), false)
+  t.is(isEmptyArray(new WeakSet()), false)
+})
+
 test('NaN tests', t => {
   t.is(isNaNValue(NaN), true)
   t.is(isNaNValue(new Error('')), false)
@@ -239,3 +276,34 @@ test('isObject vs isAnyObject', t => {
   t.is(isAnyObject(new Date('_')), false)
   t.is(isAnyObject(new Date()), false)
 })
+
+test('type related tests', t => {
+  t.pass()
+  // const fn: string | ((k: number) => string) = (p) => 'a'
+  // if (!isFunction(fn)) {
+  //   fn
+  // }
+
+  // const a: Record<string, number> = {}
+  
+  // a[fn(1)] = fn(2)
+
+  // const myArray: string | string[] = ['a', 'b']
+  // if (!isArray(myArray)) {
+  //   myArray
+  // }
+
+  // const a: Record<string, number> = {}
+  
+  // a[myArray[1]] = myArray[0]
+
+  // const myArray: string | any[] = [1, 2, 'a', 'b']
+  // if (!isArray(myArray)) {
+  //   myArray
+  // }
+
+  // const a: Record<string, number> = {}
+  
+  // a[myArray[1]] = myArray[0]
+
+})

package/tsconfig.json

@@ -1,5 +1,6 @@
 {
   "compilerOptions": {
+    "baseUrl": ".",
     "declaration": true,
     "declarationDir": "./types/"
   },

package/types/index.d.ts

@@ -1,3 +1,5 @@
+export declare type AnyFunction = (...args: any[]) => any;
+export declare type AnyClass = new (...args: any[]) => any;
 /**
  * Returns the object type of the given payload
  *
@@ -23,29 +25,32 @@ export declare function isNull(payload: any): payload is null;
  * Returns whether the payload is a plain JavaScript object (excluding special classes or objects with other prototypes)
  *
  * @param {*} payload
- * @returns {payload is {[key: string]: any}}
+ * @returns {payload is Record<string, any>}
  */
-export declare function isPlainObject(payload: any): payload is {
-    [key: string]: any;
-};
+export declare function isPlainObject(payload: any): payload is Record<string, any>;
 /**
  * Returns whether the payload is a plain JavaScript object (excluding special classes or objects with other prototypes)
  *
  * @param {*} payload
- * @returns {payload is {[key: string]: any}}
+ * @returns {payload is Record<string, any>}
  */
-export declare function isObject(payload: any): payload is {
-    [key: string]: any;
+export declare function isObject(payload: any): payload is Record<string, any>;
+/**
+ * Returns whether the payload is a an empty object (excluding special classes or objects with other prototypes)
+ *
+ * @param {*} payload
+ * @returns {payload is { [K in any]: never }}
+ */
+export declare function isEmptyObject(payload: any): payload is {
+    [K in any]: never;
 };
 /**
  * Returns whether the payload is an any kind of object (including special classes or objects with different prototypes)
  *
  * @param {*} payload
- * @returns {payload is {[key: string]: any}}
+ * @returns {payload is Record<string, any>}
  */
-export declare function isAnyObject(payload: any): payload is {
-    [key: string]: any;
-};
+export declare function isAnyObject(payload: any): payload is Record<string, any>;
 /**
  * Returns whether the payload is an object like a type passed in < >
  *
@@ -55,21 +60,28 @@ export declare function isAnyObject(payload: any): payload is {
  * @param {*} payload
  * @returns {payload is T}
  */
-export declare function isObjectLike<T extends object>(payload: any): payload is T;
+export declare function isObjectLike<T extends Record<string, any>>(payload: any): payload is T;
 /**
  * Returns whether the payload is a function
  *
  * @param {*} payload
- * @returns {payload is Function}
+ * @returns {payload is AnyFunction}
  */
-export declare function isFunction(payload: any): payload is Function;
+export declare function isFunction(payload: any): payload is AnyFunction;
 /**
  * Returns whether the payload is an array
  *
- * @param {*} payload
- * @returns {payload is undefined}
+ * @param {any} payload
+ * @returns {payload is any[]}
  */
 export declare function isArray(payload: any): payload is any[];
+/**
+ * Returns whether the payload is a an empty array
+ *
+ * @param {*} payload
+ * @returns {payload is []}
+ */
+export declare function isEmptyArray(payload: any): payload is [];
 /**
  * Returns whether the payload is a string
  *
@@ -92,9 +104,9 @@ export declare function isFullString(payload: any): payload is string;
  */
 export declare function isEmptyString(payload: any): payload is string;
 /**
- * Returns whether the payload is a number
+ * Returns whether the payload is a number (but not NaN)
  *
- * This will return false for NaN
+ * This will return `false` for `NaN`!!
  *
  * @param {*} payload
  * @returns {payload is number}
@@ -118,28 +130,28 @@ export declare function isRegExp(payload: any): payload is RegExp;
  * Returns whether the payload is a Map
  *
  * @param {*} payload
- * @returns {payload is Map}
+ * @returns {payload is Map<any, any>}
  */
 export declare function isMap(payload: any): payload is Map<any, any>;
 /**
  * Returns whether the payload is a WeakMap
  *
  * @param {*} payload
- * @returns {payload is WeakMap}
+ * @returns {payload is WeakMap<any, any>}
  */
 export declare function isWeakMap(payload: any): payload is WeakMap<any, any>;
 /**
  * Returns whether the payload is a Set
  *
  * @param {*} payload
- * @returns {payload is Set}
+ * @returns {payload is Set<any>}
  */
 export declare function isSet(payload: any): payload is Set<any>;
 /**
  * Returns whether the payload is a WeakSet
  *
  * @param {*} payload
- * @returns {payload is WeakSet}
+ * @returns {payload is WeakSet<any>}
  */
 export declare function isWeakSet(payload: any): payload is WeakSet<any>;
 /**
@@ -174,7 +186,7 @@ export declare function isFile(payload: any): payload is File;
  * Returns whether the payload is a Promise
  *
  * @param {*} payload
- * @returns {payload is Promise}
+ * @returns {payload is Promise<any>}
  */
 export declare function isPromise(payload: any): payload is Promise<any>;
 /**
@@ -185,7 +197,7 @@ export declare function isPromise(payload: any): payload is Promise<any>;
  */
 export declare function isError(payload: any): payload is Error;
 /**
- * Returns whether the payload is an Error
+ * Returns whether the payload is literally the value `NaN` (it's `NaN` and also a `number`)
  *
  * @param {*} payload
  * @returns {payload is typeof NaN}
@@ -216,4 +228,4 @@ export declare function isNullOrUndefined(payload: any): payload is null | undef
  * @throws {TypeError} Will throw type error if type is an invalid type
  * @returns {payload is T}
  */
-export declare function isType<T extends Function>(payload: any, type: T): payload is T;
+export declare function isType<T extends AnyFunction | AnyClass>(payload: any, type: T): payload is T;