restore

type AssetsInfo struct {
	// ProjectAssetsFile is the path to project.assets.json
	ProjectAssetsFile string
	ProjectAssetsSize int64
	PackageCount      int
	TargetFrameworks  []string

	// CacheFile is the path to project.nuget.cache
	CacheFile     string
	CacheFileSize int64
	DgSpecHash    string
}

type CacheFile struct {
	// Version is always 2 (current cache format version)
	Version int `json:"version"`

	// DgSpecHash is base64-encoded hash of dependency graph spec
	DgSpecHash string `json:"dgSpecHash"`

	// Success indicates whether restore succeeded
	Success bool `json:"success"`

	// ProjectFilePath is absolute path to project file
	ProjectFilePath string `json:"projectFilePath"`

	// ExpectedPackageFiles lists .nupkg.sha512 paths that must exist
	ExpectedPackageFiles []string `json:"expectedPackageFiles"`

	// Logs contains warnings/errors from restore (for replay on cache hit)
	Logs []LogMessage `json:"logs"`
}

type Console interface {
	Printf(format string, args ...any)
	Error(format string, args ...any)
	Warning(format string, args ...any)
	Output() io.Writer
}

type DependencyInfo struct {
	Target  string `json:"target"`
	Version string `json:"version"`
}

type DgSpecConfig struct {
	PackagesPath     string
	FallbackFolders  []string
	Sources          []string
	ConfigPaths      []string
	RuntimeIDPath    string
	SdkAnalysisLevel string
}

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

type DiagnosticTracer interface {
	// TracePackageResolution logs package version selection.
	// Shows why a specific version was chosen from available versions.
	TracePackageResolution(packageID, constraint string, available []string, selected string, reason string)

	// TraceFrameworkCheck logs framework compatibility check.
	TraceFrameworkCheck(packageID, packageVersion string, framework string, compatible bool)

	// TraceDependencyDiscovered logs when a dependency is found.
	TraceDependencyDiscovered(parentID, dependencyID, constraint string, isDirect bool)

	// TraceDependencyGraph logs the final resolved graph.
	TraceDependencyGraph(directCount, transitiveCount int)

	// TraceProjectAnalysis logs project file details.
	// Shows SDK, target frameworks, and package references.
	TraceProjectAnalysis(projectPath string, sdk string, targetFrameworks []string, packageCount int)

	// TracePackageSources logs active package sources.
	// Shows which sources will be used for package resolution.
	TracePackageSources(sources []string)

	// TracePerformanceBreakdown logs detailed performance metrics.
	// Shows timing for each phase and per-package operations.
	TracePerformanceBreakdown(timing *PerformanceTiming)

	// TraceAssetsGeneration logs generated output files.
	// Shows file paths, sizes, and metadata about generated assets.
	TraceAssetsGeneration(assets *AssetsInfo)
}

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

type FrameworkInfo struct {
	TargetAlias       string         `json:"targetAlias"`
	ProjectReferences map[string]any `json:"projectReferences"`
}

type FrameworkResult struct {
	Framework          string        // Target framework string (e.g., "net6.0")
	DirectPackages     []PackageInfo // Packages explicitly listed for this framework
	TransitivePackages []PackageInfo // Transitive dependencies for this framework
	Errors             []*NuGetError // NuGet errors encountered during this framework's restore
	// contains filtered or unexported fields
}

type Info struct {
	ProjectUniqueName        string                   `json:"projectUniqueName"`
	ProjectName              string                   `json:"projectName"`
	ProjectPath              string                   `json:"projectPath"`
	PackagesPath             string                   `json:"packagesPath"`
	OutputPath               string                   `json:"outputPath"`
	ProjectStyle             string                   `json:"projectStyle"`
	Sources                  map[string]SourceInfo    `json:"sources"`
	FallbackFolders          []string                 `json:"fallbackFolders"`
	ConfigFilePaths          []string                 `json:"configFilePaths"`
	OriginalTargetFrameworks []string                 `json:"originalTargetFrameworks"`
	Frameworks               map[string]FrameworkInfo `json:"frameworks"`
}

type Library struct {
	Type  string   `json:"type"`
	Path  string   `json:"path,omitempty"`
	Files []string `json:"files,omitempty"`
}

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

type LockFile struct {
	Version                     int                      `json:"version"`
	Targets                     map[string]Target        `json:"targets"`
	Libraries                   map[string]Library       `json:"libraries"`
	ProjectFileDependencyGroups map[string][]string      `json:"projectFileDependencyGroups"`
	PackageFolders              map[string]PackageFolder `json:"packageFolders"`
	Project                     ProjectInfo              `json:"project"`
}

