@eagleoutice/flowr 2.2.14 → 2.2.16

package/dataflow/eval/resolve/alias-tracking.js

@@ -0,0 +1,352 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAliases = getAliases;
+exports.resolveIdToValue = resolveIdToValue;
+exports.trackAliasInEnvironments = trackAliasInEnvironments;
+exports.trackAliasesInGraph = trackAliasesInGraph;
+exports.resolveToConstants = resolveToConstants;
+const config_1 = require("../../../config");
+const node_id_1 = require("../../../r-bridge/lang-4.x/ast/model/processing/node-id");
+const type_1 = require("../../../r-bridge/lang-4.x/ast/model/type");
+const fingerprint_1 = require("../../../slicing/static/fingerprint");
+const visiting_queue_1 = require("../../../slicing/static/visiting-queue");
+const assert_1 = require("../../../util/assert");
+const environment_1 = require("../../environments/environment");
+const identifier_1 = require("../../environments/identifier");
+const resolve_by_name_1 = require("../../environments/resolve-by-name");
+const edge_1 = require("../../graph/edge");
+const unknown_replacement_1 = require("../../graph/unknown-replacement");
+const unknown_side_effect_1 = require("../../graph/unknown-side-effect");
+const vertex_1 = require("../../graph/vertex");
+const general_1 = require("../values/general");
+const r_value_1 = require("../values/r-value");
+const set_constants_1 = require("../values/sets/set-constants");
+const resolve_1 = require("./resolve");
+const AliasHandler = {
+    [vertex_1.VertexType.Value]: (sourceId) => [sourceId],
+    [vertex_1.VertexType.Use]: getUseAlias,
+    [vertex_1.VertexType.FunctionCall]: getFunctionCallAlias,
+    [vertex_1.VertexType.FunctionDefinition]: () => undefined,
+    [vertex_1.VertexType.VariableDefinition]: () => undefined
+};
+function getFunctionCallAlias(sourceId, dataflow, environment) {
+    const identifier = (0, node_id_1.recoverName)(sourceId, dataflow.idMap);
+    if (identifier === undefined) {
+        return undefined;
+    }
+    const defs = (0, resolve_by_name_1.resolveByName)(identifier, environment, identifier_1.ReferenceType.Function);
+    if (defs === undefined || defs.length !== 1) {
+        return undefined;
+    }
+    return [sourceId];
+}
+function getUseAlias(sourceId, dataflow, environment) {
+    const definitions = [];
+    // Source is Symbol -> resolve definitions of symbol
+    const identifier = (0, node_id_1.recoverName)(sourceId, dataflow.idMap);
+    if (identifier === undefined) {
+        return undefined;
+    }
+    const defs = (0, resolve_by_name_1.resolveByName)(identifier, environment);
+    if (defs === undefined) {
+        return undefined;
+    }
+    for (const def of defs) {
+        // If one definition is not constant (or a variable aliasing a constant)
+        // we can't say for sure what value the source has
+        if (def.type === identifier_1.ReferenceType.Variable) {
+            if (def.value === undefined) {
+                return undefined;
+            }
+            definitions.push(...def.value);
+        }
+        else if (def.type === identifier_1.ReferenceType.Constant || def.type === identifier_1.ReferenceType.BuiltInConstant) {
+            definitions.push(def.nodeId);
+        }
+        else {
+            return undefined;
+        }
+    }
+    return definitions;
+}
+/**
+ * Gets the definitions / aliases of a node
+ *
+ * This function is called by the built-in-assignment processor so that we can
+ * track assignments inside the environment. The returned ids are stored in
+ * the sourceIds value field of their InGraphIdentifierDefinition. This enables
+ * us later, in the {@link trackAliasInEnvironments} function, to get all the
+ * aliases of an identifier.
+ *
+ * @param sourceIds    - node ids to get the definitions for
+ * @param dataflow     - dataflow graph
+ * @param environment  - environment
+ * @returns node id of alias
+ */
+function getAliases(sourceIds, dataflow, environment) {
+    const definitions = new Set();
+    for (const sourceId of sourceIds) {
+        const info = dataflow.getVertex(sourceId);
+        if (info === undefined) {
+            return undefined;
+        }
+        const defs = AliasHandler[info.tag](sourceId, dataflow, environment);
+        for (const def of defs ?? []) {
+            definitions.add(def);
+        }
+    }
+    return [...definitions];
+}
+/**
+ * Evaluates the value of a node in the set domain.
+ *
+ * resolveIdToValue tries to resolve the value using the data it has been given.
+ * If the environment is provided the approximation is more precise, as we can
+ * track aliases in the environment.
+ * Otherwise, the graph is used to try and resolve the nodes value.
+ * If neither is provided the value cannot be resolved.
+ *
+ * This function is also used by the Resolve Value Query and the Dependency Query
+ * to resolve values. For e.g. in the Dependency Query it is used to resolve calls
+ * like `lapply(c("a", "b", "c"), library, character.only = TRUE)`
+ *
+ * @param id          - The node id or node to resolve
+ * @param environment - The current environment used for name resolution
+ * @param graph       - The graph to resolve in
+ * @param idMap       - The id map to resolve the node if given as an id
+ * @param full        - Whether to track aliases on resolve
+ * @param resolve     - Variable resolve mode
+ */
+function resolveIdToValue(id, { environment, graph, idMap, full = true, resolve }) {
+    if (id === undefined) {
+        return r_value_1.Top;
+    }
+    idMap ??= graph?.idMap;
+    const node = typeof id === 'object' ? id : idMap?.get(id);
+    if (node === undefined) {
+        return r_value_1.Top;
+    }
+    switch (node.type) {
+        case type_1.RType.Argument:
+        case type_1.RType.Symbol:
+            if (environment) {
+                return full ? trackAliasInEnvironments(resolve, node.lexeme, environment, graph, idMap) : r_value_1.Top;
+            }
+            else if (graph && resolve === config_1.VariableResolve.Alias) {
+                return full ? trackAliasesInGraph(node.info.id, graph, idMap) : r_value_1.Top;
+            }
+            else {
+                return r_value_1.Top;
+            }
+        case type_1.RType.FunctionCall:
+            return (0, set_constants_1.setFrom)((0, resolve_1.resolveNode)(resolve, node, environment, graph, idMap));
+        case type_1.RType.String:
+        case type_1.RType.Number:
+        case type_1.RType.Logical:
+            return (0, set_constants_1.setFrom)((0, general_1.valueFromRNodeConstant)(node));
+        default:
+            return r_value_1.Top;
+    }
+}
+/**
+ * Please use {@link resolveIdToValue}
+ *
+ * Uses the aliases that were tracked in the environments (by the
+ * {@link getAliases} function) to resolve a node to a value.
+ *
+ *
+ * @param resolve    - Variable resolve mode
+ * @param identifier - Identifier to resolve
+ * @param use        - Environment to use
+ * @param graph      - Dataflow graph
+ * @param idMap      - id map of Dataflow graph
+ * @returns Value of Identifier or Top
+ */
+function trackAliasInEnvironments(resolve, identifier, use, graph, idMap) {
+    if (identifier === undefined) {
+        return r_value_1.Top;
+    }
+    const defs = (0, resolve_by_name_1.resolveByName)(identifier, use);
+    if (defs === undefined) {
+        return r_value_1.Top;
+    }
+    const values = new Set();
+    for (const def of defs) {
+        if (def.type === identifier_1.ReferenceType.BuiltInConstant) {
+            values.add((0, general_1.valueFromTsValue)(def.value));
+        }
+        else if (def.type === identifier_1.ReferenceType.BuiltInFunction) {
+            // Tracked in #1207
+        }
+        else if (def.value !== undefined) {
+            /* if there is at least one location for which we have no idea, we have to give up for now! */
+            if (def.value.length === 0) {
+                return r_value_1.Top;
+            }
+            for (const alias of def.value) {
+                const definitionOfAlias = idMap?.get(alias);
+                if (definitionOfAlias !== undefined) {
+                    const value = (0, resolve_1.resolveNode)(resolve, definitionOfAlias, use, graph, idMap);
+                    if ((0, r_value_1.isTop)(value)) {
+                        return r_value_1.Top;
+                    }
+                    values.add(value);
+                }
+            }
+        }
+    }
+    if (values.size == 0) {
+        return r_value_1.Top;
+    }
+    return (0, set_constants_1.setFrom)(...values);
+}
+/** given an unknown alias, we have to clear all values in the environments */
+(0, unknown_side_effect_1.onUnknownSideEffect)((_graph, env, _id, target) => {
+    if (target) {
+        return;
+    }
+    let current = env.current;
+    while (current) {
+        current.memory.forEach(mem => mem.forEach((def) => {
+            if (def.type !== identifier_1.ReferenceType.BuiltInConstant
+                && def.type !== identifier_1.ReferenceType.BuiltInFunction
+                && def.value !== undefined) {
+                def.value.length = 0;
+            }
+        }));
+        current = current.parent;
+    }
+});
+(0, unknown_replacement_1.onReplacementOperator)((args) => {
+    if (!args.target) {
+        return;
+    }
+    let current = args.env.current;
+    while (current) {
+        const defs = current.memory.get(args.target);
+        defs?.forEach(def => {
+            if (def.type !== identifier_1.ReferenceType.BuiltInConstant
+                && def.type !== identifier_1.ReferenceType.BuiltInFunction
+                && def.value !== undefined) {
+                def.value.length = 0;
+            }
+        });
+        current = current.parent;
+    }
+});
+function isNestedInLoop(node, ast) {
+    const parent = node?.info.parent;
+    if (node === undefined || !parent) {
+        return false;
+    }
+    const parentNode = ast.get(parent);
+    if (parentNode === undefined) {
+        return false;
+    }
+    if (parentNode.type === type_1.RType.WhileLoop || parentNode.type === type_1.RType.RepeatLoop) {
+        return true;
+    }
+    return isNestedInLoop(parentNode, ast);
+}
+/**
+ * Please use {@link resolveIdToValue}
+ *
+ * Tries to resolve the value of a node by traversing the dataflow graph
+ *
+ * @param id    - node to resolve
+ * @param graph - dataflow graph
+ * @param idMap - idmap of dataflow graph
+ * @returns Value of node or Top/Bottom
+ */
+function trackAliasesInGraph(id, graph, idMap) {
+    idMap ??= graph.idMap;
+    (0, assert_1.guard)(idMap !== undefined, 'The ID map is required to get the lineage of a node');
+    const start = graph.getVertex(id);
+    (0, assert_1.guard)(start !== undefined, 'Unable to find start for alias tracking');
+    const queue = new visiting_queue_1.VisitingQueue(25);
+    const clean = (0, environment_1.initializeCleanEnvironments)();
+    const cleanFingerprint = (0, fingerprint_1.envFingerprint)(clean);
+    queue.add(id, clean, cleanFingerprint, false);
+    let forceBot = false;
+    const resultIds = [];
+    while (queue.nonEmpty()) {
+        const { id, baseEnvironment } = queue.next();
+        const res = graph.get(id);
+        if (!res) {
+            continue;
+        }
+        const [vertex, outgoingEdges] = res;
+        const cds = vertex.cds;
+        for (const cd of cds ?? []) {
+            const target = graph.idMap?.get(cd.id);
+            if (target === undefined) {
+                continue;
+            }
+            if (target.type === type_1.RType.WhileLoop || target.type === type_1.RType.RepeatLoop) {
+                forceBot = true;
+                break;
+            }
+        }
+        if (!forceBot && (cds?.length === 0 && isNestedInLoop(idMap.get(id), idMap))) {
+            forceBot = true;
+        }
+        if (forceBot) {
+            break;
+        }
+        if (vertex.tag === vertex_1.VertexType.Value) {
+            resultIds.push(id);
+            continue;
+        }
+        else if (vertex.tag === vertex_1.VertexType.FunctionDefinition) {
+            resultIds.push(id);
+            continue;
+        }
+        const isFn = vertex.tag === vertex_1.VertexType.FunctionCall;
+        // travel all read and defined-by edges
+        for (const [targetId, edge] of outgoingEdges) {
+            if (isFn) {
+                if (edge.types === edge_1.EdgeType.Returns || edge.types === edge_1.EdgeType.DefinedByOnCall || edge.types === edge_1.EdgeType.DefinedBy) {
+                    queue.add(targetId, baseEnvironment, cleanFingerprint, false);
+                }
+                continue;
+            }
+            // currently, they have to be exact!
+            if (edge.types === edge_1.EdgeType.Reads || edge.types === edge_1.EdgeType.DefinedBy || edge.types === edge_1.EdgeType.DefinedByOnCall) {
+                queue.add(targetId, baseEnvironment, cleanFingerprint, false);
+            }
+        }
+    }
+    if (forceBot || resultIds.length === 0) {
+        return r_value_1.Bottom;
+    }
+    const values = new Set();
+    for (const id of resultIds) {
+        const node = idMap.get(id);
+        if (node !== undefined) {
+            values.add((0, general_1.valueFromRNodeConstant)(node));
+        }
+    }
+    return (0, set_constants_1.setFrom)(...values);
+}
+/**
+ * Please use {@link resolveIdToValue}
+ *
+ * Resolve an Identifier to a constant, if the identifier is a constant
+ *
+ * @param name        - Identifier to resolve
+ * @param environment - Environment to use
+ * @returns Value of Constant or Top
+ */
+function resolveToConstants(name, environment) {
+    if (name === undefined) {
+        return r_value_1.Top;
+    }
+    const definitions = (0, resolve_by_name_1.resolveByName)(name, environment, identifier_1.ReferenceType.Constant);
+    if (definitions === undefined) {
+        return r_value_1.Top;
+    }
+    const values = new Set();
+    definitions.forEach(def => values.add((0, general_1.valueFromTsValue)(def.value ?? r_value_1.Top)));
+    return (0, set_constants_1.setFrom)(...values);
+}
+//# sourceMappingURL=alias-tracking.js.map

