@cleeviox/biome 0.0.0-next-20260120205819

package/README.md

@@ -0,0 +1,124 @@
+<div align="center">
+
+<a href="https://github.com/cleevio/cleeviox-toolkit">
+<img alt="CleevioX Logo" src="../../public/logo.svg" width="308"  style="background-color: #151a1d; padding: 15px" />
+
+# BIOME
+
+### Biome configurations for cleeviox projects
+
+</a>
+</div>
+
+## 👷 Installation
+
+```bash
+bun add --dev @cleeviox/biome @biomejs/biome
+```
+
+## Usage
+
+Extend the appropriate configuration in your `biome.json` file by referencing the package through `node_modules`:
+
+### Base
+
+Suitable for general TypeScript projects.
+
+```json
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "extends": ["./node_modules/@cleeviox/biome/base.json"]
+}
+```
+
+### React
+
+For React (JSX) projects.
+
+```json
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "extends": ["./node_modules/@cleeviox/biome/react.json"]
+}
+```
+
+### Next.js
+
+For Next.js projects (extends React configuration).
+
+```json
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "extends": ["./node_modules/@cleeviox/biome/nextjs.json"]
+}
+```
+
+### NestJS
+
+For NestJS projects.
+
+```json
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "extends": ["./node_modules/@cleeviox/biome/nestjs.json"]
+}
+```
+
+## Running Biome
+
+After setting up your configuration, you can run Biome commands:
+
+```bash
+# Check code
+bun biome check .
+
+# Format code
+bun biome format --write .
+
+# Lint code
+bun biome lint .
+
+# Fix issues
+bun biome check --write .
+```
+
+## Setup With IDE
+
+First install the official VSCode extension.
+
+Add the following settings to your `settings.json` file:
+
+```json
+{
+  "editor.codeActionsOnSave": {
+    "source.action.useSortedKeys.biome": "explicit",
+    "source.fixAll.biome": "explicit"
+  },
+  "editor.defaultFormatter": "biomejs.biome",
+  "[github-actions-workflow]": {
+    "editor.defaultFormatter": "redhat.vscode-yaml"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  }
+}
+```
+
+See the link below for a more detailed explanation.
+
+[Further Reading](https://biomejs.dev/guides/editors/first-party-extensions/)
+
+## Notes
+
+- Biome combines formatting and linting in a single tool
+- These configurations aim to match the existing ESLint and Prettier rules used in Cleevio projects
+- Some ESLint rules may not have direct Biome equivalents - the configurations include the closest matches available

package/base.jsonc

@@ -0,0 +1,343 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.11/schema.json",
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on",
+        // "recommended": true,
+        "useSortedAttributes": "on",
+        "useSortedKeys": "on",
+        "useSortedProperties": "on"
+      }
+    }
+  },
+  // "files": {
+  //   "includes": ["!**/dist/**", "*.ts", "*.js"]
+  // },
+  "formatter": {
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "useEditorconfig": false
+  },
+  "javascript": {
+    "formatter": {
+      "arrowParentheses": "always",
+      "bracketSpacing": true,
+      "indentStyle": "space",
+      "indentWidth": 2,
+      "lineWidth": 120,
+      "quoteStyle": "single",
+      "semicolons": "always",
+      "trailingCommas": "all"
+    }
+  },
+  "json": {
+    "formatter": {
+      "indentStyle": "space",
+      "indentWidth": 2
+    }
+  },
+  "linter": {
+    "rules": {
+      "complexity": {
+        "noAdjacentSpacesInRegex": "error",
+        "noArguments": "error",
+        "noBannedTypes": "error",
+        "noCommaOperator": "error",
+        "noEmptyTypeParameters": "error",
+        "noExcessiveCognitiveComplexity": {
+          "level": "warn",
+          "options": {
+            "maxAllowedComplexity": 15
+          }
+        },
+        "noExcessiveLinesPerFunction": {
+          "level": "warn",
+          "options": {
+            "maxLines": 100,
+            "skipBlankLines": true
+          }
+        },
+        "noExcessiveNestedTestSuites": "warn",
+        "noExtraBooleanCast": "error",
+        "noFlatMapIdentity": "error",
+        "noForEach": "error",
+        "noImplicitCoercions": "error",
+        "noUselessCatch": "error",
+        "noUselessConstructor": "error",
+        "noUselessContinue": "error",
+        "noUselessEmptyExport": "error",
+        "noUselessEscapeInRegex": "error",
+        "noUselessLabel": "error",
+        "noUselessLoneBlockStatements": "error",
+        "noUselessRename": "error",
+        "noUselessStringConcat": "error",
+        "noUselessStringRaw": "error",
+        "noUselessSwitchCase": "error",
+        "noUselessTernary": "error",
+        "noUselessThisAlias": "error",
+        "noUselessTypeConstraint": "error",
+        "noUselessUndefinedInitialization": "error",
+        "noVoid": "warn",
+        // Arrow functions yes, but not for /app/**/*.tsx
+        "useArrowFunction": "warn",
+        "useDateNow": "error",
+        "useFlatMap": "on",
+        "useIndexOf": "on",
+        "useLiteralKeys": "error",
+        "useNumericLiterals": "error",
+        "useOptionalChain": "error",
+        "useRegexLiterals": "warn",
+        "useSimpleNumberKeys": "error",
+        "useSimplifiedLogicExpression": "error",
+        "useWhile": "error"
+      },
+      "correctness": {
+        "noConstAssign": "error",
+        "noConstantCondition": "error",
+        "noConstantMathMinMaxClamp": "error",
+        "noConstructorReturn": "error",
+        "noEmptyCharacterClassInRegex": "warn",
+        "noEmptyPattern": "error",
+        "noGlobalDirnameFilename": "warn",
+        "noGlobalObjectCalls": "warn",
+        "noInnerDeclarations": "error",
+        "noInvalidBuiltinInstantiation": "error",
+        "noInvalidConstructorSuper": "error",
+        "noInvalidUseBeforeDeclaration": "error",
+        "noNodejsModules": "warn",
+        "noNonoctalDecimalEscape": "warn",
+        "noPrecisionLoss": "error",
+        "noPrivateImports": "warn",
+        "noProcessGlobal": "error",
+        "noSelfAssign": "error",
+        "noSetterReturn": "error",
+        "noSolidDestructuredProps": "error",
+        "noStringCaseMismatch": "error",
+        "noSwitchDeclarations": "error",
+        "noUndeclaredDependencies": "error",
+        "noUndeclaredVariables": "error",
+        "noUnknownFunction": "error",
+        "noUnreachable": "error",
+        "noUnreachableSuper": "error",
+        "noUnsafeFinally": "error",
+        "noUnsafeOptionalChaining": "error",
+        "noUnusedImports": "error",
+        "noUnusedPrivateClassMembers": "error",
+        "noUnusedVariables": "error",
+        "noVoidTypeReturn": "warn",
+        "useImportExtensions": {
+          "fix": "safe",
+          "level": "error",
+          "options": {
+            "forceJsExtensions": true
+          }
+        },
+        "useIsNan": "error",
+        "useJsonImportAttributes": "warn",
+        "useParseIntRadix": "warn",
+        "useSingleJsDocAsterisk": "warn",
+        "useValidForDirection": "warn",
+        "useValidTypeof": "error",
+        "useYield": "error"
+      },
+      // Nursery Rules have performance issues according to official biomejs docs.
+      // https://biomejs.dev/linter/#nursery
+      // "nursery": "off",
+      "performance": {
+        "noAccumulatingSpread": "error",
+        "noAwaitInLoops": "error",
+        "noBarrelFile": "warn",
+        "noDelete": "error",
+        "noDynamicNamespaceImportAccess": "warn",
+        "noNamespaceImport": "error",
+        "noReExportAll": "warn",
+        "noUnwantedPolyfillio": "warn",
+        "useTopLevelRegex": "error"
+      },
+      "security": {
+        "noGlobalEval": "error",
+        "noSecrets": "error"
+      },
+      "style": {
+        "noCommonJs": "error",
+        "noDefaultExport": "error",
+        "noDescendingSpecificity": "error",
+        "noDoneCallback": "error",
+        "noEnum": "error",
+        "noExportedImports": "warn",
+        "noInferrableTypes": "warn",
+        "noMagicNumbers": "error",
+        "noNamespace": "warn",
+        "noNegationElse": "error",
+        "noNestedTernary": "error",
+        "noNonNullAssertion": "error",
+        "noParameterAssign": "error",
+        "noParameterProperties": "error",
+        "noProcessEnv": "error",
+        "noRestrictedGlobals": {
+          "level": "warn",
+          "options": {
+            "deniedGlobals": {
+              "$": "An example - Obviously jQuery is disgusting."
+            }
+          }
+        },
+        // "noRestrictedImports": {
+        // "level": "error",
+        // Something like react-18n-next
+        // }
+        "noShoutyConstants": "error",
+        "noSubstr": "warn",
+        "noUnusedTemplateLiteral": "error",
+        "noUselessElse": "error",
+        "noYodaExpression": "error",
+        "useArrayLiterals": "error",
+        "useAsConstAssertion": "error",
+        "useAtIndex": "error",
+        "useBlockStatements": "error",
+        "useCollapsedElseIf": "error",
+        "useCollapsedIf": "error",
+        "useComponentExportOnlyModules": "error",
+        "useConsistentArrayType": "error",
+        "useConsistentBuiltinInstantiation": "error",
+        "useConsistentMemberAccessibility": {
+          "level": "error",
+          "options": {
+            "accessibility": "noPublic"
+          }
+        },
+        "useConsistentObjectDefinitions": "error",
+        "useConsistentTypeDefinitions": {
+          "fix": "safe",
+          "level": "error",
+          "options": {
+            "style": "interface"
+          }
+        },
+        "useConst": "error",
+        "useDefaultParameterLast": "error",
+        "useDefaultSwitchClause": "error",
+        "useDeprecatedReason": "error",
+        // "useEnumInitializers": "error", -> not using enums
+        "useExplicitLengthCheck": "error",
+        "useExponentiationOperator": "error",
+        "useExportsLast": "error",
+        "useExportType": "error",
+        "useFilenamingConvention": {
+          "level": "error",
+          "options": {
+            "filenameCases": ["kebab-case"],
+            "strictCase": true
+          }
+        },
+        "useForOf": "error",
+        "useImportType": "error",
+        // "useLiteralEnumMembers": "error", -> not using enums
+        "useNamingConvention": "error",
+        "useNodeAssertStrict": "error",
+        // This can be tuned a little more
+        // "useNamingConvention": {
+        //   "level": "error",
+        //   }
+        // },
+        "useNumberNamespace": "error",
+        "useNumericSeparators": "error",
+        "useObjectSpread": "error",
+        "useShorthandAssign": "error",
+        "useShorthandFunctionType": "error",
+        "useSingleVarDeclarator": "error",
+        "useSymbolDescription": "error",
+        "useTemplate": "error",
+        "useThrowNewError": "error",
+        "useThrowOnlyError": "error",
+        "useTrimStartEnd": "error",
+        "useUnifiedTypeSignatures": "error"
+      },
+      "suspicious": {
+        "noApproximativeNumericConstant": "error",
+        "noAssignInExpressions": "error",
+        "noAsyncPromiseExecutor": "error",
+        "noBiomeFirstException": "warn",
+        "noBitwiseOperators": "warn",
+        "noCatchAssign": "error",
+        "noClassAssign": "error",
+        "noCommentText": "error",
+        "noCompareNegZero": "error",
+        "noConfusingLabels": "error",
+        "noConfusingVoidType": "error",
+        "noConsole": "error",
+        "noConstantBinaryExpressions": "error",
+        "noConstEnum": "error",
+        "noControlCharactersInRegex": "warn",
+        "noDebugger": "error",
+        "noDoubleEquals": "error",
+        "noDuplicateCase": "error",
+        "noDuplicateClassMembers": "error",
+        "noDuplicateCustomProperties": "error",
+        "noDuplicateElseIf": "error",
+        "noDuplicateObjectKeys": "error",
+        "noDuplicateParameters": "error",
+        "noDuplicateProperties": "error",
+        "noEmptyBlockStatements": "error",
+        "noEmptyInterface": "error",
+        "noEvolvingTypes": "error",
+        "noExplicitAny": "error",
+        "noExportsInTest": "error",
+        "noExtraNonNullAssertion": "error",
+        "noFallthroughSwitchClause": "error",
+        "noFocusedTests": "error",
+        "noFunctionAssign": "error",
+        "noGlobalAssign": "error",
+        "noGlobalIsFinite": "error",
+        "noGlobalIsNan": "error",
+        "noImplicitAnyLet": "error",
+        "noImportAssign": "warn",
+        "noIrregularWhitespace": "error",
+        "noLabelVar": "error",
+        "noMisleadingCharacterClass": "error",
+        "noMisleadingInstantiator": "error",
+        "noMisplacedAssertion": "error",
+        "noMisrefactoredShorthandAssign": "error",
+        "noNonNullAssertedOptionalChain": "error",
+        "noOctalEscape": "error",
+        "noPrototypeBuiltins": "warn",
+        "noQuickfixBiome": "warn",
+        "noRedeclare": "error",
+        "noRedundantUseStrict": "error",
+        // Who uses strict directive anymore?
+        // "noRedundantUseStrict": "error"
+        "noSelfCompare": "error",
+        "noShadowRestrictedNames": "error",
+        "noShorthandPropertyOverrides": "error",
+        "noSkippedTests": "error",
+        "noSparseArray": "error",
+        "noSuspiciousSemicolonInJsx": "error",
+        "noTemplateCurlyInString": "error",
+        "noThenProperty": "error",
+        "noTsIgnore": "error",
+        "noUnassignedVariables": "error",
+        "noUnsafeDeclarationMerging": "warn",
+        "noUnsafeNegation": "error",
+        "noUselessEscapeInString": "error",
+        "noUselessRegexBackrefs": "error",
+        "noVar": "error",
+        "noWith": "error",
+        "useAdjacentOverloadSignatures": "error",
+        "useAwait": "error",
+        "useBiomeIgnoreFolder": "warn",
+        "useDefaultSwitchClauseLast": "error",
+        "useErrorMessage": "warn",
+        "useGetterReturn": "error",
+        "useGuardForIn": "error",
+        "useIsArray": "error",
+        "useIterableCallbackReturn": "error",
+        "useNamespaceKeyword": "error",
+        "useNumberToFixedDigitsArgument": "error",
+        // "useStaticResponseMethods": "error"
+        "useStrictMode": "error"
+      }
+    }
+  },
+  "root": false
+}

