@nedcloarbr/biome-config 2.0.2 → 2.2.0

package/README.md

@@ -13,25 +13,21 @@
 
 **Table of Contents**
 
-- [Description](#description)
 - [Installation](#installation)
-- [Usage](#usage)
-- [To-Do](#to-do)
-
-## Description
-
-Configuring a linter and formatter, such as `BiomeJS`, is crucial for maintaining consistent, readable, and error-free code. Linters ensure uniform coding standards and early error detection, saving debugging time. Formatters automate code structuring, enhancing readability and maintenance. These tools increase productivity by allowing developers to focus on critical tasks. They also enforce quality standards, creating a professional development environment. In CI/CD workflows, they ensure code adherence to quality standards, preserving codebase integrity.
-
-The package includes configuration for:
-- [`NestJS`](https://nestjs.com/)
-- [`React`](https://react.dev/)
-  - [`Vite`](https://vitejs.dev/)
-  - [`NextJS`](https://nextjs.org/)
+- [Configs](#configs)
+  - [base](#base)
+  - [css](#css)
+  - [html](#html)
+  - [nestjs](#nestjs)
+  - [react](#react)
+  - [next](#next)
+  - [vue](#vue)
+  - [angular](#angular)
+  - [react-native](#react-native)
+  - [ignore](#ignore)
 
 ## Installation
 
-You can use the following command to install this package.
-
 ```sh
 npm install --save-dev --save-exact @biomejs/biome @nedcloarbr/biome-config
 yarn add --dev --exact @biomejs/biome @nedcloarbr/biome-config
@@ -40,84 +36,168 @@ bun add --dev --exact @biomejs/biome @nedcloarbr/biome-config
 ```
 
 > [!WARNING]
-> At the moment BiomeJS doesn't support Yarn PnP completely \
-> Discussion for add this support: https://github.com/biomejs/biome/discussions/3393 \
-> If you're using Yarn Classic (v1.x) you don't have to worry about this \
-> To opt out of using PnP in Yarn Modern (^v2.x), do the following
-
-```diff
-# .yarnrc.yml
-+ nodeLinker: node-modules
+> BiomeJS doesn't fully support Yarn PnP yet — [discussion](https://github.com/biomejs/biome/discussions/3393).
+> If you're using Yarn Modern (v2+), opt out of PnP:
+> ```yaml
+> # .yarnrc.yml
+> nodeLinker: node-modules
+> ```
+
+## Configs
+
+All configs extend `base` unless noted otherwise. The diagram below shows the full inheritance chain:
+
+```
+base
+├── nestjs
+├── css         (CSS formatter + linting + Tailwind support)
+├── html        (HTML formatter + 16 a11y rules)
+└── base + html + css
+    ├── react
+    │   ├── next
+    │   └── react-native
+    ├── vue
+    └── angular
+```
+
+---
+
+### `base`
+
+General TypeScript/JavaScript config. Includes formatter, linter rules for correctness, style, complexity and suspicious groups, and import organization.
+
+```jsonc
+// biome.json
+{
+  "extends": ["@nedcloarbr/biome-config/base"]
+}
+```
+
+---
+
+### `css`
+
+CSS formatter and full CSS linting. Includes Tailwind CSS support out of the box — `@tailwind`, `@apply`, `@config`, `theme()` and `screen()` are all recognized.
+
+```jsonc
+// biome.json
+{
+  "extends": ["@nedcloarbr/biome-config/css"]
+}
 ```
 
-## Usage
+---
+
+### `html`
 
-### `NodeJS`
+HTML formatter and all 16 recommended accessibility rules (`useAltText`, `useButtonType`, `useHtmlLang`, `noAutofocus`, etc.).
 
-```diff
-# biome.json
-+ extends: ["@nedcloarbr/biome-config"]
+```jsonc
+// biome.json
+{
+  "extends": ["@nedcloarbr/biome-config/html"]
+}
 ```
 
-or
+---
+
+### `nestjs`
 
-```diff
-# biome.json
-+ extends: ["@nedcloarbr/biome-config/base"]
+Extends `base`. Enables TypeScript parameter decorators (`@Injectable`, `@Controller`, etc.) and enforces explicit return types on services and controllers.
+
+```jsonc
+// biome.json
+{
+  "extends": ["@nedcloarbr/biome-config/nestjs"]
+}
 ```
 
-### [`NestJS`](https://nestjs.com/)
+---
+
+### `react`
 
-This config includes base config
+Extends `base` + `html` + `css`. Adds JSX-specific rules: `useSortedClasses` (Tailwind class sorting), `noReactForwardRef` (React 19), `noDangerouslySetInnerHtml`, a11y rules for JSX, and more.
 
-```diff
-# biome.json
-+  "extends": ["@nedcloarbr/biome-config/nestjs"]
+```jsonc
+// biome.json
+{
+  "extends": ["@nedcloarbr/biome-config/react"]
+}
 ```
 
-### [`React`](https://react.dev/)
-This config includes base config
+---
 
-```diff
-# biome.json
-+  "extends": ["@nedcloarbr/biome-config/react"]
+### `next`
+
+Extends `react`. Disables `noDefaultExport` (required for Next.js pages and layouts) and adds `noNextAsyncClientComponent`.
+
+```jsonc
+// biome.json
+{
+  "extends": ["@nedcloarbr/biome-config/next"]
+}
 ```
 
-If you're in a [`Vite`](https://vitejs.dev/) Project \
-Install this [Vite Plugin](https://github.com/skrulling/vite-plugin-biome) and follow the configuration guide
+---
 
-If you're in a [`NextJS`](https://nextjs.org/) Project \
-You will need to disable eslint checking since NextJS doesn't [support Biome](https://github.com/vercel/next.js/pull/67280) natively yet
+### `vue`
 
-``` diff
-# next.config.js
-+  eslint: {
-+    ignoreDuringBuilds: true,
-+  }
+Extends `base` + `html` + `css`. Adds all Vue-specific correctness rules (`noVueReservedProps`, `noVueDuplicateKeys`, `noVueSetupPropsReactivityLoss`, etc.) and nursery rules for Vue directives.
+
+```jsonc
+// biome.json
+{
+  "extends": ["@nedcloarbr/biome-config/vue"]
+}
 ```
 
-### `Ignore` (an array of commonly ignored folders) 
+---
+
+### `angular`
 
-This config don't includes base config
+Extends `base` + `html` + `css`. Enables TypeScript parameter decorators (`@Component`, `@Injectable`, etc.) and enforces explicit return types.
 
-```diff
-# biome.json
-+  "extends": ["@nedcloarbr/biome-config/ignore"]
+```jsonc
+// biome.json
+{
+  "extends": ["@nedcloarbr/biome-config/angular"]
+}
 ```
 
+---
 
-## To-Do
+### `react-native`
 
-Add support for other types of projects
+Extends `react`. Adds React Native-specific rules: `noReactNativeDeepImports`, `noReactNativeLiteralColors`, `noReactNativeRawText`, and `useReactNativePlatformComponents`.
 
-- Configs
-  - [x] ReactJS
-    - [x] Vanilla
-    - [x] Vite
-    - [x] NextJS
-  - [x] NodeJS
-    - [x] Vanilla
-    - [x] TypeScript
+```jsonc
+// biome.json
+{
+  "extends": ["@nedcloarbr/biome-config/react-native"]
+}
+```
+
+---
+
+### `ignore`
+
+A standalone list of commonly ignored paths (build outputs, caches, editor folders, AI tool directories, generated files, etc.). Does not extend `base`.
 
-- Repository
-  - [ ] Fix cliff for generate changelogs correctly
+```jsonc
+// biome.json
+{
+  "extends": ["@nedcloarbr/biome-config/ignore"]
+}
+```
+
+You can combine it with any other config:
+
+```jsonc
+// biome.json
+{
+  "extends": [
+    "@nedcloarbr/biome-config/react",
+    "@nedcloarbr/biome-config/ignore"
+  ]
+}
+```

package/angular.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.5.13/schema.json",
+  "extends": [
+    "./base.json",
+    "./html.json",
+    "./css.json"
+  ],
+  "javascript": {
+    "parser": {
+      "unsafeParameterDecoratorsEnabled": true
+    }
+  },
+  "linter": {
+    "rules": {
+      "a11y": {},
+      "nursery": {
+        "useExplicitReturnType": "warn"
+      }
+    }
+  }
+}

package/base.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.3.0/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.5.13/schema.json",
   "assist": {
     "actions": {
       "source": {
@@ -47,12 +47,20 @@
         "noExcessiveCognitiveComplexity": "error",
         "noForEach": "error",
         "noUselessCatch": "error",
+        "noUselessCatchBinding": "error",
         "noUselessConstructor": "error",
         "noUselessEmptyExport": "error",
         "noUselessSwitchCase": "error",
+        "noUselessUndefined": "error",
         "noVoid": "off",
         "useArrowFunction": "error",
         "useLiteralKeys": "off",
+        "useMaxParams": {
+          "level": "warn",
+          "options": {
+            "max": 4
+          }
+        },
         "useOptionalChain": "error",
         "useRegexLiterals": "error",
         "useSimplifiedLogicExpression": "error"
@@ -64,53 +72,72 @@
         "noEmptyPattern": "error",
         "noGlobalObjectCalls": "error",
         "noInnerDeclarations": "off",
+        "noInvalidBuiltinInstantiation": "error",
         "noInvalidConstructorSuper": "error",
         "noSwitchDeclarations": "off",
-        "noInvalidBuiltinInstantiation": "error"
+        "noUnresolvedImports": "error"
+      },
+      "nursery": {
+        "noImpliedEval": "error",
+        "noLoopFunc": "error",
+        "noUnnecessaryTemplateExpression": "error",
+        "noUselessTypeConversion": "error",
+        "useRegexpTest": "error",
+        "useStringStartsEndsWith": "error"
       },
       "style": {
         "noDefaultExport": "error",
-        "noUselessElse": "error",
+        "noInferrableTypes": "error",
         "noNonNullAssertion": "off",
+        "noParameterAssign": "error",
+        "noUnusedTemplateLiteral": "error",
+        "noUselessElse": "error",
         "useAsConstAssertion": "warn",
         "useConst": "error",
-        "useNodejsImportProtocol": "error",
-        "useSingleVarDeclarator": "error",
+        "useConsistentArrayType": {
+          "level": "warn",
+          "options": {
+            "syntax": "shorthand"
+          }
+        },
+        "useConsistentArrowReturn": "error",
+        "useDefaultParameterLast": "error",
+        "useEnumInitializers": "error",
         "useExportType": {
-          "options": {},
+          "options": {
+            "style": "auto"
+          },
           "level": "info",
           "fix": "none"
         },
         "useImportType": {
-          "options": {},
+          "options": {
+            "style": "auto"
+          },
           "level": "info",
           "fix": "none"
         },
-        "noParameterAssign": "error",
-        "useDefaultParameterLast": "error",
-        "useEnumInitializers": "error",
-        "useSelfClosingElements": "error",
-        "noUnusedTemplateLiteral": "error",
+        "useNodejsImportProtocol": "error",
         "useNumberNamespace": "error",
-        "noInferrableTypes": "error",
-        "useConsistentArrayType": {
-          "level": "error",
-          "options": {
-            "syntax": "shorthand"
-          }
-        }
+        "useSelfClosingElements": "error",
+        "useSingleVarDeclarator": "error"
       },
       "suspicious": {
         "noApproximativeNumericConstant": "error",
         "noCatchAssign": "error",
         "noConfusingVoidType": "error",
+        "noDeprecatedImports": "warn",
         "noDoubleEquals": "error",
         "noDuplicateCase": "error",
+        "noDuplicateDependencies": "warn",
         "noDuplicateObjectKeys": "error",
         "noDuplicateParameters": "error",
         "noEmptyBlockStatements": "error",
         "noEmptyInterface": "error",
+        "noEmptySource": "error",
         "noExplicitAny": "error",
+        "noImportCycles": "warn",
+        "noUnusedExpressions": "error",
         "noVar": "error"
       }
     }

package/css.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.5.13/schema.json",
+  "css": {
+    "formatter": {
+      "enabled": true,
+      "indentStyle": "tab",
+      "indentWidth": 2,
+      "lineEnding": "lf",
+      "lineWidth": 120,
+      "quoteStyle": "double"
+    },
+    "linter": {
+      "enabled": true
+    },
+    "parser": {
+      "tailwindDirectives": true,
+      "cssModules": true
+    }
+  },
+  "linter": {
+    "rules": {
+      "a11y": {
+        "useGenericFontNames": "error"
+      },
+      "complexity": {
+        "noImportantStyles": "error"
+      },
+      "correctness": {
+        "noInvalidDirectionInLinearGradient": "error",
+        "noInvalidGridAreas": "error",
+        "noInvalidPositionAtImportRule": "error",
+        "noMissingVarFunction": "error",
+        "noUnknownFunction": {
+          "level": "error",
+          "options": {
+            "ignore": [
+              "theme",
+              "screen"
+            ]
+          }
+        },
+        "noUnknownMediaFeatureName": "error",
+        "noUnknownProperty": "error",
+        "noUnknownPseudoClass": "error",
+        "noUnknownPseudoElement": "error",
+        "noUnknownTypeSelector": "error",
+        "noUnknownUnit": "error",
+        "noUnmatchableAnbSelector": "error"
+      },
+      "nursery": {
+        "noDeprecatedMediaType": "warn",
+        "noDuplicateSelectors": "error",
+        "noExcessiveSelectorClasses": "warn"
+      },
+      "style": {
+        "noDescendingSpecificity": "warn"
+      },
+      "suspicious": {
+        "noDuplicateAtImportRules": "error",
+        "noDuplicateCustomProperties": "error",
+        "noDuplicateFontNames": "error",
+        "noDuplicateProperties": "error",
+        "noDuplicateSelectorsKeyframeBlock": "error",
+        "noEmptyBlock": "error",
+        "noImportantInKeyframe": "error",
+        "noIrregularWhitespace": "error",
+        "noShorthandPropertyOverrides": "error",
+        "noUnknownAtRules": {
+          "level": "error",
+          "options": {
+            "ignore": [
+              "tailwind",
+              "apply",
+              "config"
+            ]
+          }
+        },
+        "noUselessEscapeInString": "error"
+      }
+    }
+  }
+}

package/html.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.5.13/schema.json",
+  "html": {
+    "formatter": {
+      "enabled": true,
+      "attributePosition": "auto",
+      "bracketSameLine": true,
+      "indentStyle": "tab",
+      "indentWidth": 2,
+      "lineEnding": "lf",
+      "lineWidth": 120,
+      "whitespaceSensitivity": "css"
+    }
+  },
+  "linter": {
+    "rules": {
+      "a11y": {
+        "noAccessKey": "error",
+        "noAutofocus": "error",
+        "noDistractingElements": "error",
+        "noHeaderScope": "error",
+        "noPositiveTabindex": "error",
+        "noRedundantAlt": "error",
+        "noSvgWithoutTitle": "error",
+        "useAltText": "error",
+        "useAnchorContent": "error",
+        "useAriaPropsForRole": "error",
+        "useButtonType": "error",
+        "useHtmlLang": "error",
+        "useIframeTitle": "error",
+        "useMediaCaption": "error",
+        "useValidAriaRole": "error",
+        "useValidLang": "error"
+      },
+      "nursery": {
+        "useIframeSandbox": "error"
+      }
+    }
+  }
+}

package/ignore.json

@@ -1,19 +1,60 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.3.0/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.5.13/schema.json",
   "files": {
     "includes": [
       "**",
-      "!**/dist/**/*",
-      "!**/out/**/*",
-      "!**/build/**/*",
-      "!**/coverage/**/*",
-      "!**/.vscode/**/*",
-      "!**/.idea/**/*",
-      "!**/.atom/**/*",
-      "!**/.yarn/**/*",
-      "!**/.next/**/*",
+      "!**/node_modules",
+      "!**/dist",
+      "!**/out",
+      "!**/build",
+      "!**/bin",
+      "!**/tmp",
+      "!**/temp",
+      "!**/coverage",
+      "!**/.nyc_output",
+      "!**/.next",
+      "!**/.nuxt",
+      "!**/.output",
+      "!**/.svelte-kit",
+      "!**/.astro",
+      "!**/.remix",
+      "!**/.solid",
+      "!**/.vinxi",
+      "!**/storybook-static",
+      "!**/.turbo",
+      "!**/.cache",
+      "!**/.angular",
+      "!**/.nx",
+      "!**/.parcel-cache",
+      "!**/.rollup.cache",
+      "!**/.wrangler",
+      "!**/.serverless",
+      "!**/.expo",
+      "!**/.vscode",
+      "!**/.idea",
+      "!**/.vs",
+      "!**/.fleet",
+      "!**/.atom",
+      "!**/.cursor",
+      "!**/.windsurf",
+      "!**/.claude",
+      "!**/.codeium",
+      "!**/.tabnine",
+      "!**/.continue",
+      "!**/.aider",
+      "!**/.supermaven",
+      "!**/.cody",
+      "!**/.yarn",
       "!**/*.pnp.*",
-      "!**/.nx/**/*"
+      "!**/generated",
+      "!**/__generated__",
+      "!**/*.generated.ts",
+      "!**/*.generated.js",
+      "!**/*.generated.d.ts",
+      "!**/*.min.js",
+      "!**/*.min.css",
+      "!**/.eslintcache",
+      "!**/.stylelintcache"
     ],
     "ignoreUnknown": true
   }

package/nestjs.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.3.0/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.5.13/schema.json",
   "extends": [
     "./base.json"
   ],
@@ -7,5 +7,12 @@
     "parser": {
       "unsafeParameterDecoratorsEnabled": true
     }
+  },
+  "linter": {
+    "rules": {
+      "nursery": {
+        "useExplicitReturnType": "warn"
+      }
+    }
   }
 }

package/next.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.5.13/schema.json",
+  "extends": [
+    "./react.json"
+  ],
+  "linter": {
+    "rules": {
+      "correctness": {
+        "noNextAsyncClientComponent": "error"
+      },
+      "style": {
+        "noDefaultExport": "off"
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nedcloarbr/biome-config",
-  "version": "2.0.2",
+  "version": "2.2.0",
   "description": "BiomeJS Configuration used by NedcloarBR in their projects",
   "license": "MIT",
   "type": "module",
@@ -22,23 +22,48 @@
   },
   "homepage": "https://github.com/NedcloarBR/biome-config#readme",
   "keywords": [
-    "BiomeJS",
-    "NestJS",
+    "biome",
+    "biomejs",
     "linter",
-    "formatter"
+    "formatter",
+    "config",
+    "typescript",
+    "react",
+    "nextjs",
+    "vue",
+    "angular",
+    "react-native",
+    "nestjs",
+    "css",
+    "html",
+    "a11y",
+    "tailwind"
   ],
   "exports": {
     ".": "./base.json",
     "./biome": "./base.json",
     "./base": "./base.json",
+    "./css": "./css.json",
+    "./html": "./html.json",
     "./nestjs": "./nestjs.json",
     "./react": "./react.json",
+    "./next": "./next.json",
+    "./vue": "./vue.json",
+    "./angular": "./angular.json",
+    "./react-native": "./react-native.json",
     "./ignore": "./ignore.json"
   },
   "files": [
+    "README.md",
     "base.json",
+    "css.json",
+    "html.json",
     "nestjs.json",
     "react.json",
+    "next.json",
+    "vue.json",
+    "angular.json",
+    "react-native.json",
     "ignore.json"
   ],
   "packageManager": "yarn@4.9.2",
@@ -47,6 +72,6 @@
     "changelog": "git cliff --prepend ./CHANGELOG.md -l --current -c ./cliff.toml -r ."
   },
   "devDependencies": {
-    "release-it": "^19.0.3"
+    "release-it": "^19.2.4"
   }
 }

package/react-native.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.5.13/schema.json",
+  "extends": [
+    "./react.json"
+  ],
+  "linter": {
+    "rules": {
+      "nursery": {
+        "noReactNativeDeepImports": "error",
+        "noReactNativeLiteralColors": "warn",
+        "noReactNativeRawText": "error",
+        "useReactNativePlatformComponents": "error"
+      }
+    }
+  }
+}

package/react.json

@@ -1,31 +1,23 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.3.0/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.5.13/schema.json",
   "extends": [
-    "./base.json"
+    "./base.json",
+    "./html.json",
+    "./css.json"
   ],
   "javascript": {
     "jsxRuntime": "transparent"
   },
-  "css": {
-    "formatter": {
-      "enabled": true,
-      "indentWidth": 2,
-      "indentStyle": "tab",
-      "lineEnding": "lf",
-      "lineWidth": 120,
-      "quoteStyle": "double"
-    }
-  },
   "linter": {
     "rules": {
       "a11y": {},
       "nursery": {
+        "noComponentHookFactories": "error",
+        "noJsxLeakedDollar": "warn",
+        "noJsxNamespace": "error",
+        "noReactStringRefs": "error",
         "useSortedClasses": "error"
       },
-      "correctness": {
-        "noUnknownFunction": "error",
-        "noUnknownUnit": "error"
-      },
       "security": {
         "noDangerouslySetInnerHtml": "error",
         "noDangerouslySetInnerHtmlWithChildren": "error"
@@ -34,6 +26,7 @@
         "noImplicitBoolean": "error"
       },
       "suspicious": {
+        "noReactForwardRef": "warn",
         "noSuspiciousSemicolonInJsx": "error"
       }
     }

package/vue.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.5.13/schema.json",
+  "extends": [
+    "./base.json",
+    "./html.json",
+    "./css.json"
+  ],
+  "linter": {
+    "rules": {
+      "a11y": {},
+      "correctness": {
+        "noVueDataObjectDeclaration": "error",
+        "noVueDuplicateKeys": "error",
+        "noVueReservedKeys": "error",
+        "noVueReservedProps": "error",
+        "noVueSetupPropsReactivityLoss": "error"
+      },
+      "nursery": {
+        "noVueImportCompilerMacros": "error",
+        "noVueVOnNumberValues": "warn",
+        "useVueNextTickPromise": "error",
+        "useVueValidVFor": "error"
+      },
+      "style": {
+        "noDefaultExport": "off"
+      }
+    }
+  }
+}