package/dataflow/eval/resolve/resolve-argument.d.ts

@@ -0,0 +1,8 @@
+import type { DataflowGraph } from '../../graph/graph';
+import type { DataflowGraphVertexFunctionCall } from '../../graph/vertex';
+import type { NodeId } from '../../../r-bridge/lang-4.x/ast/model/processing/node-id';
+import type { VariableResolve } from '../../../config';
+/**
+ * Get the values of all arguments matching the criteria.
+ */
+export declare function getArgumentStringValue(variableResolve: VariableResolve, graph: DataflowGraph, vertex: DataflowGraphVertexFunctionCall, argumentIndex: number | 'unnamed' | undefined, argumentName: string | undefined, resolveValue: boolean | 'library' | undefined): Map<NodeId, Set<string | undefined>> | undefined;

package/dataflow/eval/resolve/resolve-argument.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getArgumentStringValue = getArgumentStringValue;
+const graph_1 = require("../../graph/graph");
+const r_function_call_1 = require("../../../r-bridge/lang-4.x/ast/model/nodes/r-function-call");
+const assert_1 = require("../../../util/assert");
+const type_1 = require("../../../r-bridge/lang-4.x/ast/model/type");
+const dependencies_query_format_1 = require("../../../queries/catalog/dependencies-query/dependencies-query-format");
+const general_1 = require("../values/general");
+const alias_tracking_1 = require("./alias-tracking");
+const r_value_1 = require("../values/r-value");
+const convert_values_1 = require("../../../r-bridge/lang-4.x/convert-values");
+const string_constants_1 = require("../values/string/string-constants");
+/**
+ * Get the values of all arguments matching the criteria.
+ */
+function getArgumentStringValue(variableResolve, graph, vertex, argumentIndex, argumentName, resolveValue) {
+    if (argumentName) {
+        const arg = vertex?.args.findIndex(arg => arg !== r_function_call_1.EmptyArgument && arg.name === argumentName);
+        if (arg >= 0) {
+            argumentIndex = arg;
+        }
+    }
+    if (!vertex || argumentIndex === undefined) {
+        return undefined;
+    }
+    if (argumentIndex === 'unnamed') {
+        // return all unnamed arguments
+        const references = vertex.args.filter(arg => arg !== r_function_call_1.EmptyArgument && !arg.name).map(graph_1.getReferenceOfArgument).filter(assert_1.isNotUndefined);
+        const map = new Map();
+        for (const ref of references) {
+            let valueNode = graph.idMap?.get(ref);
+            if (valueNode?.type === type_1.RType.Argument) {
+                valueNode = valueNode.value;
+            }
+            if (valueNode) {
+                // this should be evaluated in the callee-context
+                const values = resolveBasedOnConfig(variableResolve, graph, vertex, valueNode, vertex.environment, graph.idMap, resolveValue) ?? [dependencies_query_format_1.Unknown];
+                map.set(ref, new Set(values));
+            }
+        }
+        return map;
+    }
+    if (argumentIndex < vertex.args.length) {
+        const arg = (0, graph_1.getReferenceOfArgument)(vertex.args[argumentIndex]);
+        if (!arg) {
+            return undefined;
+        }
+        let valueNode = graph.idMap?.get(arg);
+        if (valueNode?.type === type_1.RType.Argument) {
+            valueNode = valueNode.value;
+        }
+        if (valueNode) {
+            const values = resolveBasedOnConfig(variableResolve, graph, vertex, valueNode, vertex.environment, graph.idMap, resolveValue) ?? [dependencies_query_format_1.Unknown];
+            return new Map([[arg, new Set(values)]]);
+        }
+    }
+    return undefined;
+}
+function hasCharacterOnly(variableResolve, graph, vertex, idMap) {
+    if (!vertex.args || vertex.args.length === 0 || !idMap) {
+        return false;
+    }
+    const treatAsChar = getArgumentStringValue(variableResolve, graph, vertex, 5, 'character.only', true);
+    if (!treatAsChar) {
+        return false;
+    }
+    const hasTrue = [...treatAsChar.values()].some(set => set?.has('TRUE'));
+    const hasFalse = hasTrue ? [...treatAsChar.values()].some(set => set === undefined || set.has('FALSE')) : false;
+    if (hasTrue && hasFalse) {
+        return 'maybe';
+    }
+    else {
+        return hasTrue;
+    }
+}
+function resolveBasedOnConfig(variableResolve, graph, vertex, argument, environment, idMap, resolveValue) {
+    let full = true;
+    if (!resolveValue) {
+        full = false;
+    }
+    if (resolveValue === 'library') {
+        const hasChar = hasCharacterOnly(variableResolve, graph, vertex, idMap);
+        if (hasChar === false) {
+            if (argument.type === type_1.RType.Symbol) {
+                return [argument.lexeme];
+            }
+            full = false;
+        }
+    }
+    const resolved = (0, general_1.valueSetGuard)((0, alias_tracking_1.resolveIdToValue)(argument, { environment, graph, full, resolve: variableResolve }));
+    if (resolved) {
+        const values = [];
+        for (const value of resolved.elements) {
+            if (!(0, r_value_1.isValue)(value)) {
+                return undefined;
+            }
+            else if (value.type === 'string' && (0, r_value_1.isValue)(value.value)) {
+                values.push(value.value.str);
+            }
+            else if (value.type === 'logical' && (0, r_value_1.isValue)(value.value)) {
+                values.push(value.value.valueOf() ? convert_values_1.RTrue : convert_values_1.RFalse);
+            }
+            else if (value.type === 'vector' && (0, r_value_1.isValue)(value.elements)) {
+                const elements = (0, string_constants_1.collectStrings)(value.elements, !full);
+                if (elements === undefined) {
+                    return undefined;
+                }
+                values.push(...elements);
+            }
+            else {
+                return undefined;
+            }
+        }
+        return values;
+    }
+}
+//# sourceMappingURL=resolve-argument.js.map

