build: format/lint with prettier/biome and use husky hooks via lintstaged (#5)

Author: jpoehnelt

.husky/pre-commit

@@ -1 +1,3 @@
-pnpm build check test
+#!/bin/sh
+
+pnpx lint-staged --config .lintstagedrc.commit.js

.husky/pre-push

@@ -0,0 +1,3 @@
+#!/bin/sh
+
+pnpx lint-staged --config .lintstagedrc.push.js

.lintstagedrc.commit.js

@@ -0,0 +1,6 @@
+export default {
+  "**/*.{js,ts,json}": (filenames) =>
+    filenames.length ? [`biome check --write ${filenames.join(" ")}`] : [],
+  "!(**/*.{js,ts,json})": (filenames) =>
+    filenames.length ? [`prettier --write ${filenames.join(" ")}`] : [],
+};

.lintstagedrc.push.js

@@ -0,0 +1,3 @@
+export default {
+  "*": (filenames) => (filenames.length >= 5 ? ["pnpm build check test"] : []),
+};

.pretter.json

@@ -0,0 +1,3 @@
+{
+  "ignoreUnknown": true
+}

.prettierignore

@@ -0,0 +1,4 @@
+**/generated**
+**/*.{js,ts,json}
+.husky/**
+.prettierignore

.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+	"recommendations": [
+		"esbenp.prettier-vscode",
+		"biomejs.biome",
+		"google.geminicodeassist"
+	]
+}

.vscode/settings.json

@@ -1,13 +1,22 @@
 {
-  "editor.defaultFormatter": "esbenp.prettier-vscode",
-  "[javascript]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "windsurf.cascadeCommandsAllowList": [
-    "pnpm test",
-    "pnpm build",
-    "pnpm build check test",
-    "pnpm format",
-    "cd"
-  ]
+	"editor.defaultFormatter": "esbenp.prettier-vscode",
+	"[javascript]": {
+		"editor.defaultFormatter": "biomejs.biome"
+	},
+	"[typescript]": {
+		"editor.defaultFormatter": "biomejs.biome"
+	},
+	"[json]": {
+		"editor.defaultFormatter": "biomejs.biome"
+	},
+	"windsurf.cascadeCommandsAllowList": [
+		"pnpm test",
+		"pnpm build",
+		"pnpm build check test",
+		"pnpm format",
+		"cd"
+	],
+	"[shellscript]": {
+		"editor.defaultFormatter": "foxundermoon.shell-format"
+	}
 }

biome.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.8.3/schema.json",
+  "organizeImports": {
+    "enabled": true
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    }
+  },
+  "files": {
+    "include": ["**/*.js", "**/*.ts", "**/*.json"],
+    "ignore": ["**/package.json"]
+  },
+  "javascript": {
+    "formatter": {
+      "semicolons": "always"
+    }
+  }
+}

package.json

@@ -9,12 +9,20 @@
     "test": "turbo run test",
     "check": "turbo run check",
     "release": "turbo run build && pnpm publish -r",
-    "prepare": "husky install"
+    "prepare": "husky install",
+    "format:biome": "biome check --write .",
+    "format:prettier": "prettier --write .",
+    "format": "pnpm format:prettier && pnpm format:biome",
+    "lint:biome": "biome check .",
+    "lint:prettier": "prettier --check .",
+    "lint": "pnpm lint:prettier && pnpm lint:biome"
   },
   "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
     "@changesets/cli": "^2.28.1",
     "husky": "^9.1.7",
-    "prettier": "^3.5.3",
+    "lint-staged": "^15.5.0",
+    "prettier": "^3.4.2",
     "turbo": "^2.4.4",
     "typescript": "5.8.2"
   },
@@ -26,5 +34,6 @@
     "onlyBuiltDependencies": [
       "esbuild"
     ]
-  }
+  },
+  "type": "module"
 }