@rtorcato/js-tooling 2.1.0 → 2.1.1

package/README.md

@@ -1,244 +1,36 @@
 # js-tooling
 
-A comprehensive collection of JavaScript/TypeScript development tools and configurations for modern projects.
+JavaScript and TypeScript tooling for Node.js, React, Next.js, and Vitest.
 
-## Installation
-
-Install the package globally or use it directly with npx:
-
-```bash
-# Install globally
-npm install -g @rtorcato/js-tooling
-
-# Or use with npx
-npx @rtorcato/js-tooling setup
-```
-
-## Getting started
-
-Use the interactive CLI to set up tooling for your project:
-
-```bash
-npx @rtorcato/js-tooling setup
-```
-
-Or import specific configurations:
-
-```javascript
-import '@rtorcato/js-tooling/typescript/base';
-```
-
-## Available Tools
-
-This package includes configurations and presets for:
-
-- **TypeScript** - Base configurations for different project types
-- **ESLint** - Linting rules for JavaScript and TypeScript
-- **Prettier** - Code formatting configuration
-- **Biome** - Fast linter and formatter
-- **Vitest** - Testing framework configuration
-- **Jest** - Testing framework presets
-- **Commitlint** - Commit message linting
-- **Semantic Release** - Automated versioning and publishing
-- **GitHub Actions** - CI/CD workflow templates
-- **And more...**
-
-## CI/CD Setup
-
-The package includes GitHub Actions workflows and semantic-release configuration. For automated publishing, set these secrets in your GitHub repository:
-
-1. **`NPM_TOKEN`** - npm authentication token for publishing packages
-2. **`GITHUB_TOKEN`** - automatically provided by GitHub Actions
-
-Repository settings: `https://github.com/your-username/your-repo/settings/secrets/actions`
-
-## CLI Commands
-
-The package provides several CLI commands:
-
-```bash
-# Interactive project setup wizard
-npx @rtorcato/js-tooling setup
-
-# Copy configuration files to current directory
-npx @rtorcato/js-tooling copy biome
-npx @rtorcato/js-tooling copy tsconfig
-
-# List all available configurations
-npx @rtorcato/js-tooling list
-
-# Diagnose drift between your project and our presets
-npx @rtorcato/js-tooling doctor
-
-# Run commit message helper
-npx @rtorcato/js-tooling commitmessage
-
-# Hello world example
-npx @rtorcato/js-tooling helloworld
-```
-
-### Doctor
-
-`doctor` audits an existing project against the presets and reports drift:
-
-```bash
-npx @rtorcato/js-tooling doctor              # current dir
-npx @rtorcato/js-tooling doctor -d ./app     # specific dir
-npx @rtorcato/js-tooling doctor --json       # machine-readable output
-```
-
-For each tracked config (TypeScript, Biome, ESLint, Prettier, Vitest, Commitlint, `package.json`) it reports `ok`, `drift`, `missing`, or `not configured`, and exits non-zero on `drift` or `missing` — handy as a CI check.
-
-## Configuration Usage
-
-### Biome (Formatter & Linter)
-
-Since Biome doesn't support configuration extension, use the copy command to get the base configuration:
-
-```bash
-# Copy base Biome configuration
-npx @rtorcato/js-tooling copy biome
-```
-
-This creates a `biome.json` file with:
-- Tab indentation, 100 character line width
-- Single quotes, ES5 trailing commas
-- Recommended linting rules with sensible overrides
-- Smart file patterns excluding build directories
-
-After copying, customize for your project:
-
-```json
-{
-  "linter": {
-    "rules": {
-      "recommended": true,
-      "suspicious": {
-        "noExplicitAny": "error"
-      }
-    }
-  }
-}
-```
-
-### TypeScript
-
-Import TypeScript configurations directly in your `tsconfig.json`:
-
-```json
-{
-  "extends": "@rtorcato/js-tooling/typescript/base"
-}
-```
-
-Available configurations:
-- `typescript/base` - Base configuration for all projects
-- `typescript/react` - React-specific settings
-- `typescript/next` - Next.js optimized configuration
-- `typescript/node` - Node.js server configuration
-- `typescript/express` - Express.js API configuration
-
-### ESLint
-
-```javascript
-// eslint.config.js
-import baseConfig from '@rtorcato/js-tooling/eslint/base'
-import nextjsConfig from '@rtorcato/js-tooling/eslint/nextjs'
-
-export default [
-  ...baseConfig,
-  // Add project-specific rules
-]
-```
-
-### Commitlint
-
-```javascript
-// commitlint.config.js
-import config from '@rtorcato/js-tooling/commitlint/config'
-export default config
-```
-
-### Vitest
-
-```javascript
-// vitest.config.js
-import { defineConfig } from 'vitest/config'
-import baseConfig from '@rtorcato/js-tooling/vitest/config'
-
-export default defineConfig({
-  ...baseConfig,
-  // Add project-specific settings
-})
-```
-
-### Semantic Release
-
-```javascript
-// release.config.js
-import config from '@rtorcato/js-tooling/semantic-release/github'
-export default config
-```
+[![CI](https://github.com/rtorcato/js-tooling/actions/workflows/ci.yml/badge.svg)](https://github.com/rtorcato/js-tooling/actions/workflows/ci.yml)
+[![npm version](https://badge.fury.io/js/@rtorcato%2Fjs-tooling.svg)](https://badge.fury.io/js/@rtorcato%2Fjs-tooling)
+[![npm downloads](https://img.shields.io/npm/dm/@rtorcato%2Fjs-tooling)](https://www.npmjs.com/package/@rtorcato/js-tooling)
+[![Bundle size](https://img.shields.io/bundlephobia/minzip/@rtorcato/js-tooling)](https://bundlephobia.com/package/@rtorcato/js-tooling)
+[![Coverage](https://codecov.io/gh/rtorcato/js-tooling/branch/main/graph/badge.svg)](https://codecov.io/gh/rtorcato/js-tooling)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-## Using with Package Managers
+Most tooling libraries give you one piece — just TypeScript configs, or just an ESLint preset. **js-tooling** covers the entire lifecycle: TypeScript, Biome/ESLint, Vitest/Jest, Commitlint, Husky, Semantic Release, and GitHub Actions CI — all wired together. The interactive `setup` wizard scaffolds everything in one shot; `doctor` checks an existing project for drift.
 
-### With pnpm
-```bash
-# Temporarily install and run
-pnpm --package=@rtorcato/js-tooling dlx setup
+**[Full documentation →](https://rtorcato.github.io/js-tooling/)**
 
-# Or install globally
-pnpm add -g @rtorcato/js-tooling
-```
+## Quick start
 
-### With npm
 ```bash
-# Use directly
 npx @rtorcato/js-tooling setup
-
-# Or install globally  
-npm install -g @rtorcato/js-tooling
 ```
 
-## Development
-
-To work on this package locally:
-
-1. Clone the repository:
-   ```bash
-   git clone https://github.com/rtorcato/js-tooling.git
-   cd js-tooling
-   ```
-
-2. Install dependencies:
-   ```bash
-   pnpm install
-   ```
+## What's new
 
-3. Build the CLI:
-   ```bash
-   pnpm run build-cli
-   ```
+See [CHANGELOG.md](CHANGELOG.md) for the full history.
 
-4. Link globally for testing:
-   ```bash
-   pnpm link --global
-   ```
+**v2.0.0** — All 39 tool packages moved from `dependencies` to `peerDependencies`. Add them to your own `devDependencies`. Also ships: `doctor` subcommand, generator unit tests, Dependabot, CI matrix (Node 22 + 24).
 
-For more details, refer to the [pnpm link documentation](https://pnpm.io/cli/link).
-
-## Status
-
-[![CI](https://github.com/rtorcato/js-tooling/actions/workflows/ci.yml/badge.svg)](https://github.com/rtorcato/js-tooling/actions/workflows/ci.yml)
-[![npm version](https://badge.fury.io/js/@rtorcato%2Fjs-tooling.svg)](https://badge.fury.io/js/@rtorcato%2Fjs-tooling)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![GitHub release (latest by date)](https://img.shields.io/github/v/release/rtorcato/js-tooling)](https://github.com/rtorcato/js-tooling/releases)
-[![GitHub issues](https://img.shields.io/github/issues/rtorcato/js-tooling)](https://github.com/rtorcato/js-tooling/issues)
+**v1.1.0** — Stricter commitlint limits, fix for CLI path resolution when copying configs.
 
 ## Contributing
 
-Contributions are welcome! Please read our [contributing guidelines](CONTRIBUTING.md) and feel free to submit issues and pull requests.
+Contributions welcome — see [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+MIT — see [LICENSE](LICENSE).

package/dist/cli/index.js

@@ -1,9 +1,20 @@
 #!/usr/bin/env node
+import path from 'node:path';
 import chalk from 'chalk';
 import { Command } from 'commander';
+import fs from 'fs-extra';
 import packageJson from '../../package.json' with { type: 'json' };
 import { doctorCommand } from './commands/doctor.js';
 import { setupProject } from './commands/setup.js';
+async function isSelfRepo(dir) {
+    try {
+        const pkg = await fs.readJson(path.join(dir, 'package.json'));
+        return pkg.name === '@rtorcato/js-tooling';
+    }
+    catch {
+        return false;
+    }
+}
 const program = new Command();
 program
     .name('@rtorcato/js-tooling')
@@ -39,7 +50,7 @@ program
             console.log(`  ${chalk.green('●')} ${chalk.bold(key)}: ${chalk.gray(desc)}`);
         });
         console.log();
-        return;
+        process.exit(1);
     }
     const { source, target, desc } = availableConfigs[config];
     try {
@@ -96,6 +107,17 @@ program
     .option('-d, --directory <path>', 'Target directory to diagnose', process.cwd())
     .option('--json', 'Emit machine-readable JSON output')
     .action(doctorCommand);
+program.hook('preAction', async (_, actionCommand) => {
+    const name = actionCommand.name();
+    if (name === 'setup' || name === 'doctor') {
+        const dir = actionCommand.opts().directory ?? process.cwd();
+        if (await isSelfRepo(dir)) {
+            console.log(chalk.yellow('\n⚠️  This command cannot be run inside the @rtorcato/js-tooling repo itself.\n'));
+            console.log(chalk.gray('   setup and doctor are for consumer projects, not for the tooling repo.\n'));
+            process.exit(0);
+        }
+    }
+});
 // Handle unknown commands
 program.on('command:*', () => {
     console.error(chalk.red(`\n❌ Unknown command: ${program.args.join(' ')}`));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rtorcato/js-tooling",
-	"version": "2.1.0",
+	"version": "2.1.1",
 	"description": "JavaScript and TypeScript tooling for Node.js, React, Next.js, and Vitest.",
 	"type": "module",
 	"keywords": [
@@ -33,6 +33,7 @@
 		"test": "vitest",
 		"test:watch": "vitest --watch",
 		"coverage": "vitest run --coverage",
+		"knip": "knip",
 		"commit": "cz",
 		"================================================": ""
 	},
@@ -52,9 +53,12 @@
 		"tooling/typescript/reset.d.ts",
 		"tooling/vitest/vitest.config.mjs",
 		"tooling/vitest/vitest.config.d.mts",
+		"tooling/vitest/vitest.config.react.mjs",
+		"tooling/vitest/vitest.config.react.d.mts",
+		"tooling/vitest/vitest.setup.mjs",
+		"tooling/vitest/vitest.setup.d.mts",
 		"tooling/tsup/index.ts",
 		"tooling/biome/biome.json",
-		"tooling/biome/biome.jsonc",
 		"tooling/semantic-release/*.mjs",
 		"tooling/semantic-release/*.d.mts",
 		"README.md"
@@ -99,6 +103,14 @@
 			"types": "./tooling/vitest/vitest.config.d.mts",
 			"import": "./tooling/vitest/vitest.config.mjs"
 		},
+		"./vitest/react": {
+			"types": "./tooling/vitest/vitest.config.react.d.mts",
+			"import": "./tooling/vitest/vitest.config.react.mjs"
+		},
+		"./vitest/setup": {
+			"types": "./tooling/vitest/vitest.setup.d.mts",
+			"import": "./tooling/vitest/vitest.setup.mjs"
+		},
 		"./tsup": "./tooling/tsup/index.ts",
 		"./biome": "./tooling/biome/biome.json",
 		"./semantic-release": {
@@ -116,14 +128,17 @@
 	},
 	"dependencies": {
 		"chalk": "^5.6.2",
-		"commander": "^14.0.1",
+		"commander": "^14.0.3",
 		"fs-extra": "^11.3.2",
-		"inquirer": "^12.10.0"
+		"inquirer": "^14.0.0"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^2.3.0",
+		"@commitlint/types": "^20.0.0",
+		"@eslint/js": "^9.38.0",
+		"@ianvs/prettier-plugin-sort-imports": "^4.4.2",
 		"@commitlint/cli": "^20.1.0",
-		"@commitlint/config-conventional": "^20.0.0",
+		"@commitlint/config-conventional": "^21.0.1",
 		"@next/eslint-plugin-next": "^16.0.0",
 		"@playwright/test": "^1.56.1",
 		"@semantic-release/changelog": "^6.0.3",
@@ -135,18 +150,17 @@
 		"@semantic-release/release-notes-generator": "^14.1.0",
 		"@total-typescript/ts-reset": "0.6.1",
 		"@types/fs-extra": "^11.0.4",
-		"@types/inquirer": "^9.0.9",
-		"@types/node": "^24.9.1",
+		"@types/node": "^25.9.1",
 		"@typescript-eslint/eslint-plugin": "^8.46.2",
 		"@typescript-eslint/parser": "^8.46.2",
 		"@vitejs/plugin-react": "^5.1.0",
 		"@vitest/coverage-v8": "^4.0.3",
 		"commitizen": "^4.3.1",
-		"conventional-changelog-conventionalcommits": "^9.1.0",
+		"conventional-changelog-conventionalcommits": "^9.3.1",
 		"cross-env": "^10.1.0",
 		"cz-conventional-changelog": "^3.3.0",
 		"esbuild": "^0.25.11",
-		"esbuild-node-externals": "^1.18.0",
+		"esbuild-node-externals": "^1.22.0",
 		"eslint": "9.38.0",
 		"eslint-config-airbnb": "^19.0.4",
 		"eslint-config-prettier": "10.1.8",
@@ -157,6 +171,7 @@
 		"eslint-plugin-react": "^7.37.5",
 		"eslint-plugin-react-hooks": "^7.0.0",
 		"eslint-plugin-vitest": "0.5.4",
+		"jest": "^29.7.0",
 		"husky": "^9.1.7",
 		"is-ci": "^4.1.0",
 		"lint-staged": "^16.2.6",
@@ -165,15 +180,19 @@
 		"rimraf": "6.0.1",
 		"semantic-release": "^25.0.1",
 		"ts-jest": "^29.4.5",
-		"tsup": "8.5.0",
+		"tsup": "8.5.1",
 		"typescript": "^5.9.3",
 		"typescript-eslint": "^8.60.0",
-		"vitest": "4.0.3"
+		"vitest": "4.0.3",
+		"knip": "^5.61.3"
 	},
 	"peerDependencies": {
 		"@biomejs/biome": "^2.0.0",
+		"@commitlint/types": "^20.0.0",
+		"@eslint/js": "^9.0.0",
+		"@ianvs/prettier-plugin-sort-imports": "^4.0.0",
 		"@commitlint/cli": "^20.0.0",
-		"@commitlint/config-conventional": "^20.0.0",
+		"@commitlint/config-conventional": "^21.0.1",
 		"@next/eslint-plugin-next": "^16.0.0",
 		"@playwright/test": "^1.50.0",
 		"@semantic-release/changelog": "^6.0.0",
@@ -190,7 +209,7 @@
 		"commitizen": "^4.0.0",
 		"conventional-changelog-conventionalcommits": "^9.0.0",
 		"cz-conventional-changelog": "^3.0.0",
-		"esbuild": "^0.25.0",
+		"esbuild": "^0.25.0 || ^0.27.0 || ^0.28.0",
 		"esbuild-node-externals": "^1.0.0",
 		"eslint": ">=9.0.0",
 		"eslint-config-airbnb": "^19.0.0",
@@ -202,6 +221,7 @@
 		"eslint-plugin-react": "^7.0.0",
 		"eslint-plugin-react-hooks": "^7.0.0",
 		"eslint-plugin-vitest": "^0.5.0",
+		"jest": "^29.0.0",
 		"husky": "^9.0.0",
 		"lint-staged": ">=16.0.0",
 		"prettier": "^3.0.0",
@@ -217,6 +237,15 @@
 		"@biomejs/biome": {
 			"optional": true
 		},
+		"@commitlint/types": {
+			"optional": true
+		},
+		"@eslint/js": {
+			"optional": true
+		},
+		"@ianvs/prettier-plugin-sort-imports": {
+			"optional": true
+		},
 		"@commitlint/cli": {
 			"optional": true
 		},
@@ -307,6 +336,9 @@
 		"eslint-plugin-vitest": {
 			"optional": true
 		},
+		"jest": {
+			"optional": true
+		},
 		"husky": {
 			"optional": true
 		},
@@ -338,6 +370,36 @@
 			"optional": true
 		}
 	},
+	"knip": {
+		"entry": [
+			"src/cli/index.ts",
+			"src/cli/commands/doctor.ts",
+			"tooling/**/*.{mjs,ts}"
+		],
+		"project": [
+			"src/**/*.ts",
+			"tooling/**/*.{mjs,ts}"
+		],
+		"ignoreDependencies": [
+			"cross-env",
+			"@playwright/test",
+			"eslint-config-airbnb",
+			"eslint-config-prettier",
+			"eslint-config-turbo",
+			"eslint-plugin-jsx-a11y",
+			"eslint-plugin-react",
+			"eslint-plugin-react-hooks",
+			"eslint-plugin-vitest",
+			"ts-jest",
+			"@semantic-release/commit-analyzer",
+			"@semantic-release/exec",
+			"@semantic-release/github",
+			"@semantic-release/npm",
+			"@semantic-release/release-notes-generator",
+			"conventional-changelog-conventionalcommits",
+			"lint-staged"
+		]
+	},
 	"lint-staged": {
 		"*.{js,ts,json,md}": [
 			"pnpm exec biome lint --config-path=tooling/biome/biome.json",
@@ -345,9 +407,7 @@
 		]
 	},
 	"bin": {
-		"js-tooling": "./dist/cli/index.js",
-		"commitmessage": "scripts/commitmessage.sh",
-		"helloworld": "scripts/helloworld.sh"
+		"js-tooling": "./dist/cli/index.js"
 	},
 	"config": {
 		"commitizen": {

package/tooling/vitest/vitest.config.mjs

@@ -10,7 +10,7 @@ export default defineConfig({
 		environment: 'node',
 		coverage: {
 			provider: 'v8',
-			reporter: ['text', 'json', 'html'],
+			reporter: ['text', 'json', 'html', 'json-summary'],
 			include: ['src/cli/generators/**/*.ts'],
 			thresholds: {
 				statements: 25,

package/tooling/vitest/vitest.config.react.d.mts

@@ -0,0 +1,4 @@
+import type { UserConfig } from 'vitest/config'
+
+declare const config: UserConfig
+export default config

package/tooling/vitest/vitest.config.react.mjs

@@ -0,0 +1,27 @@
+import base from '@rtorcato/js-tooling/vitest/config'
+import react from '@vitejs/plugin-react'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { defineConfig, mergeConfig } from 'vitest/config'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+export default mergeConfig(
+	base,
+	defineConfig({
+		plugins: [react()],
+		test: {
+			environment: 'jsdom',
+			include: ['src/**/*.{test,spec}.{js,jsx,ts,tsx}'],
+			css: true, // ← Vitest will stub every *.css / *.module.css import
+			exclude: ['OLD/**'],
+			setupFiles: ['./vitest.setup.ts'],
+		},
+		resolve: {
+			alias: [
+				{ find: '@', replacement: resolve(__dirname, './src') },
+				{ find: '~', replacement: resolve(__dirname, './src') },
+			],
+		},
+	})
+)

package/tooling/vitest/vitest.setup.d.mts

@@ -0,0 +1 @@
+export {}

package/tooling/vitest/vitest.setup.mjs

@@ -0,0 +1,3 @@
+import { vi } from 'vitest'
+
+vi.mock('**/*.module.css', () => ({}))

package/scripts/README.md

@@ -1,8 +0,0 @@
-pnpx js-tooling commitmessage
-pnpx js-tooling version-bump
-pnpx js-tooling genpassword
-
-<!-- run before publish -->
-pnpm exec ./scripts/fix-bins.sh
-
-pnpm link --global

package/scripts/commitmessage.sh

@@ -1,44 +0,0 @@
-#!/usr/bin/env bash
-
-# chmod +x scripts/commitmessage.sh
-set -e
-
-echo "Select commit type by number:"
-select type in "feat" "fix" "perf" "ci" "WIP" "chore" "docs" "test" "style" "refactor" "build" "BREAKING CHANGE" "revert"; do
-    if [ -n "$type" ]; then
-        break
-    else
-        echo "❌ Invalid selection. Try again."
-    fi
-done
-
-if [[ "$type" =~ ^(feat|fix|perf)$ ]]; then
-    echo "Select semantic version by number:"
-    select semantic_version in "none" "patch" "minor" "major"; do
-        [ -n "$semantic_version" ] && break
-    done
-else
-    semantic_version="none"
-fi
-
-read -p "Enter commit description: " description
-read -p "Skip CI? (y/n) [n]: " skip_ci
-skip_ci=${skip_ci:-n}
-
-msg="$type"
-[ "$semantic_version" != "none" ] && msg="$msg($semantic_version)"
-msg="$msg: $description"
-[ "$skip_ci" = "y" ] && msg="$msg [skip ci]"
-
-echo ""
-echo "🔍 Commit preview:"
-echo "$msg"
-read -p "Is this okay? (y/n): " confirm
-[ "$confirm" != "y" ] && echo "❌ Commit aborted." && exit 1
-
-git add -A
-git commit -m "$msg"
-
-echo ""
-read -p "Do you want to push the commit? (y/n): " push_confirm
-[ "$push_confirm" = "y" ] && git push || echo "🚫 Commit not pushed."

package/scripts/helloworld.sh

@@ -1,5 +0,0 @@
-#!/usr/bin/env bash
-
-# chmod +x scripts/helloworld.sh
-
-echo "👋 Hello, world from js-tooling!"