@eagleoutice/flowr 2.2.3 → 2.2.4

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

@@ -1,13 +1,43 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dataflowStarCommand = exports.dataflowCommand = void 0;
 const default_pipelines_1 = require("../../../core/steps/pipeline/default-pipelines");
 const retriever_1 = require("../../../r-bridge/retriever");
 const dfg_1 = require("../../../util/mermaid/dfg");
-const clipboardy_1 = __importDefault(require("clipboardy"));
+const clipboard = Promise.resolve().then(() => __importStar(require('clipboardy')));
 const ansi_1 = require("../../../util/ansi");
 /**
  * Obtain the dataflow graph using a known parser (such as the {@link RShell} or {@link TreeSitterExecutor}).
@@ -33,10 +63,10 @@ exports.dataflowCommand = {
         const mermaid = (0, dfg_1.graphToMermaid)({ graph: result.dataflow.graph, includeEnvironments: false }).string;
         output.stdout(mermaid);
         try {
-            clipboardy_1.default.writeSync(mermaid);
+            (await clipboard).default.writeSync(mermaid);
             output.stdout(formatInfo(output, 'mermaid code', result.dataflow['.meta'].timing));
         }
-        catch (e) { /* do nothing this is a service thing */ }
+        catch { /* do nothing this is a service thing */ }
     }
 };
 exports.dataflowStarCommand = {
@@ -49,10 +79,10 @@ exports.dataflowStarCommand = {
         const mermaid = (0, dfg_1.graphToMermaidUrl)(result.dataflow.graph, false);
         output.stdout(mermaid);
         try {
-            clipboardy_1.default.writeSync(mermaid);
+            (await clipboard).default.writeSync(mermaid);
             output.stdout(formatInfo(output, 'mermaid url', result.dataflow['.meta'].timing));
         }
-        catch (e) { /* do nothing this is a service thing */ }
+        catch { /* do nothing this is a service thing */ }
     }
 };
 //# sourceMappingURL=repl-dataflow.js.map

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

@@ -1,13 +1,43 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeStarCommand = exports.normalizeCommand = void 0;
 const default_pipelines_1 = require("../../../core/steps/pipeline/default-pipelines");
 const retriever_1 = require("../../../r-bridge/retriever");
 const ast_1 = require("../../../util/mermaid/ast");
