npm - @eagleoutice/flowr - Versions diffs - 2.9.10 → 2.9.12 - Mend

@eagleoutice/flowr 2.9.10 → 2.9.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (175) hide show

package/r-bridge/lang-4.x/ast/model/nodes/r-expression-list.js CHANGED Viewed

@@ -1,3 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RExpressionList = void 0;
+const type_1 = require("../type");
+/**
+ * Helper for working with {@link RExpressionList} AST nodes.
+ */
+exports.RExpressionList = {
+    name: 'RExpressionList',
+    /**
+     * Type guard for {@link RExpressionList} nodes.
+     */
+    is(node) {
+        return node?.type === type_1.RType.ExpressionList;
+    },
+    /**
+     * Type guard for implicit {@link RExpressionList} nodes, i.e., expression lists that are not created by a wrapper like `{}`.
+     */
+    isImplicit(node) {
+        return exports.RExpressionList.is(node) && node.grouping === undefined;
+    },
+    /**
+     * Returns the grouping symbol at the start of the expression list, if it exists. For example, for an expression list created by `{ ... }`, this would return the symbol for `{`.
+     */
+    groupStart(node) {
+        return node.grouping?.[0];
+    },
+    /**
+     * Returns the grouping symbol at the end of the expression list, if it exists. For example, for an expression list created by `{ ... }`, this would return the symbol for `}`.
+     */
+    groupEnd(node) {
+        return node.grouping?.[1];
+    }
+};
 //# sourceMappingURL=r-expression-list.js.map

package/r-bridge/lang-4.x/ast/model/nodes/r-for-loop.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import type { RAstNodeBase, Location, NoInfo, RNode } from '../model';
-import type { RType } from '../type';
+import { RType } from '../type';
 import type { RSymbol } from './r-symbol';
 import type { RExpressionList } from './r-expression-list';
 /**
@@ -16,3 +16,13 @@ export interface RForLoop<Info = NoInfo> extends RAstNodeBase<Info>, Location {
     /** body used in for-loop: <p> `for(... in ...) <body>`*/
     body: RExpressionList<Info>;
 }
+/**
+ * Helper for working with {@link RForLoop} AST nodes.
+ */
+export declare const RForLoop: {
+    readonly name: "RForLoop";
+    /**
+     * Type guard for RForLoop nodes.
+     */
+    readonly is: <Info = object>(this: void, node: RNode<Info> | undefined) => node is RForLoop<Info>;
+};

package/r-bridge/lang-4.x/ast/model/nodes/r-for-loop.js CHANGED Viewed

@@ -1,3 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RForLoop = void 0;
+const type_1 = require("../type");
+/**
+ * Helper for working with {@link RForLoop} AST nodes.
+ */
+exports.RForLoop = {
+    name: 'RForLoop',
+    /**
+     * Type guard for RForLoop nodes.
+     */
+    is(node) {
+        return node?.type === type_1.RType.ForLoop;
+    }
+};
 //# sourceMappingURL=r-for-loop.js.map

package/r-bridge/lang-4.x/ast/model/nodes/r-function-call.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import type { RAstNodeBase, Location, NoInfo, RNode } from '../model';
-import type { RType } from '../type';
+import { RType } from '../type';
 import type { RSymbol } from './r-symbol';
 import type { RArgument } from './r-argument';
 export declare const EmptyArgument = "<>";
@@ -29,3 +29,21 @@ export interface RUnnamedFunctionCall<Info = NoInfo> extends RAstNodeBase<Info>,
     readonly arguments: readonly RFunctionArgument<Info>[];
 }
 export type RFunctionCall<Info = NoInfo> = RNamedFunctionCall<Info> | RUnnamedFunctionCall<Info>;
+/**
+ * Helper for working with {@link RFunctionCall} AST nodes.
+ */
+export declare const RFunctionCall: {
+    readonly name: "RFunctionCall";
+    /**
+     * Type guard for {@link RFunctionCall} nodes.
+     */
+    readonly is: <Info = object>(this: void, node: RNode<Info> | undefined) => node is RFunctionCall<Info>;
+    /**
+     * Type guard for {@link RNamedFunctionCall} nodes.
+     */
+    readonly isNamed: <Info = object>(this: void, node: RNode<Info> | undefined) => node is RNamedFunctionCall<Info>;
+    /**
+     * Type guard for {@link RUnnamedFunctionCall} nodes.
+     */
+    readonly isUnnamed: <Info = object>(this: void, node: RNode<Info> | undefined) => node is RUnnamedFunctionCall<Info>;
+};

