perf: Faster evaluate

Signed-off-by: Dmitry Dygalo <[email protected]>

Author: Stranger6667

CHANGELOG.md

@@ -9,6 +9,7 @@
 ### Performance
 
 - `validate` and other APIs returning `Result<_, ValidationError>` are 5–10% faster in some workloads due to the smaller error handle.
+- `evaluate`: Eliminated deep clones of unmatched keyword values (e.g., `title`, `description`, `examples`) on every schema node evaluation by using `Arc` internally. Can be multiple times faster for schemas with large annotations.
 
 ## [0.36.0] - 2025-11-18
 

crates/jsonschema-py/CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Performance
 
 - `jsonschema_rs.validate()` and `Validator.validate()` run 5–10% faster in some workloads thanks to slimmer `ValidationError` objects.
+- `evaluate()`: Avoids copying annotation values on every schema node evaluation. Can be multiple times faster for schemas with large annotations like extensive `title`, `description`, or `examples` fields.
 
 ## [0.36.0] - 2025-11-18
 

crates/jsonschema/src/evaluation.rs

@@ -9,20 +9,26 @@ use std::{fmt, sync::Arc};
 
 /// Annotations associated with an output unit.
 #[derive(Debug, Clone, PartialEq)]
-pub struct Annotations(serde_json::Value);
+pub struct Annotations(Arc<serde_json::Value>);
 
 impl Annotations {
     /// Create a new `Annotations` instance.
     #[must_use]
     pub(crate) fn new(v: serde_json::Value) -> Self {
+        Annotations(Arc::new(v))
+    }
+
+    /// Create a new `Annotations` instance from an Arc.
+    #[must_use]
+    pub(crate) fn from_arc(v: Arc<serde_json::Value>) -> Self {
         Annotations(v)
     }
 
     /// Returns the inner [`serde_json::Value`] of the annotation.
     #[inline]
     #[must_use]
     pub fn into_inner(self) -> serde_json::Value {
-        self.0
+        Arc::try_unwrap(self.0).unwrap_or_else(|arc| (*arc).clone())
     }
 
     /// The `serde_json::Value` of the annotation.

crates/jsonschema/src/node.rs

@@ -478,7 +478,7 @@ impl Validate for SchemaNode {
                 } = *kvals;
                 let annotations: Option<Annotations> = unmatched_keywords
                     .as_ref()
-                    .map(|v| Annotations::new((**v).clone()));
+                    .map(|v| Annotations::from_arc(Arc::clone(v)));
                 Self::evaluate_subschemas(
                     instance,
                     location,