chore(release): v4.2.10

## Fixes

### Java Bindings
- Fix ClassCastException when deserializing nested generic collections (#355)
  - Added @JsonDeserialize annotations to PageStructure, FormattedBlock,
    Footnote, Attributes, PageHierarchy, PageContent, DjotContent
  - Added comprehensive JSON deserialization regression tests

### Python Bindings
- Fix Windows CLI binary missing from wheel (#349)
  - CI workflow was copying with wrong filename (kreuzberg.exe instead of kreuzberg-cli.exe)

### MIME Type Detection
- Fix DOCX/XLSX/PPTX detected as ZIP via detect_mime_type_from_bytes (#350)

### Java Bindings
- Fix format-specific metadata missing in getMetadataMap()

Author: Goldziher

.github/workflows/ci-python.yaml

@@ -152,10 +152,11 @@ jobs:
           echo "=== Building CLI Binary with Features ==="
           cargo build --release --package kreuzberg-cli --features all
           mkdir -p packages/python/kreuzberg
+          # Copy with correct name (kreuzberg-cli) to match pyproject.toml include paths
           if [ "${{ runner.os }}" = "Windows" ]; then
-            cp target/release/kreuzberg.exe packages/python/kreuzberg/
+            cp target/release/kreuzberg.exe packages/python/kreuzberg/kreuzberg-cli.exe
           else
-            cp target/release/kreuzberg packages/python/kreuzberg/
+            cp target/release/kreuzberg packages/python/kreuzberg/kreuzberg-cli
           fi
 
       - name: Build FFI library

CHANGELOG.md

@@ -9,13 +9,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+---
+
+## [4.2.10] - 2026-02-05
+
 ### Fixed
 
 #### MIME Type Detection
 - **DOCX/XLSX/PPTX files detected as ZIP via `detect_mime_type_from_bytes`**: Fixed Office Open XML files (DOCX, XLSX, PPTX) being incorrectly detected as `application/zip` when using bytes-based MIME detection. The function now inspects ZIP contents for Office format markers (`word/document.xml`, `xl/workbook.xml`, `ppt/presentation.xml`) to correctly identify these formats. (#350)
 
 #### Java Bindings
 - **Format-specific metadata missing in `getMetadataMap()`**: Fixed `sheet_count`, `sheet_names`, and other format-specific metadata fields not being accessible via `ExtractionResult.getMetadataMap()`. The `ResultParser.buildMetadata()` method now properly propagates flattened format metadata (e.g., Excel, PPTX) to the `Metadata.additional` map.
+- **ClassCastException when deserializing nested generic collections**: Fixed `LinkedHashMap cannot be cast to PageStructure` and similar errors when deserializing JSON with nested `List<T>` fields. Added `@JsonDeserialize(contentAs = ...)` annotations to all model classes with generic list fields (`PageStructure`, `FormattedBlock`, `Footnote`, `Attributes`, `PageHierarchy`, `PageContent`, `DjotContent`) to preserve type information during Jackson deserialization. (#355)
+
+#### Python Bindings
+- **Windows CLI binary still missing from wheel**: Fixed CI workflow copying CLI binary with wrong filename (`kreuzberg.exe` instead of `kreuzberg-cli.exe`), causing the binary to be excluded from Windows wheels despite the v4.2.9 build.py fix. The CI now copies with the correct name to match pyproject.toml include paths. (#349)
 
 ---
 

Cargo.lock

@@ -22,7 +22,7 @@ kreuzberg = { path = "crates/kreuzberg" }
 kreuzberg-tesseract = { path = "crates/kreuzberg-tesseract" }
 
 [workspace.package]
-version = "4.2.9"
+version = "4.2.10"
 edition = "2024"
 rust-version = "1.91"
 authors = ["Na'aman Hirschfeld <nhirschfeld@gmail.com>"]

Cargo.toml

@@ -22,7 +22,7 @@
     <img src="https://img.shields.io/maven-central/v/dev.kreuzberg/kreuzberg?label=Java&color=007ec6" alt="Java">
   </a>
   <a href="https://github.com/kreuzberg-dev/kreuzberg/releases">
-    <img src="https://img.shields.io/github/v/tag/kreuzberg-dev/kreuzberg?label=Go&color=007ec6&filter=v4.2.9" alt="Go">
+    <img src="https://img.shields.io/github/v/tag/kreuzberg-dev/kreuzberg?label=Go&color=007ec6&filter=v4.2.10" alt="Go">
   </a>
   <a href="https://www.nuget.org/packages/Kreuzberg/">
     <img src="https://img.shields.io/nuget/v/Kreuzberg?label=C%23&color=007ec6" alt="C#">

README.md

@@ -1,7 +1,7 @@
 {
     "name": "kreuzberg/kreuzberg",
     "description": "High-performance document intelligence for PHP. Extract text, metadata, and structured information from PDFs, Office documents, images, and 56 formats. Powered by Rust core for 10-50x speed improvements.",
-    "version": "4.2.9",
+    "version": "4.2.10",
     "type": "php-ext",
     "license": "MIT",
     "keywords": [

composer.json

@@ -13,7 +13,7 @@ keywords = ["document", "extraction", "cli", "tool", "parser"]
 categories = ["command-line-utilities", "text-processing"]
 
 [dependencies]
-kreuzberg = { path = "../kreuzberg", version = "4.2.9", features = ["cli", "bundled-pdfium"] }
+kreuzberg = { path = "../kreuzberg", version = "4.2.10", features = ["cli", "bundled-pdfium"] }
 clap = { workspace = true }
 tokio = { workspace = true }
 anyhow = { workspace = true }

crates/kreuzberg-cli/Cargo.toml

@@ -22,7 +22,7 @@
     <img src="https://img.shields.io/maven-central/v/dev.kreuzberg/kreuzberg?label=Java&color=007ec6" alt="Java">
   </a>
   <a href="https://github.com/kreuzberg-dev/kreuzberg/releases">
-    <img src="https://img.shields.io/github/v/tag/kreuzberg-dev/kreuzberg?label=Go&color=007ec6&filter=v4.2.9" alt="Go">
+    <img src="https://img.shields.io/github/v/tag/kreuzberg-dev/kreuzberg?label=Go&color=007ec6&filter=v4.2.10" alt="Go">
   </a>
   <a href="https://www.nuget.org/packages/Kreuzberg/">
     <img src="https://img.shields.io/nuget/v/Kreuzberg?label=C%23&color=007ec6" alt="C#">

crates/kreuzberg-node/README.md

@@ -1,6 +1,6 @@
 {
 	"name": "@kreuzberg/node-darwin-arm64",
-	"version": "4.2.9",
+	"version": "4.2.10",
 	"cpu": [
 		"arm64"
 	],

crates/kreuzberg-node/npm/darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kreuzberg/node-darwin-x64",
-	"version": "4.2.9",
+	"version": "4.2.10",
 	"cpu": [
 		"x64"
 	],