@dimensional-innovations/tool-config 1.1.0 → 1.2.0

package/README.md

@@ -541,8 +541,96 @@ export default [
 ]
 ```
 
+## Ignoring Files
+
+All tools automatically ignore common build outputs and generated files to prevent unnecessary linting and formatting. This happens automatically when you create a config - no manual setup required.
+
+### What Gets Ignored
+
+**Common directories** (all tools):
+
+- `node_modules/` - Dependencies
+- `dist/`, `build/`, `out/` - Build outputs
+- `coverage/` - Test coverage reports
+- `.nyc_output/` - NYC coverage data
+
+**Framework build outputs** (all tools):
+
+- `.next/` - Next.js
+- `.nuxt/`, `.output/` - Nuxt
+- `.svelte-kit/` - SvelteKit
+- `.vite/` - Vite cache
+- `.cache/`, `.parcel-cache/`, `.turbo/` - Build caches
+
+**Generated files** (Prettier only):
+
+- Lock files (`package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`)
+- `CHANGELOG.md` (auto-generated by semantic-release)
+
+### How It Works
+
+**ESLint**: Uses runtime `ignores` array in flat config
+**Stylelint**: Uses runtime `ignoreFiles` property in config
+**Prettier**: Auto-generates `.prettierignore` file on first run
+
+### Customizing Ignore Patterns
+
+**ESLint** - Add custom ignores:
+
+```javascript
+export default await createConfig('eslint', {
+  ignorePaths: ['generated/**', 'legacy/**']
+})
+```
+
+**Stylelint** - Extend ignoreFiles:
+
+```javascript
+export default createConfig('stylelint', {
+  ignoreFiles: ['**/*.min.css', 'vendor/**']
+})
+```
+
+**Prettier** - Edit `.prettierignore` file:
+
+```
+# Custom ignores
+generated/
+legacy/
+```
+
+### Verifying Ignore Patterns
+
+Check what files are being processed:
+
+```bash
+# ESLint
+npx eslint --debug . 2>&1 | grep "Ignored"
+
+# Stylelint
+npx stylelint "**/*.css" --formatter verbose
+
+# Prettier
+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:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimensional-innovations/tool-config",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Universal configuration package for ESLint, Prettier, Stylelint, and semantic-release with auto-detection for React, Vue, Svelte, Solid, Astro, Angular, and more",
   "license": "MIT",
   "author": {

package/src/tools/eslint/index.js

@@ -2,6 +2,7 @@ import js from '@eslint/js'
 import tseslint from 'typescript-eslint'
 
 import { autoDetect } from '../../detectors.js'
+import { getEslintIgnores } from '../../utils/ignore-patterns.js'
 
 import basePreset from './presets/base.js'
 import browserEnv from './presets/environments/browser.js'
@@ -234,16 +235,7 @@ export async function createEslintConfig(options = {}) {
     )
   }
 
-  const defaultIgnorePaths = [
-    '**/node_modules/**',
-    '**/dist/**',
-    '**/build/**',
-    '**/out/**',
-    '**/coverage/**',
-    '**/*.min.js',
-    '**/.next/**',
-    '**/.nuxt/**'
-  ]
+  const defaultIgnorePaths = getEslintIgnores()
   const allIgnorePaths = [...defaultIgnorePaths, ...(options.ignorePaths || [])]
 
   const config = []

package/src/tools/prettier/index.js

@@ -4,7 +4,11 @@
  * Creates Prettier configurations with framework-aware defaults and auto-detection.
  */
 
+import { existsSync, writeFileSync } from 'fs'
+import { join } from 'path'
+
 import { autoDetect } from '../../detectors.js'
+import { getPrettierIgnoreContent } from '../../utils/ignore-patterns.js'
 
 import basePreset from './presets/base.js'
 import astroPreset from './presets/frameworks/astro.js'
