refactor: use Bun, Biome.js; upgrade packages

Author: dmythro

.eslintrc.json

@@ -15,29 +15,21 @@ on:
       - '!**README*'
 
 jobs:
-  nodejs:
+  bun:
     runs-on: ubuntu-latest
 
-    strategy:
-      matrix:
-        node-version: [20, 18]
-
     steps:
       - uses: actions/checkout@v3
 
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
         with:
-          cache: 'npm'
-          node-version: ${{ matrix.node-version }}
+          bun-version: 1.3.0
 
-      - name: NPM install
-        run: npm install --prefer-offline --no-audit
-        env:
-          CI: true
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
 
       - name: Build & Test
-        # Runs lint, build & tests
-        run: npm run ci
+        run: bun run ci
         env:
           CI: true

.github/workflows/nodejs.yml

@@ -3,10 +3,8 @@
 
 # IDE
 .idea
-*.lock
 
 coverage
-.eslintcache
 .phpunit.cache
 .turbo
 

.gitignore

@@ -1,4 +1,4 @@
 #!/usr/bin/env sh
 . "$(dirname "$0")/_/husky.sh"
 
-npx lint-staged
+bunx lint-staged

.husky/pre-commit

@@ -0,0 +1,24 @@
+# Agent Instructions
+
+## Commands
+
+- Build: `bun run build` (builds all packages via turbo)
+- Lint: `bun run lint` (runs biome check)
+- Lint fix: `bun run lint:fix` (runs biome check --write)
+- Format: `bun run format` (runs biome format --write)
+- Test: `bun run test` (runs all tests)
+- Single test: `cd packages/test-node && bun test <test-file.test.ts>` (Bun test runner)
+- CI: `bun run ci` (lint + build + test)
+
+## Code Style
+
+- Use Biome for linting and formatting: 100 char width, single quotes, no semicolons, 2 spaces, trailing commas (ES5)
+- TypeScript: Avoid `any` (warn level), use explicit types for exports
+- Imports: Use `.ts` extensions in import paths (e.g., `from './types.ts'`)
+- Naming: camelCase for functions/variables, PascalCase for types/interfaces (prefix `I` for interfaces, `T` for type aliases)
+- Error handling: TypeScript strict mode, no explicit any unless necessary
+- Exports: Named exports only (no default exports)
+- Files: One primary export per file matching filename (e.g., `getCountryData.ts` exports `getCountryData`)
+- Format: Run `bun run format` before committing (enforced by husky pre-commit hook)
+- Do not write any documentation unless it was asked for
+- Do not write unnecessary comments in code, unless: code is not obvious, URLs should be linked to the issue, docs etc

.prettierrc.json

@@ -24,6 +24,7 @@ Everything is strongly typed so you can easily use data with auto-complete in yo
 
 Package is available via:
 
+- **Bun** `bun add countries-list`
 - **NPM** `npm install countries-list`
 - **Composer / Packagist** `composer require annexare/countries-list`
 
@@ -113,7 +114,7 @@ Everything is generated from strongly typed files in `packages/countries/src`, i
 
 Everything in `dist` is generated,
 so please make data related changes **ONLY** to files from `packages/countries`, commit them.
-Use `npm run build` (or `turbo build`, `turbo test`) command to build/test generated files.
+Use `bun run build` (or `turbo build`, `turbo test`) command to build/test generated files.
 
 ## Credits
 

AGENTS.md

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.2.6/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": true,
+    "experimentalScannerIgnores": ["**/dist", "**/node_modules", "!**/*.min.*"],
+    "includes": [
+      "**",
+      "!**/dist",
+      "!**/node_modules",
+      "!**/*.min.*",
+      "!**/*.config.ts",
+      "!**/*.d.ts",
+      "!**/version.ts"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100,
+    "lineEnding": "lf"
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "trailingCommas": "es5",
+      "semicolons": "asNeeded",
+      "arrowParentheses": "always"
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": {
+        "noExplicitAny": "warn"
+      }
+    }
+  }
+}