Nomad changes

docs/reference/errors.md

@@ -0,0 +1,50 @@
+---
+title: "Error Reference"
+---
+
+## Error Reference
+
+All error types thrown by the library across all languages.
+
+### KreuzbergError
+
+Main error type for all Kreuzberg operations.
+
+All errors in Kreuzberg use this enum, which preserves error chains
+and provides context for debugging.
+
+## Variants
+
+- `Io` - File system and I/O errors (always bubble up)
+- `Parsing` - Document parsing errors (corrupt files, unsupported features)
+- `Ocr` - OCR processing errors
+- `Validation` - Input validation errors (invalid paths, config, parameters)
+- `Cache` - Cache operation errors (non-fatal, can be ignored)
+- `ImageProcessing` - Image manipulation errors
+- `Serialization` - JSON/MessagePack serialization errors
+- `MissingDependency` - Missing optional dependencies (tesseract, etc.)
+- `Plugin` - Plugin-specific errors
+- `LockPoisoned` - Mutex/RwLock poisoning (should not happen in normal operation)
+- `UnsupportedFormat` - Unsupported MIME type or file format
+- `Other` - Catch-all for uncommon errors
+
+| Variant | Message | Description |
+|---------|---------|-------------|
+| `Io` | IO error: {0} | Io errors |
+| `Parsing` | Parsing error: {message} | Parsing errors |
+| `Ocr` | OCR error: {message} | Ocr errors |
+| `Validation` | Validation error: {message} | Validation errors |
+| `Cache` | Cache error: {message} | Cache errors |
+| `ImageProcessing` | Image processing error: {message} | Image processing errors |
+| `Serialization` | Serialization error: {message} | Serialization errors |
+| `MissingDependency` | Missing dependency: {0} | Missing dependency errors |
+| `Plugin` | Plugin error in '{plugin_name}': {message} | Plugin errors |
+| `LockPoisoned` | Lock poisoned: {0} | Lock poisoned errors |
+| `UnsupportedFormat` | Unsupported format: {0} | Unsupported format errors |
+| `Embedding` | Embedding error: {message} | Embedding errors |
+| `Timeout` | Extraction timed out after {elapsed_ms}ms (limit: {limit_ms}ms) | Timeout errors |
+| `Cancelled` | Extraction cancelled | Cancelled errors |
+| `Security` | Security violation: {message} | Security errors |
+| `Other` | {0} | Other errors |
+
+---