docs: add TypeScript setup guide

Add documentation for using Mocha with TypeScript to help developers
avoid common setup issues.

- Add TypeScript configuration examples
- Include basic test examples
- Cover common troubleshooting issues
- Add package.json and tsconfig.json templates

This addresses frequent questions about TypeScript setup that come up
in issues and community discussions.

Author: ashvin2005

docs/typescript.md

@@ -0,0 +1,80 @@
+# TypeScript
+
+Mocha works well with TypeScript. Here's how to get started:
+
+## Quick Setup
+
+Install dependencies:
+```bash
+npm install --save-dev mocha typescript ts-node @types/mocha @types/node
+```
+
+Run tests:
+```bash
+npx mocha --require ts-node/register "test/**/*.test.ts"
+```
+
+## Configuration Files
+
+### package.json
+Add a test script:
+```json
+{
+  "scripts": {
+    "test": "mocha --require ts-node/register 'test/**/*.test.ts'"
+  }
+}
+```
+
+### tsconfig.json
+Basic configuration:
+```json
+{
+  "compilerOptions": {
+    "target": "es2018",
+    "module": "commonjs",
+    "strict": true,
+    "esModuleInterop": true,
+    "types": ["mocha", "node"]
+  }
+}
+```
+
+## Example Test
+
+```typescript
+// test/math.test.ts
+describe('math functions', function() {
+  it('should add numbers', function() {
+    const result = 2 + 2;
+    if (result !== 4) {
+      throw new Error('Addition failed');
+    }
+  });
+  
+  it('should handle async', async function() {
+    const result = await Promise.resolve(42);
+    if (result !== 42) {
+      throw new Error('Async test failed');
+    }
+  });
+});
+```
+
+## Common Issues
+
+**"Cannot find module" errors**: Make sure @types/mocha and @types/node are installed.
+
+**Compilation errors**: Check that tsconfig.json includes test files and has "types": ["mocha"].
+
+**Import errors**: Use import syntax, not require() in TypeScript files.
+
+## .mocharc.json (Optional)
+
+For persistent configuration:
+```json
+{
+  "require": ["ts-node/register"],
+  "spec": ["test/**/*.test.ts"]
+}
+```

examples/typescript-basic.test.ts

@@ -0,0 +1,17 @@
+// Simple TypeScript test example for Mocha
+describe('TypeScript Example', function() {
+  it('should run TypeScript tests', function() {
+    const message: string = 'Hello TypeScript!';
+    if (message.length === 0) {
+      throw new Error('Message should not be empty');
+    }
+  });
+
+  it('should handle async operations', async function() {
+    const delay = (ms: number): Promise<void> => 
+      new Promise(resolve => setTimeout(resolve, ms));
+    
+    await delay(1);
+    // Test passes if we reach here
+  });
+});