@eagleoutice/flowr 2.7.0 → 2.7.3

package/project/context/flowr-analyzer-functions-context.d.ts

@@ -0,0 +1,29 @@
+import { AbstractFlowrAnalyzerContext } from './abstract-flowr-analyzer-context';
+import type { FlowrAnalyzerContext } from './flowr-analyzer-context';
+import { FlowrAnalyzerPackageVersionsPlugin } from '../plugins/package-version-plugins/flowr-analyzer-package-versions-plugin';
+export declare enum FunctionTypes {
+    Function = "function",
+    ExportTypes = "exportTypes",
+    S3 = "S3"
+}
+export interface FunctionInfo {
+    name: string;
+    packageOrigin: string;
+    isExported: boolean;
+    isS3Generic: boolean;
+    s3TypeDispatch?: string;
+    inferredType?: string;
+}
+export interface ReadOnlyFlowrAnalyzerFunctionsContext {
+    readonly name: string;
+    getFunctionInfo(name: string, className?: string): FunctionInfo | FunctionInfo[] | undefined;
+}
+export declare class FlowrAnalyzerFunctionsContext extends AbstractFlowrAnalyzerContext<undefined, void, FlowrAnalyzerPackageVersionsPlugin> implements ReadOnlyFlowrAnalyzerFunctionsContext {
+    readonly name = "flowr-analyzer-functions-context";
+    private functionInfo;
+    constructor(ctx: FlowrAnalyzerContext, plugins?: readonly FlowrAnalyzerPackageVersionsPlugin[]);
+    addFunctionInfo(info: FunctionInfo): void;
+    private mergeFunctionInfo;
+    getFunctionInfo(pkg: string, name: string, s3TypeDispatch?: string): FunctionInfo | FunctionInfo[] | undefined;
+    reset(): void;
+}

package/project/context/flowr-analyzer-functions-context.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowrAnalyzerFunctionsContext = exports.FunctionTypes = void 0;
+const abstract_flowr_analyzer_context_1 = require("./abstract-flowr-analyzer-context");
+const flowr_analyzer_package_versions_plugin_1 = require("../plugins/package-version-plugins/flowr-analyzer-package-versions-plugin");
+const flowr_analyzer_package_versions_namespace_file_plugin_1 = require("../plugins/package-version-plugins/flowr-analyzer-package-versions-namespace-file-plugin");
+var FunctionTypes;
+(function (FunctionTypes) {
+    FunctionTypes["Function"] = "function";
+    FunctionTypes["ExportTypes"] = "exportTypes";
+    FunctionTypes["S3"] = "S3";
+})(FunctionTypes || (exports.FunctionTypes = FunctionTypes = {}));
+class FlowrAnalyzerFunctionsContext extends abstract_flowr_analyzer_context_1.AbstractFlowrAnalyzerContext {
+    name = 'flowr-analyzer-functions-context';
+    functionInfo = new Map();
+    constructor(ctx, plugins) {
+        super(ctx, flowr_analyzer_package_versions_plugin_1.FlowrAnalyzerPackageVersionsPlugin.defaultPlugin(), plugins);
+    }
+    addFunctionInfo(info) {
+        const list = this.functionInfo.get(info.name);
+        if (!list) {
+            this.functionInfo.set(info.name, [info]);
+            return;
+        }
+        const other = list.find(e => e.name === info.name &&
+            e.packageOrigin === info.packageOrigin &&
+            e.s3TypeDispatch === info.s3TypeDispatch);
+        if (other) {
+            flowr_analyzer_package_versions_namespace_file_plugin_1.namespaceFileLog.warn('Namespace information is being merged!');
+            this.mergeFunctionInfo(other, info);
+        }
+        else {
+            list.push(info);
+        }
+    }
+    mergeFunctionInfo(functionInfo, other) {
+        if (functionInfo.name !== other.name || functionInfo.packageOrigin !== other.packageOrigin) {
+            throw new Error(`Cannot merge FunctionInfo for ${functionInfo.name} and ${other.name}`);
+        }
+        if (functionInfo.s3TypeDispatch !== other.s3TypeDispatch) {
+            throw new Error(`Cannot merge FunctionInfo with different S3 dispatch for ${functionInfo.name}`);
+        }
+        if (!functionInfo.inferredType && other.inferredType) {
+            functionInfo.inferredType = other.inferredType;
+        }
+        functionInfo.isExported ||= other.isExported;
+        functionInfo.isS3Generic ||= other.isS3Generic;
+    }
+    getFunctionInfo(pkg, name, s3TypeDispatch) {
+        if (s3TypeDispatch) {
+            return this.functionInfo.get(`${name}`)?.find(e => e.packageOrigin === pkg && e.s3TypeDispatch === s3TypeDispatch);
+        }
+        else if (name.includes('.')) {
+            const parts = name.split('.');
+            s3TypeDispatch = parts.pop();
+            const splitName = parts.join('.');
+            if (this.functionInfo.has(splitName)) {
+                return this.functionInfo.get(splitName)?.find(e => e.packageOrigin === pkg && e.s3TypeDispatch === s3TypeDispatch);
+            }
+        }
+        return this.functionInfo.get(name)?.filter(e => e.packageOrigin === pkg);
+    }
+    reset() {
+        this.functionInfo = new Map();
+    }
+}
+exports.FlowrAnalyzerFunctionsContext = FlowrAnalyzerFunctionsContext;
+//# sourceMappingURL=flowr-analyzer-functions-context.js.map

