json_eval_rs/jsoneval/

dependents.rs

use super::JSONEval;
use crate::jsoneval::cancellation::CancellationToken;
use crate::jsoneval::json_parser;
use crate::jsoneval::path_utils;
use crate::jsoneval::path_utils::get_value_by_pointer_without_properties;
use crate::jsoneval::path_utils::normalize_to_json_pointer;
use crate::jsoneval::types::DependentItem;
use crate::rlogic::{LogicId, RLogic};
use crate::time_block;
use crate::utils::clean_float_noise_scalar;
use crate::EvalData;

use indexmap::IndexMap;
use serde_json::Value;

impl JSONEval {
    /// Evaluate fields that depend on a changed path.
    /// Processes all dependent fields transitively, then optionally performs a full
    /// re-evaluation pass (for read-only / hide effects) and cascades into subforms.
    pub fn evaluate_dependents(
        &mut self,
        changed_paths: &[String],
        data: Option<&str>,
        context: Option<&str>,
        re_evaluate: bool,
        token: Option<&CancellationToken>,
        mut canceled_paths: Option<&mut Vec<String>>,
        include_subforms: bool,
    ) -> Result<Value, String> {
        if let Some(t) = token {
            if t.is_cancelled() {
                return Err("Cancelled".to_string());
            }
        }
        let _lock = self.eval_lock.lock().unwrap();
        let _static_guard =
            self.engine.bind_static_arrays_scope(std::sync::Arc::clone(&self.static_arrays));
        let mut structural_change_data = None;

        // Update data if provided, diff versions
        if let Some(data_str) = data {
            let data_value = json_parser::parse_json_str(data_str)?;
            let context_value = if let Some(ctx) = context {
                json_parser::parse_json_str(ctx)?
            } else {
                Value::Object(serde_json::Map::new())
            };
            let old_data = self.eval_data.snapshot_data();
            time_block!("  [dep] data_replace_and_context", {
                self.eval_data
                    .replace_data_and_context(data_value, context_value);
            });
            let new_data = self.eval_data.snapshot_data();
            time_block!("  [dep] data_diff_versions", {
                self.eval_cache
                    .store_snapshot_and_diff_versions(&old_data, &new_data);
            });
            structural_change_data = Some((old_data, new_data));
        }

        // Drop the lock before calling sub-methods that need &mut self
        drop(_lock);

        // When a subform array changes structurally (items added/removed/reordered),
        // evict stale T2 global cache entries whose dep paths use the subform-local key
        // format that is never bumped by the parent-level diff.
        if let Some((old_data, new_data)) = structural_change_data {
            time_block!("  [dep] invalidate_subform_structural", {
                self.invalidate_subform_caches_on_structural_change(&old_data, &new_data);
            });
        }

        let mut result = Vec::new();
        let mut processed = std::collections::HashMap::new();
        let mut to_process: Vec<(String, bool, Option<Vec<usize>>)> = changed_paths
            .iter()
            .map(|path| {
                (
                    path_utils::dot_notation_to_schema_pointer(path),
                    false,
                    None,
                )
            })
            .collect();

        time_block!("  [dep] process_dependents_queue", {
            Self::process_dependents_queue(
                &self.engine,
                &self.evaluations,
                &mut self.eval_data,
                &mut self.eval_cache,
                &self.dependents_evaluations,
                &self.dep_formula_triggers,
                &self.evaluated_schema,
                &mut to_process,
                &mut processed,
                &mut result,
                token,
                canceled_paths.as_mut().map(|v| &mut **v),
            )?;
        });

        if re_evaluate {
            time_block!("  [dep] run_re_evaluate_pass", {
                self.run_re_evaluate_pass(
                    token,
                    &mut to_process,
                    &mut processed,
                    &mut result,
                    canceled_paths.as_mut().map(|v| &mut **v),
                )?;
            });
        }

        if include_subforms {
            // A collection changed path identifies no item index. Parent evaluation above has
            // prepared canonical state, so request a refresh for every concrete item. These
            // sentinels are consumed only by `run_subform_pass`; they are not field deltas.
            let collection_refresh_paths: Vec<String> = self
                .subforms
                .keys()
                .filter_map(|subform_path| {
                    let dot_path = path_utils::pointer_to_dot_notation(subform_path)
                        .replace(".properties.", ".");
                    let collection_changed = changed_paths
                        .iter()
                        .any(|path| path == &dot_path || path == &subform_field_key(subform_path));
                    collection_changed.then(|| {
                        let data_path = path_utils::schema_path_to_data_pointer(subform_path);
                        self.eval_data
                            .data()
                            .pointer(&data_path)
                            .and_then(Value::as_array)
                            .map(|items| {
                                (0..items.len())
                                    .map(|idx| format!("{dot_path}.{idx}"))
                                    .collect::<Vec<_>>()
                            })
                    })
                })
                .flatten()
                .flatten()
                .collect();

            // Augment changed_paths with every subform item field already written into result
            // by the dependents queue and re-evaluate pass. Without this, when a main-form
            // dependent rule writes to e.g. `items.0.benefit`, that path never appears in
            // `item_changed_paths` inside run_subform_pass → the item is skipped → the
            // subform item's own `benefit.dependents` never fire.
            let extended_paths: Vec<String> = {
                let mut paths = changed_paths.to_vec();
                for item in &result {
                    if let Some(ref_val) = item.get("$ref").and_then(|v| v.as_str()) {
                        let s = ref_val.to_string();
                        if !paths.contains(&s) {
                            paths.push(s);
                        }
                    }
                }
                paths.extend(collection_refresh_paths);
                paths
            };
            let subform_invalidated_tables = time_block!("  [dep] run_subform_pass", {
                self.run_subform_pass(
                    &extended_paths,
                    changed_paths,
                    re_evaluate,
                    token,
                    &mut result,
                )
            })?;

            // Refresh parent values after subform invalidates T2 tables.
            if subform_invalidated_tables {
                let _lock2 = self.eval_lock.lock().unwrap();
                drop(_lock2);
                self.evaluate_internal(None, token)?;

                // Refresh subform computed values with updated T2 tables.
                self.run_subform_pass(&[], &[], true, token, &mut result)?;

                // Patch the whole-array entry in result with the post-pass eval_data snapshot.
                for (subform_path, _) in &self.subforms {
                    let data_ptr = path_utils::schema_path_to_data_pointer(subform_path);
                    let data_ptr_str = data_ptr.to_string();
                    let dot_path = data_ptr_str.trim_start_matches('/').replace('/', ".");

                    if let Some(fresh_val) = self.eval_data.get(&data_ptr_str) {
                        let mut patched = false;
                        for item in result.iter_mut() {
                            if item
                                .get("$ref")
                                .and_then(|r| r.as_str())
                                .map(|r| r == dot_path)
                                .unwrap_or(false)
                            {
                                if let Some(map) = item.as_object_mut() {
                                    map.remove("clear");
                                    map.insert("value".to_string(), fresh_val.clone());
                                }
                                patched = true;
                                break;
                            }
                        }
                        if !patched {
                            let mut obj = serde_json::Map::new();
                            obj.insert("$ref".to_string(), serde_json::Value::String(dot_path));
                            obj.insert("value".to_string(), fresh_val.clone());
                            result.push(serde_json::Value::Object(obj));
                        }
                    }
                }
            }
        }

        // Deduplicate by $ref — keep the last entry for each path.
        // Multiple passes (dependents queue, re-evaluate, subform) may independently emit
        // the same $ref when cache versions cause overlapping detections. The subform pass
        // result is most specific and wins because it is appended last.
        let deduped = {
            let mut seen = std::collections::HashSet::new();
            let mut deduped = Vec::with_capacity(result.len());
            for item in result.into_iter().rev() {
                if let Some(r) = item.get("$ref").and_then(|v| v.as_str()) {
                    if seen.insert(r.to_string()) {
                        deduped.push(item);
                    }
                } else {
                    deduped.push(item);
                }
            }
            deduped.reverse();
            deduped
        };

        // Preserve post-dependents parent snapshot (O(1) Arc clone).
        if self.eval_cache.active_item_index.is_none() {
            let current_snapshot = self.eval_data.snapshot_data();
            self.eval_cache.main_form_snapshot = Some(current_snapshot);
        }

        Ok(Value::Array(deduped))
    }

