@dimensional-innovations/tool-config 1.4.0 → 2.0.0

package/README.md

@@ -1,15 +1,15 @@
 # @dimensional-innovations/tool-config
 
-> Universal configuration package for ESLint, Prettier, Stylelint, and semantic-release with automatic framework detection.
+> Universal configuration package for ESLint, Prettier, Stylelint, TypeScript, and semantic-release with automatic framework detection.
 
 [![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/)
 
-**One package. Four tools. Zero configuration.**
+**One package. Five tools. Zero configuration.**
 
-Stop juggling multiple config packages. This single package provides battle-tested configurations for ESLint, Prettier, Stylelint, and semantic-release that automatically detect your project's framework, environment, and TypeScript setup.
+Stop juggling multiple config packages. This single package provides battle-tested configurations for ESLint, Prettier, Stylelint, TypeScript, and semantic-release that automatically detect your project's framework, environment, and TypeScript setup.
 
 ## Why This Package?
 
@@ -34,12 +34,12 @@ npm install --save-dev @dimensional-innovations/tool-config
 ## Features
 
 - 🎯 **Zero Configuration** - Auto-detects your framework, environment, and TypeScript
-- 🧰 **Multi-Tool Support** - ESLint, Prettier, Stylelint, semantic-release in one package
+- 🧰 **Multi-Tool Support** - ESLint, Prettier, Stylelint, TypeScript, semantic-release in one package
 - ⚛️ **8+ Frameworks** - React, Vue, Svelte, Solid, Astro, Angular, Vanilla JS, Node.js
 - 📦 **All-In-One** - All plugins and parsers included as dependencies
 - 🔧 **Customizable** - Override any setting while keeping smart defaults
-- 🚀 **Modern** - ESLint 9+ flat config, latest tooling versions
-- ✅ **Battle-Tested** - 369 tests with 100% coverage
+- 🚀 **Modern** - ESLint 9+ flat config, TypeScript with tsgo support (10x faster)
+- ✅ **Battle-Tested** - 535 tests with 100% coverage
 
 ## Quick Start
 
@@ -83,6 +83,22 @@ import { createConfig } from '@dimensional-innovations/tool-config'
 export default createConfig('stylelint')
 ```
 
+**TypeScript** (`tsconfig.json`):
+
+```json
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules"]
+}
+```
+
+Or use the factory function to generate framework-specific TypeScript configs programmatically.
+
 **semantic-release** (`release.config.js`):
 
 ```javascript
@@ -103,23 +119,25 @@ That's it! The configs will automatically detect your framework and TypeScript s
     "prettier": "prettier --check .",
     "prettier:fix": "prettier --write .",
     "style": "stylelint '**/*.css'",
-    "style:fix": "stylelint '**/*.css' --fix"
+    "style:fix": "stylelint '**/*.css' --fix",
+    "typecheck": "tsc --noEmit",
+    "typecheck:watch": "tsc --noEmit --watch"
   }
 }
 ```
 
 ## Supported Frameworks
 
-| Framework | ESLint | Prettier | Stylelint           | Auto-Detect |
-| --------- | ------ | -------- | ------------------- | ----------- |
-| React     | ✅     | ✅       | ✅ CSS Modules      | ✅          |
-| Vue       | ✅     | ✅       | ✅ Scoped Styles    | ✅          |
-| Svelte    | ✅     | ✅       | ✅ Component Styles | ✅          |
-| Solid     | ✅     | ✅       | ✅ CSS Modules      | ✅          |
-| Astro     | ✅     | ✅       | ✅                  | ✅          |
-| Angular   | ✅     | ✅       | ✅                  | ✅          |
-| Vanilla   | ✅     | ✅       | ✅                  | ✅          |
-| Node.js   | ✅     | ✅       | N/A                 | ✅          |
+| Framework | ESLint | Prettier | Stylelint           | TypeScript      | Auto-Detect |
+| --------- | ------ | -------- | ------------------- | --------------- | ----------- |
+| React     | ✅     | ✅       | ✅ CSS Modules      | ✅ react-jsx    | ✅          |
+| Vue       | ✅     | ✅       | ✅ Scoped Styles    | ✅ vue-tsc      | ✅          |
+| Svelte    | ✅     | ✅       | ✅ Component Styles | ✅ svelte types | ✅          |
+| Solid     | ✅     | ✅       | ✅ CSS Modules      | ✅ solid-js     | ✅          |
+| Astro     | ✅     | ✅       | ✅                  | ✅ astro/client | ✅          |
+| Angular   | ✅     | ✅       | ✅                  | ✅ decorators   | ✅          |
+| Vanilla   | ✅     | ✅       | ✅                  | ✅ browser      | ✅          |
+| Node.js   | ✅     | ✅       | N/A                 | ✅ NodeNext     | ✅          |
 
 **Meta-frameworks**: Next.js (→ React), Nuxt (→ Vue), SvelteKit (→ Svelte)
 
@@ -131,7 +149,7 @@ The main factory function that creates configurations for any supported tool.
 
 **Parameters:**
 
-- `tool` (string, required): Tool name - `'eslint'`, `'prettier'`, `'stylelint'`, or `'semantic-release'`
+- `tool` (string, required): Tool name - `'eslint'`, `'prettier'`, `'stylelint'`, `'typescript'`, or `'semantic-release'`
 - `options` (object, optional): Configuration options
 
 **Common Options:**
@@ -219,6 +237,42 @@ export default createConfig('stylelint', {
 })
 ```
 
