♻️ refactor: complete TypeScript migration to Thunderbird WebExtension

Migrate from legacy JS background/options scripts to fully typed
TypeScript modules with esbuild bundling. Changes include:

- Convert all background scripts (background.js, options.js, etc.)
  to src/**/*.ts with proper type definitions
- Add esbuild build pipeline with TypeScript config
- Restruct into modular architecture (ai, email, folders, batch,
  auto-sort, shared, options, types)
- Add Vitest test suite with fixtures and mocks
- Remove legacy JS files and bundled .xpi
- Fix auto-sort extractEmailContext to use direct import instead
  of window global access (fixes Thunderbird DevTools error)
- Add ollamaNumCtx to AutoSortSettings type definition

Author: rfiacne

.gitignore

@@ -1,4 +1,5 @@
 # Build artifacts
+dist/
 *.xpi
 *.zip
 

.prettierrc

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

README.md

@@ -128,9 +128,13 @@ Choose from **5 leading cloud AI providers** or run a **local Ollama** model:
 ```bash
 git clone https://github.com/Nigel1992/AutoSort-Plus.git
 cd AutoSort-Plus
-zip -r autosortplus.xpi manifest.json background.js options.js options.html styles.css content.js icons/ js/ _locales/
+npm install
+npm run build
+npm run xpi
 ```
 
+Then load `autosortplus.xpi` as described in Option 1.
+
 <div align="center">
 
 **[📥 Download Latest Release](https://github.com/Nigel1992/AutoSort-Plus/releases) • [📖 View Changelog](#-changelog)**
@@ -620,6 +624,67 @@ If you encounter any issues, please [open an issue on GitHub](https://github.com
 
 ---
 
+## Development
+
+### Prerequisites
+
+- Node.js 18+
+- npm
+
+### Setup
+
+```bash
+git clone https://github.com/Nigel1992/AutoSort-Plus.git
+cd AutoSort-Plus
+npm install
+```
+
+### Architecture
+
+```
+src/
+├── background/       Background script (AI, batch, folders, auto-sort)
+├── options/          Options page UI
+├── shared/           Shared utilities (logger, storage, i18n, tab-fetch)
+├── types/            TypeScript type definitions
+├── content.ts        Content script
+├── ollama.ts         Ollama API client
+├── workers/          Web Workers
+└── popup/            Web-accessible popups
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `npm run build` | Build extension to `dist/` |
+| `npm run watch` | Build and watch for changes |
+| `npm run test` | Run tests |
+| `npm run test:watch` | Run tests in watch mode |
+| `npm run test:coverage` | Run tests with coverage report |
+| `npm run lint` | Lint source code |
+| `npm run format` | Check formatting |
+| `npm run format:fix` | Fix formatting |
+| `npm run typecheck` | TypeScript type checking |
+| `npm run check` | Full check (typecheck + lint + test) |
+| `npm run xpi` | Build + package as `.xpi` |
+
+### Load in Thunderbird
+
+1. `npm run build`
+2. In Thunderbird, go to `about:debugging` → This Thunderbird → Load Temporary Add-on
+3. Select `dist/manifest.json`
+
+### Tech Stack
+
+- TypeScript (strict mode)
+- esbuild (bundler)
+- Vitest (test framework)
+- ESLint + Prettier (code quality)
+- Thunderbird WebExtension APIs
+
+---
+
 ## 🙏 Contributing
 
 We welcome contributions! Here's how to help:

api_ollama/index.html

@@ -45,6 +45,6 @@ <h2>AutoSort+ - Ollama Chat</h2>
     <div id="messages"></div>
     <div id="response"></div>
     <div id="status">Initializing...</div>
-    <script src="ollama-popup.js" type="module"></script>
+    <script src="ollama-popup.js"></script>
 </body>
 </html>