    /// Full re-evaluation pass: runs `evaluate_internal`, then applies read-only fixes and
    /// recursive hide effects, feeding any newly-generated changes back into the dependents queue.
    fn run_re_evaluate_pass(
        &mut self,
        token: Option<&CancellationToken>,
        to_process: &mut Vec<(String, bool, Option<Vec<usize>>)>,
        processed: &mut std::collections::HashMap<String, Option<std::collections::HashSet<usize>>>,
        result: &mut Vec<Value>,
        mut canceled_paths: Option<&mut Vec<String>>,
    ) -> Result<(), String> {
        // --- Schema Default Value Pass (Before Eval) ---
        self.run_schema_default_value_pass(
            token,
            to_process,
            processed,
            result,
            canceled_paths.as_mut().map(|v| &mut **v),
        )?;

        // Resolve the correct data_versions tracker before snapshotting.
        // When active_item_index is Some(idx), evaluate_internal bumps
        // subform_caches[idx].data_versions — NOT the main data_versions.
        // Using the main tracker for both snapshot and post-eval lookup would make
        // old_ver == new_ver always, so no changed values would ever be emitted.
        let pre_eval_versions = if let Some(idx) = self.eval_cache.active_item_index {
            self.eval_cache
                .subform_caches
                .get(&idx)
                .map(|c| c.data_versions.clone())
                .unwrap_or_else(|| self.eval_cache.data_versions.clone())
        } else {
            self.eval_cache.data_versions.clone()
        };

        self.evaluate_internal(None, token)?;

        // First evaluation can reveal a field that was hidden when the initial
        // default pass ran (e.g. conditional fields revealed after a flag is enabled). Materialize
        // that newly visible static default, then recalculate formulas which
        // consume it. Defaults remain non-triggering: only caller paths enter
        // the dependent queue.
        if self.run_schema_default_value_pass(
            token,
            to_process,
            processed,
            result,
            canceled_paths.as_mut().map(|v| &mut **v),
        )? {
            self.evaluate_internal(None, token)?;
        }

        // Emit result entries for every sorted-evaluation whose version uniquely bumped.
        let active_idx = self.eval_cache.active_item_index;
        for eval_key in self.sorted_evaluations.iter().flatten() {
            if eval_key.contains("/$params/") || eval_key.contains("/$") {
                continue;
            }

            let schema_ptr = path_utils::schema_path_to_data_pointer(eval_key);
            let data_path = schema_ptr.trim_start_matches('/').to_string();

            let version_path = format!("/{}", data_path);
            let old_ver = pre_eval_versions.get(&version_path);
            let new_ver = if let Some(idx) = active_idx {
                self.eval_cache
                    .subform_caches
                    .get(&idx)
                    .map(|c| c.data_versions.get(&version_path))
                    .unwrap_or_else(|| self.eval_cache.data_versions.get(&version_path))
            } else {
                self.eval_cache.data_versions.get(&version_path)
            };

            if new_ver > old_ver {
                if let Some(new_val) = self.evaluated_schema.pointer(&schema_ptr) {
                    let dot_path = data_path.trim_end_matches("/value").replace('/', ".");
                    let mut obj = serde_json::Map::new();
                    obj.insert("$ref".to_string(), Value::String(dot_path));
                    let is_clear = new_val == &Value::Null || new_val.as_str() == Some("");
                    if is_clear {
                        obj.insert("clear".to_string(), Value::Bool(true));
                    } else {
                        obj.insert("value".to_string(), new_val.clone());
                    }
                    result.push(Value::Object(obj));
                }
            }
        }

        // --- Read-Only Pass ---
        let mut readonly_changes = Vec::new();
        let mut readonly_values = Vec::new();
        for path in self.conditional_readonly_fields.iter() {
            let normalized = path_utils::normalize_to_json_pointer(path);
            if let Some(schema_el) = self.evaluated_schema.pointer(&normalized) {
                self.check_readonly_for_dependents(
                    schema_el,
                    path,
                    &mut readonly_changes,
                    &mut readonly_values,
                );
            }
        }
        // Captured before draining into to_process — !to_process.is_empty() would also
        // fire for entries from earlier passes, triggering a spurious second evaluate_internal.
        let had_actual_readonly_changes = !readonly_changes.is_empty();

        // Subform root arrays need special treatment: writing the full schema array into
        // eval_data would overwrite computed nested fields (e.g. loading_benefit.first_prem)
        // with the stale snapshot from evaluated_schema (computed before the T2 table refresh).
        // Instead, merge only primitive/scalar item fields (sa, code, prem_pay_period, etc.),
        // leaving nested objects intact so run_subform_pass sees the correct old/new diff.
        let subform_data_paths: std::collections::HashSet<String> = self
            .subforms
            .keys()
            .map(|p| {
                path_utils::schema_path_to_data_pointer(p)
                    .replace("/value/", "/")
                    .to_string()
            })
            .collect();

        for (path, schema_value) in readonly_changes {
            let data_path = path_utils::schema_path_to_data_pointer(&path).replace("/value/", "/");

            if subform_data_paths.contains(&data_path) {
                // Per-item scalar merge: propagate input fields without touching computed objects.
                if let (Value::Array(schema_items), Some(Value::Array(existing_items))) = (
                    &schema_value,
                    self.eval_data.data().pointer(&data_path).cloned().as_ref(),
                ) {
                    let mut merged_items = existing_items.clone();
                    for (i, schema_item) in schema_items.iter().enumerate() {
                        if let (Some(existing), Value::Object(schema_map)) =
                            (merged_items.get_mut(i), schema_item)
                        {
                            if let Some(existing_map) = existing.as_object_mut() {
                                for (k, v) in schema_map {
                                    if !v.is_object() {
                                        existing_map.insert(k.clone(), v.clone());
                                    }
                                }
                            }
                        } else if i >= merged_items.len() {
                            merged_items.push(schema_item.clone());
                        }
                    }
                    self.eval_data.set(&data_path, Value::Array(merged_items));
                } else {
                    self.eval_data.set(&data_path, schema_value.clone());
                }
                self.eval_cache.bump_data_version(&data_path);
                to_process.push((path, true, None));
                continue;
            }

            self.eval_data.set(&data_path, schema_value.clone());
            self.eval_cache.bump_data_version(&data_path);
            to_process.push((path, true, None));
        }
        // A readonly write can change input to a cached `$params` table. Refresh only when
        // one of those tables depends on a field written by this pass. `to_process` stores
        // schema paths with `#`; dependency metadata stores the same paths without it.
        // Do not use `!to_process.is_empty()`: entries from earlier passes would cause an
        // unnecessary full evaluation even when this pass wrote no relevant readonly field.
        if had_actual_readonly_changes {
            let readonly_dep_prefixes: Vec<String> = to_process
                .iter()
                .map(|(path, _, _)| path.trim_start_matches('#').to_string())
                .collect();
            let params_table_keys: Vec<String> = self
                .table_metadata
                .keys()
                .filter(|key| key.starts_with("#/$params"))
                .filter(|key| {
                    self.dependencies
                        .get(*key)
                        .map(|deps| {
                            deps.iter().any(|dep| {
                                readonly_dep_prefixes.iter().any(|readonly| {
                                    dep == readonly
                                        || dep
                                            .strip_prefix(readonly)
                                            .is_some_and(|suffix| suffix.starts_with('/'))
                                })
                            })
                        })
                        .unwrap_or(false)
                })
                .cloned()
                .collect();

            if !params_table_keys.is_empty() {
                if let Some(active_idx) = self.eval_cache.active_item_index {
                    self.eval_cache
                        .invalidate_params_tables_for_item(active_idx, &params_table_keys);
                }
                self.evaluate_internal(None, token)?;

                // The first readonly snapshot predates the table refresh. Re-read readonly
                // values so dependent response patches reflect refreshed derived values (for
                // example derived fee after selecting a table row).
                readonly_values.clear();
                for path in self.conditional_readonly_fields.iter() {
                    let normalized = path_utils::normalize_to_json_pointer(path);
                    if let Some(schema_el) = self.evaluated_schema.pointer(&normalized) {
                        self.check_readonly_for_dependents(
                            schema_el,
                            path,
                            &mut Vec::new(),
                            &mut readonly_values,
                        );
                    }
                }
            }
        }

        for (path, schema_value) in readonly_values {
            let data_path = path_utils::schema_path_to_data_pointer(&path).replace("/value/", "/");
            let mut obj = serde_json::Map::new();
            obj.insert(
                "$ref".to_string(),
                Value::String(path_utils::pointer_to_dot_notation(&data_path)),
            );
            obj.insert("$readonly".to_string(), Value::Bool(true));
            let is_clear = schema_value == Value::Null || schema_value.as_str() == Some("");
            if is_clear {
                obj.insert("clear".to_string(), Value::Bool(true));
            } else {
                obj.insert("value".to_string(), schema_value);
            }
            result.push(Value::Object(obj));
        }

        if !to_process.is_empty() {
            Self::process_dependents_queue(
                &self.engine,
                &self.evaluations,
                &mut self.eval_data,
                &mut self.eval_cache,
                &self.dependents_evaluations,
                &self.dep_formula_triggers,
                &self.evaluated_schema,
                to_process,
                processed,
                result,
                token,
                canceled_paths.as_mut().map(|v| &mut **v),
            )?;
        }

        // --- Recursive Hide Pass ---
        // Rebuild layout refs from current evaluated_schema. Unlike mutable legacy JS
        // objects, Rust resolved refs are copies, so inherited visibility must stay
        // per-run state rather than be written back into the source schema.
        self.ensure_layout_resolved();

        let mut hidden_fields = Vec::new();
        for path in self.conditional_hidden_fields.iter() {
            let normalized = path_utils::normalize_to_json_pointer(path);
            if let Some(schema_el) = self.evaluated_schema.pointer(&normalized) {
                self.check_hidden_field(schema_el, path, &mut hidden_fields);
            }
        }
        let layout_condition_hidden_refs = {
            let state = self.layout_state.read().unwrap();
            state.layout_condition_hidden_refs.clone()
        };
        for path in layout_condition_hidden_refs.iter() {
            if let Some(schema_el) = self.evaluated_schema.pointer(path) {
                self.check_effectively_hidden_field(schema_el, path, &mut hidden_fields);
            }
        }
        hidden_fields.sort();
        hidden_fields.dedup();
        if !hidden_fields.is_empty() {
            Self::recursive_hide_effect(
                &self.engine,
                &self.evaluations,
                &self.reffed_by,
                &mut self.eval_data,
                &mut self.eval_cache,
                hidden_fields,
                to_process,
                result,
            );
        }
        if !to_process.is_empty() {
            Self::process_dependents_queue(
                &self.engine,
                &self.evaluations,
                &mut self.eval_data,
                &mut self.eval_cache,
                &self.dependents_evaluations,
                &self.dep_formula_triggers,
                &self.evaluated_schema,
                to_process,
                processed,
                result,
                token,
                canceled_paths.as_mut().map(|v| &mut **v),
            )?;
        }

        Ok(())
    }

