@eagleoutice/flowr 2.7.0 → 2.7.3

package/r-bridge/lang-4.x/ast/model/model.d.ts

@@ -102,7 +102,7 @@ export interface Namespace {
      * The namespace attached to the given node
      * (e.g., a namespaced symbol in `x::y`).
      */
-    namespace: NamespaceIdentifier | undefined;
+    namespace?: NamespaceIdentifier;
 }
 /**
  * This subtype of {@link RNode} represents all types of constants

package/r-bridge/lang-4.x/ast/model/processing/decorate.js

@@ -187,7 +187,7 @@ function createFoldForUnaryOp(info) {
         info.idMap.set(id, decorated);
         const opInfo = operand.info;
         opInfo.parent = id;
-        opInfo.role = "unary-operand" /* RoleInParent.UnaryOperand */;
+        opInfo.role = "unary-op" /* RoleInParent.UnaryOperand */;
         decorated.info.file = info.file;
         return decorated;
     };
@@ -208,7 +208,7 @@ function createFoldForAccess(info) {
                     const curInfo = acc.info;
                     curInfo.parent = id;
                     curInfo.index = idx;
-                    curInfo.role = "index-access" /* RoleInParent.IndexAccess */;
+                    curInfo.role = "index-acc" /* RoleInParent.IndexAccess */;
                 }
             }
         }
@@ -223,11 +223,11 @@ function createFoldForForLoop(info) {
         info.idMap.set(id, decorated);
         const varInfo = variable.info;
         varInfo.parent = id;
-        varInfo.role = "for-variable" /* RoleInParent.ForVariable */;
+        varInfo.role = "for-var" /* RoleInParent.ForVariable */;
         const vecInfo = vector.info;
         vecInfo.parent = id;
         vecInfo.index = 1;
-        vecInfo.role = "for-vector" /* RoleInParent.ForVector */;
+        vecInfo.role = "for-vec" /* RoleInParent.ForVector */;
         const bodyInfo = body.info;
         bodyInfo.parent = id;
         bodyInfo.index = 2;
@@ -280,7 +280,7 @@ function createFoldForIfThenElse(info) {
             const otherwiseInfo = otherwise.info;
             otherwiseInfo.parent = id;
             otherwiseInfo.index = 2;
-            otherwiseInfo.role = "if-otherwise" /* RoleInParent.IfOtherwise */;
+            otherwiseInfo.role = "if-other" /* RoleInParent.IfOtherwise */;
         }
         decorated.info.file = info.file;
         return decorated;
@@ -323,7 +323,7 @@ function createFoldForFunctionCall(info) {
                 const argInfo = arg.info;
                 argInfo.parent = id;
                 argInfo.index = idx;
-                argInfo.role = "call-argument" /* RoleInParent.FunctionCallArgument */;
+                argInfo.role = "call-arg" /* RoleInParent.FunctionCallArgument */;
             }
         }
         decorated.info.file = info.file;
@@ -340,12 +340,12 @@ function createFoldForFunctionDefinition(info) {
             const paramInfo = param.info;
             paramInfo.parent = id;
             paramInfo.index = idx++;
-            paramInfo.role = "function-def-param" /* RoleInParent.FunctionDefinitionParameter */;
+            paramInfo.role = "param" /* RoleInParent.FunctionDefinitionParameter */;
         }
         const bodyInfo = body.info;
         bodyInfo.parent = id;
         bodyInfo.index = idx;
-        bodyInfo.role = "function-def-body" /* RoleInParent.FunctionDefinitionBody */;
+        bodyInfo.role = "fun-body" /* RoleInParent.FunctionDefinitionBody */;
         decorated.info.file = info.file;
         return decorated;
     };

package/r-bridge/lang-4.x/ast/model/processing/role.d.ts