type LockFileBuilder struct {
}

type LogMessage struct {
	Code    string `json:"code"`    // NuGet error code (e.g., "NU1101")
	Level   string `json:"level"`   // Log level: "Error", "Warning", "Information"
	Message string `json:"message"` // Human-readable message

	// Optional fields
	ProjectPath  string   `json:"projectPath,omitempty"`  // Project file path
	FilePath     string   `json:"filePath,omitempty"`     // File causing the issue
	LibraryID    string   `json:"libraryId,omitempty"`    // Package ID
	TargetGraphs []string `json:"targetGraphs,omitempty"` // Affected target frameworks

	// Line/column information (omitted if zero)
	StartLineNumber   int `json:"startLineNumber,omitempty"`
	StartColumnNumber int `json:"startColumnNumber,omitempty"`
	EndLineNumber     int `json:"endLineNumber,omitempty"`
	EndColumnNumber   int `json:"endColumnNumber,omitempty"`

	// WarningLevel is only relevant for warnings (0 = show no warnings, 1 = severe)
	// Omitted from JSON if not a warning
	WarningLevel int `json:"warningLevel,omitempty"`
}

type NuGetError struct {
	Code         string        // Error code (e.g., "NU1101", "NU1102")
	Message      string        // Error message
	ProjectPath  string        // Absolute path to project file
	Sources      []string      // Source URLs involved in the error (for NU1101)
	VersionInfos []VersionInfo // Version information per source (for NU1102)
	PackageID    string        // Package ID (for NU1102 formatting)
	Constraint   string        // Version constraint (for NU1102 formatting)
}

type Options struct {
	Sources        []string
	PackagesFolder string
	ConfigFile     string
	Force          bool
	NoCache        bool
	NoDependencies bool
	Verbosity      string
}

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

type PackageFolder struct {
}

type PackageInfo struct {
	ID      string
	Version string
	Path    string

	// IsDirect indicates if this is a direct dependency
	IsDirect bool
}

type PerformanceTiming struct {
	// Phase timings
	DependencyResolution time.Duration
	PackageDownloads     time.Duration
	AssetsGeneration     time.Duration

	// Per-package resolution timing
	ResolutionTimings map[string]time.Duration // packageID -> duration

	// Per-package download timing
	DownloadTimings map[string]time.Duration // packageID -> duration
	CacheHits       map[string]bool          // packageID -> cache hit
}

type ProjectFrameworkInfo struct {
	TargetAlias  string                    `json:"targetAlias"`
	Dependencies map[string]DependencyInfo `json:"dependencies"`
}

type ProjectInfo struct {
	Version    string                          `json:"version"`
	Restore    Info                            `json:"restore"`
	Frameworks map[string]ProjectFrameworkInfo `json:"frameworks"`
}

type RealTTYDetector struct{}

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

type ResolveLatestVersionOptions struct {
	Source     string
	Prerelease bool
}

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

type Result struct {
	// DirectPackages contains packages explicitly listed in project file
	DirectPackages []PackageInfo

	// TransitivePackages contains packages pulled in as dependencies
	TransitivePackages []PackageInfo

	// FrameworkResults contains per-framework package lists (for multi-TFM projects)
	// Maps framework string (e.g., "net6.0") to the packages resolved for that framework
	FrameworkResults map[string]*FrameworkResult

	// Graph contains full dependency graph (optional, for debugging)
	Graph any // *resolver.GraphNode, but avoid import cycle

	// CacheHit indicates restore was skipped (cache valid)
	CacheHit bool

	// Errors contains NuGet errors encountered during restore
	Errors []*NuGetError

	// PerformanceTiming holds detailed timing metrics (diagnostic mode only)
	PerformanceTiming *PerformanceTiming
}

type SourceInfo struct {
}

type TTYDetector interface {
	// IsTTY returns true if w is a terminal (not piped/redirected)
	IsTTY(w io.Writer) bool

	// GetSize returns the terminal width and height (columns, rows)
	// Returns an error if w is not a terminal or size cannot be determined
	GetSize(w io.Writer) (width, height int, err error)
}

type Target map[string]TargetLibrary

type TargetLibrary struct {
	Type    string                       `json:"type"`
	Compile map[string]map[string]string `json:"compile,omitempty"` // Path to DLL -> metadata
	Runtime map[string]map[string]string `json:"runtime,omitempty"` // Path to DLL -> metadata
}

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

type VersionInfo struct {
	Source         string
	VersionCount   int
	NearestVersion string
}