    /// Collect visible primitive schema values missing from input.
    fn collect_visible_static_defaults(&self) -> Vec<(String, Value, String)> {
        let mut defaults = Vec::new();

        for eval_key in self.value_evaluations.iter() {
            let clean_key = eval_key.strip_prefix('#').unwrap_or(eval_key);

            // Exclude rules.*.value, options.*.value, and $params
            if clean_key.starts_with("/$params")
                || (clean_key.ends_with("/value")
                    && (clean_key.contains("/rules/") || clean_key.contains("/options/")))
            {
                continue;
            }

            let schema_path = clean_key.strip_suffix("/value").unwrap_or(&clean_key);
            if self.is_schema_effective_hidden(schema_path) {
                continue;
            }

            let dotted_path = clean_key
                .replace("/properties", "")
                .replace("/value", "")
                .trim_start_matches('/')
                .replace('/', ".");

            if dotted_path.is_empty() {
                continue;
            }

            let schema_val = match self.resolve_static_markers_at_path(clean_key) {
                Some(v) => crate::utils::clean_float_noise(v),
                None => continue,
            };

            let schema_ptr = path_utils::dot_notation_to_schema_pointer(&dotted_path);
            if let Some(Value::Object(schema_node)) = self
                .evaluated_schema
                .pointer(schema_ptr.trim_start_matches('#'))
            {
                if let Some(Value::Object(condition)) = schema_node.get("condition") {
                    if let Some(hidden_val) = condition.get("hidden") {
                        if !hidden_val.is_boolean() || hidden_val.as_bool() == Some(true) {
                            continue;
                        }
                    }
                }
            }

            let data_path = dotted_path.replace('.', "/");
            let current_data = self
                .eval_data
                .data()
                .pointer(&format!("/{}", data_path))
                .unwrap_or(&Value::Null);
            let is_empty = matches!(current_data, Value::Null)
                || matches!(current_data, Value::String(s) if s.is_empty());
            let is_schema_val_empty = matches!(schema_val, Value::Null)
                || matches!(schema_val, Value::String(ref s) if s.is_empty())
                || matches!(schema_val, Value::Object(ref map) if map.contains_key("$evaluation"));

            if is_empty && !is_schema_val_empty && current_data != &schema_val {
                defaults.push((data_path, schema_val, dotted_path));
            }
        }

        defaults
    }

    pub(crate) fn apply_visible_static_defaults(&mut self) -> bool {
        let defaults = self.collect_visible_static_defaults();
        for (data_path, schema_val, _) in &defaults {
            self.eval_data
                .set(&format!("/{}", data_path), schema_val.clone());
            self.eval_cache
                .bump_data_version(&format!("/{}", data_path));
        }
        !defaults.is_empty()
    }

    /// Apply missing visible static defaults and process their declared dependents.
    ///
    /// Used by indexed subform evaluation after its first formula/visibility pass. The
    /// initial pass determines which defaults are visible; this pass writes only missing
    /// primitive defaults, then lets their dependent graph override them if necessary.
    pub(crate) fn apply_visible_static_defaults_with_dependents(
        &mut self,
        token: Option<&CancellationToken>,
    ) -> Result<bool, String> {
        let mut to_process = Vec::new();
        let mut processed = std::collections::HashMap::new();
        let mut result = Vec::new();
        self.run_schema_default_value_pass(
            token,
            &mut to_process,
            &mut processed,
            &mut result,
            None,
        )
    }

    /// Internal method to run the schema default value pass.
    /// Filters for only primitive schema values (not $evaluation objects).
    fn run_schema_default_value_pass(
        &mut self,
        _token: Option<&CancellationToken>,
        _to_process: &mut Vec<(String, bool, Option<Vec<usize>>)>,
        _processed: &mut std::collections::HashMap<
            String,
            Option<std::collections::HashSet<usize>>,
        >,
        result: &mut Vec<Value>,
        _canceled_paths: Option<&mut Vec<String>>,
    ) -> Result<bool, String> {
        let default_value_changes = self.collect_visible_static_defaults();
        if default_value_changes.is_empty() {
            return Ok(false);
        }

        for (data_path, schema_val, dot_path) in default_value_changes {
            self.eval_data
                .set(&format!("/{}", data_path), schema_val.clone());
            self.eval_cache
                .bump_data_version(&format!("/{}", data_path));

            let mut change_obj = serde_json::Map::new();
            change_obj.insert("$ref".to_string(), Value::String(dot_path));
            let is_clear = schema_val == Value::Null || schema_val.as_str() == Some("");
            if is_clear {
                change_obj.insert("clear".to_string(), Value::Bool(true));
            } else {
                change_obj.insert("value".to_string(), schema_val);
            }
            result.push(Value::Object(change_obj));

            // Apply defaults in every evaluation lifecycle, but do not treat a
            // synthesized value as a caller-originated dependency event. Schema
            // expressions still observe the initialized value; paths supplied by
            // the caller remain the only inputs to dependent propagation.
        }

        Ok(true)
    }

