manifest

type DependencyPatch struct {
	Pkg          resolve.PackageKey // The package this applies to
	Type         dep.Type           // The dependency type
	OrigRequire  string             // The original requirement string e.g. "1.*.*"
	NewRequire   string             // The new requirement string e.g. "2.*.*"
	OrigResolved string             // The version the original resolves to e.g. "1.2.3" (for display only)
	NewResolved  string             // The version the new resolves to e.g. "2.4.6" (for display only)
}

type Manifest struct {
	FilePath          string                          // Path to the manifest file on disk
	Root              resolve.Version                 // Version representing this package
	Requirements      []resolve.RequirementVersion    // All direct requirements, including dev
	Groups            map[resolve.PackageKey][]string // Dependency groups that the imports belong to
	LocalManifests    []Manifest                      // manifests of local packages
	EcosystemSpecific any                             // Any ecosystem-specific information needed
}

type ManifestIO interface {
	// Read parses a manifest file into a Manifest, possibly recursively following references to other local manifest files
	Read(file lockfile.DepFile) (Manifest, error)
	// Write applies the ManifestPatch to the manifest, with minimal changes to the file.
	// `original` is the original manifest file to read from. The updated manifest is written to `output`.
	Write(original lockfile.DepFile, output io.Writer, patches ManifestPatch) error
}

type ManifestPatch struct {
	Manifest          *Manifest         // The original manifest
	Deps              []DependencyPatch // Changed direct dependencies
	EcosystemSpecific any               // Any ecosystem-specific information
}

type MavenManifestIO struct{}

type MavenManifestSpecific struct {
	Properties                 []PropertyWithOrigin
	RequirementsWithProperties []resolve.RequirementVersion
}

type MavenPropertyPatches map[string]map[string]string // origin -> tag -> value

type NpmManifestIO struct{}

type PackageJSON struct {
	Name    string `json:"name"`
	Version string `json:"version"`
	// TODO: yarn allows workspaces to be a object OR a list:
	// https://classic.yarnpkg.com/blog/2018/02/15/nohoist/
	Workspaces           []string          `json:"workspaces"`
	Dependencies         map[string]string `json:"dependencies"`
	DevDependencies      map[string]string `json:"devDependencies"`
	OptionalDependencies map[string]string `json:"optionalDependencies"`

	// These fields are currently only used when parsing package-lock.json
	PeerDependencies map[string]string `json:"peerDependencies"`
}

type PropertyWithOrigin struct {
	maven.Property
	Origin string // Origin indicates where the property comes from
}