@eagleoutice/flowr 2.4.0 → 2.4.1

package/README.md

@@ -24,7 +24,7 @@ It offers a wide variety of features, for example:
     
     ```shell
     $ docker run -it --rm eagleoutice/flowr # or npm run flowr 
-    flowR repl using flowR v2.3.0, R v4.5.0 (r-shell engine)
+    flowR repl using flowR v2.4.0, R v4.5.0 (r-shell engine)
     R> :query @linter "read.csv(\"/root/x.txt\")"
     ```
     
@@ -33,7 +33,7 @@ It offers a wide variety of features, for example:
     
     
     ```text
-    Query: linter (3 ms)
+    Query: linter (2 ms)
        ╰ **Deprecated Functions** (deprecated-functions):
            ╰ _Metadata_: <code>{"totalDeprecatedCalls":0,"totalDeprecatedFunctionDefinitions":0,"searchTimeMs":0,"processTimeMs":0}</code>
        ╰ **File Path Validity** (file-path-validity):
@@ -45,16 +45,16 @@ It offers a wide variety of features, for example:
        ╰ **Absolute Paths** (absolute-file-paths):
            ╰ certain:
                ╰ Path `/root/x.txt` at 1.1-23
-           ╰ _Metadata_: <code>{"totalConsidered":1,"totalUnknown":0,"searchTimeMs":1,"processTimeMs":0}</code>
+           ╰ _Metadata_: <code>{"totalConsidered":1,"totalUnknown":0,"searchTimeMs":0,"processTimeMs":0}</code>
        ╰ **Unused Definitions** (unused-definitions):
            ╰ _Metadata_: <code>{"totalConsidered":0,"searchTimeMs":0,"processTimeMs":0}</code>
        ╰ **Naming Convention** (naming-convention):
-           ╰ _Metadata_: <code>{"numMatches":0,"numBreak":0,"searchTimeMs":0,"processTimeMs":0}</code>
+           ╰ _Metadata_: <code>{"numMatches":0,"numBreak":0,"searchTimeMs":1,"processTimeMs":0}</code>
        ╰ **Dataframe Access Validation** (dataframe-access-validation):
            ╰ _Metadata_: <code>{"numOperations":0,"numAccesses":0,"totalAccessed":0,"searchTimeMs":0,"processTimeMs":0}</code>
        ╰ **Dead Code** (dead-code):
-           ╰ _Metadata_: <code>{"consideredNodes":5,"searchTimeMs":1,"processTimeMs":0}</code>
-    All queries together required ≈3 ms (1ms accuracy, total 9 ms)
+           ╰ _Metadata_: <code>{"consideredNodes":5,"searchTimeMs":0,"processTimeMs":0}</code>
+    All queries together required ≈2 ms (1ms accuracy, total 8 ms)
     ```
     
     
@@ -76,7 +76,7 @@ It offers a wide variety of features, for example:
     
     _Results (prettified and summarized):_
     
-    Query: **linter** (14 ms)\
+    Query: **linter** (13 ms)\
     &nbsp;&nbsp;&nbsp;╰ **Deprecated Functions** (deprecated-functions):\
     &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ _Metadata_: <code>{"totalDeprecatedCalls":0,"totalDeprecatedFunctionDefinitions":0,"searchTimeMs":2,"processTimeMs":0}</code>\
     &nbsp;&nbsp;&nbsp;╰ **File Path Validity** (file-path-validity):\
@@ -84,24 +84,24 @@ It offers a wide variety of features, for example:
     &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ Path `/root/x.txt` at 1.1-23\
     &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ _Metadata_: <code>{"totalReads":1,"totalUnknown":0,"totalWritesBeforeAlways":0,"totalValid":0,"searchTimeMs":4,"processTimeMs":1}</code>\
     &nbsp;&nbsp;&nbsp;╰ **Seeded Randomness** (seeded-randomness):\
-    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ _Metadata_: <code>{"consumerCalls":0,"callsWithFunctionProducers":0,"callsWithAssignmentProducers":0,"callsWithNonConstantProducers":0,"searchTimeMs":0,"processTimeMs":1}</code>\
+    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ _Metadata_: <code>{"consumerCalls":0,"callsWithFunctionProducers":0,"callsWithAssignmentProducers":0,"callsWithNonConstantProducers":0,"searchTimeMs":0,"processTimeMs":0}</code>\
     &nbsp;&nbsp;&nbsp;╰ **Absolute Paths** (absolute-file-paths):\
     &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ certain:\
     &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ Path `/root/x.txt` at 1.1-23\