    /// Cascade dependency evaluation into each subform item.
    ///
    /// For every registered subform, this method iterates over its array items and runs
    /// `evaluate_dependents` on the subform using the cache-swap strategy so the subform
    /// can see global main-form Tier 2 cache entries (avoiding redundant table re-evaluation).
    ///
    /// `sub_re_evaluate` is set **only** when the parent's bumped `data_versions` intersect
    /// with paths the subform actually depends on — preventing expensive full re-evals on
    /// subform items whose dependencies did not change.
    fn run_subform_pass(
        &mut self,
        changed_paths: &[String],
        parent_changed_paths: &[String],
        _re_evaluate: bool,
        token: Option<&CancellationToken>,
        result: &mut Vec<Value>,
    ) -> Result<bool, String> {
        let mut any_table_invalidated = false;
        // Collect subform paths once (avoids holding borrow on self.subforms during mutation)
        let subform_paths: Vec<String> = self.subforms.keys().cloned().collect();

        for subform_path in subform_paths {
            let field_key = subform_field_key(&subform_path);
            // Compute dotted path and prefix strings once per subform, not per item
            let subform_dot_path =
                path_utils::pointer_to_dot_notation(&subform_path).replace(".properties.", ".");
            let field_prefix = format!("{}.", field_key);
            let subform_ptr = normalize_to_json_pointer(&subform_path);

            // Borrow only the item count first — avoid cloning the full array
            let item_count =
                get_value_by_pointer_without_properties(self.eval_data.data(), &subform_ptr)
                    .and_then(|v| v.as_array())
                    .map(|a| a.len())
                    .unwrap_or(0);

            if item_count == 0 {
                continue;
            }

            // Evict stale per-item caches for indices that no longer exist in the array.
            // This prevents memory leaks when items are removed and the array shrinks.
            self.eval_cache.prune_subform_caches(item_count);

            // Snapshot the parent's version trackers once, before iterating any subform items.
            // Using the live `parent_cache.data_versions` inside the loop would let item N's
            // evaluation bumps contaminate the merge_from baseline for item M (M ≠ N),
            // causing cache misses and wrong re-evaluations on subsequent visits to item M.
            let parent_data_versions_snapshot = self.eval_cache.data_versions.clone();
            let parent_params_versions_snapshot = self.eval_cache.params_versions.clone();

            // Project parent changes into directly dependent subform value formulas. This is
            // graph-driven: no product/field path policy belongs in evaluator code. Tables
            // remain excluded because evaluating a `$params` table with one item payload can
            // overwrite shared parent cache rows.
            let mut parent_affected: std::collections::HashSet<String> = parent_changed_paths
                .iter()
                .filter(|path| {
                    !path.starts_with(&subform_dot_path)
                        && !path.starts_with(&field_prefix)
                        && !path.starts_with(&format!("{}.", field_key))
                })
                .map(|path| {
                    path_utils::dot_notation_to_schema_pointer(path)
                        .trim_start_matches('#')
                        .trim_start_matches('/')
                        .to_string()
                })
                .collect();


            // Transitively expand parent_affected through self.dependencies
            // (e.g. parent_field -> lookup_table -> subform_field)
            let mut queue: std::collections::VecDeque<String> =
                parent_affected.iter().cloned().collect();
            while let Some(current) = queue.pop_front() {
                for (target, deps) in self.dependencies.iter() {
                    let clean_target = target.trim_start_matches('#').trim_start_matches('/');
                    if !parent_affected.contains(clean_target) {
                        let is_affected = deps.iter().any(|dep| {
                            let clean_dep = dep.trim_start_matches('#').trim_start_matches('/');
                            clean_dep == current
                                || (current.starts_with(clean_dep)
                                    && current.as_bytes().get(clean_dep.len()) == Some(&b'/'))
                        });
                        if is_affected {
                            let target_str = clean_target.to_string();
                            parent_affected.insert(target_str.clone());
                            queue.push_back(target_str);
                        }
                    }
                }
            }

            let dependent_value_paths: Vec<String> = self
                .subforms
                .get(&subform_path)
                .map(|subform| {
                    subform
                        .dependencies
                        .iter()
                        .filter(|(key, deps)| {
                            !subform.table_metadata.contains_key(*key)
                                && !key.starts_with("#/$params/")
                                && key.ends_with("/value")
                                && deps.iter().any(|dep| {
                                    let clean_dep = dep.trim_start_matches('#').trim_start_matches('/');
                                    parent_affected.contains(clean_dep)
                                        || parent_affected.iter().any(|p| {
                                            p.starts_with(clean_dep)
                                                && p.as_bytes().get(clean_dep.len()) == Some(&b'/')
                                        })
                                })
                        })
                        .map(|(key, _)| key.clone())
                        .collect()
                })
                .unwrap_or_default();

            // Detect table-backed outputs downstream of parent-derived subform values once per subform.
            let refresh_table_outputs = self
                .subforms
                .get(&subform_path)
                .map(|subform| {
                    dependent_value_paths.iter().any(|source| {
                        let source_clean = source.trim_end_matches("/value").trim_start_matches('#');
                        let affected_tables: Vec<&String> = subform
                            .table_metadata
                            .keys()
                            .filter(|table| table.starts_with("#/$params"))
                            .filter(|table| {
                                subform.dependencies.get(*table).is_some_and(|deps| {
                                    deps.iter().any(|dep| dep.trim_start_matches('#') == source_clean)
                                })
                            })
                            .collect();

                        !affected_tables.is_empty()
                            && subform.evaluations.iter().any(|(target, _)| {
                                target.ends_with("/value")
                                    && subform.dependencies.get(target).is_some_and(|deps| {
                                        deps.iter().any(|dep| {
                                            affected_tables.iter().any(|table| {
                                                dep.trim_start_matches('#')
                                                    == table.trim_start_matches('#')
                                            })
                                        })
                                    })
                            })
                    })
                })
                .unwrap_or(false);

            // Sync parent params and static arrays to subform once before the item loop
            if let Some(subform) = self.subforms.get_mut(&subform_path) {
                if let Some(params) = self.evaluated_schema.pointer("/$params") {
                    if let Some(sub_params) = subform.evaluated_schema.pointer_mut("/$params") {
                        *sub_params = params.clone();
                    }
                }
                subform.static_arrays = std::sync::Arc::clone(&self.static_arrays);
                subform.engine.set_static_arrays(std::sync::Arc::clone(&subform.static_arrays));
            }

            for idx in 0..item_count {
                // Map absolute changed paths → subform-internal paths for this item index
                let prefix_dot = format!("{}.{}.", subform_dot_path, idx);
                let prefix_bracket = format!("{}[{}].", subform_dot_path, idx);
                let prefix_field_bracket = format!("{}[{}].", field_key, idx);

                let is_collection_refresh = changed_paths
                    .iter()
                    .any(|path| path == &format!("{subform_dot_path}.{idx}"));
                let item_changed_paths: Vec<String> = changed_paths
                    .iter()
                    .filter_map(|p| {
                        if p == &format!("{subform_dot_path}.{idx}") {
                            Some(field_key.clone())
                        } else if p.starts_with(&prefix_bracket) {
                            Some(p.replacen(&prefix_bracket, &field_prefix, 1))
                        } else if p.starts_with(&prefix_dot) {
                            Some(p.replacen(&prefix_dot, &field_prefix, 1))
                        } else if p.starts_with(&prefix_field_bracket) {
                            Some(p.replacen(&prefix_field_bracket, &field_prefix, 1))
                        } else {
                            None
                        }
                    })
                    .collect();

                // Build minimal merged data: clone only item at idx, share $params shallowly.
                // This avoids cloning the full 5MB parent payload for every item.
                let item_val =
                    get_value_by_pointer_without_properties(self.eval_data.data(), &subform_ptr)
                        .and_then(|v| v.as_array())
                        .and_then(|a| a.get(idx))
                        .cloned()
                        .unwrap_or(Value::Null);

                if item_changed_paths.is_empty() && !dependent_value_paths.is_empty() {
                    // Parent-only changes need an item-local overlay. Computed item values must
                    // be visible to their own `dependents` (for example a toggle flag clearing
                    // dependent subform fields), but publishing into parent eval_data or its cache
                    // makes later item/table passes observe a synthetic input change.
                    let parent_cache = std::mem::take(&mut self.eval_cache);
                    let mut overlay_cache = parent_cache.clone();
                    overlay_cache.ensure_active_item_cache(idx);
                    if let Some(item_cache) = overlay_cache.subform_caches.get_mut(&idx) {
                        // T1 checks use item versions, not parent versions. Merge parent changes
                        // into disposable overlay state so relation-driven formulas cannot reuse
                        // an earlier item result from cache.
                        item_cache
                            .data_versions
                            .merge_from(&parent_data_versions_snapshot);
                        item_cache
                            .data_versions
                            .merge_from_params(&parent_params_versions_snapshot);
                    }
                    overlay_cache.set_active_item(idx);
                    let canonical_root =
                        path_utils::schema_path_to_data_pointer(&subform_path).into_owned();
                    let scope = crate::jsoneval::subform_scope::SubformScope::new(
                        &subform_path,
                        &canonical_root,
                        Some(idx),
                    );
                    let mut scoped_view = scope.evaluation_view(self.eval_data.data());
                    if let Some(view) = scoped_view.as_object_mut() {
                        view.insert(
                            "$context".to_string(),
                            self.eval_data
                                .data()
                                .get("$context")
                                .cloned()
                                .unwrap_or(Value::Null),
                        );
                    }
                    let subform = self
                        .subforms
                        .get_mut(&subform_path)
                        .expect("subform exists");
                    subform.eval_data = EvalData::new(scoped_view);
                    std::mem::swap(&mut subform.eval_cache, &mut overlay_cache);
                    subform.evaluate_internal(Some(&dependent_value_paths), token)?;

                    let mut overlay_result = Vec::new();
                    let mut overlay_queue = Vec::new();
                    let mut overlay_processed = std::collections::HashMap::new();
                    for formula_path in &dependent_value_paths {
                        let schema_path = path_utils::normalize_to_json_pointer(formula_path);
                        let data_path = path_utils::schema_path_to_data_pointer(formula_path)
                            .replace("/value", "");
                        let Some(value) = subform.evaluated_schema.pointer(&schema_path).cloned()
                        else {
                            continue;
                        };

                        // Make this computed value available only to direct dependent formulas.
                        // The overlay is discarded below, but its version must still advance: the
                        // re-evaluation pass uses it to invalidate formulas and tables derived
                        // from this value (for example calculated fee after an input changes).
                        let source_path = formula_path.trim_end_matches("/value").to_string();
                        if subform.eval_data.get(&data_path) != Some(&value) {
                            subform.eval_data.set(&data_path, value.clone());
                            subform
                                .eval_data
                                .set(&scope.canonical_path(&data_path), value.clone());
                            subform.eval_cache.bump_data_version(&data_path);
                        }
                        overlay_queue.push((source_path, true, None));

                        let mut change = serde_json::Map::new();
                        let field = data_path
                            .trim_start_matches('/')
                            .trim_end_matches("/value")
                            .replace('/', ".");
                        let field = field.strip_prefix(&field_prefix).unwrap_or(&field);
                        change.insert(
                            "$ref".to_string(),
                            Value::String(format!("{}.{}.{}", subform_dot_path, idx, field)),
                        );
                        if value == Value::Null || value.as_str() == Some("") {
                            change.insert("clear".to_string(), Value::Bool(true));
                        } else {
                            change.insert("value".to_string(), value);
                        }
                        result.push(Value::Object(change));
                    }


                    Self::process_dependents_queue(
                        &subform.engine,
                        &subform.evaluations,
                        &mut subform.eval_data,
                        &mut subform.eval_cache,
                        &subform.dependents_evaluations,
                        &subform.dep_formula_triggers,
                        &subform.evaluated_schema,
                        &mut overlay_queue,
                        &mut overlay_processed,
                        &mut overlay_result,
                        token,
                        None,
                    )?;

                    // Dependents write local aliases. Synchronize active item before tables
                    // resolve absolute parent paths inside this disposable overlay.
                    let local_item_path = format!("/{field_key}");
                    if let Some(local_item) = subform.eval_data.get(&local_item_path).cloned() {
                        subform
                            .eval_data
                            .set(&scope.canonical_path(&local_item_path), local_item);
                    }

                    if refresh_table_outputs {
                        subform.run_re_evaluate_pass(
                            token,
                            &mut overlay_queue,
                            &mut overlay_processed,
                            &mut overlay_result,
                            None,
                        )?;
                    }

                    for change in overlay_result {
                        let Some(object) = change.as_object() else {
                            continue;
                        };
                        let Some(Value::String(ref_path)) = object.get("$ref") else {
                            continue;
                        };
                        let local_ref = ref_path.strip_prefix(&field_prefix).unwrap_or(ref_path);
                        let mut mapped = object.clone();
                        mapped.insert(
                            "$ref".to_string(),
                            Value::String(format!("{}.{}.{}", subform_dot_path, idx, local_ref)),
                        );
                        result.push(Value::Object(mapped));
                    }

                    // Restore subform's durable cache and discard overlay mutations. Keep the
                    // parent's cache byte-for-byte unchanged for remaining items/tables.
                    std::mem::swap(&mut subform.eval_cache, &mut overlay_cache);
                    self.eval_cache = parent_cache;
                    continue;
                }

                let canonical_root =
                    path_utils::schema_path_to_data_pointer(&subform_path).into_owned();
                let scope = crate::jsoneval::subform_scope::SubformScope::new(
                    &subform_path,
                    &canonical_root,
                    Some(idx),
                );
                let mut scoped_view = scope.evaluation_view(self.eval_data.data());
                if let Some(view) = scoped_view.as_object_mut() {
                    view.insert(
                        "$context".to_string(),
                        self.eval_data
                            .data()
                            .get("$context")
                            .cloned()
                            .unwrap_or(Value::Null),
                    );
                }
                let Some(subform) = self.subforms.get_mut(&subform_path) else {
                    continue;
                };

                // Parent-only re-evaluation already refreshes global `$params` tables and main-form
                // readonly values. Re-running every subform can evaluate a table with the transient
                // parent state (for example a cleared `prem_pay_period`) and overwrite fresh global
                // rows with an empty table. Only item-specific changed paths re-evaluate subforms.
                let sub_re_evaluate = !item_changed_paths.is_empty();
                if !sub_re_evaluate && item_changed_paths.is_empty() {
                    continue;
                }

                // Prepare cache state for this item
                self.eval_cache.ensure_active_item_cache(idx);
                let old_item_val = {
                    let snapshot = self
                        .eval_cache
                        .subform_caches
                        .get(&idx)
                        .map(|c| c.item_snapshot.clone())
                        .unwrap_or(Value::Null);

                    if snapshot == Value::Null {
                        if let Some(main_snap) = &self.eval_cache.main_form_snapshot {
                            get_value_by_pointer_without_properties(main_snap, &subform_ptr)
                                .and_then(|v| v.as_array())
                                .and_then(|a| a.get(idx))
                                .cloned()
                                .unwrap_or(Value::Null)
                        } else {
                            Value::Null
                        }
                    } else {
                        snapshot
                    }
                };

                subform.eval_data = EvalData::new(scoped_view);
                let new_item_val = item_val.clone();

                // Cache-swap: lend parent cache to subform
                let mut parent_cache = std::mem::take(&mut self.eval_cache);
                parent_cache.ensure_active_item_cache(idx);

                // Snapshot item data_versions BEFORE the diff so we can detect which paths
                // are newly bumped by this specific diff pass (vs historical bumps from prior calls).
                let pre_diff_item_versions = parent_cache
                    .subform_caches
                    .get(&idx)
                    .map(|c| c.data_versions.clone());

                if let Some(c) = parent_cache.subform_caches.get_mut(&idx) {
                    // Merge all data versions from the parent snapshot. We must include non-$params
                    // paths so that parent field updates correctly
                    // invalidate subform per-item cache entries that depend on them.
                    c.data_versions.merge_from(&parent_data_versions_snapshot);
                    // Always reflect the latest $params (schema-level, index-independent).
                    c.data_versions
                        .merge_from_params(&parent_params_versions_snapshot);
                    if !is_collection_refresh {
                        crate::jsoneval::eval_cache::diff_and_update_versions(
                            &mut c.data_versions,
                            &format!("/{}", field_key),
                            &old_item_val,
                            &new_item_val,
                            "run_subform_pass_diff_and_update_versions",
                        );
                    }
                    // Parent evaluation prepared this item before the refresh. Its computed
                    // leaves establish the cache baseline, not a subform item input mutation.
                    c.item_snapshot = new_item_val;
                }


                // Invalidate stale T2 $params table entries whose deps overlap any path newly
                //
                // These tables MUST be re-evaluated by the subform engine (not here) because
                // their formulas read subform-local paths which
                // only resolve correctly when the active item is injected under the subform key.
                {
                    let field_prefix_slash = format!("/{}/", field_key);
                    let newly_bumped_schema_paths: Vec<String> = if let (Some(ref pre), Some(c)) = (
                        &pre_diff_item_versions,
                        parent_cache.subform_caches.get(&idx),
                    ) {
                        c.data_versions
                            .versions()
                            .filter(|(k, &v)| k.starts_with(&field_prefix_slash) && v > pre.get(k))
                            .map(|(k, _)| {
                                // Convert data-version path (e.g. /items/prop) to schema dep
                                // format (e.g. /items/properties/prop) for dep matching against
                                // self.dependencies, which stores paths WITHOUT the '#' prefix.
                                let sub = k.trim_start_matches(&field_prefix_slash);
                                format!(
                                    "/{}/properties/{}",
                                    field_key,
                                    sub.replace('/', "/properties/")
                                )
                            })
                            .collect()
                    } else {
                        Vec::new()
                    };

                    if !newly_bumped_schema_paths.is_empty() {
                        let params_table_keys: Vec<String> = self
                            .table_metadata
                            .keys()
                            .filter(|k| k.starts_with("#/$params"))
                            .filter(|k| {
                                self.dependencies
                                    .get(*k)
                                    .map(|deps| {
                                        deps.iter().any(|dep| {
                                            let clean_dep = dep.trim_start_matches('#');
                                            newly_bumped_schema_paths
                                                .iter()
                                                .any(|b| {
                                                    let clean_b = b.trim_start_matches('#');
                                                    clean_dep == clean_b
                                                        || clean_dep.starts_with(clean_b)
                                                        || b == dep
                                                        || dep.starts_with(b.as_str())
                                                })
                                        })
                                    })
                                    .unwrap_or(false)
                            })
                            .cloned()
                            .collect();

                        if !params_table_keys.is_empty() {
                            parent_cache.invalidate_params_tables_for_item(idx, &params_table_keys);
                            any_table_invalidated = true;
                        }
                    }
                }

                parent_cache.set_active_item(idx);
                std::mem::swap(&mut subform.eval_cache, &mut parent_cache);

                let subform_result = time_block!("    [subform_pass] subform item evaluate_dependents", {
                    subform.evaluate_dependents(
                        &item_changed_paths,
                        None,
                        None,
                        sub_re_evaluate,
                        token,
                        None,
                        false,
                    )
                });

                // Restore parent cache
                std::mem::swap(&mut subform.eval_cache, &mut parent_cache);
                parent_cache.clear_active_item();

                // Propagate the updated item_snapshot from the parent's T1 cache into the
                // subform's own eval_cache. Without this, subsequent evaluate_subform() calls
                // for this idx read the OLD snapshot (pre-run_subform_pass) and see a diff
                // against the new data → item_paths_bumped = true → spurious table invalidation.
                if let Some(parent_item_cache) = self.eval_cache.subform_caches.get(&idx) {
                    let snapshot = parent_item_cache.item_snapshot.clone();
                    subform.eval_cache.ensure_active_item_cache(idx);
                    if let Some(sub_cache) = subform.eval_cache.subform_caches.get_mut(&idx) {
                        sub_cache.item_snapshot = snapshot;
                    }
                }

                self.eval_cache = parent_cache;

                if let Ok(Value::Array(changes)) = subform_result {
                    let mut had_any_change = false;
                    for change in changes {
                        if let Some(obj) = change.as_object() {
                            if let Some(Value::String(ref_path)) = obj.get("$ref") {
                                // Remap the $ref path to include the parent path + item index
                                let new_ref = if ref_path.starts_with(&field_prefix) {
                                    format!(
                                        "{}.{}.{}",
                                        subform_dot_path,
                                        idx,
                                        &ref_path[field_prefix.len()..]
                                    )
                                } else {
                                    format!("{}.{}.{}", subform_dot_path, idx, ref_path)
                                };

                                // Write the computed value back to parent eval_data so subsequent
                                // evaluate_subform calls see an up-to-date old_item_snapshot.
                                // Without this, the diff in with_item_cache_swap sees stale parent
                                // data vs the new call's apply_changes values → spurious item bumps
                                // → invalidate_params_tables_for_item fires → eval_generation bumps.
                                if let Some(val) = obj.get("value") {
                                    let data_ptr = format!("/{}", new_ref.replace('.', "/"));
                                    self.eval_data.set(&data_ptr, val.clone());
                                    had_any_change = true;
                                } else if obj.get("clear").and_then(Value::as_bool) == Some(true) {
                                    let data_ptr = format!("/{}", new_ref.replace('.', "/"));
                                    self.eval_data.set(&data_ptr, Value::Null);
                                    had_any_change = true;
                                }

                                let mut new_obj = obj.clone();
                                new_obj.insert("$ref".to_string(), Value::String(new_ref));
                                result.push(Value::Object(new_obj));
                            } else {
                                // No $ref rewrite needed — push as-is without cloning the map
                                result.push(change);
                            }
                        }
                    }

                    // Refresh item snapshots after computed writes.
                    if had_any_change {
                        let item_path = format!("{}/{}", subform_ptr, idx);
                        let updated_item = self
                            .eval_data
                            .get(&item_path)
                            .cloned()
                            .unwrap_or(Value::Null);
                        // Update parent snapshot.
                        if let Some(c) = self.eval_cache.subform_caches.get_mut(&idx) {
                            c.item_snapshot = updated_item.clone();
                        }
                        // Update subform snapshot.
                        subform.eval_cache.ensure_active_item_cache(idx);
                        if let Some(sub_cache) = subform.eval_cache.subform_caches.get_mut(&idx) {
                            sub_cache.item_snapshot = updated_item;
                        }
                    }
                }
            }
        }
        Ok(any_table_invalidated)
    }

