resolver

type ConcurrencyTracker interface {
	// Enter is called when a worker starts (after acquiring semaphore).
	Enter()
	// Exit is called when a worker finishes (before releasing semaphore).
	Exit()
}

type ConflictDetector struct{}

type ConflictResolver struct{}

type CycleAnalyzer struct{}

type CycleReport struct {
	// PackageID involved in the cycle
	PackageID string

	// PathToSelf from root to the cycle point
	PathToSelf []string

	// Depth at which cycle was detected
	Depth int

	// Description is a human-readable description
	Description string
}

type DependencyFetchResult struct {
	Info  *PackageDependencyInfo
	Error error
}

type DependencyFetchTask struct {
	// The dependency being fetched
	Dependency PackageDependency

	// Channel for receiving the result (Go equivalent of Task<T>)
	ResultChan chan *DependencyFetchResult

	// Edge information
	InnerEdge *GraphEdge
}

type DependencyGroup struct {
	TargetFramework string
	Dependencies    []PackageDependency
}

type DependencyResult int

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

type Disposition int

type DowngradeWarning struct {
	PackageID      string
	CurrentVersion string
	TargetVersion  string
	Path           []string // Path from root to downgrade
}

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

type GraphEdge struct {
	// OuterEdge - parent edge (chain to root)
	OuterEdge *GraphEdge

	// Item - the package at this edge
	Item *PackageDependencyInfo

	// Edge - the dependency that created this edge
	Edge PackageDependency
}

type GraphNode struct {
	// Key - unique identifier for this node (packageID|version)
	Key string

	// Item - package metadata and dependencies
	Item *PackageDependencyInfo

	// OuterNode - parent node (singular, for tree structure)
	OuterNode *GraphNode

	// InnerNodes - child nodes (dependencies)
	InnerNodes []*GraphNode

	// ParentNodes - tracks multiple parents when node is shared
	// Used when node is removed from outer node but needs parent tracking
	ParentNodes []*GraphNode

	// Disposition - state of this node
	Disposition Disposition

	// Depth - distance from root
	Depth int

	// OuterEdge - edge to this node from parent
	OuterEdge *GraphEdge
}

type LibraryIncludeFlags int

type NuGetErrorCode string

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

type PackageDependency struct {
	ID              string
	VersionRange    string
	TargetFramework string // Empty = all frameworks

	// Include/Exclude flags for assets
	IncludeType LibraryIncludeFlags
	ExcludeType LibraryIncludeFlags

	// SuppressParent - when LibraryIncludeFlagsAll, parent is completely suppressed (PrivateAssets="All")
	SuppressParent LibraryIncludeFlags
}

type PackageDependencyInfo struct {
	ID           string
	Version      string
	Dependencies []PackageDependency

	// For framework-specific dependencies
	DependencyGroups []DependencyGroup

	// IsUnresolved indicates this package could not be found
	// Maps to LibraryType.Unresolved in NuGet.Client
	IsUnresolved bool
}

type PackageMetadataClient interface {
	GetPackageMetadata(ctx context.Context, source string, packageID string, versionRange string) ([]*PackageDependencyInfo, error)
}

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

type ResolutionResult struct {
	Packages   []*PackageDependencyInfo
	Conflicts  []VersionConflict
	Downgrades []DowngradeWarning
	Cycles     []CycleReport
	Unresolved []UnresolvedPackage // Packages that could not be resolved
}

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

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

type UnresolvedPackage struct {
	// ID is the package identifier
	ID string

	// VersionRange is the requested version range
	VersionRange string

	// TargetFramework where this was unresolved (empty for all)
	TargetFramework string

	// ErrorCode is the NuGet error code (NU1101, NU1102, NU1103)
	ErrorCode string

	// Message is the detailed error message
	Message string

	// Sources lists sources that were checked
	Sources []string

	// AvailableVersions lists versions found (for NU1102)
	AvailableVersions []string

	// NearestVersion is the closest version found (for NU1102)
	NearestVersion string
}

type VersionConflict struct {
	PackageID string
	Versions  []string
	Paths     [][]string // Path from root to each conflicting version
}

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

type WalkerStackState struct {
	// Node being processed
	Node *GraphNode

	// Dependency creation tasks (started but not yet awaited)
	DependencyTasks []*DependencyFetchTask

	// Current index in DependencyTasks
	Index int

	// OuterEdge for this frame
	OuterEdge *GraphEdge
}