Replace dtslint with tsd

This seems appropriate. I couldn't quite get dtslint to work without
also validating types of dependencies, which is not quite what I want.

Author: badeball

.github/workflows/build.yml

@@ -31,11 +31,6 @@ jobs:
         with:
           path: ~/.npm
           key: npm@${{ matrix.cypress-version }}
-      - name: Cache TypeScript installs
-        uses: actions/cache@v2
-        with:
-          path: ~/.dts
-          key: dts
       - name: Cache Cypress binaries
         uses: actions/cache@v2
         with:

lib/index.test-d.ts

@@ -0,0 +1,114 @@
+import { expectType } from "tsd";
+
+import messages from "@cucumber/messages";
+
+import "./";
+
+import {
+  Given,
+  When,
+  Then,
+  Step,
+  defineParameterType,
+  Before,
+  After,
+  DataTable,
+} from "../methods";
+
+Given("foo", function (foo, bar: number, baz: string) {
+  expectType<Mocha.Context>(this);
+  expectType<unknown>(foo);
+  expectType<number>(bar);
+  expectType<string>(baz);
+});
+
+Given(/foo/, function (foo, bar: number, baz: string) {
+  expectType<Mocha.Context>(this);
+  expectType<unknown>(foo);
+  expectType<number>(bar);
+  expectType<string>(baz);
+});
+
+When("foo", function (foo, bar: number, baz: string) {
+  expectType<Mocha.Context>(this);
+  expectType<unknown>(foo);
+  expectType<number>(bar);
+  expectType<string>(baz);
+});
+
+When(/foo/, function (foo, bar: number, baz: string) {
+  expectType<Mocha.Context>(this);
+  expectType<unknown>(foo);
+  expectType<number>(bar);
+  expectType<string>(baz);
+});
+
+Then("foo", function (foo, bar: number, baz: string) {
+  expectType<Mocha.Context>(this);
+  expectType<unknown>(foo);
+  expectType<number>(bar);
+  expectType<string>(baz);
+});
+
+Then(/foo/, function (foo, bar: number, baz: string) {
+  expectType<Mocha.Context>(this);
+  expectType<unknown>(foo);
+  expectType<number>(bar);
+  expectType<string>(baz);
+});
+
+declare const table: DataTable;
+
+Then("foo", function () {
+  // Step should consume Mocha.Context.
+  Step(this, "foo");
+});
+
+Then("foo", function () {
+  // Step should consume DataTable's.
+  Step(this, "foo", table);
+});
+
+Then("foo", function () {
+  // Step should consume doc strings.
+  Step(this, "foo", "bar");
+});
+
+defineParameterType({
+  name: "foo",
+  regexp: /foo/,
+  transformer(foo, bar, baz) {
+    expectType<Mocha.Context>(this);
+    expectType<string>(foo);
+    expectType<string>(bar);
+    expectType<string>(baz);
+  },
+});
+
+Before(function () {
+  expectType<Mocha.Context>(this);
+});
+
+Before({}, function () {
+  expectType<Mocha.Context>(this);
+});
+
+Before({ tags: "foo" }, function () {
+  expectType<Mocha.Context>(this);
+});
+
+After(function () {
+  expectType<Mocha.Context>(this);
+});
+
+After({}, function () {
+  expectType<Mocha.Context>(this);
+});
+
+After({ tags: "foo" }, function () {
+  expectType<Mocha.Context>(this);
+});
+
+expectType<messages.GherkinDocument>(window.testState.gherkinDocument);
+expectType<messages.Pickle[]>(window.testState.pickles);
+expectType<messages.Pickle>(window.testState.pickle);

package.json

@@ -35,7 +35,7 @@
     "fmt": "prettier --ignore-path .gitignore --write '**/*.ts'",
     "test": "npm run test:fmt && npm run test:types && npm run test:unit && npm run test:integration",
     "test:fmt": "prettier --ignore-path .gitignore --check '**/*.ts'",
-    "test:types": "dtslint --expectOnly types",
+    "test:types": "tsd",
     "test:unit": "mocha lib/**/*.test.ts",
     "test:run-all-specs": "mocha --timeout 0 test/run-all-specs.ts",
     "test:integration": "cucumber-js",
@@ -73,7 +73,6 @@
     "@types/stream-buffers": "^3.0.4",
     "ast-types": "^0.15.2",
     "cypress": "^7.0.0 || ^8.0.0 || ^9.0.0 || ^10.0.0",
-    "dtslint": "^4.2.1",
     "esbuild": "^0.14.23",
     "fs-extra": "^10.1.0",
     "mocha": "^9.2.1",
@@ -84,6 +83,7 @@
     "strip-indent": "^3.0.0",
     "ts-loader": "^9.2.6",
     "ts-node": "^10.5.0",
+    "tsd": "^0.22.0",
     "typescript": "^4.5.5",
     "webpack": "^5.69.1"
   },

tsconfig.json

@@ -22,5 +22,6 @@
     "browserify.ts",
     "esbuild.ts",
     "webpack.ts"
-  ]
+  ],
+  "exclude": ["lib/index.test-d.ts"]
 }