@eagleoutice/flowr 2.2.2 → 2.2.4

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

@@ -1,17 +1,50 @@
 "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");
-async function dataflow(parser, remainingLine) {
+/**
+ * Obtain the dataflow graph using a known parser (such as the {@link RShell} or {@link TreeSitterExecutor}).
+ */
+async function replGetDataflow(parser, code) {
     return await (0, default_pipelines_1.createDataflowPipeline)(parser, {
-        request: (0, retriever_1.requestFromInput)(remainingLine.trim())
+        request: (0, retriever_1.requestFromInput)(code.trim())
     }).allRemainingSteps();
 }
 function handleString(code) {
@@ -26,14 +59,14 @@ exports.dataflowCommand = {
     aliases: ['d', 'df'],
     script: false,
     fn: async (output, shell, remainingLine) => {
-        const result = await dataflow(shell, handleString(remainingLine));
+        const result = await replGetDataflow(shell, handleString(remainingLine));
         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 = {
@@ -42,14 +75,14 @@ exports.dataflowStarCommand = {
     aliases: ['d*', 'df*'],
     script: false,
     fn: async (output, shell, remainingLine) => {
-        const result = await dataflow(shell, handleString(remainingLine));
+        const result = await replGetDataflow(shell, handleString(remainingLine));
         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-parse.js

@@ -17,7 +17,41 @@ function toDepthMap(entry) {
         result.push({ ...current, leaf: children.length === 0 });
         children.reverse();
         const nextDepth = current.depth + 1;
-        visit.push(...children.map(c => ({ depth: nextDepth, node: c })));
+        for (const c of children) {
+            visit.push({ depth: nextDepth, node: c });
+        }
+    }
+    return result;
+}
+function treeSitterToJsonEntry(node) {
+    return {
+        token: node.type,
+        children: [],
+        text: node.text,
+        id: node.id,
+        parent: node.parent?.id ?? -1,
+        terminal: node.isNamed,
+        line1: node.startPosition.row + 1,
+        col1: node.startPosition.column + 1,
+        line2: node.endPosition.row + 1,
+        col2: node.endPosition.column + 1
+    };
+}
+function treeSitterToDepthList(node) {
+    const visit = [{ depth: 0, node }];
+    const result = [];
+    while (visit.length > 0) {
+        const current = visit.pop();
+        if (current === undefined) {
+            continue;
+        }
+        const children = current.node.children;
+        result.push({ depth: current.depth, node: treeSitterToJsonEntry(current.node), leaf: children.length === 0 });
+        children.reverse();
+        const nextDepth = current.depth + 1;
+        for (const c of children) {
+            visit.push({ depth: nextDepth, node: c });
+        }
     }
     return result;
 }
@@ -57,6 +91,9 @@ function retrieveLocationString(locationRaw) {
     if (extracted[0] === extracted[2] && extracted[1] === extracted[3]) {
         return ` (${extracted[0]}:${extracted[1]})`;
     }
+    else if (extracted[0] === extracted[2]) {
+        return ` (${extracted[0]}:${extracted[1]}─${extracted[3]})`;
+    }
     else {
         return ` (${extracted[0]}:${extracted[1]}─${extracted[2]}:${extracted[3]})`;
     }
@@ -66,6 +103,10 @@ function depthListToTextTree(list, f) {
     const deadDepths = new Set();
     let i = 0;
     for (const { depth, node, leaf } of list) {
+        if (depth > 10) {
+            result += '...';
+            break;
+        }
         const nextDepth = i + 1 < list.length ? list[i + 1].depth : 0;
         deadDepths.delete(depth);
         result += initialIndentation(i, depth, deadDepths, nextDepth, list, f);
@@ -99,7 +140,7 @@ exports.parseCommand = {
         }
         else {
             // print the tree-sitter ast
-            output.stdout(JSON.stringify(result.parse.parsed, null, 2));
+            output.stdout(depthListToTextTree(treeSitterToDepthList(result.parse.parsed.rootNode), output.formatter));
         }
     }
 };

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.d.ts

@@ -1,2 +1,3 @@
 import type { KnownParser } from '../../r-bridge/parser';
+export declare function versionReplString(parser: KnownParser): Promise<string>;
 export declare function printVersionRepl(parser: KnownParser): Promise<void>;

package/cli/repl/print-version.js

@@ -1,9 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.versionReplString = versionReplString;
 exports.printVersionRepl = printVersionRepl;
 const repl_version_1 = require("./commands/repl-version");
-async function printVersionRepl(parser) {
+async function versionReplString(parser) {
     const version = await (0, repl_version_1.retrieveVersionInformation)(parser);
-    console.log(`flowR repl using flowR ${version.flowr}, R ${version.r}, engine ${version.engine}`);
+    const rVersion = version.r === 'none' ? '' : version.r === 'unknown' ? ', R version unknown' : `, R v${version.r}`;
+    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));
 }
 //# sourceMappingURL=print-version.js.map

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 };
 };
@@ -38,9 +48,6 @@ const core_1 = require("../core");
 const cfg_1 = require("../../../util/cfg/cfg");
 const quads_1 = require("../../../util/quads");
 const print_1 = require("../../../core/print/print");
-const _00_parse_1 = require("../../../core/steps/all/core/00-parse");
-const _10_normalize_1 = require("../../../core/steps/all/core/10-normalize");
-const _20_dataflow_1 = require("../../../core/steps/all/core/20-dataflow");
 const ansi_1 = require("../../../util/ansi");
 const default_pipelines_1 = require("../../../core/steps/pipeline/default-pipelines");
 const graph_1 = require("../../../dataflow/graph/graph");
@@ -136,7 +143,7 @@ class FlowRServerConnection {
         }
         const tempFile = tmp.fileSync({ postfix: '.R' });
         const slicer = this.createPipelineExecutorForRequest(message, tempFile.name);
-        await slicer.allRemainingSteps(false).then(async (results) => await this.sendFileAnalysisResponse(results, message))
+        await slicer.allRemainingSteps(false).then(async (results) => await this.sendFileAnalysisResponse(slicer, results, message))
             .catch(e => {
             this.logger.error(`[${this.name}] Error while analyzing file ${message.filename ?? 'unknown file'}: ${String(e)}`);
             (0, send_1.sendMessage)(this.socket, {
@@ -149,13 +156,18 @@ class FlowRServerConnection {
         // this is an interestingly named function that means "I am a callback that removes a file" - so this deletes the file
         tempFile.removeCallback();
     }
-    async sendFileAnalysisResponse(results, message) {
+    async sendFileAnalysisResponse(slicer, results, message) {
         let cfg = undefined;
         if (message.cfg) {
             cfg = (0, cfg_1.extractCFG)(results.normalize, results.dataflow?.graph);
         }
         const config = () => ({ context: message.filename ?? 'unknown', getId: (0, quads_1.defaultQuadIdGenerator)() });
         const sanitizedResults = sanitizeAnalysisResults(results);
+        const pipeline = slicer.getPipeline();
+        const parseStep = pipeline.steps.get('parse');
+        const normalizedStep = pipeline.steps.get('normalize');
+        const dataflowStep = pipeline.steps.get('dataflow');
+        (0, assert_1.guard)(parseStep !== undefined && normalizedStep !== undefined && dataflowStep !== undefined, 'All steps must be present');
         if (message.format === 'n-quads') {
             (0, send_1.sendMessage)(this.socket, {
                 type: 'response-file-analysis',
@@ -163,9 +175,9 @@ class FlowRServerConnection {
                 id: message.id,
                 cfg: cfg ? (0, cfg_1.cfg2quads)(cfg, config()) : undefined,
                 results: {
-                    parse: await (0, print_1.printStepResult)(_00_parse_1.PARSE_WITH_R_SHELL_STEP, sanitizedResults.parse, 5 /* StepOutputFormat.RdfQuads */, config()),
-                    normalize: await (0, print_1.printStepResult)(_10_normalize_1.NORMALIZE, sanitizedResults.normalize, 5 /* StepOutputFormat.RdfQuads */, config()),
-                    dataflow: await (0, print_1.printStepResult)(_20_dataflow_1.STATIC_DATAFLOW, sanitizedResults.dataflow, 5 /* StepOutputFormat.RdfQuads */, config())
+                    parse: await (0, print_1.printStepResult)(parseStep, sanitizedResults.parse, 5 /* StepOutputFormat.RdfQuads */, config()),
+                    normalize: await (0, print_1.printStepResult)(normalizedStep, sanitizedResults.normalize, 5 /* StepOutputFormat.RdfQuads */, config()),
+                    dataflow: await (0, print_1.printStepResult)(dataflowStep, sanitizedResults.dataflow, 5 /* StepOutputFormat.RdfQuads */, config())
                 }
             });
         }

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/pipeline-executor.d.ts

@@ -95,10 +95,16 @@ export declare class PipelineExecutor<P extends Pipeline> {
      * Construct a new pipeline executor.
      * The required additional input is specified by the {@link IPipelineStep#requiredInput|required input configuration} of each step in the `pipeline`.
      *
+     * Please see {@link createDataflowPipeline} and friends for engine agnostic shortcuts to create a pipeline executor.
+     *
      * @param pipeline - The {@link Pipeline} to execute, probably created with {@link createPipeline}.
      * @param input    - External {@link PipelineInput|configuration and input} required to execute the given pipeline.
      */
     constructor(pipeline: P, input: PipelineInput<P>);
+    /**
+     * Retrieve the {@link Pipeline|pipeline} that is currently being.
+     */
+    getPipeline(): P;
     /**
      * Retrieve the current {@link PipelineStepStage|stage} the pipeline executor is in.
      *

package/core/pipeline-executor.js

@@ -99,6 +99,8 @@ class PipelineExecutor {
      * Construct a new pipeline executor.
      * The required additional input is specified by the {@link IPipelineStep#requiredInput|required input configuration} of each step in the `pipeline`.
      *
+     * Please see {@link createDataflowPipeline} and friends for engine agnostic shortcuts to create a pipeline executor.
+     *
      * @param pipeline - The {@link Pipeline} to execute, probably created with {@link createPipeline}.
      * @param input    - External {@link PipelineInput|configuration and input} required to execute the given pipeline.
      */
@@ -114,6 +116,12 @@ class PipelineExecutor {
         }
         (0, built_in_config_1.registerBuiltInDefinitions)(builtIns.definitions);
     }
+    /**
+     * Retrieve the {@link Pipeline|pipeline} that is currently being.
+     */
+    getPipeline() {
+        return this.pipeline;
+    }
     /**
      * Retrieve the current {@link PipelineStepStage|stage} the pipeline executor is in.
      *

package/core/print/dataflow-printer.js

@@ -16,6 +16,9 @@ function mayObjectJson(d) {
     }
 }
 function objectJson(df) {
+    if (df === null) {
+        return 'null';
+    }
     const elems = [];
     for (const [key, value] of Object.entries(df)) {
         switch (typeof value) {

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/core/steps/all/core/01-parse-tree-sitter.d.ts

@@ -5,6 +5,13 @@ import type { ParseRequiredInput } from '../../../../r-bridge/parser';
 export interface ParseStepOutputTS {
     readonly parsed: Tree;
 }
+export interface TreeSitterParseJson {
+    readonly '.meta': {
+        readonly tokenCount: number;
+        readonly tokenCountNoComments: number;
+    };
+    readonly str: string;
+}
 export declare const PARSE_WITH_TREE_SITTER_STEP: {
     readonly name: "parse";
     readonly humanReadableName: "parse with tree-sitter";