feat(tape-to-node-test): first draft

recipes/tape-to-node-test/README.md

@@ -0,0 +1,118 @@
+# Tape to Node.js Test Runner Codemod
+
+This codemod migrates tests written using [`tape`](https://github.com/tape-testing/tape) v5 to the native Node.js test runner ([`node:test`](https://nodejs.org/api/test.html)).
+
+## Features
+
+- Replaces `tape` imports with `node:test` and `node:assert`.
+- Converts `test(name, (t) => ...)` to `test(name, async (t) => ...)`.
+- Maps `tape` assertions to `node:assert` equivalents, including many aliases (e.g., `t.is`, `t.equals`, `t.deepEquals`).
+- Handles `t.plan` (by commenting it out).
+- Handles `t.end` (removes it for async tests, converts to `done` callback for callback-style tests).
+- Handles `t.test` subtests (adds `await`).
+- Converts `t.teardown` to `t.after`.
+- Converts `t.comment` to `t.diagnostic`.
+- Migrates `t.timeoutAfter(ms)` to `{ timeout: ms }` test option.
+- Supports `test.skip` and `test.only`.
+- Handles `test.onFinish` and `test.onFailure` (by commenting them out with a TODO).
+- Supports loose equality assertions (e.g., `t.looseEqual` -> `assert.equal`).
+
+## Example
+
+### Basic Equality
+
+```diff
+- import test from "tape";
++ import { test } from 'node:test';
++ import assert from 'node:assert';
+
+- test("basic equality", (t) => {
++ test("basic equality", async (t) => {
+-   t.plan(4);
++   // t.plan(4);
+-   t.equal(1, 1, "equal numbers");
++   assert.strictEqual(1, 1, "equal numbers");
+-   t.notEqual(1, 2, "not equal numbers");
++   assert.notStrictEqual(1, 2, "not equal numbers");
+-   t.strictEqual(true, true, "strict equality");
++   assert.strictEqual(true, true, "strict equality");
+-   t.notStrictEqual("1", 1, "not strict equality");
++   assert.notStrictEqual("1", 1, "not strict equality");
+-   t.end();
++   // t.end();
+  });
+```
+
+### Async Tests
+
+```diff
+- import test from "tape";
++ import { test } from 'node:test';
++ import assert from 'node:assert';
+
+  function someAsyncThing() {
+    return new Promise((resolve) => setTimeout(() => resolve(true), 50));
+  }
+
+- test("async test with promises", async (t) => {
++ test("async test with promises", async (t) => {
+-   t.plan(1);
++   // t.plan(1);
+    const result = await someAsyncThing();
+-   t.ok(result, "async result is truthy");
++   assert.ok(result, "async result is truthy");
+  });
+```
+
+### Callback Style
+
+```diff
+- import test from "tape";
++ import { test } from 'node:test';
++ import assert from 'node:assert/strict';
+
+- test("callback style", (t) => {
++ test("callback style", (t, done) => {
+    setTimeout(() => {
+-     t.ok(true);
++     assert.ok(true);
+-     t.end();
++     done();
+    }, 100);
+  });
+```
+
+### Timeout Handling
+
+```diff
+- import test from "tape";
++ import { test } from 'node:test';
++ import assert from 'node:assert/strict';
+
+- test("timeout test", (t) => {
++ test("timeout test", { timeout: 100 }, async (t) => {
+-   t.timeoutAfter(100);
+-   t.ok(true);
++   assert.ok(true);
+-   t.end();
++   // t.end();
+  });
+```
+
+### Dynamic Import
+
+```diff
+  async function run() {
+-   const test = await import("tape");
++   const { test } = await import('node:test');
++   const { default: assert } = await import('node:assert/strict');
+
+-   test("dynamic import", (t) => {
++   test("dynamic import", async (t) => {
+-     t.ok(true);
++     assert.ok(true);
+-     t.end();
++     // t.end();
+    });
+  }
+```

recipes/tape-to-node-test/codemod.yaml

@@ -0,0 +1,19 @@
+schema_version: "1.0"
+name: "@nodejs/tape-to-node-test"
+version: "1.0.0"
+description: Migrates Tape tests to Node.js native test runner
+author: Node.js
+license: MIT
+workflow: workflow.yaml
+category: migration
+
+targets:
+  languages:
+    - javascript
+    - typescript
+
+keywords:
+  - transformation
+  - migration
+  - tape
+  - node:test

recipes/tape-to-node-test/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@nodejs/tape-to-node-test",
+  "version": "1.0.0",
+  "description": "Migrates Tape tests to Node.js native test runner",
+  "type": "module",
+  "scripts": {
+    "test": "npx codemod jssg test -l typescript ./src/workflow.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nodejs/userland-migrations.git",
+    "directory": "recipes/tape-to-node-test",
+    "bugs": "https://github.com/nodejs/userland-migrations/issues"
+  },
+  "author": "Node.js",
+  "license": "MIT",
+  "dependencies": {
+    "@nodejs/codemod-utils": "*"
+  }
+}