-    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ _Metadata_: <code>{"totalConsidered":1,"totalUnknown":0,"searchTimeMs":1,"processTimeMs":1}</code>\
+    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ _Metadata_: <code>{"totalConsidered":1,"totalUnknown":0,"searchTimeMs":1,"processTimeMs":0}</code>\
     &nbsp;&nbsp;&nbsp;╰ **Unused Definitions** (unused-definitions):\
-    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ _Metadata_: <code>{"totalConsidered":0,"searchTimeMs":0,"processTimeMs":0}</code>\
+    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ _Metadata_: <code>{"totalConsidered":0,"searchTimeMs":1,"processTimeMs":0}</code>\
     &nbsp;&nbsp;&nbsp;╰ **Naming Convention** (naming-convention):\
     &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ _Metadata_: <code>{"numMatches":0,"numBreak":0,"searchTimeMs":0,"processTimeMs":0}</code>\
     &nbsp;&nbsp;&nbsp;╰ **Dataframe Access Validation** (dataframe-access-validation):\
     &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ _Metadata_: <code>{"numOperations":0,"numAccesses":0,"totalAccessed":0,"searchTimeMs":0,"processTimeMs":2}</code>\
     &nbsp;&nbsp;&nbsp;╰ **Dead Code** (dead-code):\
-    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ _Metadata_: <code>{"consideredNodes":5,"searchTimeMs":0,"processTimeMs":0}</code>\
-    _All queries together required ≈14 ms (1ms accuracy, total 214 ms)_
+    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;╰ _Metadata_: <code>{"consideredNodes":5,"searchTimeMs":1,"processTimeMs":0}</code>\
+    _All queries together required ≈13 ms (1ms accuracy, total 215 ms)_
     
     <details> <summary style="color:gray">Show Detailed Results as Json</summary>
     
-    The analysis required _213.8 ms_ (including parsing and normalization and the query) within the generation environment.	
+    The analysis required _214.5 ms_ (including parsing and normalization and the query) within the generation environment.	
     
     In general, the JSON contains the Ids of the nodes in question as they are present in the normalized AST or the dataflow graph of flowR.
     Please consult the [Interface](https://github.com/flowr-analysis/flowr/wiki/Interface) wiki page for more information on how to get those.
@@ -152,7 +152,7 @@ It offers a wide variety of features, for example:
               "callsWithAssignmentProducers": 0,
               "callsWithNonConstantProducers": 0,
               "searchTimeMs": 0,
-              "processTimeMs": 1
+              "processTimeMs": 0
             }
           },
           "absolute-file-paths": {
@@ -172,14 +172,14 @@ It offers a wide variety of features, for example:
               "totalConsidered": 1,
               "totalUnknown": 0,
               "searchTimeMs": 1,
-              "processTimeMs": 1
+              "processTimeMs": 0
             }
           },
           "unused-definitions": {
             "results": [],
             ".meta": {
               "totalConsidered": 0,
-              "searchTimeMs": 0,
+              "searchTimeMs": 1,
               "processTimeMs": 0
             }
           },
@@ -206,17 +206,17 @@ It offers a wide variety of features, for example:
             "results": [],
             ".meta": {
               "consideredNodes": 5,
-              "searchTimeMs": 0,
+              "searchTimeMs": 1,
               "processTimeMs": 0
             }
           }
         },
         ".meta": {
-          "timing": 14
+          "timing": 13
         }
       },
       ".meta": {
-        "timing": 14
+        "timing": 13
       }
     }
     ```
@@ -283,7 +283,7 @@ It offers a wide variety of features, for example:
     
     ```shell
     $ docker run -it --rm eagleoutice/flowr # or npm run flowr 
