@dimensional-innovations/tool-config 3.0.0 → 3.0.2

package/README.md

@@ -4,8 +4,8 @@
 
 [![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/)
-[![Test Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)](./tests/)
+[![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,27 +28,27 @@ npm install --save-dev \
 **After:**
 
 ```bash
-npm install --save-dev @dimensional-innovations/tool-config
+yarn add --dev @dimensional-innovations/tool-config
 ```
 
 ## Features
 
 - 🎯 **Zero Configuration** - Auto-detects your framework, environment, and TypeScript
 - 🧰 **Multi-Tool Support** - ESLint, Prettier, Stylelint, TypeScript, semantic-release in one package
-- ⚛️ **8+ Frameworks** - React, Vue, Svelte, Solid, Astro, Angular, Vanilla JS, Node.js
+- ⚛️ **9 Frameworks** - React, Vue, Svelte, Solid, Astro, Angular, Vanilla JS, Node.js, Electron
 - 📦 **All-In-One** - All plugins and parsers included as dependencies
 - 🔧 **Customizable** - Override any setting while keeping smart defaults
 - 🚀 **Modern** - ESLint 9+ flat config, TypeScript with tsgo support (10x faster)
 - 🔄 **Uninstall Support** - Clean removal with safety checks for modified files
 - 🎬 **Smart Scripts** - Auto-generated `check-all` script runs tools in optimal order
-- ✅ **Battle-Tested** - 556 tests with 100% coverage
+- ✅ **Battle-Tested** - 556 tests with 96% coverage
 
 ## Quick Start
 
 ### 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
 {
@@ -120,11 +120,11 @@ That's it! The configs will automatically detect your framework and TypeScript s
     "lint:fix": "eslint --fix .",
     "prettier": "prettier --check .",
     "prettier:fix": "prettier --write .",
-    "style": "stylelint '**/*.css'",
-    "style:fix": "stylelint '**/*.css' --fix",
+    "style": "stylelint '**/*.css' --allow-empty-input",
+    "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"
   }
 }
 ```
@@ -143,6 +143,7 @@ That's it! The configs will automatically detect your framework and TypeScript s
 | Angular   | ✅     | ✅       | ✅                  | ✅ decorators   | ✅          |
 | Vanilla   | ✅     | ✅       | ✅                  | ✅ browser      | ✅          |
 | Node.js   | ✅     | ✅       | N/A                 | ✅ NodeNext     | ✅          |
+| Electron  | ✅     | ✅       | N/A                 | ✅ multi-config | ✅          |
 
 **Meta-frameworks**: Next.js (→ React), Nuxt (→ Vue), SvelteKit (→ Svelte)
 
@@ -179,23 +180,11 @@ await createConfig('eslint', {
 })
 ```
 
-**Example - Custom Rules:**
+**Custom rules:**
 
 ```javascript
 export default await createConfig('eslint', {
-  rules: {
-    'no-console': 'off',
-    'react/prop-types': 'warn'
-  }
-})
-```
-
-**Example - Explicit Framework:**
-
-```javascript
-export default await createConfig('eslint', {
-  framework: 'vue',
-  typescript: true
+  rules: { 'no-console': 'off' }
 })
 ```
 
@@ -204,20 +193,9 @@ export default await createConfig('eslint', {
 ```javascript
 createConfig('prettier', {
   framework: 'auto',
-  // Override any Prettier option
+  printWidth: 100, // Override any Prettier option
   semi: false,
-  singleQuote: true,
-  printWidth: 100
-})
-```
-
-**Example - Custom Settings:**
-
-```javascript
-export default createConfig('prettier', {
-  printWidth: 120,
-  tabWidth: 4,
-  trailingComma: 'all'
+  singleQuote: true
 })
 ```
 
@@ -226,57 +204,29 @@ export default createConfig('prettier', {
 ```javascript
 createConfig('stylelint', {
   framework: 'auto',
-  cssType: 'auto', // 'auto' | 'scss' | 'css' | { preprocessor, tailwind, modules }
+  cssType: 'auto', // 'auto' | 'scss' | 'css'
+  cssType: { preprocessor: 'scss', tailwind: true }, // Or object
   rules: {} // Custom rule overrides
 })
 ```
 
-**Example - SCSS + Tailwind:**
-
-```javascript
-export default createConfig('stylelint', {
-  cssType: {
-    preprocessor: 'scss',
-    tailwind: true
-  }
-})
-```
-
 ### TypeScript Options
 
 ```javascript
 await createConfig('typescript', {
   framework: 'auto', // Auto-detect or specify framework
   environment: 'auto', // 'auto' | 'browser' | 'node' | 'universal'
-  checker: 'auto', // 'auto' | 'modern' (tsgo) | 'legacy' (tsc/vue-tsc)
+  checker: 'auto', // 'auto' | 'modern' (tsgo) | 'legacy' (tsc)
   strict: true, // Enable strict type checking
-  compilerOptions: {} // Custom TypeScript compiler options
-})
-```
-
-**Example - React with Custom Options:**
-
-```javascript
-export default await createConfig('typescript', {
-  framework: 'react',
   compilerOptions: {
+    // Custom compiler options
     baseUrl: '.',
-    paths: {
-      '@/*': ['src/*']
-    }
+    paths: { '@/*': ['src/*'] }
   }
 })
 ```
 
-**Example - Use tsgo for 10x Faster Type Checking:**
-
-```javascript
-export default await createConfig('typescript', {
-  checker: 'modern' // Forces tsgo when installed
-})
-```
-
-**tsgo Support:** Install `@typescript/native-preview` for 10x faster type checking. The package automatically detects and uses tsgo when available.
+**tsgo Support:** Install `@typescript/native-preview` for 10x faster type checking. Auto-detected or set `checker: 'modern'` to force it.
 
 ### semantic-release Options
 
@@ -287,15 +237,6 @@ createConfig('semantic-release', {
 })
 ```
 
-**Example - Library Release:**
-
-```javascript
-export default createConfig('semantic-release', {
-  preset: 'library',
-  gitProvider: 'github'
-})
-```
-
 ## Framework-Specific Guides
 
 ### React
@@ -424,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
@@ -586,64 +527,43 @@ See the [`examples/`](./examples/) directory for complete working examples:
 - [Node Backend](./examples/node-backend/) - Express, TypeScript
 - [Vanilla JS](./examples/vanilla-js/) - Pure JavaScript, no framework
 
-Each example includes all 4 tool configurations and npm scripts.
+Each example includes all 5 tool configurations and npm scripts.
 
 ## Advanced Usage
 
-### Monorepo Support
-
-Use different configs per workspace:
+**Monorepo Support:**
 
 ```javascript
 // apps/frontend/eslint.config.js
-export default await createConfig('eslint', {
-  framework: 'react',
-  typescript: true
-})
+export default await createConfig('eslint', { framework: 'react' })
 
 // apps/backend/eslint.config.js
-export default await createConfig('eslint', {
-  framework: 'node',
-  environment: 'node'
-})
+export default await createConfig('eslint', { framework: 'node' })
 ```
 
-### Custom Ignore Patterns
+**Custom Ignore Patterns:**
 
 ```javascript
 export default await createConfig('eslint', {
-  ignore: ['dist/**', 'build/**', '**/*.generated.ts']
+  ignore: ['dist/**', '**/*.generated.ts']
 })
 ```
 
-### Environment-Specific Rules
+**Environment-Specific Rules:**
 
 ```javascript
-const isDev = process.env.NODE_ENV === 'development'
-
 export default await createConfig('eslint', {
   rules: {
-    'no-console': isDev ? 'off' : 'error',
-    'no-debugger': isDev ? 'warn' : 'error'
+    'no-console': process.env.NODE_ENV === 'development' ? 'off' : 'error'
   }
 })
 ```
 
-### Combining with Other Configs
+**Combining with Other Configs:**
 
 ```javascript
-import { createConfig } from '@dimensional-innovations/tool-config'
-import customRules from './custom-rules.js'
-
 const baseConfig = await createConfig('eslint')
-
-export default [
-  ...baseConfig,
-  {
-    files: ['**/*.js'],
-    rules: customRules
-  }
-]
+export default [...baseConfig, { files: ['**/*.js'], rules: customRules }]
 ```
 
 ## Ignoring Files
@@ -698,8 +618,7 @@ export default createConfig('stylelint', {
 
 **Prettier** - Edit `.prettierignore` file:
 
-```
-# Custom ignores
+```text
 generated/
 legacy/
 ```
@@ -721,82 +640,25 @@ npx prettier --check . --debug-check
 
 ## Troubleshooting
 
-### Tools Processing Build Outputs
-
-If you see errors about linting/formatting files in `dist/`, `coverage/`, or `out/`:
-
-1. **ESLint**: Ignore patterns are applied automatically ✅
-2. **Stylelint**: Ignore patterns are applied automatically ✅
-3. **Prettier**: Check that `.prettierignore` was created. If not, re-run config creation or manually create the file.
-
-**Solution**: If `.prettierignore` is missing, it will be auto-created next time you use the config. Or create it manually:
-
-```bash
-# Let Prettier generate it
-node -e "import('@dimensional-innovations/tool-config').then(m => m.createConfig('prettier'))"
-```
-
-### ESLint Not Detecting Framework
-
-Ensure your `package.json` includes the framework dependency:
-
-```json
-{
-  "dependencies": {
-    "react": "^18.0.0"
-  }
-}
-```
-
-Or explicitly specify:
-
-```javascript
-export default await createConfig('eslint', {
-  framework: 'react'
-})
-```
-
-### TypeScript Parsing Errors
+**ESLint not detecting framework:** Ensure framework is in `package.json` dependencies, or explicitly set `framework: 'react'`.
 
-Make sure `typescript` is installed:
+**TypeScript parsing errors:** Install TypeScript: `yarn add --dev typescript`
 
-```bash
-npm install --save-dev typescript
-```
-
-### Prettier Plugin Not Found
-
-Install the required peer dependency:
+**Prettier plugin not found:** Install required peer dependency:
 
 ```bash
-npm install --save-dev prettier-plugin-svelte  # For Svelte
-npm install --save-dev prettier-plugin-astro   # For Astro
+yarn add --dev prettier-plugin-svelte  # Svelte
+yarn add --dev prettier-plugin-astro   # Astro
 ```
 
-### Stylelint Not Linting .vue Files
+**Stylelint not linting .vue files:** Update script: `"style": "stylelint '**/*.css' '**/*.vue' --allow-empty-input"`
 
-Update your npm script to include `.vue` files:
-
-```json
-{
-  "scripts": {
-    "style": "stylelint '**/*.css' '**/*.vue'"
-  }
-}
-```
-
-### Config Not Updating After Framework Change
-
-Delete `node_modules/.cache` and restart your editor:
-
-```bash
-rm -rf node_modules/.cache
-```
+**Config not updating:** Delete `node_modules/.cache` and restart editor.
 
 ## 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
@@ -808,20 +670,18 @@ This package follows these principles:
 - **Fail Loudly** - Errors for critical issues, warnings for quality improvements
 - **Framework Agnostic** - No opinions about which framework you use
 - **Modern Standards** - Uses latest tooling and ESLint flat config
-- **Comprehensive Coverage** - 100% test coverage, battle-tested in production
+- **Comprehensive Coverage** - 96% test coverage, battle-tested in production
 
 ## Contributing
 
-Contributions welcome! This package is built to be extensible.
-
-**To add a new framework:**
+Contributions welcome! To add a new framework:
 
 1. Add detection logic in `src/detectors.js`
 2. Create presets in `src/tools/{tool}/presets/frameworks/`
 3. Add tests with 100% coverage
 4. Update documentation
 
-See [IMPLEMENTATION_PLAN.md](./IMPLEMENTATION_PLAN.md) for architecture details.
+See [CLAUDE.md](./CLAUDE.md) for architecture details.
 
 ## License
 

package/bin/lib/handlers/stylelint.js

@@ -51,8 +51,8 @@ export function getScripts(detected) {
     extensions.length === 1 ? `**/*.${extensions[0]}` : `**/*.{${extensions.join(',')}}`
 
   return {
-    style: `stylelint "${pattern}"`,
-    'style:fix': `stylelint "${pattern}" --fix`
+    style: `stylelint "${pattern}" --allow-empty-input`,
+    'style:fix': `stylelint "${pattern}" --fix --allow-empty-input`
   }
 }
 

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.0",
+  "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,23 +47,24 @@
     "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",
     "test:coverage": "vitest run --coverage",
     "release": "semantic-release",
     "prepare": "husky",
-    "style": "stylelint \"**/*.css\"",
-    "style:fix": "stylelint \"**/*.css\" --fix",
+    "style": "stylelint \"**/*.css\" --allow-empty-input",
+    "style:fix": "stylelint \"**/*.css\" --fix --allow-empty-input",
     "typecheck": "tsc --noEmit",
-    "typecheck:watch": "tsc --noEmit --watch"
+    "typecheck:watch": "tsc --noEmit --watch",
+    "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
@@ -194,8 +194,8 @@ Add these scripts to your `package.json`:
 ```json
 {
   "scripts": {
-    "style": "stylelint '**/*.css'",
-    "style:fix": "stylelint '**/*.css' --fix"
+    "style": "stylelint '**/*.css' --allow-empty-input",
+    "style:fix": "stylelint '**/*.css' --fix --allow-empty-input"
   }
 }
 ```
@@ -207,8 +207,8 @@ Add these scripts to your `package.json`:
 ```json
 {
   "scripts": {
-    "style": "stylelint '**/*.css' '**/*.vue'",
-    "style:fix": "stylelint '**/*.css' '**/*.vue' --fix"
+    "style": "stylelint '**/*.css' '**/*.vue' --allow-empty-input",
+    "style:fix": "stylelint '**/*.css' '**/*.vue' --fix --allow-empty-input"
   }
 }
 ```
@@ -218,8 +218,8 @@ Add these scripts to your `package.json`:
 ```json
 {
   "scripts": {
-    "style": "stylelint '**/*.css' '**/*.svelte'",
-    "style:fix": "stylelint '**/*.css' '**/*.svelte' --fix"
+    "style": "stylelint '**/*.css' '**/*.svelte' --allow-empty-input",
+    "style:fix": "stylelint '**/*.css' '**/*.svelte' --fix --allow-empty-input"
   }
 }
 ```
@@ -229,8 +229,8 @@ Add these scripts to your `package.json`:
 ```json
 {
   "scripts": {
-    "style": "stylelint '**/*.css'",
-    "style:fix": "stylelint '**/*.css' --fix'
+    "style": "stylelint '**/*.css' --allow-empty-input",
+    "style:fix": "stylelint '**/*.css' --fix --allow-empty-input'
   }
 }
 ```
@@ -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
@@ -338,7 +338,7 @@ Make sure your script includes `.vue` files:
 ```json
 {
   "scripts": {
-    "style": "stylelint '**/*.css' '**/*.vue'"
+    "style": "stylelint '**/*.css' '**/*.vue' --allow-empty-input"
   }
 }
 ```
@@ -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