@eagleoutice/flowr 2.0.25 → 2.1.0

package/util/mermaid/dfg.js

@@ -1,12 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.diffGraphsToMermaidUrl = exports.diffGraphsToMermaid = exports.graphToMermaidUrl = exports.graphToMermaid = exports.formatRange = void 0;
+exports.formatRange = formatRange;
+exports.printIdentifier = printIdentifier;
+exports.graphToMermaid = graphToMermaid;
+exports.graphToMermaidUrl = graphToMermaidUrl;
+exports.diffGraphsToMermaid = diffGraphsToMermaid;
+exports.diffGraphsToMermaidUrl = diffGraphsToMermaidUrl;
 const assert_1 = require("../assert");
 const mermaid_1 = require("./mermaid");
 const graph_1 = require("../../dataflow/graph/graph");
+const identifier_1 = require("../../dataflow/environments/identifier");
 const r_function_call_1 = require("../../r-bridge/lang-4.x/ast/model/nodes/r-function-call");
 const edge_1 = require("../../dataflow/graph/edge");
+const vertex_1 = require("../../dataflow/graph/vertex");
 const environment_1 = require("../../dataflow/environments/environment");
+const type_1 = require("../../r-bridge/lang-4.x/ast/model/type");
 /**
  * Prints a {@link SourceRange|range} as a human readable string.
  */
@@ -24,7 +32,6 @@ function formatRange(range) {
     }
     return `${range[0]}.${range[1]}-${range[2]}.${range[3]}`;
 }
