@eagleoutice/flowr 2.2.14 → 2.2.15

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

@@ -0,0 +1,34 @@
+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';
+/**
+ * Helper function used by {@link resolveIdToValue}, please use that instead, if
+ * you want to resolve the value of a identifier / node
+ *
+ * This function converts an RNode to its Value, but also recursivly resolves
+ * aliases and vectors (in case of a vector).
+ *
+ * @param a     - Ast node to resolve
+ * @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(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 a identifier / node
+ *
+ * This function converts an rnode to a Value Vector {@link vectorFrom}
+ * It also recursivly 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 graph - Dataflow graph
+ * @param map   - Idmap of Dataflow Graph
+ * @returns ValueVector or Top
+ */
+export declare function resolveAsVector(a: RNodeWithParent, env: REnvironmentInformation, graph?: DataflowGraph, map?: AstIdMap): Value;

package/dataflow/eval/resolve/resolve.js

@@ -0,0 +1,93 @@
+"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 a identifier / node
+ *
+ * This function converts an RNode to its Value, but also recursivly resolves
+ * aliases and vectors (in case of a vector).
+ *
+ * @param a     - Ast node to resolve
+ * @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(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(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 a identifier / node
+ *
+ * This function converts an rnode to a Value Vector {@link vectorFrom}
+ * It also recursivly 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 graph - Dataflow graph
+ * @param map   - Idmap of Dataflow Graph
+ * @returns ValueVector or Top
+ */
+function resolveAsVector(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 });
+            if ((0, r_value_1.isTop)(value)) {
+                return r_value_1.Top;
+            }
+            values.push(value);
+        }
+        else {
+            const val = resolveNode(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;

package/dataflow/eval/values/general.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bottomTopGuard = bottomTopGuard;
+exports.valueSetGuard = valueSetGuard;
+exports.valueFromTsValue = valueFromTsValue;
+exports.valueFromRNodeConstant = valueFromRNodeConstant;
+const type_1 = require("../../../r-bridge/lang-4.x/ast/model/type");
+const interval_constants_1 = require("./intervals/interval-constants");
+const logical_constants_1 = require("./logical/logical-constants");
+const r_value_1 = require("./r-value");
+const string_constants_1 = require("./string/string-constants");
+/**
+ * Takes n potentially lifted ops and returns `Top` or `Bottom` if any is `Top` or `Bottom`.
+ */
+function bottomTopGuard(...a) {
+    if (a.some(r_value_1.isBottom)) {
+        return r_value_1.Bottom;
+    }
+    else if (a.some(r_value_1.isTop)) {
+        return r_value_1.Top;
+    }
+}
+/**
+ * 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
+ */
+function valueSetGuard(a) {
+    return ((0, r_value_1.isBottom)(a) || (0, r_value_1.isTop)(a)) ? undefined : a;
+}
+/**
+ * Constructs an Abstract Value from a normal TS value
+ * @param a - ts value
+ * @returns abstract value
+ */
+function valueFromTsValue(a) {
+    if (a === undefined) {
+        return r_value_1.Bottom;
+    }
+    else if (a === null) {
+        return r_value_1.Top;
+    }
+    else if (typeof a === 'string') {
+        return (0, string_constants_1.stringFrom)(a);
+    }
+    else if (typeof a === 'number') {
+        return (0, interval_constants_1.intervalFrom)(a, a);
+    }
+    else if (typeof a === 'boolean') {
+        return a ? logical_constants_1.ValueLogicalTrue : logical_constants_1.ValueLogicalFalse;
+    }
+    return r_value_1.Top;
+}
+/**
+ * Converts a constant from an RNode into an abstract value
+ * @param a - RNode constant
+ * @returns abstract value
+ */
+function valueFromRNodeConstant(a) {
+    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;
+    }
+    return r_value_1.Top;
+}
+//# sourceMappingURL=general.js.map

package/dataflow/eval/values/intervals/interval-constants.d.ts

@@ -0,0 +1,4 @@
+import type { RNumberValue } from '../../../../r-bridge/lang-4.x/convert-values';
+import type { Lift, ValueInterval, ValueNumber } from '../r-value';
+export declare function intervalFrom(start: RNumberValue | number, end?: number | RNumberValue, startInclusive?: boolean, endInclusive?: boolean): ValueInterval;
+export declare function intervalFromValues(start: Lift<ValueNumber>, end?: Lift<ValueNumber<Lift<RNumberValue>>>, startInclusive?: boolean, endInclusive?: boolean): ValueInterval;

package/dataflow/eval/values/intervals/interval-constants.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.intervalFrom = intervalFrom;
+exports.intervalFromValues = intervalFromValues;
+const r_value_1 = require("../r-value");
+const scalar_consatnts_1 = require("../scalar/scalar-consatnts");
+function intervalFrom(start, end = start, startInclusive = true, endInclusive = true) {
+    return intervalFromValues(typeof start === 'number' ? (0, scalar_consatnts_1.getScalarFromInteger)(start) : (0, scalar_consatnts_1.liftScalar)(start), typeof end === 'number' ? (0, scalar_consatnts_1.getScalarFromInteger)(end) : (0, scalar_consatnts_1.liftScalar)(end), startInclusive, endInclusive);
+}
+function shiftNum(v) {
+    if ((0, r_value_1.isBottom)(v) || (0, r_value_1.isTop)(v)) {
+        return (0, scalar_consatnts_1.liftScalar)(v);
+    }
+    else {
+        return v;
+    }
+}
+function intervalFromValues(start, end = start, startInclusive = true, endInclusive = true) {
+    return {
+        type: 'interval',
+        start: shiftNum(start),
+        end: shiftNum(end),
+        startInclusive,
+        endInclusive,
+    };
+}
+//# sourceMappingURL=interval-constants.js.map

package/dataflow/eval/values/logical/logical-constants.d.ts

@@ -0,0 +1,7 @@
+import type { Lift, TernaryLogical, ValueLogical } from '../r-value';
+export declare function liftLogical(log: Lift<TernaryLogical>): ValueLogical;
+export declare const ValueLogicalTrue: ValueLogical;
+export declare const ValueLogicalFalse: ValueLogical;
+export declare const ValueLogicalMaybe: ValueLogical;
+export declare const ValueLogicalTop: ValueLogical;
+export declare const ValueLogicalBot: ValueLogical;

package/dataflow/eval/values/logical/logical-constants.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValueLogicalBot = exports.ValueLogicalTop = exports.ValueLogicalMaybe = exports.ValueLogicalFalse = exports.ValueLogicalTrue = void 0;
+exports.liftLogical = liftLogical;
+const r_value_1 = require("../r-value");
+function liftLogical(log) {
+    if (log === r_value_1.Top) {
+        return exports.ValueLogicalTop;
+    }
+    else if (log === r_value_1.Bottom) {
+        return exports.ValueLogicalBot;
+    }
+    else if (log === 'maybe') {
+        return exports.ValueLogicalMaybe;
+    }
+    else {
+        return log ? exports.ValueLogicalTrue : exports.ValueLogicalFalse;
+    }
+}
+function makeLogical(log) {
+    return {
+        type: 'logical',
+        value: log
+    };
+}
+exports.ValueLogicalTrue = makeLogical(true);
+exports.ValueLogicalFalse = makeLogical(false);
+exports.ValueLogicalMaybe = makeLogical('maybe');
+exports.ValueLogicalTop = makeLogical(r_value_1.Top);
+exports.ValueLogicalBot = makeLogical(r_value_1.Bottom);
+//# sourceMappingURL=logical-constants.js.map

package/dataflow/eval/values/r-value.d.ts

@@ -0,0 +1,58 @@
+import type { RNumberValue, RStringValue } from '../../../r-bridge/lang-4.x/convert-values';
+import type { RLogicalValue } from '../../../r-bridge/lang-4.x/ast/model/nodes/r-logical';
+export declare const Top: {
+    type: symbol;
+};
+export declare const Bottom: {
+    type: symbol;
+};
+export type Lift<N> = N | typeof Top | typeof Bottom;
+export type Unlift<N> = N extends typeof Top ? never : N extends typeof Bottom ? never : N;
+export interface ValueInterval<Limit extends ValueNumber = ValueNumber> {
+    type: 'interval';
+    start: Limit;
+    startInclusive: boolean;
+    end: Limit;
+    endInclusive: boolean;
+}
+/**
+ * An R vector with either a known set of elements or a known domain.
+ */
+export interface ValueVector<Elements extends Lift<unknown[]> = Lift<Value[]>, Domain extends Lift<Value> = Lift<Value>> {
+    type: 'vector';
+    elements: Elements;
+    /** if we do not know the amount of elements, we can still know the domain */
+    elementDomain: Domain;
+}
+/** describes the static case of we do not know which value */
+export interface ValueSet<Elements extends Lift<unknown[]> = Lift<Value[]>> {
+    type: 'set';
+    elements: Elements;
+}
+export interface ValueNumber<Num extends Lift<RNumberValue> = Lift<RNumberValue>> {
+    type: 'number';
+    value: Num;
+}
+export interface ValueString<Str extends Lift<RStringValue> = Lift<RStringValue>> {
+    type: 'string';
+    value: Str;
+}
+export interface ValueMissing {
+    type: 'missing';
+}
+export type TernaryLogical = RLogicalValue | 'maybe';
+export interface ValueLogical {
+    type: 'logical';
+    value: Lift<TernaryLogical>;
+}
+export type Value = Lift<ValueInterval | ValueVector | ValueSet | ValueNumber | ValueString | ValueLogical | ValueMissing>;
+export type ValueType<V> = V extends {
+    type: infer T;
+} ? T : never;
+export type ValueTypes = ValueType<Value>;
+export declare function typeOfValue<V extends Value>(value: V): V['type'];
+export declare function isTop<V extends Lift<unknown>>(value: V): value is typeof Top;
+export declare function isBottom<V extends Lift<unknown>>(value: V): value is typeof Bottom;
+export declare function isValue<V extends Lift<unknown>>(value: V): value is Unlift<V>;
+export declare function asValue<V extends Lift<unknown>>(value: V): Unlift<V>;
+export declare function stringifyValue(value: Lift<Value>): string;

package/dataflow/eval/values/r-value.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Bottom = exports.Top = void 0;
+exports.typeOfValue = typeOfValue;
+exports.isTop = isTop;
+exports.isBottom = isBottom;
+exports.isValue = isValue;
+exports.asValue = asValue;
+exports.stringifyValue = stringifyValue;
+const assert_1 = require("../../../util/assert");
+exports.Top = { type: Symbol('⊤') };
+exports.Bottom = { type: Symbol('⊥') };
+function typeOfValue(value) {
+    return value.type;
+}
+// @ts-expect-error -- this is a save cast
+function isTop(value) {
+    return value === exports.Top;
+}
+// @ts-expect-error -- this is a save cast
+function isBottom(value) {
+    return value === exports.Bottom;
+}
+function isValue(value) {
+    return !isTop(value) && !isBottom(value);
+}
+function asValue(value) {
+    (0, assert_1.guard)(isValue(value), 'Expected a value, but got a top or bottom value');
+    return value;
+}
+function tryStringifyBoTop(value, otherwise, onTop = () => '⊤', onBottom = () => '⊥') {
+    if (isTop(value)) {
+        return onTop();
+    }
+    else if (isBottom(value)) {
+        return onBottom();
+    }
+    else {
+        return otherwise(value);
+    }
+}
+function stringifyRNumberSuffix(value) {
+    let suffix = '';
+    if (value.markedAsInt) {
+        suffix += 'L';
+    }
+    if (value.complexNumber) {
+        suffix += 'i';
+    }
+    // do something about iL even though it is impossible?
+    return suffix;
+}
+function renderString(value) {
+    const quote = value.quotes;
+    const raw = value.flag === 'raw';
+    if (raw) {
+        return `r${quote}(${value.str})${quote}`;
+    }
+    else {
+        return `${quote}${JSON.stringify(value.str).slice(1, -1)}${quote}`;
+    }
+}
+function stringifyValue(value) {
+    return tryStringifyBoTop(value, v => {
+        const t = v.type;
+        switch (t) {
+            case 'interval':
+                return `${v.startInclusive ? '[' : '('}${stringifyValue(v.start)}, ${stringifyValue(v.end)}${v.endInclusive ? ']' : ')'}`;
+            case 'vector':
+                return tryStringifyBoTop(v.elements, e => {
+                    return `<${stringifyValue(v.elementDomain)}> c(${e.map(stringifyValue).join(',')})`;
+                }, () => `⊤ (vector, ${stringifyValue(v.elementDomain)})`, () => `⊥ (vector, ${stringifyValue(v.elementDomain)})`);
+            case 'set':
+                return tryStringifyBoTop(v.elements, e => {
+                    return e.length === 1 ? stringifyValue(e[0]) : `{ ${e.map(stringifyValue).join(',')} }`;
+                }, () => '⊤ (set)', () => '⊥ (set)');
+            case 'number':
+                return tryStringifyBoTop(v.value, n => `${n.num}${stringifyRNumberSuffix(n)}`, () => '⊤ (number)', () => '⊥ (number)');
+            case 'string':
+                return tryStringifyBoTop(v.value, renderString, () => '⊤ (string)', () => '⊥ (string)');
+            case 'logical':
+                return tryStringifyBoTop(v.value, l => l === 'maybe' ? 'maybe' : l ? 'TRUE' : 'FALSE', () => '⊤ (logical)', () => '⊥ (logical)');
+            case 'missing':
+                return '(missing)';
+            default:
+                (0, assert_1.assertUnreachable)(t);
+        }
+    });
+}
+//# sourceMappingURL=r-value.js.map

package/dataflow/eval/values/scalar/scalar-consatnts.d.ts

@@ -0,0 +1,15 @@
+import type { Lift, ValueNumber } from '../r-value';
+import type { RNumberValue } from '../../../../r-bridge/lang-4.x/convert-values';
+export declare function getScalarFromInteger(num: number, markedAsInt?: boolean, complexNumber?: boolean): ValueNumber<RNumberValue>;
+export declare function liftScalar(value: Lift<RNumberValue>): ValueNumber;
+export declare const ValueIntegerOne: ValueNumber<RNumberValue>;
+export declare const ValueNumberComplexOne: ValueNumber<RNumberValue>;
+export declare const ValueIntegerZero: ValueNumber<RNumberValue>;
+export declare const ValueIntegerNegativeOne: ValueNumber<RNumberValue>;
+export declare const ValueIntegerPositiveInfinity: ValueNumber<RNumberValue>;
+export declare const ValueNumberPositiveInfinity: ValueNumber<RNumberValue>;
+export declare const ValueIntegerNegativeInfinity: ValueNumber<RNumberValue>;
+export declare const ValueNumberEpsilon: ValueNumber<RNumberValue>;
+export declare const ValueNumberOneHalf: ValueNumber<RNumberValue>;
+export declare const ValueIntegerTop: ValueNumber<Lift<RNumberValue>>;
+export declare const ValueIntegerBottom: ValueNumber<Lift<RNumberValue>>;

package/dataflow/eval/values/scalar/scalar-consatnts.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValueIntegerBottom = exports.ValueIntegerTop = exports.ValueNumberOneHalf = exports.ValueNumberEpsilon = exports.ValueIntegerNegativeInfinity = exports.ValueNumberPositiveInfinity = exports.ValueIntegerPositiveInfinity = exports.ValueIntegerNegativeOne = exports.ValueIntegerZero = exports.ValueNumberComplexOne = exports.ValueIntegerOne = void 0;
+exports.getScalarFromInteger = getScalarFromInteger;
+exports.liftScalar = liftScalar;
+const r_value_1 = require("../r-value");
+function getScalarFromInteger(num, markedAsInt = Number.isInteger(num), complexNumber = false) {
+    return {
+        type: 'number',
+        value: {
+            markedAsInt,
+            num,
+            complexNumber
+        }
+    };
+}
+function liftScalar(value) {
+    return {
+        type: 'number',
+        value: value
+    };
+}
+const epsilon = 1e-7;
+exports.ValueIntegerOne = getScalarFromInteger(1);
+exports.ValueNumberComplexOne = getScalarFromInteger(1, false, true);
+exports.ValueIntegerZero = getScalarFromInteger(0);
+exports.ValueIntegerNegativeOne = getScalarFromInteger(-1);
+exports.ValueIntegerPositiveInfinity = getScalarFromInteger(Number.POSITIVE_INFINITY);
+exports.ValueNumberPositiveInfinity = getScalarFromInteger(Number.POSITIVE_INFINITY, false);
+exports.ValueIntegerNegativeInfinity = getScalarFromInteger(Number.NEGATIVE_INFINITY);
+exports.ValueNumberEpsilon = getScalarFromInteger(epsilon, false);
+exports.ValueNumberOneHalf = getScalarFromInteger(0.5, false);
+exports.ValueIntegerTop = liftScalar(r_value_1.Top);
+exports.ValueIntegerBottom = liftScalar(r_value_1.Bottom);
+//# sourceMappingURL=scalar-consatnts.js.map

package/dataflow/eval/values/sets/set-constants.d.ts

@@ -0,0 +1,7 @@
+import type { Lift, Value, ValueSet } from '../r-value';
+import { Top } from '../r-value';
+export declare function setFrom<V extends Value[]>(...elements: V): Lift<ValueSet<Value[]>>;
+export declare function isSet<V extends Value>(element: V): boolean;
+export declare const ValueEmptySet: Lift<ValueSet<Value[]>>;
+export declare const ValueSetTop: ValueSet<typeof Top>;
+export declare const ValueSetBottom: ValueSet<typeof Top>;

package/dataflow/eval/values/sets/set-constants.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValueSetBottom = exports.ValueSetTop = exports.ValueEmptySet = void 0;
+exports.setFrom = setFrom;
+exports.isSet = isSet;
+const general_1 = require("../general");
+const r_value_1 = require("../r-value");
+function flattenSetElements(s) {
+    return (0, general_1.bottomTopGuard)(s) ?? s.flatMap(e => {
+        return e.type === 'set' ? flattenSetElements(e.elements) : e;
+    });
+}
+function setFrom(...elements) {
+    const vals = elements.flatMap(e => {
+        return e.type === 'set' ? flattenSetElements(e.elements) : e;
+    });
+    return (0, general_1.bottomTopGuard)(...vals) ?? {
+        type: 'set',
+        elements: vals
+    };
+}
+function isSet(element) {
+    return element.type === 'set';
+}
+exports.ValueEmptySet = setFrom();
+exports.ValueSetTop = {
+    type: 'set',
+    elements: r_value_1.Top
+};
+exports.ValueSetBottom = {
+    type: 'set',
+    elements: r_value_1.Top
+};
+//# sourceMappingURL=set-constants.js.map

package/dataflow/eval/values/string/string-constants.d.ts

@@ -0,0 +1,8 @@
+import type { RStringValue } from '../../../../r-bridge/lang-4.x/convert-values';
+import type { Lift, Value, ValueString } from '../r-value';
+export declare function stringFrom(str: RStringValue | string): ValueString;
+export declare function liftString(str: Lift<RStringValue>): ValueString;
+export declare function collectStrings(a: Value[]): string[] | undefined;
+export declare const ValueEmptyString: ValueString<Lift<RStringValue>>;
+export declare const ValueStringTop: ValueString<Lift<RStringValue>>;
+export declare const ValueStringBot: ValueString<Lift<RStringValue>>;

package/dataflow/eval/values/string/string-constants.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValueStringBot = exports.ValueStringTop = exports.ValueEmptyString = void 0;
+exports.stringFrom = stringFrom;
+exports.liftString = liftString;
+exports.collectStrings = collectStrings;
+const general_1 = require("../general");
+const r_value_1 = require("../r-value");
+function stringFrom(str) {
+    return {
+        type: 'string',
+        value: typeof str === 'string' ? {
+            quotes: '"',
+            str: str
+        } : str,
+    };
+}
+function liftString(str) {
+    return {
+        type: 'string',
+        value: str
+    };
+}
+function collectStrings(a) {
+    if ((0, general_1.bottomTopGuard)(a)) {
+        return undefined;
+    }
+    const values = [];
+    for (const value of a) {
+        if (value.type !== 'string' || !(0, r_value_1.isValue)(value) || !(0, r_value_1.isValue)(value.value)) {
+            return undefined;
+        }
+        values.push(value.value.str);
+    }
+    return values;
+}
+exports.ValueEmptyString = stringFrom('');
+exports.ValueStringTop = liftString(r_value_1.Top);
+exports.ValueStringBot = liftString(r_value_1.Bottom);
+//# sourceMappingURL=string-constants.js.map

package/dataflow/eval/values/vectors/vector-constants.d.ts

@@ -0,0 +1,14 @@
+import type { Lift, Value, ValueVector } from '../r-value';
+/**
+ * Creates an abstract vector from abstract values
+ * @param elements - elements that the vector should contain
+ * @returns abstract ValueVector
+ */
+export declare function vectorFrom<V extends Lift<Value[]>>(elements: V): ValueVector<V>;
+/**
+ * Flattens all elements inside of a vector
+ * A set containing only one element is also replaced by its only element
+ * @param s - vector to flatten
+ * @returns flattened vactor, if all elements are not bottom / top
+ */
+export declare function flattenVectorElements(s: Lift<Value[]>): Lift<Value[]>;

package/dataflow/eval/values/vectors/vector-constants.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vectorFrom = vectorFrom;
+exports.flattenVectorElements = flattenVectorElements;
+const r_value_1 = require("../r-value");
+const assert_1 = require("../../../../util/assert");
+const general_1 = require("../general");
+/**
+ * Creates an abstract vector from abstract values
+ * @param elements - elements that the vector should contain
+ * @returns abstract ValueVector
+ */
+function vectorFrom(elements) {
+    (0, assert_1.guard)((0, r_value_1.isTop)(elements) || (0, r_value_1.isBottom)(elements) || Array.isArray(elements), 'Expected array of values');
+    return {
+        type: 'vector',
+        elements,
+        elementDomain: r_value_1.Top
+    };
+}
+/**
+ * Flattens all elements inside of a vector
+ * A set containing only one element is also replaced by its only element
+ * @param s - vector to flatten
+ * @returns flattened vactor, if all elements are not bottom / top
+ */
+function flattenVectorElements(s) {
+    return (0, general_1.bottomTopGuard)(s) ?? s.flatMap(e => {
+        return e.type === 'vector' ? flattenVectorElements(e.elements) :
+            e.type === 'set' && (0, r_value_1.isValue)(e.elements) && e.elements.length === 1 ?
+                e.elements[0].type === 'vector' ? flattenVectorElements(e.elements[0].elements) : e.elements :
+                e;
+    });
+}
+//# sourceMappingURL=vector-constants.js.map

package/dataflow/graph/unknown-replacement.d.ts

@@ -0,0 +1,11 @@
+import type { NodeId } from '../../r-bridge/lang-4.x/ast/model/processing/node-id';
+import type { REnvironmentInformation } from '../environments/environment';
+export type ReplacementOperatorHandlerArgs = {
+    operator: string;
+    target: string | undefined;
+    env: REnvironmentInformation;
+    id: NodeId;
+};
+export type ReplacementOperatorHandler = (args: ReplacementOperatorHandlerArgs) => void;
+export declare function onReplacementOperator(handler: ReplacementOperatorHandler): void;
+export declare function handleReplacementOperator(args: ReplacementOperatorHandlerArgs): void;