Fold the analyzed code's orphan calls into usage and report which functions implicated each unknown
package. An orphan is a bare call (ggplot()) whose name is not bound to a local/parameter/closure/import
definition and is not a default-attached base export, but is exported by exactly one signature-database package.
Such a call never qualifies to pkg::fn, so collectUsage is blind to it (even when flowR models the
function as a builtin, as it does for ggplot), yet it pins the package's version just as a qualified call
would; folding it into usage makes the package a guess target. The returned map lists, per package the project
does not already declare or load (isKnown is false), the orphan function names that pointed at it (e.g.
ggplot2 from ggplot()) -- a note for a downstream handler to attach the library, since the symbol would be
undefined were the package not loaded. Disambiguation is options.builtinLibraryOf (flowR's curated map, e.g.
ggplot to ggplot2, authoritative even when several packages re-export the name), then a package the project
already declares or loads, and finally the most downloaded of at most MaxOrphanProviders exporters; a
name beyond that many packages export says nothing about which one is meant and is skipped, as are quoted (NSE)
uses and forward-referenced closures. The exporters that lost the pick are kept as
OrphanUsage.alternatives, since the guess is exactly that -- a guess.
Fold the analyzed code's orphan calls into
usageand report which functions implicated each unknown package. An orphan is a bare call (ggplot()) whose name is not bound to a local/parameter/closure/import definition and is not a default-attached base export, but is exported by exactly one signature-database package. Such a call never qualifies topkg::fn, so collectUsage is blind to it (even when flowR models the function as a builtin, as it does forggplot), yet it pins the package's version just as a qualified call would; folding it intousagemakes the package a guess target. The returned map lists, per package the project does not already declare or load (isKnownisfalse), the orphan function names that pointed at it (e.g.ggplot2fromggplot()) -- a note for a downstream handler to attach the library, since the symbol would be undefined were the package not loaded. Disambiguation isoptions.builtinLibraryOf(flowR's curated map, e.g.ggplottoggplot2, authoritative even when several packages re-export the name), then a package the project already declares or loads, and finally the most downloaded of at most MaxOrphanProviders exporters; a name beyond that many packages export says nothing about which one is meant and is skipped, as are quoted (NSE) uses and forward-referenced closures. The exporters that lost the pick are kept as OrphanUsage.alternatives, since the guess is exactly that -- a guess.