    /// Helper to evaluate a dependent value - uses pre-compiled eval keys for fast lookup
    pub(crate) fn evaluate_dependent_value_static(
        engine: &RLogic,
        evaluations: &IndexMap<String, LogicId>,
        eval_data: &EvalData,
        value: &Value,
        changed_field_value: &Value,
        changed_field_ref_value: &Value,
    ) -> Result<Value, String> {
        match value {
            // If it's a String, check if it's an eval key reference
            Value::String(eval_key) => {
                if let Some(logic_id) = evaluations.get(eval_key) {
                    // It's a pre-compiled evaluation - run it with scoped context
                    // Create internal context with $value and $refValue
                    let mut internal_context = serde_json::Map::new();
                    internal_context.insert("$value".to_string(), changed_field_value.clone());
                    internal_context.insert("$refValue".to_string(), changed_field_ref_value.clone());
                    let context_value = Value::Object(internal_context);

                    let result = engine.run_with_context(logic_id, eval_data.data(), &context_value)
                        .map_err(|e| format!("Failed to evaluate dependent logic '{}': {}", eval_key, e))?;
                    Ok(result)
                } else {
                    // It's a regular string value
                    Ok(value.clone())
                }
            }
            // For backwards compatibility: compile $evaluation on-the-fly
            // This shouldn't happen with properly parsed schemas
            Value::Object(map) if map.contains_key("$evaluation") => {
                Err("Dependent evaluation contains unparsed $evaluation - schema was not properly parsed".to_string())
            }
            // Primitive value - return as-is
            _ => Ok(value.clone()),
        }
    }

