@eagleoutice/flowr 2.6.0 → 2.6.2

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

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.escapeHTML = escapeHTML;
 /**
  * Escapes HTML special characters in a string.
- *
  * @param str - The string to escape
  * @returns The escaped string
  */

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

@@ -1,3 +1,4 @@
+export declare const FlowrGithubGroupName = "flowr-analysis";
 export declare const FlowrGithubBaseRef = "https://github.com/flowr-analysis";
 export declare const FlowrSiteBaseRef = "https://flowr-analysis.github.io/flowr";
 export declare const RemoteFlowrFilePathBaseRef = "https://github.com/flowr-analysis/flowr/tree/main/";
@@ -7,6 +8,16 @@ export declare const FlowrDockerRef = "https://hub.docker.com/r/eagleoutice/flow
 export declare const FlowrCodecovRef = "https://app.codecov.io/gh/flowr-analysis/flowr";
 export declare const FlowrVsCode = "https://marketplace.visualstudio.com/items?itemName=code-inspect.vscode-flowr";
 export declare const FlowrPositron = "https://open-vsx.org/extension/code-inspect/vscode-flowr";
+/**
+ * Returns a markdown link to the given file path relative to the project root.
+ */
 export declare function getFilePathMd(path: string): string;
+/**
+ * Returns the content of a file located at the given path relative to the project root.
+ * This reads the file synchronously from disk.
+ */
 export declare function getFileContentFromRoot(path: string): string;
+/**
+ * Returns a markdown link to the given flowr source file path.
+ */
 export declare function linkFlowRSourceFile(path: string): string;

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

@@ -3,20 +3,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FlowrPositron = exports.FlowrVsCode = exports.FlowrCodecovRef = exports.FlowrDockerRef = exports.FlowrNpmRef = exports.FlowrWikiBaseRef = exports.RemoteFlowrFilePathBaseRef = exports.FlowrSiteBaseRef = exports.FlowrGithubBaseRef = void 0;
+exports.FlowrPositron = exports.FlowrVsCode = exports.FlowrCodecovRef = exports.FlowrDockerRef = exports.FlowrNpmRef = exports.FlowrWikiBaseRef = exports.RemoteFlowrFilePathBaseRef = exports.FlowrSiteBaseRef = exports.FlowrGithubBaseRef = exports.FlowrGithubGroupName = void 0;
 exports.getFilePathMd = getFilePathMd;
 exports.getFileContentFromRoot = getFileContentFromRoot;
 exports.linkFlowRSourceFile = linkFlowRSourceFile;
 const fs_1 = __importDefault(require("fs"));
-exports.FlowrGithubBaseRef = 'https://github.com/flowr-analysis';
-exports.FlowrSiteBaseRef = 'https://flowr-analysis.github.io/flowr';
+exports.FlowrGithubGroupName = 'flowr-analysis';
+exports.FlowrGithubBaseRef = `https://github.com/${exports.FlowrGithubGroupName}`;
+exports.FlowrSiteBaseRef = `https://${exports.FlowrGithubGroupName}.github.io/flowr`;
 exports.RemoteFlowrFilePathBaseRef = `${exports.FlowrGithubBaseRef}/flowr/tree/main/`;
 exports.FlowrWikiBaseRef = `${exports.FlowrGithubBaseRef}/flowr/wiki`;
 exports.FlowrNpmRef = 'https://www.npmjs.com/package/@eagleoutice/flowr';
 exports.FlowrDockerRef = 'https://hub.docker.com/r/eagleoutice/flowr';
-exports.FlowrCodecovRef = 'https://app.codecov.io/gh/flowr-analysis/flowr';
+exports.FlowrCodecovRef = `https://app.codecov.io/gh/${exports.FlowrGithubGroupName}/flowr`;
 exports.FlowrVsCode = 'https://marketplace.visualstudio.com/items?itemName=code-inspect.vscode-flowr';
 exports.FlowrPositron = 'https://open-vsx.org/extension/code-inspect/vscode-flowr';
