@eagleoutice/flowr 2.6.1 → 2.6.3

package/statistics/features/supported/defined-functions/defined-functions.js

@@ -45,7 +45,7 @@ function retrieveAllCallsites(input, node, recursiveCalls) {
 function visitDefinitions(info, input) {
     const definitionStack = [];
     const allDefinitions = [];
-    (0, visitor_1.visitAst)(input.normalizedRAst.ast, node => {
+    (0, visitor_1.visitAst)(input.normalizedRAst.ast.files.map(f => f.root), node => {
         if (node.type !== type_1.RType.FunctionDefinition) {
             return;
         }

package/statistics/features/supported/expression-list/post-process.d.ts

@@ -1,3 +1,6 @@
 import type { FeatureStatisticsWithMeta } from '../../feature';
 import type { StatisticsSummarizerConfiguration } from '../../../summarizer/summarizer';
+/**
+ *
+ */
 export declare function postProcess(featureRoot: string, info: Map<string, FeatureStatisticsWithMeta>, outputPath: string, config: StatisticsSummarizerConfiguration): void;

package/statistics/features/supported/expression-list/post-process.js

@@ -8,6 +8,9 @@ const post_processing_1 = require("../../post-processing");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const summarizer_1 = require("../../../../util/summarizer");
+/**
+ *
+ */
 function postProcess(featureRoot, info, outputPath, config) {
     const collected = {};
     const deepestNestingOut = fs_1.default.createWriteStream(path_1.default.join(outputPath, 'deepest-nesting-per-file.csv'));

package/statistics/features/supported/expression-list/statistics-expression-list.js

@@ -11,7 +11,7 @@ const initialExpressionListInfo = {
 function visitLists(info, input) {
     let nest = -1; // we start with nesting 0
     let total = 0;
-    (0, visitor_1.visitAst)(input.normalizedRAst.ast, node => {
+    (0, visitor_1.visitAst)(input.normalizedRAst.ast.files.map(f => f.root), node => {
         if (node.type === type_1.RType.ExpressionList) {
             nest++;
             total++;

package/statistics/features/supported/loops/loops.js

@@ -25,7 +25,7 @@ const isImplicitLoop = /[lsvmt]?apply/;
 function visitLoops(info, input) {
     // holds number of loops and their nesting depths
     const loopStack = [];
-    (0, visitor_1.visitAst)(input.normalizedRAst.ast, node => {
+    (0, visitor_1.visitAst)(input.normalizedRAst.ast.files.map(f => f.root), node => {
         switch (node.type) {
             case type_1.RType.Next:
                 info.nextStatements++;

package/statistics/features/supported/loops/post-process.d.ts

@@ -1,3 +1,6 @@
 import type { FeatureStatisticsWithMeta } from '../../feature';
 import type { StatisticsSummarizerConfiguration } from '../../../summarizer/summarizer';
+/**
+ *
+ */
 export declare function postProcess(featureRoot: string, info: Map<string, FeatureStatisticsWithMeta>, outputPath: string, config: StatisticsSummarizerConfiguration): void;

package/statistics/features/supported/loops/post-process.js

@@ -10,6 +10,9 @@ const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const numbers_1 = require("../../../../util/numbers");
 const summarizer_1 = require("../../../../util/summarizer");
+/**
+ *
+ */
 function postProcess(featureRoot, info, outputPath, config) {
     const collected = {
         forLoops: (0, common_syntax_probability_1.emptyCommonSyntaxTypeCounts)(() => []),

package/statistics/features/supported/used-functions/used-functions.d.ts

@@ -1,6 +1,6 @@
 import type { Feature } from '../../feature';
 import type { Writable } from 'ts-essentials';
-import type { CommonSyntaxTypeCounts } from '../../common-syntax-probability';
+import { type CommonSyntaxTypeCounts } from '../../common-syntax-probability';
 declare const initialFunctionUsageInfo: {
     allFunctionCalls: number;
     args: Record<number, bigint | CommonSyntaxTypeCounts>;

package/statistics/features/supported/used-functions/used-functions.js

@@ -50,7 +50,7 @@ function classifyArguments(args, existing) {
 function visitCalls(info, input) {
     const calls = [];
     const allCalls = [];
-    (0, visitor_1.visitAst)(input.normalizedRAst.ast, node => {
+    (0, visitor_1.visitAst)(input.normalizedRAst.ast.files.map(f => f.root), node => {
         if (node.type !== type_1.RType.FunctionCall) {
             return;
         }

package/statistics/features/supported/used-packages/post-process.d.ts

@@ -1,3 +1,6 @@
 import type { FeatureStatisticsWithMeta } from '../../feature';
 import type { StatisticsSummarizerConfiguration } from '../../../summarizer/summarizer';
+/**
+ *
+ */
 export declare function postProcess(featureRoot: string, info: Map<string, FeatureStatisticsWithMeta>, outputPath: string, config: StatisticsSummarizerConfiguration): void;

package/statistics/features/supported/used-packages/post-process.js

@@ -12,6 +12,9 @@ const summarizer_1 = require("../../../../util/summarizer");
 const files_1 = require("../../../../util/files");
 const strings_1 = require("../../../../util/text/strings");
 const arrays_1 = require("../../../../util/collections/arrays");
+/**
+ *
+ */
 function postProcess(featureRoot, info, outputPath, config) {
     const collected = {};
     for (const [filepath, data] of info.entries()) {

package/statistics/features/supported/values/post-process.d.ts

@@ -1,3 +1,6 @@
 import type { FeatureStatisticsWithMeta } from '../../feature';
 import type { StatisticsSummarizerConfiguration } from '../../../summarizer/summarizer';
+/**
+ *
+ */
 export declare function postProcess(featureRoot: string, info: Map<string, FeatureStatisticsWithMeta>, outputPath: string, config: StatisticsSummarizerConfiguration): void;

package/statistics/features/supported/values/post-process.js

@@ -11,6 +11,9 @@ const summarizer_1 = require("../../../../util/summarizer");
 const time_1 = require("../../../../util/text/time");
 const files_1 = require("../../../../util/files");
 const arrays_1 = require("../../../../util/collections/arrays");
+/**
+ *
+ */
 function postProcess(featureRoot, info, outputPath, config) {
     const collected = {};
     for (const [filepath, data] of info.entries()) {

package/statistics/features/supported/variables/post-process.d.ts

@@ -1,9 +1,15 @@
 import type { FeatureStatisticsWithMeta } from '../../feature';
-import type { SummarizedWithProject } from '../../post-processing';
+import { type SummarizedWithProject } from '../../post-processing';
 import type { StatisticsSummarizerConfiguration } from '../../../summarizer/summarizer';
+/**
+ *
+ */
 export declare function postProcess(featureRoot: string, info: Map<string, FeatureStatisticsWithMeta>, outputPath: string, config: StatisticsSummarizerConfiguration): void;
 type VariableInfoMap = Map<string, SummarizedWithProject & {
     linePercentageInFile: number[][];
 }>;
+/**
+ *
+ */
 export declare function writeVariableInfoToCsv(outputPath: string, filename: `${string}.csv`, data: VariableInfoMap): void;
 export {};

package/statistics/features/supported/variables/post-process.js

@@ -58,6 +58,9 @@ function collectInformation(info, config) {
     }
     return collected;
 }
+/**
+ *
+ */
 function postProcess(featureRoot, info, outputPath, config) {
     const collected = collectInformation(info, config);
     writeVariableCountsToCsv(outputPath, collected);
@@ -65,6 +68,9 @@ function postProcess(featureRoot, info, outputPath, config) {
     collectDefinedVariables(featureRoot, info, config, outputPath);
     collectRedefinedVariables(featureRoot, info, config, outputPath);
 }
+/**
+ *
+ */
 function writeVariableInfoToCsv(outputPath, filename, data) {
     const out = fs_1.default.createWriteStream(path_1.default.join(outputPath, filename));
     out.write(`variable,unique-projects,unique-files,${(0, summarizer_1.summarizedMeasurement2CsvHeader)('count')},${(0, summarizer_1.summarizedMeasurement2CsvHeader)('line-frac')}\n`);

package/statistics/features/supported/variables/variables.js

@@ -15,7 +15,7 @@ const initialVariableInfo = {
     unknownVariables: 0
 };
 function visitVariables(info, input) {
-    (0, visitor_1.visitAst)(input.normalizedRAst.ast, node => {
+    (0, visitor_1.visitAst)(input.normalizedRAst.ast.files.map(f => f.root), node => {
         if (node.type !== type_1.RType.Symbol || (0, r_symbol_1.isSpecialSymbol)(node)) {
             return;
         }

package/statistics/meta-statistics.d.ts

@@ -1,26 +1,25 @@
 import type { RParseRequestFromFile, RParseRequestFromText } from '../r-bridge/retriever';
 /**
  * Statistics on skipped files, the time required, and more.
- *
  * @see extractUsageStatistics
  * @see initialMetaStatistics
  */
 export interface MetaStatistics {
     /**
-   * The number of requests that were parsed successfully
-   */
+     * The number of requests that were parsed successfully
+     */
     successfulParsed: number;
     /**
-   * The processing time for each request
-   */
+     * The processing time for each request
+     */
     processingTimeMs: number[];
     /**
-   * All failed requests (e.g., if they can not be converted to XML)
-   */
+     * All failed requests (e.g., if they can not be converted to XML)
+     */
     failedRequests: (RParseRequestFromText | RParseRequestFromFile)[];
     /**
-   * Number of lines with each individual line length consumed for each request
-   */
+     * Number of lines with each individual line length consumed for each request
+     */
     lines: number[][];
     /**
      * The number of nodes in the normalized AST

package/statistics/output/file-provider.d.ts

@@ -7,7 +7,6 @@ export declare class DummyAppendProvider implements StatisticAppendProvider {
     private readonly map;
     /**
      * If you pass a map the dummy will log all append calls to the map, using the feature name and the appendage type as keys
-     *
      * @param map - The map to log to
      */
     constructor(map?: DummyAppendMemoryMap | undefined);
@@ -25,13 +24,13 @@ export declare class StatisticFileProvider implements StatisticAppendProvider {
     private readonly connections;
     constructor(statisticsDirectory: string | undefined);
     /**
-   * @param name - the name of the feature {@link Feature#name}
-   * @param fn - the name of the feature-aspect to record
-   */
+     * @param name - the name of the feature {@link Feature#name}
+     * @param fn - the name of the feature-aspect to record
+     */
     private statisticsFile;
     /**
-   * Append the given content to the information for a feature of the given name and function.
-   */
+     * Append the given content to the information for a feature of the given name and function.
+     */
     append(name: string, fn: AppendFnType, content: string): void;
     private getHandle;
 }

package/statistics/output/file-provider.js

@@ -12,7 +12,6 @@ class DummyAppendProvider {
     map;
     /**
      * If you pass a map the dummy will log all append calls to the map, using the feature name and the appendage type as keys
-     *
      * @param map - The map to log to
      */
     constructor(map = undefined) {
@@ -63,15 +62,15 @@ class StatisticFileProvider {
         });
     }
     /**
-   * @param name - the name of the feature {@link Feature#name}
-   * @param fn - the name of the feature-aspect to record
-   */
+     * @param name - the name of the feature {@link Feature#name}
+     * @param fn - the name of the feature-aspect to record
+     */
     statisticsFile(name, fn) {
         return path_1.default.join(this.statisticsDirectory, name, `${fn}${exports.defaultStatisticsFileSuffix}`);
     }
     /**
-   * Append the given content to the information for a feature of the given name and function.
-   */
+     * Append the given content to the information for a feature of the given name and function.
+     */
     append(name, fn, content) {
         const descriptor = this.getHandle(name, String(fn));
         fs_1.default.appendFileSync(descriptor, content + '\n', 'utf8');

package/statistics/output/print-stats.d.ts

@@ -1,5 +1,5 @@
 import type { MetaStatistics } from '../meta-statistics';
-import type { FeatureKey, FeatureStatistics } from '../features/feature';
+import { type FeatureKey, type FeatureStatistics } from '../features/feature';
 interface MinMaxAvgMedian {
     sum: number;
     min: number;
@@ -7,11 +7,23 @@ interface MinMaxAvgMedian {
     avg: number;
     median: number;
 }
+/**
+ * Calculates the min, max, average and median of the given data set.
+ */
 export declare function minMaxAvgAndMedian(data: number[]): MinMaxAvgMedian;
+/**
+ * Formats the given statistics as a string.
+ */
 export declare function statsString(data: MinMaxAvgMedian, suffix?: string): string;
+/**
+ * Prints the given feature statistics to the console.
+ */
 export declare function printFeatureStatistics(statistics: {
     features: FeatureStatistics;
     meta: MetaStatistics;
 }, features?: 'all' | Set<FeatureKey>): void;
+/**
+ * Prints a single feature statistics entry to the console.
+ */
 export declare function printFeatureStatisticsEntry(info: Record<string, unknown>): void;
 export {};

package/statistics/output/print-stats.js

@@ -8,6 +8,9 @@ const ansi_1 = require("../../util/text/ansi");
 const json_1 = require("../../util/json");
 const feature_1 = require("../features/feature");
 const arrays_1 = require("../../util/collections/arrays");
+/**
+ * Calculates the min, max, average and median of the given data set.
+ */
 function minMaxAvgAndMedian(data) {
     data = data.sort((a, b) => a - b);
     const sum = (0, arrays_1.arraySum)(data);
@@ -22,9 +25,15 @@ function minMaxAvgAndMedian(data) {
 function formatStatNumber(num) {
     return num === undefined ? '<?>' : Number(num.toFixed(3)).toLocaleString();
 }
+/**
+ * Formats the given statistics as a string.
+ */
 function statsString(data, suffix = '') {
     return `[${formatStatNumber(data.min)}${suffix} .. ${formatStatNumber(data.max)}${suffix}] (avg: ${formatStatNumber(data.avg)}${suffix}, median: ${formatStatNumber(data.median)}${suffix})`;
 }
+/**
+ * Prints the given feature statistics to the console.
+ */
 function printFeatureStatistics(statistics, features = 'all') {
     for (const feature of Object.keys(statistics.features)) {
         if (features !== 'all' && !features.has(feature)) {
@@ -48,6 +57,9 @@ function printFeatureStatistics(statistics, features = 'all') {
   `);
 }
 const pad = 3;
+/**
+ * Prints a single feature statistics entry to the console.
+ */
 function printFeatureStatisticsEntry(info) {
     let longestKey = 0;
     let longestValue = 0;

package/statistics/output/statistics-file.d.ts

@@ -1,4 +1,4 @@
-import type { DummyAppendMemoryMap, StatisticAppendProvider } from './file-provider';
+import { type DummyAppendMemoryMap, type StatisticAppendProvider } from './file-provider';
 /**
  * Requires source information to be attached on parsing!
  * <p>
@@ -13,7 +13,6 @@ export declare let statisticsFileProvider: StatisticAppendProvider;
 export declare function initFileProvider(outputDirectory: string): void;
 /**
  * Either ignore the statistics or write them to a given map (e.g., for testing).
- *
  * @param map - The map to write to, will not persist calls if no map is given
  */
 export declare function initDummyFileProvider(map?: DummyAppendMemoryMap): void;

package/statistics/output/statistics-file.js

@@ -32,7 +32,6 @@ function initFileProvider(outputDirectory) {
 }
 /**
  * Either ignore the statistics or write them to a given map (e.g., for testing).
- *
  * @param map - The map to write to, will not persist calls if no map is given
  */
 function initDummyFileProvider(map) {

package/statistics/statistics.d.ts

@@ -1,9 +1,9 @@
-import type { MetaStatistics } from './meta-statistics';
+import { type MetaStatistics } from './meta-statistics';
 import type { RParseRequestFromFile, RParseRequestFromText } from '../r-bridge/retriever';
 import type { PipelineOutput } from '../core/steps/pipeline/pipeline';
 import { DEFAULT_DATAFLOW_PIPELINE } from '../core/steps/pipeline/default-pipelines';
 import type { RShell } from '../r-bridge/shell';
-import type { FeatureSelection, FeatureStatistics } from './features/feature';
+import { type FeatureSelection, type FeatureStatistics } from './features/feature';
 import type { FlowrConfigOptions } from '../config';
 /**
  * By default, {@link extractUsageStatistics} requires a generator, but sometimes you already know all the files
@@ -13,13 +13,12 @@ export declare function staticRequests(...requests: (RParseRequestFromText | RPa
 type DataflowResult = PipelineOutput<typeof DEFAULT_DATAFLOW_PIPELINE>;
 /**
  * Extract all wanted statistic information from a set of requests using the presented R session.
- *
  * @param shell     - The R session to use
  * @param config    - The flowr config
  * @param onRequest - A callback that is called at the beginning of each request, this may be used to debug the requests.
  * @param features  - The features to extract (see {@link allFeatureNames}).
  * @param requests  - The requests to extract the features from. May generate them on demand (e.g., by traversing a folder).
- * 										If your request is statically known, you can use {@link staticRequests} to create this generator.
+ *                    If your request is statically known, you can use {@link staticRequests} to create this generator.
  * @param rootPath  - The root path to the project, this is used to relativize the file paths in the statistics.
  */
 export declare function extractUsageStatistics<T extends RParseRequestFromText | RParseRequestFromFile>(shell: RShell, config: FlowrConfigOptions, onRequest: (request: T) => void, features: FeatureSelection, requests: AsyncGenerator<T>, rootPath?: string): Promise<{

package/statistics/statistics.js

@@ -14,6 +14,7 @@ const pipeline_executor_1 = require("../core/pipeline-executor");
 const default_pipelines_1 = require("../core/steps/pipeline/default-pipelines");
 const feature_1 = require("./features/feature");
 const convert_values_1 = require("../r-bridge/lang-4.x/convert-values");
+const flowr_analyzer_context_1 = require("../project/context/flowr-analyzer-context");
 /**
  * By default, {@link extractUsageStatistics} requires a generator, but sometimes you already know all the files
  * that you want to process. This function simply reps your requests as a generator.
@@ -28,13 +29,12 @@ function staticRequests(...requests) {
 }
 /**
  * Extract all wanted statistic information from a set of requests using the presented R session.
- *
  * @param shell     - The R session to use
  * @param config    - The flowr config
  * @param onRequest - A callback that is called at the beginning of each request, this may be used to debug the requests.
  * @param features  - The features to extract (see {@link allFeatureNames}).
  * @param requests  - The requests to extract the features from. May generate them on demand (e.g., by traversing a folder).
- * 										If your request is statically known, you can use {@link staticRequests} to create this generator.
+ *                    If your request is statically known, you can use {@link staticRequests} to create this generator.
  * @param rootPath  - The root path to the project, this is used to relativize the file paths in the statistics.
  */
 async function extractUsageStatistics(shell, config, onRequest, features, requests, rootPath) {
@@ -83,8 +83,8 @@ function processMetaOnSuccessful(meta, request) {
 const parser = new xmldom_1.DOMParser();
 async function extractSingle(result, shell, request, features, suffixFilePath, config) {
     const slicerOutput = await new pipeline_executor_1.PipelineExecutor(default_pipelines_1.DEFAULT_DATAFLOW_PIPELINE, {
-        request, parser: shell
-    }, config).allRemainingSteps();
+        context: (0, flowr_analyzer_context_1.contextFromInput)(request, config), parser: shell
+    }).allRemainingSteps();
     // retrieve parsed xml through (legacy) xmlparsedata
     const suffix = request.request === 'file' ? ', encoding="utf-8"' : '';
     shell.sendCommands(`try(flowr_parsed<-parse(${request.request}=${JSON.stringify(request.content)},keep.source=TRUE${suffix}),silent=FALSE)`, 'try(flowr_output<-xmlparsedata::xml_parse_data(flowr_parsed,includeText=TRUE,pretty=FALSE),silent=FALSE)');

package/statistics/summarizer/auto-detect.d.ts

@@ -1,2 +1,5 @@
 import { SummarizerType } from '../../util/summarizer';
+/**
+ * Auto-detects the summarization type based on the input path.
+ */
 export declare function detectSummarizationType(inputPath: string): Promise<SummarizerType>;

package/statistics/summarizer/auto-detect.js

@@ -7,6 +7,9 @@ exports.detectSummarizationType = detectSummarizationType;
 const fs_1 = __importDefault(require("fs"));
 const summarizer_1 = require("./summarizer");
 const log_1 = require("../../util/log");
+/**
+ * Auto-detects the summarization type based on the input path.
+ */
 async function detectSummarizationType(inputPath) {
     if (fs_1.default.statSync(inputPath).isFile()) {
         log_1.log.info(`Detected benchmark summarization with single file ${inputPath}`);

package/statistics/summarizer/post-process/clusterer.d.ts

@@ -11,14 +11,13 @@ export interface ClusterReport extends MergeableRecord {
     /** Maps each context encountered (i.e., every file that contains something associated with the feature) to a unique id, used in the {@link ClusterReport#valueInfoMap|valueInfoMap}. */
     contextIdMap: ClusterContextIdMap;
     /**
-   * Counts which contexts contained which values of a feature.
-   * For example, that `<-` occurred in files with ids `[12, 42, 19, 19]` (i.e., the context with the id 19 contained it twice).
-   */
+     * Counts which contexts contained which values of a feature.
+     * For example, that `<-` occurred in files with ids `[12, 42, 19, 19]` (i.e., the context with the id 19 contained it twice).
+     */
     valueInfoMap: ClusterValueInfoMap;
 }
 /**
  * Takes a statistics file like `statistics-out/top-2023-01-01-00-00-00/Assignments/assignmentOperator.txt` and clusters the values by context
- *
  * @param filepath     - Filepath of the statistics file
  * @param contextIdMap - The id map to use, can use an existing one to reuse ids for same contexts spreading over multiple input files.
  *  `undefined` is used for unknown contexts. This map allows us to reference contexts with a way shorter identifier (vs. the full file path).

package/statistics/summarizer/post-process/clusterer.js

@@ -7,7 +7,6 @@ exports.clusterStatisticsOutput = clusterStatisticsOutput;
 /**
  * Reading the given file line by line and expecting constructs of {@link StatisticsOutputFormat},
  * this module is responsible for identifying interesting groups of same data.
- *
  * @module
  */
 const n_readlines_1 = __importDefault(require("n-readlines"));
@@ -15,7 +14,6 @@ const defaultmap_1 = require("../../../util/collections/defaultmap");
 const decorate_1 = require("../../../r-bridge/lang-4.x/ast/model/processing/decorate");
 /**
  * Takes a statistics file like `statistics-out/top-2023-01-01-00-00-00/Assignments/assignmentOperator.txt` and clusters the values by context
- *
  * @param filepath     - Filepath of the statistics file
  * @param contextIdMap - The id map to use, can use an existing one to reuse ids for same contexts spreading over multiple input files.
  *  `undefined` is used for unknown contexts. This map allows us to reference contexts with a way shorter identifier (vs. the full file path).

package/statistics/summarizer/post-process/file-based-count.d.ts

@@ -7,7 +7,6 @@ export interface FileBasedTable {
  * The purpose of this function is to reformat {@link ClusterReport} in way that lists file-based contributions.
  * E.g., "the file with id 12 contained the assignment with `<-` 3 times".
  * Feature Values are listed in the header.
- *
  * @param report - the report to reformat
  */
 export declare function fileBasedCount(report: ClusterReport): FileBasedTable;

package/statistics/summarizer/post-process/file-based-count.js

@@ -10,7 +10,6 @@ const fs_1 = __importDefault(require("fs"));
  * The purpose of this function is to reformat {@link ClusterReport} in way that lists file-based contributions.
  * E.g., "the file with id 12 contained the assignment with `<-` 3 times".
  * Feature Values are listed in the header.
- *
  * @param report - the report to reformat
  */
 function fileBasedCount(report) {

package/statistics/summarizer/post-process/histogram.d.ts

@@ -28,7 +28,6 @@ export interface Histogram {
  *
  * Let's suppose you want histograms for the Assignments feature.
  * By default, for each clustered value, a histogram is produced (can be configured by `filter`).
- *
  * @param report  - The report to collect histogram information from
  * @param binSize - Size of each bin (see {@link histogramFromNumbers} for details on why we do not specify the bin-count)
  * @param relateValuesToNumberOfLines - If true, each value (like `<-` appeared in file 'x' exactly `N` times) will be divided by the number of lines in the file 'x'.
@@ -52,7 +51,6 @@ export declare function histogramFromNumbers(name: string, binSize: number, valu
  * - `from` - The exclusive lower bound of the bin
  * - `to`   - The inclusive upper bound of the bin
  * - a column with the name of each histogram, containing its count of values in the corresponding bin
- *
  * @param histograms     - The histogram to convert (assumed to have the same ranges and bins)
  * @param countAsDensity - If true, the count is divided by the total number of values (individually for each histogram, similar to pgfplots `hist/density` option)
  */

package/statistics/summarizer/post-process/histogram.js

@@ -17,7 +17,6 @@ const arrays_1 = require("../../../util/collections/arrays");
  *
  * Let's suppose you want histograms for the Assignments feature.
  * By default, for each clustered value, a histogram is produced (can be configured by `filter`).
- *
  * @param report  - The report to collect histogram information from
  * @param binSize - Size of each bin (see {@link histogramFromNumbers} for details on why we do not specify the bin-count)
  * @param relateValuesToNumberOfLines - If true, each value (like `<-` appeared in file 'x' exactly `N` times) will be divided by the number of lines in the file 'x'.
@@ -72,7 +71,6 @@ function histogramFromNumbers(name, binSize, values) {
  * - `from` - The exclusive lower bound of the bin
  * - `to`   - The inclusive upper bound of the bin
  * - a column with the name of each histogram, containing its count of values in the corresponding bin
- *
  * @param histograms     - The histogram to convert (assumed to have the same ranges and bins)
  * @param countAsDensity - If true, the count is divided by the total number of values (individually for each histogram, similar to pgfplots `hist/density` option)
  */

package/statistics/summarizer/post-process/post-process-output.d.ts

@@ -1,11 +1,9 @@
-import type { ClusterReport } from './clusterer';
-import type { FeatureSelection } from '../../features/feature';
+import { type ClusterReport } from './clusterer';
+import { type FeatureSelection } from '../../features/feature';
 /**
  * Post process the collections in a given folder, reducing them in a memory preserving way.
- *
  * @param filepath - Path to the root file of the data collection like `statistics-out/top-2023-01-01-00-00-00/`
  * @param features - Collection of features to post process, expects corresponding folders to exist
- *
  * @returns non-aggregated reports for each sub-key of each feature
  */
 export declare function postProcessFeatureFolder(filepath: string, features: FeatureSelection): ClusterReport[];

package/statistics/summarizer/post-process/post-process-output.js

@@ -17,10 +17,8 @@ const file_provider_1 = require("../../output/file-provider");
 const arrays_1 = require("../../../util/collections/arrays");
 /**
  * Post process the collections in a given folder, reducing them in a memory preserving way.
- *
  * @param filepath - Path to the root file of the data collection like `statistics-out/top-2023-01-01-00-00-00/`
  * @param features - Collection of features to post process, expects corresponding folders to exist
- *
  * @returns non-aggregated reports for each sub-key of each feature
  */
 function postProcessFeatureFolder(filepath, features) {
@@ -39,7 +37,6 @@ function postProcessFeatureFolder(filepath, features) {
 }
 /**
  * Process a single feature folder like `Assignments/`
- *
  * @param filepath - Same as the input to {@link postProcessFeatureFolder}
  * @param feature  - The (single) feature to process
  */

package/statistics/summarizer/second-phase/process.d.ts

@@ -1,10 +1,12 @@
 import type { StatisticsSummarizerConfiguration } from '../summarizer';
-import type { CommonSummarizerConfiguration } from '../../../util/summarizer';
-import type { FeatureStatisticsWithMeta } from '../../features/feature';
+import { type CommonSummarizerConfiguration } from '../../../util/summarizer';
+import { type FeatureStatisticsWithMeta } from '../../features/feature';
+/**
+ *
+ */
 export declare function postProcessFeatures(config: StatisticsSummarizerConfiguration, filepath: string, outputPath: string, logger: (message: string) => void, metaFeatureInformation: Map<string, FeatureStatisticsWithMeta>): void;
 /**
  * Post process the collections in a given folder, retrieving the final summaries.
- *
  * @param logger       - The logger to use for outputs
  * @param filepath     - Path to the root file of the data collection (contains all the archives)
  * @param config       - Configuration of the summarizer

package/statistics/summarizer/second-phase/process.js

@@ -13,6 +13,9 @@ const arrays_1 = require("../../../util/collections/arrays");
 const files_1 = require("../../../util/files");
 const assert_1 = require("../../../util/assert");
 const feature_1 = require("../../features/feature");
+/**
+ *
+ */
 function postProcessFeatures(config, filepath, outputPath, logger, metaFeatureInformation) {
     for (const featureName of config.featuresToUse) {
         const featureInfo = feature_1.ALL_FEATURES[featureName];
@@ -66,7 +69,6 @@ function postProcessMeta(config, filepath, outputPath, logger, metaFeatureInform
 }
 /**
  * Post process the collections in a given folder, retrieving the final summaries.
- *
  * @param logger       - The logger to use for outputs
  * @param filepath     - Path to the root file of the data collection (contains all the archives)
  * @param config       - Configuration of the summarizer

package/statistics/summarizer/summarizer.d.ts

@@ -1,5 +1,4 @@
-import type { CommonSummarizerConfiguration } from '../../util/summarizer';
-import { Summarizer } from '../../util/summarizer';
+import { type CommonSummarizerConfiguration, Summarizer } from '../../util/summarizer';
 import type { FeatureSelection } from '../features/feature';
 export interface StatisticsSummarizerConfiguration extends CommonSummarizerConfiguration {
     /**