@dimensional-innovations/tool-config 3.0.1 → 3.0.2

package/README.md

@@ -4,7 +4,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@dimensional-innovations/tool-config.svg)](https://www.npmjs.com/package/@dimensional-innovations/tool-config)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node Version](https://img.shields.io/badge/node-%3E%3D22.12.0-brightgreen.svg)](https://nodejs.org/)
+[![Node Version](https://img.shields.io/badge/node-%3E%3D22.20.0-brightgreen.svg)](https://nodejs.org/)
 [![Test Coverage](https://img.shields.io/badge/coverage-96%25-brightgreen.svg)](./tests/)
 
 **One package. Five tools. Zero configuration.**
@@ -16,7 +16,7 @@ Stop juggling multiple config packages. This single package provides battle-test
 **Before:**
 
 ```bash
-npm install --save-dev \
+yarn add --dev \
   eslint @eslint/js eslint-config-airbnb eslint-plugin-react \
   prettier prettier-config-standard \
   stylelint stylelint-config-standard \
@@ -28,7 +28,7 @@ npm install --save-dev \
 **After:**
 
 ```bash
-npm install --save-dev @dimensional-innovations/tool-config
+yarn add --dev @dimensional-innovations/tool-config
 ```
 
 ## Features
@@ -48,7 +48,7 @@ npm install --save-dev @dimensional-innovations/tool-config
 ### Installation
 
 ```bash
-npm install --save-dev @dimensional-innovations/tool-config
+yarn add --dev @dimensional-innovations/tool-config
 ```
 
 Or use the interactive CLI:
@@ -111,7 +111,7 @@ export default createConfig('semantic-release')
 
 That's it! The configs will automatically detect your framework and TypeScript setup.
 
-### Add npm Scripts
+### Add Scripts
 
 ```json
 {
@@ -124,7 +124,7 @@ That's it! The configs will automatically detect your framework and TypeScript s
     "style:fix": "stylelint '**/*.css' --fix --allow-empty-input",
     "typecheck": "tsc --noEmit",
     "typecheck:watch": "tsc --noEmit --watch",
-    "check-all": "npm run prettier && npm run style && npm run lint && npm run typecheck"
+    "check-all": "yarn prettier && yarn style && yarn lint && yarn typecheck"
   }
 }
 ```
@@ -365,7 +365,7 @@ npx @dimensional-innovations/tool-config
 - Choose which tools to configure
 - Auto-detects framework and TypeScript
 - Creates config files automatically
-- Adds npm scripts to package.json (including `check-all` for multiple tools)
+- Adds scripts to package.json (including `check-all` for multiple tools)
 - Automated CI/CD pipeline setup
 - **Uninstall support** - Clean removal of configs and scripts
 - Supports dry-run mode
@@ -642,13 +642,13 @@ npx prettier --check . --debug-check
 
 **ESLint not detecting framework:** Ensure framework is in `package.json` dependencies, or explicitly set `framework: 'react'`.
 
-**TypeScript parsing errors:** Install TypeScript: `npm install --save-dev typescript`
+**TypeScript parsing errors:** Install TypeScript: `yarn add --dev typescript`
 
 **Prettier plugin not found:** Install required peer dependency:
 
 ```bash
-npm install --save-dev prettier-plugin-svelte  # Svelte
-npm install --save-dev prettier-plugin-astro   # Astro
+yarn add --dev prettier-plugin-svelte  # Svelte
+yarn add --dev prettier-plugin-astro   # Astro
 ```
 
 **Stylelint not linting .vue files:** Update script: `"style": "stylelint '**/*.css' '**/*.vue' --allow-empty-input"`
@@ -657,8 +657,8 @@ npm install --save-dev prettier-plugin-astro   # Astro
 
 ## Requirements
 
-- **Node.js**: >= 22.12.0 (Node.js 22 LTS "Jod")
-- **npm**: >= 10.0.0
+- **Node.js**: >= 22.20.0 (Node.js 22 LTS "Jod")
+- **Yarn**: >= 4.0.0 (or npm >= 10.0.0)
 - **ECMAScript**: ES2025 (ESM modules required)
 
 ## Philosophy

package/bin/lib/package-manager.js

@@ -23,7 +23,7 @@ const CHECK_ORDER = ['prettier', 'stylelint', 'eslint', 'typescript']
  */
 function generateCheckAllScript(installedTools) {
   const commands = CHECK_ORDER.filter(tool => installedTools.includes(tool))
-    .map(tool => `npm run ${CHECK_SCRIPT_MAP[tool]}`)
+    .map(tool => `yarn ${CHECK_SCRIPT_MAP[tool]}`)
     .join(' && ')
 
   return commands || null
@@ -75,11 +75,11 @@ export function updatePackageJsonScripts(tools, getScriptsFn, context) {
         const existingCheckAll = packageJson.scripts['check-all']
 
         // Only add if doesn't exist, or update if it's our auto-generated pattern
-        // Auto-generated scripts follow pattern: "npm run X && npm run Y && ..."
+        // Auto-generated scripts follow pattern: "yarn X && yarn Y && ..."
         const isAutoGenerated =
           existingCheckAll &&
-          existingCheckAll.startsWith('npm run') &&
-          existingCheckAll.includes(' && npm run')
+          existingCheckAll.startsWith('yarn ') &&
+          existingCheckAll.includes(' && yarn ')
 
         if (!existingCheckAll || isAutoGenerated) {
           scriptsToAdd['check-all'] = checkAllCmd
@@ -157,9 +157,9 @@ export function removePackageJsonScripts(tools, getScriptsFn, context) {
     // Handle check-all script separately
     const checkAllScript = packageJson.scripts['check-all']
     if (checkAllScript) {
-      // Only remove if it's auto-generated (follows npm run X && npm run Y pattern)
+      // Only remove if it's auto-generated (follows yarn X && yarn Y pattern)
       const isAutoGenerated =
-        checkAllScript.startsWith('npm run') && checkAllScript.includes(' && npm run')
+        checkAllScript.startsWith('yarn ') && checkAllScript.includes(' && yarn ')
 
       if (isAutoGenerated) {
         scriptsToRemove.push('check-all')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimensional-innovations/tool-config",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Universal configuration package for ESLint, Prettier, Stylelint, TypeScript, and semantic-release with auto-detection for React, Vue, Svelte, Solid, Astro, Angular, and more",
   "license": "MIT",
   "author": {
@@ -47,13 +47,13 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=22.12.0"
+    "node": ">=22.20.0"
   },
   "scripts": {
     "lint": "eslint .",
     "lint:fix": "eslint --fix .",
-    "prettier": "npx prettier --check .",
-    "prettier:fix": "npx prettier --write .",
+    "prettier": "prettier --check .",
+    "prettier:fix": "prettier --write .",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:ui": "vitest --ui",
@@ -64,7 +64,7 @@
     "style:fix": "stylelint \"**/*.css\" --fix --allow-empty-input",
     "typecheck": "tsc --noEmit",
     "typecheck:watch": "tsc --noEmit --watch",
-    "check-all": "npm run prettier && npm run style && npm run lint && npm run typecheck"
+    "check-all": "yarn prettier && yarn style && yarn lint && yarn typecheck"
   },
   "dependencies": {
     "@eslint/compat": "^1.4.0",

package/src/tools/prettier/README.md

@@ -43,7 +43,7 @@ The base preset applies to all frameworks:
 **Installation**:
 
 ```bash
-npm install --save-dev prettier-plugin-vue
+yarn add --save-dev prettier-plugin-vue
 ```
 
 **Example**:
@@ -82,7 +82,7 @@ export default createConfig('prettier')
 **Installation**:
 
 ```bash
-npm install --save-dev prettier-plugin-svelte
+yarn add --save-dev prettier-plugin-svelte
 ```
 
 **Svelte 5 Support**: Fully compatible with Svelte 5 runes (`$state`, `$derived`, etc.)
@@ -94,7 +94,7 @@ npm install --save-dev prettier-plugin-svelte
 **Installation**:
 
 ```bash
-npm install --save-dev prettier-plugin-astro
+yarn add --save-dev prettier-plugin-astro
 ```
 
 **Automatic Formatting**: The Astro plugin handles all `.astro` file formatting automatically
@@ -195,8 +195,8 @@ Add these scripts to your `package.json`:
 Then run:
 
 ```bash
-npm run prettier:fix  # Format all files
-npm run prettier      # Check formatting without writing
+yarn prettier:fix  # Format all files
+yarn prettier      # Check formatting without writing
 ```
 
 ## VSCode Integration
@@ -258,7 +258,7 @@ This package deliberately **does not** integrate Prettier with ESLint. They rema
 Run them separately:
 
 ```bash
-npm run lint && npm run prettier:fix
+yarn lint && yarn prettier:fix
 ```
 
 ## Troubleshooting
@@ -270,7 +270,7 @@ If you see errors like `Cannot find module 'prettier-plugin-svelte'`:
 1. Install the required plugin:
 
    ```bash
-   npm install --save-dev prettier-plugin-svelte
+   yarn add --save-dev prettier-plugin-svelte
    ```
 
 2. Or specify a framework that doesn't need plugins:

package/src/tools/semantic-release/README.md

@@ -49,7 +49,7 @@ export default createConfig('semantic-release', {
 ## Installation
 
 ```bash
-npm install --save-dev @dimensional-innovations/tool-config semantic-release
+yarn add --save-dev @dimensional-innovations/tool-config semantic-release
 ```
 
 ### Optional Peer Dependencies
@@ -58,13 +58,13 @@ Install the semantic-release plugins you need based on your Git provider:
 
 ```bash
 # For GitLab projects
-npm install --save-dev @semantic-release/changelog @semantic-release/git @semantic-release/gitlab
+yarn add --save-dev @semantic-release/changelog @semantic-release/git @semantic-release/gitlab
 
 # For GitHub projects
-npm install --save-dev @semantic-release/changelog @semantic-release/git @semantic-release/github
+yarn add --save-dev @semantic-release/changelog @semantic-release/git @semantic-release/github
 
 # For Bitbucket or other providers (no provider-specific plugin)
-npm install --save-dev @semantic-release/changelog @semantic-release/git
+yarn add --save-dev @semantic-release/changelog @semantic-release/git
 ```
 
 ## Usage
@@ -255,8 +255,8 @@ release:
   only:
     - main
   script:
-    - npm install
-    - npx semantic-release
+    - yarn add
+    - yarn semantic-release
   variables:
     GL_TOKEN: $GL_TOKEN
     NPM_TOKEN: $NPM_TOKEN
@@ -281,8 +281,8 @@ jobs:
       - uses: actions/setup-node@v3
         with:
           node-version: '20'
-      - run: npm install
-      - run: npx semantic-release
+      - run: yarn add
+      - run: yarn semantic-release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
@@ -293,7 +293,7 @@ jobs:
 Test your configuration without publishing:
 
 ```bash
-npx semantic-release --dry-run
+yarn semantic-release --dry-run
 ```
 
 ## Workflow
@@ -370,7 +370,7 @@ semantic-release analyzes commits and:
 
 1. Only release from CI/CD, never manually
 2. Protect main branch to prevent direct pushes
-3. Use `npm run release --dry-run` to test locally
+3. Use `yarn release --dry-run` to test locally
 
 ### Monorepo Issues
 

package/src/tools/semantic-release/templates/.gitlab-ci.yml

@@ -16,24 +16,24 @@ stages:
 cache:
   key:
     files:
-      - package-lock.json
+      - yarn.lock
   paths:
     - node_modules/
-    - .npm/
+    - .yarn/cache/
 
 # Default settings for all jobs
 default:
   image: node:22-alpine
   before_script:
-    - npm ci --cache .npm --prefer-offline
+    - yarn install --frozen-lockfile
 
 # Lint job - runs ESLint, Prettier, Stylelint
 lint:
   stage: lint
   script:
-    - npm run lint
-    - npm run prettier
-    - npm run style || true # Allow failure if no CSS files
+    - yarn lint
+    - yarn prettier
+    - yarn style || true # Allow failure if no CSS files
   only:
     - branches
     - merge_requests
@@ -42,7 +42,7 @@ lint:
 test:
   stage: test
   script:
-    - npm run test:coverage
+    - yarn test:coverage
   coverage: '/All files[^|]*\|[^|]*\s+([\d\.]+)/'
   artifacts:
     reports:
@@ -62,9 +62,9 @@ release:
   before_script:
     # Install git (required by semantic-release)
     - apk add --no-cache git
-    - npm ci --cache .npm --prefer-offline
+    - yarn install --frozen-lockfile
   script:
-    - npm run release
+    - yarn release
   only:
     - main
   except:

package/src/tools/semantic-release/templates/bitbucket-pipelines.yml

@@ -10,27 +10,27 @@ image: node:22
 
 definitions:
   caches:
-    npm: ~/.npm
+    yarn: ~/.yarn/cache
 
 pipelines:
   default:
     - step:
         name: Lint
         caches:
-          - npm
+          - yarn
         script:
-          - npm ci
-          - npm run lint
-          - npm run prettier
-          - npm run style || true # Allow failure if no CSS files
+          - yarn install --frozen-lockfile
+          - yarn lint
+          - yarn prettier
+          - yarn style || true # Allow failure if no CSS files
 
     - step:
         name: Test
         caches:
-          - npm
+          - yarn
         script:
-          - npm ci
-          - npm run test:coverage
+          - yarn install --frozen-lockfile
+          - yarn test:coverage
         artifacts:
           - coverage/**
 
@@ -39,30 +39,30 @@ pipelines:
       - step:
           name: Lint
           caches:
-            - npm
+            - yarn
           script:
-            - npm ci
-            - npm run lint
-            - npm run prettier
-            - npm run style || true
+            - yarn install --frozen-lockfile
+            - yarn lint
+            - yarn prettier
+            - yarn style || true
 
       - step:
           name: Test
           caches:
-            - npm
+            - yarn
           script:
-            - npm ci
-            - npm run test:coverage
+            - yarn install --frozen-lockfile
+            - yarn test:coverage
           artifacts:
             - coverage/**
 
       - step:
           name: Release
           caches:
-            - npm
+            - yarn
           script:
-            - npm ci
-            - npm run release
+            - yarn install --frozen-lockfile
+            - yarn release
           trigger: manual # Remove this line to make releases automatic
 
   pull-requests:
@@ -70,13 +70,13 @@ pipelines:
       - step:
           name: Lint & Test
           caches:
-            - npm
+            - yarn
           script:
-            - npm ci
-            - npm run lint
-            - npm run prettier
-            - npm run style || true
-            - npm run test
+            - yarn install --frozen-lockfile
+            - yarn lint
+            - yarn prettier
+            - yarn style || true
+            - yarn test
 # Optional: Test on multiple Node versions
 # definitions:
 #   services:
@@ -90,11 +90,11 @@ pipelines:
 #           name: Test (Node 20)
 #           image: node:20
 #           script:
-#             - npm ci
-#             - npm test
+#             - yarn install --frozen-lockfile
+#             - yarn test
 #       - step:
 #           name: Test (Node 22)
 #           image: node:22
 #           script:
-#             - npm ci
-#             - npm test
+#             - yarn install --frozen-lockfile
+#             - yarn test

package/src/tools/semantic-release/templates/github-workflow.yml

@@ -27,19 +27,19 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: '22'
-          cache: 'npm'
+          cache: 'yarn'
 
       - name: Install dependencies
-        run: npm ci
+        run: yarn install --frozen-lockfile
 
       - name: Run ESLint
-        run: npm run lint
+        run: yarn lint
 
       - name: Run Prettier
-        run: npm run prettier
+        run: yarn prettier
 
       - name: Run Stylelint
-        run: npm run style || true # Allow failure if no CSS files
+        run: yarn style || true # Allow failure if no CSS files
 
   test:
     name: Test
@@ -51,13 +51,13 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: '22'
-          cache: 'npm'
+          cache: 'yarn'
 
       - name: Install dependencies
-        run: npm ci
+        run: yarn install --frozen-lockfile
 
       - name: Run tests with coverage
-        run: npm run test:coverage
+        run: yarn test:coverage
 
       - name: Upload coverage to Codecov
         uses: codecov/codecov-action@v4
@@ -79,16 +79,16 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: '22'
-          cache: 'npm'
+          cache: 'yarn'
 
       - name: Install dependencies
-        run: npm ci
+        run: yarn install --frozen-lockfile
 
       - name: Release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: npm run release
+        run: yarn release
 # Optional: Test on multiple Node versions
 #   test-matrix:
 #     name: Test (Node ${{ matrix.node-version }})
@@ -102,6 +102,6 @@ jobs:
 #         uses: actions/setup-node@v4
 #         with:
 #           node-version: ${{ matrix.node-version }}
-#           cache: 'npm'
-#       - run: npm ci
-#       - run: npm test
+#           cache: 'yarn'
+#       - run: yarn install --frozen-lockfile
+#       - run: yarn test

package/src/tools/stylelint/README.md

@@ -19,10 +19,10 @@ The Stylelint tool and core config are included as dependencies. For Vue project
 
 ```bash
 # Vue projects only
-npm install --save-dev stylelint-config-standard-vue postcss-html
+yarn add --save-dev stylelint-config-standard-vue postcss-html
 
 # Svelte projects need postcss-html for component parsing
-npm install --save-dev postcss-html
+yarn add --save-dev postcss-html
 ```
 
 ## Usage
@@ -247,7 +247,7 @@ No conflicts! They work together perfectly:
 Run them sequentially:
 
 ```bash
-npm run style && npm run prettier:fix
+yarn style && yarn prettier:fix
 ```
 
 ### Stylelint + ESLint
@@ -320,7 +320,7 @@ export default createConfig('stylelint', {
 **Vue projects only**: Install the optional peer dependency:
 
 ```bash
-npm install --save-dev stylelint-config-standard-vue postcss-html
+yarn add --save-dev stylelint-config-standard-vue postcss-html
 ```
 
 ### "Cannot find module 'postcss-html'"
@@ -328,7 +328,7 @@ npm install --save-dev stylelint-config-standard-vue postcss-html
 **Vue/Svelte projects**: Install the parser:
 
 ```bash
-npm install --save-dev postcss-html
+yarn add --save-dev postcss-html
 ```
 
 ### Stylelint Not Linting .vue Files
@@ -363,7 +363,7 @@ This shouldn't happen! Our Stylelint config focuses on quality, not formatting.
 Make sure you're using Stylelint 16+:
 
 ```bash
-npm install --save-dev stylelint@^16.0.0
+yarn add --save-dev stylelint@^16.0.0
 ```
 
 ## Rule Philosophy

package/src/tools/typescript/README.md

@@ -14,19 +14,19 @@ Zero-config TypeScript type checking for modern JavaScript/TypeScript projects.
 ## Installation
 
 ```bash
-npm install --save-dev @dimensional-innovations/tool-config typescript
+yarn add --save-dev @dimensional-innovations/tool-config typescript
 ```
 
 For modern performance with tsgo:
 
 ```bash
-npm install --save-dev @typescript/native-preview
+yarn add --save-dev @typescript/native-preview
 ```
 
 For Vue projects, also install:
 
 ```bash
-npm install --save-dev vue-tsc
+yarn add --save-dev vue-tsc
 ```
 
 ## Quick Start
@@ -116,8 +116,8 @@ export default await createConfig('typescript', { framework: 'react' })
 **Type checking:**
 
 ```bash
-npm install --save-dev @types/react @types/react-dom
-npm run typecheck
+yarn add --save-dev @types/react @types/react-dom
+yarn typecheck
 ```
 
 ### Vue
@@ -141,8 +141,8 @@ export default await createConfig('typescript', { framework: 'vue' })
 **Type checking:**
 
 ```bash
-npm install --save-dev vue-tsc
-npm run typecheck
+yarn add --save-dev vue-tsc
+yarn typecheck
 ```
 
 **Note:** Vue projects should use `vue-tsc` instead of `tsc` for proper .vue file support.
@@ -165,8 +165,8 @@ export default await createConfig('typescript', { framework: 'svelte' })
 **Type checking:**
 
 ```bash
-npm install --save-dev @sveltejs/vite-plugin-svelte
-npm run typecheck
+yarn add --save-dev @sveltejs/vite-plugin-svelte
+yarn typecheck
 ```
 
 ### Solid
@@ -237,8 +237,8 @@ export default await createConfig('typescript', { framework: 'node' })
 **Type checking:**
 
 ```bash
-npm install --save-dev @types/node
-npm run typecheck
+yarn add --save-dev @types/node
+yarn typecheck
 ```
 
 ### Vanilla JavaScript
@@ -271,13 +271,13 @@ tsgo is a Go port of the TypeScript compiler that is 10x faster than tsc.
 **Installation:**
 
 ```bash
-npm install --save-dev @typescript/native-preview
+yarn add --save-dev @typescript/native-preview
 ```
 
 **Usage:**
 
 ```bash
-npx tsgo --noEmit
+yarn tsgo --noEmit
 ```
 
 The package will automatically detect tsgo and use it when available.
@@ -471,7 +471,7 @@ console.log(cmd) // 'tsgo --noEmit || vue-tsc --noEmit'
 **Solution:** Install the @types package:
 
 ```bash
-npm install --save-dev @types/node @types/react @types/react-dom
+yarn add --save-dev @types/node @types/react @types/react-dom
 ```
 
 ### Vue .vue files not type checking
@@ -481,8 +481,8 @@ npm install --save-dev @types/node @types/react @types/react-dom
 **Solution:** Install and use vue-tsc:
 
 ```bash
-npm install --save-dev vue-tsc
-npx vue-tsc --noEmit
+yarn add --save-dev vue-tsc
+yarn vue-tsc --noEmit
 ```
 
 ### tsgo not found
@@ -492,7 +492,7 @@ npx vue-tsc --noEmit
 **Solution:** Install @typescript/native-preview:
 
 ```bash
-npm install --save-dev @typescript/native-preview
+yarn add --save-dev @typescript/native-preview
 ```
 
 ### Slow type checking