@bagelink/lint-config 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Bagel Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,353 @@
+# @bagelink/lint-config
+
+ESLint and Prettier configuration for Vue 3 + TypeScript projects.
+
+## Philosophy
+
+- **Prettier owns formatting** — no line length, quotes, semicolons, or indentation rules in ESLint
+- **ESLint owns correctness** — catch bugs, enforce best practices, no pedantic preferences
+- **Zero conflict** — `eslint-config-prettier` disables all formatting rules; saving never produces lint errors from formatting
+- **Minimal dependencies** — only what's needed for Vue 3 + TypeScript
+- **Near-zero consumer config** — centralized configs, auto-setup script, one-line usage
+
+## Quick Start
+
+```bash
+# Install all dependencies
+bun add -d @bagelink/lint-config @eslint/js eslint prettier eslint-plugin-vue eslint-config-prettier globals @typescript-eslint/eslint-plugin @typescript-eslint/parser vue-eslint-parser typescript simple-git-hooks lint-staged vue-tsc
+
+# Auto-setup (copies config files)
+bunx bagel-lint-setup
+
+# Create eslint.config.js
+echo "export { default } from '@bagelink/lint-config/eslint'" > eslint.config.js
+
+# Setup git hooks
+bun run prepare
+
+# To update from GitHub and reapply configs (one command!)
+bunx bagel-lint-setup --upgrade
+```
+
+See [Full Setup Guide](#full-setup-guide) below for complete instructions.
+
+## Installation
+
+### From npm (once published)
+
+```bash
+# Bun
+bun add -d @bagelink/lint-config @eslint/js eslint prettier eslint-plugin-vue eslint-config-prettier globals @typescript-eslint/eslint-plugin @typescript-eslint/parser vue-eslint-parser typescript
+
+# npm
+npm install -D @bagelink/lint-config @eslint/js eslint prettier eslint-plugin-vue eslint-config-prettier globals @typescript-eslint/eslint-plugin @typescript-eslint/parser vue-eslint-parser typescript
+```
+
+### From GitHub
+
+```bash
+# Bun
+bun add -d github:bageldb/bagel-lint-config @eslint/js eslint prettier eslint-plugin-vue eslint-config-prettier globals @typescript-eslint/eslint-plugin @typescript-eslint/parser vue-eslint-parser typescript
+
+# npm
+npm install -D github:bageldb/bagel-lint-config @eslint/js eslint prettier eslint-plugin-vue eslint-config-prettier globals @typescript-eslint/eslint-plugin @typescript-eslint/parser vue-eslint-parser typescript
+```
+
+## Full Setup Guide
+
+### 1. Install Dependencies
+
+```bash
+bun add -d @bagelink/lint-config @eslint/js eslint prettier eslint-plugin-vue eslint-config-prettier globals @typescript-eslint/eslint-plugin @typescript-eslint/parser vue-eslint-parser typescript simple-git-hooks lint-staged vue-tsc
+```
+
+### 2. Run Auto-Setup
+
+```bash
+bunx bagel-lint-setup
+```
+
+This copies the following to your project:
+- `.prettierignore`
+- `.editorconfig`
+- `tsconfig.json`
+- `tsconfig.app.json`
+- `tsconfig.node.json`
+- `.vscode/settings.json` — Format on save, ESLint integration
+- `.vscode/extensions.json` — Recommended VS Code extensions
+
+### 3. Create ESLint Config
+
+**Option A: Minimal (Recommended)**
+
+Create `eslint.config.js`:
+
+```js
+export { default } from '@bagelink/lint-config/eslint'
+```
+
+**Option B: With Overrides**
+
+```js
+import bagelConfig from '@bagelink/lint-config/eslint'
+
+export default [
+  ...bagelConfig,
+  // Your project-specific overrides
+  {
+    rules: {
+      'no-console': 'off',
+    },
+  },
+]
+```
+
+### 4. Update package.json
+
+Add these configurations:
+
+```json
+{
+  "scripts": {
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepare": "simple-git-hooks"
+  },
+  "prettier": "@bagelink/lint-config/prettier",
+  "simple-git-hooks": {
+    "pre-commit": "bunx --bun lint-staged"
+  },
+  "lint-staged": {
+    "*.{js,mjs,cjs,ts,mts,cts,vue}": ["eslint --fix", "prettier --write"],
+    "*.{json,md,html,css,scss}": ["prettier --write"]
+  }
+}
+```
+
+### 5. Initialize Git Hooks
+
+```bash
+bun run prepare
+```
+
+### 6. Install VS Code Extensions
+
+When you open the project in VS Code, you'll be prompted to install recommended extensions:
+- Prettier
+- ESLint
+- Vue Language Features (Volar)
+
+Click "Install All" when prompted, or install manually:
+
+```bash
+code --install-extension esbenp.prettier-vscode
+code --install-extension dbaeumer.vscode-eslint
+code --install-extension vue.volar
+code --install-extension vue.vscode-typescript-vue-plugin
+```
+
+After installing extensions, **reload VS Code** for format-on-save to activate.
+
+## Advanced Usage
+
+### Custom Prettier Config
+
+If you need to override Prettier settings, create `prettier.config.cjs`:
+
+```js
+const bagelPrettier = require('@bagelink/lint-config/prettier')
+
+module.exports = {
+  ...bagelPrettier,
+  printWidth: 120, // Override
+}
+```
+
+### Custom ESLint Rules
+
+See Option B in [Step 3](#3-create-eslint-config) above.
+
+## CI Integration
+
+### GitHub Actions
+
+```yaml
+name: Lint & Format
+
+on: [push, pull_request]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v1
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Check formatting
+        run: bun run format:check
+
+      - name: Lint
+        run: bun run lint
+```
+
+### Pre-commit Hook
+
+Automatically runs on every commit (configured via `simple-git-hooks`):
+
+- ESLint auto-fix on JS/TS/Vue files
+- Prettier format on all supported files
+- Only stages changed files via `lint-staged`
+
+## What's Included
+
+### ESLint Rules
+
+- ✅ Vue 3 recommended rules (including `<script setup>`)
+- ✅ TypeScript recommended rules
+- ✅ Browser, Node, and ES2021 globals
+- ✅ `prefer-const`, `no-debugger`
+- ✅ Unused variables error (except `_` prefixed)
+- ✅ Consistent type imports (allows splitting type and regular imports)
+- ✅ `console` and `any` are allowed
+- ❌ No formatting rules (handled by Prettier)
+- ❌ No pedantic preferences
+
+### Prettier Settings
+
+- `printWidth: 100`
+- `singleQuote: true`
+- `semi: false`
+- `trailingComma: 'all'`
+- `arrowParens: 'always'`
+- `endOfLine: 'lf'`
+
+### Additional Files
+
+- `.prettierignore` — Ignore build outputs, dependencies, IDE files
+- `.editorconfig` — Consistent editor settings (2 spaces, LF, UTF-8)
+- `tsconfig.json` / `tsconfig.app.json` / `tsconfig.node.json` — TypeScript configuration for Vue 3 + Vite
+- `.vscode/settings.json` — Format on save, ESLint auto-fix
+- `.vscode/extensions.json` — Recommended VS Code extensions
+- Git hooks config — Auto-format and lint on commit
+
+### TypeScript Configuration
+
+The included TypeScript configs are optimized for Vue 3 + Vite projects:
+
+**Key Features:**
+- ✅ `types: []` in app config — prevents @types conflicts with ESLint
+- ✅ `lib: ["ES2022"]` — modern JS features (Object.hasOwn, String.replaceAll)
+- ✅ `exclude: ["**/.*"]` — excludes hidden config files from type checking
+- ✅ Project references — separate configs for app code vs build tooling
+- ✅ Strict mode enabled with unused variable checks
+- ✅ Path aliases (`@/*` → `./src/*`)
+
+## Upgrading
+
+### Update to Latest Version (One Command)
+
+```bash
+# Update from GitHub and reapply all configs
+bunx bagel-lint-setup --upgrade
+
+# Then test
+bun run lint
+bun run format
+```
+
+This single command:
+1. ✅ Pulls latest version from GitHub
+2. ✅ Overwrites all config files with updates
+3. ✅ Auto-detects your package manager (bun/npm/yarn/pnpm)
+
+## Migration Guide
+
+### From Previous Versions
+
+```bash
+# 1. Pull latest and reapply configs
+bunx bagel-lint-setup --upgrade
+
+# 2. Simplify eslint.config.js to one line
+echo "export { default } from '@bagelink/lint-config/eslint'" > eslint.config.js
+
+# 3. Remove old config files (if upgrading from older setup)
+rm -f prettier.config.cjs .eslintrc.* .prettierrc.*
+
+# 4. Update package.json (see Full Setup Guide)
+
+# 5. Test
+bun run lint
+bun run format
+```
+
+### Manual Update (Alternative)
+
+If you prefer to control each step:
+
+```bash
+# 1. Update package manually
+bun update @bagelink/lint-config
+
+# 2. Force reapply configs
+bunx bagel-lint-setup --force
+```
+
+## Troubleshooting
+
+### Git Hooks Not Running
+
+```bash
+# Reinitialize hooks
+bun run prepare
+```
+
+### ESLint Not Finding Config
+
+Ensure `eslint.config.js` is at your project root and uses ES module syntax.
+
+### Format on Save Not Working
+
+1. **Install required VS Code extensions** (see `.vscode/extensions.json`)
+2. **Reload VS Code** after installing
+3. Check `.vscode/settings.json` exists with `"editor.formatOnSave": true`
+4. Verify Prettier is set as default formatter:
+   - Right-click in a file → "Format Document With..." → "Configure Default Formatter"
+   - Select "Prettier - Code formatter"
+
+### Prettier Ignoring Files
+
+Check `.prettierignore` is in your project root. Run `bunx bagel-lint-setup` to regenerate.
+
+### TypeScript Errors
+
+If you get TypeScript errors about conflicting types:
+- Check that `tsconfig.app.json` has `"types": []` (prevents auto-including @types)
+- Ensure `exclude: ["**/.*"]` is present to exclude config files
+- Run `bunx bagel-lint-setup` to regenerate configs from the latest version
+
+## Package Exports
+
+The following can be imported in your project:
+
+- `@bagelink/lint-config/eslint` — ESLint flat config
+- `@bagelink/lint-config/prettier` — Prettier config
+- `@bagelink/lint-config/lint-staged` — lint-staged config
+- `@bagelink/lint-config/git-hooks` — simple-git-hooks config
+- `@bagelink/lint-config/vscode/settings` — VS Code settings
+- `@bagelink/lint-config/vscode/extensions` — VS Code extensions
+- `@bagelink/lint-config/prettierignore` — Prettier ignore patterns
+- `@bagelink/lint-config/editorconfig` — EditorConfig settings
+- `@bagelink/lint-config/tsconfig` — Root TypeScript config
+- `@bagelink/lint-config/tsconfig/app` — App TypeScript config
+- `@bagelink/lint-config/tsconfig/node` — Node/Vite TypeScript config
+
+## License
+
+MIT
+

package/editorconfig/.editorconfig

@@ -0,0 +1,10 @@
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+

package/eslint/index.js

@@ -0,0 +1,5 @@
+import vue3 from './vue3.js'
+
+export { vue3 }
+export default vue3
+

package/eslint/vue3.js

@@ -0,0 +1,143 @@
+import js from '@eslint/js'
+import pluginVue from 'eslint-plugin-vue'
+import tseslint from '@typescript-eslint/eslint-plugin'
+import tsparser from '@typescript-eslint/parser'
+import vueParser from 'vue-eslint-parser'
+import eslintConfigPrettier from 'eslint-config-prettier'
+import globals from 'globals'
+
+export default [
+  // Base recommended rules
+  js.configs.recommended,
+  
+  // Vue 3 recommended rules
+  ...pluginVue.configs['flat/recommended'],
+  
+  // Disable formatting rules
+  eslintConfigPrettier,
+  
+  // File matching and parser configuration
+  {
+    files: ['**/*.{js,mjs,cjs,ts,tsx,vue}'],
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      parser: vueParser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+        parser: tsparser,
+        extraFileExtensions: ['.vue'],
+      },
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        ...globals.es2021,
+      },
+    },
+  },
+  
+  // CommonJS files configuration
+  {
+    files: ['**/*.cjs'],
+    languageOptions: {
+      sourceType: 'commonjs',
+      globals: {
+        ...globals.node,
+        ...globals.commonjs,
+      },
+    },
+  },
+  
+  // TypeScript-specific configuration
+  {
+    files: ['**/*.{ts,tsx,vue}'],
+    plugins: {
+      '@typescript-eslint': tseslint,
+    },
+    languageOptions: {
+      parser: vueParser,
+      parserOptions: {
+        parser: tsparser,
+        project: null, // Disable type-aware linting by default for speed
+        extraFileExtensions: ['.vue'],
+      },
+    },
+    rules: {
+      // TypeScript recommended rules (manually applied)
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+        },
+      ],
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-non-null-assertion': 'warn',
+      '@typescript-eslint/consistent-type-imports': [
+        'error',
+        { 
+          prefer: 'type-imports',
+          disallowTypeAnnotations: false,
+          fixStyle: 'inline-type-imports',
+        },
+      ],
+      '@typescript-eslint/no-duplicate-imports': 'off',
+      
+      // Explicitly disable type-aware rules that require parserOptions.project
+      '@typescript-eslint/use-unknown-in-catch-callback-variable': 'off',
+      '@typescript-eslint/await-thenable': 'off',
+      '@typescript-eslint/no-floating-promises': 'off',
+      '@typescript-eslint/no-misused-promises': 'off',
+      '@typescript-eslint/require-await': 'off',
+      '@typescript-eslint/no-unnecessary-type-assertion': 'off',
+      
+      // Disable base rule as it conflicts with TS version
+      'no-unused-vars': 'off',
+      'no-unused-expressions': 'off',
+    },
+  },
+  
+  // General quality rules
+  {
+    files: ['**/*.{js,mjs,cjs,ts,tsx,vue}'],
+    rules: {
+      // Correctness and quality
+      'prefer-const': 'error',
+      'no-debugger': 'error',
+      'no-console': 'off',
+      'no-var': 'error',
+      'no-undef': 'error',
+      'eqeqeq': ['error', 'always', { null: 'ignore' }],
+      'no-constant-condition': 'error',
+      'no-duplicate-imports': 'off',
+      
+      // Vue 3 + <script setup> specific overrides
+      'vue/multi-word-component-names': 'off',
+      'vue/require-default-prop': 'off',
+      'vue/no-v-html': 'warn',
+      
+      // Disable pedantic template formatting rules
+      'vue/max-attributes-per-line': 'off',
+      'vue/singleline-html-element-content-newline': 'off',
+      'vue/html-self-closing': 'off',
+      'vue/html-indent': 'off',
+    },
+  },
+  
+  // Ignore patterns
+  {
+    ignores: [
+      '**/node_modules/**',
+      '**/dist/**',
+      '**/build/**',
+      '**/.nuxt/**',
+      '**/.output/**',
+      '**/coverage/**',
+      '**/.vscode/**',
+      '**/.idea/**',
+    ],
+  },
+]
+

