packaging

type ContentFilesEntry struct {
	Include      string `xml:"include,attr"`
	Exclude      string `xml:"exclude,attr"`
	BuildAction  string `xml:"buildAction,attr"`
	CopyToOutput string `xml:"copyToOutput,attr"`
	Flatten      string `xml:"flatten,attr"`
}

type ContentTypeDefault struct {
	Extension   string `xml:"Extension,attr"`
	ContentType string `xml:"ContentType,attr"`
}

type ContentTypeOverride struct {
	PartName    string `xml:"PartName,attr"`
	ContentType string `xml:"ContentType,attr"`
}

type ContentTypesXML struct {
	XMLName   xml.Name              `xml:"Types"`
	Xmlns     string                `xml:"xmlns,attr"`
	Defaults  []ContentTypeDefault  `xml:"Default"`
	Overrides []ContentTypeOverride `xml:"Override,omitempty"`
}

type CorePropertiesXML struct {
	XMLName        xml.Name `xml:"http://schemas.openxmlformats.org/package/2006/metadata/core-properties coreProperties"`
	XmlnsDC        string   `xml:"xmlns:dc,attr"`
	XmlnsDCTerms   string   `xml:"xmlns:dcterms,attr"`
	XmlnsXSI       string   `xml:"xmlns:xsi,attr"`
	Creator        string   `xml:"http://purl.org/dc/elements/1.1/ creator,omitempty"`
	Description    string   `xml:"http://purl.org/dc/elements/1.1/ description,omitempty"`
	Identifier     string   `xml:"http://purl.org/dc/elements/1.1/ identifier,omitempty"`
	Version        string   `xml:"version,omitempty"`
	Keywords       string   `xml:"keywords,omitempty"`
	LastModifiedBy string   `xml:"lastModifiedBy,omitempty"`
}

type DependenciesElement struct {
	Groups []DependencyGroup `xml:"group"`
	// Legacy: dependencies without groups (applies to all frameworks)
	Dependencies []Dependency `xml:"dependency"`
}

type Dependency struct {
	ID      string `xml:"id,attr"`
	Version string `xml:"version,attr"` // Version range string
	Include string `xml:"include,attr"` // Asset include filter
	Exclude string `xml:"exclude,attr"` // Asset exclude filter
}

type DependencyGroup struct {
	TargetFramework string       `xml:"targetFramework,attr"`
	Dependencies    []Dependency `xml:"dependency"`
}

type FileIOMode uint32

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

type FrameworkAssembly struct {
	AssemblyName    string `xml:"assemblyName,attr"`
	TargetFramework string `xml:"targetFramework,attr"`
}

type FrameworkReference struct {
	Name string `xml:"name,attr"`
}

type FrameworkReferenceGroup struct {
	TargetFramework string               `xml:"targetFramework,attr"`
	References      []FrameworkReference `xml:"frameworkReference"`
}

type FrameworkReferencesElement struct {
	Groups []FrameworkReferenceGroup `xml:"group"`
}

type LicenseMetadata struct {
	Type    string `xml:"type,attr"`    // "expression" or "file"
	Version string `xml:"version,attr"` // SPDX license version
	Text    string `xml:",chardata"`    // License expression or file path
}

type Logger interface {
	Info(format string, args ...any)
	Warning(format string, args ...any)
	Error(format string, args ...any)
}

type NupkgMetadataFile struct {
	Version     int    `json:"version"`     // Format version (currently 2)
	ContentHash string `json:"contentHash"` // Base64-encoded SHA512 hash
	Source      string `json:"source"`      // Source URL
}

type Nuspec struct {
	XMLName  xml.Name       `xml:"package"`
	Xmlns    string         `xml:"xmlns,attr,omitempty"`
	Metadata NuspecMetadata `xml:"metadata"`
	Files    []NuspecFile   `xml:"files>file"`
}

type NuspecFile struct {
	Source  string `xml:"src,attr"`
	Target  string `xml:"target,attr"`
	Exclude string `xml:"exclude,attr"`
}

type NuspecMetadata struct {
	// Required fields
	ID          string `xml:"id"`
	Version     string `xml:"version"`
	Description string `xml:"description"`
	Authors     string `xml:"authors"`

	// Optional fields
	Title                    string           `xml:"title"`
	Owners                   string           `xml:"owners"`
	ProjectURL               string           `xml:"projectUrl"`
	IconURL                  string           `xml:"iconUrl"`
	Icon                     string           `xml:"icon"`
	LicenseURL               string           `xml:"licenseUrl"`
	License                  *LicenseMetadata `xml:"license"`
	RequireLicenseAcceptance bool             `xml:"requireLicenseAcceptance"`
	DevelopmentDependency    bool             `xml:"developmentDependency"`
	Summary                  string           `xml:"summary"`
	ReleaseNotes             string           `xml:"releaseNotes"`
	Copyright                string           `xml:"copyright"`
	Language                 string           `xml:"language"`
	Tags                     string           `xml:"tags"`
	Serviceable              bool             `xml:"serviceable"`
	Readme                   string           `xml:"readme"`

	// Version constraints
	MinClientVersion string `xml:"minClientVersion,attr"`

	// Complex elements
	Dependencies        *DependenciesElement        `xml:"dependencies"`
	FrameworkReferences *FrameworkReferencesElement `xml:"frameworkReferences"`
	FrameworkAssemblies []FrameworkAssembly         `xml:"frameworkAssemblies>frameworkAssembly"`
	References          *ReferencesElement          `xml:"references"`
	ContentFiles        []ContentFilesEntry         `xml:"contentFiles>files"`
	PackageTypes        []PackageType               `xml:"packageTypes>packageType"`
	Repository          *RepositoryMetadata         `xml:"repository"`
}

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