package/dataflow/eval/resolve/resolve.d.ts

@@ -0,0 +1,37 @@
+import type { AstIdMap, RNodeWithParent } from '../../../r-bridge/lang-4.x/ast/model/processing/decorate';
+import type { REnvironmentInformation } from '../../environments/environment';
+import type { DataflowGraph } from '../../graph/graph';
+import type { Value } from '../values/r-value';
+import type { VariableResolve } from '../../../config';
+/**
+ * Helper function used by {@link resolveIdToValue}, please use that instead, if
+ * you want to resolve the value of an identifier / node
+ *
+ * This function converts an RNode to its Value, but also recursively resolves
+ * aliases and vectors (in case of a vector).
+ *
+ * @param a       - Ast node to resolve
+ * @param resolve - Variable resolve mode
+ * @param env     - Environment to use
+ * @param graph   - Dataflow Graph to use
+ * @param map     - Idmap of Dataflow Graph
+ * @returns resolved value or top/bottom
+ */
+export declare function resolveNode(resolve: VariableResolve, a: RNodeWithParent, env?: REnvironmentInformation, graph?: DataflowGraph, map?: AstIdMap): Value;
+/**
+ * Helper function used by {@link resolveIdToValue}, please use that instead, if
+ * you want to resolve the value of an identifier / node
+ *
+ * This function converts an r-node to a Value Vector {@link vectorFrom}
+ * It also recursively resolves any symbols, values, function calls (only c), in
+ * order to construct the value of the vector to resolve by calling {@link resolveIdToValue}
+ * or {@link resolveNode}
+ *
+ * @param a       - Node of the vector to resolve
+ * @param env     - Environment to use
+ * @param resolve - Variable resolve mode
+ * @param graph   - Dataflow graph
+ * @param map     - Idmap of Dataflow Graph
+ * @returns ValueVector or Top
+ */
+export declare function resolveAsVector(resolve: VariableResolve, a: RNodeWithParent, env: REnvironmentInformation, graph?: DataflowGraph, map?: AstIdMap): Value;