@@ -45,6 +49,20 @@ export function createPrettierConfig(options = {}) {
   // Auto-detect framework if needed
   const framework = explicitFramework === 'auto' ? autoDetect(cwd).framework : explicitFramework
 
+  // Auto-generate .prettierignore if it doesn't exist
+  const ignoreFile = join(cwd, '.prettierignore')
+  if (!existsSync(ignoreFile)) {
+    try {
+      writeFileSync(ignoreFile, getPrettierIgnoreContent(), 'utf8')
+      console.warn('📝 Prettier: Created .prettierignore file')
+    } catch {
+      console.warn(
+        '⚠️  Prettier: Could not create .prettierignore file automatically.\n' +
+          '   Please create it manually or ensure write permissions.'
+      )
+    }
+  }
+
   // Start with base configuration
   const config = { ...basePreset }
 

package/src/tools/stylelint/index.js

@@ -8,6 +8,7 @@
  */
 
 import { autoDetect, detectCssType } from '../../detectors.js'
+import { getStylelintIgnores } from '../../utils/ignore-patterns.js'
 
 import basePreset from './presets/base.js'
 import cssModulesPreset from './presets/css-modules.js'
@@ -127,6 +128,9 @@ export function createStylelintConfig(options = {}) {
       ? { ...scssPreset, customSyntax: 'postcss-scss' }
       : { ...basePreset }
 
+  // Add default ignore patterns
+  config.ignoreFiles = getStylelintIgnores()
+
   // Apply Tailwind preset if detected
   if (cssType?.tailwind) {
     mergePreset(config, tailwindPreset)

package/src/utils/ignore-patterns.js

@@ -0,0 +1,156 @@
+/**
+ * Shared ignore patterns for all tools
+ *
+ * Provides consistent ignore patterns across ESLint, Prettier, and Stylelint
+ * to prevent processing build outputs, dependencies, and generated files.
+ */
+
+/**
+ * Common directories that should be ignored by all tools
+ */
+export const COMMON_IGNORE_DIRS = [
+  'node_modules',
+  'dist',
+  'build',
+  'out',
+  'coverage',
+  '.nyc_output'
+]
+
+/**
+ * Framework-specific build outputs
+ */
+export const FRAMEWORK_BUILD_DIRS = [
+  '.next', // Next.js
+  '.nuxt', // Nuxt
+  '.output', // Nitro/Nuxt3
+  '.vercel', // Vercel
+  '.netlify', // Netlify
+  '.cache', // Gatsby/Parcel
+  '.parcel-cache', // Parcel
+  '.turbo', // Turborepo
+  '.vite', // Vite
+  '.svelte-kit' // SvelteKit
+]
+
+/**
+ * Lock files and generated files
+ */
+export const GENERATED_FILES = [
+  'package-lock.json',
+  'pnpm-lock.yaml',
+  'yarn.lock',
+  'bun.lockb',
+  'CHANGELOG.md'
+]
+
+/**
+ * Minified files
+ */
+export const MINIFIED_FILES = ['*.min.js', '*.min.css', '*.min.mjs']
+
+/**
+ * Get ESLint ignore patterns (flat config format)
+ * @returns {string[]} Array of glob patterns for ESLint ignores array
+ */
+export function getEslintIgnores() {
+  return [
+    ...COMMON_IGNORE_DIRS.map(dir => `**/${dir}/**`),
+    ...FRAMEWORK_BUILD_DIRS.map(dir => `**/${dir}/**`),
+    ...MINIFIED_FILES.map(pattern => `**/${pattern}`)
+  ]
+}
+
+/**
+ * Get Stylelint ignore patterns (ignoreFiles format)
+ * @returns {string[]} Array of glob patterns for Stylelint ignoreFiles
+ */
+export function getStylelintIgnores() {
+  return [
+    ...COMMON_IGNORE_DIRS.map(dir => `**/${dir}/**`),
+    ...FRAMEWORK_BUILD_DIRS.map(dir => `**/${dir}/**`),
+    ...MINIFIED_FILES.map(pattern => `**/${pattern}`)
+  ]
+}
+
+/**
+ * Get Prettier ignore content (.prettierignore file format)
+ * @returns {string} .prettierignore file content
+ */
+export function getPrettierIgnoreContent() {
+  return `# Dependencies
+node_modules/
+.pnp/
+.pnp.js
+
+# Build outputs
+${COMMON_IGNORE_DIRS.filter(dir => dir !== 'node_modules' && dir !== 'coverage')
+  .map(dir => `${dir}/`)
+  .join('\n')}
+${FRAMEWORK_BUILD_DIRS.map(dir => `${dir}/`).join('\n')}
+
+# Coverage
+coverage/
+.nyc_output/
+*.lcov
+
+# Lock files
+${GENERATED_FILES.filter(f => f.includes('lock') || f.includes('.lock')).join('\n')}
+
+# Generated files
+CHANGELOG.md
+
+# Cache directories
+.cache/
+.parcel-cache/
+.turbo/
+.vite/
+
+# Environment files (may contain secrets)
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/
+.idea/
+
+# OS files
+.DS_Store
+Thumbs.db
+`
+}
+
+/**
+ * Get Stylelint ignore content (.stylelintignore file format)
+ * @returns {string} .stylelintignore file content
+ */
+export function getStylelintIgnoreContent() {
+  return `# Dependencies
+node_modules/
+
+# Build outputs
+${COMMON_IGNORE_DIRS.filter(dir => dir !== 'node_modules' && dir !== 'coverage')
+  .map(dir => `${dir}/`)
+  .join('\n')}
+${FRAMEWORK_BUILD_DIRS.map(dir => `${dir}/`).join('\n')}
+
+# Coverage
+coverage/
+.nyc_output/
+
+# Minified files
+${MINIFIED_FILES.join('\n')}
+`
+}
+
+export default {
+  COMMON_IGNORE_DIRS,
+  FRAMEWORK_BUILD_DIRS,
+  GENERATED_FILES,
+  MINIFIED_FILES,
+  getEslintIgnores,
+  getStylelintIgnores,
+  getPrettierIgnoreContent,
+  getStylelintIgnoreContent
+}