Move Vue flow models into QL

Author: Copilot

javascript/ql/lib/change-notes/2026-07-16-vue-composition-api-flow.md

@@ -0,0 +1,4 @@
+---
+category: minorAnalysis
+---
+* Added flow models for Vue's `ref`, `shallowRef`, `toRef`, `reactive`, and `computed` Composition API helpers.

javascript/ql/lib/ext/vue.model.yml

@@ -35,6 +35,42 @@ module Vue {
     result = any(GlobalVueEntryPoint e).getANode()
   }
 
+  /** Models data flow through Vue Composition API helpers. */
+  private class VueCompositionApiSummary extends DataFlow::SummarizedCallable::Range {
+    string name;
+
+    VueCompositionApiSummary() {
+      name = ["ref", "shallowRef", "toRef", "reactive", "computed"] and
+      this = "vue." + name
+    }
+
+    override predicate propagatesFlow(string input, string output, boolean preservesValue) {
+      name = ["ref", "shallowRef"] and
+      input = "Argument[0]" and
+      output = "ReturnValue.Member[value]" and
+      preservesValue = true
+      or
+      name = "toRef" and
+      input = "Argument[0]" and
+      output = "ReturnValue.Member[value]" and
+      preservesValue = false
+      or
+      name = "reactive" and
+      input = "Argument[0]" and
+      output = "ReturnValue" and
+      preservesValue = false
+      or
+      name = "computed" and
+      input = "Argument[0].ReturnValue" and
+      output = "ReturnValue.Member[value]" and
+      preservesValue = true
+    }
+
+    override DataFlow::InvokeNode getACall() {
+      result = API::moduleImport("vue").getMember(name).getACall()
+    }
+  }
+
   /**
    * Gets a reference to the 'Vue' object.
    */

javascript/ql/lib/semmle/javascript/frameworks/Vue.qll

@@ -1,6 +1,24 @@
 import javascript
 import semmle.javascript.security.dataflow.DomBasedXssCustomizations
 
+module TestConfig implements DataFlow::ConfigSig {
+  predicate isSource(DataFlow::Node source) {
+    source.(DataFlow::CallNode).getCalleeName() = "source"
+  }
+
+  predicate isSink(DataFlow::Node sink) {
+    sink = any(DataFlow::CallNode call | call.getCalleeName() = "sink").getAnArgument()
+  }
+}
+
+module TestDataFlow = DataFlow::Global<TestConfig>;
+
+module TestTaintFlow = TaintTracking::Global<TestConfig>;
+
+query predicate compositionApiDataFlow = TestDataFlow::flow/2;
+
+query predicate compositionApiTaintFlow = TestTaintFlow::flow/2;
+
 query predicate component_getAPropertyValue(Vue::Component c, string name, DataFlow::Node prop) {
   c.getAPropertyValue(name) = prop
 }

javascript/ql/test/library-tests/frameworks/Vue/tests.ql

@@ -115,3 +115,9 @@ let subclass2 = base.extend({
 		fromSubclass2: 100
 	}
 });
+
+sink(Vue.ref(source("ref")).value);
+sink(Vue.shallowRef(source("shallowRef")).value);
+sink(Vue.toRef(source("toRef")).value);
+sink(Vue.reactive(source("reactive")));
+sink(Vue.computed(() => source("computed")).value);