package/biome.jsonc

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.11/schema.json",
+  "extends": ["./base.jsonc"],
+  "overrides": [
+    {
+      "includes": ["**/lint-staged.config.js"],
+      "linter": {
+        "rules": {
+          "correctness": {
+            "noUndeclaredDependencies": "off"
+          },
+          "performance": {
+            "noBarrelFile": "off"
+          },
+          "style": {
+            "noDefaultExport": "off"
+          }
+        }
+      }
+    }
+  ],
+  "root": false
+}

package/nestjs.jsonc

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.11/schema.json",
+  "extends": ["./base.jsonc"],
+  "linter": {
+    "rules": {
+      "complexity": {
+        "noStaticOnlyClass": "warn",
+        "noThisInStatic": "warn"
+      },
+      "style": {
+        "useGroupedAccessorPairs": "error",
+        "useReadonlyClassProperties": "error"
+      }
+    }
+  },
+  "root": false
+}

package/nextjs.jsonc

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.11/schema.json",
+  "extends": ["./react.jsonc"],
+  "linter": {
+    "rules": {
+      "performance": {
+        "noImgElement": "error",
+        "useGoogleFontPreconnect": "warn"
+      },
+      "suspicious": {
+        "noDocumentImportInPage": "error",
+        "noHeadImportInDocument": "error"
+      }
+    }
+  },
+  "root": false
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "description": "Biome configurations",
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.11"
+  },
+  "exports": {
+    "./base.json": "./base.jsonc",
+    "./nestjs.json": "./nestjs.jsonc",
+    "./nextjs.json": "./nextjs.jsonc",
+    "./react.json": "./react.jsonc"
+  },
+  "files": [
+    "*.jsonc",
+    "!package.json"
+  ],
+  "name": "@cleeviox/biome",
+  "peerDependencies": {
+    "@biomejs/biome": "^2.3.11"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "directory": "packages/biome",
+    "type": "git",
+    "url": "https://github.com/cleevio/cleeviox-toolkit"
+  },
+  "scripts": {
+    "check": "biome check --write .",
+    "clean": "del .turbo node_modules",
+    "fix": "biome:check:fix",
+    "format": "biome format .",
+    "format:fix": "biome format --write .",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write ."
+  },
+  "sideEffects": false,
+  "type": "module",
+  "version": "0.0.0-next-20260120205819"
+}

