refactor(dependencies): consolidate RefFinder structs

Author: zharinov

crates/plotnik-lib/src/query/dependencies.rs

@@ -515,9 +515,19 @@ fn collect_refs<'a>(expr: &Expr, symbol_table: &'a SymbolTable) -> IndexSet<&'a
     refs
 }
 
+/// Whether to search for any reference or only unguarded ones.
+#[derive(Clone, Copy, PartialEq, Eq)]
+enum RefSearchMode {
+    /// Find any reference to the target.
+    Any,
+    /// Find only unguarded references (not inside a NamedNode/AnonymousNode).
+    Unguarded,
+}
+
 struct RefFinder<'a> {
     target: &'a str,
     found: Option<TextRange>,
+    mode: RefSearchMode,
 }
 
 impl Visitor for RefFinder<'_> {
@@ -528,49 +538,23 @@ impl Visitor for RefFinder<'_> {
         walk_expr(self, expr);
     }
 
-    fn visit_ref(&mut self, r: &Ref) {
-        if self.found.is_some() {
-            return;
-        }
-        if let Some(name) = r.name()
-            && name.text() == self.target
-        {
-            self.found = Some(name.text_range());
+    fn visit_named_node(&mut self, node: &NamedNode) {
+        if self.mode == RefSearchMode::Unguarded {
+            return; // Guarded: stop recursion
         }
-    }
-}
-
-fn find_ref_range(expr: &Expr, target: &str) -> Option<TextRange> {
-    let mut visitor = RefFinder {
-        target,
-        found: None,
-    };
-    visitor.visit_expr(expr);
-    visitor.found
-}
-
-struct UnguardedRefFinder<'a> {
-    target: &'a str,
-    found: Option<TextRange>,
-}
-
-impl Visitor for UnguardedRefFinder<'_> {
-    fn visit_expr(&mut self, expr: &Expr) {
-        if self.found.is_some() {
-            return;
-        }
-        walk_expr(self, expr);
-    }
-
-    fn visit_named_node(&mut self, _node: &NamedNode) {
-        // Guarded: stop recursion
+        super::visitor::walk_named_node(self, node);
     }
 
     fn visit_anonymous_node(&mut self, _node: &AnonymousNode) {
-        // Guarded: stop recursion
+        if self.mode == RefSearchMode::Unguarded {
+            return; // Guarded: stop recursion
+        }
     }
 
     fn visit_ref(&mut self, r: &Ref) {
+        if self.found.is_some() {
+            return;
+        }
         if let Some(name) = r.name()
             && name.text() == self.target
         {
@@ -584,17 +568,28 @@ impl Visitor for UnguardedRefFinder<'_> {
             if self.found.is_some() {
                 return;
             }
-            if expr_guarantees_consumption(&child) {
+            if self.mode == RefSearchMode::Unguarded && expr_guarantees_consumption(&child) {
                 return;
             }
         }
     }
 }
 
+fn find_ref_range(expr: &Expr, target: &str) -> Option<TextRange> {
+    let mut visitor = RefFinder {
+        target,
+        found: None,
+        mode: RefSearchMode::Any,
+    };
+    visitor.visit_expr(expr);
+    visitor.found
+}
+
 fn find_unguarded_ref_range(expr: &Expr, target: &str) -> Option<TextRange> {
-    let mut visitor = UnguardedRefFinder {
+    let mut visitor = RefFinder {
         target,
         found: None,
+        mode: RefSearchMode::Unguarded,
     };
     visitor.visit_expr(expr);
     visitor.found