-const clipboardy_1 = __importDefault(require("clipboardy"));
+const clipboard = Promise.resolve().then(() => __importStar(require('clipboardy')));
 const ansi_1 = require("../../../util/ansi");
 async function normalize(parser, remainingLine) {
     return await (0, default_pipelines_1.createNormalizePipeline)(parser, {
@@ -30,10 +60,10 @@ exports.normalizeCommand = {
         const mermaid = (0, ast_1.normalizedAstToMermaid)(result.normalize.ast);
         output.stdout(mermaid);
         try {
-            clipboardy_1.default.writeSync(mermaid);
+            (await clipboard).default.writeSync(mermaid);
             output.stdout(formatInfo(output, 'mermaid url', result.normalize['.meta'].timing));
         }
-        catch (e) { /* do nothing this is a service thing */ }
+        catch { /* do nothing this is a service thing */ }
     }
 };
 exports.normalizeStarCommand = {
@@ -46,10 +76,10 @@ exports.normalizeStarCommand = {
         const mermaid = (0, ast_1.normalizedAstToMermaidUrl)(result.normalize.ast);
         output.stdout(mermaid);
         try {
-            clipboardy_1.default.writeSync(mermaid);
+            (await clipboard).default.writeSync(mermaid);
             output.stdout(formatInfo(output, 'mermaid url', result.normalize['.meta'].timing));
         }
-        catch (e) { /* do nothing this is a service thing */ }
+        catch { /* do nothing this is a service thing */ }
     }
 };
 //# sourceMappingURL=repl-normalize.js.map

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

@@ -21,14 +21,14 @@ function printHelp(output) {
     output.stdout(`\n\nThe example ${(0, ansi_1.italic)(':query "[{\\"type\\": \\"call-context\\", \\"callName\\": \\"mean\\" }]" mean(1:10)', output.formatter)} would return the call context of the mean function.`);
     output.stdout('As a convenience, we interpret any (non-help, non-@) string not starting with \'[\' as a regex for the simple call-context query.');
     output.stdout(`Hence, ${(0, ansi_1.italic)(':query "mean" mean(1:10)', output.formatter)} is equivalent to the above example.`);
-    output.stdout(`Similarly, '@<type>' is interpreted as a query of the given type.`);
+    output.stdout('Similarly, \'@<type>\' is interpreted as a query of the given type.');
     output.stdout(`With this, ${(0, ansi_1.italic)(':query @config', output.formatter)} prints the result of the config query.`);
 }
 async function processQueryArgs(line, parser, output) {
     const args = (0, args_1.splitAtEscapeSensitive)(line);
     const query = args.shift();
     if (!query) {
-        output.stderr(`No query provided, use ':query help' to get more information.`);
+        output.stderr('No query provided, use \':query help\' to get more information.');
         return;
     }
     if (query === 'help') {

package/cli/repl/core.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -152,7 +162,6 @@ async function repl({ parser = new shell_1.RShell({ revive: 2 /* RShellReviveOpt
         rl.on('history', h => fs_1.default.writeFileSync(historyFile, h.join('\n'), { encoding: 'utf-8' }));
     }
     // the incredible repl :D, we kill it with ':quit'
-    // eslint-disable-next-line no-constant-condition,@typescript-eslint/no-unnecessary-condition
     while (true) {
         await new Promise((resolve, reject) => {
             rl.question((0, prompt_1.prompt)(), answer => {

package/cli/repl/print-version.js

@@ -6,7 +6,8 @@ const repl_version_1 = require("./commands/repl-version");
 async function versionReplString(parser) {
     const version = await (0, repl_version_1.retrieveVersionInformation)(parser);
     const rVersion = version.r === 'none' ? '' : version.r === 'unknown' ? ', R version unknown' : `, R v${version.r}`;
-    return `flowR repl using flowR v${version.flowr}${rVersion} (${version.engine} engine)`;
+    const treeSitterVer = parser.name === 'tree-sitter' ? `, R grammar v${parser.treeSitterVersion()}` : '';
+    return `flowR repl using flowR v${version.flowr}${rVersion}${treeSitterVer} (${version.engine} engine)`;
 }
 async function printVersionRepl(parser) {
     console.log(await versionReplString(parser));

package/cli/repl/server/connection.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/cli/repl/server/messages/all-messages.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.baseMessage = void 0;
 /**

package/cli/repl/server/messages/message-repl.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.responseExecuteReplEndMessage = exports.responseExecuteReplIntermediateMessage = exports.requestExecuteReplExpressionMessage = void 0;
 const Joi = __importStar(require("joi"));

package/cli/repl/server/messages/message-slice.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.responseSliceMessage = exports.requestSliceMessage = void 0;
 const Joi = __importStar(require("joi"));

package/cli/script-core/statistics-helper-core.js

@@ -21,7 +21,6 @@ const time_1 = require("../../util/time");
 const tar_1 = require("tar");
 const ansi_1 = require("../../util/ansi");
 function compressFolder(folder, target) {
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-call,@typescript-eslint/no-unsafe-member-access
     return (0, tar_1.create)({
         gzip: true,
         file: target,

package/core/print/normalize-printer.js

@@ -14,7 +14,6 @@ function normalizedAstToJson(ast) {
         if (k === 'fullLexeme') {
             return undefined;
         }
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
         return (0, json_1.jsonReplacer)(k, v);
     });
 }

package/dataflow/environments/resolve-by-name.d.ts

@@ -17,8 +17,10 @@ import type { AstIdMap } from '../../r-bridge/lang-4.x/ast/model/processing/deco
  */
 export declare function resolveByName(name: Identifier, environment: REnvironmentInformation, target?: ReferenceType): IdentifierDefinition[] | undefined;
 export declare function resolvesToBuiltInConstant(name: Identifier | undefined, environment: REnvironmentInformation, wantedValue: unknown): Ternary;
+/** Please use {@link resolveValueOfVariable} */
 export declare function resolveToConstants(name: Identifier | undefined, environment: REnvironmentInformation): unknown[] | undefined;
 export declare function getAliases(sourceIds: readonly NodeId[], dataflow: DataflowGraph, environment: REnvironmentInformation): NodeId[] | undefined;
+/** Please use {@link resolveValueOfVariable} */
 export declare function resolveToValues(identifier: Identifier | undefined, environment: REnvironmentInformation, idMap?: AstIdMap): unknown[] | undefined;
 /**
  * Convenience function using the variable resolver as specified within the configuration file

package/dataflow/environments/resolve-by-name.js

@@ -90,6 +90,7 @@ function resolvesToBuiltInConstant(name, environment, wantedValue) {
         return some ? logic_1.Ternary.Maybe : logic_1.Ternary.Never;
     }
 }
+/** Please use {@link resolveValueOfVariable} */
 function resolveToConstants(name, environment) {
     if (name === undefined) {
         return undefined;
@@ -147,6 +148,7 @@ function getAliases(sourceIds, dataflow, environment) {
     }
     return [...definitions];
 }
+/** Please use {@link resolveValueOfVariable} */
 function resolveToValues(identifier, environment, idMap) {
     if (identifier === undefined) {
         return undefined;

package/dataflow/graph/resolve-graph.js

@@ -22,7 +22,7 @@ function resolveDataflowGraph(graph, idMap) {
         try {
             resolved = (0, parse_1.slicingCriterionToId)(id, resolveMap);
         }
-        catch (e) {
+        catch {
             /* just keep it :D */
             resolved = id;
         }

package/dataflow/internal/process/functions/call/built-in/built-in-assignment.d.ts

@@ -47,4 +47,4 @@ export interface AssignmentToSymbolParameters<OtherInfo> extends AssignmentConfi
 export declare function markAsAssignment(information: {
     environment: REnvironmentInformation;
     graph: DataflowGraph;
-}, nodeToDefine: InGraphIdentifierDefinition, sourceIds: readonly NodeId[], rootIdOfAssignment: NodeId, config?: AssignmentConfiguration | undefined): void;
+}, nodeToDefine: InGraphIdentifierDefinition, sourceIds: readonly NodeId[], rootIdOfAssignment: NodeId, config?: AssignmentConfiguration): void;

package/documentation/data/server/doc-data-server-messages.js

@@ -69,7 +69,7 @@ Requests for the [REPL](#message-request-repl) are independent of that.
 The request allows the server to analyze a file and prepare it for slicing.
 The message can contain a \`filetoken\`, which is used to identify the file in later slice or lineage requests (if you do not add one, the request will not be stored and therefore, it is not available for subsequent requests).
 
-> [!IMPORTANT]
+> **Please note!**\\
 > If you want to send and process a lot of analysis requests, but do not want to slice them, please do not pass the \`filetoken\` field. This will save the server a lot of memory allocation.
 
 Furthermore, the request must contain either a \`content\` field to directly pass the file's content or a \`filepath\` field which contains the path to the file (this path must be accessible for the server to be useful).
@@ -420,7 +420,6 @@ See [above](#message-request-file-analysis) for the general structure of the res
                                 {
                                     type: 'compound',
                                     query: 'call-context',
-                                    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- otherwise we would have to carry generic typing information through the test infrastrcuture
                                     commonArguments: {
                                         kind: 'visualize',
                                         subkind: 'text',

package/documentation/doc-util/doc-auto-gen.d.ts

@@ -5,3 +5,4 @@ export interface AutoGenHeaderArguments {
     readonly purpose: string;
 }
 export declare function autoGenHeader({ rVersion, filename, purpose, currentDateAndTime }: AutoGenHeaderArguments): string;
+export declare function fileNameForGenHeader(filename: string): string;

package/documentation/doc-util/doc-auto-gen.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.autoGenHeader = autoGenHeader;
+exports.fileNameForGenHeader = fileNameForGenHeader;
 const version_1 = require("../../util/version");
 const doc_files_1 = require("./doc-files");
 function autoGenHeader({ rVersion, filename, purpose, currentDateAndTime = new Date().toISOString().replace('T', ', ').replace(/\.\d+Z$/, ' UTC') }) {
+    return `_This document was generated from '${fileNameForGenHeader(filename)}' on ${currentDateAndTime} presenting an overview of flowR's ${purpose} (v${(0, version_1.flowrVersion)().format()}${rVersion ? ', using R v' + rVersion : ''}). Please do not edit this file/wiki page directly._`;
+}
+function fileNameForGenHeader(filename) {
     const shortenFilename = filename.replace(/^.*src\//, 'src/');
-    return `_This document was generated from '${(0, doc_files_1.linkFlowRSourceFile)(shortenFilename)}' on ${currentDateAndTime} presenting an overview of flowR's ${purpose} (v${(0, version_1.flowrVersion)().format()}${rVersion ? ', using R v' + rVersion : ''}). Please do not edit this file/wiki page directly._`;
+    return (0, doc_files_1.linkFlowRSourceFile)(shortenFilename);
 }
 //# sourceMappingURL=doc-auto-gen.js.map

package/documentation/doc-util/doc-benchmarks.d.ts

@@ -0,0 +1,23 @@
+interface BenchmarkData {
+    readonly lastUpdate: number;
+    readonly repoUrl: string;
+    readonly entries: Record<string, [BenchmarkElement]>;
+}
+interface BenchmarkElement {
+    readonly commit: Record<string, unknown>;
+    readonly date: number;
+    readonly tool: string;
+    readonly benches: BenchmarkElementBench[];
+}
+interface BenchmarkElementBench {
+    readonly name: string;
+    readonly value: number;
+    readonly unit: string;
+    readonly range: number;
+    readonly extra: string;
+}
+export declare function loadBenchmarkData(): Promise<BenchmarkData>;
+export declare function getLatestBenchmark(suite: string): Promise<BenchmarkElement>;
+export declare function getLastBenchmarkUpdate(): Promise<number>;
+export declare function getLatestDfAnalysisTime(suite: string): Promise<number>;
+export {};

package/documentation/doc-util/doc-benchmarks.js

@@ -0,0 +1,76 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadBenchmarkData = loadBenchmarkData;
+exports.getLatestBenchmark = getLatestBenchmark;
+exports.getLastBenchmarkUpdate = getLastBenchmarkUpdate;
+exports.getLatestDfAnalysisTime = getLatestDfAnalysisTime;
+const path_1 = __importDefault(require("path"));
+const assert_1 = require("../../util/assert");
+const BenchmarkDataPath = path_1.default.resolve(__dirname, '..', '..', '..', 'wiki', 'stats', 'benchmark', 'data.js');
+let benchmarkData = null;
+async function loadBenchmarkData() {
+    if (benchmarkData === null) {
+        // provide a window object to attach to in the import
+        globalThis['window'] = {};
+        await Promise.resolve(`${BenchmarkDataPath}`).then(s => __importStar(require(s)));
+        // @ts-expect-error -- we know that the data is there
+        benchmarkData = window['BENCHMARK_DATA'];
+    }
+    return benchmarkData;
+}
+async function getLatestBenchmark(suite) {
+    // provide a window object to attach to in the import
+    const suiteData = (await loadBenchmarkData()).entries[suite];
+    (0, assert_1.guard)(suiteData, `No benchmark data for suite '${suite}' found!`);
+    return suiteData.sort((a, b) => b.date - a.date)[0];
+}
+async function getLastBenchmarkUpdate() {
+    return (await loadBenchmarkData()).lastUpdate;
+}
+function getBenchmarkElement(bench, name) {
+    const element = bench.benches.find(b => b.name === name);
+    (0, assert_1.guard)(element, `No benchmark data for '${name}' found!`);
+    return element;
+}
+async function getLatestDfAnalysisTime(suite) {
+    const elem = await getLatestBenchmark(suite);
+    const [parse, normalize, analyze] = ['Retrieve AST from R code', 'Normalize R AST', 'Produce dataflow information'].map(name => getBenchmarkElement(elem, name));
+    return parse.value + normalize.value + analyze.value;
+}
+//# sourceMappingURL=doc-benchmarks.js.map

package/documentation/doc-util/doc-code.d.ts

@@ -1,2 +1,3 @@
 export declare function codeBlock(language: string, code: string | undefined): string;
+export declare function codeInline(code: string): string;
 export declare function jsonWithLimit(object: object, maxLength?: number, tooLongText?: string): string;

package/documentation/doc-util/doc-code.js

@@ -1,11 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.codeBlock = codeBlock;
+exports.codeInline = codeInline;
 exports.jsonWithLimit = jsonWithLimit;
 const json_1 = require("../../util/json");
 function codeBlock(language, code) {
     return `\n\`\`\`${language}\n${code?.trim() ?? ''}\n\`\`\`\n`;
 }
+function codeInline(code) {
+    return `<code>${code}</code>`;
+}
 function jsonWithLimit(object, maxLength = 5_000, tooLongText = '_As the code is pretty long, we inhibit pretty printing and syntax highlighting (JSON):_') {
     const prettyPrinted = JSON.stringify(object, json_1.jsonReplacer, 2);
     return `

package/documentation/doc-util/doc-files.d.ts

@@ -5,6 +5,7 @@ export declare const FlowrWikiBaseRef = "https://github.com/flowr-analysis/flowr
 export declare const FlowrNpmRef = "https://www.npmjs.com/package/@eagleoutice/flowr";
 export declare const FlowrDockerRef = "https://hub.docker.com/r/eagleoutice/flowr";
 export declare const FlowrCodecovRef = "https://app.codecov.io/gh/flowr-analysis/flowr";
+export declare const FlowrVsCode = "https://marketplace.visualstudio.com/items?itemName=code-inspect.vscode-flowr";
 export declare function getFilePathMd(path: string): string;
 export declare function getFileContentFromRoot(path: string): string;
 export declare function linkFlowRSourceFile(path: string): string;

package/documentation/doc-util/doc-files.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FlowrCodecovRef = exports.FlowrDockerRef = exports.FlowrNpmRef = exports.FlowrWikiBaseRef = exports.RemoteFlowrFilePathBaseRef = exports.FlowrSiteBaseRef = exports.FlowrGithubBaseRef = void 0;
+exports.FlowrVsCode = exports.FlowrCodecovRef = exports.FlowrDockerRef = exports.FlowrNpmRef = exports.FlowrWikiBaseRef = exports.RemoteFlowrFilePathBaseRef = exports.FlowrSiteBaseRef = exports.FlowrGithubBaseRef = void 0;
 exports.getFilePathMd = getFilePathMd;
 exports.getFileContentFromRoot = getFileContentFromRoot;
 exports.linkFlowRSourceFile = linkFlowRSourceFile;
@@ -15,6 +15,7 @@ exports.FlowrWikiBaseRef = `${exports.FlowrGithubBaseRef}/flowr/wiki`;
 exports.FlowrNpmRef = 'https://www.npmjs.com/package/@eagleoutice/flowr';
 exports.FlowrDockerRef = 'https://hub.docker.com/r/eagleoutice/flowr';
 exports.FlowrCodecovRef = 'https://app.codecov.io/gh/flowr-analysis/flowr';
+exports.FlowrVsCode = 'https://marketplace.visualstudio.com/items?itemName=code-inspect.vscode-flowr';
 function getFilePathMd(path) {
     // we go one up as we are in doc-util now :D #convenience
     const fullpath = require.resolve('../' + path);

package/documentation/doc-util/doc-server-message.js

@@ -80,7 +80,7 @@ async function documentServerMessageResponse({ shell, title, messageType, messag
                 try {
                     await socket.waitForMessage(metaMessage.expectedType, 20);
                 }
-                catch (e) {
+                catch {
                     console.error('Failed to receive message', metaMessage.expectedType, 'has', socket.getMessages());
                 }
             }

package/documentation/doc-util/doc-structure.d.ts

@@ -6,7 +6,7 @@ export interface DetailsOptions {
 }
 export declare function details(title: string, content: string, { color, open, hideIfEmpty, prefixInit }?: DetailsOptions): string;
 export interface BlockOptions {
-    readonly type: 'NOTE' | 'WARNING' | 'TIP';
+    readonly type: 'NOTE' | 'WARNING' | 'TIP' | 'IMPORTANT';
     readonly content: string;
 }
 export declare function block({ type, content }: BlockOptions): string;

package/documentation/doc-util/doc-structure.js

@@ -3,9 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.details = details;
 exports.block = block;
 const doc_general_1 = require("./doc-general");
-function details(title, content, { color = 'black', open = false, hideIfEmpty = true, prefixInit = '' } = {}) {
+function details(title, content, { color, open = false, hideIfEmpty = true, prefixInit = '' } = {}) {
     return hideIfEmpty && content.trim().length === 0 ? '' : `
-${prefixInit}<details${open ? ' open' : ''}><summary style="color:${color}">${title}</summary>
+${prefixInit}<details${open ? ' open' : ''}><summary style="${color ? 'color:' + color : ''}">${title}</summary>
 
 ${content}