Skip to content

@saflib/imports


index

Classes

ClassDescription
MemoryFactStoreIn-memory FactStore for workdir / CI (no SQLite).

Interfaces

InterfaceDescription
FactStore-
FileExportFact-
FileFactContent-addressed parse result for one file. contentKey is a git blob hash (Spec) or content hash (workdir / CI).
FileImportFact-
FileTableColumnFact-
FileTableFact-
FileTestCaseFact-
PackageDetailForIssues-
PackageIssue-
WorkdirAnalyzeOptions-
WorkdirAnalyzeResult-
WorkdirGraphContext-
WorkdirPackageAnalyzeResult-

Type Aliases

Type AliasDescription
FileSpecialtyDiscriminated specialty for one file. exports and imports are on every kind; kind-only props are testCases (test) and tables (sql-table). localExportUsages is optional for older blob_facts rows (pre analyzer v8).
PackageIssueKind-
UsedBy-

Variables

VariableDescription
ANALYZER_VERSIONBump when specialty shape or extractors change incompatibly.

Functions

FunctionDescription
analyzePackageFromWorkdirContextAnalyze one package from a pre-built WorkdirGraphContext.
analyzeWorkdirPackageAnalyze a single package from the working tree.
analyzeWorkdirPackagesAnalyze one or more packages from the working tree.
buildFileSpecialtyBuild FileSpecialty from source text via @saflib/parser extractors.
buildWorkdirGraphContextWalk the tree once and build import/export specialties for graph analysis.
collectPackageIssuesGraph-derived issues: dead exports/queries (plus merged layoutIssues). Same-file-only exports are not reported — self-use is enough to clear dead-code.
collectPublicExportPathsFromTreeRepo-relative paths that are public package.json export targets, derived from a commit tree (no filesystem).
countSourceLines-
createTreeResolveImportTargetResolve import specifiers to repo-relative paths using a commit tree (no FS). Handles # import maps, relative imports, and workspace package exports.
fileFactFromSource-
isGraphSourcePath.ts / .tsx / .vue sources parsed for exports and import graph edges.
isScaffoldTemplatePathWorkflow scaffold placeholders (__target-name__.ts, handlers/__group-name__/, …).
isTestSourcePathTest / fixture / test-helper paths excluded from export inventory.
matchExportPatternMatch a Node.js package.json exports subpath pattern.
resolveImportsMapSpecifierResolve # entries from a package imports map (exact + pattern).
sortExportPatternKeysPrefer longer (more specific) pattern keys, matching Node's best-match preference.
specialtyExports-
specialtyImports-
specialtyLocalExportUsages-
specialtyTables-
specialtyTestCases-

References

applyCompositionRootReferences

Re-exports applyCompositionRootReferences


assembleUsedBy

Re-exports assembleUsedBy


buildPackageIndex

Re-exports buildPackageIndex


buildReferenceGraph

Re-exports buildReferenceGraph


BuildReferenceGraphResult

Re-exports BuildReferenceGraphResult


checkReferences

Re-exports checkReferences


CheckReferencesResult

Re-exports CheckReferencesResult


checkSnapshot

Re-exports checkSnapshot


CheckSnapshotOptions

Re-exports CheckSnapshotOptions


CheckSnapshotResult

Re-exports CheckSnapshotResult


Cycle

Re-exports Cycle


detectCycles

Re-exports detectCycles


DetectCyclesOptions

Re-exports DetectCyclesOptions


detectReferenceCycles

Re-exports detectReferenceCycles


existsResolve

Re-exports existsResolve


ExportUsedBy

Re-exports ExportUsedBy


exportUsedByKey

Re-exports exportUsedByKey


ExportUsedByMap

Re-exports ExportUsedByMap


findMonorepoRoot

Re-exports findMonorepoRoot


findPath

Re-exports findPath


FindPathResult

Re-exports FindPathResult


formatRegression

Re-exports formatRegression


generateReferences

Re-exports generateReferences


GenerateReferencesPreview

Re-exports GenerateReferencesPreview


generateSnapshot

Re-exports generateSnapshot


GenerateSnapshotOptions

Re-exports GenerateSnapshotOptions


GraphWalkOptions

Re-exports GraphWalkOptions


ImportUsedBy

Re-exports ImportUsedBy


isInternalReference

Re-exports isInternalReference


measureGraph

Re-exports measureGraph


MeasureGraphOptions

Re-exports MeasureGraphOptions


MeasureGraphResult

Re-exports MeasureGraphResult


mergePackageReferences

Re-exports mergePackageReferences


MetricsSnapshot

Re-exports MetricsSnapshot


moduleTargetFromImport

Re-exports moduleTargetFromImport


PackageIndex

Re-exports PackageIndex


PackageInfo

Re-exports PackageInfo


packageLocalPath

Re-exports packageLocalPath


PackageReferencePreview

Re-exports PackageReferencePreview


previewReferencesGenerate

Re-exports previewReferencesGenerate


readSource

Re-exports readSource


ReferenceCycle

Re-exports ReferenceCycle


ReferenceGraph

Re-exports ReferenceGraph


ReferenceGraphNode

Re-exports ReferenceGraphNode


resolvePackageExportPath

Re-exports resolvePackageExportPath


resolveRelative

Re-exports resolveRelative


resolveSpecifier

Re-exports resolveSpecifier


resolveTsconfigEntry

Re-exports resolveTsconfigEntry


SnapshotBundles

Re-exports SnapshotBundles


SnapshotGraphStats

Re-exports SnapshotGraphStats


SnapshotRegression

Re-exports SnapshotRegression


SnapshotSuiteTiming

Re-exports SnapshotSuiteTiming


SnapshotTypecheck

Re-exports SnapshotTypecheck


stripTsExt

Re-exports stripTsExt


UsedByImporterUnit

Re-exports UsedByImporterUnit


workspaceDepsOf

Re-exports workspaceDepsOf