Documentation
¶
Overview ¶
Package importresolve provides a unified import resolver shared by codegraph and analyze. It is a leaf package (path/filepath, strings, os, encoding/json) so both callers can import it without introducing dependency cycles.
Resolution strategy (in dispatch order):
- "$lib/…" / "$lib" — SvelteKit alias: resolved via each LibDir in Config.
- "@scope/pkg…" — Workspace scoped package: resolved via Config.Workspace.
- "./x" / "../x" — TS/JS/Svelte relative imports resolved against the importing file or package directory. See resolveRelative.
- everything else — Go-style absolute imports, longest-suffix-matched against the set of local package dirs. See localPkgDir.
A zero Config{} means "no aliases" — steps 1 and 2 are skipped, preserving the exact pre-alias behaviour for analyze callers that do not have config.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Config ¶
type Config struct {
// LibDirs is the list of SvelteKit project roots (repo-relative dirs that
// contain a svelte.config.js or svelte.config.ts). For each LibDir, "$lib"
// maps to "<libDir>/src/lib".
LibDirs []string
// Workspace maps a scoped package name (e.g. "@acme/mesh-core") to its
// repo-relative directory (e.g. "packages/mesh-core"). Subpath imports like
// "@acme/mesh-core/foo" are resolved by joining the mapped dir with "foo".
Workspace map[string]string
}
Config carries alias configuration for the Resolver. A zero Config{} disables all alias resolution — relative and Go-style resolution still applies. This preserves exact pre-alias behaviour for analyze callers that do not have project config at hand.
func BuildConfig ¶
BuildConfig walks the repository at root and produces a Config by:
- recording the repo-relative dir of every svelte.config.js or svelte.config.ts as a LibDir (so "$lib" → "<libDir>/src/lib");
- reading every package.json and mapping its "name" field to the repo-relative dir, building the Workspace alias map.
"node_modules" and any dot-directory (".git", ".svelte-kit", ".claude/worktrees", …) are skipped entirely via filepath.SkipDir (path-segment match, not substring). Skipping dot-dirs matters because some repos keep nested git worktrees (full repo copies) under e.g. .claude/worktrees/; descending into them would register a duplicate svelte.config / package.json and let a worktree copy win the $lib root or a Workspace name by last-write. Config files live in non-dot dirs, so this is safe. Files that cannot be read or parsed are silently skipped — one bad manifest must never fail the build.
BuildConfig is decoupled from ingest: it walks the repo from disk so that package.json files (which have no registered language and are excluded by the ingest language filter) are still discovered. This fixes the production bug where Config.Workspace was always empty because ingest.IngestRepo dropped .json files before BuildConfig could see them.
type Resolver ¶
type Resolver struct {
// contains filtered or unexported fields
}
Resolver resolves import paths to the repo-relative container directory of the package they refer to.
func New ¶
New builds a Resolver from pkgDirs (set of repo-relative package directories), fileSet (set of all indexed repo-relative file paths), and an alias Config. A zero Config{} means no aliases — relative and Go-style resolution only. Both maps must not be mutated after New returns.
func (*Resolver) Resolve ¶
Resolve maps an import string to the repo-relative container directory of the package it refers to. Returns ("", false) for external (unresolvable) imports.
Dispatch order:
- "$lib/…" or "$lib" — SvelteKit alias (requires non-empty cfg.LibDirs).
- "@scope/pkg…" — workspace scoped package (requires cfg.Workspace entry).
- "./x" / "../x" — relative import, resolved against importingDir. importingDir should be filepath.Dir(relFile) for file-level callers, or the package directory for package-level callers.
- everything else — Go-style absolute import, longest-suffix-matched.
Aliased imports that have no matching config entry fall through to external.
Source Files