@lifeofqui/lint-config 1.1.0 → 1.2.1

package/README.md

@@ -52,11 +52,12 @@ export default defineLintConfig()
 
 Optionen von `defineLintConfig`:
 
-| Option             | Default              | Zweck                                                                 |
-| ------------------ | -------------------- | --------------------------------------------------------------------- |
-| `ignores`          | `[]`                 | Zusätzliche Ignore-Globs (Nuxt-Build-Ordner sind schon drin)          |
-| `oxlintConfigFile` | `'./.oxlintrc.json'` | Oxlint-Config des Projekts, deren Regeln ESLint abschaltet            |
-| `configs`          | `[]`                 | Projektspezifische Flat-Configs, werden nach den geteilten angewendet |
+| Option             | Default              | Zweck                                                                                                                                                    |
+| ------------------ | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ignores`          | `[]`                 | Zusätzliche Ignore-Globs (Nuxt-Build-Ordner sind schon drin)                                                                                             |
+| `oxlintConfigFile` | `'./.oxlintrc.json'` | Oxlint-Config des Projekts, deren Regeln ESLint abschaltet                                                                                               |
+| `gitignore`        | `'.gitignore'`       | Ignore-Datei (relativ zum Arbeitsverzeichnis), deren Muster ESLint überspringt, wie Oxlint und Oxfmt. Fehlt sie, passiert nichts; `false` schaltet es ab |
+| `configs`          | `[]`                 | Projektspezifische Flat-Configs, werden nach den geteilten angewendet                                                                                    |
 
 **Scripts** (Standard, `npm-run-all` im Projekt)
 
@@ -76,18 +77,29 @@ Optionen von `defineLintConfig`:
 ## Projektspezifische Anpassungen
 
 - **Oxlint**: eigene `rules` / `overrides` in `.oxlintrc.json` nach dem `extends`. Spätere Einträge gewinnen.
-- **Oxfmt**: `export default { ...base, printWidth: 120 }`
+- **Oxfmt**: `export default { ...base, printWidth: 120 }`, zusätzliche Ignores mit `ignorePatterns: [...base.ignorePatterns, 'datei.json']`
 - **ESLint**: `defineLintConfig({ configs: [{ files: ['…'], rules: { … } }] })`
 
 ## Updates verteilen
 
-1. Regel oder Tool-Version hier ändern (Tool-Versionen immer exakt pinnen).
-2. Lokal testen: `npm pack`, im Projekt `npm i -D ../lint-config/lifeofqui-lint-config-<version>.tgz`, dann `npm run lint:check`.
-3. `npm version patch|minor|major` und danach `npm publish`.
-4. In den Projekten öffnet Dependabot einen PR (`.github/dependabot.yml`), die CI prüft ihn mit `npm run lint:check`.
+Tool-Updates kommen per Dependabot (`.github/dependabot.yml`): wöchentlich ein gesammelter PR für alle Minor- und Patch-Updates, Majors als eigene PRs. Regeländerungen werden direkt hier gemacht. Tool-Versionen immer exakt pinnen.
+
+1. Die CI prüft jeden PR mit `npm test` (`test/smoke.sh`). Das Skript packt das Paket, installiert es in eine Kopie von `test/fixture` und prüft, dass `eslint`, `oxlint` und `oxfmt` in `node_modules/.bin` liegen. Dann laufen alle drei Tools über das Fixture, und Oxlint und ESLint müssen je einen bekannten Verstoß melden.
+2. Bei größeren Änderungen zusätzlich in einem echten Projekt testen: `npm pack`, dort `npm i -D ../lint-config/lifeofqui-lint-config-<version>.tgz`, dann `npm run lint:check` und `npm run build`.
+3. Nach dem Merge lokal auf `main`: `npm version patch|minor|major` und `git push --follow-tags`. Der Tag startet `.github/workflows/publish.yml`. Der Workflow lässt `npm test` laufen und legt die Version dann per npm Trusted Publishing als Staged Publish ab.
+4. Freigeben: auf npmjs.com im Tab „Staged Packages“ auf Approve klicken, oder `npm stage approve <stage-id>` (beides mit 2FA). Erst dann ist die Version live.
+5. In den Projekten öffnet Dependabot einen PR, die CI prüft ihn mit `npm run lint:check`.
+
+Einmalig auf npmjs.com einrichten: Paket → Settings → Trusted Publisher → GitHub Actions mit Owner `LifeOfQui`, Repository `lint-config` und Workflow `publish.yml`. „Allow npm publish“ bleibt aus, damit jede Version die Freigabe mit 2FA braucht.
 
 Semver: neue oder verschärfte Regeln und Tool-Updates mit Formatierungsänderungen → `minor`, Lockerungen und Fixes → `patch`, geänderte Datei-Struktur oder Optionen → `major`.
 
+## Stolperfalle: Inline-Handler mit mehreren Anweisungen
+
+Oxfmt entfernt mit `semi: false` das `;` aus Vue-Handlern wie `@click="a = 1; b = 2"` und schreibt die Anweisungen untereinander. Der Vue-Compiler erkennt mehrere Anweisungen aber nur am `;` und bricht dann den **Build** ab („Error parsing JavaScript expression“). Lint und Typecheck merken davon nichts.
+
+Deshalb keine Inline-Handler mit mehreren Anweisungen schreiben, sondern eine Funktion aufrufen (`@click="resetFilters"`). Nach einer Umstellung auf dieses Paket immer auch `npm run build` laufen lassen.
+
 ## Hinweis zu eslint-plugin-oxlint
 
 `eslint-plugin-oxlint` übernimmt bei `extends` keine `categories`. `defineLintConfig` liest deshalb zusätzlich die Basis-Datei direkt ein, damit ESLint alle Regeln abschaltet, die Oxlint über Kategorien abdeckt.

package/eslint.d.ts

@@ -5,6 +5,11 @@ export interface LintConfigOptions {
   ignores?: string[]
   /** Oxlint config whose rules ESLint turns off. Defaults to `./.oxlintrc.json`. */
   oxlintConfigFile?: string
+  /**
+   * Ignore file whose patterns ESLint skips, relative to the working directory. Defaults to
+   * `.gitignore`; skipped silently if missing. `false` turns it off.
+   */
+  gitignore?: string | false
   /** Project-specific flat configs, applied after the shared ones. */
   configs?: Linter.Config[]
 }

package/eslint.js

@@ -1,7 +1,10 @@
 import { defineConfigWithVueTs, vueTsConfigs } from '@vue/eslint-config-typescript'
+import { includeIgnoreFile } from 'eslint/config'
 import skipFormatting from 'eslint-config-prettier'
 import pluginOxlint from 'eslint-plugin-oxlint'
 import pluginVue from 'eslint-plugin-vue'
+import { existsSync } from 'node:fs'
+import { resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 const baseOxlintConfigFile = fileURLToPath(new URL('./oxlintrc.json', import.meta.url))
@@ -15,14 +18,29 @@ const defaultIgnores = ['**/.output', '**/.data', '**/.nuxt', '**/.nitro', '**/.
  * @param {object} [options]
  * @param {string[]} [options.ignores] Extra ignore globs, added to the Nuxt build output dirs.
  * @param {string} [options.oxlintConfigFile] Oxlint config whose rules ESLint turns off.
+ * @param {string | false} [options.gitignore] Ignore file whose patterns ESLint skips, relative to the
+ *   working directory. Skipped silently if missing; `false` turns it off.
  * @param {object[]} [options.configs] Project-specific flat configs, applied after the shared ones.
  */
 export function defineLintConfig({
   ignores = [],
   oxlintConfigFile = './.oxlintrc.json',
+  gitignore = '.gitignore',
   configs = [],
 } = {}) {
+  const gitignoreFile = gitignore === false ? null : resolve(gitignore)
+
   return [
+    // Lint the same files as Oxlint and Oxfmt, which both respect .gitignore
+    ...(gitignoreFile && existsSync(gitignoreFile)
+      ? [
+          includeIgnoreFile(gitignoreFile, {
+            gitignoreResolution: true,
+            name: 'lifeofqui/gitignore',
+          }),
+        ]
+      : []),
+
     ...defineConfigWithVueTs(
       { ignores: [...defaultIgnores, ...ignores] },
 

package/oxfmt.d.ts

@@ -1,4 +1,4 @@
 import type { OxfmtConfig } from 'oxfmt'
 
-declare const config: OxfmtConfig
+declare const config: OxfmtConfig & { ignorePatterns: string[] }
 export default config

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifeofqui/lint-config",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "Shared ESLint, Oxlint and Oxfmt setup for Vue/Nuxt projects",
   "license": "MIT",
   "author": "Quirin Koch",
@@ -31,9 +31,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "test": "test/smoke.sh"
+  },
   "dependencies": {
     "@vue/eslint-config-typescript": "14.9.0",
-    "eslint": "10.13.0",
+    "eslint": "10.14.0",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-oxlint": "1.90.0",
     "eslint-plugin-vue": "10.12.0",