package/r-bridge/lang-4.x/ast/model/nodes/r-function-call.js CHANGED Viewed

@@ -1,5 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EmptyArgument = void 0;
+exports.RFunctionCall = exports.EmptyArgument = void 0;
+const type_1 = require("../type");
 exports.EmptyArgument = '<>';
+/**
+ * Helper for working with {@link RFunctionCall} AST nodes.
+ */
+exports.RFunctionCall = {
+    name: 'RFunctionCall',
+    /**
+     * Type guard for {@link RFunctionCall} nodes.
+     */
+    is(node) {
+        return node?.type === type_1.RType.FunctionCall;
+    },
+    /**
+     * Type guard for {@link RNamedFunctionCall} nodes.
+     */
+    isNamed(node) {
+        return exports.RFunctionCall.is(node) && node.named === true;
+    },
+    /**
+     * Type guard for {@link RUnnamedFunctionCall} nodes.
+     */
+    isUnnamed(node) {
+        return exports.RFunctionCall.is(node) && !node.named;
+    }
+};
 //# sourceMappingURL=r-function-call.js.map

package/r-bridge/lang-4.x/ast/model/nodes/r-function-definition.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import type { RAstNodeBase, Location, NoInfo, RNode } from '../model';
-import type { RType } from '../type';
+import { RType } from '../type';
 import type { RParameter } from './r-parameter';
 /**
  * ```r
@@ -16,3 +16,13 @@ export interface RFunctionDefinition<Info = NoInfo> extends RAstNodeBase<Info>,
     parameters: RParameter<Info>[];
     body: RNode<Info>;
 }
+/**
+ * Helper for working with {@link RFunctionDefinition} AST nodes.
+ */
+export declare const RFunctionDefinition: {
+    readonly name: "RFunctionDefinition";
+    /**
+     * Type guard for {@link RFunctionDefinition} nodes.
+     */
+    readonly is: <Info = object>(this: void, node: RNode<Info> | undefined) => node is RFunctionDefinition<Info>;
+};

package/r-bridge/lang-4.x/ast/model/nodes/r-function-definition.js CHANGED Viewed

@@ -1,3 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RFunctionDefinition = void 0;
+const type_1 = require("../type");
+/**
+ * Helper for working with {@link RFunctionDefinition} AST nodes.
+ */
+exports.RFunctionDefinition = {
+    name: 'RFunctionDefinition',
+    /**
+     * Type guard for {@link RFunctionDefinition} nodes.
+     */
+    is(node) {
+        return node?.type === type_1.RType.FunctionDefinition;
+    }
+};
 //# sourceMappingURL=r-function-definition.js.map

package/r-bridge/lang-4.x/ast/model/nodes/r-if-then-else.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import type { RAstNodeBase, Location, NoInfo, RNode } from '../model';
-import type { RType } from '../type';
+import { RType } from '../type';
 import type { RExpressionList } from './r-expression-list';
 /**
  * ```r
@@ -12,3 +12,13 @@ export interface RIfThenElse<Info = NoInfo> extends RAstNodeBase<Info>, Location
     then: RExpressionList<Info>;
     otherwise?: RExpressionList<Info>;
 }
+/**
+ * Helper for working with {@link RIfThenElse} AST nodes.
+ */
+export declare const RIfThenElse: {
+    readonly name: "RIfThenElse";
+    /**
+     * Type guard for {@link RIfThenElse} nodes.
+     */
+    readonly is: <Info = object>(this: void, node: RNode<Info> | undefined) => node is RIfThenElse<Info>;
+};

package/r-bridge/lang-4.x/ast/model/nodes/r-if-then-else.js CHANGED Viewed

@@ -1,3 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RIfThenElse = void 0;
+const type_1 = require("../type");
+/**
+ * Helper for working with {@link RIfThenElse} AST nodes.
+ */
+exports.RIfThenElse = {
+    name: 'RIfThenElse',
+    /**
+     * Type guard for {@link RIfThenElse} nodes.
+     */
+    is(node) {
+        return node?.type === type_1.RType.IfThenElse;
+    }
+};
 //# sourceMappingURL=r-if-then-else.js.map