package/project/context/flowr-file.d.ts

@@ -15,6 +15,8 @@ export declare enum FileRole {
     Description = "description",
     /** The `NAMESPACE` file in R packages, currently not specially supported. */
     Namespace = "namespace",
+    /** The `NEWS` file in R packages */
+    News = "news",
     /** Data files, e.g., `R/sysdata.rda`, currently not specially supported. */
     Data = "data",
     /**

package/project/context/flowr-file.js

@@ -17,6 +17,8 @@ var FileRole;
     FileRole["Description"] = "description";
     /** The `NAMESPACE` file in R packages, currently not specially supported. */
     FileRole["Namespace"] = "namespace";
+    /** The `NEWS` file in R packages */
+    FileRole["News"] = "news";
     /** Data files, e.g., `R/sysdata.rda`, currently not specially supported. */
     FileRole["Data"] = "data";
     /**

package/project/plugins/file-plugins/{flowr-description-file.d.ts → files/flowr-description-file.d.ts}

@@ -1,4 +1,4 @@
-import { type FlowrFileProvider, type FileRole, FlowrFile } from '../../context/flowr-file';
+import { type FlowrFileProvider, type FileRole, FlowrFile } from '../../../context/flowr-file';
 export type DCF = Map<string, string[]>;
 /**
  * This decorates a text file and provides access to its content as a DCF (Debian Control File)-like structure.

package/project/plugins/file-plugins/files/flowr-description-file.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowrDescriptionFile = void 0;
+const flowr_file_1 = require("../../../context/flowr-file");
+/**
+ * This decorates a text file and provides access to its content as a DCF (Debian Control File)-like structure.
+ */
+class FlowrDescriptionFile extends flowr_file_1.FlowrFile {
+    wrapped;
+    /**
+     * Prefer the static {@link FlowrDescriptionFile.from} method to create instances of this class as it will not re-create if already a description file
+     * and handle role assignments.
+     */
+    constructor(file) {
+        super(file.path(), file.role);
+        this.wrapped = file;
+    }
+    /**
+     * Loads and parses the content of the wrapped file as a DCF structure.
+     * @see {@link parseDCF} for details on the parsing logic.
+     */
+    loadContent() {
+        return parseDCF(this.wrapped);
+    }
+    /**
+     * Description file lifter, this does not re-create if already a description file
+     */
+    static from(file, role) {
+        if (role) {
+            file.assignRole(role);
+        }
+        return file instanceof FlowrDescriptionFile ? file : new FlowrDescriptionFile(file);
+    }
+}
+exports.FlowrDescriptionFile = FlowrDescriptionFile;
+/**
+ * Parses the given file in the 'Debian Control Format'.
+ * @param file - The file to parse
+ */
+function parseDCF(file) {
+    const result = new Map();
+    let currentKey = '';
+    let currentValue = '';
+    const indentRegex = new RegExp(/^\s/);
+    const firstColonRegex = new RegExp(/:(.*)/s);
+    const fileContent = file.content().toString().split(/\r?\n/);
+    for (const line of fileContent) {
+        if (indentRegex.test(line)) {
+            currentValue += '\n' + line.trim();
+        }
+        else {
+            if (currentKey) {
+                const values = currentValue ? cleanValues(currentValue) : [];
+                result.set(currentKey, values);
+            }
+            const [key, rest] = line.split(firstColonRegex).map(s => s.trim());
+            currentKey = key?.trim() ?? '';
+            currentValue = rest?.trim() ?? '';
+        }
+    }
+    if (currentKey) {
+        const values = currentValue ? cleanValues(currentValue) : [];
+        result.set(currentKey, values);
+    }
+    return result;
+}
+const cleanSplitRegex = /[\n,]+/;
+const cleanQuotesRegex = /'/g;
+function cleanValues(values) {
+    return values
+        .split(cleanSplitRegex)
+        .map(s => s.trim().replace(cleanQuotesRegex, ''))
+        .filter(s => s.length > 0);
+}
+//# sourceMappingURL=flowr-description-file.js.map

package/project/plugins/file-plugins/files/flowr-namespace-file.d.ts

@@ -0,0 +1,32 @@
+import type { FileRole, FlowrFileProvider } from '../../../context/flowr-file';
+import { FlowrFile } from '../../../context/flowr-file';
+export interface NamespaceInfo {
+    exportedSymbols: string[];
+    exportedFunctions: string[];
+    exportS3Generics: Map<string, string[]>;
+    loadsWithSideEffects: boolean;
+}
+export interface NamespaceFormat {
+    current: NamespaceInfo;
+    [packageName: string]: NamespaceInfo;
+}
+/**
+ * This decorates a text file and provides access to its content in the {@link NamespaceFormat}.
+ */
+export declare class FlowrNamespaceFile extends FlowrFile<NamespaceFormat> {
+    private readonly wrapped;
+    /**
+     * Prefer the static {@link FlowrNamespaceFile.from} method to create instances of this class as it will not re-create if already a namespace file
+     * and handle role assignments.
+     */
+    constructor(file: FlowrFileProvider);
+    /**
+     * Loads and parses the content of the wrapped file in the {@link NamespaceFormat}.
+     * @see {@link parseNamespace} for details on the parsing logic.
+     */
+    protected loadContent(): NamespaceFormat;
+    /**
+     * Namespace file lifter, this does not re-create if already a namespace file
+     */
+    static from(file: FlowrFileProvider | FlowrNamespaceFile, role?: FileRole): FlowrNamespaceFile;
+}

package/project/plugins/file-plugins/files/flowr-namespace-file.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowrNamespaceFile = void 0;
+const flowr_file_1 = require("../../../context/flowr-file");
+/**
+ * This decorates a text file and provides access to its content in the {@link NamespaceFormat}.
+ */
+class FlowrNamespaceFile extends flowr_file_1.FlowrFile {
+    wrapped;
+    /**
+     * Prefer the static {@link FlowrNamespaceFile.from} method to create instances of this class as it will not re-create if already a namespace file
+     * and handle role assignments.
+     */
+    constructor(file) {
+        super(file.path(), file.role);
+        this.wrapped = file;
+    }
+    /**
+     * Loads and parses the content of the wrapped file in the {@link NamespaceFormat}.
+     * @see {@link parseNamespace} for details on the parsing logic.
+     */
+    loadContent() {
+        return parseNamespace(this.wrapped);
+    }
+    /**
+     * Namespace file lifter, this does not re-create if already a namespace file
+     */
+    static from(file, role) {
+        if (role) {
+            file.assignRole(role);
+        }
+        return file instanceof FlowrNamespaceFile ? file : new FlowrNamespaceFile(file);
+    }
+}
+exports.FlowrNamespaceFile = FlowrNamespaceFile;
+const cleanLineCommentRegex = /^#.*$/gm;
+/**
+ * Parses the given NAMESPACE file
+ */
+function parseNamespace(file) {
+    const result = {
+        current: {
+            exportedSymbols: [],
+            exportedFunctions: [],
+            exportS3Generics: new Map(),
+            loadsWithSideEffects: false,
+        },
+    };
+    const fileContent = file.content().toString().replaceAll(cleanLineCommentRegex, '').trim()
+        .split(/\r?\n/).filter(Boolean);
+    for (const line of fileContent) {
+        const match = line.trim().match(/^(\w+)\(([^)]*)\)$/);
+        if (!match) {
+            continue;
+        }
+        const [, type, args] = match;
+        switch (type) {
+            case 'exportClasses':
+            case 'exportMethods':
+                result.current.exportedFunctions.push(args);
+                break;
+            case 'S3method':
+                {
+                    const parts = args.split(',').map(s => s.trim());
+                    if (parts.length !== 2) {
+                        continue;
+                    }
+                    const [pkg, func] = parts;
+                    let arr = result.current.exportS3Generics.get(pkg);
+                    if (!arr) {
+                        arr = [];
+                        result.current.exportS3Generics.set(pkg, arr);
+                    }
+                    arr.push(func);
+                    break;
+                }
+            case 'export':
+                result.current.exportedSymbols.push(args);
+                break;
+            case 'useDynLib':
+                {
+                    const parts = args.split(',').map(s => s.trim());
+                    if (parts.length !== 2) {
+                        continue;
+                    }
+                    const [pkg] = parts;
+                    if (!result[pkg]) {
+                        result[pkg] = {
+                            exportedSymbols: [],
+                            exportedFunctions: [],
+                            exportS3Generics: new Map(),
+                            loadsWithSideEffects: false,
+                        };
+                    }
+                    result[pkg].loadsWithSideEffects = true;
+                    break;
+                }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=flowr-namespace-file.js.map

package/project/plugins/file-plugins/files/flowr-news-file.d.ts

@@ -0,0 +1,27 @@
+import { type FlowrFileProvider, type FileRole, FlowrFile } from '../../../context/flowr-file';
+export interface NewsChunk {
+    header?: string;
+    version?: string;
+    date?: string;
+    entries: string[] | NewsChunk[];
+}
+/**
+ * This decorates a text file and provides access to its content following R's NEWS file structure.
+ */
+export declare class FlowrNewsFile extends FlowrFile<NewsChunk[]> {
+    private readonly wrapped;
+    /**
+     * Prefer the static {@link FlowrNewsFile.from} method to create instances of this class as it will not re-create if already a news file
+     * and handle role assignments.
+     */
+    constructor(file: FlowrFileProvider);
+    /**
+     * Loads and parses the content of the wrapped file as news chunks.
+     * @see {@link parseNews} for details on the parsing logic.
+     */
+    protected loadContent(): NewsChunk[];
+    /**
+     * News file lifter, this does not re-create if already a news file
+     */
+    static from(file: FlowrFileProvider | FlowrNewsFile, role?: FileRole): FlowrNewsFile;
+}

package/project/plugins/file-plugins/files/flowr-news-file.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowrNewsFile = void 0;
+const flowr_file_1 = require("../../../context/flowr-file");
+const r_regex_1 = require("../../../../util/r-regex");
+const objects_1 = require("../../../../util/objects");
+/**
+ * This decorates a text file and provides access to its content following R's NEWS file structure.
+ */
+class FlowrNewsFile extends flowr_file_1.FlowrFile {
+    wrapped;
+    /**
+     * Prefer the static {@link FlowrNewsFile.from} method to create instances of this class as it will not re-create if already a news file
+     * and handle role assignments.
+     */
+    constructor(file) {
+        super(file.path(), file.role);
+        this.wrapped = file;
+    }
+    /**
+     * Loads and parses the content of the wrapped file as news chunks.
+     * @see {@link parseNews} for details on the parsing logic.
+     */
+    loadContent() {
+        return parseNews(this.wrapped);
+    }
+    /**
+     * News file lifter, this does not re-create if already a news file
+     */
+    static from(file, role) {
+        if (role) {
+            file.assignRole(role);
+        }
+        return file instanceof FlowrNewsFile ? file : new FlowrNewsFile(file);
+    }
+}
+exports.FlowrNewsFile = FlowrNewsFile;
+function makeRversionRegex() {
+    // ^([[:space:]]*(%s)|(%s))(%s).*$
+    const fst = 'CHANGES? *(IN|FOR).*VERSION *|CHANGES? *(IN|FOR|TO) *';
+    const pVersion = r_regex_1.RStandardRegexp.ValidPackageVersion.source;
+    const pName = r_regex_1.RStandardRegexp.ValidPackageName.source;
+    const teachingDemos = [
+        // TeachingDemos pomp ouch
+        'NEW IN .*',
+        // HyperbolicDist nls2 proto
+        'VERSION:? *',
+        `${pName} +`,
+        // E.g., lattice:
+        //   Changes in lattice 0.17
+        `CHANGES IN ${pName} +`,
+        // sv*
+        `== Changes in ${pName} +`,
+        // tcltk2
+        '== Version +',
+        // R2WinBUGS
+        'update *',
+        'v *',
+        '',
+    ].join('|');
+    const weAreNicerFlags = 'i';
+    const pkgVersionLine = `\\s*(${pName})\\s+version\\s+(${pVersion})\\s*|\\s*#+\\s*${pName} (\\([^)]*\\)|${pVersion}).*`;
+    return new RegExp(`^(\\s*(${fst})|(${teachingDemos}))((${pVersion}).*)|${pkgVersionLine}$`, weAreNicerFlags);
+}
+//"^.*([[:digit:]]{4}-[[:digit:]]{2}-[[:digit:]]{2})[[:punct:][:space:]]*$",
+const RDateRegex = new RegExp(`^.*(\\d{4}-\\d{2}-\\d{2})[${r_regex_1.RPunctuationChars}\\s]*$`);
+// ^[[:space:]]*([o*+-])
+const RBulletPointRegex = /^\s*(?<bullet>[o*+-])/;
+// ^([[:alpha:]].*)[[:space:]]*$"
+const RCategoryRegex = /^((#+\s*)?([A-Za-z].*))\s*$/;
+const AnyVersionRegex = new RegExp(r_regex_1.RStandardRegexp.ValidPackageVersion.source + '|dev(e(l(opment)?)?)? (ver(sion)?)?|(?<=\\()[^)]*(?=\\))', 'i');
+function splitLinesRegex(relevantLines, regex) {
+    const lineChunks = [];
+    let currentChunk = [];
+    for (const line of relevantLines) {
+        if (regex.test(line)) {
+            if (currentChunk.length > 0) {
+                lineChunks.push(currentChunk);
+            }
+            currentChunk = [line];
+        }
+        else {
+            currentChunk.push(line);
+        }
+    }
+    if (currentChunk.length > 0) {
+        lineChunks.push(currentChunk);
+    }
+    return lineChunks;
+}
+/**
+ * Parses the given file into news chunks.
+ * @param file - The file to parse
+ * @see https://github.com/r-devel/r-svn/blob/44474af03ae77fd3b9a340279fa10cb698d106c3/src/library/tools/R/news.R#L91-L92
+ */
+function parseNews(file) {
+    // ^[[:space:]]*[[:punct:]]*[[:space:]]*
+    const noiseRegex = new RegExp(`^\\s*[${r_regex_1.RPunctuationChars}]*\\s*$`);
+    const lines = file.content().toString().split(/\r?\n/)
+        // first we clean underlines and friends (according to the R impl)
+        .filter(l => !noiseRegex.test(l));
+    // this is a port of the incredible complex R NEWS regex, but luckily it is  not too liberal :D
+    const regexVersion = makeRversionRegex();
+    // filter lines that match the version regex
+    const versionLines = lines.map(line => regexVersion.test(line));
+    // drop the header by removing everything before the first match
+    const firstVersionIndex = versionLines.findIndex(v => v);
+    const relevantLines = lines.slice(firstVersionIndex);
+    // split at every version line
+    const lineChunks = splitLinesRegex(relevantLines, regexVersion);
+    /**
+     * @see https://github.com/r-devel/r-svn/blob/44474af03ae77fd3b9a340279fa10cb698d106c3/src/library/tools/R/news.R#L183
+     */
+    function processChunk(lines, header) {
+        let date;
+        let head;
+        if (header) {
+            head = AnyVersionRegex.exec(header)?.[0];
+            date = RDateRegex.exec(header)?.[1];
+        }
+        const content = lines.join('\n').trim();
+        const hasBullets = RBulletPointRegex.exec(content);
+        if (hasBullets) {
+            const separator = hasBullets.groups?.bullet ?? '-';
+            const lineChunks = splitLinesRegex(lines, new RegExp(`^\\s*[${separator}]\\s+`)).map(
+            // apparently we have to trim leading '\tab' indentations
+            chunkLines => chunkLines.map(l => {
+                return l.replace(new RegExp(`^\\s*[${separator}]\\s+`), '').replace(/^\t?/gm, '').trim();
+            }).join('\n'));
+            return (0, objects_1.compactRecord)({
+                header,
+                version: head,
+                date,
+                entries: lineChunks
+            });
+        }
+        else {
+            // from the spec: "Categories should be non-empty starting in column 1."
+            const categoryChunks = splitLinesRegex(lines, RCategoryRegex);
+            // different to R we may accept no category blobs here
+            return (0, objects_1.compactRecord)({
+                header,
+                version: head,
+                date,
+                entries: categoryChunks.length > 1 ?
+                    categoryChunks.map(chunkLines => processChunk(chunkLines, header = RCategoryRegex.exec(chunkLines[0])?.[1])) : [content]
+            });
+        }
+    }
+    return lineChunks.map(l => processChunk(l.slice(1), l[0]));
+}
+//# sourceMappingURL=flowr-news-file.js.map

package/project/plugins/file-plugins/flowr-analyzer-description-file-plugin.d.ts

@@ -2,7 +2,7 @@ import { FlowrAnalyzerFilePlugin } from './flowr-analyzer-file-plugin';
 import { SemVer } from 'semver';
 import type { PathLike } from 'fs';
 import type { FlowrAnalyzerContext } from '../../context/flowr-analyzer-context';
-import { FlowrDescriptionFile } from './flowr-description-file';
+import { FlowrDescriptionFile } from './files/flowr-description-file';
 import { type FlowrFileProvider } from '../../context/flowr-file';
 export declare const descriptionFileLog: import("tslog").Logger<import("tslog").ILogObj>;
 /**

package/project/plugins/file-plugins/flowr-analyzer-description-file-plugin.js

@@ -4,7 +4,7 @@ exports.FlowrAnalyzerDescriptionFilePlugin = exports.descriptionFileLog = void 0
 const flowr_analyzer_file_plugin_1 = require("./flowr-analyzer-file-plugin");
 const semver_1 = require("semver");
 const log_1 = require("../../../util/log");
-const flowr_description_file_1 = require("./flowr-description-file");
+const flowr_description_file_1 = require("./files/flowr-description-file");
 const flowr_file_1 = require("../../context/flowr-file");
 const built_in_source_1 = require("../../../dataflow/internal/process/functions/call/built-in/built-in-source");
 exports.descriptionFileLog = log_1.log.getSubLogger({ name: 'flowr-analyzer-loading-order-description-file-plugin' });

package/project/plugins/file-plugins/flowr-analyzer-namespace-file-plugin.d.ts

@@ -0,0 +1,22 @@
+import { FlowrAnalyzerFilePlugin } from './flowr-analyzer-file-plugin';
+import { SemVer } from 'semver';
+import type { PathLike } from 'fs';
+import type { FlowrAnalyzerContext } from '../../context/flowr-analyzer-context';
+import type { FlowrFileProvider } from '../../context/flowr-file';
+import { FlowrNamespaceFile } from './files/flowr-namespace-file';
+/**
+ * This plugin provides support for R `NAMESPACE` files.
+ */
+export declare class FlowrAnalyzerNamespaceFilePlugin extends FlowrAnalyzerFilePlugin {
+    readonly name = "flowr-analyzer-namespace-file-plugin";
+    readonly description = "This plugin provides support for NAMESPACE files and extracts their content into the NAMESPACEFormat.";
+    readonly version: SemVer;
+    private readonly pattern;
+    /**
+     * Creates a new instance of the NAMESPACE file plugin.
+     * @param filePattern - The pattern to identify NAMESPACE files, see {@link NamespaceFilePattern} for the default pattern.
+     */
+    constructor(filePattern?: RegExp);
+    applies(file: PathLike): boolean;
+    process(_ctx: FlowrAnalyzerContext, file: FlowrFileProvider): FlowrNamespaceFile;
+}

package/project/plugins/file-plugins/flowr-analyzer-namespace-file-plugin.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowrAnalyzerNamespaceFilePlugin = void 0;
+const flowr_analyzer_file_plugin_1 = require("./flowr-analyzer-file-plugin");
+const semver_1 = require("semver");
+const flowr_file_1 = require("../../context/flowr-file");
+const flowr_namespace_file_1 = require("./files/flowr-namespace-file");
+const built_in_source_1 = require("../../../dataflow/internal/process/functions/call/built-in/built-in-source");
+const NamespaceFilePattern = /^NAMESPACE(\.txt)?$/i;
+/**
+ * This plugin provides support for R `NAMESPACE` files.
+ */
+class FlowrAnalyzerNamespaceFilePlugin extends flowr_analyzer_file_plugin_1.FlowrAnalyzerFilePlugin {
+    name = 'flowr-analyzer-namespace-file-plugin';
+    description = 'This plugin provides support for NAMESPACE files and extracts their content into the NAMESPACEFormat.';
+    version = new semver_1.SemVer('0.1.0');
+    pattern;
+    /**
+     * Creates a new instance of the NAMESPACE file plugin.
+     * @param filePattern - The pattern to identify NAMESPACE files, see {@link NamespaceFilePattern} for the default pattern.
+     */
+    constructor(filePattern = NamespaceFilePattern) {
+        super();
+        this.pattern = filePattern;
+    }
+    applies(file) {
+        return this.pattern.test((0, built_in_source_1.platformBasename)(file.toString()));
+    }
+    process(_ctx, file) {
+        return flowr_namespace_file_1.FlowrNamespaceFile.from(file, flowr_file_1.FileRole.Namespace);
+    }
+}
+exports.FlowrAnalyzerNamespaceFilePlugin = FlowrAnalyzerNamespaceFilePlugin;
+//# sourceMappingURL=flowr-analyzer-namespace-file-plugin.js.map

package/project/plugins/file-plugins/flowr-analyzer-news-file-plugin.d.ts

@@ -0,0 +1,23 @@
+import { FlowrAnalyzerFilePlugin } from './flowr-analyzer-file-plugin';
+import { SemVer } from 'semver';
+import type { PathLike } from 'fs';
+import type { FlowrAnalyzerContext } from '../../context/flowr-analyzer-context';
+import { type FlowrFileProvider } from '../../context/flowr-file';
+import { FlowrNewsFile } from './files/flowr-news-file';
+/**
+ * This plugin provides support for R `NEWS` files.
+ * @see https://rdrr.io/r/utils/news.html
+ */
+export declare class FlowrAnalyzerNewsFilePlugin extends FlowrAnalyzerFilePlugin {
+    readonly name = "flowr-analyzer-news-file-plugin";
+    readonly description = "This plugin provides support for NEWS files and extracts their content into version chunks.";
+    readonly version: SemVer;
+    private readonly pattern;
+    /**
+     * Creates a new instance of the NEWS file plugin.
+     * @param filePattern - The pattern to identify NEWS files, see {@link NewsFilePattern} for the default pattern.
+     */
+    constructor(filePattern?: RegExp);
+    applies(file: PathLike): boolean;
+    process(_ctx: FlowrAnalyzerContext, file: FlowrFileProvider): FlowrNewsFile;
+}

package/project/plugins/file-plugins/flowr-analyzer-news-file-plugin.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowrAnalyzerNewsFilePlugin = void 0;
+const flowr_analyzer_file_plugin_1 = require("./flowr-analyzer-file-plugin");
+const semver_1 = require("semver");
+const flowr_file_1 = require("../../context/flowr-file");
+const built_in_source_1 = require("../../../dataflow/internal/process/functions/call/built-in/built-in-source");
+const flowr_news_file_1 = require("./files/flowr-news-file");
+const NewsFilePattern = /^NEWS(\.(rd|md))?$/i;
+/**
+ * This plugin provides support for R `NEWS` files.
+ * @see https://rdrr.io/r/utils/news.html
+ */
+class FlowrAnalyzerNewsFilePlugin extends flowr_analyzer_file_plugin_1.FlowrAnalyzerFilePlugin {
+    name = 'flowr-analyzer-news-file-plugin';
+    description = 'This plugin provides support for NEWS files and extracts their content into version chunks.';
+    version = new semver_1.SemVer('0.1.0');
+    pattern;
+    /**
+     * Creates a new instance of the NEWS file plugin.
+     * @param filePattern - The pattern to identify NEWS files, see {@link NewsFilePattern} for the default pattern.
+     */
+    constructor(filePattern = NewsFilePattern) {
+        super();
+        this.pattern = filePattern;
+    }
+    applies(file) {
+        return this.pattern.test((0, built_in_source_1.platformBasename)(file.toString()));
+    }
+    process(_ctx, file) {
+        return flowr_news_file_1.FlowrNewsFile.from(file, flowr_file_1.FileRole.News);
+    }
+}
+exports.FlowrAnalyzerNewsFilePlugin = FlowrAnalyzerNewsFilePlugin;
+//# sourceMappingURL=flowr-analyzer-news-file-plugin.js.map

package/project/plugins/file-plugins/notebooks/flowr-analyzer-jupyter-file-plugin.d.ts

@@ -3,7 +3,7 @@ import { SemVer } from 'semver';
 import type { FlowrAnalyzerContext } from '../../../context/flowr-analyzer-context';
 import type { FlowrFileProvider } from '../../../context/flowr-file';
 import { FlowrAnalyzerFilePlugin } from '../flowr-analyzer-file-plugin';
-import { FlowrJupyterFile } from './flowr-jupyter-file';
+import { FlowrJupyterFile } from '../files/flowr-jupyter-file';
 /**
  * The plugin provides support for Jupyter (`.ipynb`) files
  */