Require Node.js 14 and TypeScript 4.7

.github/workflows/main.yml

@@ -10,16 +10,17 @@ jobs:
       fail-fast: false
       matrix:
         node-version:
+          - 18
           - 16
           - 14
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
         with:
           node-version: ${{ matrix.node-version }}
       - run: npm install --force
       - run: npm test
-      - uses: codecov/codecov-action@v2
+      - uses: codecov/codecov-action@v3
         if: matrix.node-version == 16
         with:
           fail_ci_if_error: true

package.json

@@ -4,25 +4,24 @@
 	"description": "Function argument validation for humans",
 	"license": "MIT",
 	"repository": "sindresorhus/ow",
-	"funding": {
-		"url": "https://github.com/sponsors/sindresorhus"
-	},
+	"funding": "https://github.com/sponsors/sindresorhus",
 	"author": {
 		"name": "Sindre Sorhus",
 		"email": "[email protected]",
 		"url": "https://sindresorhus.com"
 	},
 	"type": "module",
-	"main": "dist/index.js",
+	"exports": "./dist/index.js",
+	"types": "./dist/index.d.ts",
 	"engines": {
-		"node": ">=12"
+		"node": ">=14.16"
 	},
 	"scripts": {
 		"test": "xo && c8 ava",
 		"docs": "typedoc source/index.ts",
 		"build": "del-cli dist && tsc",
 		"prepare": "npm run build",
-		"postpublish": "npm run docs && gh-pages --dist docs --no-history --message \"Deploy documentation\"",
+		"//postpublish": "npm run docs && gh-pages --dist docs --no-history --message \"Deploy documentation\"",
 		"example": "npm run build && node example.js"
 	},
 	"files": [
@@ -50,32 +49,30 @@
 		"object"
 	],
 	"dependencies": {
-		"@sindresorhus/is": "^4.2.0",
-		"callsites": "^3.1.0",
-		"dot-prop": "^6.0.1",
+		"@sindresorhus/is": "^4.6.0",
+		"callsites": "^4.0.0",
+		"dot-prop": "^7.2.0",
 		"lodash.isequal": "^4.5.0",
-		"type-fest": "^2.3.4",
+		"type-fest": "^2.13.0",
 		"vali-date": "^1.0.0"
 	},
 	"devDependencies": {
-		"@sindresorhus/tsconfig": "^0.8.0",
-		"@types/lodash.isequal": "^4.5.5",
-		"@types/node": "^16.10.2",
+		"@sindresorhus/tsconfig": "^3.0.1",
+		"@types/lodash.isequal": "^4.5.6",
+		"@types/node": "^17.0.36",
 		"@types/vali-date": "^1.0.0",
-		"ava": "^3.15.0",
-		"c8": "^7.10.0",
-		"del-cli": "^4.0.0",
-		"expect-type": "^0.12.0",
-		"gh-pages": "^3.2.3",
-		"ts-node": "^10.4.0",
-		"typedoc": "^0.22.5",
-		"typescript": "^4.5.0-beta",
-		"xo": "^0.46.4"
+		"ava": "^4.2.0",
+		"c8": "^7.11.3",
+		"del-cli": "^4.0.1",
+		"expect-type": "^0.13.0",
+		"gh-pages": "^4.0.0",
+		"ts-node": "^10.8.0",
+		"typescript": "^4.7.2",
+		"xo": "^0.49.0"
 	},
 	"browser": {
 		"./dist/utils/infer-label.js": "./dist/utils/infer-label.browser.js"
 	},
