@eagleoutice/flowr 2.2.14 → 2.2.16

package/dataflow/internal/process/functions/call/built-in/built-in-while-loop.js

@@ -11,6 +11,8 @@ const logger_1 = require("../../../../../logger");
 const environment_1 = require("../../../../../environments/environment");
 const edge_1 = require("../../../../../graph/edge");
 const identifier_1 = require("../../../../../environments/identifier");
+const general_1 = require("../../../../../eval/values/general");
+const alias_tracking_1 = require("../../../../../eval/resolve/alias-tracking");
 function processWhileLoop(name, args, rootId, data) {
     if (args.length !== 2 || args[1] === r_function_call_1.EmptyArgument) {
         logger_1.dataflowLogger.warn(`While-Loop ${name.content} does not have 2 arguments, skipping`);
@@ -21,6 +23,13 @@ function processWhileLoop(name, args, rootId, data) {
         logger_1.dataflowLogger.warn(`While-Loop ${name.content} has empty arguments in ${JSON.stringify(args)}, skipping`);
         return (0, known_call_handling_1.processKnownFunctionCall)({ name, args, rootId, data, origin: 'default' }).information;
     }
+    // we should defer this to the abstract interpretation
+    const values = (0, alias_tracking_1.resolveIdToValue)(unpackedArgs[0]?.info.id, { environment: data.environment, idMap: data.completeAst.idMap, resolve: data.flowrConfig.solver.variables });
+    const conditionIsAlwaysFalse = (0, general_1.valueSetGuard)(values)?.elements.every(d => d.type === 'logical' && d.value === false) ?? false;
+    //We don't care about the body if it never executes
+    if (conditionIsAlwaysFalse) {
+        unpackedArgs.pop();
+    }
     /* we inject the cf-dependency of the while-loop after the condition */
     const { information, processedArguments } = (0, known_call_handling_1.processKnownFunctionCall)({
         name,
@@ -36,10 +45,24 @@ function processWhileLoop(name, args, rootId, data) {
         }, origin: 'builtin:while-loop'
     });
     const [condition, body] = processedArguments;
+    // If the condition is always false, we don't include the body
+    if (condition !== undefined && conditionIsAlwaysFalse) {
+        information.graph.addEdge(name.info.id, condition.entryPoint, edge_1.EdgeType.Reads);
+        return {
+            unknownReferences: [],
+            in: [{ nodeId: name.info.id, name: name.lexeme, controlDependencies: data.controlDependencies, type: identifier_1.ReferenceType.Function }],
+            out: condition.out,
+            entryPoint: name.info.id,
+            exitPoints: [],
+            graph: information.graph,
+            environment: information.environment
+        };
+    }
     (0, assert_1.guard)(condition !== undefined && body !== undefined, () => `While-Loop ${name.content} has no condition or body, impossible!`);
     const originalDependency = data.controlDependencies;
     if ((0, info_1.alwaysExits)(condition)) {
         logger_1.dataflowLogger.warn(`While-Loop ${rootId} forces exit in condition, skipping rest`);
+        information.graph.addEdge(name.info.id, condition.entryPoint, edge_1.EdgeType.Reads);
         return condition;
     }
     const remainingInputs = (0, linker_1.linkInputs)([

package/dataflow/internal/process/functions/call/common.js

@@ -83,7 +83,7 @@ function processAllArguments({ functionName, args, data, finalGraph, functionRoo
                     // When only a single index is referenced, we don't need to reference the whole object
                     const resolvedInGraphDef = resolved;
                     const isContainer = checkForContainer(resolvedInGraphDef?.indicesCollection);
-                    if (isContainer || isContainer === undefined) {
+                    if (isContainer !== false) {
                         finalGraph.addEdge(ingoing.nodeId, resolved.nodeId, edge_1.EdgeType.Reads);
                     }
                 }

package/dataflow/internal/process/functions/call/known-call-handling.js

@@ -10,6 +10,7 @@ const edge_1 = require("../../../../graph/edge");
 const logger_1 = require("../../../../logger");
 const vertex_1 = require("../../../../graph/vertex");
 const log_1 = require("../../../../../util/log");
+const unknown_side_effect_1 = require("../../../../graph/unknown-side-effect");
 function markNonStandardEvaluationEdges(markAsNSE, callArgs, finalGraph, rootId) {
     for (const nse of markAsNSE) {
         if (nse < callArgs.length) {
@@ -46,7 +47,7 @@ function processKnownFunctionCall({ name, args, rootId, data, reverseOrder = fal
         origin: origin === 'default' ? ['function'] : [origin]
     });
     if (hasUnknownSideEffect) {
-        finalGraph.markIdForUnknownSideEffects(rootId);
+        (0, unknown_side_effect_1.handleUnknownSideEffect)(finalGraph, data.environment, rootId);
     }
     const inIds = remainingReadInArgs;
     const fnRef = { nodeId: rootId, name: functionCallName, controlDependencies: data.controlDependencies, type: identifier_1.ReferenceType.Function };

package/dataflow/internal/process/functions/process-parameter.js

@@ -20,7 +20,7 @@ function processFunctionParameter(parameter, data) {
     for (const writtenNode of writtenNodes) {
         log_1.log.trace(`parameter ${writtenNode.name} (${writtenNode.nodeId}) is defined at id ${writtenNode.definedAt} with ${defaultValue === undefined ? 'no default value' : ' no default value'}`);
         graph.setDefinitionOfVertex(writtenNode);
-        environment = (0, define_1.define)(writtenNode, false, environment);
+        environment = (0, define_1.define)(writtenNode, false, environment, data.flowrConfig);
         if (defaultValue !== undefined) {
             if (parameter.defaultValue?.type === type_1.RType.FunctionDefinition) {
                 graph.addEdge(writtenNode, parameter.defaultValue.info.id, edge_1.EdgeType.DefinedBy);

package/dataflow/origin/dfg-get-symbol-refs.d.ts

@@ -0,0 +1,21 @@
+import type { NodeId } from '../../r-bridge/lang-4.x/ast/model/processing/node-id';
+import type { DataflowGraph } from '../graph/graph';
+/**
+ * Finds the definition of a variable and all other uses from that point on
+ *
+ * For example, for the following code
+ * ```ts
+ *   y <- 5
+ *   f <- function() {
+ *     y <- 8
+ *     print(y)
+ *   }
+ * ```
+ *
+ * @example getAllRefsToSymbol('3\@y') returns ['3\@y', '4\@y']
+ *
+ * @param graph  - Dataflow Graph
+ * @param nodeId - NodeId of Symbol to resolve
+ * @returns List including the Definitions and Refereneces to that definition
+ */
+export declare function getAllRefsToSymbol(graph: DataflowGraph, nodeId: NodeId): NodeId[] | undefined;

package/dataflow/origin/dfg-get-symbol-refs.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAllRefsToSymbol = getAllRefsToSymbol;
+const edge_1 = require("../graph/edge");
+const info_1 = require("../info");
+const dfg_get_origin_1 = require("./dfg-get-origin");
+/**
+ * Finds the definition of a variable and all other uses from that point on
+ *
+ * For example, for the following code
+ * ```ts
+ *   y <- 5
+ *   f <- function() {
+ *     y <- 8
+ *     print(y)
+ *   }
+ * ```
+ *
+ * @example getAllRefsToSymbol('3\@y') returns ['3\@y', '4\@y']
+ *
+ * @param graph  - Dataflow Graph
+ * @param nodeId - NodeId of Symbol to resolve
+ * @returns List including the Definitions and Refereneces to that definition
+ */
+function getAllRefsToSymbol(graph, nodeId) {
+    // Get all origins and filter for ones that happen for sure
+    const origins = (0, dfg_get_origin_1.getOriginInDfg)(graph, nodeId);
+    if (origins === undefined) {
+        return undefined;
+    }
+    const definitiveOrigins = origins.filter(o => (0, info_1.happensInEveryBranch)(graph.getVertex(o.id)?.cds));
+    if (definitiveOrigins.length === 0) {
+        return undefined;
+    }
+    // Gather all the references 
+    const res = new Set();
+    for (const origin of definitiveOrigins) {
+        res.add(origin.id);
+        graph.ingoingEdges(origin.id)
+            ?.entries()
+            .filter(([_, edge]) => (0, edge_1.edgeIncludesType)(edge.types, edge_1.EdgeType.Reads))
+            .forEach(([node, _]) => res.add(node));
+        graph.outgoingEdges(origin.id)
+            ?.entries()
+            .filter(([_, edge]) => (0, edge_1.edgeIncludesType)(edge.types, edge_1.EdgeType.DefinedByOnCall))
+            .forEach(([node, _]) => res.add(node));
+    }
+    return [...res];
+}
+//# sourceMappingURL=dfg-get-symbol-refs.js.map

package/dataflow/processor.d.ts

@@ -7,6 +7,7 @@ import type { REnvironmentInformation } from './environments/environment';
 import type { RParseRequest } from '../r-bridge/retriever';
 import type { RNode } from '../r-bridge/lang-4.x/ast/model/model';
 import type { KnownParserType, Parser } from '../r-bridge/parser';
+import type { FlowrConfigOptions } from '../config';
 export interface DataflowProcessorInformation<OtherInfo> {
     readonly parser: Parser<KnownParserType>;
     /**
@@ -35,6 +36,10 @@ export interface DataflowProcessorInformation<OtherInfo> {
      * The chain of control-flow {@link NodeId}s that lead to the current node (e.g., of known ifs).
      */
     readonly controlDependencies: ControlDependency[] | undefined;
+    /**
+     * The flowr configuration used for environment seeding, and precision control
+     */
+    readonly flowrConfig: FlowrConfigOptions;
 }
 export type DataflowProcessor<OtherInfo, NodeType extends RNodeWithParent<OtherInfo>> = (node: NodeType, data: DataflowProcessorInformation<OtherInfo>) => DataflowInformation;
 type NodeWithKey<OtherInfo, Key> = RNode<OtherInfo & ParentInformation> & {

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

@@ -11,13 +11,14 @@ const doc_files_1 = require("./doc-files");
 const cfg_1 = require("../../util/mermaid/cfg");
 const doc_code_1 = require("./doc-code");
 const cfg_simplification_1 = require("../../control-flow/cfg-simplification");
+const config_1 = require("../../config");
 async function getCfg(parser, code, simplifications = [], useDfg = true) {
     const result = useDfg ? await (0, default_pipelines_1.createDataflowPipeline)(parser, {
         request: (0, retriever_1.requestFromInput)(code)
-    }).allRemainingSteps() : await (0, default_pipelines_1.createNormalizePipeline)(parser, {
+    }, config_1.defaultConfigOptions).allRemainingSteps() : await (0, default_pipelines_1.createNormalizePipeline)(parser, {
         request: (0, retriever_1.requestFromInput)(code)
-    }).allRemainingSteps();
-    const cfg = (0, extract_cfg_1.extractCfg)(result.normalize, useDfg ? result.dataflow.graph : undefined, [...cfg_simplification_1.DefaultCfgSimplificationOrder, ...simplifications]);
+    }, config_1.defaultConfigOptions).allRemainingSteps();
+    const cfg = (0, extract_cfg_1.extractCfg)(result.normalize, config_1.defaultConfigOptions, useDfg ? result.dataflow.graph : undefined, [...cfg_simplification_1.DefaultCfgSimplificationOrder, ...simplifications]);
     return {
         info: cfg,
         ast: result.normalize,

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

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

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

@@ -15,6 +15,7 @@ const assert_1 = require("../../util/assert");
 const time_1 = require("../../util/text/time");
 const doc_files_1 = require("./doc-files");
 const doc_code_1 = require("./doc-code");
+const config_1 = require("../../config");
 function printDfGraph(graph, mark, simplified = false) {
     return `
 ${(0, doc_code_1.codeBlock)('mermaid', (0, dfg_1.graphToMermaid)({
@@ -37,7 +38,7 @@ async function printDfGraphForCode(parser, code, { simplified = false, mark, sho
     const now = performance.now();
     const result = await (0, default_pipelines_1.createDataflowPipeline)(parser, {
         request: (0, retriever_1.requestFromInput)(code)
-    }).allRemainingSteps();
+    }, config_1.defaultConfigOptions).allRemainingSteps();
     const duration = performance.now() - now;
     if (switchCodeAndGraph) {
         (0, assert_1.guard)(showCode, 'can not switch code and graph if code is not shown');
@@ -76,7 +77,7 @@ async function verifyExpectedSubgraph(shell, code, expectedSubgraph) {
         parser: shell,
         request: (0, retriever_1.requestFromInput)(code),
         getId: (0, decorate_1.deterministicCountingIdGenerator)(0)
-    }).allRemainingSteps();
+    }, config_1.defaultConfigOptions).allRemainingSteps();
     expectedSubgraph.setIdMap(info.normalize.idMap);
     expectedSubgraph = (0, resolve_graph_1.resolveDataflowGraph)(expectedSubgraph);
     const report = (0, diff_dataflow_graph_1.diffOfDataflowGraphs)({ name: 'expected', graph: expectedSubgraph }, { name: 'got', graph: info.dataflow.graph }, {

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

@@ -0,0 +1,24 @@
+import type { Expression } from 'typescript';
+import ts from 'typescript';
+export interface FunctionElementInSource {
+    name: string;
+    node: ts.Node;
+    source: ts.SourceFile;
+    kind: 'function';
+    arguments: Expression[];
+    lineNumber: number;
+    comments?: string[];
+}
+export interface GetFunctionsOption {
+    readonly rootFolder?: string;
+    readonly files?: readonly string[];
+    readonly fname?: RegExp;
+}
+export interface FunctionsReport {
+    info: FunctionElementInSource[];
+    program: ts.Program;
+}
+/**
+ * Inspect typescript source code for types and return a report.
+ */
+export declare function getFunctionsFromFolder(options: GetFunctionsOption): FunctionsReport;

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

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFunctionsFromFolder = getFunctionsFromFolder;
+const typescript_1 = __importDefault(require("typescript"));
+const assert_1 = require("../../util/assert");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const doc_types_1 = require("./doc-types");
+function collectHierarchyInformation(sourceFiles, options, fname) {
+    const hierarchyList = [];
+    const visit = (node, sourceFile) => {
+        if (!node) {
+            return;
+        }
+        if (typescript_1.default.isCallExpression(node) || typescript_1.default.isNewExpression(node)) {
+            const name = node.expression.getText(sourceFile);
+            if (!fname || fname.test(name)) {
+                const comments = typescript_1.default.getLeadingCommentRanges(sourceFile.getText(sourceFile), node.getFullStart())?.map(c => {
+                    return (0, doc_types_1.removeCommentSymbolsFromTypeScriptComment)(sourceFile.getText(sourceFile).substring(c.pos, c.end).trim());
+                });
+                hierarchyList.push({
+                    name: (0, doc_types_1.dropGenericsFromTypeName)(name),
+                    node,
+                    kind: 'function',
+                    comments,
+                    lineNumber: (0, doc_types_1.getStartLineOfTypeScriptNode)(node, sourceFile),
+                    source: sourceFile,
+                    arguments: node.arguments?.map(n => n) ?? []
+                });
+            }
+        }
+        typescript_1.default.forEachChild(node, child => visit(child, sourceFile));
+    };
+    sourceFiles.forEach(sourceFile => {
+        visit(sourceFile, sourceFile);
+    });
+    return hierarchyList;
+}
+/**
+ * Inspect typescript source code for types and return a report.
+ */
+function getFunctionsFromFolder(options) {
+    (0, assert_1.guard)(options.rootFolder !== undefined || options.files !== undefined, 'Either rootFolder or files must be provided');
+    const fileNames = [...options.files ?? []];
+    if (options.rootFolder) {
+        for (const fileBuff of fs_1.default.readdirSync(options.rootFolder, { recursive: true })) {
+            const file = fileBuff.toString();
+            if (file.endsWith('.ts')) {
+                fileNames.push(path_1.default.join(options.rootFolder, file));
+            }
+        }
+    }
+    const { files, program } = (0, doc_types_1.getTypeScriptSourceFiles)(fileNames);
+    (0, assert_1.guard)(files.length > 0, () => `No source files found for ${JSON.stringify(fileNames)}`);
+    const withProgram = { ...options, program };
+    const hierarchyList = collectHierarchyInformation(files, withProgram, options.fname);
+    return {
+        info: hierarchyList,
+        program
+    };
+}
+//# sourceMappingURL=doc-functions.js.map

package/documentation/doc-util/doc-normalized-ast.js

@@ -12,6 +12,7 @@ const assert_1 = require("../../util/assert");
 const ast_1 = require("../../util/mermaid/ast");
 const time_1 = require("../../util/text/time");
 const doc_files_1 = require("./doc-files");
+const config_1 = require("../../config");
 function printNormalizedAst(ast, prefix = 'flowchart TD\n') {
     return `
 \`\`\`mermaid
@@ -23,7 +24,7 @@ async function printNormalizedAstForCode(parser, code, { showCode = true, prefix
     const now = performance.now();
     const result = await (0, default_pipelines_1.createNormalizePipeline)(parser, {
         request: (0, retriever_1.requestFromInput)(code)
-    }).allRemainingSteps();
+    }, config_1.defaultConfigOptions).allRemainingSteps();
     const duration = performance.now() - now;
     const metaInfo = `The analysis required _${(0, time_1.printAsMs)(duration)}_ (including parsing with the [${parser.name}](${doc_files_1.FlowrWikiBaseRef}/Engines) engine) within the generation environment.`;
     return '\n\n' + printNormalizedAst(result.normalize.ast, prefix) + (showCode ? `
@@ -57,7 +58,7 @@ async function verifyExpectedSubgraph(shell, code, expectedSubgraph) {
     const info = await (0, default_pipelines_1.createDataflowPipeline)(shell, {
         request: (0, retriever_1.requestFromInput)(code),
         getId: (0, decorate_1.deterministicCountingIdGenerator)(0)
-    }).allRemainingSteps();
+    }, config_1.defaultConfigOptions).allRemainingSteps();
     expectedSubgraph.setIdMap(info.normalize.idMap);
     expectedSubgraph = (0, resolve_graph_1.resolveDataflowGraph)(expectedSubgraph);
     const report = (0, diff_dataflow_graph_1.diffOfDataflowGraphs)({ name: 'expected', graph: expectedSubgraph }, { name: 'got', graph: info.dataflow.graph }, {

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

@@ -0,0 +1,5 @@
+/**
+ * Writes the wiki documentation to the specified output path.
+ * Returns true if the file was updated, false if it was unchanged.
+ */
+export declare function writeWikiTo(text: string, output_path: string, check_change?: boolean): boolean;

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

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeWikiTo = writeWikiTo;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/* eslint-disable */
+const IgnoreRegex = /[0-9]+(\.[0-9]+)? ?ms|"timing":\s*[0-9]+(\.0-9)?,?|tmp-[A-Za-z0-9-]+/g;
+/* eslint-enable */
+/**
+ * Checks whether the file contains a different content, but ignores timing and some other non-semantic changes.
+ */
+function didFileChange(filePath, content) {
+    if (!fs_1.default.existsSync(filePath)) {
+        return true; // If the file does not exist, it is considered changed.
+    }
+    const currentContent = fs_1.default.readFileSync(filePath, 'utf-8');
+    const cleanedCurrentContent = currentContent.replace(IgnoreRegex, '');
+    const cleanedNewContent = content.replace(IgnoreRegex, '');
+    return cleanedCurrentContent !== cleanedNewContent;
+}
+/**
+ * Writes the wiki documentation to the specified output path.
+ * Returns true if the file was updated, false if it was unchanged.
+ */
+function writeWikiTo(text, output_path, check_change = true) {
+    if (!check_change || didFileChange(output_path, text)) {
+        fs_1.default.mkdirSync(path_1.default.dirname(output_path), { recursive: true });
+        fs_1.default.writeFileSync(output_path, text, 'utf-8');
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=doc-print.js.map

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

@@ -1,13 +1,16 @@
 import type { RShell } from '../../r-bridge/shell';
-import type { Queries, SupportedQueryTypes } from '../../queries/query';
+import type { Queries, QueryResults, SupportedQueryTypes } from '../../queries/query';
+import { DEFAULT_DATAFLOW_PIPELINE } from '../../core/steps/pipeline/default-pipelines';
 import type { SupportedVirtualQueryTypes } from '../../queries/virtual-query/virtual-queries';
 import type { VirtualCompoundConstraint } from '../../queries/virtual-query/compound-query';
-export interface ShowQueryOptions {
+import type { PipelineOutput } from '../../core/steps/pipeline/pipeline';
+export interface ShowQueryOptions<Base extends SupportedQueryTypes> {
     readonly showCode?: boolean;
     readonly collapseResult?: boolean;
     readonly collapseQuery?: boolean;
+    readonly addOutput?: (result: QueryResults<Base>, pipeline: PipelineOutput<typeof DEFAULT_DATAFLOW_PIPELINE>) => string;
 }
-export declare function showQuery<Base extends SupportedQueryTypes, VirtualArguments extends VirtualCompoundConstraint<Base> = VirtualCompoundConstraint<Base>>(shell: RShell, code: string, queries: Queries<Base, VirtualArguments>, { showCode, collapseResult, collapseQuery }?: ShowQueryOptions): Promise<string>;
+export declare function showQuery<Base extends SupportedQueryTypes, VirtualArguments extends VirtualCompoundConstraint<Base> = VirtualCompoundConstraint<Base>>(shell: RShell, code: string, queries: Queries<Base, VirtualArguments>, { showCode, collapseResult, collapseQuery, addOutput }?: ShowQueryOptions<Base>): Promise<string>;
 export interface QueryDocumentation {
     readonly name: string;
     readonly type: 'virtual' | 'active';

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

@@ -17,13 +17,14 @@ const doc_dfg_1 = require("./doc-dfg");
 const doc_code_1 = require("./doc-code");
 const time_1 = require("../../util/text/time");
 const query_print_1 = require("../../queries/query-print");
-async function showQuery(shell, code, queries, { showCode, collapseResult, collapseQuery } = {}) {
+const config_1 = require("../../config");
+async function showQuery(shell, code, queries, { showCode, collapseResult, collapseQuery, addOutput = () => '' } = {}) {
     const now = performance.now();
     const analysis = await new pipeline_executor_1.PipelineExecutor(default_pipelines_1.DEFAULT_DATAFLOW_PIPELINE, {
         parser: shell,
         request: (0, retriever_1.requestFromInput)(code)
-    }).allRemainingSteps();
-    const results = (0, query_1.executeQueries)({ dataflow: analysis.dataflow, ast: analysis.normalize }, queries);
+    }, config_1.defaultConfigOptions).allRemainingSteps();
+    const results = (0, query_1.executeQueries)({ dataflow: analysis.dataflow, ast: analysis.normalize, config: config_1.defaultConfigOptions }, queries);
     const duration = performance.now() - now;
     const metaInfo = `
 The analysis required _${(0, time_1.printAsMs)(duration)}_ (including parsing and normalization and the query) within the generation environment.
@@ -60,6 +61,8 @@ ${await (0, doc_dfg_1.printDfGraphForCode)(shell, code, { switchCodeAndGraph: tr
 
 ${collapseResult ? '</details>' : ''}
 
+${addOutput(results, analysis)}
+
 	`;
 }
 exports.RegisteredQueries = {

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

@@ -11,6 +11,7 @@ const doc_docker_1 = require("./doc-docker");
 const prompt_1 = require("../../cli/repl/prompt");
 const doc_code_1 = require("./doc-code");
 const print_version_1 = require("../../cli/repl/print-version");
+const config_1 = require("../../config");
 function printHelpForScript(script, starredVersion) {
     let base = `| **${(0, doc_cli_option_1.getReplCommand)(script[0], false, starredVersion !== undefined)}** | ${script[1].description}`;
     if (starredVersion) {
@@ -51,7 +52,7 @@ async function documentReplSession(parser, commands, options) {
                 entry.lines.push(msg);
             }
         };
-        await (0, core_1.replProcessAnswer)(collectingOutput, command.command, parser, options?.allowRSessionAccess ?? false);
+        await (0, core_1.replProcessAnswer)(config_1.defaultConfigOptions, collectingOutput, command.command, parser, options?.allowRSessionAccess ?? false);
         collect.push(entry);
     }
     let result = '';

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

@@ -17,13 +17,14 @@ const flowr_search_executor_1 = require("../../search/flowr-search-executor");
 const flowr_search_printer_1 = require("../../search/flowr-search-printer");
 const node_id_1 = require("../../r-bridge/lang-4.x/ast/model/processing/node-id");
 const dfg_1 = require("../../util/mermaid/dfg");
+const config_1 = require("../../config");
 async function showSearch(shell, code, search, { collapseResult = true } = {}) {
     const now = performance.now();
     const analysis = await new pipeline_executor_1.PipelineExecutor(default_pipelines_1.DEFAULT_DATAFLOW_PIPELINE, {
         parser: shell,
         request: (0, retriever_1.requestFromInput)(code)
-    }).allRemainingSteps();
-    const result = (0, flowr_search_executor_1.runSearch)(search, analysis);
+    }, config_1.defaultConfigOptions).allRemainingSteps();
+    const result = (0, flowr_search_executor_1.runSearch)(search, { ...analysis, config: config_1.defaultConfigOptions });
     const duration = performance.now() - now;
     const metaInfo = `
 The search required _${(0, time_1.printAsMs)(duration)}_ (including parsing and normalization and the query) within the generation environment.

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

@@ -10,21 +10,42 @@ export interface TypeElementInSource {
     comments?: string[];
     readonly properties?: string[];
 }
+export declare function getTypeScriptSourceFiles(fileNames: readonly string[]): {
+    files: ts.SourceFile[];
+    program: ts.Program;
+};
+export declare function dropGenericsFromTypeName(type: string): string;
+export declare function removeCommentSymbolsFromTypeScriptComment(comment: string): string;
+export declare function getTextualCommentsFromTypeScript(node: ts.Node): string[];
+export declare function getStartLineOfTypeScriptNode(node: ts.Node, sourceFile: ts.SourceFile): number;
 export declare function getType(node: ts.Node, typeChecker: ts.TypeChecker): string;
 export declare function followTypeReference(type: ts.TypeReferenceNode, sourceFile: ts.SourceFile): string[];
-export declare function getTypePathLink({ filePath, lineNumber }: TypeElementInSource, prefix?: string): string;
+export declare function getTypePathForTypeScript({ filePath }: Pick<TypeElementInSource, 'filePath'>): string;
+export declare function getTypePathLink(elem: Pick<TypeElementInSource, 'filePath' | 'lineNumber'>, prefix?: string): string;
 export interface GetTypesAsMermaidOption {
     readonly rootFolder?: string;
     readonly files?: readonly string[];
-    readonly typeName: string;
+    /** if you request a type name, we will generate a mermaid diagram for that type */
+    readonly typeNameForMermaid?: string;
     readonly inlineTypes?: readonly string[];
 }
-export interface MermaidTypeReport {
-    text: string;
+export interface TypeReport {
+    /** if you request a type name this will include the mermaid diagram for the type */
+    mermaid: string | undefined;
     info: TypeElementInSource[];
     program: ts.Program;
 }
-export declare function getTypesFromFolderAsMermaid(options: GetTypesAsMermaidOption): MermaidTypeReport;
+export declare function getTypesFromFolder(options: GetTypesAsMermaidOption & {
+    typeNameForMermaid: string;
+}): (TypeReport & {
+    mermaid: string;
+});
+export declare function getTypesFromFolder(options: GetTypesAsMermaidOption & {
+    typeNameForMermaid?: undefined;
+}): (TypeReport & {
+    mermaid: undefined;
+});
+export declare function getTypesFromFolder(options: GetTypesAsMermaidOption): TypeReport;
 export declare function implSnippet(node: TypeElementInSource | undefined, program: ts.Program, showName?: boolean, nesting?: number, open?: boolean): string;
 export interface PrintHierarchyArguments {
     readonly program: ts.Program;
@@ -51,5 +72,6 @@ export declare function printCodeOfElement({ program, info }: FnInfo, name: stri
  * @param realNameWrapper - How to highlight the function in name in the `x::y` format?
  */
 export declare function shortLink(name: string, hierarchy: readonly TypeElementInSource[], codeStyle?: boolean, realNameWrapper?: string): string;
-export declare function getDocumentationForType(name: string, hierarchy: TypeElementInSource[], prefix?: string): string;
+export declare function shortLinkFile(name: string, hierarchy: readonly TypeElementInSource[]): string;
+export declare function getDocumentationForType(name: string, hierarchy: TypeElementInSource[], prefix?: string, fuzzy?: boolean): string;
 export {};