Merge pull request #21 from alienfast/tooling

Migrate tooling: ESLint/Prettier → Biome, Vite → tsdown

Author: rosskevin

.markdownlint.jsonc

@@ -0,0 +1,4 @@
+{
+  "default": true,
+  "MD013": false
+}

.markdownlintignore

@@ -0,0 +1,2 @@
+node_modules/
+**/CHANGELOG.md

.ncurc.cjs

@@ -1,6 +1,6 @@
 module.exports = {
   packageFile: './package.json',
   packageManager: 'yarn',
-  workspaces: true,
   root: true,
+  workspaces: true,
 }

.prettierignore

@@ -1,3 +1,3 @@
 {
-  "recommendations": ["dbaeumer.vscode-eslint", "esbenp.prettier-vscode"]
+  "recommendations": ["biomejs.biome", "davidanson.vscode-markdownlint"]
 }

.vscode/extensions.json

@@ -1,9 +1,9 @@
 {
   "search.exclude": {
-    "**/.yarn": true,
-    "**/.pnp.*": true
+    "**/.pnp.*": true,
+    "**/.yarn": true
   },
-  "eslint.useFlatConfig": true,
   "typescript.enablePromptUseWorkspaceTsdk": true,
-  "testing.automaticallyOpenPeekView": "never"
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "vitest.maximumConfigs": 15
 }

.vscode/settings.json

@@ -1,16 +1,16 @@
 {
-  // See https://go.microsoft.com/fwlink/?LinkId=733558
-  // for the documentation about the tasks.json format
-  "version": "2.0.0",
   "tasks": [
     {
-      "type": "npm",
-      "script": "typecheck",
-      "problemMatcher": ["$tsc"],
+      "detail": "echo 'tsc -p tsconfig.json --pretty' && tsc -p tsconfig.json --pretty",
       "group": {
-        "kind": "build",
-        "isDefault": true
-      }
+        "isDefault": true,
+        "kind": "build"
+      },
+      "label": "npm: check-types",
+      "problemMatcher": ["$tsc"],
+      "script": "check-types",
+      "type": "npm"
     }
-  ]
+  ],
+  "version": "2.0.0"
 }

.vscode/tasks.json

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-This is a TypeScript monorepo for AlienFast logger packages, managed with Lerna and built with Vite. The project provides logging functionality across three main packages:
+This is a TypeScript monorepo for AlienFast logger packages, managed with Lerna and built with tsdown. The project provides logging functionality across three main packages:
 
 - `@alienfast/logger` - Core logging interfaces and functionality
 - `@alienfast/logger-browser` - Browser-specific logging implementation
@@ -15,9 +15,17 @@ This is a TypeScript monorepo for AlienFast logger packages, managed with Lerna
 ### Development
 
 - `yarn build` - Build all packages (clean → prep → individual builds)
-- `yarn typecheck` - TypeScript compilation only (`tsc -b`)
-- `yarn test` - Run all tests across packages (builds first, then runs in parallel)
-- `yarn lint:fix` - Run ESLint with auto-fix
+- `yarn check-types` - TypeScript type-checking only (`tsc -p tsconfig.json --pretty`)
+- `yarn test` - Run all tests across packages (type-checks first, then runs tests in parallel)
+- `yarn lint-fix` - Run Biome with auto-fix for code formatting and linting
+
+### Quality Checks
+
+- `yarn check` - Run all quality checks (types, Biome, circular dependencies, markdown)
+- `yarn check-types` - TypeScript type-checking without emitting files
+- `yarn check-biome` - Run Biome checks with auto-fixing
+- `yarn check-circular` - Detect circular dependencies using madge
+- `yarn check-markdown` - Lint markdown files with markdownlint
 
 ### Package Management
 
@@ -28,7 +36,7 @@ This is a TypeScript monorepo for AlienFast logger packages, managed with Lerna
 
 All packages support these commands (run from package directory or with `lerna exec`):
 
-- `yarn build` - Build individual package using shared Vite config
+- `yarn build` - Build individual package using shared tsdown config
 - `yarn test` - Run package-specific tests with Vitest
 
 ## Architecture