package/r-bridge/lang-4.x/ast/model/nodes/r-line-directive.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
-import type { Leaf, Location, NoInfo } from '../model';
-import type { RType } from '../type';
+import type { Leaf, Location, NoInfo, RNode } from '../model';
+import { RType } from '../type';
 /**
  * Special comment to signal line mappings (e.g., in generated code) to the interpreter.
  */
@@ -8,3 +8,13 @@ export interface RLineDirective<Info = NoInfo> extends Location, Leaf<Info> {
     line: number;
     file: string;
 }
+/**
+ * Helper for working with {@link RLineDirective} AST nodes.
+ */
+export declare const RLineDirective: {
+    readonly name: "RLineDirective";
+    /**
+     * Type guard for {@link RLineDirective} nodes.
+     */
+    readonly is: <Info = object>(this: void, node: RNode<Info> | undefined) => node is RLineDirective<Info>;
+};

package/r-bridge/lang-4.x/ast/model/nodes/r-line-directive.js CHANGED Viewed

@@ -1,3 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RLineDirective = void 0;
+const type_1 = require("../type");
+/**
+ * Helper for working with {@link RLineDirective} AST nodes.
+ */
+exports.RLineDirective = {
+    name: 'RLineDirective',
+    /**
+     * Type guard for {@link RLineDirective} nodes.
+     */
+    is(node) {
+        return node?.type === type_1.RType.LineDirective;
+    }
+};
 //# sourceMappingURL=r-line-directive.js.map

package/r-bridge/lang-4.x/ast/model/nodes/r-logical.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
-import type { Leaf, Location, NoInfo } from '../model';
-import type { RType } from '../type';
+import type { Leaf, Location, NoInfo, RNode } from '../model';
+import { RType } from '../type';
 export type RLogicalValue = boolean;
 /**
  * Represents logical values (`TRUE` or `FALSE`).
@@ -8,3 +8,21 @@ export interface RLogical<Info = NoInfo> extends Leaf<Info>, Location {
     readonly type: RType.Logical;
     content: RLogicalValue;
 }
+/**
+ * Helper for working with {@link RLogical} AST nodes.
+ */
+export declare const RLogical: {
+    readonly name: "RLogical";
+    /**
+     * Type guard for {@link RLogical} nodes.
+     */
+    readonly is: <Info = object>(this: void, node: RNode<Info> | undefined) => node is RLogical<Info>;
+    /**
+     * Checks whether a node is a logical constant with value `TRUE`.
+     */
+    readonly isTrue: <Info = object>(this: void, node: RNode<Info> | undefined) => boolean;
+    /**
+     * Checks whether a node is a logical constant with value `FALSE`.
+     */
+    readonly isFalse: <Info = object>(this: void, node: RNode<Info> | undefined) => boolean;
+};

package/r-bridge/lang-4.x/ast/model/nodes/r-logical.js CHANGED Viewed

@@ -1,3 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RLogical = void 0;
+const type_1 = require("../type");
+/**
+ * Helper for working with {@link RLogical} AST nodes.
+ */
+exports.RLogical = {
+    name: 'RLogical',
+    /**
+     * Type guard for {@link RLogical} nodes.
+     */
+    is(node) {
+        return node?.type === type_1.RType.Logical;
+    },
+    /**
+     * Checks whether a node is a logical constant with value `TRUE`.
+     */
+    isTrue(node) {
+        return exports.RLogical.is(node) && node.content;
+    },
+    /**
+     * Checks whether a node is a logical constant with value `FALSE`.
+     */
+    isFalse(node) {
+        return exports.RLogical.is(node) && !node.content;
+    }
+};
 //# sourceMappingURL=r-logical.js.map

package/r-bridge/lang-4.x/ast/model/nodes/r-next.d.ts CHANGED Viewed

@@ -1,8 +1,18 @@
-import type { Leaf, Location, NoInfo } from '../model';
-import type { RType } from '../type';
+import type { Leaf, Location, NoInfo, RNode } from '../model';
+import { RType } from '../type';
 /**
  * A `next` statement.
  */
 export interface RNext<Info = NoInfo> extends Location, Leaf<Info> {
     readonly type: RType.Next;
 }
+/**
+ * Helper for working with {@link RNext} AST nodes.
+ */
+export declare const RNext: {
+    readonly name: "RNext";
+    /**
+     * Type guard for {@link RNext} nodes.
+     */
+    readonly is: <Info = object>(this: void, node: RNode<Info> | undefined) => node is RNext<Info>;
+};

