model

type Def struct {
	Kind NodeKind
	Name string
	// Parent is the index into Facts.Defs of the lexically enclosing
	// definition, or NoParent. Parents always precede their children.
	Parent int32
	// Scope holds extra qualifier segments that are not represented by a
	// parent def in this file, e.g. the receiver type of a Go method
	// ("Server") or "ns::Cls" of an out-of-line C++ method definition.
	Scope []string
	Span
	Sig   string // normalized, at most MaxSigLen bytes (see NormalizeSig)
	Flags DefFlags
}

type DefFlags uint16

type EdgeKind uint8

type Facts struct {
	Lang Lang
	// Package is the package / namespace declared in the file, if the
	// language has such a clause (Go package, Java package, C#/PHP namespace).
	Package  string
	TestFile bool // file is a test file by naming convention or content
	Defs     []Def
	Refs     []Ref
	Imports  []Import
	Inherits []Inherit
	Tests    []TestMark
}

type FileStatus uint8

type Import struct {
	// Spec is the import path as written, without quotes. C/C++ includes
	// keep their delimiters ("<stdio.h>" or "\"util.h\"") so resolvers can
	// tell system and local includes apart.
	Spec  string
	Alias string   // local alias, "" if none ("_" and "." kept verbatim for Go)
	Names []string // imported member names (Python from-import, JS named, Java single-type)
	// Wildcard is set for on-demand imports: Java a.b.*, Python from x import *,
	// C# using / C++ using namespace, JS export * from.
	Wildcard bool
	Line     uint32
}

type ImportTarget struct {
	Kind ImportTargetKind
	// Path is the repo-relative target file (TargetFile) or directory
	// (TargetModule); empty otherwise.
	Path string
	// Module is the target module identity in the same form ModuleOf
	// returns, or the external module name for TargetExternal.
	Module string
}

type ImportTargetKind uint8

type Inherit struct {
	Child     int32    // index into Facts.Defs
	Kind      EdgeKind // EdgeExtends, EdgeImplements or EdgeEmbeds
	Name      string   // target type name
	Qualifier string   // target qualifier text, "" if unqualified
	Line      uint32
	Col       uint32
}

type Lang uint8

type LanguageSpec interface {
	// Lang returns the language this spec handles.
	Lang() Lang
	// Extensions returns the file extensions (with leading dot) handled.
	Extensions() []string
	// Grammar returns the raw TSLanguage pointer exported by the grammar's
	// Go binding (e.g. tree_sitter_go.Language()). The parse layer wraps it
	// with tree_sitter.NewLanguage; keeping it opaque here keeps model free
	// of cgo.
	Grammar() unsafe.Pointer
	// QuerySource returns the tree-sitter query (.scm) used for extraction.
	QuerySource() string
	// ExtractorVersion must be bumped whenever extraction output changes;
	// it invalidates cached facts for this language only.
	ExtractorVersion() int
	// ModuleOf returns the module identity of the repo-relative file path,
	// e.g. a Go import path, Python dotted module, Java package, or the
	// file path itself for TS/JS. facts may be nil.
	ModuleOf(path string, facts *Facts, ctx RepoContext) string
	// ResolveImport maps an import spec written in fromFile (repo-relative)
	// to its target.
	ResolveImport(spec string, fromFile string, ctx RepoContext) ImportTarget
}

type MemRepo struct {
	// contains filtered or unexported fields
}

type NodeKind uint8

type Ref struct {
	Kind RefKind
	Name string // the referenced identifier, e.g. "Foo" in pkg.Foo()
	// Qualifier is the textual qualifier when it is a module/type path,
	// e.g. "pkg" in pkg.Foo() or "std::vector" in std::vector::push_back.
	Qualifier string
	// Receiver is the receiver expression text for member access on a
	// value, e.g. "s" in s.Start() or "this" / "self" / "$this".
	Receiver string
	// Enclosing is the index of the innermost enclosing def, or NoParent.
	Enclosing int32
	Line      uint32
	Col       uint32
}

type RefKind uint8

type RepoContext interface {
	// FileExists reports whether a regular, indexed-or-indexable file exists.
	FileExists(rel string) bool
	// DirExists reports whether a directory exists.
	DirExists(rel string) bool
	// ReadFile reads a small file such as go.mod, tsconfig.json or
	// composer.json. Implementations may cap the size. A missing file
	// returns an error wrapping fs.ErrNotExist.
	ReadFile(rel string) ([]byte, error)
	// ListDir returns the sorted base names of files (not directories)
	// directly inside dir.
	ListDir(dir string) []string
}

type Span struct {
	StartLine uint32
	StartCol  uint32
	EndLine   uint32
	EndCol    uint32
	StartByte uint32
	EndByte   uint32
}

type TestMark struct {
	Def    int32
	Target string
}