Optional ReadonlyabstractInterpretation?: {Optional ReadonlydefaultEngine?: "r-shell" | "tree-sitter"The default engine to use. If undefined, an arbitrary one from engines is used.
Optional ReadonlydefaultPlugins?: (string | [(...)?, (...)?] | undefined)[]Optional Readonlyengines?: (Engines to use for interacting with R code (TreeSitterEngineConfig, RShellEngineConfig); empty means all available engines.
Optional Readonlygas?: {Resource-usage guard (gas) configuration; disabled by default (every feature factor 0), enable by setting a
feature's factor > 0. See FlowrGasConfig, ReadOnlyFlowrAnalyzerGasContext.
Optional ReadonlycountedCheckEvery?: numberHow many calls one accounting of an armed check covers (default DefaultCountedCheckEvery), for a
DataflowBudgetTracker as much as for the slicer's traversal. Trades how far a run may overshoot a
bound against what the guard costs per node: 1 counts exactly, larger counts coarsely.
Optional Readonlyfeatures?: { [key: ...]: ... }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 v8/performance.memory detection. Return undefined to skip the memory check.
Optional Readonlythresholds?: { memory?: ...; steps?: ...; timeMs?: ...; vertices?: ...; [key: ...]: ... }Thresholds scaled by each feature factor before comparison, optionally bounded per feature (see GasThresholdSpec).
Optional Readonlymemory?: ...Heap-usage fraction thresholds (0-1, before factor scaling).
Optional Readonlysteps?: ...Processed-AST-node thresholds, counted rather than sampled. Only read by keys that arm a budget (i.e. GasFeatureKey.Dataflow); absent means unbounded.
Optional ReadonlytimeMs?: ...Elapsed analysis time thresholds in milliseconds (before factor scaling).
Optional Readonlyvertices?: ...Created-dataflow-vertex thresholds, counted like FlowrGasThresholds.steps.
Optional ReadonlyignoreLoadCalls?: booleanOptional ReadonlyignoreSourceCalls?: booleanOptional Readonlyincremental?: { alwaysIncremental?: boolean; parsing?: { activated?: ...; heuristics?: ... } }Optional ReadonlyinputSources?: {Teaches the InputSourcesQuery|input-sources analysis further frameworks; entries are added to what flowR knows already. Usually set per ProjectKind via specializeConfig. See InputClassifierConfig.
Optionalcmdline?: (...)[]Optionalconst?: (...)[]Optionaldconst?: (...)[]Optionalffi?: (...)[]Optionalfile?: (...)[]Optionalglob?: (...)[]Optionallang?: (...)[]OptionallinkedEntryPoints?: (...)[]Calls that hand a function to a framework, which then binds linkedObjects to its parameters by position.
OptionallinkedObjects?: (...)[]Objects provided by a framework rather than by the code itself, like shiny's input.
Optionalnarrowing?: (...)[]Functions whose result is bounded by one of their arguments (classified by that argument alone).
Optionalnet?: (...)[]Optionaloptions?: (...)[]Optionalparam?: (...)[]Optionalpure?: (...)[]Functions which are considered to be pure (i.e., deterministic, trusted, safe, idempotent on the lub of the input types)
Optionalrand?: (...)[]Optionalscope?: (...)[]Optionalsystem?: (...)[]Optionaltempfile?: (...)[]Optionalunknown?: (...)[]Optionaluser?: (...)[]Optional Readonlylinter?: { disabledRules?: (...)[] }Optional ReadonlylogLevel?: "debug" | "silly" | "trace" | "info" | "warn" | "error" | "fatal"Optional Readonlyproject?: {OptionalassumeImplicitEcho?: booleanWhether the top level's visible results count as an output (the print category); off by default for a ProjectKind.Package, whose top level runs at install time.
OptionalbasePackages?: (...)[]The packages considered part of R itself; if unset, flowR derives them (for the assumed R version) from the signature database via baseRPackages.
Optionalclassification?: {OptionalnotebookExtensions?: ...File extensions marking a notebook (default ipynb, rmd, rmarkdown, qmd, rnw).
OptionalshinyDescriptionTypes?: ...DESCRIPTION Type: values that mark a shiny app (default shiny, shiny-app, shinyapp).
OptionalshinyEntryFiles?: ...File names a shiny app is assembled from (default app.R, ui.R, server.R, global.R).
OptionalshinyUsagePattern?: ...Optionaldiscovery?: { full?: ...; ignore?: ...; perKind?: ... }OptionalfailOnInaccessiblePath?: booleanOptionalimplicitSources?: (...)[]OptionalresolveUnknownPathsOnDisk?: booleanOptionaluseProjectType?: ProjectKindOptional Readonlyrepl?: {OptionalautoUseFileProtocol?: booleanAutomatically use the file protocol for inputs that look like paths (default true)
OptionaldfProcessorHeat?: booleanOptionalhints?: booleanWhether to show dim inline hints (e.g. :help) on the empty prompt; automatically disabled on non-interactive terminals
Optionalplugins?: (...)[]OptionalqueryStats?: booleanWhether :query closes with the line stating how long the queries took (default true, :query* never prints it)
OptionalquickStats?: booleanOptionalshowPlugins?: booleanWhether :version grays out the plugins that did not activate during the last analysis (default false)
Optional Readonlysemantics?: { environment?: { overwriteBuiltIns?: ... } }Optional Readonlysolver?: {Optional ReadonlyassumeAttachedPackages?: (...)[]Packages to treat as attached without a library() call, on top of the base packages R attaches on
startup (see AttachedBasePackages, which a bare name resolves against without this option).
Optional ReadonlyevalStrings?: booleanOptional Readonlyinstrument?: { dataflowExtractors?: ... }OptionaldataflowExtractors?: ...Modify the dataflow processors used during analysis; keep every processor correctness requires present. May affect precision/performance arbitrarily -- prefer decorating existing processors over replacing them.
Optional ReadonlymaxOverlayDepth?: numberHow many binding overlays may stack on one environment frame before a write flattens them (default DefaultMaxOverlayDepth); trades lookup cost against copy cost and never changes a result.
Optional ReadonlyresolveSource?: {Optional ReadonlyapplyReplacements?: ...Regex replacements to try against a sourced file's candidate name, tried in order alongside the original
name, e.g. { '.*\\.R$': 'main.R' } makes source("foo bar.R") also try main.R.
Optional ReadonlyassumeFilesExist?: ...Optional ReadonlydropPaths?: ...Optional ReadonlyignoreCapitalization?: ...Optional ReadonlyinferWorkingDirectory?: ...Optional ReadonlyrepeatedSourceLimit?: ...Optional ReadonlysearchPath?: ...Optional Readonlysigdb?: {Optional ReadonlyadditionalPaths?: ...Optional ReadonlyassumedRVersion?: ...R version assumed when resolving versioned (base-R) exports: a pin, or "auto" to detect the installed R
(falling back to DefaultAssumedRVersion if none, e.g. tree-sitter). See resolveAssumedRVersion.
Optional ReadonlyautoSync?: ...Optional ReadonlyblobCacheBudgetMb?: ...How many MiB of decoded package blobs every open bundle may hold together; a bigger budget re-reads and re-parses less, a smaller one keeps less in memory (default 16).
Optional ReadonlydownloadRepo?: ...Optional ReadonlyeagerlyLoad?: ...Optional ReadonlyeagerlyLoadExports?: ...Optional Readonlyenabled?: ...Optional ReadonlyinstalledLibrary?: ...Recovering a package no signature database knows (e.g. maptools) from its local install: DESCRIPTION
states the version, NAMESPACE the exports. Opt-in, since it reads outside the analyzed project.
Optional ReadonlylinkBaseR?: ...Eagerly 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?: ...Add 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?: ...Eagerly 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?: ...Add a lightweight Reads edge from a resolved package call (pkg::fn/attached export) to its signature-database function vertex (default false).
Optional ReadonlyloadProjectDependencies?: ...Optional ReadonlyversionOverrides?: ...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?: ...Optional ReadonlywarmInBackground?: ...Decompress 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?: ...; threshold?: ... }Optional ReadonlytrackEnvironments?: booleanOptional ReadonlytransitiveSideEffectRounds?: numberOptional Readonlyvariables?: VariableResolveOptional ReadonlyversionManagement?: { linkedVersionGroups?: ... }Optional ReadonlyspecializeConfig?: {Overwrite (parts of) this configuration per ProjectKind; an entry may inherit another kind's
overwrite first (own keys win). Resolve with FlowrConfig.forKind.
Optionalnotebook?: {Optional ReadonlyabstractInterpretation?: ...Optional ReadonlydefaultEngine?: ...The default engine to use. If undefined, an arbitrary one from engines is used.
Optional ReadonlydefaultPlugins?: ...Optional Readonlyengines?: ...Engines to use for interacting with R code (TreeSitterEngineConfig, RShellEngineConfig); empty means all available engines.
Optional Readonlygas?: ...Resource-usage guard (gas) configuration; disabled by default (every feature factor 0), enable by setting a
feature's factor > 0. See FlowrGasConfig, ReadOnlyFlowrAnalyzerGasContext.
Optional ReadonlyignoreLoadCalls?: ...Optional ReadonlyignoreSourceCalls?: ...Optional Readonlyincremental?: ...Optional Readonlyinherit?: ...Optional ReadonlyinputSources?: ...Teaches the InputSourcesQuery|input-sources analysis further frameworks; entries are added to what flowR knows already. Usually set per ProjectKind via specializeConfig. See InputClassifierConfig.
Optional Readonlylinter?: ...Optional ReadonlylogLevel?: ...Optional Readonlyproject?: ...Optional Readonlyrepl?: ...Optional Readonlysemantics?: ...Optional Readonlysolver?: ...Optional ReadonlyspecializeConfig?: ...Overwrite (parts of) this configuration per ProjectKind; an entry may inherit another kind's
overwrite first (own keys win). Resolve with FlowrConfig.forKind.
Optionalpackage?: {Optional ReadonlyabstractInterpretation?: ...Optional ReadonlydefaultEngine?: ...The default engine to use. If undefined, an arbitrary one from engines is used.
Optional ReadonlydefaultPlugins?: ...Optional Readonlyengines?: ...Engines to use for interacting with R code (TreeSitterEngineConfig, RShellEngineConfig); empty means all available engines.
Optional Readonlygas?: ...Resource-usage guard (gas) configuration; disabled by default (every feature factor 0), enable by setting a
feature's factor > 0. See FlowrGasConfig, ReadOnlyFlowrAnalyzerGasContext.
Optional ReadonlyignoreLoadCalls?: ...Optional ReadonlyignoreSourceCalls?: ...Optional Readonlyincremental?: ...Optional Readonlyinherit?: ...Optional ReadonlyinputSources?: ...Teaches the InputSourcesQuery|input-sources analysis further frameworks; entries are added to what flowR knows already. Usually set per ProjectKind via specializeConfig. See InputClassifierConfig.
Optional Readonlylinter?: ...Optional ReadonlylogLevel?: ...Optional Readonlyproject?: ...Optional Readonlyrepl?: ...Optional Readonlysemantics?: ...Optional Readonlysolver?: ...Optional ReadonlyspecializeConfig?: ...Overwrite (parts of) this configuration per ProjectKind; an entry may inherit another kind's
overwrite first (own keys win). Resolve with FlowrConfig.forKind.
Optionalproject?: {Optional ReadonlyabstractInterpretation?: ...Optional ReadonlydefaultEngine?: ...The default engine to use. If undefined, an arbitrary one from engines is used.
Optional ReadonlydefaultPlugins?: ...Optional Readonlyengines?: ...Engines to use for interacting with R code (TreeSitterEngineConfig, RShellEngineConfig); empty means all available engines.
Optional Readonlygas?: ...Resource-usage guard (gas) configuration; disabled by default (every feature factor 0), enable by setting a
feature's factor > 0. See FlowrGasConfig, ReadOnlyFlowrAnalyzerGasContext.
Optional ReadonlyignoreLoadCalls?: ...Optional ReadonlyignoreSourceCalls?: ...Optional Readonlyincremental?: ...Optional Readonlyinherit?: ...Optional ReadonlyinputSources?: ...Teaches the InputSourcesQuery|input-sources analysis further frameworks; entries are added to what flowR knows already. Usually set per ProjectKind via specializeConfig. See InputClassifierConfig.
Optional Readonlylinter?: ...Optional ReadonlylogLevel?: ...Optional Readonlyproject?: ...Optional Readonlyrepl?: ...Optional Readonlysemantics?: ...Optional Readonlysolver?: ...Optional ReadonlyspecializeConfig?: ...Overwrite (parts of) this configuration per ProjectKind; an entry may inherit another kind's
overwrite first (own keys win). Resolve with FlowrConfig.forKind.
Optionalscript?: {Optional ReadonlyabstractInterpretation?: ...Optional ReadonlydefaultEngine?: ...The default engine to use. If undefined, an arbitrary one from engines is used.
Optional ReadonlydefaultPlugins?: ...Optional Readonlyengines?: ...Engines to use for interacting with R code (TreeSitterEngineConfig, RShellEngineConfig); empty means all available engines.
Optional Readonlygas?: ...Resource-usage guard (gas) configuration; disabled by default (every feature factor 0), enable by setting a
feature's factor > 0. See FlowrGasConfig, ReadOnlyFlowrAnalyzerGasContext.
Optional ReadonlyignoreLoadCalls?: ...Optional ReadonlyignoreSourceCalls?: ...Optional Readonlyincremental?: ...Optional Readonlyinherit?: ...Optional ReadonlyinputSources?: ...Teaches the InputSourcesQuery|input-sources analysis further frameworks; entries are added to what flowR knows already. Usually set per ProjectKind via specializeConfig. See InputClassifierConfig.
Optional Readonlylinter?: ...Optional ReadonlylogLevel?: ...Optional Readonlyproject?: ...Optional Readonlyrepl?: ...Optional Readonlysemantics?: ...Optional Readonlysolver?: ...Optional ReadonlyspecializeConfig?: ...Overwrite (parts of) this configuration per ProjectKind; an entry may inherit another kind's
overwrite first (own keys win). Resolve with FlowrConfig.forKind.
Optionalshiny-app?: {Optional ReadonlyabstractInterpretation?: ...Optional ReadonlydefaultEngine?: ...The default engine to use. If undefined, an arbitrary one from engines is used.
Optional ReadonlydefaultPlugins?: ...Optional Readonlyengines?: ...Engines to use for interacting with R code (TreeSitterEngineConfig, RShellEngineConfig); empty means all available engines.
Optional Readonlygas?: ...Resource-usage guard (gas) configuration; disabled by default (every feature factor 0), enable by setting a
feature's factor > 0. See FlowrGasConfig, ReadOnlyFlowrAnalyzerGasContext.
Optional ReadonlyignoreLoadCalls?: ...Optional ReadonlyignoreSourceCalls?: ...Optional Readonlyincremental?: ...Optional Readonlyinherit?: ...Optional ReadonlyinputSources?: ...Teaches the InputSourcesQuery|input-sources analysis further frameworks; entries are added to what flowR knows already. Usually set per ProjectKind via specializeConfig. See InputClassifierConfig.
Optional Readonlylinter?: ...Optional ReadonlylogLevel?: ...Optional Readonlyproject?: ...Optional Readonlyrepl?: ...Optional Readonlysemantics?: ...Optional Readonlysolver?: ...Optional ReadonlyspecializeConfig?: ...Overwrite (parts of) this configuration per ProjectKind; an entry may inherit another kind's
overwrite first (own keys win). Resolve with FlowrConfig.forKind.
Optionalunknown?: {Optional ReadonlyabstractInterpretation?: ...Optional ReadonlydefaultEngine?: ...The default engine to use. If undefined, an arbitrary one from engines is used.
Optional ReadonlydefaultPlugins?: ...Optional Readonlyengines?: ...Engines to use for interacting with R code (TreeSitterEngineConfig, RShellEngineConfig); empty means all available engines.
Optional Readonlygas?: ...Resource-usage guard (gas) configuration; disabled by default (every feature factor 0), enable by setting a
feature's factor > 0. See FlowrGasConfig, ReadOnlyFlowrAnalyzerGasContext.
Optional ReadonlyignoreLoadCalls?: ...Optional ReadonlyignoreSourceCalls?: ...Optional Readonlyincremental?: ...Optional Readonlyinherit?: ...Optional ReadonlyinputSources?: ...Teaches the InputSourcesQuery|input-sources analysis further frameworks; entries are added to what flowR knows already. Usually set per ProjectKind via specializeConfig. See InputClassifierConfig.
Optional Readonlylinter?: ...Optional ReadonlylogLevel?: ...Optional Readonlyproject?: ...Optional Readonlyrepl?: ...Optional Readonlysemantics?: ...Optional Readonlysolver?: ...Optional ReadonlyspecializeConfig?: ...Overwrite (parts of) this configuration per ProjectKind; an entry may inherit another kind's
overwrite first (own keys win). Resolve 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.