cbm

type Call struct {
	CalleeName      string
	EnclosingFuncQN string
	DispatchKind    string
	// CalleeIsLocallyBound: a bare call whose callee is a parameter of an
	// enclosing function; the resolver must not bind it to a project symbol.
	CalleeIsLocallyBound bool
}

type CrossFileDef struct {
	QualifiedName string
	ShortName     string
	Label         string // "Function", "Method", "Type", "Interface"
	ReceiverType  string // for methods: receiver type QN
	DefModuleQN   string // module QN where this def lives
	ReturnTypes   string // "|"-separated return type texts (e.g., "*File|error")
	EmbeddedTypes string // "|"-separated embedded type QNs
	FieldDefs     string // "|"-separated "name:type" pairs (for struct fields, e.g. "Binder:Binder|Name:string")
	MethodNames   string // "|"-separated method names for interfaces (e.g. "Get|Put|Delete")
	IsInterface   bool
}

type Definition struct {
	Name            string
	QualifiedName   string
	Label           string // "Function", "Method", "Class", "Variable", "Module", "Interface", "Enum", "Type"
	FilePath        string
	StartLine       int
	EndLine         int
	Signature       string
	ReturnType      string
	Receiver        string
	Docstring       string
	ParentClass     string
	Decorators      []string
	BaseClasses     []string
	ExtendsTypes    []string
	ImplementsTypes []string
	ParamNames      []string
	ParamTypes      []string
	ReturnTypes     []string
	Complexity      int
	Lines           int
	IsExported      bool
	IsAbstract      bool
	IsTest          bool
	IsEntryPoint    bool
}

type EnvAccess struct {
	EnvKey          string
	EnclosingFuncQN string
}

type FileResult struct {
	Definitions   []Definition
	Calls         []Call
	Imports       []Import
	Usages        []Usage
	Throws        []Throw
	ReadWrites    []ReadWrite
	TypeRefs      []TypeRef
	EnvAccesses   []EnvAccess
	TypeAssigns   []TypeAssign
	ImplTraits    []ImplTrait
	ResolvedCalls []ResolvedCall

	ModuleQN    string
	IsTestFile  bool
	ImportCount int
	// DepthCapped is true when an AST walk hit the recursion ceiling and
	// skipped a subtree; the file was indexed partially rather than crashing.
	DepthCapped bool
}

type ImplTrait struct {
	TraitName  string
	StructName string
}

type Import struct {
	LocalName      string
	ModulePath     string
	DependencyOnly bool
}

type ProfileStats struct {
	ParseNs   uint64
	ExtractNs uint64
	Files     uint64
}

type ReadWrite struct {
	VarName         string
	EnclosingFuncQN string
	IsWrite         bool
}

type ResolvedCall struct {
	CallerQN   string
	CalleeQN   string
	Strategy   string
	Confidence float32
	Reason     string // diagnostic label for unresolved calls (empty if resolved)
}

type Throw struct {
	ExceptionName   string
	EnclosingFuncQN string
}

type TypeAssign struct {
	VarName         string
	TypeName        string
	EnclosingFuncQN string
}

type TypeRef struct {
	TypeName        string
	EnclosingFuncQN string
}

type Usage struct {
	RefName         string
	EnclosingFuncQN string
}