package/dataflow/eval/resolve/resolve.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveNode = resolveNode;
+exports.resolveAsVector = resolveAsVector;
+const r_function_call_1 = require("../../../r-bridge/lang-4.x/ast/model/nodes/r-function-call");
+const type_1 = require("../../../r-bridge/lang-4.x/ast/model/type");
+const assert_1 = require("../../../util/assert");
+const built_in_1 = require("../../environments/built-in");
+const dfg_get_origin_1 = require("../../origin/dfg-get-origin");
+const interval_constants_1 = require("../values/intervals/interval-constants");
+const logical_constants_1 = require("../values/logical/logical-constants");
+const r_value_1 = require("../values/r-value");
+const string_constants_1 = require("../values/string/string-constants");
+const vector_constants_1 = require("../values/vectors/vector-constants");
+const alias_tracking_1 = require("./alias-tracking");
+/**
+ * Helper function used by {@link resolveIdToValue}, please use that instead, if
+ * you want to resolve the value of an identifier / node
+ *
+ * This function converts an RNode to its Value, but also recursively resolves
+ * aliases and vectors (in case of a vector).
+ *
+ * @param a       - Ast node to resolve
+ * @param resolve - Variable resolve mode
+ * @param env     - Environment to use
+ * @param graph   - Dataflow Graph to use
+ * @param map     - Idmap of Dataflow Graph
+ * @returns resolved value or top/bottom
+ */
+function resolveNode(resolve, a, env, graph, map) {
+    if (a.type === type_1.RType.String) {
+        return (0, string_constants_1.stringFrom)(a.content.str);
+    }
+    else if (a.type === type_1.RType.Number) {
+        return (0, interval_constants_1.intervalFrom)(a.content.num, a.content.num);
+    }
+    else if (a.type === type_1.RType.Logical) {
+        return a.content.valueOf() ? logical_constants_1.ValueLogicalTrue : logical_constants_1.ValueLogicalFalse;
+    }
+    else if (a.type === type_1.RType.FunctionCall && env && graph) {
+        const origin = (0, dfg_get_origin_1.getOriginInDfg)(graph, a.info.id)?.[0];
+        if (origin === undefined || origin.type !== 3 /* OriginType.BuiltInFunctionOrigin */) {
+            return r_value_1.Top;
+        }
+        if (origin.proc in built_in_1.BuiltInEvalHandlerMapper) {
+            const handler = built_in_1.BuiltInEvalHandlerMapper[origin.proc];
+            return handler(resolve, a, env, graph, map);
+        }
+    }
+    return r_value_1.Top;
+}
+/**
+ * Helper function used by {@link resolveIdToValue}, please use that instead, if
+ * you want to resolve the value of an identifier / node
+ *
+ * This function converts an r-node to a Value Vector {@link vectorFrom}
+ * It also recursively resolves any symbols, values, function calls (only c), in
+ * order to construct the value of the vector to resolve by calling {@link resolveIdToValue}
+ * or {@link resolveNode}
+ *
+ * @param a       - Node of the vector to resolve
+ * @param env     - Environment to use
+ * @param resolve - Variable resolve mode
+ * @param graph   - Dataflow graph
+ * @param map     - Idmap of Dataflow Graph
+ * @returns ValueVector or Top
+ */
+function resolveAsVector(resolve, a, env, graph, map) {
+    (0, assert_1.guard)(a.type === type_1.RType.FunctionCall);
+    const values = [];
+    for (const arg of a.arguments) {
+        if (arg === r_function_call_1.EmptyArgument) {
+            continue;
+        }
+        if (arg.value === undefined) {
+            return r_value_1.Top;
+        }
+        if (arg.value.type === type_1.RType.Symbol) {
+            const value = (0, alias_tracking_1.resolveIdToValue)(arg.info.id, { environment: env, idMap: map, graph: graph, full: true, resolve });
+            if ((0, r_value_1.isTop)(value)) {
+                return r_value_1.Top;
+            }
+            values.push(value);
+        }
+        else {
+            const val = resolveNode(resolve, arg.value, env, graph, map);
+            if ((0, r_value_1.isTop)(val)) {
+                return r_value_1.Top;
+            }
+            values.push(val);
+        }
+    }
+    return (0, vector_constants_1.vectorFrom)((0, vector_constants_1.flattenVectorElements)(values));
+}
+//# sourceMappingURL=resolve.js.map

