graph

type CodeGraph struct {
	Nodes map[string]*Node
	Edges []*Edge
	// ProjectStats summarises what the file walk saw. Set by Initialize.
	// Callers read it to render meaningful empty-state messages when
	// len(Nodes) == 0 (e.g. "Detected: TypeScript (32), JavaScript (8)").
	ProjectStats ProjectStats
}

type ComposeGraph struct {
	// Embedded YAML graph
	YAMLGraph *YAMLGraph

	// Compose-specific indexes
	Services map[string]*YAMLNode
	Volumes  map[string]*YAMLNode
	Networks map[string]*YAMLNode

	// Metadata
	Version  string
	FilePath string
}

type Edge struct {
	From *Node
	To   *Node
}

type Node struct {
	ID                   string
	Type                 string
	Name                 string
	CodeSnippet          string // DEPRECATED: Will be removed, use GetCodeSnippet() instead
	SourceLocation       *SourceLocation
	LineNumber           uint32
	OutgoingEdges        []*Edge
	IsExternal           bool
	Modifier             string
	ReturnType           string
	MethodArgumentsType  []string
	MethodArgumentsValue []string
	PackageName          string
	ImportPackage        []string
	SuperClass           string
	Interface            []string
	DataType             string
	Scope                string
	VariableValue        string
	File                 string

	ThrowsExceptions  []string
	Annotation        []string
	JavaDoc           *model.Javadoc
	BinaryExpr        *model.BinaryExpr
	ClassInstanceExpr *model.ClassInstanceExpr
	IfStmt            *model.IfStmt
	WhileStmt         *model.WhileStmt
	DoStmt            *model.DoStmt
	ForStmt           *model.ForStmt
	BreakStmt         *model.BreakStmt
	ContinueStmt      *model.ContinueStmt
	YieldStmt         *model.YieldStmt
	AssertStmt        *model.AssertStmt
	ReturnStmt        *model.ReturnStmt
	BlockStmt         *model.BlockStmt
	Language          string         // "go", "python", "java" - set during parsing
	Metadata          map[string]any // Generic key-value store for language/tool-specific metadata
	// contains filtered or unexported fields
}

type ProgressCallbacks struct {
	// OnStart is called once before processing begins, with the total number of files.
	OnStart func(totalFiles int)
	// OnProgress is called after each file is processed (successfully or with error).
	OnProgress func()
	// ExcludePatterns holds validated, normalized repo-relative path prefixes.
	// A file is skipped during the walk if its repo-relative path starts with any prefix.
	// Use validateExcludePatterns in the cmd package to produce this slice.
	ExcludePatterns []string
}

type ProjectStats struct {
	// TotalFiles is the count of every regular file walked, after applying
	// the skip-directory list and --exclude patterns.
	TotalFiles int
	// ScannedFiles is the count of files routed to one of the supported
	// tree-sitter parsers. Equals len(files) returned from getFiles.
	ScannedFiles int
	// ByLanguage is a language-display-name → file-count map covering every
	// file walked, both supported and unsupported. Files in formats
	// pathfinder cannot classify (binaries, lock files, dotfiles) are
	// omitted entirely rather than bucketed as "Other"; this keeps the
	// downstream "Detected: …" line honest about what's actually source.
	ByLanguage map[string]int
}

type SourceLocation struct {
	File      string
	StartByte uint32
	EndByte   uint32
}

type YAMLGraph struct {
	Root     *YAMLNode
	FilePath string
}

type YAMLNode struct {
	Value      any
	Children   map[string]*YAMLNode
	Type       string // "scalar", "mapping", "sequence"
	LineNumber int    // Line number in source file (1-indexed)
}