package/git-hooks/lint-staged.config.js

@@ -0,0 +1,4 @@
+export default {
+	'*.{js,mjs,cjs,ts,mts,cts,vue}': ['eslint --fix', 'prettier --write'],
+	'*.{json,md,html,css,scss}': ['prettier --write'],
+}

package/git-hooks/simple-git-hooks.config.js

@@ -0,0 +1,3 @@
+export default {
+	'pre-commit': 'bunx --bun lint-staged',
+}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@bagelink/lint-config",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "ESLint and Prettier configuration for Vue 3 + TypeScript projects",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bageldb/lint-config.git"
+  },
+  "homepage": "https://github.com/bageldb/lint-config#readme",
+  "bugs": {
+    "url": "https://github.com/bageldb/lint-config/issues"
+  },
+  "exports": {
+    "./eslint": "./eslint/index.js",
+    "./eslint/vue3": "./eslint/vue3.js",
+    "./prettier": "./prettier/index.cjs",
+    "./prettierignore": "./prettier/.prettierignore",
+    "./editorconfig": "./editorconfig/.editorconfig",
+    "./lint-staged": "./git-hooks/lint-staged.config.js",
+    "./git-hooks": "./git-hooks/simple-git-hooks.config.js",
+    "./tsconfig": "./tsconfig/tsconfig.json",
+    "./tsconfig/app": "./tsconfig/tsconfig.app.json",
+    "./tsconfig/node": "./tsconfig/tsconfig.node.json",
+    "./vscode/settings": "./vscode/settings.json",
+    "./vscode/extensions": "./vscode/extensions.json"
+  },
+  "bin": {
+    "bagel-lint-setup": "./scripts/setup.js"
+  },
+  "peerDependencies": {
+    "@eslint/js": "^9.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-vue": "^9.0.0",
+    "globals": "^15.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "^5.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "vue-eslint-parser": "^9.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.17.0",
+    "eslint": "^9.17.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-vue": "^9.31.0",
+    "globals": "^15.13.0",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.2",
+    "@typescript-eslint/eslint-plugin": "^8.18.2",
+    "@typescript-eslint/parser": "^8.18.2",
+    "vue-eslint-parser": "^9.4.3"
+  },
+  "keywords": [
+    "eslint",
+    "prettier",
+    "vue",
+    "vue3",
+    "typescript",
+    "lint-config"
+  ],
+  "files": [
+    "eslint",
+    "prettier",
+    "editorconfig",
+    "git-hooks",
+    "scripts",
+    "tsconfig",
+    "vscode",
+    "README.md"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "lint": "eslint . --max-warnings=0",
+    "format": "prettier . --write",
+    "format:check": "prettier . --check"
+  }
+}