    /// Check if a single field is readonly and populate vectors for both changes and all values
    pub(crate) fn check_readonly_for_dependents(
        &self,
        schema_element: &Value,
        path: &str,
        changes: &mut Vec<(String, Value)>,
        all_values: &mut Vec<(String, Value)>,
    ) {
        match schema_element {
            Value::Object(map) => {
                // Check if field is disabled (ReadOnly)
                let mut is_disabled = false;
                if let Some(Value::Object(condition)) = map.get("condition") {
                    if let Some(Value::Bool(d)) = condition.get("disabled") {
                        is_disabled = *d;
                    }
                }

                // Check skipReadOnlyValue config
                let mut skip_readonly = false;
                if let Some(Value::Object(config)) = map.get("config") {
                    if let Some(Value::Object(all)) = config.get("all") {
                        if let Some(Value::Bool(skip)) = all.get("skipReadOnlyValue") {
                            skip_readonly = *skip;
                        }
                    }
                }

                if is_disabled && !skip_readonly {
                    if let Some(schema_value) = map.get("value") {
                        let data_path = path_utils::schema_path_to_data_pointer(path)
                            // Strip the schema /value/ wrapper that appears in subform array item
                            // paths, e.g. #/items/value/0/prop → /items/0/prop (correct data pointer).
                            .replace("/value/", "/");

                        let current_data = self
                            .eval_data
                            .data()
                            .pointer(&data_path)
                            .unwrap_or(&Value::Null);

                        // Emit to all_values regardless of change (frontend needs $readonly value);
                        // add to changes only when eval_data differs from the schema value.
                        all_values.push((path.to_string(), schema_value.clone()));
                        if current_data != schema_value {
                            changes.push((path.to_string(), schema_value.clone()));
                        }
                    }
                }
            }
            _ => {}
        }
    }

    /// Recursively collect read-only fields that need updates (Legacy/Full-Scan)
    #[allow(dead_code)]
    pub(crate) fn collect_readonly_fixes(
        &self,
        schema_element: &Value,
        path: &str,
        changes: &mut Vec<(String, Value)>,
    ) {
        match schema_element {
            Value::Object(map) => {
                // Check if field is disabled (ReadOnly)
                let mut is_disabled = false;
                if let Some(Value::Object(condition)) = map.get("condition") {
                    if let Some(Value::Bool(d)) = condition.get("disabled") {
                        is_disabled = *d;
                    }
                }

                // Check skipReadOnlyValue config
                let mut skip_readonly = false;
                if let Some(Value::Object(config)) = map.get("config") {
                    if let Some(Value::Object(all)) = config.get("all") {
                        if let Some(Value::Bool(skip)) = all.get("skipReadOnlyValue") {
                            skip_readonly = *skip;
                        }
                    }
                }

                if is_disabled && !skip_readonly {
                    // Check if it's a value field (has "value" property or implicit via path?)
                    // In JS: "const readOnlyValues = this.getSchemaValues();"
                    // We only care if data != schema value
                    if let Some(schema_value) = map.get("value") {
                        let data_path = path_utils::schema_path_to_data_pointer(path).into_owned();

                        let current_data = self
                            .eval_data
                            .data()
                            .pointer(&data_path)
                            .unwrap_or(&Value::Null);

                        if current_data != schema_value {
                            changes.push((path.to_string(), schema_value.clone()));
                        }
                    }
                }

                // Recurse into properties
                if let Some(Value::Object(props)) = map.get("properties") {
                    for (key, val) in props {
                        let next_path = if path == "#" {
                            format!("#/properties/{}", key)
                        } else {
                            format!("{}/properties/{}", path, key)
                        };
                        self.collect_readonly_fixes(val, &next_path, changes);
                    }
                }
            }
            _ => {}
        }
    }

