@eagleoutice/flowr 2.0.25 → 2.1.0

package/cli/flowr.js

@@ -3,45 +3,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.optionHelp = exports.optionDefinitions = exports.toolName = void 0;
+exports.optionHelp = exports.toolName = void 0;
 const server_1 = require("./repl/server/server");
 const net_1 = require("./repl/server/net");
 const version_1 = require("../util/version");
+const command_line_usage_1 = __importDefault(require("command-line-usage"));
 const log_1 = require("../util/log");
 const ansi_1 = require("../util/ansi");
 const command_line_args_1 = __importDefault(require("command-line-args"));
-const command_line_usage_1 = __importDefault(require("command-line-usage"));
 const config_1 = require("../config");
 const assert_1 = require("../util/assert");
 const scripts_info_1 = require("./common/scripts-info");
 const shell_1 = require("../r-bridge/shell");
 const execute_1 = require("./repl/execute");
-const main_1 = require("./repl/commands/main");
+const repl_main_1 = require("./repl/commands/repl-main");
 const core_1 = require("./repl/core");
-const version_2 = require("./repl/commands/version");
+const repl_version_1 = require("./repl/commands/repl-version");
 const print_version_1 = require("./repl/print-version");
-let _scriptsText;
-function getScriptsText() {
-    if (_scriptsText === undefined) {
-        _scriptsText = Array.from(Object.entries(scripts_info_1.scripts).filter(([, { type }]) => type === 'master script'), ([k,]) => k).join(', ');
-    }
-    return _scriptsText;
-}
+const flowr_main_options_1 = require("./flowr-main-options");
 exports.toolName = 'flowr';