+### 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)
+  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: {
+    baseUrl: '.',
+    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.
+
 ### semantic-release Options
 
 ```javascript

package/bin/lib/ci-setup.js

@@ -0,0 +1,142 @@
+/**
+ * CI/CD setup utilities for setup-tool-config CLI
+ * Handles CI template copying and configuration
+ */
+
+import { copyFileSync, existsSync, mkdirSync } from 'fs'
+import { dirname, join } from 'path'
+import { fileURLToPath } from 'url'
+
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const __filename = fileURLToPath(import.meta.url)
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const __dirname = dirname(__filename)
+
+/**
+ * Get CI filename and path for a git provider
+ */
+function getCIFileInfo(provider) {
+  const ciFiles = {
+    gitlab: {
+      filename: '.gitlab-ci.yml',
+      destination: '.gitlab-ci.yml',
+      template: '.gitlab-ci.yml'
+    },
+    github: {
+      filename: 'ci.yml',
+      destination: '.github/workflows/ci.yml',
+      template: 'github-workflow.yml',
+      needsDir: true
+    },
+    bitbucket: {
+      filename: 'bitbucket-pipelines.yml',
+      destination: 'bitbucket-pipelines.yml',
+      template: 'bitbucket-pipelines.yml'
+    }
+  }
+
+  return ciFiles[provider] || null
+}
+
+/**
+ * Get environment variable instructions for a git provider
+ */
+function getCIInstructions(provider) {
+  const instructions = {
+    gitlab: `
+⚠️  Configuration Required:
+  Add these CI/CD variables in GitLab Settings > CI/CD > Variables:
+  - GL_TOKEN: GitLab Personal Access Token (with api scope)
+  - NPM_TOKEN: npm authentication token
+
+  Then push to main branch to trigger automated releases.`,
+    github: `
+⚠️  Configuration Required:
+  Add these secrets in GitHub Settings > Secrets and variables > Actions:
+  - GITHUB_TOKEN: Automatically provided by GitHub Actions
+  - NPM_TOKEN: npm authentication token
+
+  Then push to main branch to trigger automated releases.`,
+    bitbucket: `
+⚠️  Configuration Required:
+  Add this repository variable in Bitbucket Settings > Pipelines > Repository variables:
+  - NPM_TOKEN: npm authentication token
+
+  Then push to main branch to trigger automated releases.`
+  }
+
+  return instructions[provider] || ''
+}
+
+/**
+ * Copy CI/CD template
+ */
+export function copyCITemplate(provider, cwd, dryRun = false) {
+  if (!provider || provider === 'unknown') {
+    console.log('  ⚠️  Could not detect git provider - skipping CI setup')
+    console.log('  💡 You can manually copy templates from:')
+    console.log(
+      '     node_modules/@dimensional-innovations/tool-config/src/tools/semantic-release/templates/'
+    )
+    return false
+  }
+
+  const ciInfo = getCIFileInfo(provider)
+
+  if (!ciInfo) {
+    console.log(`  ⚠️  Unsupported git provider: ${provider}`)
+    return false
+  }
+
+  const destPath = join(cwd, ciInfo.destination)
+  const destDir = dirname(destPath)
+
+  // Check if CI file already exists
+  if (existsSync(destPath)) {
+    console.log(`  ⚠️  ${ciInfo.destination} already exists - skipping`)
+    return false
+  }
+
+  if (dryRun) {
+    console.log(`  📄 Would create: ${ciInfo.destination}`)
+    if (ciInfo.needsDir && !existsSync(destDir)) {
+      console.log(`  📁 Would create directory: ${dirname(ciInfo.destination)}`)
+    }
+    return true
+  }
+
+  try {
+    // Create directory if needed
+    if (ciInfo.needsDir && !existsSync(destDir)) {
+      mkdirSync(destDir, { recursive: true })
+      console.log(`  ✅ Created directory: ${dirname(ciInfo.destination)}`)
+    }
+
+    // Copy template
+    const templatePath = join(
+      __dirname,
+      '..',
+      '..',
+      'src',
+      'tools',
+      'semantic-release',
+      'templates',
+      ciInfo.template
+    )
+    copyFileSync(templatePath, destPath)
+    console.log(`  ✅ Created: ${ciInfo.destination}`)
+
+    // Show configuration instructions
+    console.log(getCIInstructions(provider))
+
+    console.log('\n  📖 For more details, see:')
+    console.log(
+      '     node_modules/@dimensional-innovations/tool-config/src/tools/semantic-release/CI_SETUP.md'
+    )
+
+    return true
+  } catch (error) {
+    console.error(`  ❌ Failed to copy CI template:`, error.message)
+    return false
+  }
+}

package/bin/lib/handlers/eslint.js

@@ -0,0 +1,61 @@
+/**
+ * ESLint handler for setup-tool-config CLI
+ */
+
+import { existsSync, writeFileSync } from 'fs'
+import { join } from 'path'
+
+/**
+ * Get config filename
+ */
+export function getConfigFilename() {
+  return 'eslint.config.js'
+}
+
+/**
+ * Generate config file content
+ */
+export function generateConfigContent() {
+  return `import { createConfig } from '@dimensional-innovations/tool-config'
+
+export default await createConfig('eslint')
+`
+}
+
+/**
+ * Get npm scripts
+ */
+export function getScripts() {
+  return {
+    lint: 'eslint .',
+    'lint:fix': 'eslint --fix .'
+  }
+}
+
+/**
+ * Write config file
+ */
+export function writeConfig(cwd, _detected, dryRun = false) {
+  const filename = getConfigFilename()
+  const filepath = join(cwd, filename)
+  const content = generateConfigContent()
+
+  if (existsSync(filepath)) {
+    console.log(`  ⚠️  ${filename} already exists - skipping`)
+    return false
+  }
+
+  if (dryRun) {
+    console.log(`  📄 Would create: ${filename}`)
+    return true
+  }
+
+  try {
+    writeFileSync(filepath, content, 'utf8')
+    console.log(`  ✅ Created: ${filename}`)
+    return true
+  } catch (error) {
+    console.error(`  ❌ Failed to create ${filename}:`, error.message)
+    return false
+  }
+}

package/bin/lib/handlers/prettier.js

@@ -0,0 +1,83 @@
+/**
+ * Prettier handler for setup-tool-config CLI
+ */
+
+import { existsSync, writeFileSync } from 'fs'
+import { join } from 'path'
+
+import { prettierIgnoreContent } from '../../../src/tools/prettier/index.js'
+
+/**
+ * Get config filename
+ */
+export function getConfigFilename() {
+  return 'prettier.config.js'
+}
+
+/**
+ * Generate config file content
+ */
+export function generateConfigContent() {
+  return `import { createConfig } from '@dimensional-innovations/tool-config'
+
+export default createConfig('prettier')
+`
+}
+
+/**
+ * Get npm scripts
+ */
+export function getScripts() {
+  return {
+    'prettier:fix': 'prettier --write .',
+    prettier: 'prettier --check .'
+  }
+}
+
+/**
+ * Write config file
+ */
+export function writeConfig(cwd, _detected, dryRun = false) {
+  const filename = getConfigFilename()
+  const filepath = join(cwd, filename)
+  const content = generateConfigContent()
+
+  if (existsSync(filepath)) {
+    console.log(`  ⚠️  ${filename} already exists - skipping`)
+    return false
+  }
+
+  if (dryRun) {
+    console.log(`  📄 Would create: ${filename}`)
+
+    // Prettier also creates .prettierignore
+    const ignoreFile = '.prettierignore'
+    const ignoreExists = existsSync(join(cwd, ignoreFile))
+    if (!ignoreExists) {
+      console.log(`  📄 Would create: ${ignoreFile}`)
+    }
+
+    return true
+  }
+
+  try {
+    writeFileSync(filepath, content, 'utf8')
+    console.log(`  ✅ Created: ${filename}`)
+
+    // Prettier also creates .prettierignore
+    const ignoreFile = '.prettierignore'
+    const ignorePath = join(cwd, ignoreFile)
+
+    if (!existsSync(ignorePath)) {
+      writeFileSync(ignorePath, prettierIgnoreContent, 'utf8')
+      console.log(`  ✅ Created: ${ignoreFile}`)
+    } else {
+      console.log(`  ⚠️  ${ignoreFile} already exists - skipping`)
+    }
+
+    return true
+  } catch (error) {
+    console.error(`  ❌ Failed to create ${filename}:`, error.message)
+    return false
+  }
+}

package/bin/lib/handlers/semantic-release.js

@@ -0,0 +1,60 @@
+/**
+ * semantic-release handler for setup-tool-config CLI
+ */
+
+import { existsSync, writeFileSync } from 'fs'
+import { join } from 'path'
+
+/**
+ * Get config filename
+ */
+export function getConfigFilename() {
+  return 'release.config.js'
+}
+
+/**
+ * Generate config file content
+ */
+export function generateConfigContent() {
+  return `import { createConfig } from '@dimensional-innovations/tool-config'
+
+export default createConfig('semantic-release')
+`
+}
+
+/**
+ * Get npm scripts
+ */
+export function getScripts() {
+  return {
+    release: 'semantic-release'
+  }
+}
+
+/**
+ * Write config file
+ */
+export function writeConfig(cwd, _detected, dryRun = false) {
+  const filename = getConfigFilename()
+  const filepath = join(cwd, filename)
+  const content = generateConfigContent()
+
+  if (existsSync(filepath)) {
+    console.log(`  ⚠️  ${filename} already exists - skipping`)
+    return false
+  }
+
+  if (dryRun) {
+    console.log(`  📄 Would create: ${filename}`)
+    return true
+  }
+
+  try {
+    writeFileSync(filepath, content, 'utf8')
+    console.log(`  ✅ Created: ${filename}`)
+    return true
+  } catch (error) {
+    console.error(`  ❌ Failed to create ${filename}:`, error.message)
+    return false
+  }
+}

package/bin/lib/handlers/stylelint.js

@@ -0,0 +1,85 @@
+/**
+ * Stylelint handler for setup-tool-config CLI
+ */
+
+import { existsSync, writeFileSync } from 'fs'
+import { join } from 'path'
+
+/**
+ * Get config filename
+ */
+export function getConfigFilename() {
+  return 'stylelint.config.js'
+}
+
+/**
+ * Generate config file content
+ */
+export function generateConfigContent() {
+  return `import { createConfig } from '@dimensional-innovations/tool-config'
+
+export default createConfig('stylelint')
+`
+}
+
+/**
+ * Get file extensions for Stylelint based on framework and CSS type
+ */
+function getStylelintExtensions(framework, cssType) {
+  const extensions = ['css']
+
+  // Add preprocessor extensions
+  if (cssType.preprocessor === 'scss') {
+    extensions.push('scss')
+  } else if (cssType.preprocessor === 'less') {
+    extensions.push('less')
+  }
+
+  // Add framework-specific extensions
+  if (framework === 'vue') extensions.push('vue')
+  if (framework === 'svelte') extensions.push('svelte')
+
+  return extensions
+}
+
+/**
+ * Get npm scripts based on detected framework and CSS type
+ */
+export function getScripts(detected) {
+  const extensions = getStylelintExtensions(detected.framework, detected.cssType)
+  const pattern =
+    extensions.length === 1 ? `**/*.${extensions[0]}` : `**/*.{${extensions.join(',')}}`
+
+  return {
+    style: `stylelint "${pattern}"`,
+    'style:fix': `stylelint "${pattern}" --fix`
+  }
+}
+
+/**
+ * Write config file
+ */
+export function writeConfig(cwd, _detected, dryRun = false) {
+  const filename = getConfigFilename()
+  const filepath = join(cwd, filename)
+  const content = generateConfigContent()
+
+  if (existsSync(filepath)) {
+    console.log(`  ⚠️  ${filename} already exists - skipping`)
+    return false
+  }
+
+  if (dryRun) {
+    console.log(`  📄 Would create: ${filename}`)
+    return true
+  }
+
+  try {
+    writeFileSync(filepath, content, 'utf8')
+    console.log(`  ✅ Created: ${filename}`)
+    return true
+  } catch (error) {
+    console.error(`  ❌ Failed to create ${filename}:`, error.message)
+    return false
+  }
+}