@@ -10,29 +10,29 @@ export declare const enum RoleInParent {
     Root = "root",
     IfCondition = "if-cond",
     IfThen = "if-then",
-    IfOtherwise = "if-otherwise",
+    IfOtherwise = "if-other",
     WhileCondition = "while-cond",
     WhileBody = "while-body",
     RepeatBody = "repeat-body",
-    ForVariable = "for-variable",
-    ForVector = "for-vector",
+    ForVariable = "for-var",
+    ForVector = "for-vec",
     ForBody = "for-body",
     FunctionCallName = "call-name",
-    FunctionCallArgument = "call-argument",
-    FunctionDefinitionBody = "function-def-body",
-    FunctionDefinitionParameter = "function-def-param",
+    FunctionCallArgument = "call-arg",
+    FunctionDefinitionBody = "fun-body",
+    FunctionDefinitionParameter = "param",
     ExpressionListChild = "expr-list-child",
     BinaryOperationLhs = "binop-lhs",
     BinaryOperationRhs = "binop-rhs",
     PipeLhs = "pipe-lhs",
     PipeRhs = "pipe-rhs",
-    UnaryOperand = "unary-operand",
+    UnaryOperand = "unary-op",
     ParameterName = "param-name",
     ParameterDefaultValue = "param-value",
     ArgumentName = "arg-name",
     ArgumentValue = "arg-value",
     Accessed = "accessed",
-    IndexAccess = "index-access"
+    IndexAccess = "index-acc"
 }
 /**
  * Returns the roles of the parents of the given node, starting with the parent-role of the node itself.

package/r-bridge/lang-4.x/ast/parser/main/internal/functions/normalize-parameter.js

@@ -34,7 +34,6 @@ function tryNormalizeParameter(data, objs) {
         name: {
             type: type_1.RType.Symbol,
             location, content,
-            namespace: undefined,
             lexeme: content,
             info: {
                 fullRange: location,

package/r-bridge/lang-4.x/tree-sitter/tree-sitter-normalize.js

@@ -483,7 +483,6 @@ function convertTreeNode(node) {
                 name: {
                     type: type_1.RType.Symbol,
                     location: nameRange,
-                    namespace: undefined,
                     content: name.text,
                     lexeme: name.text,
                     info: {

package/statistics/features/supported/data-access/data-access.js

@@ -58,7 +58,7 @@ function visitAccess(info, input) {
                 acc = true;
                 break; // we only account for the first one
             }
-            else if (role === "index-access" /* RoleInParent.IndexAccess */) {
+            else if (role === "index-acc" /* RoleInParent.IndexAccess */) {
                 idxAcc = true;
                 break;
             }

package/util/containers.js

@@ -16,7 +16,7 @@ const type_1 = require("../r-bridge/lang-4.x/ast/model/type");
 function getAccessOperands(args) {
     const nonEmptyArgs = args.filter(arg => arg !== r_function_call_1.EmptyArgument);
     const accessedArg = nonEmptyArgs.find(arg => arg.info.role === "accessed" /* RoleInParent.Accessed */);
-    const accessArg = nonEmptyArgs.find(arg => arg.info.role === "index-access" /* RoleInParent.IndexAccess */);
+    const accessArg = nonEmptyArgs.find(arg => arg.info.role === "index-acc" /* RoleInParent.IndexAccess */);
     return { accessedArg, accessArg };
 }
 /**

package/util/files.d.ts

@@ -1,6 +1,5 @@
 import { type PathLike } from 'fs';
 import type { RParseRequestFromFile } from '../r-bridge/retriever';
-import type { FlowrFileProvider } from '../project/context/flowr-file';
 /**
  * Represents a table, identified by a header and a list of rows.
  */
@@ -70,12 +69,6 @@ export declare function readLineByLineSync(filePath: string, onLine: (line: Buff
  * @param directory - The directory whose parent to return
  */
 export declare function getParentDirectory(directory: string): string;
-/**
- * Parses the given file in the 'Debian Control Format'.
- * @param file - The file to parse
- * @returns Map containing the keys and values of the provided file.
- */
-export declare function parseDCF(file: FlowrFileProvider): Map<string, string[]>;
 /**
  * Checks whether the given path-like object is a file that exists on the local filesystem.
  */

package/util/files.js

@@ -44,7 +44,6 @@ exports.writeTableAsCsv = writeTableAsCsv;
 exports.readLineByLine = readLineByLine;
 exports.readLineByLineSync = readLineByLineSync;
 exports.getParentDirectory = getParentDirectory;
-exports.parseDCF = parseDCF;
 exports.isFilePath = isFilePath;
 const fs_1 = __importStar(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -201,46 +200,6 @@ function getParentDirectory(directory) {
     // apparently this is somehow the best way to do it in node, what
     return directory.split(path_1.default.sep).slice(0, -1).join(path_1.default.sep);
 }
-/**
- * Parses the given file in the 'Debian Control Format'.
- * @param file - The file to parse
- * @returns Map containing the keys and values of the provided file.
- */
-function parseDCF(file) {
-    const result = new Map();
-    let currentKey = '';
-    let currentValue = '';
-    const indentRegex = new RegExp(/^\s/);
-    const firstColonRegex = new RegExp(/:(.*)/s);
-    const fileContent = file.content().toString().split(/\r?\n/);
-    for (const line of fileContent) {
-        if (indentRegex.test(line)) {
-            currentValue += '\n' + line.trim();
-        }
-        else {
-            if (currentKey) {
-                const values = currentValue ? cleanValues(currentValue) : [];
-                result.set(currentKey, values);
-            }
-            const [key, rest] = line.split(firstColonRegex).map(s => s.trim());
-            currentKey = key.trim();
-            currentValue = rest.trim();
-        }
-    }
-    if (currentKey) {
-        const values = currentValue ? cleanValues(currentValue) : [];
-        result.set(currentKey, values);
-    }
-    return result;
-}
-const cleanSplitRegex = /[\n,]+/;
-const cleanQuotesRegex = /'/g;
-function cleanValues(values) {
-    return values
-        .split(cleanSplitRegex)
-        .map(s => s.trim().replace(cleanQuotesRegex, ''))
-        .filter(s => s.length > 0);
-}
 /**
  * Checks whether the given path-like object is a file that exists on the local filesystem.
  */

package/util/mermaid/ast.d.ts

@@ -1,10 +1,11 @@
 import type { ParentInformation, RNodeWithParent } from '../../r-bridge/lang-4.x/ast/model/processing/decorate';
 import type { RProject } from '../../r-bridge/lang-4.x/ast/model/nodes/r-project';
+import type { MermaidGraphPrinterInfo } from './info';
 /**
  * Serialize the normalized AST to mermaid format
  */
-export declare function normalizedAstToMermaid(ast: RProject<ParentInformation> | RNodeWithParent, prefix?: string): string;
+export declare function normalizedAstToMermaid(ast: RProject<ParentInformation> | RNodeWithParent, { prefix, markStyle, includeOnlyIds, mark }?: MermaidGraphPrinterInfo): string;
 /**
  * Use mermaid to visualize the normalized AST.
  */
-export declare function normalizedAstToMermaidUrl(ast: RProject<ParentInformation> | RNodeWithParent, prefix?: string): string;
+export declare function normalizedAstToMermaidUrl(ast: RProject<ParentInformation> | RNodeWithParent, info?: MermaidGraphPrinterInfo): string;

package/util/mermaid/ast.js

@@ -7,6 +7,7 @@ const visitor_1 = require("../../r-bridge/lang-4.x/ast/model/processing/visitor"
 const type_1 = require("../../r-bridge/lang-4.x/ast/model/type");
 const r_function_call_1 = require("../../r-bridge/lang-4.x/ast/model/nodes/r-function-call");
 const flowr_file_1 = require("../../project/context/flowr-file");
+const info_1 = require("./info");
 function identifyMermaidDirection(prefix) {
     const directionMatch = prefix.match(/flowchart (TD|LR|RL|BT)/);
     if (directionMatch) {
@@ -17,14 +18,20 @@ function identifyMermaidDirection(prefix) {
 /**
  * Serialize the normalized AST to mermaid format
  */
-function normalizedAstToMermaid(ast, prefix = 'flowchart TD\n') {
+function normalizedAstToMermaid(ast, { prefix = 'flowchart TD\n', markStyle = info_1.MermaidDefaultMarkStyle, includeOnlyIds, mark } = {}) {
     let output = prefix;
     function showNode(n) {
+        if (includeOnlyIds && !includeOnlyIds.has(n.info.id)) {
+            return;
+        }
         const name = `${n.type} (${n.info.id})\\n${n.lexeme ?? ' '}`;
         output += `    n${n.info.id}(["${(0, mermaid_1.escapeMarkdown)(name)}"])\n`;
-        if (n.info.parent !== undefined) {
+        if (mark?.has(n.info.id)) {
+            output += `    style n${n.info.id} ${markStyle.vertex}\n`;
+        }
+        if (n.info.parent !== undefined && (!includeOnlyIds || includeOnlyIds.has(n.info.parent))) {
             const context = n.info;
-            const roleSuffix = context.role === "expr-list-child" /* RoleInParent.ExpressionListChild */ || context.role === "call-argument" /* RoleInParent.FunctionCallArgument */ || context.role === "function-def-param" /* RoleInParent.FunctionDefinitionParameter */ ? `-${context.index}` : '';
+            const roleSuffix = context.role === "expr-list-child" /* RoleInParent.ExpressionListChild */ || context.role === "call-arg" /* RoleInParent.FunctionCallArgument */ || context.role === "param" /* RoleInParent.FunctionDefinitionParameter */ ? `-${context.index}` : '';
             output += `    n${n.info.parent} -->|"${context.role}${roleSuffix}"| n${n.info.id}\n`;
         }
         if (n.type === type_1.RType.ExpressionList && n.grouping !== undefined) {
@@ -49,9 +56,8 @@ function normalizedAstToMermaid(ast, prefix = 'flowchart TD\n') {
         for (const f of ast.files) {
             // add a subgraph for each file
             if (ast.files.length !== 1 || (f.filePath && f.filePath !== flowr_file_1.FlowrFile.INLINE_PATH)) {
-                output += `    subgraph "File: ${(0, mermaid_1.escapeMarkdown)(f.filePath ?? flowr_file_1.FlowrFile.INLINE_PATH)}"\n`;
                 const direction = identifyMermaidDirection(prefix);
-                output += `        direction ${direction}\n`;
+                output += `    subgraph "File: ${(0, mermaid_1.escapeMarkdown)(f.filePath ?? flowr_file_1.FlowrFile.INLINE_PATH)}" direction ${direction}\n`;
                 showAst(f.root);
                 output += '    end\n';
             }
@@ -68,7 +74,7 @@ function normalizedAstToMermaid(ast, prefix = 'flowchart TD\n') {
 /**
  * Use mermaid to visualize the normalized AST.
  */
-function normalizedAstToMermaidUrl(ast, prefix = 'flowchart TD\n') {
-    return (0, mermaid_1.mermaidCodeToUrl)(normalizedAstToMermaid(ast, prefix));
+function normalizedAstToMermaidUrl(ast, info) {
+    return (0, mermaid_1.mermaidCodeToUrl)(normalizedAstToMermaid(ast, info ?? {}));
 }
 //# sourceMappingURL=ast.js.map

package/util/mermaid/cfg.d.ts

@@ -1,5 +1,6 @@
 import type { NormalizedAst } from '../../r-bridge/lang-4.x/ast/model/processing/decorate';
 import { type ControlFlowInformation } from '../../control-flow/control-flow-graph';
+import { type MermaidGraphPrinterInfo } from './info';
 /**
  * Convert the control flow graph to a mermaid string.
  * @param cfg              - The control flow graph to convert.
@@ -7,8 +8,8 @@ import { type ControlFlowInformation } from '../../control-flow/control-flow-gra
  * @param prefix           - The prefix to use for the mermaid string.
  * @param simplify         - Whether to simplify the control flow graph (especially in the context of basic blocks).
  */
-export declare function cfgToMermaid(cfg: ControlFlowInformation, normalizedAst: NormalizedAst, prefix?: string, simplify?: boolean): string;
+export declare function cfgToMermaid(cfg: ControlFlowInformation, normalizedAst: NormalizedAst, { prefix, simplify, markStyle, includeOnlyIds, mark }?: MermaidGraphPrinterInfo): string;
 /**
  * Use mermaid to visualize the normalized AST.
  */
-export declare function cfgToMermaidUrl(cfg: ControlFlowInformation, normalizedAst: NormalizedAst, prefix?: string): string;
+export declare function cfgToMermaidUrl(cfg: ControlFlowInformation, normalizedAst: NormalizedAst, info?: MermaidGraphPrinterInfo): string;

package/util/mermaid/cfg.js

@@ -7,6 +7,7 @@ const type_1 = require("../../r-bridge/lang-4.x/ast/model/type");
 const control_flow_graph_1 = require("../../control-flow/control-flow-graph");
 const reconstruct_1 = require("../../reconstruct/reconstruct");
 const auto_select_defaults_1 = require("../../reconstruct/auto-select/auto-select-defaults");
+const info_1 = require("./info");
 function getLexeme(n) {
     return n ? n.info.fullLexeme ?? n.lexeme ?? '' : undefined;
 }
@@ -30,7 +31,7 @@ const getDirRegex = /flowchart\s+([A-Za-z]+)/;
  * @param prefix           - The prefix to use for the mermaid string.
  * @param simplify         - Whether to simplify the control flow graph (especially in the context of basic blocks).
  */
-function cfgToMermaid(cfg, normalizedAst, prefix = 'flowchart BT\n', simplify = false) {
+function cfgToMermaid(cfg, normalizedAst, { prefix = 'flowchart BT\n', simplify = false, markStyle = info_1.MermaidDefaultMarkStyle, includeOnlyIds, mark } = {}) {
     let output = prefix;
     const dirIs = getDirRegex.exec(prefix)?.at(1) ?? 'LR';
     for (const [id, vertex] of cfg.graph.vertices(false)) {
@@ -52,6 +53,10 @@ function cfgToMermaid(cfg, normalizedAst, prefix = 'flowchart BT\n', simplify =
                 output += `        direction ${dirIs}\n`;
                 let last = undefined;
                 for (const element of vertex.elems ?? []) {
+                    if (includeOnlyIds && !includeOnlyIds.has(element.id)) {
+                        last = undefined;
+                        continue;
+                    }
                     const childNormalizedVertex = normalizedAst?.idMap.get(element.id);
                     const childContent = getLexeme(childNormalizedVertex);
                     output = cfgOfNode(vertex, childNormalizedVertex, element.id, childContent, output);
@@ -64,7 +69,7 @@ function cfgToMermaid(cfg, normalizedAst, prefix = 'flowchart BT\n', simplify =
                 output += '    end\n';
             }
         }
-        else {
+        else if (!includeOnlyIds || includeOnlyIds.has(id)) {
             output = cfgOfNode(vertex, normalizedVertex, id, content, output);
         }
         if (vertex.name === type_1.RType.ExpressionList && vertex.type === control_flow_graph_1.CfgVertexType.EndMarker) {
@@ -72,24 +77,39 @@ function cfgToMermaid(cfg, normalizedAst, prefix = 'flowchart BT\n', simplify =
         }
     }
     for (const [from, targets] of cfg.graph.edges()) {
+        if (includeOnlyIds && !includeOnlyIds.has(from)) {
+            continue;
+        }
         for (const [to, edge] of targets) {
+            if (includeOnlyIds && !includeOnlyIds.has(to)) {
+                continue;
+            }
             const edgeType = edge.label === 1 /* CfgEdgeType.Cd */ ? '-->' : '-.->';
             const edgeSuffix = edge.label === 1 /* CfgEdgeType.Cd */ ? ` (${edge.when})` : '';
             output += `    n${from} ${edgeType}|"${(0, mermaid_1.escapeMarkdown)((0, control_flow_graph_1.edgeTypeToString)(edge.label))}${edgeSuffix}"| n${to}\n`;
         }
     }
     for (const entryPoint of cfg.entryPoints) {
-        output += `    style n${entryPoint} stroke:cyan,stroke-width:6.5px;`;
+        if (!includeOnlyIds || includeOnlyIds.has(entryPoint)) {
+            output += `    style n${entryPoint} stroke:cyan,stroke-width:6.5px;`;
+        }
     }
     for (const exitPoint of cfg.exitPoints) {
-        output += `    style n${exitPoint} stroke:green,stroke-width:6.5px;`;
+        if (!includeOnlyIds || includeOnlyIds.has(exitPoint)) {
+            output += `    style n${exitPoint} stroke:green,stroke-width:6.5px;`;
+        }
+    }
+    if (mark) {
+        for (const id of mark.values()) {
+            output += `    style n${id} ${markStyle.vertex}`;
+        }
     }
     return output;
 }
 /**
  * Use mermaid to visualize the normalized AST.
  */
-function cfgToMermaidUrl(cfg, normalizedAst, prefix = 'flowchart BT\n') {
-    return (0, mermaid_1.mermaidCodeToUrl)(cfgToMermaid(cfg, normalizedAst, prefix));
+function cfgToMermaidUrl(cfg, normalizedAst, info) {
+    return (0, mermaid_1.mermaidCodeToUrl)(cfgToMermaid(cfg, normalizedAst, info ?? {}));
 }
 //# sourceMappingURL=cfg.js.map

package/util/mermaid/dfg.d.ts

@@ -2,13 +2,7 @@ import type { SourceRange } from '../range';
 import { type DataflowGraph } from '../../dataflow/graph/graph';
 import { type NodeId } from '../../r-bridge/lang-4.x/ast/model/processing/node-id';
 import { type IdentifierDefinition } from '../../dataflow/environments/identifier';
-type MarkVertex = NodeId;
-type MarkEdge = `${string}->${string}`;
-export type MermaidMarkdownMark = MarkVertex | MarkEdge;
-export interface MermaidMarkStyle {
-    readonly vertex: string;
-    readonly edge: string;
-}
+import { type MermaidMarkdownMark, type MermaidMarkStyle } from './info';
 interface MermaidGraph {
     nodeLines: string[];
     edgeLines: string[];

package/util/mermaid/dfg.js

@@ -15,6 +15,7 @@ const edge_1 = require("../../dataflow/graph/edge");
 const vertex_1 = require("../../dataflow/graph/vertex");
 const type_1 = require("../../r-bridge/lang-4.x/ast/model/type");
 const built_in_1 = require("../../dataflow/environments/built-in");
+const info_1 = require("./info");
 /**
  * Prints a {@link SourceRange|range} as a human-readable string.
  */
@@ -147,7 +148,7 @@ function printEnvironmentToLines(env) {
     }
     return lines;
 }
-function vertexToMermaid(info, mermaid, id, idPrefix, mark) {
+function vertexToMermaid(info, mermaid, id, idPrefix, mark, includeOnlyIds) {
     const fCall = info.tag === vertex_1.VertexType.FunctionCall;
     const { open, close } = mermaidNodeBrackets(info.tag);
     id = (0, mermaid_1.escapeId)(id);
@@ -184,6 +185,9 @@ function vertexToMermaid(info, mermaid, id, idPrefix, mark) {
     const artificialCdEdges = (info.cds ?? []).map(x => [x.id, { types: new Set([x.when ? 'CD-True' : 'CD-False']) }]);
     // eslint-disable-next-line prefer-const
     for (let [target, edge] of [...edges[1], ...artificialCdEdges]) {
+        if (includeOnlyIds && !includeOnlyIds.has(target)) {
+            continue;
+        }
         const originalTarget = target;
         target = (0, mermaid_1.escapeId)(target);
         const edgeTypes = typeof edge.types == 'number' ? new Set((0, edge_1.splitEdgeTypes)(edge.types)) : edge.types;
@@ -214,11 +218,11 @@ function vertexToMermaid(info, mermaid, id, idPrefix, mark) {
     }
 }
 // make the passing of root ids more performant again
-function graphToMermaidGraph(rootIds, { simplified, graph, prefix = 'flowchart BT', idPrefix = '', includeEnvironments = !simplified, 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' } }) {
+function graphToMermaidGraph(rootIds, { simplified, graph, prefix = 'flowchart BT', idPrefix = '', includeEnvironments = !simplified, mark, rootGraph, presentEdges = new Set(), markStyle = info_1.MermaidDefaultMarkStyle, includeOnlyIds }) {
     const mermaid = { nodeLines: prefix === null ? [] : [prefix], edgeLines: [], presentEdges, presentVertices: new Set(), mark, rootGraph: rootGraph ?? graph, includeEnvironments, markStyle, simplified };
     for (const [id, info] of graph.vertices(true)) {
         if (rootIds.has(id)) {
-            vertexToMermaid(info, mermaid, id, idPrefix, mark);
+            vertexToMermaid(info, mermaid, id, idPrefix, mark, includeOnlyIds);
         }
     }
     return mermaid;

package/util/mermaid/info.d.ts

@@ -0,0 +1,17 @@
+import type { NodeId } from '../../r-bridge/lang-4.x/ast/model/processing/node-id';
+type MarkVertex = NodeId;
+type MarkEdge = `${string}->${string}`;
+export type MermaidMarkdownMark = MarkVertex | MarkEdge;
+export interface MermaidMarkStyle {
+    readonly vertex: string;
+    readonly edge: string;
+}
+export interface MermaidGraphPrinterInfo {
+    includeOnlyIds?: ReadonlySet<NodeId>;
+    mark?: ReadonlySet<MermaidMarkdownMark>;
+    markStyle?: MermaidMarkStyle;
+    prefix?: string;
+    simplify?: boolean;
+}
+export declare const MermaidDefaultMarkStyle: MermaidMarkStyle;
+export {};

package/util/mermaid/info.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MermaidDefaultMarkStyle = void 0;
+exports.MermaidDefaultMarkStyle = { vertex: 'stroke:teal,stroke-width:7px,stroke-opacity:.8;', edge: 'stroke:teal,stroke-width:4.2px,stroke-opacity:.8' };
+//# sourceMappingURL=info.js.map

package/util/prefix.d.ts

@@ -1,12 +1,16 @@
 /**
- * given a potentially partial prefix like `hell`, this finds the matching name in the map, but only
+ * Given a potentially partial prefix like `hell`, this finds the matching name in the keys, but only
  * if it is unique!
+ * Please note, that `...` is considered special here, anything *afteR* `...` will not be matched by prefix but only by exact name,
+ * following R's pmatch semantics.
  * @example
  * ```typescript
- * findByPrefixIfUnique('hell', { 'hello', 'bar' }) // => 'hello'
- * findByPrefixIfUnique('hell', { 'hello', 'hell' }) // => 'hell' (full match)
- * findByPrefixIfUnique('h', { 'hello', 'hell' }) // => undefined (not unique)
- * findByPrefixIfUnique('', { 'hello', 'hell' }) // => undefined (empty prefix)
+ * findByPrefixIfUnique('hello', [ 'hello', 'bar' ]) // => 'hello'
+ * findByPrefixIfUnique('hell', [ 'hello', 'bar' ]) // => 'hello'
+ * findByPrefixIfUnique('hell', [ 'hello', 'hell' ]) // => 'hell' (full/exact match)
+ * findByPrefixIfUnique('hell', [ 'bar', '...', 'hello' ]) // => undefined (not matched due to being after `...`)
+ * findByPrefixIfUnique('h', [ 'hello', 'hell' ]) // => undefined (not unique)
+ * findByPrefixIfUnique('', [ 'hello', 'hell' ]) // => undefined (empty prefix)
  * ```
  */
 export declare function findByPrefixIfUnique(prefix: string, keys: readonly string[] | MapIterator<string>): string | undefined;

package/util/prefix.js

@@ -2,14 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findByPrefixIfUnique = findByPrefixIfUnique;
 /**
- * given a potentially partial prefix like `hell`, this finds the matching name in the map, but only
+ * Given a potentially partial prefix like `hell`, this finds the matching name in the keys, but only
  * if it is unique!
+ * Please note, that `...` is considered special here, anything *afteR* `...` will not be matched by prefix but only by exact name,
+ * following R's pmatch semantics.
  * @example
  * ```typescript
- * findByPrefixIfUnique('hell', { 'hello', 'bar' }) // => 'hello'
- * findByPrefixIfUnique('hell', { 'hello', 'hell' }) // => 'hell' (full match)
- * findByPrefixIfUnique('h', { 'hello', 'hell' }) // => undefined (not unique)
- * findByPrefixIfUnique('', { 'hello', 'hell' }) // => undefined (empty prefix)
+ * findByPrefixIfUnique('hello', [ 'hello', 'bar' ]) // => 'hello'
+ * findByPrefixIfUnique('hell', [ 'hello', 'bar' ]) // => 'hello'
+ * findByPrefixIfUnique('hell', [ 'hello', 'hell' ]) // => 'hell' (full/exact match)
+ * findByPrefixIfUnique('hell', [ 'bar', '...', 'hello' ]) // => undefined (not matched due to being after `...`)
+ * findByPrefixIfUnique('h', [ 'hello', 'hell' ]) // => undefined (not unique)
+ * findByPrefixIfUnique('', [ 'hello', 'hell' ]) // => undefined (empty prefix)
  * ```
  */
 function findByPrefixIfUnique(prefix, keys) {
@@ -17,11 +21,15 @@ function findByPrefixIfUnique(prefix, keys) {
         return undefined;
     }
     let found = undefined;
+    let matchPartial = true;
     for (const key of keys) {
         if (key === prefix) {
             return key;
         }
-        if (key.startsWith(prefix)) {
+        if (key === '...') {
+            matchPartial = false;
+        }
+        else if (matchPartial && key.startsWith(prefix)) {
             if (found) {
                 return undefined;
             }

package/util/r-regex.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Represents R's `.standard_regexps` definitions.
+ * @see https://github.com/r-devel/r-svn/blob/44474af03ae77fd3b9a340279fa10cb698d106c3/src/library/base/R/utils.R#L52-L53
+ */
+export declare const RStandardRegexp: {
+    /** `[[:alpha:]][[:alnum:].]*[[:alnum:]]` */
+    ValidPackageName: RegExp;
+    /** `([[:digit:]]+[.-]){1,}[[:digit:]]+` */
+    ValidPackageVersion: RegExp;
+    /** `[[:digit:]]+\\.[[:digit:]]+\\.[[:digit:]]+` */
+    ValidRSystemVersion: RegExp;
+    /** `([[:digit:]]+[.-])*[[:digit:]]+` */
+    ValidNumericVersion: RegExp;
+};
+/**
+ * Based on the C-definition:
+ * ```txt
+ * !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~
+ * ```
+ */
+export declare const RPunctuationChars = "!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~";

package/util/r-regex.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RPunctuationChars = exports.RStandardRegexp = void 0;
+/**
+ * Represents R's `.standard_regexps` definitions.
+ * @see https://github.com/r-devel/r-svn/blob/44474af03ae77fd3b9a340279fa10cb698d106c3/src/library/base/R/utils.R#L52-L53
+ */
+exports.RStandardRegexp = {
+    /** `[[:alpha:]][[:alnum:].]*[[:alnum:]]` */
+    ValidPackageName: (/[A-Za-z][A-Za-z0-9._]*[A-Za-z0-9]/),
+    /** `([[:digit:]]+[.-]){1,}[[:digit:]]+` */
+    ValidPackageVersion: (/([0-9]+[.-])+[0-9]+/),
+    /** `[[:digit:]]+\\.[[:digit:]]+\\.[[:digit:]]+` */
+    ValidRSystemVersion: (/[0-9]+\.[0-9]+\.[0-9]+/),
+    /** `([[:digit:]]+[.-])*[[:digit:]]+` */
+    ValidNumericVersion: /([0-9]+[.-])*[0-9]+/
+};
+/**
+ * Based on the C-definition:
+ * ```txt
+ * !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~
+ * ```
+ */
+exports.RPunctuationChars = '!"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~';
+//# sourceMappingURL=r-regex.js.map

package/util/text/args.js

@@ -55,10 +55,19 @@ function splitAtEscapeSensitive(inputString, escapeQuote = true, split = ' ') {
             current = '';
         }
         else if (c === '"' || c === "'") {
-            inQuotes = !inQuotes;
-            if (!escapeQuote) {
-                current += c;
+            if (!inQuotes) {
+                inQuotes = c;
+                if (escapeQuote) {
+                    continue;
+                }
             }
+            else if (inQuotes === c) {
+                inQuotes = false;
+                if (escapeQuote) {
+                    continue;
+                }
+            }
+            current += c;
         }
         else if (c === '\\' && escapeQuote) {
             escaped = true;

package/util/version.js

@@ -6,7 +6,7 @@ exports.printVersionInformation = printVersionInformation;
 const semver_1 = require("semver");
 const assert_1 = require("./assert");
 // this is automatically replaced with the current version by release-it
-const version = '2.7.0';
+const version = '2.7.3';
 /**
  * Retrieves the current flowR version as a new {@link SemVer} object.
  */