-	"types": "dist",
 	"sideEffects": false,
 	"xo": {
 		"parserOptions": {
@@ -98,9 +95,6 @@
 		}
 	},
 	"ava": {
-		"nonSemVerExperiments": {
-			"configurableModuleFormat": true
-		},
 		"nodeArguments": [
 			"--loader=ts-node/esm",
 			"--experimental-specifier-resolution=node"

readme.md

@@ -20,14 +20,12 @@
 
 ## Install
 
-```
-$ npm install ow
+```sh
+npm install ow
 ```
 
 ## Usage
 
-*If you use CommonJS, you need to import is as `const {default: ow} = require('ow')`.*
-
 ```ts
 import ow from 'ow';
 
@@ -291,6 +289,8 @@ This can be useful for creating your own reusable validators which can be extrac
 
 ### TypeScript
 
+**Requires TypeScript 4.7 or later.**
+
 Ow includes a type utility that lets you to extract a TypeScript type from the given predicate.
 
 ```ts
@@ -306,6 +306,9 @@ type User = Infer<typeof userPredicate>;
 ## Maintainers
 
 - [Sindre Sorhus](https://github.com/sindresorhus)
+
+**Former:**
+
 - [Sam Verschueren](https://github.com/SamVerschueren)
 
 ## Related

source/index.ts

@@ -1,6 +1,5 @@
 import callsites from 'callsites';
 import {inferLabel} from './utils/infer-label.js';
-import {Predicate} from './predicates/predicate.js';
 import {BasePredicate, isPredicate} from './predicates/base-predicate.js';
 import modifiers, {Modifiers} from './modifiers.js';
 import predicates, {Predicates} from './predicates.js';
@@ -72,7 +71,7 @@ export interface ReusableValidator<T> {
 	@param value - Value to test.
 	@param label - Override the label which should be used in error messages.
 	*/
-	// eslint-disable-next-line @typescript-eslint/prefer-function-type
+	// eslint-disable-next-line @typescript-eslint/prefer-function-type, @typescript-eslint/no-redundant-type-constituents
 	(value: unknown | T, label?: string): void;
 }
 
@@ -117,7 +116,7 @@ const ow = <T>(value: unknown, labelOrPredicate: unknown, predicate?: BasePredic
 
 Object.defineProperties(ow, {
 	isValid: {
-		value: <T>(value: unknown, predicate: BasePredicate<T>): boolean => {
+		value(value: unknown, predicate: BasePredicate<T>): boolean {
 			try {
 				test(value, '', predicate);
 				return true;
@@ -148,6 +147,8 @@ const _ow: Ow = predicates(modifiers(ow)) as Ow;
 
 export default _ow;
 
-export {BasePredicate, Predicate};
 export * from './predicates.js';
 export {ArgumentError} from './argument-error.js';
+
+export {Predicate} from './predicates/predicate.js';
+export {BasePredicate} from './predicates/base-predicate.js';

source/predicates.ts

@@ -6,7 +6,7 @@ import {BigIntPredicate} from './predicates/bigint.js';
 import {BooleanPredicate} from './predicates/boolean.js';
 import {Predicate, PredicateOptions} from './predicates/predicate.js';
 import {ArrayPredicate} from './predicates/array.js';
-import {ObjectPredicate, Shape} from './predicates/object.js';
+import {ObjectPredicate} from './predicates/object.js';
 import {DatePredicate} from './predicates/date.js';
 import {ErrorPredicate} from './predicates/error.js';
 import {MapPredicate} from './predicates/map.js';
@@ -328,22 +328,19 @@ const predicates = <T>(object: T, options?: PredicateOptions): T & Predicates =>
 
 export default predicates;
 
-export {
-	StringPredicate,
-	NumberPredicate,
-	BigIntPredicate,
-	BooleanPredicate,
-	ArrayPredicate,
-	ObjectPredicate,
-	DatePredicate,
-	ErrorPredicate,
-	MapPredicate,
-	WeakMapPredicate,
-	SetPredicate,
-	WeakSetPredicate,
-	TypedArrayPredicate,
-	ArrayBufferPredicate,
-	DataViewPredicate,
-	AnyPredicate,
-	Shape,
-};
+export {Shape, ObjectPredicate} from './predicates/object.js';
+export {StringPredicate} from './predicates/string.js';
+export {NumberPredicate} from './predicates/number.js';
+export {BigIntPredicate} from './predicates/bigint.js';
+export {BooleanPredicate} from './predicates/boolean.js';
+export {ArrayPredicate} from './predicates/array.js';
+export {DatePredicate} from './predicates/date.js';
+export {ErrorPredicate} from './predicates/error.js';
+export {MapPredicate} from './predicates/map.js';
+export {WeakMapPredicate} from './predicates/weak-map.js';
+export {SetPredicate} from './predicates/set.js';
+export {WeakSetPredicate} from './predicates/weak-set.js';
+export {TypedArrayPredicate} from './predicates/typed-array.js';
+export {ArrayBufferPredicate} from './predicates/array-buffer.js';
+export {DataViewPredicate} from './predicates/data-view.js';
+export {AnyPredicate} from './predicates/any.js';

source/predicates/map.ts

@@ -93,7 +93,7 @@ export class MapPredicate<T1 = unknown, T2 = unknown> extends Predicate<Map<T1,
 	hasAnyValues(...values: readonly T2[]): this {
 		return this.addValidator({
 			message: (_, label) => `Expected ${label} to have any value of \`${JSON.stringify(values)}\``,
-			validator: map => {
+			validator(map) {
 				const valueSet = new Set(map.values());
 				return values.some(key => valueSet.has(key));
 			},

source/predicates/number.ts

@@ -89,7 +89,7 @@ export class NumberPredicate extends Predicate<number> {
 	*/
 	oneOf(list: readonly number[]): this {
 		return this.addValidator({
-			message: (value, label) => {
+			message(value, label) {
 				let printedList = JSON.stringify(list);
 
 				if (list.length > 10) {

source/predicates/object.ts

@@ -1,6 +1,5 @@
 import is from '@sindresorhus/is';
-
-import dotProp from 'dot-prop';
+import {hasProperty} from 'dot-prop';
 import isEqual from 'lodash.isequal';
 import hasItems from '../utils/has-items.js';
 import ofType from '../utils/of-type.js';
@@ -9,8 +8,6 @@ import {partial, exact, Shape, TypeOfShape} from '../utils/match-shape.js';
 import {Predicate, PredicateOptions} from './predicate.js';
 import {BasePredicate} from './base-predicate.js';
 
-export {Shape};
-
 export class ObjectPredicate<T extends object = object> extends Predicate<T> {
 	/**
 	@hidden
@@ -92,7 +89,7 @@ export class ObjectPredicate<T extends object = object> extends Predicate<T> {
 	*/
 	instanceOf(instance: Function): this {
 		return this.addValidator({
-			message: (object: object, label: string) => {
+			message(object: object, label: string) {
 				let {name} = object?.constructor ?? {};
 
 				if (!name || name === 'Object') {
@@ -115,7 +112,7 @@ export class ObjectPredicate<T extends object = object> extends Predicate<T> {
 			message: (_, label, missingKeys) => `Expected ${label} to have keys \`${JSON.stringify(missingKeys)}\``,
 			validator: object => hasItems(
 				{
-					has: item => dotProp.has(object, item),
+					has: item => hasProperty(object, item),
 				},
 				keys,
 			),
@@ -130,7 +127,7 @@ export class ObjectPredicate<T extends object = object> extends Predicate<T> {
 	hasAnyKeys(...keys: readonly string[]): this {
 		return this.addValidator({
 			message: (_, label) => `Expected ${label} to have any key of \`${JSON.stringify(keys)}\``,
-			validator: object => keys.some(key => dotProp.has(object, key)),
+			validator: object => keys.some(key => hasProperty(object, key)),
 		});
 	}
 
@@ -191,3 +188,5 @@ export class ObjectPredicate<T extends object = object> extends Predicate<T> {
 		}) as ObjectPredicate<any>;
 	}
 }
+
+export {Shape} from '../utils/match-shape.js';

source/predicates/predicate.ts

@@ -179,7 +179,7 @@ export class Predicate<T = unknown> implements BasePredicate<T> {
 				? `(${label}) ${error}`
 				// eslint-disable-next-line @typescript-eslint/no-unsafe-call
 				: error(label),
-			validator: value => {
+			validator(value) {
 				const {message, validator} = customValidator(value);
 
 				if (validator) {

source/predicates/string.ts

@@ -103,7 +103,7 @@ export class StringPredicate extends Predicate<string> {
 	*/
 	oneOf(list: readonly string[]): this {
 		return this.addValidator({
-			message: (value, label) => {
+			message(value, label) {
 				let printedList = JSON.stringify(list);
 
 				if (list.length > 10) {
@@ -132,7 +132,7 @@ export class StringPredicate extends Predicate<string> {
 	*/
 	get nonBlank(): this {
 		return this.addValidator({
-			message: (value, label) => {
+			message(value, label) {
 				// Unicode's formal substitute characters can be barely legible and may not be easily recognized.
 				// Hence this alternative substitution scheme.
 				const madeVisible = value

source/utils/match-shape.ts

@@ -3,7 +3,6 @@ import test from '../test.js';
 import {isPredicate} from '../predicates/base-predicate.js';
 import {BasePredicate} from '../index.js';
 
-// eslint-disable-next-line @typescript-eslint/consistent-indexed-object-style
 export interface Shape {
 	[key: string]: BasePredicate | Shape;
 }

test/any-multiple-errors.ts

@@ -1,8 +1,8 @@
 /* eslint-disable @typescript-eslint/naming-convention */
 import test from 'ava';
-import ow, {ArgumentError, BasePredicate, Main} from '../source';
-import {testSymbol} from '../source/predicates/base-predicate';
-import {createAnyError, createAnyPredicateError} from './fixtures/create-error';
+import ow, {ArgumentError, BasePredicate, Main} from '../source/index.js';
+import {testSymbol} from '../source/predicates/base-predicate.js';
+import {createAnyError, createAnyPredicateError} from './fixtures/create-error.js';
 
 test('any predicate', t => {
 	// #region Tests line 49 of predicates/any.ts and lines 16-21 of utils/generate-argument-error-message.ts

test/any.ts

@@ -1,6 +1,6 @@
 import test from 'ava';
-import ow from '../source';
-import {createAnyError} from './fixtures/create-error';
+import ow from '../source/index.js';
+import {createAnyError} from './fixtures/create-error.js';
 
 test('any', t => {
 	t.notThrows(() => {

test/array-buffer.ts

@@ -1,5 +1,5 @@
 import test from 'ava';
-import ow from '../source';
+import ow from '../source/index.js';
 
 test('arrayBuffer', t => {
 	t.notThrows(() => {

test/array.ts

@@ -1,5 +1,5 @@
 import test from 'ava';
-import ow from '../source';
+import ow from '../source/index.js';
 
 test('array', t => {
 	t.notThrows(() => {

test/bigint.ts

@@ -1,5 +1,5 @@
 import test from 'ava';
-import ow from '../source';
+import ow from '../source/index.js';
 
 test('bigint', t => {
 	t.notThrows(() => {

test/boolean.ts

@@ -1,5 +1,5 @@
 import test from 'ava';
-import ow from '../source';
+import ow from '../source/index.js';
 
 test('boolean', t => {
 	t.notThrows(() => {

test/buffer.ts

@@ -1,6 +1,6 @@
 import {Buffer} from 'node:buffer';
 import test from 'ava';
-import ow from '../source';
+import ow from '../source/index.js';
 
 test('buffer', t => {
 	t.notThrows(() => {

test/custom-message.ts

@@ -1,5 +1,5 @@
 import test from 'ava';
-import ow, {ArgumentError, Predicate} from '../source';
+import ow, {ArgumentError, Predicate} from '../source/index.js';
 
 class CustomPredicate extends Predicate<any> {
 	constructor() {