adamantite 0.0.1

package/README.md

@@ -0,0 +1,3 @@
+# Adamantite
+
+An opinionated set of presets for modern TypeScript applications.

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "adamantite",
+  "version": "0.0.1",
+  "description": "An strict and opinionated set of presets for modern TypeScript applications",
+  "keywords": [
+    "adamantite",
+    "biome",
+    "preset",
+    "formatter",
+    "linter",
+    "typescript"
+  ],
+  "homepage": "https://github.com/adelrodriguez/adamantite",
+  "bugs": {
+    "url": "https://github.com/adelrodriguez/adamantite/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adelrodriguez/adamantite.git"
+  },
+  "license": "MIT",
+  "author": "Adel Rodriguez <hello@adelrodriguez.com>",
+  "type": "module",
+  "exports": {
+    ".": "./config/biome.jsonc",
+    "./tsconfig": "./tsconfig.base.json"
+  },
+  "files": [
+    "src/config/biome.jsonc",
+    "src/config/tsconfig.json"
+  ],
+  "scripts": {
+    "test": "bun test",
+    "test:watch": "bun --watch test"
+  },
+  "dependencies": {
+    "@biomejs/biome": "2.1.2"
+  },
+  "devDependencies": {
+    "@types/bun": "1.2.19"
+  },
+  "peerDependencies": {
+    "typescript": "5.8.3"
+  },
+  "packageManager": "bun@1.2.18"
+}

package/src/config/biome.jsonc