type PackageDependency struct {
	ID           string
	VersionRange *version.Range
	Include      []string // Asset include filters
	Exclude      []string // Asset exclude filters
}

type PackageDependencyGroup struct {
	TargetFramework *frameworks.NuGetFramework
	Dependencies    []PackageDependency
}

type PackageExtractionContext struct {
	// PackageSaveMode controls what files to extract
	PackageSaveMode PackageSaveMode

	// XMLDocFileSaveMode controls XML documentation handling
	XMLDocFileSaveMode XMLDocFileSaveMode

	// CopySatelliteFiles enables satellite package file merging
	CopySatelliteFiles bool

	// SignatureVerifier for signed package validation (optional)
	SignatureVerifier SignatureVerifier

	// Logger for extraction progress (optional)
	Logger Logger

	// ParentID for telemetry correlation (optional)
	ParentID string
}

type PackageFile struct {
	SourcePath string    // Path on disk (or empty for in-memory)
	TargetPath string    // Path in .nupkg
	Content    []byte    // In-memory content (if SourcePath is empty)
	Reader     io.Reader // Stream content (if SourcePath is empty and Content is nil)
}

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

type PackageFrameworkAssembly struct {
	AssemblyName     string
	TargetFrameworks []*frameworks.NuGetFramework
}

type PackageFrameworkReferenceGroup struct {
	TargetFramework *frameworks.NuGetFramework
	References      []string
}

type PackageIdentity struct {
	ID      string
	Version *version.NuGetVersion
}

type PackageMetadata struct {
	// Required
	ID          string
	Version     *version.NuGetVersion
	Description string
	Authors     []string

	// Optional
	Title                    string
	Owners                   []string
	ProjectURL               *url.URL
	IconURL                  *url.URL
	Icon                     string
	LicenseURL               *url.URL
	LicenseMetadata          *LicenseMetadata
	RequireLicenseAcceptance bool
	DevelopmentDependency    bool
	Summary                  string
	ReleaseNotes             string
	Copyright                string
	Language                 string
	Tags                     []string
	Serviceable              bool
	Readme                   string

	// Version constraints
	MinClientVersion *version.NuGetVersion

	// Complex elements
	DependencyGroups         []PackageDependencyGroup
	FrameworkReferenceGroups []PackageFrameworkReferenceGroup
	FrameworkAssemblies      []PackageFrameworkAssembly
	PackageTypes             []PackageTypeInfo
	Repository               *PackageRepositoryMetadata
}

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

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

type PackageRepositoryMetadata struct {
	Type   string
	URL    string
	Branch string
	Commit string
}

type PackageSaveMode int

type PackageType struct {
	Name    string `xml:"name,attr"`
	Version string `xml:"version,attr"`
}

type PackageTypeInfo struct {
	Name    string
	Version *version.NuGetVersion
}

type ParsedDependency struct {
	ID           string
	VersionRange *version.Range
	Include      []string // Asset include patterns
	Exclude      []string // Asset exclude patterns
}

type ParsedDependencyGroup struct {
	TargetFramework *frameworks.NuGetFramework
	Dependencies    []ParsedDependency
}

type ParsedFrameworkReferenceGroup struct {
	TargetFramework *frameworks.NuGetFramework
	References      []string
}

type PathResolver interface {
	GetInstallPath(packageID string, ver *version.NuGetVersion) string
}

type Reference struct {
	File string `xml:"file,attr"`
}

type ReferenceGroup struct {
	TargetFramework string      `xml:"targetFramework,attr"`
	References      []Reference `xml:"reference"`
}

type ReferencesElement struct {
	Groups []ReferenceGroup `xml:"group"`
}

type Relationship struct {
	Type   string `xml:"Type,attr"`
	Target string `xml:"Target,attr"`
	ID     string `xml:"Id,attr"`
}

type RelationshipsXML struct {
	XMLName       xml.Name       `xml:"Relationships"`
	Xmlns         string         `xml:"xmlns,attr"`
	Relationships []Relationship `xml:"Relationship"`
}

type RepositoryMetadata struct {
	Type   string `xml:"type,attr"`
	URL    string `xml:"url,attr"`
	Branch string `xml:"branch,attr"`
	Commit string `xml:"commit,attr"`
}

type SignatureVerifier interface {
	VerifySignatureAsync(ctx context.Context, reader *PackageReader) error
}

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

type XMLDocFileSaveMode int