treesitter

type Client interface {
	// ListSymbols returns symbols defined in a file (or the whole workspace
	// when file is empty).
	ListSymbols(ctx context.Context, file string) ([]*codev0.Symbol, error)

	// NotifyChange is a no-op for tree-sitter: the parser is stateless and
	// re-parses on demand.
	NotifyChange(ctx context.Context, file string, content string) error

	// NotifySave is a no-op for tree-sitter.
	NotifySave(ctx context.Context, file string) error

	// Diagnostics returns SYNTAX errors (ERROR nodes) for a file or the
	// entire workspace (file == "").
	Diagnostics(ctx context.Context, file string) ([]DiagnosticResult, error)

	// Definition returns the definition location for the identifier at the
	// given 1-based (line, col). Uses CIS 7.1 3-step resolution.
	Definition(ctx context.Context, file string, line, col int) ([]LocationResult, error)

	// References returns all usage locations of the identifier at (line, col).
	References(ctx context.Context, file string, line, col int) ([]LocationResult, error)

	// Hover returns the node text at (line, col).
	Hover(ctx context.Context, file string, line, col int) (*HoverResult, error)

	// Close releases parser resources. Safe to call multiple times.
	Close(ctx context.Context) error
}

type DiagnosticResult struct {
	File      string
	Line      int32
	Column    int32
	EndLine   int32
	EndColumn int32
	Message   string
	Severity  string // always "error" — tree-sitter only emits ERROR nodes
	Source    string // "tree-sitter"
}

type HoverResult struct {
	Content  string
	Language string
}

type LanguageConfig struct {
	// LanguageID matches the LSP languageId convention ("go", "python").
	LanguageID string

	// FileExtensions lists source file suffixes (e.g. [".go"], [".py"]).
	FileExtensions []string

	// SkipDirs are directory names to skip when walking the workspace.
	SkipDirs []string

	// SkipSuffixes are file suffixes to skip (e.g. "_test.go").
	SkipSuffixes []string

	// Grammar returns the tree-sitter language grammar. Called once per client.
	Grammar func() *sitter.Language

	// ExtractSymbols turns a parsed tree into Symbols. Required.
	ExtractSymbols SymbolExtractor
}

type LocationResult struct {
	File       string  // relative path within the workspace
	Line       int     // 1-based
	Column     int     // 1-based
	EndLine    int     // 1-based
	EndColumn  int     // 1-based
	Confidence float32 // 0.0–1.0 per CIS confidence model
	Source     string  // "tree_sitter" | "resolved_explicit" | "resolved_wildcard"
}

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

type SymbolExtractor func(tree *sitter.Tree, content []byte, relPath string) []*codev0.Symbol