package/r-bridge/lang-4.x/ast/model/nodes/r-next.js CHANGED Viewed

@@ -1,3 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RNext = void 0;
+const type_1 = require("../type");
+/**
+ * Helper for working with {@link RNext} AST nodes.
+ */
+exports.RNext = {
+    name: 'RNext',
+    /**
+     * Type guard for {@link RNext} nodes.
+     */
+    is(node) {
+        return node?.type === type_1.RType.Next;
+    }
+};
 //# sourceMappingURL=r-next.js.map

package/r-bridge/lang-4.x/ast/model/nodes/r-number.d.ts CHANGED Viewed

@@ -11,6 +11,12 @@ export interface RNumber<Info = NoInfo> extends Leaf<Info>, Location {
     content: RNumberValue;
 }
 /**
- * Checks whether the given node is an RNumber.
+ * Helper for working with {@link RNumber} AST nodes.
  */
-export declare function isRNumber(node: RNode | undefined): node is RNumber;
+export declare const RNumber: {
+    readonly name: "RNumber";
+    /**
+     * Type guard for {@link RNumber} nodes.
+     */
+    readonly is: <Info = object>(this: void, node: RNode<Info> | undefined) => node is RNumber<Info>;
+};

package/r-bridge/lang-4.x/ast/model/nodes/r-number.js CHANGED Viewed

@@ -1,11 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isRNumber = isRNumber;
+exports.RNumber = void 0;
 const type_1 = require("../type");
 /**
- * Checks whether the given node is an RNumber.
+ * Helper for working with {@link RNumber} AST nodes.
  */
-function isRNumber(node) {
-    return node?.type === type_1.RType.Number;
-}
+exports.RNumber = {
+    name: 'RNumber',
+    /**
+     * Type guard for {@link RNumber} nodes.
+     */
+    is(node) {
+        return node?.type === type_1.RType.Number;
+    }
+};
 //# sourceMappingURL=r-number.js.map

package/r-bridge/lang-4.x/ast/model/nodes/r-parameter.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import type { RAstNodeBase, Location, NoInfo, RNode } from '../model';
-import type { RType } from '../type';
+import { RType } from '../type';
 import type { RSymbol } from './r-symbol';
 import type { BrandedIdentifier } from '../../../../../dataflow/environments/identifier';
 /**
@@ -12,3 +12,19 @@ export interface RParameter<Info = NoInfo> extends RAstNodeBase<Info>, Location
     special: boolean;
     defaultValue: RNode<Info> | undefined;
 }
+/**
+ * Helper for working with {@link RParameter} AST nodes.
+ */
+export declare const RParameter: {
+    readonly name: "RParameter";
+    /**
+     * Type guard for {@link RParameter} nodes.
+     * @see {@link RParameter.isDotDotDotDot} - to check whether a parameter is the special `...` parameter
+     */
+    readonly is: <Info = object>(this: void, node: RNode<Info> | undefined) => node is RParameter<Info>;
+    /**
+     * Type guard for the special `...` parameter.
+     * @see {@link RParameter.is} - to check whether a node is a parameter at all
+     */
+    readonly isDotDotDotDot: <Info = object>(this: void, node: RNode<Info> | undefined) => node is RParameter<Info>;
+};

package/r-bridge/lang-4.x/ast/model/nodes/r-parameter.js CHANGED Viewed

@@ -1,3 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RParameter = void 0;
+const type_1 = require("../type");
+/**
+ * Helper for working with {@link RParameter} AST nodes.
+ */
+exports.RParameter = {
+    name: 'RParameter',
+    /**
+     * Type guard for {@link RParameter} nodes.
+     * @see {@link RParameter.isDotDotDotDot} - to check whether a parameter is the special `...` parameter
+     */
+    is(node) {
+        return node?.type === type_1.RType.Parameter;
+    },
+    /**
+     * Type guard for the special `...` parameter.
+     * @see {@link RParameter.is} - to check whether a node is a parameter at all
+     */
+    isDotDotDotDot(node) {
+        return exports.RParameter.is(node) && node.special;
+    }
+};
 //# sourceMappingURL=r-parameter.js.map

package/r-bridge/lang-4.x/ast/model/nodes/r-pipe.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 import type { RAstNodeBase, Location, NoInfo, RNode } from '../model';
-import type { RType } from '../type';
+import { RType } from '../type';
+import { SemVer } from 'semver';
 /**
  * Variant of the binary operator, specifically for the new, built-in pipe operator.
  */