package/reactjs.jsonc

@@ -0,0 +1,76 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.11/schema.json",
+  "css": {
+    "parser": {
+      "tailwindDirectives": true
+    }
+  },
+  "extends": ["./base.jsonc"],
+  "linter": {
+    "rules": {
+      "a11y": "on",
+      "complexity": {
+        "noImportantStyles": "error",
+        "noUselessFragments": "error"
+      },
+      "correctness": {
+        "noChildrenProp": "error",
+        "noInvalidDirectionInLinearGradient": "error",
+        "noInvalidGridAreas": "error",
+        "noInvalidPositionAtImportRule": "error",
+        "noMissingVarFunction": "error",
+        "noNestedComponentDefinitions": "error",
+        "noQwikUseVisibleTask": "error",
+        "noReactPropAssignments": "error",
+        "noRenderReturnValue": "error",
+        "noUnknownMediaFeatureName": "error",
+        "noUnknownProperty": "error",
+        "noUnknownPseudoClass": "error",
+        "noUnknownPseudoElement": "error",
+        "noUnknownTypeSelector": "error",
+        "noUnknownUnit": "error",
+        "noUnmatchableAnbSelector": "error",
+        "noVoidElementsWithChildren": "error",
+        "useExhaustiveDependencies": "error",
+        "useHookAtTopLevel": "error",
+        "useImageSize": "error",
+
+        "useJsxKeyInIterable": "error",
+        "useQwikClasslist": "error",
+        "useUniqueElementIds": "error"
+      },
+      "security": {
+        "noBlankTarget": "error",
+        "noDangerouslySetInnerHtml": "error",
+        "noDangerouslySetInnerHtmlWithChildren": "error"
+      },
+      "style": {
+        "noDescendingSpecificity": "error",
+        "noHeadElement": "error",
+        "noImplicitBoolean": "error",
+        "noValueAtRule": "error",
+        "useConsistentCurlyBraces": "error",
+        "useFragmentSyntax": "error",
+        "useReactFunctionComponents": "error",
+        "useSelfClosingElements": "error"
+      },
+      "suspicious": {
+        "noAlert": "error",
+        "noArrayIndexKey": "warn",
+        "noCommentText": "error",
+        "noDocumentCookie": "error",
+        "noDuplicateAtImportRules": "error",
+        "noDuplicateFontNames": "error",
+        "noDuplicateJsxProps": "error",
+        "noDuplicateSelectorsKeyframeBlock": "error",
+        "noDuplicateTestHooks": "error",
+        "noEmptyBlock": "error",
+        "noImportantInKeyframe": "error",
+        "noReactSpecificProps": "error",
+        "noUnknownAtRules": "error",
+        "useGoogleFontDisplay": "error"
+      }
+    }
+  },
+  "root": false
+}