@@ -0,0 +1,447 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.1.2/schema.json",
+  // ----------------------------- FORMATTER -----------------------------
+  // These are the generic settings that apply to all files in the project.
+  "formatter": {
+    "enabled": true,
+    // Format the code even if there are errors.
+    "formatWithErrors": true,
+    // Use spaces for indentation.
+    "indentStyle": "space",
+    // Use 2 spaces for indentation.
+    "indentWidth": 2,
+    // Use LF line endings.
+    "lineEnding": "lf",
+    // Good middle ground between readability and line length.
+    "lineWidth": 100,
+    // Don't force attributes to be on the same line as the element.
+    "attributePosition": "auto",
+    "bracketSpacing": true
+  },
+  // ----------------------------- ASSIST -----------------------------
+  // This is used to help with code completion and other IDE features.
+  "assist": {
+    "actions": {
+      "source": {
+        // Sort imports in a certain order. We prioritize runtime imports
+        // first (Bun, Node, etc.). Then external packages, and finally
+        // aliased imports.
+        "organizeImports": {
+          "level": "on",
+          "options": {
+            "groups": [":BUN:", ":NODE:", ":PACKAGE:", ":ALIAS:"]
+          }
+        },
+        "useSortedAttributes": "on",
+        "useSortedProperties": "on",
+        // Don't sort the keys of an object.
+        "useSortedKeys": "off"
+      }
+    }
+  },
+  // ----------------------------- LINTER -----------------------------
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "a11y": {
+        "noAccessKey": "error",
+        "noAriaHiddenOnFocusable": "error",
+        "noAriaUnsupportedElements": "error",
+        "noDistractingElements": "error",
+        "noHeaderScope": "error",
+        "noInteractiveElementToNoninteractiveRole": "error",
+        "noLabelWithoutControl": "error",
+        "noNoninteractiveElementToInteractiveRole": "error",
+        "noNoninteractiveTabindex": "error",
+        "noPositiveTabindex": "error",
+        "noRedundantAlt": "error",
+        "noRedundantRoles": "error",
+        "noStaticElementInteractions": "error",
+        "noSvgWithoutTitle": "error",
+        "useAltText": "error",
+        "useAnchorContent": "error",
+        "useAriaActivedescendantWithTabindex": "error",
+        "useAriaPropsForRole": "error",
+        "useAriaPropsSupportedByRole": "error",
+        "useButtonType": "error",
+        "useFocusableInteractive": "error",
+        "useHeadingContent": "error",
+        "useHtmlLang": "error",
+        "useIframeTitle": "error",
+        "useKeyWithClickEvents": "error",
+        "useKeyWithMouseEvents": "error",
+        "useMediaCaption": "error",
+        "useSemanticElements": "error",
+        "useValidAnchor": "error",
+        "useValidAriaProps": "error",
+        "useValidAriaRole": "error",
+        "useValidAriaValues": "error",
+        "useValidAutocomplete": "error",
+        "useValidLang": "error",
+        "noAutofocus": "off",
+        "useGenericFontNames": "error"
+      },
+      "complexity": {
+        "noAdjacentSpacesInRegex": "error",
+        "noArguments": "error",
+        "noBannedTypes": "error",
+        "noCommaOperator": "error",
+        "noEmptyTypeParameters": "error",
+        "noExcessiveCognitiveComplexity": {
+          "level": "error",
+          "options": {
+            "maxAllowedComplexity": 18
+          }
+        },
+        "noExcessiveNestedTestSuites": "error",
+        "useSimplifiedLogicExpression": "error",
+        "useWhile": "error"
+      },
+      "correctness": {
+        // --------- JavaScript ---------
+
+        "noChildrenProp": "error",
+        "noConstantCondition": "error",
+        "noConstantMathMinMaxClamp": "error",
+        "noConstAssign": "error",
+        "noConstructorReturn": "error",
+        "noEmptyCharacterClassInRegex": "error",
+        "noEmptyPattern": "error",
+        "noGlobalObjectCalls": "error",
+        "noInnerDeclarations": "error",
+        "noInvalidBuiltinInstantiation": "error",
+        "noInvalidConstructorSuper": "error",
+        "noInvalidUseBeforeDeclaration": "error",
+        "noNodejsModules": "off",
+        "noNonoctalDecimalEscape": "error",
+        "noPrecisionLoss": "error",
+        "noPrivateImports": "error",
+        "noRenderReturnValue": "error",
+        "noSelfAssign": "error",
+        "noSetterReturn": "error",
+        "noStringCaseMismatch": "error",
+        "noSwitchDeclarations": "error",
+        "noUndeclaredDependencies": "off",
+        "noUndeclaredVariables": "error",
+        "noUnreachable": "error",
+        "noUnreachableSuper": "error",
+        "noUnsafeFinally": "error",
+        "noUnsafeOptionalChaining": "error",
+        "noUnusedFunctionParameters": "error",
+        "noUnusedImports": "error",
+        "noUnusedLabels": "error",
+        "noUnusedPrivateClassMembers": "error",
+        "noUnusedVariables": "error",
+        "noVoidElementsWithChildren": "error",
+        "noVoidTypeReturn": "error",
+        "useExhaustiveDependencies": "error",
+        "useHookAtTopLevel": "error",
+        "useImportExtensions": "off",
+        "useIsNan": "error",
+        "useJsxKeyInIterable": "error",
+        "useValidForDirection": "error",
+        "useValidTypeof": "error",
+        "useYield": "error",
+
+        // --------- CSS ---------
+        "noInvalidDirectionInLinearGradient": "error",
+        "noInvalidGridAreas": "error",
+        "noInvalidPositionAtImportRule": "error",
+        "noMissingVarFunction": "error",
+        "noUnknownFunction": "error",
+        "noUnknownMediaFeatureName": "error",
+        "noUnknownProperty": "error",
+        "noUnknownPseudoClass": "error",
+        "noUnknownPseudoElement": "error",
+        "noUnknownTypeSelector": "error",
+        "noUnknownUnit": "error",
+        "noUnmatchableAnbSelector": "error"
+      },
+      "nursery": {
+        // --------- JavaScript ---------
+
+        "noAwaitInLoop": "error",
+        "noBitwiseOperators": "error",
+        "noConstantBinaryExpression": "error",
+        "noGlobalDirnameFilename": "error",
+        "noNestedComponentDefinitions": "error",
+        "noNoninteractiveElementInteractions": "error",
+        "noReactPropAssign": "error",
+        "noRestrictedElements": "error",
+        "noShadow": "error",
+        "noTsIgnore": "error",
+        "noUnwantedPolyfillio": "error",
+        "noUselessBackrefInRegex": "error",
+        "noUselessEscapeInString": "error",
+        "noUselessUndefined": "error",
+        "useAdjacentGetterSetter": "error",
+        "useConsistentObjectDefinition": "error",
+        "useConsistentResponse": "error",
+        "useExhaustiveSwitchCases": "error",
+        "useGoogleFontPreconnect": "error",
+        "useIndexOf": "error",
+        "useIterableCallbackReturn": "error",
+        "useJsonImportAttribute": "error",
+        "useNumericSeparators": "error",
+        "useObjectSpread": "error",
+        "useParseIntRadix": "error",
+        "useSingleJsDocAsterisk": "error",
+        "useSymbolDescription": "error",
+
+        "useExplicitType": "off",
+
+        "noProcessGlobal": "off",
+        "noSecrets": "off",
+        "useExportsLast": "off",
+        "useSortedClasses": {
+          "fix": "safe",
+          "level": "error",
+          "options": {
+            "attributes": ["className"],
+            "functions": ["clsx", "cva", "tw", "twMerge", "cn", "twJoin", "tv"]
+          }
+        },
+        "useUniqueElementIds": "off",
+
+        // These rules should be enabled eventually
+        "noFloatingPromises": "off",
+        "noImportCycles": "off",
+        "noUnresolvedImports": "off",
+
+        // --------- CSS ---------
+        "noImportantStyles": "error",
+        // Disabling this rule since we need custom at-rules for Tailwind
+        "noUnknownAtRule": "off"
+      },
+      "performance": {
+        // --------- JavaScript ---------
+
+        "noAccumulatingSpread": "error",
+        "noBarrelFile": "off",
+        "noDelete": "error",
+        "noDynamicNamespaceImportAccess": "error",
+        "noImgElement": "error",
+        "noNamespaceImport": "off",
+        "noReExportAll": "off",
+        "useTopLevelRegex": "error"
+      },
+      "security": {
+        // --------- JavaScript ---------
+
+        "noBlankTarget": "error",
+        "noDangerouslySetInnerHtml": "error",
+        "noDangerouslySetInnerHtmlWithChildren": "error",
+        "noGlobalEval": "error"
+      },
+      "style": {
+        // --------- JavaScript ---------
+        "noCommonJs": "off",
+        "noDefaultExport": "off",
+        "noDoneCallback": "error",
+        "noEnum": "error",
+        "noExportedImports": "error",
+        "noHeadElement": "error",
+        "noImplicitBoolean": "off",
+        "noInferrableTypes": "error",
+        "noNamespace": "error",
+        "noNegationElse": "error",
+        "noNestedTernary": "off",
+        "noNonNullAssertion": "error",
+        "noParameterAssign": "error",
+        "noParameterProperties": "error",
+        "noProcessEnv": "off",
+        "noRestrictedGlobals": "error",
+        "noRestrictedImports": "error",
+        "noRestrictedTypes": "error",
+        "noShoutyConstants": "error",
+        "noSubstr": "error",
+        "noUnusedTemplateLiteral": "error",
+        "noUselessElse": "error",
+        "noYodaExpression": "error",
+        "useArrayLiterals": "error",
+        "useAsConstAssertion": "error",
+        "useAtIndex": "error",
+        "useBlockStatements": "error",
+        "useCollapsedElseIf": "error",
+        "useCollapsedIf": "error",
+        "useComponentExportOnlyModules": "off",
+        "useConsistentArrayType": "error",
+        "useConsistentBuiltinInstantiation": "error",
+        "useConsistentCurlyBraces": "off",
+        "useConsistentMemberAccessibility": "error",
+        "useConst": "error",
+        "useDefaultParameterLast": "error",
+        "useDefaultSwitchClause": "error",
+        "useEnumInitializers": "error",
+        "useExplicitLengthCheck": "off",
+        "useExponentiationOperator": "error",
+        "useExportType": "error",
+        "useFilenamingConvention": {
+          "level": "error",
+          "options": {
+            "filenameCases": ["kebab-case"],
+            "requireAscii": true,
+            "match": "[-?%+]?(.+?)[.](.+)"
+          }
+        },
+        "useForOf": "error",
+        "useFragmentSyntax": "error",
+        "useImportType": "error",
+        "useLiteralEnumMembers": "error",
+        "useNamingConvention": "off",
+        "useNodeAssertStrict": "error",
+        "useNodejsImportProtocol": "error",
+        "useNumberNamespace": "error",
+        "useSelfClosingElements": "error",
+        "useShorthandAssign": "error",
+        "useShorthandFunctionType": "error",
+        "useSingleVarDeclarator": "off",
+        "useTemplate": "error",
+        "useThrowNewError": "error",
+        "useThrowOnlyError": "error",
+        "useTrimStartEnd": "error",
+
+        // --------- CSS ---------
+        "noDescendingSpecificity": "error",
+        "noValueAtRule": "error"
+      },
+      "suspicious": {
+        "noApproximativeNumericConstant": "error",
+        "noArrayIndexKey": "error",
+        "noAssignInExpressions": "error",
+        "noAsyncPromiseExecutor": "error",
+        "noCatchAssign": "error",
+        "noClassAssign": "error",
+        "noCommentText": "error",
+        "noCompareNegZero": "error",
+        "noConfusingLabels": "error",
+        "noConfusingVoidType": "error",
+        // Warn for the use of console to avoid accidental logging. Prefer a dedicated logger.
+        "noConsole": "warn",
+        "noConstEnum": "error",
+        "noControlCharactersInRegex": "error",
+        "noDebugger": "error",
+        "noDocumentCookie": "error",
+        "noDocumentImportInPage": "error",
+        "noDoubleEquals": "error",
+        "noDuplicateCase": "error",
+        "noDuplicateClassMembers": "error",
+        "noDuplicateElseIf": "error",
+        "noDuplicateJsxProps": "error",
+        "noDuplicateObjectKeys": "error",
+        "noDuplicateParameters": "error",
+        "noDuplicateTestHooks": "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",
+        "noHeadImportInDocument": "error",
+        "noImplicitAnyLet": "error",
+        "noImportAssign": "error",
+        "noIrregularWhitespace": "error",
+        "noLabelVar": "error",
+        "noMisleadingCharacterClass": "error",
+        "noMisleadingInstantiator": "error",
+        "noMisplacedAssertion": "error",
+        "noMisrefactoredShorthandAssign": "error",
+        "noOctalEscape": "error",
+        "noPrototypeBuiltins": "error",
+        "noReactSpecificProps": "off",
+        "noRedeclare": "error",
+        "noRedundantUseStrict": "error",
+        "noSelfCompare": "error",
+        "noShadowRestrictedNames": "error",
+        "noSkippedTests": "error",
+        "noSparseArray": "error",
+        "noSuspiciousSemicolonInJsx": "error",
+        "noTemplateCurlyInString": "error",
+        "noThenProperty": "error",
+        "noUnsafeDeclarationMerging": "error",
+        "noUnsafeNegation": "error",
+        "noVar": "error",
+        "noWith": "error",
+        "useAdjacentOverloadSignatures": "error",
+        "useAwait": "error",
+        "useDefaultSwitchClauseLast": "error",
+        "useErrorMessage": "error",
+        "useGetterReturn": "error",
+        "useGoogleFontDisplay": "error",
+        "useGuardForIn": "error",
+        "useIsArray": "error",
+        "useNamespaceKeyword": "error",
+        "useNumberToFixedDigitsArgument": "error",
+        "useStrictMode": "error",
+
+        // --------- CSS ---------
+        "noDuplicateAtImportRules": "error",
+        "noDuplicateCustomProperties": "error",
+        "noDuplicateFontNames": "error",
+        "noDuplicateProperties": "error",
+        "noDuplicateSelectorsKeyframeBlock": "error",
+        "noEmptyBlock": "error",
+        "noImportantInKeyframe": "error",
+        "noShorthandPropertyOverrides": "error"
+      }
+    }
+  },
+  // ------------------------------ JAVASCRIPT ------------------------------
+  // Options for JavaScript and TypeScript files.
+  "javascript": {
+    "formatter": {
+      "arrowParentheses": "always",
+      "attributePosition": "auto",
+      "bracketSameLine": false,
+      "bracketSpacing": true,
+      "enabled": true,
+      "indentStyle": "space",
+      "jsxQuoteStyle": "double",
+      "quoteProperties": "asNeeded",
+      "quoteStyle": "double",
+      // Only use semicolons to clear up ambiguity. We are of the opinion that
+      // JavaScript code without semicolons is more elegant.
+      "semicolons": "asNeeded",
+      "trailingCommas": "es5"
+    }
+  },
+  // --------------------------------- CSS -------------------------------
+  "css": {
+    "formatter": {
+      "quoteStyle": "double"
+    },
+    "parser": {
+      "allowWrongLineComments": false,
+      "cssModules": false
+    }
+  },
+  // ------------------------------- JSON ------------------------------
+  "json": {
+    "assist": {
+      "enabled": true
+    },
+    "formatter": {
+      "enabled": true,
+      "indentStyle": "space",
+      "indentWidth": 2,
+      "lineEnding": "lf",
+      "lineWidth": 80,
+      "trailingCommas": "none"
+    },
+    "linter": {
+      "enabled": true
+    }
+  },
+  "vcs": {
+    "clientKind": "git",
+    "defaultBranch": "main",
+    "enabled": true,
+    "useIgnoreFile": true
+  }
+}

package/src/config/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    // Base options
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "verbatimModuleSyntax": true,
+    "allowJs": true,
+    "resolveJsonModule": true,
+    "moduleDetection": "force",
+
+    // Strictness and best practices
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitOverride": true,
+    "forceConsistentCasingInFileNames": true,
+    "noUnusedParameters": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitThis": true,
+    "noImplicitReturns": true
+  }
+}