Nuvraxis/nuvraxis-plugins

Biome

Biome est le seul formateur et linter pour JS, TS, JSX, JSON et CSS. SCSS est l'exception : Biome 2.5 ne le parse pas, donc stylelint gère les .scss (voir scss-bem). Pas d'ESLint, pas de Prettier.

Le biome.json racine du modèle est la source de vérité. Un hook du plugin exécute pnpm exec biome check --write <fichier> après chaque fichier édité par Claude, lorsqu'un biome.json existe au-dessus.

Règles

1. Un seul biome.json racine, schéma épinglé à la version installée. "$schema": "https://biomejs.dev/schemas/2.5.15/schema.json", et @biomejs/biome épinglé à la même version dans le catalogue du workspace. Un schéma décalé masque les options inconnues ou renommées dans l'éditeur. Lors d'une mise à niveau, exécutez pnpm exec biome migrate --write et mettez à jour les deux.

2. Laissez git décider ce qui est ignoré : vcs.useIgnoreFile: true. Forcez ensuite l'ignorance des sorties de build avec !! dans files.includes (!!**/.next, !!**/.turbo, !!**/dist, !!**/coverage), ce qui empêche également Biome de scanner ces dossiers. Un seul ! exclut du traitement mais indexe quand même. files.ignoreUnknown: true empêche les fichiers .scss et autres fichiers non supportés d'être signalés.

3. Formateur : 2 espaces, largeur 100, LF, guillemets doubles, points-virgules, virgules finales. Ceux-ci sont fixes pour chaque dépôt, afin que les diffs ne se battent pas pour le style. N'ajoutez pas de surcharges de formateur par paquet.

4. Linter : preset: "recommended", a11y: "error", domaines react et next au niveau recommended. rules.recommended: true est l'ancienne orthographe et est dépréciée : utilisez rules.preset. a11y en error car nuvui gère lui-même l'accessibilité de ses composants, donc ce qui reste (alt, labels, types de boutons dans votre propre balisage) doit être correct. Le domaine next ajoute des règles comme noImgElement ; react ajoute les règles des hooks.

5. Nursery reste désactivée. Les règles Nursery changent entre les versions de patch et peuvent casser la CI lors d'une mise à niveau de Biome. Activez-en une délibérément, par son nom, avec un commentaire expliquant pourquoi, et revérifiez à chaque mise à niveau.

6. noConsole avertit, en autorisant error et warn. Les logs d'erreur structurés (instrumentation.ts) utilisent console.error ; les console.log intempestifs sont détectés.

7. Triez les imports avec l'assistant, pas à la main. assist.actions.source.organizeImports: "on". biome check --write l'applique ; biome ci échoue en cas d'imports non triés.

8. Surcharges par glob, pour les fichiers de test et autres. Le modèle active le domaine test uniquement pour *.test.ts(x) / *.test-d.ts. Mettez-y aussi les autres différences de type de fichier, pas dans des configurations séparées.

9. Configurations imbriquées uniquement pour les paquets qui diffèrent vraiment, et elles héritent de la racine.

   // packages/legacy-widget/biome.json
   { "extends": "//", "linter": { "rules": { "style": { "noNonNullAssertion": "off" } } } }
   

   "extends": "//" signifie "la configuration racine" et implique "root": false. Toute autre configuration imbriquée doit définir "root": false. Nous n'utilisons pas de paquet @repo/biome-config partagé : le fichier racine plus // suffit sans build ni dépendance.

10. Localement biome check --write ; en CI biome ci. pnpm lint exécute biome check . (sans écriture) ; pnpm lint:fix exécute biome check --write .. La CI exécute pnpm exec biome ci --reporter=github ., qui n'écrit jamais, échoue en cas de problèmes de formatage, de lint et d'ordre des imports, et annote la PR. Ajoutez --changed --since=origin/main seulement si l'exécution complète devient lente ; c'est en millisecondes aujourd'hui.

11. Supprimez une ligne, avec une raison.

    // biome-ignore lint/suspicious/noExplicitAny: third-party callback typed as any upstream
    

    Ne désactivez jamais une règle à l'échelle du dépôt pour faire passer un seul fichier. Si une règle est incorrecte pour le dépôt, modifiez biome.json dans son propre commit avec la raison.

12. Corrigez, ne masquez pas, les plus courantes.

    • useImportType : exécutez la correction ; elle est requise par verbatimModuleSyntax.
    • noExplicitAny : utilisez unknown et parsez (voir typescript-production).
    • useButtonType, noSvgWithoutTitle, useAltText : de véritables bugs d'accessibilité.
    • noImgElement : utilisez next/image.
    • useExhaustiveDependencies : corrigez la liste des dépendances ou déplacez la valeur hors du composant.

13. VS Code : Biome est le formateur par défaut, correction à la sauvegarde. Le .vscode/settings.json du modèle définit editor.defaultFormatter: "biomejs.biome", source.fixAll.biome et source.organizeImports.biome à la sauvegarde, et biome.requireConfiguration: true pour que l'extension reste silencieuse dans les dépôts sans Biome. SCSS conserve l'extension stylelint. Recommandez les deux dans .vscode/extensions.json.

14. Migrer depuis ESLint/Prettier : migrez, puis supprimez. Voir references/migration.md. État final : aucun paquet eslint*, prettier* ou @typescript-eslint/*, aucun fichier .eslintrc*, eslint.config.*, .prettierrc*, .prettierignore.

Ce que Biome ne couvre pas

Fichier	Outil
.scss	stylelint (scss-bem)
.yaml (workflows, Helm)	actionlint pour les workflows ; helm lint + kubeconform pour les charts
.md	rien d'imposé
Erreurs de type	tsc --noEmit (pnpm typecheck)

Vérifier

pnpm lint                               # biome check . && stylelint
pnpm exec biome ci --reporter=github .  # ce que la CI exécute
pnpm exec biome rage                    # affiche la configuration résolue si quelque chose semble ignoré

Sources

• https://biomejs.dev/reference/configuration/
• https://biomejs.dev/guides/big-projects/
• https://biomejs.dev/linter/domains/
• https://biomejs.dev/linter/rules/
• https://biomejs.dev/reference/cli/
• https://biomejs.dev/reference/vscode/
• https://biomejs.dev/guides/migrate-eslint-prettier/
• https://biomejs.dev/internals/language-support/