scaffold codemod

Author: AugustinMauroy

package-lock.json

@@ -0,0 +1,33 @@
+# `fs.rmdir` DEP0147
+
+This recipe provides a guide for migrating from the deprecated `fs.rmdir` and its synchronous and promise-based counterparts to the new `fs.rm` method in Node.js.
+
+See [DEP0147](https://nodejs.org/api/deprecations.html#DEP0147).
+
+## Examples
+
+**Before:**
+
+```js
+// Using fs.rmdir with the recursive option
+fs.rmdir(path, { recursive: true }, callback);
+
+// Using fs.rmdirSync with the recursive option
+fs.rmdirSync(path, { recursive: true });
+
+// Using fs.promises.rmdir with the recursive option
+fs.promises.rmdir(path, { recursive: true });
+```
+
+**After:**
+
+```js
+// Using fs.rm with recursive and force options
+fs.rm(path, { recursive: true, force: true }, callback);
+
+// Using fs.rmSync with recursive and force options
+fs.rmSync(path, { recursive: true, force: true });
+
+// Using fs.promises.rm with recursive and force options
+fs.promises.rm(path, { recursive: true, force: true });
+```

recipes/repl-builtin-modules/README.md

@@ -0,0 +1,21 @@
+schema_version: "1.0"
+name: "@nodejs/repl-builtin-modules"
+version: 1.0.0
+description: Handle DEP0191 via transforming `repl.builtinModules` usage to `module.builtinModules`.
+author: Augustin Mauroy
+license: MIT
+workflow: workflow.yaml
+category: migration
+
+targets:
+  languages:
+    - javascript
+    - typescript
+
+keywords:
+  - transformation
+  - migration
+
+registry:
+  access: public
+  visibility: public

recipes/repl-builtin-modules/codemod.yaml

@@ -0,0 +1,26 @@
+{
+  "name": "@nodejs/repl-builtin-modules",
+  "version": "1.0.0",
+  "description": "Handle DEP0191 via transforming `repl.builtinModules` usage to `module.builtinModules`.",
+  "type": "module",
+  "scripts": {
+    "test": "npx codemod@next jssg test -l typescript ./src/workflow.ts ./",
+    "test:update-snapshots": "npx codemod@next jssg test --update-snapshots -l typescript ./src/workflow.ts ./ "
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nodejs/userland-migrations.git",
+    "directory": "recipes/rmdirs",
+    "bugs": "https://github.com/nodejs/userland-migrations/issues"
+  },
+  "author": "Augustin Mauroy",
+  "license": "MIT",
+  "homepage": "https://github.com/nodejs/userland-migrations/blob/main/recipes/rmdirs/README.md",
+  "devDependencies": {
+    "@types/node": "^24.0.3",
+    "@codemod.com/jssg-types": "^1.0.3"
+  },
+  "dependencies": {
+    "@nodejs/codemod-utils": "*"
+  }
+}

recipes/repl-builtin-modules/package.json

@@ -0,0 +1,22 @@
+import { getNodeImportStatements } from "@nodejs/codemod-utils/ast-grep/import-statement";
+import { getNodeRequireCalls } from "@nodejs/codemod-utils/ast-grep/require-call";
+import type { SgRoot, Edit } from "@codemod.com/jssg-types/main";
+
+/**
+ * Transform function that converts deprecated fs.rmdir calls
+ * with recursive: true option to the new fs.rm API.
+ *
+ * Handles:
+ * 1. ...
+ */
+export default function transform(root: SgRoot): string | null {
+	const rootNode = root.root();
+	let hasChanges = false;
+	const edits: Edit[] = [];
+
+	// do things
+
+	if (!hasChanges) return null;
+
+	return rootNode.commitEdits(edits);
+}

recipes/repl-builtin-modules/src/workflow.ts

@@ -0,0 +1,3 @@
+const repl = require('node:repl');
+
+console.log(repl.builtinModules);

recipes/repl-builtin-modules/tests/expected/file-1.js

@@ -0,0 +1,3 @@
+const { builtinModules } = require('node:module');
+
+console.log(builtinModules);

recipes/repl-builtin-modules/tests/expected/file-2.js

@@ -0,0 +1,6 @@
+const { foo } = require('node:repl');
+const { builtinModules } = require('node:module');
+
+console.log(builtinModules);
+
+foo(); // does something else

recipes/repl-builtin-modules/tests/expected/file-3.js

@@ -0,0 +1,6 @@
+import { foo } from 'node:repl';
+import { builtinModules } from 'node:module';
+
+console.log(builtinModules);
+
+foo(); // does something else

recipes/repl-builtin-modules/tests/expected/file-4.mjs

@@ -0,0 +1,3 @@
+const module = require('node:module');
+
+console.log(module.builtinModules);