feat: enable incremental compilation and update TypeScript configuration standards

Author: austenstone

.github/copilot-instructions.md

@@ -0,0 +1,45 @@
+---
+applyTo: "**"
+---
+
+# TypeScript Node.js Project Standards
+
+## Module System
+- Use ES modules (`import`/`export`) - this project is configured with `"type": "module"` in package.json
+
+## TypeScript Configuration
+- Follow strict TypeScript settings - all strict options are enabled
+- Use `NodeNext` module resolution and `ES2022` target
+- Generate declaration files for all exported types
+- Remove comments in compiled output
+- Enable incremental compilation for faster builds
+
+## Development Tools
+- Use `tsx` for development with watch mode (`npm run dev`)
+- Use `vitest` for testing (not Jest) - test files should use `.test.ts` extension (`npm run test`)
+- Use `eslint` for linting (`npm run lint`)
+
+## Code Style
+- Use single quotes for strings
+- Use 2 spaces for indentation
+- Prefer `const` over `let` when possible
+- Use async/await over promises (top-level await is supported)
+- Use proper TypeScript types instead of `any`
+
+## Testing
+- Place test files alongside source files with `.test.ts` extension
+
+## Environment Configuration
+- Use dotenv for environment variables with `import 'dotenv/config'`
+- Load environment configuration at the top of entry files
+
+## Project Structure
+- Source files in `src/` directory
+- Compiled output in `dist/` directory
+- Entry point: `src/index.ts` compiles to `dist/index.js`
+- Type definitions generated as `dist/index.d.ts`
+
+## Dependencies
+- Keep dependencies minimal and focused
+- Use `@types/node` for Node.js type definitions
+- Prefer modern Node.js APIs and features

tsconfig.json

@@ -1,7 +1,7 @@
 {
   "compilerOptions": {
     /* Basic Options */
-    // "incremental": true,                   /* Enable incremental compilation */
+    "incremental": true,                      /* Enable incremental compilation */
     "target": "ES2022",                       /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019' or 'ESNEXT'. */
     "module": "NodeNext",                     /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', or 'ESNext'. */
     // "allowJs": true,                       /* Allow javascript files to be compiled. */
@@ -36,7 +36,7 @@
     "noFallthroughCasesInSwitch": true,       /* Report errors for fallthrough cases in switch statement. */
     /* Module Resolution Options */
     "moduleResolution": "nodenext",           /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */
-    // "baseUrl": "./",                       /* Base directory to resolve non-absolute module names. */
+        // "baseUrl": "./",                       /* Base directory to resolve non-absolute module names. */
     // "paths": {},                           /* A series of entries which re-map imports to lookup locations relative to the 'baseUrl'. */
     // "rootDirs": [],                        /* List of root folders whose combined content represents the structure of the project at runtime. */
     // "typeRoots": [],                       /* List of folders to include type definitions from. */
@@ -57,6 +57,6 @@
   "exclude": [
     "dist",
     "node_modules",
-    "tests"
+    "**/*.spec.ts",
   ]
 }