feat(chalk-to-util-styletext): introduce

recipes/chalk-to-util-styletext/README.md

@@ -0,0 +1,56 @@
+# Chalk to util.styleText
+
+This recipe migrates from the external `chalk` package to Node.js built-in `util.styleText` API. It transforms chalk method calls to use the native Node.js styling functionality.
+
+## Examples
+
+```diff
+- import chalk from 'chalk';
++ import { styleText } from 'node:util';
+- console.log(chalk.red('Error message'));
++ console.log(styleText('red', 'Error message'));
+- console.log(chalk.green('Success message'));
++ console.log(styleText('green', 'Success message'));
+- console.log(chalk.blue('Info message'));
++ console.log(styleText('blue', 'Info message'));
+```
+
+```diff
+- import chalk from 'chalk';
++ import { styleText } from 'node:util';
+- console.log(chalk.red.bold('Important error'));
++ console.log(styleText(['red', 'bold'], 'Important error'));
+- console.log(chalk.green.underline('Success with emphasis'));
++ console.log(styleText(['green', 'underline'], 'Success with emphasis'));
+```
+
+```diff
+- const chalk = require('chalk');
++ const { styleText } = require('node:util');
+- const red = chalk.red;
++ const red = (text) => styleText('red', text);
+- const boldBlue = chalk.blue.bold;
++ const boldBlue = (text) => styleText(['blue', 'bold'], text);
+- console.log(red('Error'));
++ console.log(red('Error'));
+- console.log(boldBlue('Info'));
++ console.log(boldBlue('Info'));
+```
+
+## Usage
+
+Run this codemod with:
+
+```sh
+npx codemod nodejs/chalk-to-util-styletext
+```
+
+## Compatibility
+
+- **Removes chalk dependency** from package.json automatically
+- **Supports most chalk methods**: colors, background colors, and text modifiers
+- **Unsupported methods**: `hex()`, `rgb()`, `ansi256()`, `bgAnsi256()`, `visible()` (warnings will be shown)
+
+## Limitations
+
+- **Complex conditional expressions** in some contexts may need manual review

recipes/chalk-to-util-styletext/codemod.yaml

@@ -0,0 +1,24 @@
+schema_version: "1.0"
+name: "@nodejs/chalk-to-util-styletext"
+version: 1.0.0
+capabilities:
+  - fs
+  - child_process
+description: Migrate from the chalk package to Node.js's built-in util.styleText API
+author: Richie McColl
+license: MIT
+workflow: workflow.yaml
+category: migration
+
+targets:
+  languages:
+    - javascript
+    - typescript
+
+keywords:
+  - transformation
+  - migration
+
+registry:
+  access: public
+  visibility: public

recipes/chalk-to-util-styletext/package.json

@@ -0,0 +1,24 @@
+{
+    "name": "@nodejs/chalk-to-util-styletext",
+    "version": "1.0.0",
+    "description": "Migrate from the chalk package to Node.js's built-in util.styleText API",
+    "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/chalk-to-util-styletext",
+        "bugs": "https://github.com/nodejs/userland-migrations/issues"
+    },
+    "author": "Richie McColl",
+    "license": "MIT",
+    "homepage": "https://github.com/nodejs/userland-migrations/blob/main/recipes/chalk-to-util-styletext/README.md",
+    "devDependencies": {
+        "@codemod.com/jssg-types": "^1.0.9"
+    },
+    "dependencies": {
+        "@nodejs/codemod-utils": "*"
+    }
+}

recipes/chalk-to-util-styletext/src/remove-dependencies.ts

@@ -0,0 +1,8 @@
+import removeDependencies from '@nodejs/codemod-utils/remove-dependencies';
+
+/**
+ * Remove chalk and @types/chalk dependencies from package.json
+ */
+export default function removeChalkDependencies(): string | null {
+	return removeDependencies(['chalk', '@types/chalk']);
+}