deadcode

type DeadSymbol struct {
	Name       string `json:"name"`
	Kind       string `json:"kind"`
	File       string `json:"file"`
	Package    string `json:"package"`
	StartLine  int    `json:"start_line"`
	Lines      int    `json:"lines"`
	Exported   bool   `json:"exported"`
	Confidence string `json:"confidence"` // high, medium, low
}

type Options struct {
	IncludeExported bool                      // include exported (public) symbols — usually false positives
	IncludeTests    bool                      // include test-file symbols
	HookCallbacks   []string                  // function names registered as WordPress hook callbacks
	Relationships   []parser.TypeRelationship // type relationships for interface-aware filtering
	// OxCodes is an optional ox-codes client. When set, a second pass searches
	// for string references to apparent dead symbols, reducing false positives
	// caused by callbacks, reflection, and config-driven dispatch.
	OxCodes  *oxcodes.Client
	Root     string // repo root path (required for ox-codes queries)
	Language string // primary language (for scoped search)
	// Ctx is used for cancellation when OxCodes is set. A nil Ctx means
	// context.Background() is used.
	Ctx context.Context //nolint:containedctx
}

type Result struct {
	TotalFunctions int          `json:"total_functions"`
	DeadCount      int          `json:"dead_count"`
	DeadRatio      float64      `json:"dead_ratio"`
	DeadSymbols    []DeadSymbol `json:"dead_symbols"`
}