-exports.formatRange = formatRange;
 function subflowToMermaid(nodeId, exitPoints, subflow, mermaid, idPrefix = '') {
     if (subflow === undefined) {
         return;
@@ -41,6 +48,9 @@ function subflowToMermaid(nodeId, exitPoints, subflow, mermaid, idPrefix = '') {
     });
     mermaid.nodeLines.push(...subgraph.nodeLines);
     mermaid.edgeLines.push(...subgraph.edgeLines);
+    for (const present of subgraph.presentEdges) {
+        mermaid.presentEdges.add(present);
+    }
     for (const [color, pool] of [['purple', subflow.in], ['green', subflow.out], ['orange', subflow.unknownReferences]]) {
         for (const out of pool) {
             if (!mermaid.mark?.has(out.nodeId)) {
@@ -51,6 +61,9 @@ function subflowToMermaid(nodeId, exitPoints, subflow, mermaid, idPrefix = '') {
     }
     mermaid.nodeLines.push('end');
     mermaid.edgeLines.push(`${idPrefix}${nodeId} -.-|function| ${subflowId}\n`);
+    /* mark edge as present */
+    const edgeId = encodeEdge(idPrefix + nodeId, subflowId, new Set(['function']));
+    mermaid.presentEdges.add(edgeId);
 }
 function printArg(arg) {
     if (arg === undefined) {
@@ -88,7 +101,7 @@ function mermaidNodeBrackets(tag) {
         open = '[';
         close = ']';
     }
-    else if (tag === "function-call" /* VertexType.FunctionCall */) {
+    else if (tag === vertex_1.VertexType.FunctionCall) {
         open = '[[';
         close = ']]';
     }
@@ -103,7 +116,7 @@ function mermaidNodeBrackets(tag) {
     return { open, close };
 }
 function printIdentifier(id) {
-    return `${id.name} (${id.nodeId}, ${id.kind},${id.controlDependencies ? ' {' + id.controlDependencies.map(c => c.id + (c.when ? '+' : '-')).join(',') + '},' : ''} def. @${id.definedAt})`;
+    return `**${id.name}** (id: ${id.nodeId}, type: ${identifier_1.ReferenceTypeReverseMapping.get(id.type)},${id.controlDependencies ? ' cds: {' + id.controlDependencies.map(c => c.id + (c.when ? '+' : '-')).join(',') + '},' : ''} def. @${id.definedAt})`;
 }
 function printEnvironmentToLines(env) {
     if (env === undefined) {
@@ -121,7 +134,7 @@ function printEnvironmentToLines(env) {
     return lines;
 }
 function vertexToMermaid(info, mermaid, id, idPrefix, mark) {
-    const fCall = info.tag === "function-call" /* VertexType.FunctionCall */;
+    const fCall = info.tag === vertex_1.VertexType.FunctionCall;
     const { open, close } = mermaidNodeBrackets(info.tag);
     if (info.environment && mermaid.includeEnvironments) {
         if (info.environment.level > 0 || info.environment.current.memory.size !== 0) {
@@ -129,13 +142,16 @@ function vertexToMermaid(info, mermaid, id, idPrefix, mark) {
         }
     }
     const node = mermaid.rootGraph.idMap?.get(info.id);
-    const lexeme = node?.lexeme ?? (node?.type === "RExpressionList" /* RType.ExpressionList */ ? node?.grouping?.[0]?.lexeme : '') ?? '??';
+    const lexeme = node?.lexeme ?? (node?.type === type_1.RType.ExpressionList ? node?.grouping?.[0]?.lexeme : '') ?? '??';
     const escapedName = (0, mermaid_1.escapeMarkdown)(node ? `[${node.type}] ${lexeme}` : '??');
     const deps = info.controlDependencies ? ', :may:' + info.controlDependencies.map(c => c.id + (c.when ? '+' : '-')).join(',') : '';
-    const n = node?.info.fullRange ?? node?.location ?? (node?.type === "RExpressionList" /* RType.ExpressionList */ ? node?.grouping?.[0].location : undefined);
+    const n = node?.info.fullRange ?? node?.location ?? (node?.type === type_1.RType.ExpressionList ? node?.grouping?.[0].location : undefined);
     mermaid.nodeLines.push(`    ${idPrefix}${id}${open}"\`${escapedName}${escapedName.length > 10 ? '\n      ' : ' '}(${id}${deps})\n      *${formatRange(n)}*${fCall ? displayFunctionArgMapping(info.args) : ''}\`"${close}`);
     if (mark?.has(id)) {
-        mermaid.nodeLines.push(`    style ${idPrefix}${id} stroke:black,stroke-width:7px; `);
+        mermaid.nodeLines.push(`    style ${idPrefix}${id} ${mermaid.markStyle.vertex} `);
+    }
+    if (mermaid.rootGraph.unknownSideEffects.has(id)) {
+        mermaid.nodeLines.push(`    style ${idPrefix}${id} stroke:red,stroke-width:5px; `);
     }
     const edges = mermaid.rootGraph.get(id, true);
     (0, assert_1.guard)(edges !== undefined, `node ${id} must be found`);
@@ -148,9 +164,9 @@ function vertexToMermaid(info, mermaid, id, idPrefix, mark) {
             mermaid.edgeLines.push(`    ${idPrefix}${id} -->|"${[...edgeTypes].map(e => typeof e === 'number' ? (0, edge_1.edgeTypeToName)(e) : e).join(', ')}"| ${idPrefix}${target}`);
             if (mermaid.mark?.has(id + '->' + target)) {
                 // who invented this syntax?!
-                mermaid.edgeLines.push(`    linkStyle ${mermaid.presentEdges.size - 1} stroke:red,color:red,stroke-width:4px;`);
+                mermaid.edgeLines.push(`    linkStyle ${mermaid.presentEdges.size - 1} ${mermaid.markStyle.edge}`);
             }
-            if (edgeTypes.has('CD-True')) {
+            if (edgeTypes.has('CD-True') || edgeTypes.has('CD-False')) {
                 mermaid.edgeLines.push(`    linkStyle ${mermaid.presentEdges.size - 1} stroke:gray,color:gray;`);
             }
         }
@@ -160,8 +176,8 @@ function vertexToMermaid(info, mermaid, id, idPrefix, mark) {
     }
 }
 // make the passing of root ids more performant again
-function graphToMermaidGraph(rootIds, { graph, prefix = 'flowchart TD', idPrefix = '', includeEnvironments = true, mark, rootGraph, presentEdges = new Set() }) {
-    const mermaid = { nodeLines: prefix === null ? [] : [prefix], edgeLines: [], presentEdges, mark, rootGraph: rootGraph ?? graph, includeEnvironments };
+function graphToMermaidGraph(rootIds, { graph, prefix = 'flowchart TD', idPrefix = '', includeEnvironments = true, mark, rootGraph, presentEdges = new Set(), markStyle = { vertex: 'stroke:teal,stroke-width:7px,stroke-opacity:.8;', edge: 'stroke:teal,stroke-width:4.2px,stroke-opacity:.8' } }) {
+    const mermaid = { nodeLines: prefix === null ? [] : [prefix], edgeLines: [], presentEdges, mark, rootGraph: rootGraph ?? graph, includeEnvironments, markStyle };
     for (const [id, info] of graph.vertices(true)) {
         if (rootIds.has(id)) {
             vertexToMermaid(info, mermaid, id, idPrefix, mark);
@@ -173,7 +189,6 @@ function graphToMermaid(config) {
     const mermaid = graphToMermaidGraph(config.graph.rootIds(), config);
     return { string: `${mermaid.nodeLines.join('\n')}\n${mermaid.edgeLines.join('\n')}`, mermaid };
 }
-exports.graphToMermaid = graphToMermaid;
 /**
  * Converts a dataflow graph to a mermaid url that visualizes the graph.
  *
@@ -184,7 +199,6 @@ exports.graphToMermaid = graphToMermaid;
 function graphToMermaidUrl(graph, includeEnvironments, mark) {
     return (0, mermaid_1.mermaidCodeToUrl)(graphToMermaid({ graph, includeEnvironments, mark }).string);
 }
-exports.graphToMermaidUrl = graphToMermaidUrl;
 /** uses same id map but ensures, it is different from the rhs so that mermaid can work with that */
 function diffGraphsToMermaid(left, right, prefix) {
     // we add the prefix ourselves
@@ -192,9 +206,7 @@ function diffGraphsToMermaid(left, right, prefix) {
     const { string: rightGraph } = graphToMermaid({ graph: right.graph, prefix: '', idPrefix: `r-${right.label}`, includeEnvironments: true, mark: right.mark, presentEdges: mermaid.presentEdges });
     return `${prefix}flowchart TD\nsubgraph "${left.label}"\n${leftGraph}\nend\nsubgraph "${right.label}"\n${rightGraph}\nend`;
 }
-exports.diffGraphsToMermaid = diffGraphsToMermaid;
 function diffGraphsToMermaidUrl(left, right, prefix) {
     return (0, mermaid_1.mermaidCodeToUrl)(diffGraphsToMermaid(left, right, prefix));
 }
-exports.diffGraphsToMermaidUrl = diffGraphsToMermaidUrl;
 //# sourceMappingURL=dfg.js.map

package/util/mermaid/mermaid.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mermaidCodeToUrl = exports.escapeMarkdown = void 0;
+exports.escapeMarkdown = escapeMarkdown;
+exports.mermaidCodeToUrl = mermaidCodeToUrl;
 const replacements = {
     // keep newlines
     '\\n': '\n',
@@ -17,7 +18,9 @@ const replacements = {
     '_': '#95;',
     '{': '#123;',
     '}': '#125;',
-    '&': '#38;'
+    '&': '#38;',
+    '\'': '#39;',
+    ':': '#58;',
 };
 function escapeMarkdown(text) {
     for (const [key, value] of Object.entries(replacements)) {
@@ -25,7 +28,6 @@ function escapeMarkdown(text) {
     }
     return text;
 }
-exports.escapeMarkdown = escapeMarkdown;
 /**
  * Converts mermaid code (potentially produced by {@link graphToMermaid}) to an url that presents the graph in the mermaid editor.
  *
@@ -40,5 +42,4 @@ function mermaidCodeToUrl(code, edit = false) {
     };
     return `https://mermaid.live/${edit ? 'edit' : 'view'}#base64:${Buffer.from(JSON.stringify(obj)).toString('base64')}`;
 }
-exports.mermaidCodeToUrl = mermaidCodeToUrl;
 //# sourceMappingURL=mermaid.js.map

package/util/numbers.js

@@ -1,9 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bigint2number = void 0;
+exports.bigint2number = bigint2number;
 function bigint2number(a) {
     // we have to remove the trailing `n`
     return Number(String(a).slice(0, -1));
 }
-exports.bigint2number = bigint2number;
 //# sourceMappingURL=numbers.js.map

package/util/objects.d.ts

@@ -15,3 +15,10 @@ export declare function deepMergeObject<T extends Mergeable>(base: DeepRequired<
 export declare function deepMergeObject<T extends Mergeable>(base: T, addon?: DeepPartial<T> | Partial<T>): T;
 export declare function deepMergeObject(base: Mergeable, addon: Mergeable): Mergeable;
 export declare function deepMergeObject(base?: Mergeable, addon?: Mergeable): Mergeable | undefined;
+type Defined<T> = Exclude<T, undefined>;
+type DefinedRecord<T> = {
+    [K in keyof T as T[K] extends undefined ? never : K]: Defined<T[K]>;
+};
+/** from a record take only the keys that are not undefined */
+export declare function compactRecord<T extends Record<string, unknown>>(record: T): DefinedRecord<T>;
+export {};

package/util/objects.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deepMergeObject = exports.isObjectOrArray = void 0;
+exports.isObjectOrArray = isObjectOrArray;
+exports.deepMergeObject = deepMergeObject;
+exports.compactRecord = compactRecord;
 const json_1 = require("./json");
 /**
  * checks if `item` is an object (it may be an array, ...)
@@ -8,7 +10,6 @@ const json_1 = require("./json");
 function isObjectOrArray(item) {
     return typeof item === 'object';
 }
-exports.isObjectOrArray = isObjectOrArray;
 function deepMergeObject(base, addon) {
     if (!base) {
         return addon;
@@ -35,7 +36,6 @@ function deepMergeObject(base, addon) {
     }
     return result;
 }
-exports.deepMergeObject = deepMergeObject;
 function deepMergeObjectWithResult(addon, base, result) {
     for (const key of Object.keys(addon)) {
         // values that are undefined (like from a partial object) should NOT be overwritten
@@ -61,4 +61,14 @@ function assertSameType(base, addon) {
         throw new Error(`cannot merge different types! ${typeof base} (${JSON.stringify(base, json_1.jsonReplacer)}) !== ${typeof addon} (${JSON.stringify(addon, json_1.jsonReplacer)})`);
     }
 }
+/** from a record take only the keys that are not undefined */
+function compactRecord(record) {
+    const result = {};
+    for (const key of Object.keys(record)) {
+        if (record[key] !== undefined) {
+            result[key] = record[key];
+        }
+    }
+    return result;
+}
 //# sourceMappingURL=objects.js.map

package/util/os.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPlatform = void 0;
+exports.getPlatform = getPlatform;
 let platformCache = null;
 function getPlatform() {
     if (platformCache !== null) {
@@ -21,5 +21,4 @@ function getPlatform() {
     }
     return platformCache;
 }
-exports.getPlatform = getPlatform;
 //# sourceMappingURL=os.js.map

package/util/quads.js

@@ -9,7 +9,11 @@
  * @module
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.graph2quads = exports.serialize2quads = exports.DefaultQuadSerializationConfiguration = exports.defaultQuadIgnoreIf = exports.defaultQuadIdGenerator = void 0;
+exports.DefaultQuadSerializationConfiguration = void 0;
+exports.defaultQuadIdGenerator = defaultQuadIdGenerator;
+exports.defaultQuadIgnoreIf = defaultQuadIgnoreIf;
+exports.serialize2quads = serialize2quads;
+exports.graph2quads = graph2quads;
 const n3_1 = require("n3");
 var namedNode = n3_1.DataFactory.namedNode;
 var quad = n3_1.DataFactory.quad;
@@ -27,12 +31,10 @@ function defaultQuadIdGenerator() {
     const idMap = new defaultmap_1.DefaultMap(() => counter++);
     return (elem, context) => `${context}/${idMap.get(elem)}`;
 }
-exports.defaultQuadIdGenerator = defaultQuadIdGenerator;
 const ignoredKeysArray = ['complexNumber', 'markedAsInt', 'info'];
 function defaultQuadIgnoreIf() {
     return (key, value) => value === undefined || ignoredKeysArray.includes(key);
 }
-exports.defaultQuadIgnoreIf = defaultQuadIgnoreIf;
 exports.DefaultQuadSerializationConfiguration = {
     ignore: defaultQuadIgnoreIf(),
     context: 'unknown-context',
@@ -62,7 +64,6 @@ function serialize2quads(obj, config) {
     serializeObject(obj, quads, useConfig);
     return writer.quadsToString(quads);
 }
-exports.serialize2quads = serialize2quads;
 /**
  * Serializes the given directed graph to rdf quads.
  * This is a mere (type-)convenience wrapper for {@link serialize2quads}.
@@ -72,7 +73,6 @@ exports.serialize2quads = serialize2quads;
 function graph2quads(graph, config) {
     return serialize2quads(graph, config);
 }
-exports.graph2quads = graph2quads;
 function processArrayEntries(key, values, obj, quads, config) {
     for (const [index, element] of values.entries()) {
         if (element !== null && element !== undefined && (0, objects_1.isObjectOrArray)(element)) {

package/util/random.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomString = exports.ALPHABET = exports.ALPHABET_UPPERCASE = exports.ALPHABET_LOWERCASE = void 0;
+exports.ALPHABET = exports.ALPHABET_UPPERCASE = exports.ALPHABET_LOWERCASE = void 0;
+exports.randomString = randomString;
 const assert_1 = require("./assert");
 exports.ALPHABET_LOWERCASE = [...'abcdefghijklmnopqrstuvwxyz'];
 exports.ALPHABET_UPPERCASE = [...'ABCDEFGHIJKLMNOPQRSTUVWXYZ'];
@@ -18,5 +19,4 @@ function randomString(length, symbols = exports.ALPHABET) {
     }
     return result;
 }
-exports.randomString = randomString;
 //# sourceMappingURL=random.js.map

package/util/range.js

@@ -1,15 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rangeCompare = exports.addRanges = exports.rangesOverlap = exports.rangeStartsCompletelyBefore = exports.mergeRanges = exports.rangeFrom = exports.getRangeEnd = exports.getRangeStart = void 0;
+exports.getRangeStart = getRangeStart;
+exports.getRangeEnd = getRangeEnd;
+exports.rangeFrom = rangeFrom;
+exports.mergeRanges = mergeRanges;
+exports.rangeStartsCompletelyBefore = rangeStartsCompletelyBefore;
+exports.rangesOverlap = rangesOverlap;
+exports.addRanges = addRanges;
+exports.rangeCompare = rangeCompare;
 const assert_1 = require("./assert");
 function getRangeStart(p) {
     return p === undefined ? undefined : [p[0], p[1]];
 }
-exports.getRangeStart = getRangeStart;
 function getRangeEnd(p) {
     return p === undefined ? undefined : [p[2], p[3]];
 }
-exports.getRangeEnd = getRangeEnd;
 /**
  * This does not ensure ordering of start and end!
  *
@@ -21,7 +26,6 @@ exports.getRangeEnd = getRangeEnd;
 function rangeFrom(sl, sc, el, ec) {
     return [Number(sl), Number(sc), Number(el), Number(ec)];
 }
-exports.rangeFrom = rangeFrom;
 function mergeRanges(...rs) {
     (0, assert_1.guard)(rs.length > 0, 'Cannot merge no ranges');
     return rs.reduce(([sl, sc, el, ec], [nsl, nsc, nel, nec]) => [
@@ -29,25 +33,21 @@ function mergeRanges(...rs) {
         ...(el > nel || (el === nel && ec > nec) ? [el, ec] : [nel, nec])
     ], rs[0]);
 }
-exports.mergeRanges = mergeRanges;
 /**
  * @returns true iff `r1` starts and ends before `r2` starts (i.e., if `r1` and `r2` do not overlap and `r1` comes before `r2`
  */
 function rangeStartsCompletelyBefore([, , r1el, r1ec], [r2sl, r2sc, ,]) {
     return r1el < r2sl || (r1el === r2sl && r1ec < r2sc);
 }
-exports.rangeStartsCompletelyBefore = rangeStartsCompletelyBefore;
 /**
  * Checks if the two ranges overlap.
  */
 function rangesOverlap([r1sl, r1sc, r1el, r1ec], [r2sl, r2sc, r2el, r2ec]) {
     return r1sl <= r2el && r2sl <= r1el && r1sc <= r2ec && r2sc <= r1ec;
 }
-exports.rangesOverlap = rangesOverlap;
 function addRanges([r1sl, r1sc, r1el, r1ec], [r2sl, r2sc, r2el, r2ec]) {
     return [r1sl + r2sl, r1sc + r2sc, r1el + r2el, r1ec + r2ec];
 }
-exports.addRanges = addRanges;
 /**
  * Provides a comparator for {@link SourceRange}s that sorts them in ascending order.
  *
@@ -61,5 +61,4 @@ function rangeCompare([r1sl, r1sc, ,], [r2sl, r2sc, ,]) {
         return r1sl - r2sl;
     }
 }
-exports.rangeCompare = rangeCompare;
 //# sourceMappingURL=range.js.map

package/util/schema.d.ts

@@ -0,0 +1,11 @@
+import type Joi from 'joi';
+import type { OutputFormatter } from './ansi';
+interface SchemaLine {
+    level: number;
+    text: string;
+}
+export declare function describeSchema(schema: Joi.Schema, f?: OutputFormatter): string;
+export declare function genericDescription(level: number, formatter: OutputFormatter, name: string, desc: Joi.Description | undefined): SchemaLine[];
+export declare function headerLine(level: number, formatter: OutputFormatter, name: string, type: string, flags: object | undefined): SchemaLine[];
+export declare function describeObject(level: number, formatter: OutputFormatter, desc: Joi.Description): SchemaLine[];
+export {};

package/util/schema.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeSchema = describeSchema;
+exports.genericDescription = genericDescription;
+exports.headerLine = headerLine;
+exports.describeObject = describeObject;
+const ansi_1 = require("./ansi");
+function describeSchema(schema, f = ansi_1.formatter) {
+    const description = schema.describe();
+    const lines = genericDescription(1, f, f.format('.', { effect: ansi_1.ColorEffect.Foreground, color: 7 /* Colors.White */ }), description);
+    const indent = ' '.repeat(4);
+    return lines.map(line => `${indent.repeat(line.level - 1)}${line.text}`).join('\n');
+}
+function genericDescription(level, formatter, name, desc) {
+    if (!desc) {
+        return [];
+    }
+    const lines = [...headerLine(level, formatter, name, desc.type ?? 'unknown', desc.flags)];
+    if ('allow' in desc) {
+        lines.push({ level: level + 1, text: `Allows only the values: ${desc['allow'].map(v => "'" + v + "'").join(', ')}` });
+    }
+    switch (desc.type) {
+        case 'object':
+            lines.push(...describeObject(level, formatter, desc));
+            break;
+        case 'alternatives':
+            if ('matches' in desc) {
+                lines.push(...desc['matches']
+                    .flatMap(({ schema }) => genericDescription(level + 1, formatter, '.', schema)));
+            }
+            break;
+        case 'array':
+            if ('items' in desc) {
+                lines.push({ text: 'Valid item types:', level: level });
+                lines.push(...desc['items']
+                    .flatMap(desc => genericDescription(level + 1, formatter, '.', desc)));
+            }
+            break;
+        default:
+            /* specific support for others if needed */
+            break;
+    }
+    return lines;
+}
+function printFlags(flags) {
+    if (!flags || Object.keys(flags).length === 0) {
+        return '';
+    }
+    let flagText = '';
+    if ('presence' in flags) {
+        flagText += String(flags['presence']);
+    }
+    return flagText.trim().length > 0 ? '[' + flagText + ']' : '';
+}
+function headerLine(level, formatter, name, type, flags) {
+    const text = `- ${(0, ansi_1.bold)(name, formatter)} ${formatter.format(type, { effect: ansi_1.ColorEffect.Foreground, color: 7 /* Colors.White */ })} ${printFlags(flags)}`;
+    const baseLine = { level, text };
+    if (flags && 'description' in flags) {
+        return [baseLine, { level: level + 1, text: (0, ansi_1.italic)(flags['description'], formatter) }];
+    }
+    return [baseLine];
+}
+function describeObject(level, formatter, desc) {
+    const lines = [];
+    if (!('keys' in desc)) {
+        return lines;
+    }
+    for (const key in desc.keys) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+        const keySchema = desc.keys[key];
+        lines.push(...genericDescription(level + 1, formatter, key, keySchema));
+    }
+    return lines;
+}
+//# sourceMappingURL=schema.js.map

package/util/set.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setMinus = exports.setEquals = void 0;
+exports.setEquals = setEquals;
+exports.setMinus = setMinus;
 /**
  * Given both sets, this checks if they contain the same elements.
  */
@@ -15,7 +16,6 @@ function setEquals(a, b) {
     }
     return true;
 }
-exports.setEquals = setEquals;
 /**
  * Returns `A – B`
  */
@@ -28,5 +28,4 @@ function setMinus(a, b) {
     }
     return result;
 }
-exports.setMinus = setMinus;
 //# sourceMappingURL=set.js.map

package/util/strings.js

@@ -1,20 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.longestCommonPrefix = exports.withoutWhitespace = exports.startAndEndsWith = void 0;
+exports.startAndEndsWith = startAndEndsWith;
+exports.withoutWhitespace = withoutWhitespace;
+exports.longestCommonPrefix = longestCommonPrefix;
 /**
  * Check if the given string starts and ends with the given letter
  */
 function startAndEndsWith(str, letter) {
     return str.startsWith(letter) && str.endsWith(letter);
 }
-exports.startAndEndsWith = startAndEndsWith;
 /**
  * Removes all whitespace in the given string
  */
 function withoutWhitespace(output) {
     return output.replace(/\s/g, '');
 }
-exports.withoutWhitespace = withoutWhitespace;
 /**
  * Find the longest common prefix in an array of strings
  */
@@ -37,5 +37,4 @@ function longestCommonPrefix(strings) {
     }
     return prefix;
 }
-exports.longestCommonPrefix = longestCommonPrefix;
 //# sourceMappingURL=strings.js.map

package/util/summarizer.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.summarizeMeasurement = exports.summarizedMeasurement2CsvHeader = exports.summarizedMeasurement2Csv = exports.Summarizer = void 0;
+exports.Summarizer = void 0;
+exports.summarizedMeasurement2Csv = summarizedMeasurement2Csv;
+exports.summarizedMeasurement2CsvHeader = summarizedMeasurement2CsvHeader;
+exports.summarizeMeasurement = summarizeMeasurement;
 const arrays_1 = require("./arrays");
 class Summarizer {
     config;
@@ -14,12 +17,10 @@ exports.Summarizer = Summarizer;
 function summarizedMeasurement2Csv(a) {
     return `${a.min},${a.max},${a.median},${a.mean},${a.std},${a.total}`;
 }
-exports.summarizedMeasurement2Csv = summarizedMeasurement2Csv;
 const summarizedKeys = ['min', 'max', 'median', 'mean', 'std', 'total'];
 function summarizedMeasurement2CsvHeader(prefix) {
     return summarizedKeys.map(k => prefix ? `${prefix}-${k}` : k).join(',');
 }
-exports.summarizedMeasurement2CsvHeader = summarizedMeasurement2CsvHeader;
 function summarizeMeasurement(data, totalNumberOfDataPoints) {
     // just to avoid in-place modification
     const sorted = [...data].sort((a, b) => a - b);
@@ -33,5 +34,4 @@ function summarizeMeasurement(data, totalNumberOfDataPoints) {
     const std = Math.sqrt(sorted.map(x => (x - mean) ** 2).reduce((a, b) => a + b, 0) / length);
     return { min, max, median, mean, std, total };
 }
-exports.summarizeMeasurement = summarizeMeasurement;
 //# sourceMappingURL=summarizer.js.map

package/util/text.d.ts

@@ -0,0 +1 @@
+export declare function nth(n: number): string;

package/util/text.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nth = nth;
+const assert_1 = require("./assert");
+function nth(n) {
+    (0, assert_1.guard)(isFinite(n) && n >= 1, 'n must be a non-negative number');
+    const num = String(n);
+    const lastDigit = num[num.length - 1];
+    switch (lastDigit) {
+        case '1':
+            return n > 0 && n < 20 ? `${n}th` : `${n}st`;
+        case '2':
+            return n > 0 && n < 20 ? `${n}th` : `${n}nd`;
+        case '3':
+            return n > 0 && n < 20 ? `${n}th` : `${n}rd`;
+        default:
+            return `${n}th`;
+    }
+}
+//# sourceMappingURL=text.js.map

package/util/time.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.date2string = void 0;
+exports.date2string = date2string;
 /**
  * Retrieve a string in the form of "YYYY-MM-DD-HH-MM-SS-MS" from a Date object.
  *
@@ -9,5 +9,4 @@ exports.date2string = void 0;
 function date2string(date = new Date()) {
     return `${date.getFullYear()}-${date.getMonth() + 1}-${date.getDate()}-${date.getHours()}-${date.getMinutes()}-${date.getSeconds()}-${date.getMilliseconds()}`;
 }
-exports.date2string = date2string;
 //# sourceMappingURL=time.js.map

package/util/version.js

@@ -1,11 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.flowrVersion = void 0;
+exports.flowrVersion = flowrVersion;
 const semver_1 = require("semver");
 // this is automatically replaced with the current version by release-it
-const version = '2.0.25';
+const version = '2.1.0';
 function flowrVersion() {
     return new semver_1.SemVer(version);
 }
-exports.flowrVersion = flowrVersion;
 //# sourceMappingURL=version.js.map

package/cli/repl/commands/lineage.d.ts

@@ -1,15 +0,0 @@
-import type { ReplCommand } from './main';
-import type { SingleSlicingCriterion } from '../../../slicing/criterion/parse';
-import type { NodeId } from '../../../r-bridge/lang-4.x/ast/model/processing/node-id';
-import type { DataflowInformation } from '../../../dataflow/info';
-import type { NormalizedAst } from '../../../r-bridge/lang-4.x/ast/model/processing/decorate';
-/**
- * Get the lineage of a node in the dataflow graph
- *
- * @param criterion - The criterion to get the lineage of
- * @param ast       - The normalized AST
- * @param dfg       - The dataflow graph
- * @returns The lineage of the node represented as a set of node ids
- */
-export declare function getLineage(criterion: SingleSlicingCriterion, { idMap }: NormalizedAst, dfg: DataflowInformation): Set<NodeId>;
-export declare const getLineageCommand: ReplCommand;

package/cli/repl/commands/quit.d.ts

@@ -1,2 +0,0 @@
-import type { ReplCommand } from './main';
-export declare const quitCommand: ReplCommand;

package/cli/repl/server/messages/analysis.js

@@ -1,21 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.requestAnalysisMessage = void 0;
-const joi_1 = __importDefault(require("joi"));
-exports.requestAnalysisMessage = {
-    type: 'request-file-analysis',
-    schema: joi_1.default.object({
-        type: joi_1.default.string().valid('request-file-analysis').required(),
-        id: joi_1.default.string().optional(),
-        filetoken: joi_1.default.string().optional(),
-        filename: joi_1.default.string().optional(),
-        content: joi_1.default.string().optional(),
-        filepath: joi_1.default.alternatives(joi_1.default.string(), joi_1.default.array().items(joi_1.default.string())).optional(),
-        cfg: joi_1.default.boolean().optional(),
-        format: joi_1.default.string().valid('json', 'n-quads').optional()
-    }).xor('content', 'filepath')
-};
-//# sourceMappingURL=analysis.js.map