@@ -37,15 +45,19 @@ All packages support these commands (run from package directory or with `lerna e
 
 - **Workspace Root**: Contains shared configuration and build tools
 - **packages/logger**: Core logging abstractions (`Logger`, `Log`, `LogWriter`, etc.)
+  - Includes `diagnostics.ts` module for circular dependency diagnostic utilities
 - **packages/logger-browser**: Browser-specific implementations (`BrowserLogWriter`)
 - **packages/logger-node**: Node.js implementations with colored console output (`NodeLogWriter`)
 
 ### Build System
 
-- **Vite** for library builds with TypeScript declaration generation
-- **Shared configuration** in `vite.config.lib.ts` used by all packages
-- **ESM-only** output format with tree-shaking support
+- **tsdown** for library builds with TypeScript declaration generation
+- **Shared configuration** in `tsdown.config.base.ts` used by all packages
+- **ESM-only unbundled** output format with automatic exports generation
 - **Type preservation** with source maps for debugging
+- **Vite** still used for testing via Vitest
+- Each package has `tsconfig.build.json` for build-specific configuration
+- Root `tsconfig.json` has `noEmit: true` for type-checking only
 
 ### Key Dependencies
 
@@ -54,23 +66,31 @@ All packages support these commands (run from package directory or with `lerna e
 - Node package adds `chalk` for colored output
 - All packages use `clean-package` for publishing optimizations
 
+### Code Quality
+
+- **Biome** for code formatting and linting (replaces ESLint/Prettier)
+- **markdownlint** for markdown file linting
+- **madge** for circular dependency detection
+- **TypeScript** strict mode with comprehensive type-checking
+
 ### Testing
 
 - **Vitest** for unit testing across all packages
-- Tests run in parallel after TypeScript compilation
+- Tests run in parallel after TypeScript type-checking
 - Individual package testing supported
 
 ### Release Process
 
 - **Auto** for automated releases with conventional commits
 - **Lerna** for coordinated package versioning
 - **GitHub Packages** registry for publishing
-- Pre-commit hooks with lint-staged for code quality
+- Pre-commit hooks with lint-staged running Biome checks
 
 ## Development Workflow
 
 1. Make changes in relevant package(s) under `packages/`
-2. Run `yarn typecheck` for quick type checking
-3. Run `yarn test` to ensure all tests pass
-4. Use `yarn lint:fix` to format code
-5. Commit follows conventional commit format for auto-releases
+2. Run `yarn check-types` for quick type checking
+3. Run `yarn test` to ensure all tests pass (includes type-checking)
+4. Use `yarn lint-fix` to format code with Biome
+5. Run `yarn check` to verify all quality checks pass
+6. Commit follows conventional commit format for auto-releases

CLAUDE.md

@@ -21,12 +21,14 @@ LogWriter implementations check log levels before expensive operations like time
 ## Performance Characteristics
 
 **When log levels are set to WARN/ERROR:**
+
 - Debug/info calls have near-zero overhead (< 0.001ms per call)
 - Spread operator overhead eliminated for disabled log levels
 - Object serialization optimized with efficient cycle detection
 - Timestamp and formatting operations skipped when not needed
 
 **Backward Compatibility:**
+
 - All existing APIs work unchanged
 - No migration required
 - Performance improvements are automatic
@@ -45,4 +47,4 @@ The optimizations work at three levels:
 - **Production configuration**: Set system threshold to WARN or ERROR for optimal performance
 - **Complex objects**: Benefits are automatic when logging objects with circular references
 
-The optimizations ensure that production applications with logging set to WARN+ experience minimal performance impact from debug/info logging statements.
+The optimizations ensure that production applications with logging set to WARN+ experience minimal performance impact from debug/info logging statements.

PERFORMANCE.md

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.2.4/schema.json",
+  "extends": ["@alienfast/biome-config/base"],
+  "files": {
+    "experimentalScannerIgnores": [
+      "node_modules/**",
+      "**/dist/**",
+      "**/node_modules/**",
+      "packages/*/dist/**"
+    ],
+    "includes": ["**/*"]
+  },
+  "linter": {
+    "rules": {
+      "complexity": {
+        "noStaticOnlyClass": "off"
+      }
+    }
+  }
+}