callgraph

const (
	// ── Call relationships (function/method → function/method) ───────────────
	CallDirect    CallType = "direct"    // explicit synchronous call: A()
	CallDynamic   CallType = "dynamic"   // via function pointer, stored closure, or first-class function
	CallInterface CallType = "interface" // via interface/virtual/dynamic dispatch
	CallCallback  CallType = "callback"  // passed as a callback or higher-order argument
	CallAsync     CallType = "async"     // concurrent/async invocation: goroutine spawn, JS await, Python asyncio, thread

	// ── Type / structural relationships ──────────────────────────────────────
	CallImplements   CallType = "implements"   // type → interface/trait/protocol/ABC it satisfies
	CallExtends      CallType = "extends"      // type → parent type (class inheritance, struct embedding, mixin)
	CallOverrides    CallType = "overrides"    // method → parent method it overrides/shadows
	CallInstantiates CallType = "instantiates" // function/method → type it constructs (new, make, literal, factory)
	CallContains     CallType = "contains"     // type → type of a field/property it holds (composition)
	CallAliases      CallType = "aliases"      // type → type it is an alias/typedef for

	// ── Dependency relationships ──────────────────────────────────────────────
	CallImports   CallType = "imports"   // module → module it imports or depends on
	CallUses      CallType = "uses"      // function/method → type or const it references without instantiating
	CallReads     CallType = "reads"     // function/method → module/global variable it reads
	CallWrites    CallType = "writes"    // function/method → module/global variable it writes or mutates
	CallDecorates CallType = "decorates" // function/class → entity it wraps or transforms (Python/TS decorator)
	CallThrows    CallType = "throws"    // function/method → exception/error type it can raise
)

const (
	// ── Callable entities ────────────────────────────────────────────────────
	KindFunction    NodeKind = "function"    // standalone callable: Go func, Python def, JS function, Rust fn, C function
	KindMethod      NodeKind = "method"      // instance-bound callable: Go method, Python instance method, Java/C# method
	KindConstructor NodeKind = "constructor" // instance creation: Python __init__, Java/C# constructor, Rust new(), Swift init
	KindInit        NodeKind = "init"        // module/package initializer: Go init(), Python module-level setup, static initializers

	// ── Structural entities ───────────────────────────────────────────────────
	KindType      NodeKind = "type"      // composite data type: Go struct, Python/Java/TS class, Rust struct/enum-with-data, Swift struct, record
	KindInterface NodeKind = "interface" // behavioral contract: Go interface, Rust trait, Java/C# interface, Python ABC/Protocol, Swift protocol, TS interface
	KindEnum      NodeKind = "enum"      // pure named-value set: Java enum, TS enum, Python Enum, C/C++ enum, Swift enum (no associated values)

	// ── Value entities ────────────────────────────────────────────────────────
	KindConst    NodeKind = "const"    // named constant: Go const, Rust const/static, Java static final, JS/TS const, C #define/constexpr
	KindVariable NodeKind = "variable" // module/global mutable state: Go package var, Python global, JS module-level let, Rust static mut

	// ── Organizational entities ───────────────────────────────────────────────
	KindModule NodeKind = "module" // organizational unit: Go package, Python module, JS/TS ES module, Rust mod, C++ namespace, Java package
	KindMacro  NodeKind = "macro"  // code-generating metaprogramming: Rust macro, C/C++ macro, Lisp macro, Elixir macro
)