Feat/dirent path dep0178

recipes/dirent-path-to-parent-path/README.md

@@ -0,0 +1,51 @@
+# `dirent.path` DEP0178
+
+This codemod transforms the usage of `dirent.path` to use `dirent.parentPath`.
+
+See [DEP0178](https://nodejs.org/api/deprecations.html#DEP0178).
+
+## Example
+
+**Before:**
+
+```js
+const { readdir } = require('node:fs/promises');
+
+const entries = await readdir('/some/path', { withFileTypes: true });
+for (const dirent of entries) {
+  console.log(dirent.path);
+}
+```
+
+**After:**
+
+```js
+const { readdir } = require('node:fs/promises');
+
+const entries = await readdir('/some/path', { withFileTypes: true });
+for (const dirent of entries) {
+  console.log(dirent.parentPath);
+}
+```
+
+**Before:**
+
+```js
+import { opendir } from 'node:fs/promises';
+
+const dir = await opendir('./');
+for await (const dirent of dir) {
+  console.log(`Found ${dirent.name} in ${dirent.path}`);
+}
+```
+
+**After:**
+
+```js
+import { opendir } from 'node:fs/promises';
+
+const dir = await opendir('./');
+for await (const dirent of dir) {
+  console.log(`Found ${dirent.name} in ${dirent.parentPath}`);
+}
+```

recipes/dirent-path-to-parent-path/codemod.yaml

@@ -0,0 +1,21 @@
+schema_version: "1.0"
+name: "@nodejs/dirent-path-to-parent-path"
+version: 1.0.0
+description: Handle DEP0178 via transforming `dirent.path` to `dirent.parentPath`.
+author: Bruno Rodrigues
+license: MIT
+workflow: workflow.yaml
+category: migration
+
+targets:
+  languages:
+    - javascript
+    - typescript
+
+keywords:
+  - transformation
+  - migration
+
+registry:
+  access: public
+  visibility: public

recipes/dirent-path-to-parent-path/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@nodejs/dirent-path-to-parent-path",
+  "version": "1.0.0",
+  "description": "Handle DEP0178 via transforming `dirent.path` to `dirent.parentPath`",
+  "type": "module",
+  "scripts": {
+    "test": "npx codemod jssg test -l typescript ./src/workflow.ts ./",
+    "testu": "npx codemod jssg test -l typescript -u ./src/workflow.ts ./"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nodejs/userland-migrations.git",
+    "directory": "recipes/dirent-path-to-parent-path",
+    "bugs": "https://github.com/nodejs/userland-migrations/issues"
+  },
+  "author": "Bruno Rodrigues",
+  "license": "MIT",
+  "homepage": "https://github.com/nodejs/userland-migrations/blob/main/recipes/dirent-path-to-parent-path/README.md",
+  "devDependencies": {
+    "@codemod.com/jssg-types": "^1.0.9"
+  },
+  "dependencies": {
+    "@nodejs/codemod-utils": "*"
+  }
+}