    /// Check if a single field is hidden and needs clearing (Optimized non-recursive)
    pub(crate) fn check_hidden_field(
        &self,
        schema_element: &Value,
        path: &str,
        hidden_fields: &mut Vec<String>,
    ) {
        match schema_element {
            Value::Object(map) => {
                // Check if field is hidden
                let mut is_hidden = false;
                if let Some(Value::Object(condition)) = map.get("condition") {
                    if let Some(Value::Bool(h)) = condition.get("hidden") {
                        is_hidden = *h;
                    }
                }

                // Check keepHiddenValue config
                let mut keep_hidden = false;
                if let Some(Value::Object(config)) = map.get("config") {
                    if let Some(Value::Object(all)) = config.get("all") {
                        if let Some(Value::Bool(keep)) = all.get("keepHiddenValue") {
                            keep_hidden = *keep;
                        }
                    }
                }

                if is_hidden && !keep_hidden {
                    let data_path = path_utils::schema_path_to_data_pointer(path).into_owned();

                    let current_data = self
                        .eval_data
                        .data()
                        .pointer(&data_path)
                        .unwrap_or(&Value::Null);

                    // If hidden and has non-empty value, add to list
                    if current_data != &Value::Null && current_data != "" {
                        hidden_fields.push(path.to_string());
                    }
                }
            }
            _ => {}
        }
    }

    /// Check a field hidden by layout ancestry and needing data clearing.
    fn check_effectively_hidden_field(
        &self,
        schema_element: &Value,
        path: &str,
        hidden_fields: &mut Vec<String>,
    ) {
        let Value::Object(map) = schema_element else {
            return;
        };

        let keep_hidden = map
            .get("config")
            .and_then(Value::as_object)
            .and_then(|config| config.get("all"))
            .and_then(Value::as_object)
            .and_then(|all| all.get("keepHiddenValue"))
            .and_then(Value::as_bool)
            .unwrap_or(false);
        if keep_hidden {
            return;
        }

        let current_data = self
            .eval_data
            .data()
            .pointer(&path_utils::schema_path_to_data_pointer(path))
            .unwrap_or(&Value::Null);
        if current_data != &Value::Null && current_data != "" {
            hidden_fields.push(path.to_string());
        }
    }

    /// Recursively collect hidden fields that have values (candidates for clearing) (Legacy/Full-Scan)
    #[allow(dead_code)]
    pub(crate) fn collect_hidden_fields(
        &self,
        schema_element: &Value,
        path: &str,
        hidden_fields: &mut Vec<String>,
    ) {
        match schema_element {
            Value::Object(map) => {
                // Check if field is hidden
                let mut is_hidden = false;
                if let Some(Value::Object(condition)) = map.get("condition") {
                    if let Some(Value::Bool(h)) = condition.get("hidden") {
                        is_hidden = *h;
                    }
                }

                // Check keepHiddenValue config
                let mut keep_hidden = false;
                if let Some(Value::Object(config)) = map.get("config") {
                    if let Some(Value::Object(all)) = config.get("all") {
                        if let Some(Value::Bool(keep)) = all.get("keepHiddenValue") {
                            keep_hidden = *keep;
                        }
                    }
                }

                if is_hidden && !keep_hidden {
                    let data_path = path_utils::schema_path_to_data_pointer(path).into_owned();

                    let current_data = self
                        .eval_data
                        .data()
                        .pointer(&data_path)
                        .unwrap_or(&Value::Null);

                    // If hidden and has non-empty value, add to list
                    if current_data != &Value::Null && current_data != "" {
                        hidden_fields.push(path.to_string());
                    }
                }

                // Recurse into children
                for (key, val) in map {
                    if key == "properties" {
                        if let Value::Object(props) = val {
                            for (p_key, p_val) in props {
                                let next_path = if path == "#" {
                                    format!("#/properties/{}", p_key)
                                } else {
                                    format!("{}/properties/{}", path, p_key)
                                };
                                self.collect_hidden_fields(p_val, &next_path, hidden_fields);
                            }
                        }
                    } else if let Value::Object(_) = val {
                        // Skip known metadata keys and explicitly handled keys
                        if key == "condition"
                            || key == "config"
                            || key == "rules"
                            || key == "dependents"
                            || key == "hideLayout"
                            || key == "$layout"
                            || key == "$params"
                            || key == "definitions"
                            || key == "$defs"
                            || key.starts_with('$')
                        {
                            continue;
                        }

                        let next_path = if path == "#" {
                            format!("#/{}", key)
                        } else {
                            format!("{}/{}", path, key)
                        };
                        self.collect_hidden_fields(val, &next_path, hidden_fields);
                    }
                }
            }
            _ => {}
        }
    }

