@dimensional-innovations/tool-config 1.0.0

package/package.json

@@ -0,0 +1,168 @@
+{
+  "name": "@dimensional-innovations/tool-config",
+  "version": "1.0.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": {
+    "name": "J.D. Hillen",
+    "email": "jdhillen@dimin.com",
+    "url": "https://dimin.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/dimensional-innovations/tool-config.git"
+  },
+  "homepage": "https://gitlab.com/dimensional-innovations/tool-config#readme",
+  "bugs": {
+    "url": "https://gitlab.com/dimensional-innovations/tool-config/issues"
+  },
+  "keywords": [
+    "eslint",
+    "eslint-config",
+    "prettier",
+    "stylelint",
+    "semantic-release",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "astro",
+    "angular",
+    "typescript",
+    "javascript",
+    "auto-detect",
+    "universal",
+    "config",
+    "tool-config"
+  ],
+  "type": "module",
+  "main": "./src/index.js",
+  "bin": {
+    "setup-tool-config": "bin/setup-tool-config.js"
+  },
+  "files": [
+    "src/**",
+    "bin/**",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix .",
+    "prettier": "npx prettier --check .",
+    "prettier:fix": "npx 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"
+  },
+  "dependencies": {
+    "@eslint/compat": "^1.4.0",
+    "@eslint/js": "^9.37.0",
+    "@typescript-eslint/eslint-plugin": "^8.46.0",
+    "@typescript-eslint/parser": "^8.46.0",
+    "astro-eslint-parser": "^1.2.2",
+    "eslint": ">=9.0.0",
+    "eslint-plugin-astro": "^1.3.1",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-react": "^7.37.0",
+    "eslint-plugin-react-hooks": "^6.1.1",
+    "eslint-plugin-solid": "^0.14.5",
+    "eslint-plugin-svelte": "^3.12.4",
+    "eslint-plugin-vue": "^10.5.0",
+    "globals": "^16.4.0",
+    "postcss-scss": "^4.0.9",
+    "prettier": ">=3.0.0",
+    "prompts": "^2.4.2",
+    "stylelint": ">=16.0.0",
+    "stylelint-config-standard": "^39.0.1",
+    "stylelint-config-standard-scss": "^16.0.0",
+    "svelte-eslint-parser": "^1.3.3",
+    "typescript-eslint": "^8.46.0",
+    "vue-eslint-parser": "^10.2.0"
+  },
+  "peerDependencies": {
+    "astro": ">=3.0.0 || >=4.0.0 || >=5.0.0",
+    "eslint": ">=9.0.0",
+    "less": ">=4.0.0",
+    "postcss-html": ">=1.0.0",
+    "prettier": ">=3.0.0",
+    "prettier-plugin-astro": ">=0.12.0",
+    "prettier-plugin-svelte": ">=3.0.0",
+    "sass": ">=1.0.0",
+    "solid-js": ">=1.0.0",
+    "stylelint": ">=16.0.0",
+    "stylelint-config-standard-vue": ">=1.0.0",
+    "svelte": ">=3.0.0 || >=4.0.0 || >=5.0.0",
+    "tailwindcss": ">=3.0.0",
+    "typescript": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "astro": {
+      "optional": true
+    },
+    "eslint": {
+      "optional": true
+    },
+    "less": {
+      "optional": true
+    },
+    "postcss-html": {
+      "optional": true
+    },
+    "prettier": {
+      "optional": true
+    },
+    "prettier-plugin-astro": {
+      "optional": true
+    },
+    "prettier-plugin-svelte": {
+      "optional": true
+    },
+    "sass": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    },
+    "stylelint": {
+      "optional": true
+    },
+    "stylelint-config-standard-vue": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "tailwindcss": {
+      "optional": true
+    },
+    "typescript": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/gitlab": "^13.2.9",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "astro": "^5.14.1",
+    "husky": "^9.1.7",
+    "semantic-release": "^24.2.9",
+    "solid-js": "^1.9.9",
+    "svelte": "^5.39.9",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/detectors.js

@@ -0,0 +1,261 @@
+import { execSync } from 'child_process'
+import { existsSync } from 'fs'
+import { join } from 'path'
+
+import { getAllDependencies, readPackageJson } from './utils/package-reader.js'
+
+/**
+ * Check for React meta-frameworks
+ */
+function detectReactMetaFramework(deps) {
+  return (
+    deps.next ||
+    deps['@next/core'] ||
+    deps.remix ||
+    deps['@remix-run/react'] ||
+    deps['@remix-run/node'] ||
+    deps.gatsby ||
+    deps['gatsby-link']
+  )
+}
+
+/**
+ * Check for Vue meta-frameworks
+ */
+function detectVueMetaFramework(deps) {
+  return deps.nuxt || deps['nuxt3']
+}
+
+/**
+ * Check for Svelte meta-frameworks
+ */
+function detectSvelteMetaFramework(deps) {
+  return deps['@sveltejs/kit']
+}
+
+/**
+ * Check for base framework dependencies
+ */
+function detectBaseFramework(deps) {
+  if (deps.react || deps['react-dom']) return 'react'
+  if (deps.vue || deps['@vue/runtime-core']) return 'vue'
+  if (deps['@angular/core']) return 'angular'
+  if (deps.svelte) return 'svelte'
+  if (deps['solid-js']) return 'solid'
+  if (deps.astro) return 'astro'
+  return null
+}
+
+/**
+ * Check if project is a Node.js backend
+ */
+function isNodeBackend(pkg, deps, cwd) {
+  if (pkg.type !== 'module') return false
+
+  const hasNodeFramework = deps.express || deps.fastify || deps.koa || deps['@hapi/hapi']
+  const hasServerFiles =
+    existsSync(join(cwd, 'server.js')) ||
+    existsSync(join(cwd, 'app.js')) ||
+    (existsSync(join(cwd, 'index.js')) && existsSync(join(cwd, 'routes')))
+
+  return hasNodeFramework || hasServerFiles
+}
+
+/**
+ * Detect the framework being used in the project
+ * @param {string} cwd - Current working directory
+ * @returns {string} Detected framework name
+ */
+export function detectFramework(cwd = process.cwd()) {
+  const pkg = readPackageJson(cwd)
+
+  if (!pkg) {
+    console.warn('⚠️  Could not find package.json, defaulting to vanilla JavaScript')
+    return 'vanilla'
+  }
+
+  const deps = getAllDependencies(pkg)
+
+  // Check meta-frameworks first
+  if (detectReactMetaFramework(deps)) return 'react'
+  if (detectVueMetaFramework(deps)) return 'vue'
+  if (detectSvelteMetaFramework(deps)) return 'svelte'
+
+  // Check base frameworks
+  const baseFramework = detectBaseFramework(deps)
+  if (baseFramework) return baseFramework
+
+  // Check Node.js backend
+  if (isNodeBackend(pkg, deps, cwd)) return 'node'
+
+  // Default to vanilla JavaScript
+  return 'vanilla'
+}
+
+/**
+ * Detect the environment (browser, node, or universal)
+ * @param {string} framework - Detected framework
+ * @param {string} cwd - Current working directory
+ * @returns {string} Environment type
+ */
+export function detectEnvironment(framework, cwd = process.cwd()) {
+  // Framework-specific defaults
+  if (framework === 'node') {
+    return 'node'
+  }
+
+  // Frontend frameworks default to browser
+  if (['react', 'vue', 'svelte', 'solid', 'angular'].includes(framework)) {
+    return 'browser'
+  }
+
+  // Astro uses islands architecture (both browser and node)
+  if (framework === 'astro') {
+    return 'universal'
+  }
+
+  // Check for mixed environment indicators
+  const hasServerCode =
+    existsSync(join(cwd, 'server')) ||
+    existsSync(join(cwd, 'api')) ||
+    existsSync(join(cwd, 'backend'))
+
+  if (hasServerCode) {
+    return 'universal'
+  }
+
+  // Default to browser for frontend projects
+  return 'browser'
+}
+
+/**
+ * Detect if TypeScript is being used
+ * @param {string} cwd - Current working directory
+ * @returns {boolean} True if TypeScript is detected
+ */
+export function detectTypeScript(cwd = process.cwd()) {
+  return existsSync(join(cwd, 'tsconfig.json'))
+}
+
+/**
+ * Detect Git provider from repository URL
+ * @param {string} cwd - Current working directory
+ * @returns {string} Git provider ('gitlab', 'github', 'bitbucket', or null)
+ */
+export function detectGitProvider(cwd = process.cwd()) {
+  // Try package.json repository field first
+  const pkg = readPackageJson(cwd)
+  if (pkg?.repository) {
+    const repoUrl = typeof pkg.repository === 'string' ? pkg.repository : pkg.repository.url || ''
+
+    if (repoUrl.includes('gitlab.com')) return 'gitlab'
+    if (repoUrl.includes('github.com')) return 'github'
+    if (repoUrl.includes('bitbucket.org')) return 'bitbucket'
+
+    // If repository field exists but provider not recognized, return null
+    // Don't fallback to git remote if package.json explicitly specifies a repo
+    return null
+  }
+
+  // Try git remote as fallback only if no repository field in package.json
+  try {
+    const remoteUrl = execSync('git remote get-url origin', {
+      cwd,
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'ignore']
+    }).trim()
+
+    if (remoteUrl.includes('gitlab.com')) return 'gitlab'
+    if (remoteUrl.includes('github.com')) return 'github'
+    if (remoteUrl.includes('bitbucket.org')) return 'bitbucket'
+  } catch {
+    // Git command failed or not a git repository
+  }
+
+  // Default to null (no provider detected)
+  return null
+}
+
+/**
+ * Detect CSS type and variants
+ * @param {string} cwd - Current working directory
+ * @returns {Object} CSS type detection results
+ */
+export function detectCssType(cwd = process.cwd()) {
+  const pkg = readPackageJson(cwd)
+
+  const results = {
+    preprocessor: null, // 'scss', 'sass', 'less', null
+    tailwind: false,
+    modules: false,
+    postcss: false
+  }
+
+  // Detect SCSS/Sass
+  const hasSass =
+    pkg?.dependencies?.sass ||
+    pkg?.devDependencies?.sass ||
+    pkg?.dependencies?.['node-sass'] ||
+    pkg?.devDependencies?.['node-sass'] ||
+    pkg?.dependencies?.['sass-embedded'] ||
+    pkg?.devDependencies?.['sass-embedded']
+
+  if (hasSass) {
+    results.preprocessor = 'scss'
+  }
+
+  // Detect Less
+  const hasLess = pkg?.dependencies?.less || pkg?.devDependencies?.less
+
+  if (hasLess && !hasSass) {
+    // SCSS takes precedence if both exist
+    results.preprocessor = 'less'
+  }
+
+  // Detect Tailwind CSS
+  const hasTailwind = pkg?.dependencies?.tailwindcss || pkg?.devDependencies?.tailwindcss
+
+  if (hasTailwind) {
+    // Check for config file
+    results.tailwind =
+      existsSync(join(cwd, 'tailwind.config.js')) ||
+      existsSync(join(cwd, 'tailwind.config.ts')) ||
+      existsSync(join(cwd, 'tailwind.config.mjs')) ||
+      existsSync(join(cwd, 'tailwind.config.cjs'))
+  }
+
+  // Detect PostCSS config
+  results.postcss =
+    existsSync(join(cwd, 'postcss.config.js')) ||
+    existsSync(join(cwd, 'postcss.config.cjs')) ||
+    existsSync(join(cwd, 'postcss.config.mjs')) ||
+    existsSync(join(cwd, '.postcssrc')) ||
+    existsSync(join(cwd, '.postcssrc.json'))
+
+  // Note: CSS Modules detection is tricky without scanning files
+  // Framework-based heuristic: React/Next.js projects often use CSS Modules
+  // Will be set to true if React/Next.js detected (handled in Stylelint factory)
+
+  return results
+}
+
+/**
+ * Auto-detect all configuration options
+ * @param {string} cwd - Current working directory
+ * @returns {Object} Detected configuration
+ */
+export function autoDetect(cwd = process.cwd()) {
+  const framework = detectFramework(cwd)
+  const environment = detectEnvironment(framework, cwd)
+  const typescript = detectTypeScript(cwd)
+  const gitProvider = detectGitProvider(cwd)
+  const cssType = detectCssType(cwd)
+
+  return {
+    framework,
+    environment,
+    typescript,
+    gitProvider,
+    cssType
+  }
+}