package/prettier/.prettierignore

@@ -0,0 +1,37 @@
+# Dependencies
+node_modules
+bun.lock
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# Build outputs
+dist
+build
+.output
+.vite
+.cache
+
+# IDE
+.vscode
+.idea
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Public assets
+public
+
+# Generated files
+*.min.js
+*.min.css
+
+# Bagel specific
+**/bagelink/packages/**
+
+# Config files (handled by linter)
+.eslintrc*
+.prettierrc*
+

package/prettier/index.cjs

@@ -0,0 +1,14 @@
+module.exports = {
+  printWidth: 100,
+  singleQuote: true,
+  semi: false,
+  trailingComma: 'all',
+  arrowParens: 'always',
+  endOfLine: 'lf',
+  tabWidth: 2,
+  useTabs: false,
+  
+  // Vue-specific settings
+  vueIndentScriptAndStyle: false,
+}
+

package/scripts/setup.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { execSync } from 'child_process'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+// Parse command line arguments
+const args = process.argv.slice(2)
+const forceOverwrite = args.includes('--force') || args.includes('-f')
+const upgrade = args.includes('--upgrade') || args.includes('--update') || args.includes('-u')
+
+// If upgrade flag is set, update the package first
+if (upgrade) {
+  console.log('🔄 Updating @bagelink/lint-config from GitHub...\n')
+  
+  try {
+    // Detect package manager
+    const hasBun = fs.existsSync('bun.lockb')
+    const hasYarn = fs.existsSync('yarn.lock')
+    const hasPnpm = fs.existsSync('pnpm-lock.yaml')
+    
+    let updateCmd
+    if (hasBun) {
+      updateCmd = 'bun update @bagelink/lint-config'
+    } else if (hasYarn) {
+      updateCmd = 'yarn upgrade @bagelink/lint-config'
+    } else if (hasPnpm) {
+      updateCmd = 'pnpm update @bagelink/lint-config'
+    } else {
+      updateCmd = 'npm update @bagelink/lint-config'
+    }
+    
+    console.log(`   Running: ${updateCmd}\n`)
+    execSync(updateCmd, { stdio: 'inherit' })
+    console.log('\n✅ Package updated!\n')
+  } catch (error) {
+    console.error('❌ Failed to update package:', error.message)
+    process.exit(1)
+  }
+}
+
+// Files to copy
+const filesToCopy = [
+  {
+    src: path.join(__dirname, '../prettier/.prettierignore'),
+    dest: path.join(process.cwd(), '.prettierignore'),
+  },
+  {
+    src: path.join(__dirname, '../editorconfig/.editorconfig'),
+    dest: path.join(process.cwd(), '.editorconfig'),
+  },
+  {
+    src: path.join(__dirname, '../tsconfig/tsconfig.json'),
+    dest: path.join(process.cwd(), 'tsconfig.json'),
+  },
+  {
+    src: path.join(__dirname, '../tsconfig/tsconfig.app.json'),
+    dest: path.join(process.cwd(), 'tsconfig.app.json'),
+  },
+  {
+    src: path.join(__dirname, '../tsconfig/tsconfig.node.json'),
+    dest: path.join(process.cwd(), 'tsconfig.node.json'),
+  },
+  {
+    src: path.join(__dirname, '../vscode/settings.json'),
+    dest: path.join(process.cwd(), '.vscode/settings.json'),
+  },
+  {
+    src: path.join(__dirname, '../vscode/extensions.json'),
+    dest: path.join(process.cwd(), '.vscode/extensions.json'),
+  },
+]
+
+console.log('📦 Setting up @bagelink/lint-config...\n')
+
+if (upgrade || forceOverwrite) {
+  console.log('⚠️  Force mode enabled - will overwrite existing files\n')
+}
+
+let copied = 0
+let skipped = 0
+let overwritten = 0
+
+filesToCopy.forEach(({ src, dest }) => {
+  try {
+    // Create parent directory if it doesn't exist
+    const destDir = path.dirname(dest)
+    if (!fs.existsSync(destDir)) {
+      fs.mkdirSync(destDir, { recursive: true })
+    }
+
+    const exists = fs.existsSync(dest)
+
+    if (!exists) {
+      fs.copyFileSync(src, dest)
+      console.log(`✅ Copied ${path.basename(dest)}`)
+      copied++
+    } else if (forceOverwrite || upgrade) {
+      fs.copyFileSync(src, dest)
+      console.log(`🔄 Overwrote ${path.basename(dest)}`)
+      overwritten++
+    } else {
+      console.log(`⏭️  Skipped ${path.basename(dest)} (already exists)`)
+      skipped++
+    }
+  } catch (error) {
+    console.warn(`⚠️  Failed to copy ${path.basename(dest)}:`, error.message)
+  }
+})
+
+console.log('\n✨ Setup complete!')
+console.log(`   ${copied} copied, ${overwritten} overwritten, ${skipped} skipped\n`)
+
+if (skipped > 0 && !forceOverwrite && !upgrade) {
+  console.log('💡 Tip: Use --force to overwrite existing files or --upgrade to update from GitHub')
+  console.log('   bunx bagel-lint-setup --force')
+  console.log('   bunx bagel-lint-setup --upgrade\n')
+}
+

package/tsconfig/tsconfig.app.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "preserve",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "types": []
+  },
+  "include": ["env.d.ts", "src/**/*", "src/**/*.vue"],
+  "exclude": ["**/node_modules", "**/.*"]
+}
+

package/tsconfig/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "files": [],
+  "references": [{ "path": "./tsconfig.app.json" }, { "path": "./tsconfig.node.json" }],
+  "exclude": ["node_modules"]
+}
+

package/tsconfig/tsconfig.node.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["ES2023"],
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "types": ["node"]
+  },
+  "include": ["vite.config.ts"]
+}
+

package/vscode/extensions.json

@@ -0,0 +1,8 @@
+{
+  "recommendations": [
+    "esbenp.prettier-vscode",
+    "dbaeumer.vscode-eslint",
+    "vue.volar",
+    "vue.vscode-typescript-vue-plugin"
+  ]
+}

package/vscode/settings.json

@@ -0,0 +1,35 @@
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+  "eslint.enable": true,
+  "eslint.useFlatConfig": true,
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "typescript",
+    "typescriptreact",
+    "vue"
+  ],
+  "[javascript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[vue]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  }
+}
+