-    flowR repl using flowR v2.3.0, R v4.5.0 (r-shell engine)
+    flowR repl using flowR v2.4.0, R v4.5.0 (r-shell engine)
     R> :slicer test/testfiles/example.R --criterion "11@sum"
     ```
     
@@ -330,7 +330,7 @@ It offers a wide variety of features, for example:
         
 
 * 🚀 **fast data- and control-flow graphs**\
-  Within just <i><span title="This measurement is automatically fetched from the latest benchmark!">136.8 ms</span></i> (as of Jul 21, 2025), 
+  Within just <i><span title="This measurement is automatically fetched from the latest benchmark!">139.1 ms</span></i> (as of Aug 6, 2025), 
   _flowR_ can analyze the data- and control-flow of the average real-world R script. See the [benchmarks](https://flowr-analysis.github.io/flowr/wiki/stats/benchmark) for more information,
   and consult the [wiki pages](https://github.com/flowr-analysis/flowr/wiki/Dataflow-Graph) for more details on the dataflow graph.
 
@@ -366,7 +366,7 @@ It offers a wide variety of features, for example:
     
     ```shell
     $ docker run -it --rm eagleoutice/flowr # or npm run flowr 
-    flowR repl using flowR v2.3.0, R v4.5.0 (r-shell engine)
+    flowR repl using flowR v2.4.0, R v4.5.0 (r-shell engine)
     R> :dataflow* test/testfiles/example.R
     ```
     
@@ -667,7 +667,7 @@ It offers a wide variety of features, for example:
     ```
     
     	
