astkit

type CallSite struct {
	Callee string `json:"callee"`
	Line   int    `json:"line"`
}

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

type Export struct {
	Name string     `json:"name"`
	Kind SymbolKind `json:"kind"`
}

type ImportStatement struct {
	// Raw is the original source text of the clause.
	Raw string `json:"raw"`

	// Path is the imported module/package path.
	Path string `json:"path"`

	// Alias is the local binding name, if the import was aliased.
	Alias string `json:"alias,omitempty"`

	// Group classifies the import as stdlib | external | relative when known.
	Group string `json:"group,omitempty"`

	// Line is the 1-indexed source line of the clause.
	Line int `json:"line"`
}

type LanguageKey string

type LineRange struct {
	Start int `json:"start"`
	End   int `json:"end"`
}

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

type Strategy interface {
	Language() LanguageKey
	Extensions() []string
	Extract(tree *sitter.Tree, src []byte) ([]Symbol, error)
	ExtractImports(tree *sitter.Tree, src []byte) ([]ImportStatement, error)
}

type Symbol struct {
	// Kind classifies the declaration (function, class, etc.).
	Kind SymbolKind `json:"kind"`

	// Name is the bare identifier (e.g. "Bar" for method Foo.Bar).
	Name string `json:"name"`

	// QualifiedName disambiguates within a file (e.g. "Foo.Bar" for methods
	// of class Foo). For top-level symbols it equals Name.
	QualifiedName string `json:"qualifiedName"`

	// ParentName is the immediate enclosing type/class name, if any.
	ParentName string `json:"parentName,omitempty"`

	// Signature is the declaration text without a body (best-effort).
	Signature string `json:"signature"`

	// Docstring is the language-idiomatic documentation comment immediately
	// preceding the declaration, if any. Producers MAY leave this empty and
	// let downstream consumers attach it from raw source.
	Docstring string `json:"docstring,omitempty"`

	// Body is the full source text covering the declaration including its
	// body. Required by consumers that need to reconstruct merged source
	// (Fuse). Grove may drop this before persisting.
	Body string `json:"body,omitempty"`

	// Span is the 1-indexed inclusive line range covered by Body.
	Span LineRange `json:"span"`

	// Exported reports whether the declaration is visible outside its
	// defining unit (file/module/package), per language semantics.
	Exported bool `json:"exported"`

	// Modifiers lists language-idiomatic modifier keywords (public, static,
	// async, pub, etc.).
	Modifiers []string `json:"modifiers,omitempty"`

	// TypeParameters lists generic type parameters declared on the symbol
	// (e.g. ["T", "U"] for `func F[T any, U Comparable]`).
	TypeParameters []string `json:"typeParameters,omitempty"`

	// Annotations lists raw annotation/decorator/attribute text attached to
	// the symbol (Java @Override, Rust #[derive(...)], Python @cache, …).
	Annotations []string `json:"annotations,omitempty"`

	// CallSites records every call expression observed inside Body, when the
	// strategy supports call-site extraction.
	CallSites []CallSite `json:"callSites,omitempty"`
}

type SymbolKind string