Migrate repository to TypeScript + Zod targeting ES2022

.gitignore

@@ -103,4 +103,6 @@ typings/
 # TernJS port file
 .tern-port
 
-src/schemas/build
+# Build directories
+src/schemas/build
+build/

.npmignore

@@ -113,4 +113,11 @@ docs/
 test/
 .coderabbit.yaml
 .gitignore
-CONTRIBUTIONS.md
+CONTRIBUTIONS.md
+
+# TypeScript source files (use compiled output in build/)
+src/
+tsconfig.json
+
+# Schema build directory
+src/schemas/build/

README.md

@@ -1,6 +1,6 @@
 # Doc Detective Common
 
-Shared components for Doc Detective projects.
+Shared components for Doc Detective projects. Written in TypeScript with Zod for type-safe schema validation.
 
 ## 📦 Installation
 
@@ -25,22 +25,41 @@ This package automatically publishes development versions on every commit to the
 This package exports the following components:
 
 - `schemas` - JSON schemas for validation
-- `validate` - Validation functions
+- `validate` - Validation functions using AJV
 - `resolvePaths` - Path resolution utilities
 - `readFile` - File reading utilities
 - `transformToSchemaKey` - Schema key transformation
 
+### TypeScript & Zod Schemas
+
+The package includes Zod schemas for type inference:
+
+```typescript
+import { 
+  configV3Schema, 
+  stepV3Schema, 
+  type ConfigV3, 
+  type StepV3 
+} from 'doc-detective-common';
+
+// Type-safe validation
+const config: ConfigV3 = configV3Schema.parse(myConfigObject);
+```
+
 ## 🧪 Development
 
 ```bash
 # Install dependencies
 npm install
 
+# Build TypeScript and schemas
+npm run build
+
 # Run tests
 npm test
 
-# Build schemas
-npm run build
+# Compile TypeScript only
+npm run compile
 ```
 
 ## 📄 License