-exports.optionDefinitions = [
-    { name: 'config-file', type: String, description: 'The name of the configuration file to use', multiple: false },
-    { name: 'execute', alias: 'e', type: String, description: 'Execute the given command and exit. Use a semicolon ";" to separate multiple commands.', typeLabel: '{underline command}', multiple: false },
-    { name: 'help', alias: 'h', type: Boolean, description: 'Print this usage guide (or the guide of the corresponding script)' },
-    { name: 'no-ansi', type: Boolean, description: 'Disable ansi-escape-sequences in the output. Useful, if you want to redirect the output to a file.' },
-    { name: 'port', type: Number, description: 'The port to listen on, if --server is given.', defaultValue: 1042, typeLabel: '{underline port}' },
-    { name: 'r-path', type: String, description: 'The path to the R executable to use. Defaults to your PATH.', multiple: false },
-    { name: 'r-session-access', type: Boolean, description: 'Allow to access the underlying R session when using flowR (security warning: this allows the execution of arbitrary R code!)' },
-    { name: 'script', alias: 's', type: String, description: `The sub-script to run (${getScriptsText()})`, multiple: false, defaultOption: true, typeLabel: '{underline files}', defaultValue: undefined },
-    { name: 'server', type: Boolean, description: 'Do not drop into a repl, but instead start a server on the given port (default: 1042) and listen for messages.' },
-    { name: 'verbose', alias: 'v', type: Boolean, description: 'Run with verbose logging (will be passed to the corresponding script)' },
-    { name: 'version', alias: 'V', type: Boolean, description: 'Provide information about the version of flowR as well as its underlying R system and exit.' },
-    { name: 'ws', type: Boolean, description: 'If the server flag is set, use websocket for messaging' }
-];
 exports.optionHelp = [
     {
         header: `flowR (version ${(0, version_1.flowrVersion)().toString()})`,
@@ -59,17 +39,28 @@ exports.optionHelp = [
     },
     {
         header: 'Options',
-        optionList: exports.optionDefinitions
+        optionList: flowr_main_options_1.flowrMainOptionDefinitions
     }
 ];
-const options = (0, command_line_args_1.default)(exports.optionDefinitions);
+const options = (0, command_line_args_1.default)(flowr_main_options_1.flowrMainOptionDefinitions);
 log_1.log.updateSettings(l => l.settings.minLevel = options.verbose ? 1 /* LogLevel.Trace */ : 5 /* LogLevel.Error */);
 log_1.log.info('running with options', options);
 if (options['no-ansi']) {
     log_1.log.info('disabling ansi colors');
     (0, ansi_1.setFormatter)(ansi_1.voidFormatter);
 }
-(0, config_1.setConfigFile)(undefined, options['config-file'] ?? config_1.defaultConfigFile, true);
+let usedConfig = false;
+if (options['config-json']) {
+    const config = (0, config_1.parseConfig)(options['config-json']);
+    if (config) {
+        log_1.log.info(`Using passed config ${JSON.stringify(config)}`);
+        (0, config_1.setConfig)(config);
+        usedConfig = true;
+    }
+}
+if (!usedConfig) {
+    (0, config_1.setConfigFile)(options['config-file'] ?? flowr_main_options_1.defaultConfigFile, undefined, true);
+}
 function retrieveShell() {
     // we keep an active shell session to allow other parse investigations :)
     let opts = {
@@ -88,7 +79,7 @@ function retrieveShell() {
 async function mainRepl() {
     if (options.script) {
         const target = scripts_info_1.scripts[options.script].target;
-        (0, assert_1.guard)(target !== undefined, `Unknown script ${options.script}, pick one of ${getScriptsText()}.`);
+        (0, assert_1.guard)(target !== undefined, `Unknown script ${options.script}, pick one of ${(0, flowr_main_options_1.getScriptsText)()}.`);
         console.log(`Running script '${ansi_1.formatter.format(options.script, { style: 1 /* FontStyles.Bold */ })}'`);
         log_1.log.debug(`Script maps to "${target}"`);
         await (0, execute_1.waitOnScript)(`${__dirname}/${target}`, process.argv.slice(3), undefined, true);
@@ -101,7 +92,7 @@ async function mainRepl() {
     if (options.version) {
         const shell = new shell_1.RShell();
         process.on('exit', () => shell.close());
-        await (0, version_2.printVersionInformation)(main_1.standardReplOutput, shell);
+        await (0, repl_version_1.printVersionInformation)(repl_main_1.standardReplOutput, shell);
         process.exit(0);
     }
     const shell = retrieveShell();
@@ -117,7 +108,7 @@ async function mainRepl() {
     process.on('SIGTERM', end);
     const allowRSessionAccess = options['r-session-access'] ?? false;
     if (options.execute) {
-        await (0, core_1.replProcessAnswer)(main_1.standardReplOutput, options.execute, shell, allowRSessionAccess);
+        await (0, core_1.replProcessAnswer)(repl_main_1.standardReplOutput, options.execute, shell, allowRSessionAccess);
     }
     else {
         await (0, print_version_1.printVersionRepl)(shell);

package/cli/repl/commands/{cfg.d.ts → repl-cfg.d.ts}

@@ -1,3 +1,3 @@
-import type { ReplCommand } from './main';
+import type { ReplCommand } from './repl-main';
 export declare const controlflowCommand: ReplCommand;
 export declare const controlflowStarCommand: ReplCommand;

package/cli/repl/commands/{cfg.js → repl-cfg.js}

@@ -24,8 +24,8 @@ exports.controlflowCommand = {
     }
 };
 exports.controlflowStarCommand = {
-    description: `Get a mermaid url of the control-flow graph of R code, start with '${retriever_1.fileProtocol}' to indicate a file`,
-    usageExample: ':controlflow',
+    description: 'Returns the URL to mermaid.live',
+    usageExample: ':controlflow*',
     aliases: ['cfg*', 'cf*'],
     script: false,
     fn: async (output, shell, remainingLine) => {
@@ -34,4 +34,4 @@ exports.controlflowStarCommand = {
         output.stdout((0, cfg_2.cfgToMermaidUrl)(cfg, result.normalize));
     }
 };
-//# sourceMappingURL=cfg.js.map
+//# sourceMappingURL=repl-cfg.js.map

package/cli/repl/commands/{commands.d.ts → repl-commands.d.ts}

@@ -1,5 +1,6 @@
-import type { ReplCommand } from './main';
+import type { ReplCommand } from './repl-main';
 export declare const helpCommand: ReplCommand;
+export declare function getReplCommands(): Record<string, ReplCommand>;
 /**
  * The names of all commands including their aliases (but without the leading `:`)
  */
@@ -11,3 +12,4 @@ export declare function getCommandNames(): string[];
 export declare function getCommand(command: string): ReplCommand | undefined;
 export declare function asOptionName(argument: string): string;
 export declare function longestCommandName(): number;
+export declare function padCmd<T>(string: T): string;

package/cli/repl/commands/{commands.js → repl-commands.js}

@@ -1,28 +1,50 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.longestCommandName = exports.asOptionName = exports.getCommand = exports.getCommandNames = exports.helpCommand = void 0;
-const quit_1 = require("./quit");
+exports.helpCommand = void 0;
+exports.getReplCommands = getReplCommands;
+exports.getCommandNames = getCommandNames;
+exports.getCommand = getCommand;
+exports.asOptionName = asOptionName;
+exports.longestCommandName = longestCommandName;
+exports.padCmd = padCmd;
+const repl_quit_1 = require("./repl-quit");
 const execute_1 = require("../execute");
 const prompt_1 = require("../prompt");
-const version_1 = require("./version");
-const parse_1 = require("./parse");
-const execute_2 = require("./execute");
-const normalize_1 = require("./normalize");
-const dataflow_1 = require("./dataflow");
-const cfg_1 = require("./cfg");
+const repl_version_1 = require("./repl-version");
+const repl_parse_1 = require("./repl-parse");
+const repl_execute_1 = require("./repl-execute");
+const repl_normalize_1 = require("./repl-normalize");
+const repl_dataflow_1 = require("./repl-dataflow");
+const repl_cfg_1 = require("./repl-cfg");
 const ansi_1 = require("../../../util/ansi");
 const args_1 = require("../../../util/args");
 const assert_1 = require("../../../util/assert");
 const scripts_info_1 = require("../../common/scripts-info");
-const lineage_1 = require("./lineage");
-function printHelpForScript(script, f) {
-    const base = `  ${(0, ansi_1.bold)(padCmd(':' + script[0]), f)}${script[1].description}`;
+const repl_lineage_1 = require("./repl-lineage");
+const repl_query_1 = require("./repl-query");
+function printHelpForScript(script, f, starredVersion) {
+    let base = `  ${(0, ansi_1.bold)(padCmd(':' + script[0] + (starredVersion ? '[*]' : '')), f)}${script[1].description}`;
+    if (starredVersion) {
+        base += ` (star: ${starredVersion.description})`;
+    }
     if (script[1].aliases.length === 0) {
         return base;
     }
     const aliases = script[1].aliases;
     return `${base} (alias${aliases.length > 1 ? 'es' : ''}: ${aliases.map(a => (0, ansi_1.bold)(':' + a, f)).join(', ')})`;
 }
+function printCommandHelp(formatter) {
+    const scriptHelp = [];
+    const cmds = getReplCommands();
+    for (const c of Object.entries(cmds)) {
+        if (c[1].script || c[0].endsWith('*')) {
+            continue;
+        }
+        const starred = cmds[c[0] + '*'];
+        scriptHelp.push(printHelpForScript(c, formatter, starred));
+    }
+    return scriptHelp.sort().join('\n');
+}
 exports.helpCommand = {
     description: 'Show help information',
     script: false,
@@ -31,15 +53,16 @@ exports.helpCommand = {
     fn: output => {
         initCommandMapping();
         output.stdout(`
-If enabled, you can just enter R expressions which get evaluated right away:
+If enabled ('--r-session-access'), you can just enter R expressions which get evaluated right away:
 ${prompt_1.rawPrompt} ${(0, ansi_1.bold)('1 + 1', output.formatter)}
 ${(0, ansi_1.italic)('[1] 2', output.formatter)}
 
-Besides that, you can use the following commands. The scripts ${(0, ansi_1.italic)('can', output.formatter)} accept further arguments. There are the following basic commands:
-${Array.from(Object.entries(commands())).filter(([, { script }]) => !script).map(c => printHelpForScript(c, output.formatter)).join('\n')}
+Besides that, you can use the following commands. The scripts ${(0, ansi_1.italic)('can', output.formatter)} accept further arguments. In general, those ending with [*] may be called with and without the star. 
+There are the following basic commands:
+${printCommandHelp(output.formatter)}
 
 Furthermore, you can directly call the following scripts which accept arguments. If you are unsure, try to add ${(0, ansi_1.italic)('--help', output.formatter)} after the command.
-${Array.from(Object.entries(commands())).filter(([, { script }]) => script).map(([command, { description }]) => `  ${(0, ansi_1.bold)(padCmd(':' + command), output.formatter)}${description}`).join('\n')}
+${Array.from(Object.entries(getReplCommands())).filter(([, { script }]) => script).map(([command, { description }]) => `  ${(0, ansi_1.bold)(padCmd(':' + command), output.formatter)}${description}`).sort().join('\n')}
 
 You can combine commands by separating them with a semicolon ${(0, ansi_1.bold)(';', output.formatter)}.
 `);
@@ -50,17 +73,19 @@ You can combine commands by separating them with a semicolon ${(0, ansi_1.bold)(
  */
 const _commands = {
     'help': exports.helpCommand,
-    'quit': quit_1.quitCommand,
-    'version': version_1.versionCommand,
-    'execute': execute_2.executeCommand,
-    'parse': parse_1.parseCommand,
-    'normalize': normalize_1.normalizeCommand,
-    'normalize*': normalize_1.normalizeStarCommand,
-    'dataflow': dataflow_1.dataflowCommand,
-    'dataflow*': dataflow_1.dataflowStarCommand,
-    'controlflow': cfg_1.controlflowCommand,
-    'controlflow*': cfg_1.controlflowStarCommand,
-    'lineage': lineage_1.getLineageCommand
+    'quit': repl_quit_1.quitCommand,
+    'version': repl_version_1.versionCommand,
+    'execute': repl_execute_1.executeCommand,
+    'parse': repl_parse_1.parseCommand,
+    'normalize': repl_normalize_1.normalizeCommand,
+    'normalize*': repl_normalize_1.normalizeStarCommand,
+    'dataflow': repl_dataflow_1.dataflowCommand,
+    'dataflow*': repl_dataflow_1.dataflowStarCommand,
+    'controlflow': repl_cfg_1.controlflowCommand,
+    'controlflow*': repl_cfg_1.controlflowStarCommand,
+    'lineage': repl_lineage_1.lineageCommand,
+    'query': repl_query_1.queryCommand,
+    'query*': repl_query_1.queryStarCommand
 };
 let commandsInitialized = false;
 function hasModule(path) {
@@ -72,7 +97,7 @@ function hasModule(path) {
         return false;
     }
 }
-function commands() {
+function getReplCommands() {
     if (commandsInitialized) {
         return _commands;
     }
@@ -110,14 +135,13 @@ function getCommandNames() {
     }
     return commandNames;
 }
-exports.getCommandNames = getCommandNames;
 let commandNames = undefined;
 // maps command names or aliases to the actual command name
 let commandMapping = undefined;
 function initCommandMapping() {
     commandMapping = {};
     commandNames = [];
-    for (const [command, { aliases }] of Object.entries(commands())) {
+    for (const [command, { aliases }] of Object.entries(getReplCommands())) {
         (0, assert_1.guard)(commandMapping[command] === undefined, `Command ${command} is already registered!`);
         commandMapping[command] = command;
         for (const alias of aliases) {
@@ -136,9 +160,8 @@ function getCommand(command) {
     if (commandMapping === undefined) {
         initCommandMapping();
     }
-    return commands()[commandMapping[command]];
+    return getReplCommands()[commandMapping[command]];
 }
-exports.getCommand = getCommand;
 function asOptionName(argument) {
     if (argument.length == 1) {
         return `-${argument}`;
@@ -147,16 +170,14 @@ function asOptionName(argument) {
         return `--${argument}`;
     }
 }
-exports.asOptionName = asOptionName;
 let _longestCommandName = undefined;
 function longestCommandName() {
     if (_longestCommandName === undefined) {
-        _longestCommandName = Array.from(Object.keys(commands()), k => k.length).reduce((p, n) => Math.max(p, n), 0);
+        _longestCommandName = Array.from(Object.keys(getReplCommands()), k => k.endsWith('*') ? k.length + 3 : k.length).reduce((p, n) => Math.max(p, n), 0);
     }
     return _longestCommandName;
 }
-exports.longestCommandName = longestCommandName;
 function padCmd(string) {
     return String(string).padEnd(longestCommandName() + 2, ' ');
 }
-//# sourceMappingURL=commands.js.map
+//# sourceMappingURL=repl-commands.js.map

package/cli/repl/commands/{dataflow.d.ts → repl-dataflow.d.ts}

@@ -1,3 +1,3 @@
-import type { ReplCommand } from './main';
+import type { ReplCommand } from './repl-main';
 export declare const dataflowCommand: ReplCommand;
 export declare const dataflowStarCommand: ReplCommand;

package/cli/repl/commands/{dataflow.js → repl-dataflow.js}

@@ -22,7 +22,7 @@ exports.dataflowCommand = {
     }
 };
 exports.dataflowStarCommand = {
-    description: `Get a mermaid url of the dataflow graph of R code, start with '${retriever_1.fileProtocol}' to indicate a file`,
+    description: 'Returns the URL to mermaid.live',
     usageExample: ':dataflow*',
     aliases: ['d*', 'df*'],
     script: false,
@@ -31,4 +31,4 @@ exports.dataflowStarCommand = {
         output.stdout((0, dfg_1.graphToMermaidUrl)(result.dataflow.graph, false));
     }
 };
-//# sourceMappingURL=dataflow.js.map
+//# sourceMappingURL=repl-dataflow.js.map

package/cli/repl/commands/{execute.d.ts → repl-execute.d.ts}

@@ -1,4 +1,4 @@
-import type { ReplCommand, ReplOutput } from './main';
+import type { ReplCommand, ReplOutput } from './repl-main';
 import type { RShell } from '../../../r-bridge/shell';
 export declare function executeRShellCommand(output: ReplOutput, shell: RShell, statement: string): Promise<void>;
 export declare const executeCommand: ReplCommand;

package/cli/repl/commands/{execute.js → repl-execute.js}

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeCommand = exports.executeRShellCommand = void 0;
+exports.executeCommand = void 0;
+exports.executeRShellCommand = executeRShellCommand;
 const ansi_1 = require("../../../util/ansi");
 async function executeRShellCommand(output, shell, statement) {
     try {
@@ -14,7 +15,6 @@ async function executeRShellCommand(output, shell, statement) {
         output.stderr(`Error while executing '${statement}': ${e.message}`);
     }
 }
-exports.executeRShellCommand = executeRShellCommand;
 exports.executeCommand = {
     description: 'Execute the given code as R code (essentially similar to using now command)',
     usageExample: ':execute',
@@ -24,4 +24,4 @@ exports.executeCommand = {
         await executeRShellCommand(output, shell, remainingLine);
     }
 };
-//# sourceMappingURL=execute.js.map
+//# sourceMappingURL=repl-execute.js.map

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

@@ -0,0 +1,15 @@
+import type { ReplCommand } from './repl-main';
+import type { SingleSlicingCriterion } from '../../../slicing/criterion/parse';
+import type { NodeId } from '../../../r-bridge/lang-4.x/ast/model/processing/node-id';
+import type { DataflowGraph } from '../../../dataflow/graph/graph';
+import type { AstIdMap } 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 graph - The dataflow graph to search in
+ * @param idMap - The ID map to use for resolving the criterion (will default to that shipped with the dfgraph)
+ * @returns The lineage of the node represented as a set of node ids
+ */
+export declare function getLineage(criterion: SingleSlicingCriterion, graph: DataflowGraph, idMap?: AstIdMap): Set<NodeId>;
+export declare const lineageCommand: ReplCommand;

package/cli/repl/commands/{lineage.js → repl-lineage.js}

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLineageCommand = exports.getLineage = void 0;
+exports.lineageCommand = void 0;
+exports.getLineage = getLineage;
 const pipeline_executor_1 = require("../../../core/pipeline-executor");
 const default_pipelines_1 = require("../../../core/steps/pipeline/default-pipelines");
 const retriever_1 = require("../../../r-bridge/retriever");
@@ -17,7 +18,7 @@ async function getDfg(shell, remainingLine) {
     }).allRemainingSteps();
 }
 function filterRelevantEdges(edge) {
-    return (0, edge_1.edgeIncludesType)(2 /* EdgeType.DefinedBy */ | 32 /* EdgeType.DefinedByOnCall */ | 8 /* EdgeType.Returns */ | 1 /* EdgeType.Reads */, edge.types);
+    return (0, edge_1.edgeIncludesType)(edge_1.EdgeType.DefinedBy | edge_1.EdgeType.DefinedByOnCall | edge_1.EdgeType.Returns | edge_1.EdgeType.Reads, edge.types);
 }
 function pushRelevantEdges(queue, outgoingEdges) {
     queue.push(...[...outgoingEdges].filter(([_, edge]) => filterRelevantEdges(edge)));
@@ -26,12 +27,14 @@ function pushRelevantEdges(queue, outgoingEdges) {
  * 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
+ * @param graph - The dataflow graph to search in
+ * @param idMap - The ID map to use for resolving the criterion (will default to that shipped with the dfgraph)
  * @returns The lineage of the node represented as a set of node ids
  */
-function getLineage(criterion, { idMap }, dfg) {
-    const src = dfg.graph.get((0, parse_1.slicingCriterionToId)(criterion, idMap));
+function getLineage(criterion, graph, idMap) {
+    idMap ??= graph.idMap;
+    (0, assert_1.guard)(idMap !== undefined, 'The ID map is required to get the lineage of a node');
+    const src = graph.get((0, parse_1.slicingCriterionToId)(criterion, idMap));
     (0, assert_1.guard)(src !== undefined, 'The ID pointed to by the criterion does not exist in the dataflow graph');
     const [vertex, outgoingEdges] = src;
     const result = new Set([vertex.id]);
@@ -43,24 +46,23 @@ function getLineage(criterion, { idMap }, dfg) {
             continue;
         }
         result.add(target);
-        const outgoingEdges = dfg.graph.outgoingEdges(target);
+        const outgoingEdges = graph.outgoingEdges(target);
         if (outgoingEdges !== undefined) {
             pushRelevantEdges(edgeQueue, outgoingEdges);
         }
     }
     return result;
 }
-exports.getLineage = getLineage;
-exports.getLineageCommand = {
+exports.lineageCommand = {
     description: 'Get the lineage of an R object',
     usageExample: ':lineage',
     aliases: ['lin'],
     script: false,
     fn: async (output, shell, remainingLine) => {
         const [criterion, rest] = splitAt(remainingLine, remainingLine.indexOf(' '));
-        const { dataflow: dfg, normalize: ast } = await getDfg(shell, rest);
-        const lineageIds = getLineage(criterion, ast, dfg);
+        const { dataflow: dfg } = await getDfg(shell, rest);
+        const lineageIds = getLineage(criterion, dfg.graph);
         output.stdout([...lineageIds].join('\n'));
     }
 };
-//# sourceMappingURL=lineage.js.map
+//# sourceMappingURL=repl-lineage.js.map

package/cli/repl/commands/{main.js → repl-main.js}

@@ -11,4 +11,4 @@ exports.standardReplOutput = {
     stdout: console.log,
     stderr: console.error
 };
-//# sourceMappingURL=main.js.map
+//# sourceMappingURL=repl-main.js.map

package/cli/repl/commands/{normalize.d.ts → repl-normalize.d.ts}

@@ -1,3 +1,3 @@
-import type { ReplCommand } from './main';
+import type { ReplCommand } from './repl-main';
 export declare const normalizeCommand: ReplCommand;
 export declare const normalizeStarCommand: ReplCommand;

package/cli/repl/commands/{normalize.js → repl-normalize.js}

@@ -22,8 +22,8 @@ exports.normalizeCommand = {
     }
 };
 exports.normalizeStarCommand = {
-    description: `Get a mermaid url of the normalized AST of R code, start with '${retriever_1.fileProtocol}' to indicate a file`,
-    usageExample: ':normalize',
+    description: 'Returns the URL to mermaid.live',
+    usageExample: ':normalize*',
     aliases: ['n*'],
     script: false,
     fn: async (output, shell, remainingLine) => {
@@ -31,4 +31,4 @@ exports.normalizeStarCommand = {
         output.stdout((0, ast_1.normalizedAstToMermaidUrl)(result.normalize.ast));
     }
 };
-//# sourceMappingURL=normalize.js.map
+//# sourceMappingURL=repl-normalize.js.map

package/cli/repl/commands/{parse.d.ts → repl-parse.d.ts}

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

package/cli/repl/commands/{parse.js → repl-parse.js}

@@ -5,11 +5,12 @@ const pipeline_executor_1 = require("../../../core/pipeline-executor");
 const format_1 = require("../../../r-bridge/lang-4.x/ast/parser/json/format");
 const parser_1 = require("../../../r-bridge/lang-4.x/ast/parser/json/parser");
 const input_format_1 = require("../../../r-bridge/lang-4.x/ast/parser/xml/input-format");
+const type_1 = require("../../../r-bridge/lang-4.x/ast/model/type");
 const normalize_meta_1 = require("../../../r-bridge/lang-4.x/ast/parser/xml/normalize-meta");
 const default_pipelines_1 = require("../../../core/steps/pipeline/default-pipelines");
 const retriever_1 = require("../../../r-bridge/retriever");
 function toDepthMap(xml) {
-    const root = (0, input_format_1.getKeyGuarded)(xml, "exprlist" /* RawRType.ExpressionList */);
+    const root = (0, input_format_1.getKeyGuarded)(xml, type_1.RawRType.ExpressionList);
     const visit = [{ depth: 0, node: root }];
     const result = [];
     while (visit.length > 0) {
@@ -107,4 +108,4 @@ exports.parseCommand = {
         output.stdout(depthListToTextTree(toDepthMap(object), output.formatter));
     }
 };
-//# sourceMappingURL=parse.js.map
+//# sourceMappingURL=repl-parse.js.map

package/cli/repl/commands/repl-query.d.ts

@@ -0,0 +1,8 @@
+import { DEFAULT_DATAFLOW_PIPELINE } from '../../../core/steps/pipeline/default-pipelines';
+import type { ReplCommand } from './repl-main';
+import type { OutputFormatter } from '../../../util/ansi';
+import type { QueryResults, SupportedQueryTypes } from '../../../queries/query';
+import type { PipelineOutput } from '../../../core/steps/pipeline/pipeline';
+export declare function asciiSummaryOfQueryResult(formatter: OutputFormatter, totalInMs: number, results: QueryResults<SupportedQueryTypes>, processed: PipelineOutput<typeof DEFAULT_DATAFLOW_PIPELINE>): string;
+export declare const queryCommand: ReplCommand;
+export declare const queryStarCommand: ReplCommand;