reference

type ImportResolveContext ¶

type ImportResolveContext struct {
	RootDir      string
	ImporterPath string
	KnownFiles   map[string]bool
	KnownDirs    map[string]bool
}

ImportResolveContext carries filesystem and index metadata needed by provider-backed import resolution.

type Provider ¶

type Provider interface {
	Name() string
	Resolve(spec string, ctx ImportResolveContext) (string, bool)
}

Provider resolves import specs into canonical references.

func ProviderForName(name string) (Provider, bool)

type Reference ¶

type Reference struct {
	Provider string // e.g. "path", "go", "python", "node"
	Path     string // e.g. "./main.go", "fmt"
	Name     string // e.g. "main", "Println"; empty for file/package refs
}

Reference is a parsed provider:path::symbol string.

func NormalizePathReference(ref Reference) Reference

func Parse(s string) Reference

func (r Reference) String() string

type Resolver ¶

type Resolver struct {
	// RootDir is the project/module working directory used by providers that
	// run tools like `go list` / project .venv python (empty = no project context).
	RootDir string
}

Resolver performs provider-backed scope/symbol resolution in the context of a project root (e.g. serve --dir, browse root). Language/provider specifics are dispatched through registered providers; only this type carries RootDir.

func NewResolver(rootDir string) *Resolver

func (r *Resolver) ResolveScopeChildren(ref Reference, includeHidden bool) ([]ScopeChild, bool, error)

func (r *Resolver) ResolveScopeTarget(ref Reference) (ScopeTarget, bool, error)

func (r *Resolver) ResolveSymbolTarget(ref Reference) (SymbolTarget, bool, error)

type ScopeChild ¶

type ScopeChild struct {
	Ref  Reference
	Kind ScopeChildKind
}

ScopeChild is a provider-backed child scope exposed to browse UIs.

type ScopeChildKind ¶

type ScopeChildKind int

const (
	ScopeChildDir ScopeChildKind = iota
	ScopeChildFile
)

type ScopeChildrenProvider ¶

type ScopeChildrenProvider interface {
	ListScopeChildren(ref Reference, rootDir string, includeHidden bool) ([]ScopeChild, bool, error)
}

ScopeChildrenProvider is an optional provider capability used by browse UIs.

type ScopeTarget ¶

type ScopeTarget struct {
	Dir string
	// CanDescend controls whether provider browse UIs should offer child scope
	// navigation from this target. Nil means unknown/default behavior.
	CanDescend *bool
}

ScopeTarget points to a directory that can be ingested for provider-backed scope operations such as listing.

type ScopeTargetProvider ¶

type ScopeTargetProvider interface {
	ResolveScopeTarget(ref Reference, rootDir string) (ScopeTarget, bool, error)
}

ScopeTargetProvider is an optional provider capability used by listing.

type SymbolTarget ¶

type SymbolTarget struct {
	Dir  string
	Name string
}

SymbolTarget points to a directory that can be ingested for provider-backed symbol lookup.

type SymbolTargetProvider ¶

type SymbolTargetProvider interface {
	ResolveSymbolTarget(ref Reference, rootDir string) (SymbolTarget, bool, error)
}

SymbolTargetProvider is an optional provider capability used by doc lookup. rootDir is injected by Resolver (project/module context for go list, etc.).