@@ -8,3 +9,17 @@ export interface RPipe<Info = NoInfo> extends RAstNodeBase<Info>, Location {
     readonly lhs: RNode<Info>;
     readonly rhs: RNode<Info>;
 }
+/**
+ * Helper for working with {@link RPipe} AST nodes.
+ */
+export declare const RPipe: {
+    readonly name: "RPipe";
+    /**
+     * Type guard for {@link RPipe} nodes.
+     */
+    readonly is: <Info = object>(this: void, node: RNode<Info> | undefined) => node is RPipe<Info>;
+    /**
+     * Returns the minimum R version that supports the pipe operator.
+     */
+    readonly availableFromRVersion: (this: void) => SemVer;
+};

package/r-bridge/lang-4.x/ast/model/nodes/r-pipe.js CHANGED Viewed

@@ -1,3 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RPipe = void 0;
+const type_1 = require("../type");
+const semver_1 = require("semver");
+const versions_1 = require("../versions");
+/**
+ * Helper for working with {@link RPipe} AST nodes.
+ */
+exports.RPipe = {
+    name: 'RPipe',
+    /**
+     * Type guard for {@link RPipe} nodes.
+     */
+    is(node) {
+        return node?.type === type_1.RType.Pipe;
+    },
+    /**
+     * Returns the minimum R version that supports the pipe operator.
+     */
+    availableFromRVersion() {
+        return new semver_1.SemVer(versions_1.MIN_VERSION_PIPE);
+    },
+};
 //# sourceMappingURL=r-pipe.js.map

package/r-bridge/lang-4.x/ast/model/nodes/r-project.d.ts CHANGED Viewed

@@ -1,7 +1,10 @@
 import type { NoInfo } from '../model';
+import { RNode } from '../model';
 import { RType } from '../type';
 import type { RExpressionList } from './r-expression-list';
 import type { NodeId } from '../processing/node-id';
+import type { OnEnter, OnExit } from '../processing/visitor';
+import type { ParentInformation } from '../processing/decorate';
 /**
  * Holds a single R file starting with an expression list.
  */
@@ -11,8 +14,9 @@ export interface RProjectFile<Info = NoInfo> {
 }
 /**
  * Holds a collection of files (started with the expression list)
+ * @see {@link RProject.visitAst} - to visit all nodes in the project and related helper functions
  * @see {@link RExpressionList} - for the root of each file
- * @see {@link mergeProjects} - to merge multiple projects into a single one
+ * @see {@link RProject.merge} - to merge multiple projects into a single one
  * @see {@link RProjectFile} - for each file in the project
  */
 export interface RProject<Info = NoInfo> {
@@ -23,11 +27,44 @@ export interface RProject<Info = NoInfo> {
     };
 }
 /**
- * Type guard for RProject nodes.
+ * Helper object to identify RProject nodes by their type and to provide related functions.
+ * @see {@link RNode.visitAst} - to visit all nodes in the project
  */
-export declare function isRProject<Info = NoInfo>(node: unknown): node is RProject<Info>;
-/**
- * Merge multiple projects into a single one by concatenating their files.
- * This will remove the `info` property of the resulting project.
- */
-export declare function mergeProjects<Info = NoInfo>(projects: RProject<Info>[]): RProject<Info>;
+export declare const RProject: {
+    readonly name: "RProject";
+    /**
+     * Visits all nodes in the project by visiting the root of each file.
+     * @param project          - The project to visit file by file
+     * @param onVisit        - Called before visiting the subtree of each node. Can be used to stop visiting the subtree starting with this node (return `true` stop)
+     * @param onExit         - Called after the subtree of a node has been visited, called for leafs too (even though their subtree is empty)
+     */
+    readonly visitAst: <OtherInfo>(this: void, project: RProject<OtherInfo>, onVisit?: OnEnter<OtherInfo>, onExit?: OnExit<OtherInfo>) => void;
+    /**
+     * Collects all node ids within a project
+     * @param project - The project to collect ids from
+     * @see {@link RNode.collectAllIds} - to stop collecting at certain nodes
+     * @see {@link RProject.collectAllIdsWithStop} - to stop collecting at certain nodes
+     */
+    readonly collectAllIds: <OtherInfo>(this: void, project: RProject<OtherInfo & ParentInformation>) => Set<NodeId>;
+    /**
+     * Collects all node ids within a project, but stops collecting at nodes where the given `stop` function returns `true`.
+     * @param project - The project to collect ids from
+     * @param stop    - A function that determines whether to stop collecting at a given node, does not stop by default
+     * @see {@link RNode.collectAllIdsWithStop} - to collect all ids without stopping
+     * @see {@link RProject.collectAllIds} - to collect all ids without stopping
+     */
+    readonly collectAllIdsWithStop: <OtherInfo>(this: void, project: RProject<OtherInfo & ParentInformation>, stop: (node: RNode<OtherInfo & ParentInformation>) => boolean) => Set<NodeId>;
+    /**
+     * Flattens the project to an array of nodes by collecting the root nodes of each file.
+     */
+    readonly asNodes: <OtherInfo>(this: void, project: RProject<OtherInfo>) => RNode<OtherInfo>[];
+    /**
+     * Type guard for RProject nodes.
+     */
+    readonly is: <OtherInfo = object>(this: void, node: unknown) => node is RProject<OtherInfo>;
+    /**
+     * Merge multiple projects into a single one by concatenating their files.
+     * This will remove the `info` property of the resulting project.
+     */
+    readonly merge: <Info = object>(this: void, projects: readonly RProject<Info>[]) => RProject<Info>;
+};