+/**
+ * Returns a markdown link to the given file path relative to the project root.
+ */
 function getFilePathMd(path) {
     // we go one up as we are in doc-util now :D #convenience
     const fullpath = require.resolve('../' + path);
@@ -26,10 +30,17 @@ function getFilePathMd(path) {
     /* remove project prefix */
     return `[\`${relative}\`](${exports.RemoteFlowrFilePathBaseRef}${relative})`;
 }
+/**
+ * Returns the content of a file located at the given path relative to the project root.
+ * This reads the file synchronously from disk.
+ */
 function getFileContentFromRoot(path) {
     const fullpath = require.resolve('../../../' + path);
     return fs_1.default.readFileSync(fullpath, 'utf-8');
 }
+/**
+ * Returns a markdown link to the given flowr source file path.
+ */
 function linkFlowRSourceFile(path) {
     return `[${path}](${exports.RemoteFlowrFilePathBaseRef}/${path})`;
 }

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

@@ -1,2 +1,8 @@
+/**
+ *
+ */
 export declare function prefixLines(line: string, prefix: string): string;
+/**
+ *
+ */
 export declare function lastJoin(elements: readonly string[], join: string, lastjoin: string): string;

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

@@ -2,9 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.prefixLines = prefixLines;
 exports.lastJoin = lastJoin;
+/**
+ *
+ */
 function prefixLines(line, prefix) {
     return line.split('\n').map(l => `${prefix}${l}`).join('\n');
 }
+/**
+ *
+ */
 function lastJoin(elements, join, lastjoin) {
     if (elements.length <= 1) {
         return elements.join(lastjoin);

package/documentation/doc-util/doc-normalized-ast.d.ts

@@ -1,12 +1,18 @@
 import type { DataflowGraph } from '../../dataflow/graph/graph';
 import type { RShell } from '../../r-bridge/shell';
-import type { RNodeWithParent } from '../../r-bridge/lang-4.x/ast/model/processing/decorate';
+import { type RNodeWithParent } from '../../r-bridge/lang-4.x/ast/model/processing/decorate';
 import type { KnownParser } from '../../r-bridge/parser';
+/**
+ *
+ */
 export declare function printNormalizedAst(ast: RNodeWithParent, prefix?: string): string;
 export interface PrintNormalizedAstOptions {
     readonly showCode?: boolean;
     readonly prefix?: string;
 }
+/**
+ *
+ */
 export declare function printNormalizedAstForCode(parser: KnownParser, code: string, { showCode, prefix }?: PrintNormalizedAstOptions): Promise<string>;
 /** returns resolved expected df graph */
 export declare function verifyExpectedSubgraph(shell: RShell, code: string, expectedSubgraph: DataflowGraph): Promise<DataflowGraph>;

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

@@ -13,6 +13,9 @@ 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
@@ -20,6 +23,9 @@ ${(0, ast_1.normalizedAstToMermaid)(ast, prefix)}
 \`\`\`
 	`;
 }
+/**
+ *
+ */
 async function printNormalizedAstForCode(parser, code, { showCode = true, prefix = 'flowchart TD\n' } = {}) {
     const now = performance.now();
     const result = await (0, default_pipelines_1.createNormalizePipeline)(parser, {

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

@@ -7,6 +7,9 @@ export interface ShowQueryOptions {
     readonly collapseResult?: boolean;
     readonly collapseQuery?: boolean;
 }
+/**
+ * Visualizes a query and its results in markdown format.
+ */
 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 interface QueryDocumentation {
     readonly name: string;
@@ -20,7 +23,19 @@ export declare const RegisteredQueries: {
     active: Map<string, QueryDocumentation>;
     virtual: Map<string, QueryDocumentation>;
 };
+/**
+ *
+ */
 export declare function registerQueryDocumentation(query: SupportedQueryTypes | SupportedVirtualQueryTypes, doc: QueryDocumentation): void;
+/**
+ *
+ */
 export declare function linkToQueryOfName(id: SupportedQueryTypes | SupportedVirtualQueryTypes): string;
+/**
+ *
+ */
 export declare function tocForQueryType(type: 'active' | 'virtual'): string;
+/**
+ *
+ */
 export declare function explainQueries(shell: RShell, type: 'active' | 'virtual'): Promise<string>;

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

@@ -16,6 +16,9 @@ const time_1 = require("../../util/text/time");
 const query_print_1 = require("../../queries/query-print");
 const flowr_analyzer_builder_1 = require("../../project/flowr-analyzer-builder");
 const doc_cli_option_1 = require("./doc-cli-option");
+/**
+ * Visualizes a query and its results in markdown format.
+ */
 async function showQuery(shell, code, queries, { showCode, collapseResult, collapseQuery } = {}) {
     const now = performance.now();
     const analyzer = await new flowr_analyzer_builder_1.FlowrAnalyzerBuilder((0, retriever_1.requestFromInput)(code)).setParser(shell).build();
@@ -46,7 +49,7 @@ ${await (0, query_print_1.asciiSummaryOfQueryResult)(ansi_1.markdownFormatter, d
 
 <details> <summary style="color:gray">Show Detailed Results as Json</summary>
 
-${metaInfo}	
+${metaInfo}
 
 In general, the JSON contains the Ids of the nodes in question as they are present in the normalized AST or the dataflow graph of flowR.
 Please consult the [Interface](${doc_files_1.FlowrWikiBaseRef}/Interface) wiki page for more information on how to get those.
@@ -71,6 +74,9 @@ exports.RegisteredQueries = {
     'active': new Map(),
     'virtual': new Map()
 };
+/**
+ *
+ */
 function registerQueryDocumentation(query, doc) {
     const map = exports.RegisteredQueries[doc.type];
     if (map.has(query)) {
@@ -81,6 +87,9 @@ function registerQueryDocumentation(query, doc) {
 function linkify(name) {
     return name.toLowerCase().replace(/ /g, '-');
 }
+/**
+ *
+ */
 function linkToQueryOfName(id) {
     const query = exports.RegisteredQueries.active.get(id) ?? exports.RegisteredQueries.virtual.get(id);
     if (!query) {
@@ -88,6 +97,9 @@ function linkToQueryOfName(id) {
     }
     return `[${query.name}](#${linkify(query.name)})`;
 }
+/**
+ *
+ */
 function tocForQueryType(type) {
     const queries = [...exports.RegisteredQueries[type].entries()].sort(([, { name: a }], [, { name: b }]) => a.localeCompare(b));
     const result = [];
@@ -108,10 +120,13 @@ ${await buildExplanation(shell)}
 
 Responsible for the execution of the ${name} query is \`${functionName}\` in ${(0, doc_files_1.getFilePathMd)(functionFile)}.
 
-</details>	
+</details>
 
 `;
 }
+/**
+ *
+ */
 async function explainQueries(shell, type) {
     const queries = [...exports.RegisteredQueries[type].entries()].sort(([, { name: a }], [, { name: b }]) => a.localeCompare(b));
     const result = [];

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

@@ -1,4 +1,7 @@
 import type { KnownParser } from '../../r-bridge/parser';
+/**
+ *
+ */
 export declare function printReplHelpAsMarkdownTable(): string;
 export interface DocumentReplSessionOptions {
     /** defaults to false and shows starting the repl */
@@ -14,4 +17,7 @@ export interface DocumentReplCommand {
     command: string;
     description: string;
 }
+/**
+ *
+ */
 export declare function documentReplSession(parser: KnownParser, commands: readonly DocumentReplCommand[], options?: DocumentReplSessionOptions): Promise<string>;

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

@@ -11,7 +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");
+const flowr_analyzer_builder_1 = require("../../project/flowr-analyzer-builder");
 function printHelpForScript(script, starredVersion) {
     let base = `| **${(0, doc_cli_option_1.getReplCommand)(script[0], false, starredVersion !== undefined)}** | ${script[1].description}`;
     if (starredVersion) {
@@ -23,6 +23,9 @@ function printHelpForScript(script, starredVersion) {
     const aliases = script[1].aliases;
     return `${base} (alias${aliases.length > 1 ? 'es' : ''}: ${aliases.map(a => '**:' + (0, html_hover_over_1.textWithTooltip)(a, `Alias of ':${script[0]}'. ${script[1].description}`) + '**').join(', ')}) |`;
 }
+/**
+ *
+ */
 function printReplHelpAsMarkdownTable() {
     const scriptHelp = [];
     const cmds = (0, repl_commands_1.getReplCommands)();
@@ -39,6 +42,9 @@ function printReplHelpAsMarkdownTable() {
 ${scriptHelp.sort().join('\n')}
 `;
 }
+/**
+ *
+ */
 async function documentReplSession(parser, commands, options) {
     const collect = [];
     for (const command of commands) {
@@ -52,7 +58,10 @@ async function documentReplSession(parser, commands, options) {
                 entry.lines.push(msg);
             }
         };
-        await (0, core_1.replProcessAnswer)(config_1.defaultConfigOptions, collectingOutput, command.command, parser, options?.allowRSessionAccess ?? false);
+        const analyzer = await new flowr_analyzer_builder_1.FlowrAnalyzerBuilder()
+            .setParser(parser)
+            .build();
+        await (0, core_1.replProcessAnswer)(analyzer, collectingOutput, command.command, options?.allowRSessionAccess ?? false);
         collect.push(entry);
     }
     let result = '';

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

@@ -6,6 +6,9 @@ export interface ShowSearchOptions {
     readonly showCode?: boolean;
     readonly collapseResult?: boolean;
 }
+/**
+ * Visualizes a search and its results in markdown format.
+ */
 export declare function showSearch(shell: RShell, code: string, search: FlowrSearchLike, { collapseResult }?: ShowSearchOptions): Promise<string>;
 export interface QueryDocumentation {
     readonly name: string;
@@ -19,7 +22,19 @@ export declare const RegisteredQueries: {
     active: Map<string, QueryDocumentation>;
     virtual: Map<string, QueryDocumentation>;
 };
+/**
+ *
+ */
 export declare function registerQueryDocumentation(query: SupportedQueryTypes | SupportedVirtualQueryTypes, doc: QueryDocumentation): void;
+/**
+ *
+ */
 export declare function linkToQueryOfName(id: SupportedQueryTypes | SupportedVirtualQueryTypes): string;
+/**
+ *
+ */
 export declare function tocForQueryType(type: 'active' | 'virtual'): string;
+/**
+ *
+ */
 export declare function explainQueries(shell: RShell, type: 'active' | 'virtual'): Promise<string>;

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

@@ -15,6 +15,9 @@ 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 flowr_analyzer_builder_1 = require("../../project/flowr-analyzer-builder");
+/**
+ * Visualizes a search and its results in markdown format.
+ */
 async function showSearch(shell, code, search, { collapseResult = true } = {}) {
     const now = performance.now();
     const analyzer = await new flowr_analyzer_builder_1.FlowrAnalyzerBuilder((0, retriever_1.requestFromInput)(code))
@@ -52,7 +55,7 @@ ${collapseResult ? ' <details> <summary style="color:gray">Show Results</summary
 The query returns the following vetices (all references to \`x\` in the code):
 ${result.getElements().map(({ node }) => `<b>${node.info.id} ('${(0, node_id_1.recoverContent)(node.info.id, dataflow.graph)}')</b> at L${(0, dfg_1.formatRange)(node.location)}`).join(', ')}
 
-${metaInfo}	
+${metaInfo}
 
 The returned results are highlighted thick and blue within the dataflow graph:
 
@@ -67,6 +70,9 @@ exports.RegisteredQueries = {
     'active': new Map(),
     'virtual': new Map()
 };
+/**
+ *
+ */
 function registerQueryDocumentation(query, doc) {
     const map = exports.RegisteredQueries[doc.type];
     if (map.has(query)) {
@@ -77,6 +83,9 @@ function registerQueryDocumentation(query, doc) {
 function linkify(name) {
     return name.toLowerCase().replace(/ /g, '-');
 }
+/**
+ *
+ */
 function linkToQueryOfName(id) {
     const query = exports.RegisteredQueries.active.get(id) ?? exports.RegisteredQueries.virtual.get(id);
     if (!query) {
@@ -84,6 +93,9 @@ function linkToQueryOfName(id) {
     }
     return `[${query.name}](#${linkify(query.name)})`;
 }
+/**
+ *
+ */
 function tocForQueryType(type) {
     const queries = [...exports.RegisteredQueries[type].entries()].sort(([, { name: a }], [, { name: b }]) => a.localeCompare(b));
     const result = [];
@@ -104,10 +116,13 @@ ${await buildExplanation(shell)}
 
 Responsible for the execution of the ${name} query is \`${functionName}\` in ${(0, doc_files_1.getFilePathMd)(functionFile)}.
 
-</details>	
+</details>
 
 `;
 }
+/**
+ *
+ */
 async function explainQueries(shell, type) {
     const queries = [...exports.RegisteredQueries[type].entries()].sort(([, { name: a }], [, { name: b }]) => a.localeCompare(b));
     const result = [];

package/documentation/doc-util/doc-server-message.d.ts

@@ -1,6 +1,6 @@
 import type { RShell } from '../../r-bridge/shell';
 import type { FlowrMessage, IdMessageBase, MessageDefinition } from '../../cli/repl/server/messages/all-messages';
-import type { FakeServer, FakeSocket } from '../../../test/functionality/_helper/net';
+import { type FakeServer, type FakeSocket } from '../../../test/functionality/_helper/net';
 export interface ServerMessageDescription {
     readonly title: string;
     readonly type: 'request' | 'response';
@@ -12,8 +12,17 @@ export interface ServerMessageDescription {
     readonly additionalDefs?: MessageDefinition<IdMessageBase>[];
     readonly text: (shell: RShell) => Promise<string>;
 }
+/**
+ * Documents a server message for later printing.
+ */
 export declare function documentServerMessage(description: ServerMessageDescription): void;
+/**
+ * Visualizes all documented server messages in markdown format.
+ */
 export declare function printServerMessages(shell: RShell): Promise<string>;
+/**
+ * Executes the given function within a server context.
+ */
 export declare function inServerContext<T>(shell: RShell, fn: (socket: FakeSocket, server: FakeServer) => Promise<T> | T): Promise<T>;
 interface ResponseMessageInPingPong {
     readonly type: 'response';
@@ -33,5 +42,8 @@ export interface MessagePingPongDocumentationArguments {
     readonly messageType?: FlowrMessage['type'];
     readonly messages: readonly (ResponseMessageInPingPong | RequestMessageInPingPong)[];
 }
+/**
+ * Documents a ping-pong message exchange with the server.
+ */
 export declare function documentServerMessageResponse({ shell, title, messageType, messages }: MessagePingPongDocumentationArguments): Promise<string>;
 export {};

package/documentation/doc-util/doc-server-message.js

@@ -12,9 +12,15 @@ const doc_code_1 = require("./doc-code");
 const assert_1 = require("../../util/assert");
 const time_1 = require("../../util/text/time");
 const messages = [];
+/**
+ * Documents a server message for later printing.
+ */
 function documentServerMessage(description) {
     messages.push(description);
 }
+/**
+ * Visualizes all documented server messages in markdown format.
+ */
 async function printServerMessages(shell) {
     let text = '<ul>';
     for (const message of messages) {
@@ -22,6 +28,9 @@ async function printServerMessages(shell) {
     }
     return text + '</ul>';
 }
+/**
+ * Executes the given function within a server context.
+ */
 async function inServerContext(shell, fn) {
     return (0, net_1.withSocket)(shell, async (socket, server) => {
         return fn(socket, server);
@@ -69,6 +78,9 @@ function explainPingPong(description, received) {
     }
     return result + '</ol>';
 }
+/**
+ * Documents a ping-pong message exchange with the server.
+ */
 async function documentServerMessageResponse({ shell, title, messageType, messages }) {
     const start = performance.now();
     const response = await inServerContext(shell, async (socket) => {
@@ -145,7 +157,7 @@ ${additionalDefs?.map(def => getSchema(definitionPath, def)).join('\n') ?? ''}
 
 <hr>
 
-</details>	
+</details>
 	`;
 }
 //# sourceMappingURL=doc-server-message.js.map

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

@@ -4,12 +4,21 @@ export interface DetailsOptions {
     readonly hideIfEmpty?: boolean;
     readonly prefixInit?: string;
 }
+/**
+ *
+ */
 export declare function details(title: string, content: string, { color, open, hideIfEmpty, prefixInit }?: DetailsOptions): string;
 export interface BlockOptions {
     readonly type: 'NOTE' | 'WARNING' | 'TIP' | 'IMPORTANT';
     readonly content: string;
 }
+/**
+ *
+ */
 export declare function block({ type, content }: BlockOptions): string;
+/**
+ *
+ */
 export declare function section(title: string, depth?: 1 | 2 | 3 | 4 | 5 | 6, anchor?: string): string;
 /**
  * Supported pattern: `Name@link`

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

@@ -7,21 +7,30 @@ exports.collapsibleToc = collapsibleToc;
 const doc_general_1 = require("./doc-general");
 const mermaid_1 = require("../../util/mermaid/mermaid");
 const strings_1 = require("../../util/text/strings");
+/**
+ *
+ */
 function details(title, content, { color, open = false, hideIfEmpty = true, prefixInit = '' } = {}) {
     return hideIfEmpty && content.trim().length === 0 ? '' : `
-${prefixInit}<details${open ? ' open' : ''}><summary style="${color ? 'color:' + color : ''}">${title}</summary>
+${prefixInit}<details${open ? ' open' : ''}><summary${color ? ' style="color:' + color + '"' : ''}>${title}</summary>
 
 ${content}
 
 </details>
     `;
 }
+/**
+ *
+ */
 function block({ type, content }) {
     return `
 > [!${type}]
 ${(0, doc_general_1.prefixLines)(content, '> ')}
 `;
 }
+/**
+ *
+ */
 function section(title, depth = 2, anchor = (0, mermaid_1.escapeId)(title)) {
     return `<h${depth} id="${anchor}">${title}</h${depth}>`;
 }

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

@@ -11,17 +11,44 @@ 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 getTypePathForTypeScript({ filePath }: Pick<TypeElementInSource, 'filePath'>): string;
+/**
+ *
+ */
 export declare function getTypePathLink(elem: Pick<TypeElementInSource, 'filePath' | 'lineNumber'>, prefix?: string): string;
 export interface GetTypesAsMermaidOption {
     readonly rootFolder?: string;
@@ -47,6 +74,9 @@ export declare function getTypesFromFolder(options: GetTypesAsMermaidOption & {
     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;
@@ -58,6 +88,9 @@ export interface PrintHierarchyArguments {
     readonly openTop?: boolean;
 }
 export declare const mermaidHide: string[];
+/**
+ *
+ */
 export declare function printHierarchy({ program, info, root, collapseFromNesting, initialNesting, maxDepth, openTop }: PrintHierarchyArguments): string;
 interface FnInfo {
     info: TypeElementInSource[];
@@ -67,6 +100,9 @@ interface FnInfo {
     doNotAutoGobble?: boolean;
     hideDefinedAt?: boolean;
 }
+/**
+ *
+ */
 export declare function printCodeOfElement({ program, info, dropLinesEnd, dropLinesStart, doNotAutoGobble, hideDefinedAt }: FnInfo, name: string): string;
 /**
  * Create a short link to a type in the documentation
@@ -77,10 +113,16 @@ export declare function printCodeOfElement({ program, info, dropLinesEnd, dropLi
  * @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 shortLinkFile(name: string, hierarchy: readonly TypeElementInSource[]): string;
 export interface GetDocumentationForTypeFilters {
     fuzzy?: boolean;
     type?: TypeElementKind;
 }
+/**
+ *
+ */
 export declare function getDocumentationForType(name: string, hierarchy: TypeElementInSource[], prefix?: string, filter?: GetDocumentationForTypeFilters): string;
 export {};