Optional ReadonlyabstractInterpretation?: {Configuration options for abstract interpretation
Optional ReadonlydataFrame?: {The configuration of the shape inference for data frames
Optional ReadonlymaxColNames?: numberThe maximum number of columns names to infer for data frames before over-approximating the column names to top
Optional ReadonlyreadLoadedData?: { maxReadLines?: number; readExternalFiles?: boolean }Configuration options for reading data frame shapes from loaded external data files, such as CSV files
Optional ReadonlymaxReadLines?: numberThe maximum number of lines to read when extracting data frame shapes from loaded files, such as CSV files
Optional ReadonlyreadExternalFiles?: booleanWhether data frame shapes should be extracted from loaded external data files, such as CSV files
Optional ReadonlywideningThreshold?: numberThe threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (string | [string?, unknown[]?] | undefined)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: {Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: { [key: string]: number | undefined }Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: () => GasHeapStatistics | undefinedCustom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: {Shared thresholds scaled by each feature factor before comparison.
Optional Readonlymemory?: { critical?: number; problematic?: number; [key: string]: unknown }Heap-usage fraction thresholds (0-1, before factor scaling).
Optional Readonlycritical?: numberReturns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: numberReturns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlytimeMs?: { critical?: number; problematic?: number; [key: string]: unknown }Elapsed analysis time thresholds in milliseconds (before factor scaling).
Optional Readonlycritical?: numberReturns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: numberReturns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlylinter?: { disabledRules?: (string | undefined)[] }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: (string | undefined)[]Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: (string | undefined)[]The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: (string | undefined)[]Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: booleanWhether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ProjectKindOverwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: booleanAutomatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: booleanThis instruments the dataflow processors to count how often each processor is called
Optionalhints?: booleanWhether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: (string | [string?, unknown[]?] | undefined)[]Plugins to load in REPL mode
OptionalqueryStats?: booleanWhether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: booleanWhether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: booleanWhether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: {Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: {Semantics regarding the handling of the environment
Optional ReadonlyoverwriteBuiltIns?: {Do you want to overwrite (parts) of the builtin definition?
Optional Readonlydefinitions?: (The definitions to load
Optional ReadonlyloadDefaults?: booleanShould the default configuration still be loaded?
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: booleanShould we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: {These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
OptionaldataflowExtractors?: (Modify the dataflow processors used during dataflow analysis. Make sure that all processors required for correct analysis are still present! This may have arbitrary consequences on the analysis precision and performance, consider focusing on decorating existing processors instead of replacing them.
Optional ReadonlyresolveSource?: {If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional ReadonlyapplyReplacements?: ({ [key: string]: string | undefined } | undefined)[]sometimes files may have a different name in the source call (e.g., due to later replacements), with this setting you can provide a list of replacements to apply for each sourced file. Every replacement consists of a record that maps a regex to a replacement string.
[
{ }, // no replacement -> still try the original name/path
{ '.*\\.R$': 'main.R' }, // replace all .R files with main.R
{ '\s' : '_' }, // replace all spaces with underscores
{ '\s' : '-', 'oo': 'aa' }, // replace all spaces with dashes and oo with aa
]
Given a source("foo bar.R") this configuration will search for (in this order):
foo bar.R (original name)main.R (replaced with main.R)foo_bar.R (replaced spaces)faa-bar.R (replaced spaces and oo)Optional ReadonlyassumeFilesExist?: booleanAssume a sourced file is always there, making what it defines certain instead of conditional on the source call.
Optional ReadonlydropPaths?: DropPathsOptionAllow to drop the first or all parts of the sourced path, if it is relative.
Optional ReadonlyignoreCapitalization?: booleansearch for filenames matching in the lowercase
Optional ReadonlyinferWorkingDirectory?: InferWorkingDirectorytry to infer the working directory from the main or any script to analyze.
Optional ReadonlyrepeatedSourceLimit?: numberHow often the same file can be sourced within a single run? Please be aware: in case of cyclic sources this may not reach a fixpoint so give this a sensible limit.
Optional ReadonlysearchPath?: (string | undefined)[]Additionally search in these paths
Optional Readonlysigdb?: {Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optional ReadonlyadditionalPaths?: (string | undefined)[]Extra directories (or bundle/manifest files) searched for signature databases, alongside the shipped default and $FLOWR_SIGDB_DIR. A downloaded full-history bundle placed here is mounted automatically.
Optional ReadonlyassumedRVersion?: stringThe R version analysis assumes when resolving versioned (base-R) package exports: a pin like "4.5",
or "auto" to detect the locally installed R (falling back to DefaultAssumedRVersion when the
engine reports none, e.g. the tree-sitter engine). Resolve it with resolveAssumedRVersion.
Optional ReadonlyautoSync?: booleanOn startup, compare the cache against the committed sigdb.remote.json link file and re-download changed shards in the background (default false; needs network, so opt-in — a git pull that updates the pointer then re-syncs automatically).
Optional ReadonlydownloadRepo?: stringGitHub owner/repo the full-history bundle is downloaded from (:signature download); default flowr-analysis/flowr, release tag sigdb-v<flowR-version>.
Optional ReadonlyeagerlyLoad?: booleanParse the database up front rather than on the first package load (default false, ignored if disabled).
Optional ReadonlyeagerlyLoadExports?: booleanAdd a vertex for every export on load rather than on demand (default false); keeps the graph small.
Optional Readonlyenabled?: booleanResolve library exports from a signature database (default true); when false no database is consulted.
Optional ReadonlylinkBaseR?: booleanEagerly attach base-R namespaces (from a signature database) so bare base calls resolve without library() (default false; changes every analysis; needs a base-R signature database).
Optional ReadonlylinkBaseRCalls?: booleanAdd a lightweight Reads edge from a bare base-R call to its signature-database function vertex (built-in:pkg:fn); base-R qualification stays edge-free unless this is on (default false; adds edges to every base call).
Optional ReadonlylinkDescriptionDependencies?: booleanEagerly attach the namespaces of the project's declared DESCRIPTION dependencies (Imports/Depends) so their exports resolve without an explicit library() (default false; changes every analysis; needs a signature database resolving the declared packages).
Optional ReadonlylinkPackageCalls?: booleanAdd a lightweight Reads edge from a resolved package call (pkg::fn/attached export) to its signature-database function vertex (default false).
Optional ReadonlyloadProjectDependencies?: booleanLoad the project's declared dependencies from its metadata files (DESCRIPTION Imports/Depends, rproject.toml, renv.lock, rv.lock) into the dependency context (default true); when false these files are not read, so neither the undefined-symbol linter nor linkDescriptionDependencies sees any project-declared dependency.
Optional ReadonlyversionOverrides?: { [key: string]: string | undefined }Force an exact version for specific packages (mapping a package name to a version), overriding both the project constraint and the versionSelection policy; a version missing from the database falls back with a warning (default {}).
Optional ReadonlyversionSelection?: VersionSelectionWhen a project constrains a dependency, resolve to the newest (default) or oldest version satisfying the constraint, or the system-installed version (needs R; falls back to newest when unavailable). Base-R packages always resolve against the assumed R version.
Optional ReadonlywarmInBackground?: booleanDecompress the hot shards (base + most-downloaded) in a background task on startup, so the first library() lookup is warm (default false; useful for long-running servers/REPLs, not one-shot runs).
Optionalslicer?: { autoExtend?: boolean; threshold?: number }The configuration for flowR's slicer
Optional ReadonlyautoExtend?: booleanIf set, the slicer will gain an additional post-pass
Optional Readonlythreshold?: numberThe maximum number of iterations to perform on a single function call during slicing
Optional ReadonlytrackEnvironments?: booleanTrack user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: VariableResolveHow to resolve variables and their values
Optional ReadonlyversionManagement?: { linkedVersionGroups?: ((string | undefined)[] | undefined)[] }Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlylinkedVersionGroups?: ((string | undefined)[] | undefined)[]Groups of packages that must resolve to the same version (like the base packages, which share the R version); version guessing intersects each group so its members stay mutually compatible (default []).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalnotebook?: {Optional ReadonlyabstractInterpretation?: {Configuration options for abstract interpretation
Optional ReadonlydataFrame?: {The configuration of the shape inference for data frames
Optional ReadonlymaxColNames?: numberThe maximum number of columns names to infer for data frames before over-approximating the column names to top
Optional ReadonlyreadLoadedData?: { maxReadLines?: ...; readExternalFiles?: ... }Configuration options for reading data frame shapes from loaded external data files, such as CSV files
Optional ReadonlymaxReadLines?: ...The maximum number of lines to read when extracting data frame shapes from loaded files, such as CSV files
Optional ReadonlyreadExternalFiles?: ...Whether data frame shapes should be extracted from loaded external data files, such as CSV files
Optional ReadonlywideningThreshold?: numberThe threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (string | [string?, (...)[]?] | undefined)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: {Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: { [key: string]: number | undefined }Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: () => GasHeapStatistics | undefinedCustom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: {Shared thresholds scaled by each feature factor before comparison.
Optional Readonlymemory?: { critical?: ...; problematic?: ...; [key: ...]: ... }Heap-usage fraction thresholds (0-1, before factor scaling).
Optional Readonlycritical?: ...Returns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: ...Returns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlytimeMs?: { critical?: ...; problematic?: ...; [key: ...]: ... }Elapsed analysis time thresholds in milliseconds (before factor scaling).
Optional Readonlycritical?: ...Returns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: ...Returns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: (string | undefined)[] }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: (string | undefined)[]Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: (string | undefined)[]The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: (string | undefined)[]Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: booleanWhether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ProjectKindOverwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: booleanAutomatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: booleanThis instruments the dataflow processors to count how often each processor is called
Optionalhints?: booleanWhether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: (string | [(...)?, (...)?] | undefined)[]Plugins to load in REPL mode
OptionalqueryStats?: booleanWhether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: booleanWhether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: booleanWhether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: {Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: { overwriteBuiltIns?: { definitions?: ...; loadDefaults?: ... } }Semantics regarding the handling of the environment
Optional ReadonlyoverwriteBuiltIns?: { definitions?: ...; loadDefaults?: ... }Do you want to overwrite (parts) of the builtin definition?
Optional Readonlydefinitions?: ...The definitions to load
Optional ReadonlyloadDefaults?: ...Should the default configuration still be loaded?
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: booleanShould we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: { dataflowExtractors?: (extractor: ..., ctx: ...) => ... }These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
OptionaldataflowExtractors?: (extractor: ..., ctx: ...) => ...Modify the dataflow processors used during dataflow analysis. Make sure that all processors required for correct analysis are still present! This may have arbitrary consequences on the analysis precision and performance, consider focusing on decorating existing processors instead of replacing them.
Optional ReadonlyresolveSource?: {If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional ReadonlyapplyReplacements?: (...)[]sometimes files may have a different name in the source call (e.g., due to later replacements), with this setting you can provide a list of replacements to apply for each sourced file. Every replacement consists of a record that maps a regex to a replacement string.
[
{ }, // no replacement -> still try the original name/path
{ '.*\\.R$': 'main.R' }, // replace all .R files with main.R
{ '\s' : '_' }, // replace all spaces with underscores
{ '\s' : '-', 'oo': 'aa' }, // replace all spaces with dashes and oo with aa
]
Given a source("foo bar.R") this configuration will search for (in this order):
foo bar.R (original name)main.R (replaced with main.R)foo_bar.R (replaced spaces)faa-bar.R (replaced spaces and oo)Optional ReadonlyassumeFilesExist?: booleanAssume a sourced file is always there, making what it defines certain instead of conditional on the source call.
Optional ReadonlydropPaths?: DropPathsOptionAllow to drop the first or all parts of the sourced path, if it is relative.
Optional ReadonlyignoreCapitalization?: booleansearch for filenames matching in the lowercase
Optional ReadonlyinferWorkingDirectory?: InferWorkingDirectorytry to infer the working directory from the main or any script to analyze.
Optional ReadonlyrepeatedSourceLimit?: numberHow often the same file can be sourced within a single run? Please be aware: in case of cyclic sources this may not reach a fixpoint so give this a sensible limit.
Optional ReadonlysearchPath?: (...)[]Additionally search in these paths
Optional Readonlysigdb?: {Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optional ReadonlyadditionalPaths?: (...)[]Extra directories (or bundle/manifest files) searched for signature databases, alongside the shipped default and $FLOWR_SIGDB_DIR. A downloaded full-history bundle placed here is mounted automatically.
Optional ReadonlyassumedRVersion?: stringThe R version analysis assumes when resolving versioned (base-R) package exports: a pin like "4.5",
or "auto" to detect the locally installed R (falling back to DefaultAssumedRVersion when the
engine reports none, e.g. the tree-sitter engine). Resolve it with resolveAssumedRVersion.
Optional ReadonlyautoSync?: booleanOn startup, compare the cache against the committed sigdb.remote.json link file and re-download changed shards in the background (default false; needs network, so opt-in — a git pull that updates the pointer then re-syncs automatically).
Optional ReadonlydownloadRepo?: stringGitHub owner/repo the full-history bundle is downloaded from (:signature download); default flowr-analysis/flowr, release tag sigdb-v<flowR-version>.
Optional ReadonlyeagerlyLoad?: booleanParse the database up front rather than on the first package load (default false, ignored if disabled).
Optional ReadonlyeagerlyLoadExports?: booleanAdd a vertex for every export on load rather than on demand (default false); keeps the graph small.
Optional Readonlyenabled?: booleanResolve library exports from a signature database (default true); when false no database is consulted.
Optional ReadonlylinkBaseR?: booleanEagerly attach base-R namespaces (from a signature database) so bare base calls resolve without library() (default false; changes every analysis; needs a base-R signature database).
Optional ReadonlylinkBaseRCalls?: booleanAdd a lightweight Reads edge from a bare base-R call to its signature-database function vertex (built-in:pkg:fn); base-R qualification stays edge-free unless this is on (default false; adds edges to every base call).
Optional ReadonlylinkDescriptionDependencies?: booleanEagerly attach the namespaces of the project's declared DESCRIPTION dependencies (Imports/Depends) so their exports resolve without an explicit library() (default false; changes every analysis; needs a signature database resolving the declared packages).
Optional ReadonlylinkPackageCalls?: booleanAdd a lightweight Reads edge from a resolved package call (pkg::fn/attached export) to its signature-database function vertex (default false).
Optional ReadonlyloadProjectDependencies?: booleanLoad the project's declared dependencies from its metadata files (DESCRIPTION Imports/Depends, rproject.toml, renv.lock, rv.lock) into the dependency context (default true); when false these files are not read, so neither the undefined-symbol linter nor linkDescriptionDependencies sees any project-declared dependency.
Optional ReadonlyversionOverrides?: { [key: ...]: ... }Force an exact version for specific packages (mapping a package name to a version), overriding both the project constraint and the versionSelection policy; a version missing from the database falls back with a warning (default {}).
Optional ReadonlyversionSelection?: VersionSelectionWhen a project constrains a dependency, resolve to the newest (default) or oldest version satisfying the constraint, or the system-installed version (needs R; falls back to newest when unavailable). Base-R packages always resolve against the assumed R version.
Optional ReadonlywarmInBackground?: booleanDecompress the hot shards (base + most-downloaded) in a background task on startup, so the first library() lookup is warm (default false; useful for long-running servers/REPLs, not one-shot runs).
Optionalslicer?: { autoExtend?: boolean; threshold?: number }The configuration for flowR's slicer
Optional ReadonlyautoExtend?: booleanIf set, the slicer will gain an additional post-pass
Optional Readonlythreshold?: numberThe maximum number of iterations to perform on a single function call during slicing
Optional ReadonlytrackEnvironments?: booleanTrack user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: VariableResolveHow to resolve variables and their values
Optional ReadonlyversionManagement?: { linkedVersionGroups?: (...)[] }Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlylinkedVersionGroups?: (...)[]Groups of packages that must resolve to the same version (like the base packages, which share the R version); version guessing intersects each group so its members stay mutually compatible (default []).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalnotebook?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalpackage?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalproject?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalscript?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalshiny-app?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalunknown?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalpackage?: {Optional ReadonlyabstractInterpretation?: {Configuration options for abstract interpretation
Optional ReadonlydataFrame?: {The configuration of the shape inference for data frames
Optional ReadonlymaxColNames?: numberThe maximum number of columns names to infer for data frames before over-approximating the column names to top
Optional ReadonlyreadLoadedData?: { maxReadLines?: ...; readExternalFiles?: ... }Configuration options for reading data frame shapes from loaded external data files, such as CSV files
Optional ReadonlymaxReadLines?: ...The maximum number of lines to read when extracting data frame shapes from loaded files, such as CSV files
Optional ReadonlyreadExternalFiles?: ...Whether data frame shapes should be extracted from loaded external data files, such as CSV files
Optional ReadonlywideningThreshold?: numberThe threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (string | [string?, (...)[]?] | undefined)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: {Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: { [key: string]: number | undefined }Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: () => GasHeapStatistics | undefinedCustom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: {Shared thresholds scaled by each feature factor before comparison.
Optional Readonlymemory?: { critical?: ...; problematic?: ...; [key: ...]: ... }Heap-usage fraction thresholds (0-1, before factor scaling).
Optional Readonlycritical?: ...Returns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: ...Returns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlytimeMs?: { critical?: ...; problematic?: ...; [key: ...]: ... }Elapsed analysis time thresholds in milliseconds (before factor scaling).
Optional Readonlycritical?: ...Returns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: ...Returns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: (string | undefined)[] }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: (string | undefined)[]Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: (string | undefined)[]The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: (string | undefined)[]Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: booleanWhether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ProjectKindOverwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: booleanAutomatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: booleanThis instruments the dataflow processors to count how often each processor is called
Optionalhints?: booleanWhether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: (string | [(...)?, (...)?] | undefined)[]Plugins to load in REPL mode
OptionalqueryStats?: booleanWhether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: booleanWhether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: booleanWhether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: {Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: { overwriteBuiltIns?: { definitions?: ...; loadDefaults?: ... } }Semantics regarding the handling of the environment
Optional ReadonlyoverwriteBuiltIns?: { definitions?: ...; loadDefaults?: ... }Do you want to overwrite (parts) of the builtin definition?
Optional Readonlydefinitions?: ...The definitions to load
Optional ReadonlyloadDefaults?: ...Should the default configuration still be loaded?
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: booleanShould we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: { dataflowExtractors?: (extractor: ..., ctx: ...) => ... }These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
OptionaldataflowExtractors?: (extractor: ..., ctx: ...) => ...Modify the dataflow processors used during dataflow analysis. Make sure that all processors required for correct analysis are still present! This may have arbitrary consequences on the analysis precision and performance, consider focusing on decorating existing processors instead of replacing them.
Optional ReadonlyresolveSource?: {If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional ReadonlyapplyReplacements?: (...)[]sometimes files may have a different name in the source call (e.g., due to later replacements), with this setting you can provide a list of replacements to apply for each sourced file. Every replacement consists of a record that maps a regex to a replacement string.
[
{ }, // no replacement -> still try the original name/path
{ '.*\\.R$': 'main.R' }, // replace all .R files with main.R
{ '\s' : '_' }, // replace all spaces with underscores
{ '\s' : '-', 'oo': 'aa' }, // replace all spaces with dashes and oo with aa
]
Given a source("foo bar.R") this configuration will search for (in this order):
foo bar.R (original name)main.R (replaced with main.R)foo_bar.R (replaced spaces)faa-bar.R (replaced spaces and oo)Optional ReadonlyassumeFilesExist?: booleanAssume a sourced file is always there, making what it defines certain instead of conditional on the source call.
Optional ReadonlydropPaths?: DropPathsOptionAllow to drop the first or all parts of the sourced path, if it is relative.
Optional ReadonlyignoreCapitalization?: booleansearch for filenames matching in the lowercase
Optional ReadonlyinferWorkingDirectory?: InferWorkingDirectorytry to infer the working directory from the main or any script to analyze.
Optional ReadonlyrepeatedSourceLimit?: numberHow often the same file can be sourced within a single run? Please be aware: in case of cyclic sources this may not reach a fixpoint so give this a sensible limit.
Optional ReadonlysearchPath?: (...)[]Additionally search in these paths
Optional Readonlysigdb?: {Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optional ReadonlyadditionalPaths?: (...)[]Extra directories (or bundle/manifest files) searched for signature databases, alongside the shipped default and $FLOWR_SIGDB_DIR. A downloaded full-history bundle placed here is mounted automatically.
Optional ReadonlyassumedRVersion?: stringThe R version analysis assumes when resolving versioned (base-R) package exports: a pin like "4.5",
or "auto" to detect the locally installed R (falling back to DefaultAssumedRVersion when the
engine reports none, e.g. the tree-sitter engine). Resolve it with resolveAssumedRVersion.
Optional ReadonlyautoSync?: booleanOn startup, compare the cache against the committed sigdb.remote.json link file and re-download changed shards in the background (default false; needs network, so opt-in — a git pull that updates the pointer then re-syncs automatically).
Optional ReadonlydownloadRepo?: stringGitHub owner/repo the full-history bundle is downloaded from (:signature download); default flowr-analysis/flowr, release tag sigdb-v<flowR-version>.
Optional ReadonlyeagerlyLoad?: booleanParse the database up front rather than on the first package load (default false, ignored if disabled).
Optional ReadonlyeagerlyLoadExports?: booleanAdd a vertex for every export on load rather than on demand (default false); keeps the graph small.
Optional Readonlyenabled?: booleanResolve library exports from a signature database (default true); when false no database is consulted.
Optional ReadonlylinkBaseR?: booleanEagerly attach base-R namespaces (from a signature database) so bare base calls resolve without library() (default false; changes every analysis; needs a base-R signature database).
Optional ReadonlylinkBaseRCalls?: booleanAdd a lightweight Reads edge from a bare base-R call to its signature-database function vertex (built-in:pkg:fn); base-R qualification stays edge-free unless this is on (default false; adds edges to every base call).
Optional ReadonlylinkDescriptionDependencies?: booleanEagerly attach the namespaces of the project's declared DESCRIPTION dependencies (Imports/Depends) so their exports resolve without an explicit library() (default false; changes every analysis; needs a signature database resolving the declared packages).
Optional ReadonlylinkPackageCalls?: booleanAdd a lightweight Reads edge from a resolved package call (pkg::fn/attached export) to its signature-database function vertex (default false).
Optional ReadonlyloadProjectDependencies?: booleanLoad the project's declared dependencies from its metadata files (DESCRIPTION Imports/Depends, rproject.toml, renv.lock, rv.lock) into the dependency context (default true); when false these files are not read, so neither the undefined-symbol linter nor linkDescriptionDependencies sees any project-declared dependency.
Optional ReadonlyversionOverrides?: { [key: ...]: ... }Force an exact version for specific packages (mapping a package name to a version), overriding both the project constraint and the versionSelection policy; a version missing from the database falls back with a warning (default {}).
Optional ReadonlyversionSelection?: VersionSelectionWhen a project constrains a dependency, resolve to the newest (default) or oldest version satisfying the constraint, or the system-installed version (needs R; falls back to newest when unavailable). Base-R packages always resolve against the assumed R version.
Optional ReadonlywarmInBackground?: booleanDecompress the hot shards (base + most-downloaded) in a background task on startup, so the first library() lookup is warm (default false; useful for long-running servers/REPLs, not one-shot runs).
Optionalslicer?: { autoExtend?: boolean; threshold?: number }The configuration for flowR's slicer
Optional ReadonlyautoExtend?: booleanIf set, the slicer will gain an additional post-pass
Optional Readonlythreshold?: numberThe maximum number of iterations to perform on a single function call during slicing
Optional ReadonlytrackEnvironments?: booleanTrack user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: VariableResolveHow to resolve variables and their values
Optional ReadonlyversionManagement?: { linkedVersionGroups?: (...)[] }Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlylinkedVersionGroups?: (...)[]Groups of packages that must resolve to the same version (like the base packages, which share the R version); version guessing intersects each group so its members stay mutually compatible (default []).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalnotebook?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalpackage?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalproject?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalscript?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalshiny-app?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalunknown?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalproject?: {Optional ReadonlyabstractInterpretation?: {Configuration options for abstract interpretation
Optional ReadonlydataFrame?: {The configuration of the shape inference for data frames
Optional ReadonlymaxColNames?: numberThe maximum number of columns names to infer for data frames before over-approximating the column names to top
Optional ReadonlyreadLoadedData?: { maxReadLines?: ...; readExternalFiles?: ... }Configuration options for reading data frame shapes from loaded external data files, such as CSV files
Optional ReadonlymaxReadLines?: ...The maximum number of lines to read when extracting data frame shapes from loaded files, such as CSV files
Optional ReadonlyreadExternalFiles?: ...Whether data frame shapes should be extracted from loaded external data files, such as CSV files
Optional ReadonlywideningThreshold?: numberThe threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (string | [string?, (...)[]?] | undefined)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: {Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: { [key: string]: number | undefined }Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: () => GasHeapStatistics | undefinedCustom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: {Shared thresholds scaled by each feature factor before comparison.
Optional Readonlymemory?: { critical?: ...; problematic?: ...; [key: ...]: ... }Heap-usage fraction thresholds (0-1, before factor scaling).
Optional Readonlycritical?: ...Returns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: ...Returns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlytimeMs?: { critical?: ...; problematic?: ...; [key: ...]: ... }Elapsed analysis time thresholds in milliseconds (before factor scaling).
Optional Readonlycritical?: ...Returns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: ...Returns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: (string | undefined)[] }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: (string | undefined)[]Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: (string | undefined)[]The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: (string | undefined)[]Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: booleanWhether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ProjectKindOverwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: booleanAutomatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: booleanThis instruments the dataflow processors to count how often each processor is called
Optionalhints?: booleanWhether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: (string | [(...)?, (...)?] | undefined)[]Plugins to load in REPL mode
OptionalqueryStats?: booleanWhether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: booleanWhether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: booleanWhether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: {Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: { overwriteBuiltIns?: { definitions?: ...; loadDefaults?: ... } }Semantics regarding the handling of the environment
Optional ReadonlyoverwriteBuiltIns?: { definitions?: ...; loadDefaults?: ... }Do you want to overwrite (parts) of the builtin definition?
Optional Readonlydefinitions?: ...The definitions to load
Optional ReadonlyloadDefaults?: ...Should the default configuration still be loaded?
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: booleanShould we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: { dataflowExtractors?: (extractor: ..., ctx: ...) => ... }These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
OptionaldataflowExtractors?: (extractor: ..., ctx: ...) => ...Modify the dataflow processors used during dataflow analysis. Make sure that all processors required for correct analysis are still present! This may have arbitrary consequences on the analysis precision and performance, consider focusing on decorating existing processors instead of replacing them.
Optional ReadonlyresolveSource?: {If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional ReadonlyapplyReplacements?: (...)[]sometimes files may have a different name in the source call (e.g., due to later replacements), with this setting you can provide a list of replacements to apply for each sourced file. Every replacement consists of a record that maps a regex to a replacement string.
[
{ }, // no replacement -> still try the original name/path
{ '.*\\.R$': 'main.R' }, // replace all .R files with main.R
{ '\s' : '_' }, // replace all spaces with underscores
{ '\s' : '-', 'oo': 'aa' }, // replace all spaces with dashes and oo with aa
]
Given a source("foo bar.R") this configuration will search for (in this order):
foo bar.R (original name)main.R (replaced with main.R)foo_bar.R (replaced spaces)faa-bar.R (replaced spaces and oo)Optional ReadonlyassumeFilesExist?: booleanAssume a sourced file is always there, making what it defines certain instead of conditional on the source call.
Optional ReadonlydropPaths?: DropPathsOptionAllow to drop the first or all parts of the sourced path, if it is relative.
Optional ReadonlyignoreCapitalization?: booleansearch for filenames matching in the lowercase
Optional ReadonlyinferWorkingDirectory?: InferWorkingDirectorytry to infer the working directory from the main or any script to analyze.
Optional ReadonlyrepeatedSourceLimit?: numberHow often the same file can be sourced within a single run? Please be aware: in case of cyclic sources this may not reach a fixpoint so give this a sensible limit.
Optional ReadonlysearchPath?: (...)[]Additionally search in these paths
Optional Readonlysigdb?: {Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optional ReadonlyadditionalPaths?: (...)[]Extra directories (or bundle/manifest files) searched for signature databases, alongside the shipped default and $FLOWR_SIGDB_DIR. A downloaded full-history bundle placed here is mounted automatically.
Optional ReadonlyassumedRVersion?: stringThe R version analysis assumes when resolving versioned (base-R) package exports: a pin like "4.5",
or "auto" to detect the locally installed R (falling back to DefaultAssumedRVersion when the
engine reports none, e.g. the tree-sitter engine). Resolve it with resolveAssumedRVersion.
Optional ReadonlyautoSync?: booleanOn startup, compare the cache against the committed sigdb.remote.json link file and re-download changed shards in the background (default false; needs network, so opt-in — a git pull that updates the pointer then re-syncs automatically).
Optional ReadonlydownloadRepo?: stringGitHub owner/repo the full-history bundle is downloaded from (:signature download); default flowr-analysis/flowr, release tag sigdb-v<flowR-version>.
Optional ReadonlyeagerlyLoad?: booleanParse the database up front rather than on the first package load (default false, ignored if disabled).
Optional ReadonlyeagerlyLoadExports?: booleanAdd a vertex for every export on load rather than on demand (default false); keeps the graph small.
Optional Readonlyenabled?: booleanResolve library exports from a signature database (default true); when false no database is consulted.
Optional ReadonlylinkBaseR?: booleanEagerly attach base-R namespaces (from a signature database) so bare base calls resolve without library() (default false; changes every analysis; needs a base-R signature database).
Optional ReadonlylinkBaseRCalls?: booleanAdd a lightweight Reads edge from a bare base-R call to its signature-database function vertex (built-in:pkg:fn); base-R qualification stays edge-free unless this is on (default false; adds edges to every base call).
Optional ReadonlylinkDescriptionDependencies?: booleanEagerly attach the namespaces of the project's declared DESCRIPTION dependencies (Imports/Depends) so their exports resolve without an explicit library() (default false; changes every analysis; needs a signature database resolving the declared packages).
Optional ReadonlylinkPackageCalls?: booleanAdd a lightweight Reads edge from a resolved package call (pkg::fn/attached export) to its signature-database function vertex (default false).
Optional ReadonlyloadProjectDependencies?: booleanLoad the project's declared dependencies from its metadata files (DESCRIPTION Imports/Depends, rproject.toml, renv.lock, rv.lock) into the dependency context (default true); when false these files are not read, so neither the undefined-symbol linter nor linkDescriptionDependencies sees any project-declared dependency.
Optional ReadonlyversionOverrides?: { [key: ...]: ... }Force an exact version for specific packages (mapping a package name to a version), overriding both the project constraint and the versionSelection policy; a version missing from the database falls back with a warning (default {}).
Optional ReadonlyversionSelection?: VersionSelectionWhen a project constrains a dependency, resolve to the newest (default) or oldest version satisfying the constraint, or the system-installed version (needs R; falls back to newest when unavailable). Base-R packages always resolve against the assumed R version.
Optional ReadonlywarmInBackground?: booleanDecompress the hot shards (base + most-downloaded) in a background task on startup, so the first library() lookup is warm (default false; useful for long-running servers/REPLs, not one-shot runs).
Optionalslicer?: { autoExtend?: boolean; threshold?: number }The configuration for flowR's slicer
Optional ReadonlyautoExtend?: booleanIf set, the slicer will gain an additional post-pass
Optional Readonlythreshold?: numberThe maximum number of iterations to perform on a single function call during slicing
Optional ReadonlytrackEnvironments?: booleanTrack user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: VariableResolveHow to resolve variables and their values
Optional ReadonlyversionManagement?: { linkedVersionGroups?: (...)[] }Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlylinkedVersionGroups?: (...)[]Groups of packages that must resolve to the same version (like the base packages, which share the R version); version guessing intersects each group so its members stay mutually compatible (default []).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalnotebook?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalpackage?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalproject?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalscript?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalshiny-app?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalunknown?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalscript?: {Optional ReadonlyabstractInterpretation?: {Configuration options for abstract interpretation
Optional ReadonlydataFrame?: {The configuration of the shape inference for data frames
Optional ReadonlymaxColNames?: numberThe maximum number of columns names to infer for data frames before over-approximating the column names to top
Optional ReadonlyreadLoadedData?: { maxReadLines?: ...; readExternalFiles?: ... }Configuration options for reading data frame shapes from loaded external data files, such as CSV files
Optional ReadonlymaxReadLines?: ...The maximum number of lines to read when extracting data frame shapes from loaded files, such as CSV files
Optional ReadonlyreadExternalFiles?: ...Whether data frame shapes should be extracted from loaded external data files, such as CSV files
Optional ReadonlywideningThreshold?: numberThe threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (string | [string?, (...)[]?] | undefined)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: {Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: { [key: string]: number | undefined }Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: () => GasHeapStatistics | undefinedCustom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: {Shared thresholds scaled by each feature factor before comparison.
Optional Readonlymemory?: { critical?: ...; problematic?: ...; [key: ...]: ... }Heap-usage fraction thresholds (0-1, before factor scaling).
Optional Readonlycritical?: ...Returns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: ...Returns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlytimeMs?: { critical?: ...; problematic?: ...; [key: ...]: ... }Elapsed analysis time thresholds in milliseconds (before factor scaling).
Optional Readonlycritical?: ...Returns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: ...Returns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: (string | undefined)[] }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: (string | undefined)[]Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: (string | undefined)[]The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: (string | undefined)[]Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: booleanWhether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ProjectKindOverwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: booleanAutomatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: booleanThis instruments the dataflow processors to count how often each processor is called
Optionalhints?: booleanWhether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: (string | [(...)?, (...)?] | undefined)[]Plugins to load in REPL mode
OptionalqueryStats?: booleanWhether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: booleanWhether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: booleanWhether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: {Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: { overwriteBuiltIns?: { definitions?: ...; loadDefaults?: ... } }Semantics regarding the handling of the environment
Optional ReadonlyoverwriteBuiltIns?: { definitions?: ...; loadDefaults?: ... }Do you want to overwrite (parts) of the builtin definition?
Optional Readonlydefinitions?: ...The definitions to load
Optional ReadonlyloadDefaults?: ...Should the default configuration still be loaded?
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: booleanShould we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: { dataflowExtractors?: (extractor: ..., ctx: ...) => ... }These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
OptionaldataflowExtractors?: (extractor: ..., ctx: ...) => ...Modify the dataflow processors used during dataflow analysis. Make sure that all processors required for correct analysis are still present! This may have arbitrary consequences on the analysis precision and performance, consider focusing on decorating existing processors instead of replacing them.
Optional ReadonlyresolveSource?: {If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional ReadonlyapplyReplacements?: (...)[]sometimes files may have a different name in the source call (e.g., due to later replacements), with this setting you can provide a list of replacements to apply for each sourced file. Every replacement consists of a record that maps a regex to a replacement string.
[
{ }, // no replacement -> still try the original name/path
{ '.*\\.R$': 'main.R' }, // replace all .R files with main.R
{ '\s' : '_' }, // replace all spaces with underscores
{ '\s' : '-', 'oo': 'aa' }, // replace all spaces with dashes and oo with aa
]
Given a source("foo bar.R") this configuration will search for (in this order):
foo bar.R (original name)main.R (replaced with main.R)foo_bar.R (replaced spaces)faa-bar.R (replaced spaces and oo)Optional ReadonlyassumeFilesExist?: booleanAssume a sourced file is always there, making what it defines certain instead of conditional on the source call.
Optional ReadonlydropPaths?: DropPathsOptionAllow to drop the first or all parts of the sourced path, if it is relative.
Optional ReadonlyignoreCapitalization?: booleansearch for filenames matching in the lowercase
Optional ReadonlyinferWorkingDirectory?: InferWorkingDirectorytry to infer the working directory from the main or any script to analyze.
Optional ReadonlyrepeatedSourceLimit?: numberHow often the same file can be sourced within a single run? Please be aware: in case of cyclic sources this may not reach a fixpoint so give this a sensible limit.
Optional ReadonlysearchPath?: (...)[]Additionally search in these paths
Optional Readonlysigdb?: {Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optional ReadonlyadditionalPaths?: (...)[]Extra directories (or bundle/manifest files) searched for signature databases, alongside the shipped default and $FLOWR_SIGDB_DIR. A downloaded full-history bundle placed here is mounted automatically.
Optional ReadonlyassumedRVersion?: stringThe R version analysis assumes when resolving versioned (base-R) package exports: a pin like "4.5",
or "auto" to detect the locally installed R (falling back to DefaultAssumedRVersion when the
engine reports none, e.g. the tree-sitter engine). Resolve it with resolveAssumedRVersion.
Optional ReadonlyautoSync?: booleanOn startup, compare the cache against the committed sigdb.remote.json link file and re-download changed shards in the background (default false; needs network, so opt-in — a git pull that updates the pointer then re-syncs automatically).
Optional ReadonlydownloadRepo?: stringGitHub owner/repo the full-history bundle is downloaded from (:signature download); default flowr-analysis/flowr, release tag sigdb-v<flowR-version>.
Optional ReadonlyeagerlyLoad?: booleanParse the database up front rather than on the first package load (default false, ignored if disabled).
Optional ReadonlyeagerlyLoadExports?: booleanAdd a vertex for every export on load rather than on demand (default false); keeps the graph small.
Optional Readonlyenabled?: booleanResolve library exports from a signature database (default true); when false no database is consulted.
Optional ReadonlylinkBaseR?: booleanEagerly attach base-R namespaces (from a signature database) so bare base calls resolve without library() (default false; changes every analysis; needs a base-R signature database).
Optional ReadonlylinkBaseRCalls?: booleanAdd a lightweight Reads edge from a bare base-R call to its signature-database function vertex (built-in:pkg:fn); base-R qualification stays edge-free unless this is on (default false; adds edges to every base call).
Optional ReadonlylinkDescriptionDependencies?: booleanEagerly attach the namespaces of the project's declared DESCRIPTION dependencies (Imports/Depends) so their exports resolve without an explicit library() (default false; changes every analysis; needs a signature database resolving the declared packages).
Optional ReadonlylinkPackageCalls?: booleanAdd a lightweight Reads edge from a resolved package call (pkg::fn/attached export) to its signature-database function vertex (default false).
Optional ReadonlyloadProjectDependencies?: booleanLoad the project's declared dependencies from its metadata files (DESCRIPTION Imports/Depends, rproject.toml, renv.lock, rv.lock) into the dependency context (default true); when false these files are not read, so neither the undefined-symbol linter nor linkDescriptionDependencies sees any project-declared dependency.
Optional ReadonlyversionOverrides?: { [key: ...]: ... }Force an exact version for specific packages (mapping a package name to a version), overriding both the project constraint and the versionSelection policy; a version missing from the database falls back with a warning (default {}).
Optional ReadonlyversionSelection?: VersionSelectionWhen a project constrains a dependency, resolve to the newest (default) or oldest version satisfying the constraint, or the system-installed version (needs R; falls back to newest when unavailable). Base-R packages always resolve against the assumed R version.
Optional ReadonlywarmInBackground?: booleanDecompress the hot shards (base + most-downloaded) in a background task on startup, so the first library() lookup is warm (default false; useful for long-running servers/REPLs, not one-shot runs).
Optionalslicer?: { autoExtend?: boolean; threshold?: number }The configuration for flowR's slicer
Optional ReadonlyautoExtend?: booleanIf set, the slicer will gain an additional post-pass
Optional Readonlythreshold?: numberThe maximum number of iterations to perform on a single function call during slicing
Optional ReadonlytrackEnvironments?: booleanTrack user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: VariableResolveHow to resolve variables and their values
Optional ReadonlyversionManagement?: { linkedVersionGroups?: (...)[] }Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlylinkedVersionGroups?: (...)[]Groups of packages that must resolve to the same version (like the base packages, which share the R version); version guessing intersects each group so its members stay mutually compatible (default []).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalnotebook?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalpackage?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalproject?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalscript?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalshiny-app?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalunknown?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalshiny-app?: {Optional ReadonlyabstractInterpretation?: {Configuration options for abstract interpretation
Optional ReadonlydataFrame?: {The configuration of the shape inference for data frames
Optional ReadonlymaxColNames?: numberThe maximum number of columns names to infer for data frames before over-approximating the column names to top
Optional ReadonlyreadLoadedData?: { maxReadLines?: ...; readExternalFiles?: ... }Configuration options for reading data frame shapes from loaded external data files, such as CSV files
Optional ReadonlymaxReadLines?: ...The maximum number of lines to read when extracting data frame shapes from loaded files, such as CSV files
Optional ReadonlyreadExternalFiles?: ...Whether data frame shapes should be extracted from loaded external data files, such as CSV files
Optional ReadonlywideningThreshold?: numberThe threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (string | [string?, (...)[]?] | undefined)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: {Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: { [key: string]: number | undefined }Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: () => GasHeapStatistics | undefinedCustom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: {Shared thresholds scaled by each feature factor before comparison.
Optional Readonlymemory?: { critical?: ...; problematic?: ...; [key: ...]: ... }Heap-usage fraction thresholds (0-1, before factor scaling).
Optional Readonlycritical?: ...Returns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: ...Returns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlytimeMs?: { critical?: ...; problematic?: ...; [key: ...]: ... }Elapsed analysis time thresholds in milliseconds (before factor scaling).
Optional Readonlycritical?: ...Returns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: ...Returns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: (string | undefined)[] }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: (string | undefined)[]Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: (string | undefined)[]The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: (string | undefined)[]Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: booleanWhether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ProjectKindOverwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: booleanAutomatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: booleanThis instruments the dataflow processors to count how often each processor is called
Optionalhints?: booleanWhether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: (string | [(...)?, (...)?] | undefined)[]Plugins to load in REPL mode
OptionalqueryStats?: booleanWhether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: booleanWhether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: booleanWhether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: {Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: { overwriteBuiltIns?: { definitions?: ...; loadDefaults?: ... } }Semantics regarding the handling of the environment
Optional ReadonlyoverwriteBuiltIns?: { definitions?: ...; loadDefaults?: ... }Do you want to overwrite (parts) of the builtin definition?
Optional Readonlydefinitions?: ...The definitions to load
Optional ReadonlyloadDefaults?: ...Should the default configuration still be loaded?
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: booleanShould we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: { dataflowExtractors?: (extractor: ..., ctx: ...) => ... }These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
OptionaldataflowExtractors?: (extractor: ..., ctx: ...) => ...Modify the dataflow processors used during dataflow analysis. Make sure that all processors required for correct analysis are still present! This may have arbitrary consequences on the analysis precision and performance, consider focusing on decorating existing processors instead of replacing them.
Optional ReadonlyresolveSource?: {If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional ReadonlyapplyReplacements?: (...)[]sometimes files may have a different name in the source call (e.g., due to later replacements), with this setting you can provide a list of replacements to apply for each sourced file. Every replacement consists of a record that maps a regex to a replacement string.
[
{ }, // no replacement -> still try the original name/path
{ '.*\\.R$': 'main.R' }, // replace all .R files with main.R
{ '\s' : '_' }, // replace all spaces with underscores
{ '\s' : '-', 'oo': 'aa' }, // replace all spaces with dashes and oo with aa
]
Given a source("foo bar.R") this configuration will search for (in this order):
foo bar.R (original name)main.R (replaced with main.R)foo_bar.R (replaced spaces)faa-bar.R (replaced spaces and oo)Optional ReadonlyassumeFilesExist?: booleanAssume a sourced file is always there, making what it defines certain instead of conditional on the source call.
Optional ReadonlydropPaths?: DropPathsOptionAllow to drop the first or all parts of the sourced path, if it is relative.
Optional ReadonlyignoreCapitalization?: booleansearch for filenames matching in the lowercase
Optional ReadonlyinferWorkingDirectory?: InferWorkingDirectorytry to infer the working directory from the main or any script to analyze.
Optional ReadonlyrepeatedSourceLimit?: numberHow often the same file can be sourced within a single run? Please be aware: in case of cyclic sources this may not reach a fixpoint so give this a sensible limit.
Optional ReadonlysearchPath?: (...)[]Additionally search in these paths
Optional Readonlysigdb?: {Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optional ReadonlyadditionalPaths?: (...)[]Extra directories (or bundle/manifest files) searched for signature databases, alongside the shipped default and $FLOWR_SIGDB_DIR. A downloaded full-history bundle placed here is mounted automatically.
Optional ReadonlyassumedRVersion?: stringThe R version analysis assumes when resolving versioned (base-R) package exports: a pin like "4.5",
or "auto" to detect the locally installed R (falling back to DefaultAssumedRVersion when the
engine reports none, e.g. the tree-sitter engine). Resolve it with resolveAssumedRVersion.
Optional ReadonlyautoSync?: booleanOn startup, compare the cache against the committed sigdb.remote.json link file and re-download changed shards in the background (default false; needs network, so opt-in — a git pull that updates the pointer then re-syncs automatically).
Optional ReadonlydownloadRepo?: stringGitHub owner/repo the full-history bundle is downloaded from (:signature download); default flowr-analysis/flowr, release tag sigdb-v<flowR-version>.
Optional ReadonlyeagerlyLoad?: booleanParse the database up front rather than on the first package load (default false, ignored if disabled).
Optional ReadonlyeagerlyLoadExports?: booleanAdd a vertex for every export on load rather than on demand (default false); keeps the graph small.
Optional Readonlyenabled?: booleanResolve library exports from a signature database (default true); when false no database is consulted.
Optional ReadonlylinkBaseR?: booleanEagerly attach base-R namespaces (from a signature database) so bare base calls resolve without library() (default false; changes every analysis; needs a base-R signature database).
Optional ReadonlylinkBaseRCalls?: booleanAdd a lightweight Reads edge from a bare base-R call to its signature-database function vertex (built-in:pkg:fn); base-R qualification stays edge-free unless this is on (default false; adds edges to every base call).
Optional ReadonlylinkDescriptionDependencies?: booleanEagerly attach the namespaces of the project's declared DESCRIPTION dependencies (Imports/Depends) so their exports resolve without an explicit library() (default false; changes every analysis; needs a signature database resolving the declared packages).
Optional ReadonlylinkPackageCalls?: booleanAdd a lightweight Reads edge from a resolved package call (pkg::fn/attached export) to its signature-database function vertex (default false).
Optional ReadonlyloadProjectDependencies?: booleanLoad the project's declared dependencies from its metadata files (DESCRIPTION Imports/Depends, rproject.toml, renv.lock, rv.lock) into the dependency context (default true); when false these files are not read, so neither the undefined-symbol linter nor linkDescriptionDependencies sees any project-declared dependency.
Optional ReadonlyversionOverrides?: { [key: ...]: ... }Force an exact version for specific packages (mapping a package name to a version), overriding both the project constraint and the versionSelection policy; a version missing from the database falls back with a warning (default {}).
Optional ReadonlyversionSelection?: VersionSelectionWhen a project constrains a dependency, resolve to the newest (default) or oldest version satisfying the constraint, or the system-installed version (needs R; falls back to newest when unavailable). Base-R packages always resolve against the assumed R version.
Optional ReadonlywarmInBackground?: booleanDecompress the hot shards (base + most-downloaded) in a background task on startup, so the first library() lookup is warm (default false; useful for long-running servers/REPLs, not one-shot runs).
Optionalslicer?: { autoExtend?: boolean; threshold?: number }The configuration for flowR's slicer
Optional ReadonlyautoExtend?: booleanIf set, the slicer will gain an additional post-pass
Optional Readonlythreshold?: numberThe maximum number of iterations to perform on a single function call during slicing
Optional ReadonlytrackEnvironments?: booleanTrack user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: VariableResolveHow to resolve variables and their values
Optional ReadonlyversionManagement?: { linkedVersionGroups?: (...)[] }Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlylinkedVersionGroups?: (...)[]Groups of packages that must resolve to the same version (like the base packages, which share the R version); version guessing intersects each group so its members stay mutually compatible (default []).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalnotebook?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalpackage?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalproject?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalscript?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalshiny-app?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalunknown?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalunknown?: {Optional ReadonlyabstractInterpretation?: {Configuration options for abstract interpretation
Optional ReadonlydataFrame?: {The configuration of the shape inference for data frames
Optional ReadonlymaxColNames?: numberThe maximum number of columns names to infer for data frames before over-approximating the column names to top
Optional ReadonlyreadLoadedData?: { maxReadLines?: ...; readExternalFiles?: ... }Configuration options for reading data frame shapes from loaded external data files, such as CSV files
Optional ReadonlymaxReadLines?: ...The maximum number of lines to read when extracting data frame shapes from loaded files, such as CSV files
Optional ReadonlyreadExternalFiles?: ...Whether data frame shapes should be extracted from loaded external data files, such as CSV files
Optional ReadonlywideningThreshold?: numberThe threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (string | [string?, (...)[]?] | undefined)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: {Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: { [key: string]: number | undefined }Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: () => GasHeapStatistics | undefinedCustom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: {Shared thresholds scaled by each feature factor before comparison.
Optional Readonlymemory?: { critical?: ...; problematic?: ...; [key: ...]: ... }Heap-usage fraction thresholds (0-1, before factor scaling).
Optional Readonlycritical?: ...Returns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: ...Returns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlytimeMs?: { critical?: ...; problematic?: ...; [key: ...]: ... }Elapsed analysis time thresholds in milliseconds (before factor scaling).
Optional Readonlycritical?: ...Returns GasLevel.Critical when reached (after factor scaling).
Optional Readonlyproblematic?: ...Returns GasLevel.Problematic when reached (after factor scaling).
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: (string | undefined)[] }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: (string | undefined)[]Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: (string | undefined)[]The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: (string | undefined)[]Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: booleanWhether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ProjectKindOverwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: booleanAutomatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: booleanThis instruments the dataflow processors to count how often each processor is called
Optionalhints?: booleanWhether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: (string | [(...)?, (...)?] | undefined)[]Plugins to load in REPL mode
OptionalqueryStats?: booleanWhether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: booleanWhether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: booleanWhether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: {Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: { overwriteBuiltIns?: { definitions?: ...; loadDefaults?: ... } }Semantics regarding the handling of the environment
Optional ReadonlyoverwriteBuiltIns?: { definitions?: ...; loadDefaults?: ... }Do you want to overwrite (parts) of the builtin definition?
Optional Readonlydefinitions?: ...The definitions to load
Optional ReadonlyloadDefaults?: ...Should the default configuration still be loaded?
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: booleanShould we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: { dataflowExtractors?: (extractor: ..., ctx: ...) => ... }These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
OptionaldataflowExtractors?: (extractor: ..., ctx: ...) => ...Modify the dataflow processors used during dataflow analysis. Make sure that all processors required for correct analysis are still present! This may have arbitrary consequences on the analysis precision and performance, consider focusing on decorating existing processors instead of replacing them.
Optional ReadonlyresolveSource?: {If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional ReadonlyapplyReplacements?: (...)[]sometimes files may have a different name in the source call (e.g., due to later replacements), with this setting you can provide a list of replacements to apply for each sourced file. Every replacement consists of a record that maps a regex to a replacement string.
[
{ }, // no replacement -> still try the original name/path
{ '.*\\.R$': 'main.R' }, // replace all .R files with main.R
{ '\s' : '_' }, // replace all spaces with underscores
{ '\s' : '-', 'oo': 'aa' }, // replace all spaces with dashes and oo with aa
]
Given a source("foo bar.R") this configuration will search for (in this order):
foo bar.R (original name)main.R (replaced with main.R)foo_bar.R (replaced spaces)faa-bar.R (replaced spaces and oo)Optional ReadonlyassumeFilesExist?: booleanAssume a sourced file is always there, making what it defines certain instead of conditional on the source call.
Optional ReadonlydropPaths?: DropPathsOptionAllow to drop the first or all parts of the sourced path, if it is relative.
Optional ReadonlyignoreCapitalization?: booleansearch for filenames matching in the lowercase
Optional ReadonlyinferWorkingDirectory?: InferWorkingDirectorytry to infer the working directory from the main or any script to analyze.
Optional ReadonlyrepeatedSourceLimit?: numberHow often the same file can be sourced within a single run? Please be aware: in case of cyclic sources this may not reach a fixpoint so give this a sensible limit.
Optional ReadonlysearchPath?: (...)[]Additionally search in these paths
Optional Readonlysigdb?: {Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optional ReadonlyadditionalPaths?: (...)[]Extra directories (or bundle/manifest files) searched for signature databases, alongside the shipped default and $FLOWR_SIGDB_DIR. A downloaded full-history bundle placed here is mounted automatically.
Optional ReadonlyassumedRVersion?: stringThe R version analysis assumes when resolving versioned (base-R) package exports: a pin like "4.5",
or "auto" to detect the locally installed R (falling back to DefaultAssumedRVersion when the
engine reports none, e.g. the tree-sitter engine). Resolve it with resolveAssumedRVersion.
Optional ReadonlyautoSync?: booleanOn startup, compare the cache against the committed sigdb.remote.json link file and re-download changed shards in the background (default false; needs network, so opt-in — a git pull that updates the pointer then re-syncs automatically).
Optional ReadonlydownloadRepo?: stringGitHub owner/repo the full-history bundle is downloaded from (:signature download); default flowr-analysis/flowr, release tag sigdb-v<flowR-version>.
Optional ReadonlyeagerlyLoad?: booleanParse the database up front rather than on the first package load (default false, ignored if disabled).
Optional ReadonlyeagerlyLoadExports?: booleanAdd a vertex for every export on load rather than on demand (default false); keeps the graph small.
Optional Readonlyenabled?: booleanResolve library exports from a signature database (default true); when false no database is consulted.
Optional ReadonlylinkBaseR?: booleanEagerly attach base-R namespaces (from a signature database) so bare base calls resolve without library() (default false; changes every analysis; needs a base-R signature database).
Optional ReadonlylinkBaseRCalls?: booleanAdd a lightweight Reads edge from a bare base-R call to its signature-database function vertex (built-in:pkg:fn); base-R qualification stays edge-free unless this is on (default false; adds edges to every base call).
Optional ReadonlylinkDescriptionDependencies?: booleanEagerly attach the namespaces of the project's declared DESCRIPTION dependencies (Imports/Depends) so their exports resolve without an explicit library() (default false; changes every analysis; needs a signature database resolving the declared packages).
Optional ReadonlylinkPackageCalls?: booleanAdd a lightweight Reads edge from a resolved package call (pkg::fn/attached export) to its signature-database function vertex (default false).
Optional ReadonlyloadProjectDependencies?: booleanLoad the project's declared dependencies from its metadata files (DESCRIPTION Imports/Depends, rproject.toml, renv.lock, rv.lock) into the dependency context (default true); when false these files are not read, so neither the undefined-symbol linter nor linkDescriptionDependencies sees any project-declared dependency.
Optional ReadonlyversionOverrides?: { [key: ...]: ... }Force an exact version for specific packages (mapping a package name to a version), overriding both the project constraint and the versionSelection policy; a version missing from the database falls back with a warning (default {}).
Optional ReadonlyversionSelection?: VersionSelectionWhen a project constrains a dependency, resolve to the newest (default) or oldest version satisfying the constraint, or the system-installed version (needs R; falls back to newest when unavailable). Base-R packages always resolve against the assumed R version.
Optional ReadonlywarmInBackground?: booleanDecompress the hot shards (base + most-downloaded) in a background task on startup, so the first library() lookup is warm (default false; useful for long-running servers/REPLs, not one-shot runs).
Optionalslicer?: { autoExtend?: boolean; threshold?: number }The configuration for flowR's slicer
Optional ReadonlyautoExtend?: booleanIf set, the slicer will gain an additional post-pass
Optional Readonlythreshold?: numberThe maximum number of iterations to perform on a single function call during slicing
Optional ReadonlytrackEnvironments?: booleanTrack user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: VariableResolveHow to resolve variables and their values
Optional ReadonlyversionManagement?: { linkedVersionGroups?: (...)[] }Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlylinkedVersionGroups?: (...)[]Groups of packages that must resolve to the same version (like the base packages, which share the R version); version guessing intersects each group so its members stay mutually compatible (default []).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalnotebook?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalpackage?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalproject?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalscript?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalshiny-app?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
Optionalunknown?: {Optional ReadonlyabstractInterpretation?: { dataFrame?: ...; wideningThreshold?: ... }Configuration options for abstract interpretation
Optional ReadonlydataFrame?: ...The configuration of the shape inference for data frames
Optional ReadonlywideningThreshold?: ...The threshold for the number of visitations of a node at which widening should be performed to ensure the termination of the fixpoint iteration
Optional ReadonlydefaultEngine?: "tree-sitter" | "r-shell"The default engine to use for interacting with R code. If this is undefined, an arbitrary engine from engines will be used.
Optional ReadonlydefaultPlugins?: (...)[]Plugins to load by default when creating a new FlowrAnalyzer
Optional Readonlyengines?: (...)[]The engines to use for interacting with R code. Currently, supports TreeSitterEngineConfig and RShellEngineConfig. An empty array means all available engines will be used.
Optional Readonlygas?: { features?: ...; heapProvider?: ...; thresholds?: ...; [key: ...]: ... }Resource-usage guard (gas) configuration.
Gas checks are disabled by default (all feature factors are 0).
Set a feature factor > 0 to enable checking for that feature.
Optional Readonlyfeatures?: ...Per-feature sensitivity factors. Missing or 0 disables checking with zero overhead.
Optional ReadonlyheapProvider?: ...Custom heap statistics source (programmatic configs only), overriding the built-in detection (v8 module, then Chromium's performance.memory). Return undefined to skip the memory check.
Optional Readonlythresholds?: ...Shared thresholds scaled by each feature factor before comparison.
Optional ReadonlyignoreLoadCalls?: booleanWhether load calls should be ignored, causing processLoadCall's behavior to be skipped
Optional ReadonlyignoreSourceCalls?: booleanWhether source calls should be ignored, causing processSourceCall's behavior to be skipped
Optional Readonlyinherit?: ProjectKindOptional Readonlylinter?: { disabledRules?: ... }Linter configuration, usually specialized per ProjectKind via FlowrConfig.specializeConfig.
Optional ReadonlydisabledRules?: ...Rule names excluded from the default rule set (a rule requested explicitly still runs).
Optional ReadonlylogLevel?: "error" | "info" | "debug" | "trace" | "silly" | "warn" | "fatal"Optional Readonlyproject?: {OptionalbasePackages?: ...The packages considered part of R itself, used e.g. by the project query to classify dependencies. If
unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
OptionalimplicitSources?: ...Files a framework loads on its own, without any source() call (e.g. global.R in a shiny app), in load
order. Entries are case-insensitive globs (R/*.R) matched against the path, a plain name matches any file
with that name; entries matching nothing are warned about. Usually set per ProjectKind via
FlowrConfig.specializeConfig.
OptionalresolveUnknownPathsOnDisk?: ...Whether to resolve unknown paths loaded by the r project disk when trying to source/analyze files
OptionaluseProjectType?: ...Overwrite the ProjectKind flowR would otherwise infer from the analyzed files, e.g. when auto-detection guesses wrong.
Optional Readonlyrepl?: {Configuration options for the REPL
OptionalautoUseFileProtocol?: ...Automatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: ...This instruments the dataflow processors to count how often each processor is called
Optionalhints?: ...Whether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: ...Plugins to load in REPL mode
OptionalqueryStats?: ...Whether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: ...Whether to show quick stats in the REPL after each evaluation
OptionalshowPlugins?: ...Whether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: ... }Configure language semantics and how flowR handles them
Optional Readonlyenvironment?: ...Semantics regarding the handling of the environment
Optional Readonlysolver?: {How to resolve constants, constraints, cells, …
Optional ReadonlyevalStrings?: ...Should we include eval(parse(text="...")) calls in the dataflow graph?
Optional Readonlyinstrument?: ...These keys are only intended for use within code, allowing to instrument the dataflow analyzer!
Optional ReadonlyresolveSource?: ...If lax source calls are active, flowR searches for sourced files much more freely, based on the configurations you give it. This option is only in effect if ignoreSourceCalls is set to false.
Optional Readonlysigdb?: ...Resolving library()/use() exports from a signature database (e.g. the bundled flowr-sigdb).
Optionalslicer?: ...The configuration for flowR's slicer
Optional ReadonlytrackEnvironments?: ...Track user-created environments (new.env(), assign(..., envir=e), get(..., envir=e),
local({}, envir=e), e$x <- v, attach(e)) with precise per-variable envState.
When disabled all envir-style calls fall through to the conservative global treatment.
Optional Readonlyvariables?: ...How to resolve variables and their values
Optional ReadonlyversionManagement?: ...Policies for reasoning about dependency versions (independent of how the signature database is loaded).
Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration depending on the ProjectKind flowR detects for the project,
e.g. to give a shiny app its implicit sources. An entry may inherit another kind's overwrite (merged first,
with the entry's own keys winning) to avoid repeating it. Resolve it with FlowrConfig.forKind.
The first schema violation (an unknown key or a wrong-typed value) in a config update, or
undefinedif it is valid. Shared by the repl line parser and the executor, so a programmatic or JSON-API update is validated exactly like a:config +key=valueline and never merges junk or a mistyped value.