-    (The analysis required _13.8 ms_ (including parse and normalize, using the [r-shell](https://github.com/flowr-analysis/flowr/wiki/Engines) engine) within the generation environment.)
+    (The analysis required _13.9 ms_ (including parse and normalize, using the [r-shell](https://github.com/flowr-analysis/flowr/wiki/Engines) engine) within the generation environment.)
     
     
     

package/benchmark/stats/size-of.js

@@ -5,7 +5,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getSizeOfDfGraph = getSizeOfDfGraph;
 exports.safeSizeOf = safeSizeOf;
-const environment_1 = require("../../dataflow/environments/environment");
 const vertex_1 = require("../../dataflow/graph/vertex");
 const identifier_1 = require("../../dataflow/environments/identifier");
 const object_sizeof_1 = __importDefault(require("object-sizeof"));
@@ -15,12 +14,13 @@ function killBuiltInEnv(env) {
     if (env === undefined) {
         return undefined;
     }
-    else if (env.id === environment_1.BuiltInEnvironment.id) {
+    else if (env.builtInEnv) {
         /* in this case, the reference would be shared for sure */
         return {
             id: env.id,
             parent: killBuiltInEnv(env.parent),
-            memory: new Map()
+            memory: new Map(),
+            builtInEnv: true
         };
     }
     const memory = new Map();

package/cli/repl/commands/repl-query.js

@@ -59,7 +59,7 @@ async function processQueryArgs(line, parser, output, config) {
     }
     const processed = await getDataflow(config, parser, args.join(' '));
     return {
-        query: await Promise.resolve((0, query_1.executeQueries)({ dataflow: processed.dataflow, ast: processed.normalize, config: config }, parsedQuery)),
+        query: await Promise.resolve((0, query_1.executeQueries)({ dataflow: processed.dataflow, ast: processed.normalize, config }, parsedQuery)),
         processed
     };
 }

package/core/pipeline-executor.js

@@ -2,8 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PipelineExecutor = void 0;
 const assert_1 = require("../util/assert");
-const built_in_1 = require("../dataflow/environments/built-in");
-const built_in_config_1 = require("../dataflow/environments/built-in-config");
 /**
  * The pipeline executor allows to execute arbitrary {@link Pipeline|pipelines} in a step-by-step fashion.
  * If you are not yet in the possession of a {@link Pipeline|pipeline}, you can use the {@link createPipeline} function
@@ -110,12 +108,6 @@ class PipelineExecutor {
         this.length = pipeline.order.length;
         this.input = input;
         this.flowrConfig = flowrConfig;
-        const builtIns = flowrConfig.semantics.environment.overwriteBuiltIns;
-        if (!builtIns.loadDefaults) {
-            built_in_1.BuiltInMemory.clear();
-            built_in_1.EmptyBuiltInMemory.clear();
-        }
-        (0, built_in_config_1.registerBuiltInDefinitions)(builtIns.definitions);
     }
     /**
      * Retrieve the {@link Pipeline|pipeline} that is currently being.

package/core/steps/all/static-slicing/00-slice.js

@@ -10,7 +10,7 @@ var SliceDirection;
 })(SliceDirection || (exports.SliceDirection = SliceDirection = {}));
 function processor(results, input, _config) {
     const direction = input.direction ?? SliceDirection.Backward;
-    return (0, static_slicer_1.staticSlice)(results.dataflow.graph, results.normalize, input.criterion, direction, input.threshold);
+    return (0, static_slicer_1.staticSlice)(results.dataflow, results.normalize, input.criterion, direction, input.threshold);
 }
 exports.STATIC_SLICE = {
     name: 'slice',

package/dataflow/environments/append.js

@@ -25,7 +25,7 @@ function appendIEnvironmentWith(base, next) {
             map.set(key, value);
         }
     }
-    const parent = base.parent === environment_1.BuiltInEnvironment ? environment_1.BuiltInEnvironment : appendIEnvironmentWith(base.parent, next.parent);
+    const parent = base.parent.builtInEnv ? base.parent : appendIEnvironmentWith(base.parent, next.parent);
     const out = new environment_1.Environment(parent);
     out.memory = map;
     return out;

package/dataflow/environments/built-in-config.d.ts

@@ -1,4 +1,5 @@
 import type { BuiltInMappingName, ConfigOfBuiltInMappingName } from './built-in';
+import { BuiltIns } from './built-in';
 import type { Identifier } from './identifier';
 export interface BaseBuiltInDefinition {
     /** The type of the built-in configuration */
@@ -45,7 +46,14 @@ export type BuiltInDefinition = BuiltInConstantDefinition<any> | BuiltInFunction
  * @see DefaultBuiltinConfig
  */
 export type BuiltInDefinitions = BuiltInDefinition[];
-export declare function registerBuiltInFunctions<BuiltInProcessor extends BuiltInMappingName>({ names, processor, config, assumePrimitive }: BuiltInFunctionDefinition<BuiltInProcessor>): void;
-export declare function registerReplacementFunctions({ names, suffixes, assumePrimitive, config }: BuiltInReplacementDefinition): void;
-export declare function registerBuiltInDefinition(definition: BuiltInDefinition): void;
-export declare function registerBuiltInDefinitions(definitions: BuiltInDefinitions): void;
+/**
+ * Get the {@link BuiltIns#builtInMemory} and {@link BuiltIns#emptyBuiltInMemory} for the {@link DefaultBuiltinConfig}.
+ */
+export declare function getDefaultBuiltInDefinitions(): BuiltIns;
+/**
+ * Get the {@link BuiltIns#builtInMemory} and {@link BuiltIns#emptyBuiltInMemory} for the given list of built-in definitions.
+ *
+ * @param definitions - the list of built-in definitions
+ * @param loadDefaults - whether to first add the {@link DefaultBuiltinConfig} before the given {@link definitions}
+ */
+export declare function getBuiltInDefinitions(definitions: BuiltInDefinitions, loadDefaults: boolean | undefined): BuiltIns;

package/dataflow/environments/built-in-config.js

@@ -1,92 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerBuiltInFunctions = registerBuiltInFunctions;
-exports.registerReplacementFunctions = registerReplacementFunctions;
-exports.registerBuiltInDefinition = registerBuiltInDefinition;
-exports.registerBuiltInDefinitions = registerBuiltInDefinitions;
+exports.getDefaultBuiltInDefinitions = getDefaultBuiltInDefinitions;
+exports.getBuiltInDefinitions = getBuiltInDefinitions;
 const built_in_1 = require("./built-in");
-const identifier_1 = require("./identifier");
-const assert_1 = require("../../util/assert");
-function registerBuiltInConstant({ names, value, assumePrimitive }) {
-    for (const name of names) {
-        const id = (0, built_in_1.builtInId)(name);
-        const d = [{
-                type: identifier_1.ReferenceType.BuiltInConstant,
-                definedAt: id,
-                controlDependencies: undefined,
-                value,
-                name,
-                nodeId: id
-            }];
-        built_in_1.BuiltInMemory.set(name, d);
-        if (assumePrimitive) {
-            built_in_1.EmptyBuiltInMemory.set(name, d);
-        }
+const default_builtin_config_1 = require("./default-builtin-config");
+/**
+ * Get the {@link BuiltIns#builtInMemory} and {@link BuiltIns#emptyBuiltInMemory} for the {@link DefaultBuiltinConfig}.
+ */
+function getDefaultBuiltInDefinitions() {
+    const builtIns = new built_in_1.BuiltIns();
+    for (const definition of default_builtin_config_1.DefaultBuiltinConfig) {
+        builtIns.registerBuiltInDefinition(definition);
     }
+    return builtIns;
 }
-function registerBuiltInFunctions({ names, processor, config, assumePrimitive }) {
-    const mappedProcessor = built_in_1.BuiltInProcessorMapper[processor];
-    (0, assert_1.guard)(mappedProcessor !== undefined, () => `Processor for ${processor} is undefined! Please pass a valid builtin name ${JSON.stringify(Object.keys(built_in_1.BuiltInProcessorMapper))}!`);
-    for (const name of names) {
-        (0, assert_1.guard)(processor !== undefined, `Processor for ${name} is undefined, maybe you have an import loop? You may run 'npm run detect-circular-deps' - although by far not all are bad`);
-        const id = (0, built_in_1.builtInId)(name);
-        const d = [{
-                type: identifier_1.ReferenceType.BuiltInFunction,
-                definedAt: id,
-                controlDependencies: undefined,
-                /* eslint-disable-next-line @typescript-eslint/no-explicit-any,@typescript-eslint/no-unsafe-argument */
-                processor: (name, args, rootId, data) => mappedProcessor(name, args, rootId, data, config),
-                config,
-                name,
-                nodeId: id
-            }];
-        built_in_1.BuiltInMemory.set(name, d);
-        if (assumePrimitive) {
-            built_in_1.EmptyBuiltInMemory.set(name, d);
-        }
+/**
+ * Get the {@link BuiltIns#builtInMemory} and {@link BuiltIns#emptyBuiltInMemory} for the given list of built-in definitions.
+ *
+ * @param definitions - the list of built-in definitions
+ * @param loadDefaults - whether to first add the {@link DefaultBuiltinConfig} before the given {@link definitions}
+ */
+function getBuiltInDefinitions(definitions, loadDefaults) {
+    let builtIns = new built_in_1.BuiltIns();
+    if (loadDefaults) {
+        builtIns = getDefaultBuiltInDefinitions();
     }
-}
-/* registers all combinations of replacements */
-function registerReplacementFunctions({ names, suffixes, assumePrimitive, config }) {
-    const replacer = built_in_1.BuiltInProcessorMapper['builtin:replacement'];
-    (0, assert_1.guard)(replacer !== undefined, () => 'Processor for builtin:replacement is undefined!');
-    for (const assignment of names) {
-        for (const suffix of suffixes) {
-            const effectiveName = `${assignment}${suffix}`;
-            const id = (0, built_in_1.builtInId)(effectiveName);
-            const d = [{
-                    type: identifier_1.ReferenceType.BuiltInFunction,
-                    definedAt: id,
-                    processor: (name, args, rootId, data) => replacer(name, args, rootId, data, { makeMaybe: true, assignmentOperator: suffix, readIndices: config.readIndices }),
-                    config: {
-                        ...config,
-                        assignmentOperator: suffix,
-                        makeMaybe: true
-                    },
-                    name: effectiveName,
-                    controlDependencies: undefined,
-                    nodeId: id
-                }];
-            built_in_1.BuiltInMemory.set(effectiveName, d);
-            if (assumePrimitive) {
-                built_in_1.EmptyBuiltInMemory.set(effectiveName, d);
-            }
-        }
-    }
-}
-function registerBuiltInDefinition(definition) {
-    switch (definition.type) {
-        case 'constant':
-            return registerBuiltInConstant(definition);
-        case 'function':
-            return registerBuiltInFunctions(definition);
-        case 'replacement':
-            return registerReplacementFunctions(definition);
-    }
-}
-function registerBuiltInDefinitions(definitions) {
     for (const definition of definitions) {
-        registerBuiltInDefinition(definition);
+        builtIns.registerBuiltInDefinition(definition);
     }
+    return builtIns;
 }
 //# sourceMappingURL=built-in-config.js.map

package/dataflow/environments/built-in.d.ts

@@ -30,9 +30,10 @@ import { processRm } from '../internal/process/functions/call/built-in/built-in-
 import { processEvalCall } from '../internal/process/functions/call/built-in/built-in-eval';
 import type { REnvironmentInformation } from './environment';
 import type { Value } from '../eval/values/r-value';
-import { resolveAsVector, resolveAsSeq, resolveAsMinus, resolveAsPlus } from '../eval/resolve/resolve';
+import { resolveAsMinus, resolveAsPlus, resolveAsSeq, resolveAsVector } from '../eval/resolve/resolve';
 import type { DataflowGraph } from '../graph/graph';
 import type { VariableResolve } from '../../config';
+import type { BuiltInConstantDefinition, BuiltInDefinition, BuiltInFunctionDefinition, BuiltInReplacementDefinition } from './built-in-config';
 export type BuiltIn = `built-in:${string}`;
 export declare function builtInId(name: string): BuiltIn;
 export declare function isBuiltIn(name: NodeId | string): name is BuiltIn;
@@ -64,7 +65,7 @@ export interface DefaultBuiltInProcessorConfiguration extends ForceArguments {
 }
 export type BuiltInEvalHandler = (resolve: VariableResolve, a: RNodeWithParent, env?: REnvironmentInformation, graph?: DataflowGraph, map?: AstIdMap) => Value;
 declare function defaultBuiltInProcessor<OtherInfo>(name: RSymbol<OtherInfo & ParentInformation>, args: readonly RFunctionArgument<OtherInfo & ParentInformation>[], rootId: NodeId, data: DataflowProcessorInformation<OtherInfo & ParentInformation>, { returnsNthArgument, useAsProcessor, forceArgs, readAllArguments, cfg, hasUnknownSideEffects, treatAsFnCall }: DefaultBuiltInProcessorConfiguration): DataflowInformation;
-export declare function registerBuiltInFunctions<Config extends object, Proc extends BuiltInIdentifierProcessorWithConfig<Config>>(both: boolean, names: readonly Identifier[], processor: Proc, config: Config): void;
+export declare function registerBuiltInFunctions<Config extends object, Proc extends BuiltInIdentifierProcessorWithConfig<Config>>(both: boolean, names: readonly Identifier[], processor: Proc, config: Config, builtIns: BuiltIns): void;
 export declare const BuiltInProcessorMapper: {
     readonly 'builtin:default': typeof defaultBuiltInProcessor;
     readonly 'builtin:eval': typeof processEvalCall;
@@ -96,6 +97,39 @@ export declare const BuiltInEvalHandlerMapper: {
 };
 export type BuiltInMappingName = keyof typeof BuiltInProcessorMapper;
 export type ConfigOfBuiltInMappingName<N extends BuiltInMappingName> = Parameters<typeof BuiltInProcessorMapper[N]>[4];
-export declare const BuiltInMemory: Map<Identifier, IdentifierDefinition[]>;
-export declare const EmptyBuiltInMemory: Map<Identifier, IdentifierDefinition[]>;
+export type BuiltInMemory = Map<Identifier, IdentifierDefinition[]>;
+export declare class BuiltIns {
+    /**
+     * Register a built-in constant (like `NULL` or `TRUE`) to the given {@link builtIns}
+     */
+    registerBuiltInConstant<T>({ names, value, assumePrimitive }: BuiltInConstantDefinition<T>): void;
+    /**
+     * Register a built-in function (like `print` or `c`) to the given {@link builtIns}
+     */
+    registerBuiltInFunctions<BuiltInProcessor extends BuiltInMappingName>({ names, processor, config, assumePrimitive }: BuiltInFunctionDefinition<BuiltInProcessor>): void;
+    /**
+     * Registers all combinations of replacements
+     */
+    registerReplacementFunctions({ names, suffixes, assumePrimitive, config }: BuiltInReplacementDefinition): void;
+    /**
+     * Register a single {@link BuiltInDefinition} to the given memories in {@link builtIns}
+     */
+    registerBuiltInDefinition(definition: BuiltInDefinition): void;
+    /**
+     * The built-in {@link REnvironmentInformation|environment} is the root of all environments.
+     *
+     * For its default content (when not overwritten by a flowR config),
+     * see the {@link DefaultBuiltinConfig}.
+     */
+    builtInMemory: BuiltInMemory;
+    /**
+     * The twin of the {@link builtInMemory} but with less built ins defined for
+     * cases in which we want some commonly overwritten variables to remain open.
+     * If you do not know if you need the empty environment, you do not need the empty environment (right now).
+     *
+     * @see {@link builtInMemory}
+     */
+    emptyBuiltInMemory: BuiltInMemory;
+    set(identifier: Identifier, definition: IdentifierDefinition[], includeInEmptyMemory: boolean | undefined): void;
+}
 export {};

package/dataflow/environments/built-in.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EmptyBuiltInMemory = exports.BuiltInMemory = exports.BuiltInEvalHandlerMapper = exports.BuiltInProcessorMapper = void 0;
+exports.BuiltIns = exports.BuiltInEvalHandlerMapper = exports.BuiltInProcessorMapper = void 0;
 exports.builtInId = builtInId;
 exports.isBuiltIn = isBuiltIn;
 exports.registerBuiltInFunctions = registerBuiltInFunctions;
@@ -25,8 +25,6 @@ const edge_1 = require("../graph/edge");
 const built_in_library_1 = require("../internal/process/functions/call/built-in/built-in-library");
 const built_in_source_1 = require("../internal/process/functions/call/built-in/built-in-source");
 const built_in_apply_1 = require("../internal/process/functions/call/built-in/built-in-apply");
-const built_in_config_1 = require("./built-in-config");
-const default_builtin_config_1 = require("./default-builtin-config");
 const built_in_list_1 = require("../internal/process/functions/call/built-in/built-in-list");
 const built_in_vector_1 = require("../internal/process/functions/call/built-in/built-in-vector");
 const built_in_rm_1 = require("../internal/process/functions/call/built-in/built-in-rm");
@@ -101,7 +99,7 @@ function defaultBuiltInProcessor(name, args, rootId, data, { returnsNthArgument,
     }
     return res;
 }
-function registerBuiltInFunctions(both, names, processor, config) {
+function registerBuiltInFunctions(both, names, processor, config, builtIns) {
     for (const name of names) {
         (0, assert_1.guard)(processor !== undefined, `Processor for ${name} is undefined, maybe you have an import loop? You may run 'npm run detect-circular-deps' - although by far not all are bad`);
         const id = builtInId(name);
@@ -114,10 +112,7 @@ function registerBuiltInFunctions(both, names, processor, config) {
                 name,
                 nodeId: id
             }];
-        exports.BuiltInMemory.set(name, d);
-        if (both) {
-            exports.EmptyBuiltInMemory.set(name, d);
-        }
+        builtIns.set(name, d, both);
     }
 }
 exports.BuiltInProcessorMapper = {
@@ -149,7 +144,107 @@ exports.BuiltInEvalHandlerMapper = {
     'built-in:+': resolve_1.resolveAsPlus,
     'built-in:-': resolve_1.resolveAsMinus
 };
-exports.BuiltInMemory = new Map();
-exports.EmptyBuiltInMemory = new Map();
-(0, built_in_config_1.registerBuiltInDefinitions)(default_builtin_config_1.DefaultBuiltinConfig);
+class BuiltIns {
+    /**
+     * Register a built-in constant (like `NULL` or `TRUE`) to the given {@link builtIns}
+     */
+    registerBuiltInConstant({ names, value, assumePrimitive }) {
+        for (const name of names) {
+            const id = builtInId(name);
+            const d = [{
+                    type: identifier_1.ReferenceType.BuiltInConstant,
+                    definedAt: id,
+                    controlDependencies: undefined,
+                    value,
+                    name,
+                    nodeId: id
+                }];
+            this.set(name, d, assumePrimitive);
+        }
+    }
+    /**
+     * Register a built-in function (like `print` or `c`) to the given {@link builtIns}
+     */
+    registerBuiltInFunctions({ names, processor, config, assumePrimitive }) {
+        const mappedProcessor = exports.BuiltInProcessorMapper[processor];
+        (0, assert_1.guard)(mappedProcessor !== undefined, () => `Processor for ${processor} is undefined! Please pass a valid builtin name ${JSON.stringify(Object.keys(exports.BuiltInProcessorMapper))}!`);
+        for (const name of names) {
+            (0, assert_1.guard)(processor !== undefined, `Processor for ${name} is undefined, maybe you have an import loop? You may run 'npm run detect-circular-deps' - although by far not all are bad`);
+            const id = builtInId(name);
+            const d = [{
+                    type: identifier_1.ReferenceType.BuiltInFunction,
+                    definedAt: id,
+                    controlDependencies: undefined,
+                    /* eslint-disable-next-line @typescript-eslint/no-explicit-any,@typescript-eslint/no-unsafe-argument */
+                    processor: (name, args, rootId, data) => mappedProcessor(name, args, rootId, data, config),
+                    config,
+                    name,
+                    nodeId: id
+                }];
+            this.set(name, d, assumePrimitive);
+        }
+    }
+    /**
+     * Registers all combinations of replacements
+     */
+    registerReplacementFunctions({ names, suffixes, assumePrimitive, config }) {
+        const replacer = exports.BuiltInProcessorMapper['builtin:replacement'];
+        (0, assert_1.guard)(replacer !== undefined, () => 'Processor for builtin:replacement is undefined!');
+        for (const assignment of names) {
+            for (const suffix of suffixes) {
+                const effectiveName = `${assignment}${suffix}`;
+                const id = builtInId(effectiveName);
+                const d = [{
+                        type: identifier_1.ReferenceType.BuiltInFunction,
+                        definedAt: id,
+                        processor: (name, args, rootId, data) => replacer(name, args, rootId, data, { makeMaybe: true, assignmentOperator: suffix, readIndices: config.readIndices }),
+                        config: {
+                            ...config,
+                            assignmentOperator: suffix,
+                            makeMaybe: true
+                        },
+                        name: effectiveName,
+                        controlDependencies: undefined,
+                        nodeId: id
+                    }];
+                this.set(effectiveName, d, assumePrimitive);
+            }
+        }
+    }
+    /**
+     * Register a single {@link BuiltInDefinition} to the given memories in {@link builtIns}
+     */
+    registerBuiltInDefinition(definition) {
+        switch (definition.type) {
+            case 'constant':
+                return this.registerBuiltInConstant(definition);
+            case 'function':
+                return this.registerBuiltInFunctions(definition);
+            case 'replacement':
+                return this.registerReplacementFunctions(definition);
+        }
+    }
+    /**
+     * The built-in {@link REnvironmentInformation|environment} is the root of all environments.
+     *
+     * For its default content (when not overwritten by a flowR config),
+     * see the {@link DefaultBuiltinConfig}.
+     */
+    builtInMemory = new Map();
+    /**
+     * The twin of the {@link builtInMemory} but with less built ins defined for
+     * cases in which we want some commonly overwritten variables to remain open.
+     * If you do not know if you need the empty environment, you do not need the empty environment (right now).
+     *
+     * @see {@link builtInMemory}
+     */
+    emptyBuiltInMemory = new Map();
+    set(identifier, definition, includeInEmptyMemory) {
+        this.builtInMemory.set(identifier, definition);
+        if (includeInEmptyMemory) {
+            this.emptyBuiltInMemory.set(identifier, definition);
+        }
+    }
+}
+exports.BuiltIns = BuiltIns;
 //# sourceMappingURL=built-in.js.map

package/dataflow/environments/clone.d.ts

@@ -1,7 +1,8 @@
 import type { REnvironmentInformation } from './environment';
 /**
  * Produce a clone of the given environment information.
- * @param environment    - The environment information to clone.
- * @param recurseParents - Whether to clone the parent environments as well.
+ * @param environment        - The environment information to clone.
+ * @param builtInEnvironment - The built-in environment
+ * @param recurseParents     - Whether to clone the parent environments as well.
  */
 export declare function cloneEnvironmentInformation(environment: REnvironmentInformation, recurseParents?: boolean): REnvironmentInformation;

package/dataflow/environments/clone.js

@@ -6,18 +6,19 @@ function cloneEnvironment(environment, recurseParents) {
     if (environment === undefined) {
         return undefined;
     }
-    else if (environment.id === environment_1.BuiltInEnvironment.id) {
-        return environment_1.BuiltInEnvironment;
+    else if (environment.builtInEnv) {
+        return environment; // do not clone the built-in environment
     }
     /* make sure the clone has the same id */
-    const clone = new environment_1.Environment(recurseParents ? cloneEnvironment(environment.parent, recurseParents) : environment.parent);
+    const clone = new environment_1.Environment(recurseParents ? cloneEnvironment(environment.parent, recurseParents) : environment.parent, environment.builtInEnv);
     clone.memory = new Map(JSON.parse(JSON.stringify([...environment.memory])));
     return clone;
 }
 /**
  * Produce a clone of the given environment information.
- * @param environment    - The environment information to clone.
- * @param recurseParents - Whether to clone the parent environments as well.
+ * @param environment        - The environment information to clone.
+ * @param builtInEnvironment - The built-in environment
+ * @param recurseParents     - Whether to clone the parent environments as well.
  */
 function cloneEnvironmentInformation(environment, recurseParents = true) {
     return {