package/src/index.js

@@ -0,0 +1,64 @@
+/**
+ * @dimensional-innovations/tool-config
+ * Universal configuration package for development tools
+ *
+ * Supports: ESLint, Prettier, Stylelint, semantic-release
+ * Auto-detects: React, Vue, Svelte, Solid, Astro, Angular, Vanilla JS, Node.js
+ */
+
+/**
+ * Create a configuration for a specific tool
+ *
+ * @param {string} tool - Tool name ('eslint' | 'prettier' | 'stylelint' | 'semantic-release')
+ * @param {Object} options - Configuration options
+ * @returns {Promise<any>|any} Tool-specific configuration
+ *
+ * @example
+ * // ESLint configuration
+ * import { createConfig } from '@dimensional-innovations/tool-config';
+ * export default await createConfig('eslint', {
+ *   framework: 'auto',
+ *   environment: 'auto',
+ *   typescript: 'auto'
+ * });
+ *
+ * @example
+ * // Prettier configuration
+ * import { createConfig } from '@dimensional-innovations/tool-config';
+ * export default createConfig('prettier', {
+ *   framework: 'auto'
+ * });
+ */
+export async function createConfig(tool, options = {}) {
+  switch (tool) {
+    case 'eslint': {
+      const { createEslintConfig } = await import('./tools/eslint/index.js')
+      return createEslintConfig(options)
+    }
+    case 'prettier': {
+      const { createPrettierConfig } = await import('./tools/prettier/index.js')
+      return createPrettierConfig(options)
+    }
+    case 'stylelint': {
+      const { createStylelintConfig } = await import('./tools/stylelint/index.js')
+      return createStylelintConfig(options)
+    }
+    case 'semantic-release': {
+      const { createReleaseConfig } = await import('./tools/semantic-release/index.js')
+      return createReleaseConfig(options)
+    }
+    default:
+      throw new Error(
+        `Unknown tool: "${tool}". Supported tools: eslint, prettier, stylelint, semantic-release`
+      )
+  }
+}
+
+// Named exports for convenience
+export { createEslintConfig } from './tools/eslint/index.js'
+export { createPrettierConfig } from './tools/prettier/index.js'
+export { createStylelintConfig } from './tools/stylelint/index.js'
+export { createReleaseConfig } from './tools/semantic-release/index.js'
+
+// Re-export detection utilities for advanced users
+export { autoDetect, detectFramework, detectEnvironment, detectTypeScript } from './detectors.js'