resource

type AnonymousBind struct {
	Resource ResourceOrPath
	File     *pkginfo.File
}

type Bind interface {
	Pos() token.Pos
	ResourceRef() ResourceOrPath
	Package() *pkginfo.Package
	DeclaredIn() option.Option[*pkginfo.File]

	// DescriptionForTest describes the bind for testing purposes.
	DescriptionForTest() string
}

type ImplicitBind struct {
	Resource ResourceOrPath
	Pkg      *pkginfo.Package
}

type Kind int

type Named interface {
	Resource

	// ResourceName is the name of the resource.
	ResourceName() string
}

type Path []PathEntry

type PathEntry struct {
	Kind Kind
	Name string
}

type PkgDeclBind struct {
	Resource ResourceOrPath
	File     *pkginfo.File

	// BoundName is the package-level identifier the bind is declared with.
	BoundName *ast.Ident
}

type Resource interface {
	// Node is embedded so we can use the resource in a [posmap.Map].
	// The position should be the position of the resource declaration.
	ast.Node

	// Kind is the kind of resource this is.
	Kind() Kind

	// SortKey is a string that can be used to sort resources.
	// The sort key's value is arbitrary but should provide a
	// consistent sort order regardless of the parsing order.
	// The sort key only matters between resources of the same Kind.
	SortKey() string
}

type ResourceOrPath struct {
	Resource Resource
	Path     Path
}