    /// Perform recursive hiding effect using reffed_by graph.
    /// Collects every data path that gets nulled into `invalidated_paths`.
    pub(crate) fn recursive_hide_effect(
        engine: &RLogic,
        evaluations: &IndexMap<String, LogicId>,
        reffed_by: &IndexMap<String, Vec<String>>,
        eval_data: &mut EvalData,
        eval_cache: &mut crate::jsoneval::eval_cache::EvalCache,
        mut hidden_fields: Vec<String>,
        queue: &mut Vec<(String, bool, Option<Vec<usize>>)>,
        result: &mut Vec<Value>,
    ) {
        while let Some(hf) = hidden_fields.pop() {
            let data_path = path_utils::schema_path_to_data_pointer(&hf).into_owned();

            // clear data
            eval_data.set(&data_path, Value::Null);
            eval_cache.bump_data_version(&data_path);

            // Create dependent object for result
            let mut change_obj = serde_json::Map::new();
            change_obj.insert(
                "$ref".to_string(),
                Value::String(path_utils::pointer_to_dot_notation(&data_path)),
            );
            change_obj.insert("$hidden".to_string(), Value::Bool(true));
            change_obj.insert("clear".to_string(), Value::Bool(true));
            result.push(Value::Object(change_obj));

            // Add to queue for standard dependent processing
            queue.push((hf.clone(), true, None));

            // Check reffed_by to find other fields that might become hidden
            if let Some(referencing_fields) = reffed_by.get(&data_path) {
                for rb in referencing_fields {
                    // Evaluate condition.hidden for rb
                    // We need a way to run specific evaluation?
                    // We can check if rb has a hidden evaluation in self.evaluations
                    let hidden_eval_key = format!("{}/condition/hidden", rb);

                    if let Some(logic_id) = evaluations.get(&hidden_eval_key) {
                        // Run evaluation
                        // Context: $value = current field (rb) value? No, $value usually refers to changed field in deps.
                        // But here we are just re-evaluating the rule.
                        // In JS logic: "const result = hiddenFn(runnerCtx);"
                        // runnerCtx has the updated data (we just set hf to null).

                        let rb_data_path = path_utils::schema_path_to_data_pointer(rb).into_owned();
                        let rb_value = eval_data
                            .data()
                            .pointer(&rb_data_path)
                            .cloned()
                            .unwrap_or(Value::Null);

                        // We can use engine.run w/ eval_data
                        if let Ok(Value::Bool(is_hidden)) = engine.run(logic_id, eval_data.data()) {
                            if is_hidden {
                                // Check if rb is not already in hidden_fields and has value
                                // rb is &String, hidden_fields is Vec<String>
                                if !hidden_fields.contains(rb) {
                                    let has_value = rb_value != Value::Null && rb_value != "";
                                    if has_value {
                                        hidden_fields.push(rb.clone());
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }

    /// Process the dependents queue.
    /// Collects every data path written into `eval_data` into `invalidated_paths`.
    pub(crate) fn process_dependents_queue(
        engine: &RLogic,
        evaluations: &IndexMap<String, LogicId>,
        eval_data: &mut EvalData,
        eval_cache: &mut crate::jsoneval::eval_cache::EvalCache,
        dependents_evaluations: &IndexMap<String, Vec<DependentItem>>,
        dep_formula_triggers: &IndexMap<String, Vec<(String, usize)>>,
        evaluated_schema: &Value,
        queue: &mut Vec<(String, bool, Option<Vec<usize>>)>,
        processed: &mut std::collections::HashMap<String, Option<std::collections::HashSet<usize>>>,
        result: &mut Vec<Value>,
        token: Option<&CancellationToken>,
        canceled_paths: Option<&mut Vec<String>>,
    ) -> Result<(), String> {
        while let Some((current_path, is_transitive, target_indices)) = queue.pop() {
            if let Some(t) = token {
                if t.is_cancelled() {

                    if let Some(cp) = canceled_paths {
                        cp.push(current_path.clone());
                        for (path, _, _) in queue.iter() {
                            cp.push(path.clone());
                        }
                    }
                    return Err("Cancelled".to_string());
                }
            }

            let (should_run, indices_to_run) = match processed.get(&current_path) {
                Some(None) => {
                    // Already fully processed, skip
                    continue;
                }
                Some(Some(already_processed_indices)) => {
                    if let Some(targets) = &target_indices {
                        let new_targets: std::collections::HashSet<usize> = targets
                            .iter()
                            .copied()
                            .filter(|i| !already_processed_indices.contains(i))
                            .collect();
                        if new_targets.is_empty() {
                            continue;
                        }
                        (true, Some(new_targets))
                    } else {
                        (true, None)
                    }
                }
                None => (
                    true,
                    target_indices.clone().map(|t| t.into_iter().collect()),
                ),
            };

            if !should_run {
                continue;
            }

            let new_processed_state = if let Some(targets_to_run) = &indices_to_run {
                match processed.get(&current_path) {
                    Some(Some(existing_targets)) => {
                        let mut copy = existing_targets.clone();
                        for t in targets_to_run {
                            copy.insert(*t);
                        }
                        Some(copy)
                    }
                    _ => Some(targets_to_run.clone()),
                }
            } else {
                None
            };
            processed.insert(current_path.clone(), new_processed_state);

            // Get the value of the changed field for $value context
            let current_data_path =
                path_utils::schema_path_to_data_pointer(&current_path).into_owned();
            let mut current_value = eval_data
                .data()
                .pointer(&current_data_path)
                .cloned()
                .unwrap_or(Value::Null);

            // Re-enqueue source fields whose dependent formulas reference this changed field.
            // These are fields that have a dependent formula that checks `current_path` as a
            // contextual condition (e.g., ins_occ's formula for ph_occupation checks phins_relation).
            // When `current_path` changes, we need to re-evaluate those source fields' dependents.
            if target_indices.is_none() {
                if let Some(formula_sources) = dep_formula_triggers.get(&current_data_path) {
                    let mut targets_by_source: std::collections::HashMap<String, Vec<usize>> =
                        std::collections::HashMap::new();
                    for (source_schema_path, dep_idx) in formula_sources {
                        let source_ptr = path_utils::dot_notation_to_schema_pointer(source_schema_path);
                        targets_by_source
                            .entry(source_ptr)
                            .or_default()
                            .push(*dep_idx);
                    }
                    for (source_ptr, targets) in targets_by_source {
                        // Check if it's already entirely processed
                        if let Some(None) = processed.get(&source_ptr) {
                            continue;
                        }
                        queue.push((source_ptr, true, Some(targets)));
                    }
                }
            }

            // Find dependents for this path
            if let Some(dependent_items) = dependents_evaluations.get(&current_path) {
                for (dep_idx, dep_item) in dependent_items.iter().enumerate() {
                    if let Some(targets) = &indices_to_run {
                        if !targets.contains(&dep_idx) {
                            continue;
                        }
                    }
                    let ref_path = &dep_item.ref_path;

                    // Skip writing back to a field that has already been processed.
                    // This prevents formula-triggered re-enqueues from creating circular writes:
                    // e.g., ins_gender → triggers phins_relation (via dep_formula_triggers) →
                    // phins_relation has a dep that writes back to ins_gender → we must not let that happen.
                    if processed.contains_key(ref_path) {
                        continue;
                    }

                    let pointer_path = path_utils::normalize_to_json_pointer(ref_path);
                    // Data paths don't include /properties/, strip it for data access
                    let data_path =
                        crate::jsoneval::path_utils::schema_path_to_data_pointer(&pointer_path)
                            .into_owned();

                    let current_ref_value = eval_data
                        .data()
                        .pointer(&data_path)
                        .cloned()
                        .unwrap_or(Value::Null);

                    let mut add_transitive = false;
                    let mut add_deps = false;
                    let mut clear_applied = false;
                    let mut value_to_apply = None;

                    // Process clear
                    if let Some(clear_val) = &dep_item.clear {
                        let should_clear = Self::evaluate_dependent_value_static(
                            engine,
                            evaluations,
                            eval_data,
                            clear_val,
                            &current_value,
                            &current_ref_value,
                        )?;
                        let clear_bool = match should_clear {
                            Value::Bool(b) => b,
                            _ => false,
                        };

                        if clear_bool {
                            let was_already_null = current_ref_value == Value::Null;
                            if data_path == current_data_path {
                                current_value = Value::Null;
                            }
                            eval_data.set(&data_path, Value::Null);

                            eval_cache.bump_data_version(&data_path);
                            clear_applied = true;
                            if !was_already_null {
                                add_transitive = true;
                            }
                            add_deps = true;
                        }
                    }

                    // Process value
                    if !clear_applied {
                        if let Some(value_val) = &dep_item.value {
                        let computed_value = Self::evaluate_dependent_value_static(
                            engine,
                            evaluations,
                            eval_data,
                            value_val,
                            &current_value,
                            &current_ref_value,
                        )?;
                        let cleaned_val = clean_float_noise_scalar(computed_value);

                        let is_clear =
                            cleaned_val == Value::Null || cleaned_val.as_str() == Some("");

                        if cleaned_val != current_ref_value && !is_clear {
                            if data_path == current_data_path {
                                current_value = cleaned_val.clone();
                            }
                            eval_data.set(&data_path, cleaned_val.clone());
                            eval_cache.bump_data_version(&data_path);
                            value_to_apply = Some(cleaned_val);
                            add_transitive = true;
                            add_deps = true;
                        }
                    }
                }

                    // add only when has clear / value
                    if add_deps {
                        let field = evaluated_schema.pointer(&pointer_path).cloned();

                        // Get parent field - skip /properties/ to get actual parent object
                        let parent_path = if let Some(last_slash) = pointer_path.rfind("/properties") {
                            &pointer_path[..last_slash]
                        } else {
                            "/"
                        };
                        let parent_field = extract_parent_field(evaluated_schema, parent_path);

                        let mut change_obj = serde_json::Map::new();
                        change_obj.insert(
                            "$ref".to_string(),
                            Value::String(path_utils::pointer_to_dot_notation(&data_path)),
                        );
                        if let Some(f) = field {
                            change_obj.insert("$field".to_string(), f);
                        }
                        change_obj.insert("$parentField".to_string(), parent_field);
                        change_obj.insert("transitive".to_string(), Value::Bool(is_transitive));
                        if clear_applied {
                            change_obj.insert("clear".to_string(), Value::Bool(true));
                        }
                        if let Some(val) = value_to_apply {
                            change_obj.insert("value".to_string(), val);
                        }
                        result.push(Value::Object(change_obj));
                    }

                    // Add this dependent to queue for transitive processing
                    if add_transitive {
                        queue.push((ref_path.clone(), true, None));
                    }
                }
            }
        }
        Ok(())
    }
}

/// Extract the field key from a subform path.
///
/// Examples:
/// - `#/items`                                → `items`
/// - `#/properties/form/properties/items`     → `items`
fn subform_field_key(subform_path: &str) -> String {
    // Strip leading `#/`
    let stripped = subform_path.trim_start_matches('#').trim_start_matches('/');

    // The last non-"properties" segment is the field key
    stripped
        .split('/')
        .filter(|seg| !seg.is_empty() && *seg != "properties")
        .last()
        .unwrap_or(stripped)
        .to_string()
}

/// Extract the parent field definition excluding heavy child collections (`properties`, `$layout`).
/// Returns a shallow copy of the parent schema node's attributes.
fn extract_parent_field(evaluated_schema: &Value, parent_path: &str) -> Value {
    let node = if parent_path.is_empty() || parent_path == "/" {
        evaluated_schema
    } else {
        match evaluated_schema.pointer(parent_path) {
            Some(v) => v,
            None => return Value::Object(serde_json::Map::new()),
        }
    };
    if let Value::Object(map) = node {
        let mut filtered = serde_json::Map::with_capacity(map.len().saturating_sub(2));
        for (k, v) in map {
            if k != "properties" && k != "$layout" {
                filtered.insert(k.clone(), v.clone());
            }
        }
        Value::Object(filtered)
    } else {
        Value::Object(serde_json::Map::new())
    }
}