package/dataflow/eval/values/general.d.ts

@@ -0,0 +1,27 @@
+import type { RNodeWithParent } from '../../../r-bridge/lang-4.x/ast/model/processing/decorate';
+import type { Lift, Value, ValueSet } from './r-value';
+import { Bottom, Top } from './r-value';
+/**
+ * Takes n potentially lifted ops and returns `Top` or `Bottom` if any is `Top` or `Bottom`.
+ */
+export declare function bottomTopGuard(...a: Lift<unknown>[]): typeof Top | typeof Bottom | undefined;
+/**
+ * Returns a value set, if a is not bottom or top, otherwise undefined.
+ * Useful when working with values returned by {@link resolveIdToValue}
+ *
+ * @param a - value set to check
+ * @returns value set if a is not top or bottom
+ */
+export declare function valueSetGuard(a: Lift<ValueSet<Value[]>>): ValueSet<Value[]> | undefined;
+/**
+ * Constructs an Abstract Value from a normal TS value
+ * @param a - ts value
+ * @returns abstract value
+ */
+export declare function valueFromTsValue(a: unknown): Value;
+/**
+ * Converts a constant from an RNode into an abstract value
+ * @param a - RNode constant
+ * @returns abstract value
+ */
+export declare function valueFromRNodeConstant(a: RNodeWithParent): Value;