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