package/r-bridge/lang-4.x/ast/model/nodes/r-project.js CHANGED Viewed

@@ -1,22 +1,63 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isRProject = isRProject;
-exports.mergeProjects = mergeProjects;
+exports.RProject = void 0;
+const model_1 = require("../model");
 const type_1 = require("../type");
 /**
- * Type guard for RProject nodes.
+ * Helper object to identify RProject nodes by their type and to provide related functions.
+ * @see {@link RNode.visitAst} - to visit all nodes in the project
  */
-function isRProject(node) {
-    return typeof node === 'object' && node !== null && 'type' in node && node.type === type_1.RType.Project;
-}
-/**
- * Merge multiple projects into a single one by concatenating their files.
- * This will remove the `info` property of the resulting project.
- */
-function mergeProjects(projects) {
-    return {
-        type: type_1.RType.Project,
-        files: projects.flatMap(p => p.files)
-    };
-}
+exports.RProject = {
+    name: 'RProject',
+    /**
+     * Visits all nodes in the project by visiting the root of each file.
+     * @param project          - The project to visit file by file
+     * @param onVisit        - Called before visiting the subtree of each node. Can be used to stop visiting the subtree starting with this node (return `true` stop)
+     * @param onExit         - Called after the subtree of a node has been visited, called for leafs too (even though their subtree is empty)
+     */
+    visitAst(project, onVisit, onExit) {
+        return model_1.RNode.visitAst(project.files.map(f => f.root), onVisit, onExit);
+    },
+    /**
+     * Collects all node ids within a project
+     * @param project - The project to collect ids from
+     * @see {@link RNode.collectAllIds} - to stop collecting at certain nodes
+     * @see {@link RProject.collectAllIdsWithStop} - to stop collecting at certain nodes
+     */
+    collectAllIds(project) {
+        return model_1.RNode.collectAllIds(exports.RProject.asNodes(project));
+    },
+    /**
+     * Collects all node ids within a project, but stops collecting at nodes where the given `stop` function returns `true`.
+     * @param project - The project to collect ids from
+     * @param stop    - A function that determines whether to stop collecting at a given node, does not stop by default
+     * @see {@link RNode.collectAllIdsWithStop} - to collect all ids without stopping
+     * @see {@link RProject.collectAllIds} - to collect all ids without stopping
+     */
+    collectAllIdsWithStop(project, stop) {
+        return model_1.RNode.collectAllIdsWithStop(exports.RProject.asNodes(project), stop);
+    },
+    /**
+     * Flattens the project to an array of nodes by collecting the root nodes of each file.
+     */
+    asNodes(project) {
+        return project.files.map(f => f.root);
+    },
+    /**
+     * Type guard for RProject nodes.
+     */
+    is(node) {
+        return typeof node === 'object' && node !== null && 'type' in node && node.type === type_1.RType.Project;
+    },
+    /**
+     * Merge multiple projects into a single one by concatenating their files.
+     * This will remove the `info` property of the resulting project.
+     */
+    merge(projects) {
+        return {
+            type: type_1.RType.Project,
+            files: projects.flatMap(p => p.files)
+        };
+    }
+};
 //# sourceMappingURL=r-project.js.map