projectconfig

type CheckConfig struct {
	// Skip indicates whether the %check section should be disabled for this component.
	Skip bool `` /* 153-byte string literal not displayed */
	// SkipReason provides a required justification when Skip is true.
	SkipReason string `` /* 170-byte string literal not displayed */
}

type ComponentBuildConfig struct {
	// Which features should be enabled via `with` options to the builder.
	With []string `` /* 126-byte string literal not displayed */
	// Which features should be disabled via `without` options to the builder.
	Without []string `` /* 138-byte string literal not displayed */
	// Macro definitions.
	Defines map[string]string `` /* 140-byte string literal not displayed */
	// Undefine macros that would otherwise be defined by the component configuration.
	Undefines []string `` /* 154-byte string literal not displayed */
	// Check section configuration.
	Check CheckConfig `` /* 133-byte string literal not displayed */
	// Failure configuration and policy for this component's build.
	Failure ComponentBuildFailureConfig `` /* 194-byte string literal not displayed */
	// Hints for how or when to build the component; must not be required for correctness of builds.
	Hints ComponentBuildHints `` /* 164-byte string literal not displayed */
}

type ComponentBuildFailureConfig struct {
	// Expected indicates that this component is expected to fail building. This is intended to be used as a temporary
	// marker for components that are expected to fail until they can be fixed.
	Expected bool `` /* 159-byte string literal not displayed */
	// ExpectedReason provides a required justification when Expected is true.
	ExpectedReason string `` /* 195-byte string literal not displayed */
}

type ComponentBuildHints struct {
	// Expensive indicates that building this component is relatively expensive compared to the rest of the distro.
	Expensive bool `` /* 207-byte string literal not displayed */
}

type ComponentConfig struct {
	// The component's name; not actually present in serialized files.
	Name string `toml:"-" json:"name" table:",sortkey" fingerprint:"-"`

	// Reference to the source config file that this definition came from; not present
	// in serialized files.
	SourceConfigFile *ConfigFile `toml:"-" json:"-" table:"-" fingerprint:"-"`

	// RenderedSpecDir is the output directory for this component's rendered spec files.
	// Derived at resolve time from the project's rendered-specs-dir setting; not present
	// in serialized files. Empty when rendered-specs-dir is not configured.
	RenderedSpecDir string `toml:"-" json:"renderedSpecDir,omitempty" table:"-" fingerprint:"-"`

	// Locked holds resolved lock file state for this component. Populated by
	// the component resolver from the lock store. Nil when no lock file exists.
	// During 'component update', this field may be cleared before re-resolving
	// to prevent the source provider from short-circuiting with stale values.
	Locked *ComponentLockData `toml:"-" json:"locked,omitempty" table:"-" fingerprint:"-"`

	// Where to get its spec and adjacent files from.
	Spec SpecSource `` /* 132-byte string literal not displayed */

	// Release configuration for this component.
	Release ReleaseConfig `` /* 179-byte string literal not displayed */

	// Overlays to apply to sources after they've been acquired. May mutate the spec as well as sources.
	Overlays []ComponentOverlay `` /* 159-byte string literal not displayed */

	// OverlayFiles, if set, lists path or glob patterns (relative to this component config file)
	// matched against the filesystem after component config resolution to locate per-file overlay documents.
	// Each matched file is parsed as an [OverlayFile]: one logical change consisting of a
	// file-level `[metadata]` block plus an ordered list of `[[overlays]]`. The per-file
	// metadata is stamped onto every overlay in the file. Matches are concatenated in the
	// order patterns are declared; within a single pattern, matches are applied in
	// filename (lexicographic) order, using the full path as a tie-breaker when
	// filenames match. Duplicate matches are de-duplicated, preserving first
	// occurrence. The resulting overlays are appended to [ComponentConfig.Overlays]
	// after any inline overlays. A value set in a higher-priority config layer replaces
	// lower-priority overlay-files values; an explicit empty list disables inherited
	// overlay files. Excluded from the fingerprint because the value affects only where
	// overlays are sourced from, not their content.
	OverlayFiles []string `` /* 408-byte string literal not displayed */

	// Configuration for building the component.
	Build ComponentBuildConfig `` /* 147-byte string literal not displayed */

	// Configuration for rendering the component.
	Render ComponentRenderConfig `` /* 151-byte string literal not displayed */

	// Source file references for this component.
	SourceFiles []SourceFileReference `` /* 156-byte string literal not displayed */

	// Per-package configuration overrides, keyed by exact binary package name.
	// Takes precedence over package-group defaults.
	Packages map[string]PackageConfig `` /* 197-byte string literal not displayed */

	// Publish holds the component-level publish settings. These provide default channels for
	// all packages produced by this component. Overridden by package-group and per-package settings
	// for binary and debuginfo channels.
	Publish ComponentPublishConfig `` /* 164-byte string literal not displayed */
}

type ComponentGroupConfig struct {
	// A human-friendly description of this component group.
	Description string `` /* 136-byte string literal not displayed */

	// Optional documentation metadata describing this component group's intent and provenance.
	// It reuses the overlay metadata schema (see [OverlayMetadata]) and does not affect how the
	// group's members are resolved or built.
	Metadata *OverlayMetadata `` /* 148-byte string literal not displayed */

	// List of explicitly included components, identified by name.
	Components []string `` /* 152-byte string literal not displayed */

	// List of glob patterns specifying raw spec files that define components.
	SpecPathPatterns []string `` /* 218-byte string literal not displayed */
	// List of glob patterns specifying files to specifically ignore from spec selection.
	ExcludedPathPatterns []string `` /* 210-byte string literal not displayed */

	// Default configuration to apply to component members of this group.
	DefaultComponentConfig ComponentConfig `` /* 218-byte string literal not displayed */
}

type ComponentLockData struct {
	// UpstreamCommit is the resolved upstream commit from the lock file.
	UpstreamCommit string `json:"upstreamCommit,omitempty"`
	// ImportCommit is the upstream commit at fork time (write-once).
	ImportCommit string `json:"importCommit,omitempty"`
	// ManualBump is the extra rebuild counter.
	ManualBump int `json:"manualBump,omitempty"`
	// InputFingerprint is the stored fingerprint from the last update.
	// Covers build inputs (config, overlays, commit, manual bump, release ver)
	// but excludes resolution inputs like snapshot timestamp.
	InputFingerprint string `json:"inputFingerprint,omitempty"`
	// ResolutionInputHash is the stored hash of resolution inputs (snapshot,
	// distro ref, pin, upstream name). Used to determine if the locked commit
	// needs re-resolution.
	ResolutionInputHash string `json:"resolutionInputHash,omitempty"`
	// Freshness indicates whether the component's config matches its lock.
	// Runtime-only — computed by the resolver when freshness checking is enabled.
	Freshness FreshnessStatus `json:"-"`
	// ResolutionStale indicates whether resolution inputs specifically changed,
	// as opposed to build-only inputs. When true, re-resolution is needed.
	// When false but Freshness is Stale, only build inputs changed and the
	// locked commit can be reused.
	ResolutionStale bool `json:"-"`
}

type ComponentOverlay struct {
	// The type of overlay to apply.
	Type ComponentOverlayType `` /* 470-byte string literal not displayed */
	// Human readable description of overlay; primarily present to document the need for the change.
	Description string `` /* 154-byte string literal not displayed */

	// For overlays that apply to non-spec files, indicates the filename. For overlays that can
	// apply to multiple files, supports glob patterns (including globstar).
	Filename string `` /* 190-byte string literal not displayed */
	// For archive-scoped overlays (file-remove and file-search-replace), the name of the source
	// archive to extract, modify, and repack (e.g. "pkg-1.0.tar.gz"). When set, [ComponentOverlay.Filename]
	// is interpreted as a glob relative to the archive's extraction root rather than a loose
	// file in the sources tree.
	Archive string `` /* 257-byte string literal not displayed */
	// For overlays that apply to specs, indicates the name of the section to which it applies.
	// Optional for spec-prepend-lines, spec-append-lines, and spec-search-replace: when omitted,
	// the overlay targets the entire spec file (prepend at top, append at end, search-replace
	// across all sections).
	SectionName string `` /* 276-byte string literal not displayed */
	// For overlays that apply to specs, indicates the name of the sub-package to which it applies.
	// A sub-package is always a sub-qualifier of a section, so this field cannot be combined
	// with an omitted SectionName on overlays that support whole-file targeting.
	PackageName string `` /* 242-byte string literal not displayed */
	// For overlays that apply to spec tags, indicates the name of the tag.
	Tag string `` /* 144-byte string literal not displayed */
	// For overlays that apply to values in specs, an exact string value to match.
	Value string `toml:"value,omitempty" json:"value,omitempty" jsonschema:"title=Value,description=An exact string value to match in the spec"`
	// For overlays that use a regular expression to match text in the spec, the regular expression to match.
	Regex string `` /* 139-byte string literal not displayed */
	// For overlays that replace text in a spec, the replacement text to use.
	Replacement string `` /* 145-byte string literal not displayed */
	// For overlays that reference lines of text, the lines of text to use.
	Lines []string `toml:"lines,omitempty" json:"lines,omitempty" jsonschema:"title=Lines,description=The lines of text to use"`
	// For overlays that require a source file as input, indicates a path to that file; relative paths are relative to
	// the config file that defines the overlay.
	// Excluded from fingerprint because it contains an absolute path that varies by checkout
	// location. Overlay content is hashed separately by [fingerprint.ComputeIdentity].
	Source string `` /* 254-byte string literal not displayed */

	// Metadata describes the intent and provenance of the overlay (category, related
	// commits, bug links, upstreamability, etc.). Optional. Populated either inline
	// in the component config file or by the [ComponentConfig.OverlayFiles] loader,
	// which stamps the per-file metadata onto every overlay declared in that file.
	// Excluded from the fingerprint because it is documentation only.
	Metadata *OverlayMetadata `` /* 186-byte string literal not displayed */
}

type ComponentOverlayType string

type ComponentPublishConfig struct {
	// RPMChannel identifies the publish channel for binary (non-debuginfo) packages
	// produced by this component. When empty, the value is inherited from the next layer
	// in the resolution order.
	RPMChannel string `` /* 210-byte string literal not displayed */

	// SRPMChannel identifies the publish channel for the SRPM produced by this component.
	// When empty, the value is inherited from the next layer in the resolution order.
	SRPMChannel string `` /* 206-byte string literal not displayed */

	// DebugInfoChannel identifies the publish channel for debuginfo packages produced
	// by this component. When empty, the value is inherited from the next layer in the
	// resolution order.
	DebugInfoChannel string `` /* 231-byte string literal not displayed */
}

type ComponentReference struct {
	// Name of the component.
	Name string

	// Version of the component (optional).
	Version *rpm.Version
}

type ComponentRenderConfig struct {
	// SkipFileFilter, when true, disables the post-render file filter for this
	// component. Normally, rendered output is filtered to only include files
	// referenced by Source/Patch tags in the spec (as reported by spectool).
	// Some specs use macros that spectool cannot expand, causing referenced
	// files to be incorrectly removed. Setting this to true preserves all
	// files from the dist-git checkout.
	SkipFileFilter bool `` /* 204-byte string literal not displayed */
}

type ConfigFile struct {
	// URI for the schema for this file format.
	SchemaURI string `toml:"$schema,omitempty"`

	// Basic project info.
	Project *ProjectInfo `toml:"project,omitempty" jsonschema:"title=Project info,description=Basic properties for this project"`

	// List of glob patterns specifying additional config files to load and deserialize.
	Includes []string `` /* 155-byte string literal not displayed */

	// Definitions of distros.
	Distros map[string]DistroDefinition `toml:"distros,omitempty" jsonschema:"title=Distros,description=Definitions of distros to build for or consume from"`

	// Reusable resource definitions (e.g., RPM repositories) referenced from
	// elsewhere in the configuration.
	Resources *ResourcesConfig `toml:"resources,omitempty" jsonschema:"title=Resources,description=Reusable named resource definitions"`

	// Definitions of component groups.
	ComponentGroups map[string]ComponentGroupConfig `` /* 146-byte string literal not displayed */

	// Definitions of components.
	Components map[string]ComponentConfig `` /* 128-byte string literal not displayed */

	// Definitions of images.
	Images map[string]ImageConfig `toml:"images,omitempty" validate:"dive" jsonschema:"title=Images,description=Definitions of images for this project"`

	// Configuration for tools used by azldev.
	Tools *ToolsConfig `toml:"tools,omitempty" jsonschema:"title=Tools configuration,description=Configuration for tools used by azldev"`

	// DefaultComponentConfig is the project-wide default component configuration applied before any
	// component-group or component-level config is considered.
	DefaultComponentConfig *ComponentConfig `` /* 181-byte string literal not displayed */

	// DefaultPackageConfig is the project-wide default package configuration applied before any
	// package-group or component-level config is considered.
	DefaultPackageConfig *PackageConfig `` /* 182-byte string literal not displayed */

	// Definitions of package groups. Groups allow shared configuration
	// to be applied to sets of binary packages.
	PackageGroups map[string]PackageGroupConfig `` /* 163-byte string literal not displayed */

	// Definitions of test suites.
	TestSuites map[string]TestSuiteConfig `` /* 131-byte string literal not displayed */
	// contains filtered or unexported fields
}

type DistroDefinition struct {
	// Human-readable description of the distro.
	Description string `` /* 127-byte string literal not displayed */

	// Optionally provides a default version to use for this distro when one is not explicitly specified.
	DefaultVersion string `` /* 143-byte string literal not displayed */

	// The base URI of this distro's dist-git spec source repository.
	DistGitBaseURI string `` /* 179-byte string literal not displayed */

	// The base URI of this distro's lookaside cache for source archives.
	LookasideBaseURI string `` /* 175-byte string literal not displayed */

	// Published artifact information
	PackageRepositories []PackageRepository `` /* 136-byte string literal not displayed */

	// When true, source file downloads will not fall back to configured origins if the lookaside cache fails.
	DisableOrigins bool `` /* 213-byte string literal not displayed */

	// Versions: maps version => definition
	Versions map[string]DistroVersionDefinition `` /* 129-byte string literal not displayed */
}

type DistroReference struct {
	// Name of the referenced distro.
	Name string `toml:"name" json:"name,omitempty" jsonschema:"required,title=Name,description=Name of the referenced distro"`
	// Version of the referenced distro.
	Version string `toml:"version,omitempty" json:"version,omitempty" jsonschema:"title=Version,description=Version of the referenced distro"`
	// Snapshot date/time for source code if specified components will use source as it existed at this time.
	// Note: set this on the distro or group default-component-config, not on individual components.
	// Per-component snapshots are rejected when lock validation is enabled.
	Snapshot string `` /* 262-byte string literal not displayed */
}

type DistroVersionDefinition struct {
	// Human-readable description of this version
	Description string `` /* 149-byte string literal not displayed */

	// Formal `releasever` for this version.
	ReleaseVer string `toml:"release-ver" json:"releaseVer,omitempty" jsonschema:"title=Release version,description=Formal releasever string"`

	// Dist-git branch for this version (if applicable)
	DistGitBranch string `` /* 161-byte string literal not displayed */

	// Default config for components.
	DefaultComponentConfig ComponentConfig `` /* 212-byte string literal not displayed */

	// Path to mock configuration file for this project (if one exists).
	MockConfigPath        string `` /* 195-byte string literal not displayed */
	MockConfigPathX86_64  string `` /* 202-byte string literal not displayed */
	MockConfigPathAarch64 string `` /* 203-byte string literal not displayed */

	// Inputs maps build use-cases ([UseCaseRPMBuild], [UseCaseImageBuild]) to
	// ordered lists of input references. Each entry references either a
	// [RpmRepoResource] or a [RpmRepoSet]; sets are expanded at validation time.
	Inputs DistroVersionInputs `toml:"inputs,omitempty" json:"inputs,omitempty" jsonschema:"title=Inputs,description=Per-use-case input repositories"`
}

type DistroVersionInput struct {
	// Repo names a top-level [ResourcesConfig.RpmRepos] entry. Mutually
	// exclusive with `Set`.
	Repo string `` /* 153-byte string literal not displayed */

	// Set names a top-level [ResourcesConfig.RpmRepoSets] entry. Mutually
	// exclusive with `Repo`.
	Set string `` /* 155-byte string literal not displayed */
}

type DistroVersionInputs struct {
	// RpmBuild is the ordered list of inputs made available when building RPMs
	// (the mock/comp build path). Order is preserved on emission but not
	// interpreted as priority by dnf.
	RpmBuild []DistroVersionInput `` /* 162-byte string literal not displayed */

	// ImageBuild is the ordered list of inputs made available when building
	// images (the kiwi/image build path). Order is preserved on emission but
	// not interpreted as priority by kiwi.
	ImageBuild []DistroVersionInput `` /* 170-byte string literal not displayed */
}

type FreshnessStatus int

type ImageCapabilities struct {
	// MachineBootable indicates whether the image can be booted on a machine (bare metal,
	// VM, etc.). Images that lack a kernel are not machine-bootable.
	MachineBootable *bool `` /* 178-byte string literal not displayed */

	// Container indicates whether the image can be run on an OCI container host.
	Container *bool `` /* 148-byte string literal not displayed */

	// Systemd indicates whether the image runs systemd as its init system.
	Systemd *bool `` /* 138-byte string literal not displayed */

	// RuntimePackageManagement indicates whether the image supports installing or
	// removing packages at runtime (e.g., via dnf/tdnf).
	RuntimePackageManagement *bool `` /* 213-byte string literal not displayed */
}

type ImageConfig struct {
	// The image's name; not actually present in serialized TOML files.
	Name string `toml:"-" json:"name" table:",sortkey"`

	// Reference to the source config file that this definition came from; not present
	// in serialized files.
	SourceConfigFile *ConfigFile `toml:"-" json:"-" table:"-"`

	// Description of the image.
	Description string `toml:"description,omitempty" json:"description,omitempty" jsonschema:"title=Description,description=Description of the image"`

	// Where to find its definition.
	Definition ImageDefinition `` /* 152-byte string literal not displayed */

	// Capabilities describes the features and properties of this image.
	Capabilities ImageCapabilities `` /* 141-byte string literal not displayed */

	// Tests holds the test configuration for this image, including which test suites
	// apply to it.
	Tests ImageTestsConfig `toml:"tests,omitempty" json:"tests,omitempty" jsonschema:"title=Tests,description=Test configuration for this image"`

	// Publish holds the publish settings for this image.
	Publish ImagePublishConfig `` /* 132-byte string literal not displayed */
}

type ImageCustomizerConfig struct {
	// Full tag name of the Image Customizer container.
	ContainerTag string `` /* 152-byte string literal not displayed */
}

type ImageDefinition struct {
	// DefinitionType indicates the type of image definition.
	DefinitionType ImageDefinitionType `toml:"type,omitempty" json:"type,omitempty" jsonschema:"title=Type,description=Type of image definition"`

	// Path points to the image definition file.
	Path string `toml:"path,omitempty" json:"path,omitempty" jsonschema:"title=Path,description=Path to the image definition file"`

	// Profile is an optional field that specifies the profile to use when building the image.
	Profile string `` /* 161-byte string literal not displayed */
}

type ImageDefinitionType string

type ImagePublishConfig struct {
	// Channels lists the publish channels for this image.
	Channels []string `` /* 183-byte string literal not displayed */
}

type ImageTestsConfig struct {
	// TestSuites is the list of test suite references that apply to this image. Each
	// reference identifies a test suite defined in the top-level [test-suites] section
	// and may carry per-test metadata in the future (e.g., required vs optional).
	TestSuites []TestSuiteRef `` /* 154-byte string literal not displayed */
}

type Origin struct {
	// Type indicates how the source file should be acquired.
	Type OriginType `` /* 153-byte string literal not displayed */
	// Uri to download the source file from if origin type is 'download'. Ignored for other origin types.
	Uri string `` /* 200-byte string literal not displayed */

	// Script is the filename of a shell script, relative to the component's spec directory,
	// that is run inside a mock chroot to generate this source file.
	// Required when [Origin.Type] is 'custom'; must be empty otherwise.
	Script string `` /* 234-byte string literal not displayed */

	// MockPackages is a list of RPM package names to install in the mock chroot before
	// running [Origin.Script]. Only valid when [Origin.Type] is 'custom'.
	MockPackages []string `` /* 227-byte string literal not displayed */

	// Inputs is a list of source-output filenames to copy next to [Origin.Script]
	// before it runs. Each entry must be a plain filename. Only valid when
	// [Origin.Type] is 'custom'.
	Inputs []string `` /* 214-byte string literal not displayed */
}

type OriginType string

type OverlayCategory string

type OverlayFile struct {
	// Metadata is the shared metadata for every overlay in this file. Required.
	Metadata OverlayMetadata `toml:"metadata"`

	// Overlays is the ordered list of overlays applied by this file. Must be non-empty.
	// Per-overlay `metadata` is not allowed — the file-level [OverlayFile.Metadata] is
	// the single source of truth.
	Overlays []ComponentOverlay `toml:"overlays"`
}

type OverlayMetadata struct {
	// Category classifies the overlay's intent. Required.
	Category OverlayCategory `` /* 382-byte string literal not displayed */

	// Commits references upstream commits (typically Fedora dist-git or upstream-project
	// commits) that this overlay backports or references. Each entry must carry an
	// http(s) URL (see [URLRef]).
	Commits []URLRef `` /* 168-byte string literal not displayed */

	// Bugs holds references to issue-tracker entries related to this overlay. Each entry
	// must carry an http(s) URL (see [URLRef]).
	Bugs []URLRef `` /* 175-byte string literal not displayed */

	// UpstreamStatus classifies the overlay's relationship to its upstream project.
	// Required. Use [OverlayUpstreamStatusUnknown] when the assessment has not been
	// made yet; reviewers should push for a definite status before approving.
	UpstreamStatus OverlayUpstreamStatus `` /* 252-byte string literal not displayed */
}

type OverlayUpstreamStatus string

type PackageConfig struct {
	// Publish holds the publish settings for this package.
	Publish PackagePublishConfig `` /* 157-byte string literal not displayed */
}

type PackageGroupConfig struct {
	// Description is an optional human-readable description of this group.
	Description string `` /* 149-byte string literal not displayed */

	// Packages is an explicit list of binary package names that belong to this group.
	Packages []string `` /* 160-byte string literal not displayed */

	// DefaultPackageConfig is the configuration applied to all packages listed in Packages.
	DefaultPackageConfig PackageConfig `` /* 185-byte string literal not displayed */
}

type PackagePublishConfig struct {
	// RPMChannel identifies the publish channel specifically for binary (non-debuginfo)
	// packages. When set at the package level, it overrides the component-level
	// [ComponentPublishConfig.RPMChannel]. When empty, the value is inherited. The
	// reserved value `"none"` keeps RPMs in the base directory and means they should
	// not be published.
	RPMChannel string `` /* 293-byte string literal not displayed */
	// DebugInfoChannel identifies the publish channel specifically for debuginfo packages.
	// When set at the package level, it overrides the component-level
	// [ComponentPublishConfig.DebugInfoChannel]. When empty, the value is inherited.
	// The reserved value `"none"` keeps RPMs in the base directory and means they
	// should not be published.
	DebugInfoChannel string `` /* 320-byte string literal not displayed */

	// Deprecated: use 'rpm-channel' instead. When set, the value is used as a fallback
	// for [PackagePublishConfig.RPMChannel] during channel resolution if 'rpm-channel' is not
	// already set. Kept for backwards compatibility with older config files.
	DeprecatedChannel string `` /* 251-byte string literal not displayed */
}

type PackageRepository struct {
	BaseURI string `toml:"base-uri" json:"baseUri" jsonschema:"required,title=Base URI,description=Base URI for the repository"`
}

type ProjectConfig struct {
	// Basic project info.
	Project ProjectInfo `toml:"project,omitempty" json:"project,omitempty" jsonschema:"title=Project Info,description=Basic project information"`
	// Definitions of component groups.
	ComponentGroups map[string]ComponentGroupConfig `` /* 165-byte string literal not displayed */
	// Definitions of components.
	Components map[string]ComponentConfig `` /* 142-byte string literal not displayed */
	// Definitions of images.
	Images map[string]ImageConfig `` /* 126-byte string literal not displayed */
	// Definitions of distros.
	Distros map[string]DistroDefinition `` /* 133-byte string literal not displayed */
	// Reusable resource definitions (e.g., RPM repositories) referenced from
	// elsewhere in the configuration.
	Resources ResourcesConfig `` /* 130-byte string literal not displayed */
	// Configuration for tools used by azldev.
	Tools ToolsConfig `` /* 135-byte string literal not displayed */

	// DefaultComponentConfig is the project-wide default applied to every component before any
	// component-group or component-level config is considered. It is the lowest-priority layer in
	// the component publish config resolution order.
	DefaultComponentConfig ComponentConfig `` /* 221-byte string literal not displayed */

	// DefaultPackageConfig is the project-wide default applied to every binary package before any
	// package-group or component-level config is considered. It is the lowest-priority layer in the
	// package config resolution order.
	DefaultPackageConfig PackageConfig `` /* 220-byte string literal not displayed */

	// Definitions of package groups with shared configuration.
	PackageGroups map[string]PackageGroupConfig `` /* 182-byte string literal not displayed */

	// Definitions of test suites.
	TestSuites map[string]TestSuiteConfig `` /* 145-byte string literal not displayed */

	// Root config file path; not serialized.
	RootConfigFilePath string `toml:"-" json:"-"`
	// Map from component names to groups they belong to; not serialized.
	GroupsByComponent map[string][]string `toml:"-" json:"-"`
}

type ProjectInfo struct {
	// Human-readable description of this project.
	Description string `` /* 135-byte string literal not displayed */

	// Path to log directory to use for this project.
	LogDir string `` /* 132-byte string literal not displayed */
	// Path to temp work directory to use for this project.
	WorkDir string `` /* 145-byte string literal not displayed */
	// Path to output directory to use for this project.
	OutputDir string `` /* 143-byte string literal not displayed */

	// Path to the output directory for rendered specs (component render).
	RenderedSpecsDir string `` /* 175-byte string literal not displayed */

	// Path to the directory for per-component lock files.
	LockDir string `` /* 149-byte string literal not displayed */

	// Default-selected distro. May be overridden at runtime.
	DefaultDistro DistroReference `` /* 142-byte string literal not displayed */

	// Default email address used for synthetic changelog entries and commits
	// when no author email is available (e.g. when no synthetic commits exist).
	DefaultAuthorEmail string `` /* 183-byte string literal not displayed */
}

type PytestConfig struct {
	// WorkingDir is the directory to use as the current working directory when running pytest.
	// Relative paths are resolved against the config file's directory.
	WorkingDir string `` /* 149-byte string literal not displayed */

	// TestPaths is the list of test file paths or directories to pass to pytest as positional
	// arguments. Glob patterns (e.g., cases/test_*.py) are expanded relative to WorkingDir.
	TestPaths []string `` /* 173-byte string literal not displayed */

	// ExtraArgs is the list of additional arguments to pass to pytest. These are passed
	// verbatim after placeholder substitution. Use {image-path} as a placeholder for the
	// image path, which will be substituted at runtime.
	ExtraArgs []string `` /* 194-byte string literal not displayed */

	// Install specifies how Python dependencies are installed into the venv before running
	// pytest. Defaults to "none" (no install) when not specified.
	Install PytestInstallMode `` /* 219-byte string literal not displayed */
}

type PytestInstallMode string

type ReleaseCalculation string

type ReleaseConfig struct {
	// Calculation controls how the Release tag is managed during rendering.
	Calculation ReleaseCalculation `` /* 317-byte string literal not displayed */
}

type ResourcesConfig struct {
	// RpmRepos is the set of reusable RPM repository definitions, keyed by name.
	RpmRepos map[string]RpmRepoResource `` /* 142-byte string literal not displayed */

	// RpmRepoSetTemplates defines named layout templates that describe a fixed
	// matrix of sub-repos (e.g., the standard Azure Linux base/sdk x main/debuginfo/srpms
	// matrix, or a Koji dist-repo layout). Templates are instantiated by [RpmRepoSet]
	// entries.
	RpmRepoSetTemplates map[string]RpmRepoSetTemplate `` /* 195-byte string literal not displayed */

	// RpmRepoSets instantiates a [RpmRepoSetTemplate] for a specific deployment by
	// supplying a base URI and shared GPG configuration. Each set expands at validation
	// time into one or more synthesized [RpmRepoResource] entries; consumers reach the
	// expanded repos via [ResourcesConfig.EffectiveRpmRepos].
	RpmRepoSets map[string]RpmRepoSet `` /* 172-byte string literal not displayed */
}

type RpmRepoResource struct {
	// Description is a human-readable description of the repository. Used only
	// for `azldev config dump` and similar diagnostics; not projected into dnf
	// or kiwi configuration (avoids newline/encoding pitfalls).
	Description string `` /* 145-byte string literal not displayed */

	// Type discriminates the repository's access protocol. Defaults to "rpm-md" when unset.
	Type RpmRepoType `` /* 138-byte string literal not displayed */

	// BaseURI is the repository base URI (dnf's `baseurl`). Mutually exclusive with
	// [RpmRepoResource.Metalink]. Either BaseURI or Metalink must be set for type "rpm-md".
	BaseURI string `` /* 221-byte string literal not displayed */

	// Metalink is the repository metalink URL. Mutually exclusive with [RpmRepoResource.BaseURI].
	Metalink string `` /* 212-byte string literal not displayed */

	// DisableGPGCheck disables GPG signature verification for this repo. The zero
	// value (false) means GPG checking is *enabled* — the safe default. Setting
	// this to true is an explicit opt-out and load-time validation requires either
	// `disable-gpg-check = true` or a non-empty `gpg-key`.
	DisableGPGCheck bool `` /* 200-byte string literal not displayed */

	// GPGKey is a path or URI to the GPG key used to verify signatures.
	//
	// Accepted forms:
	//   * `https://...` or `http://...` URI: passed through verbatim to both consumers.
	//   * `file:///absolute/path`: passed through verbatim. Note that mock evaluates this
	//     *inside* the chroot, while kiwi evaluates it on the host. Prefer http(s)://
	//     for portability across consumers.
	//   * Bare path: resolved at TOML-load time relative to the directory containing the
	//     defining TOML file, then emitted to consumers as a `file://` URI.
	GPGKey string `` /* 240-byte string literal not displayed */

	// Arches optionally restricts the repository to a specific list of target architectures
	// (e.g., ["x86_64"]). When empty, the repository is available for all architectures.
	Arches []string `` /* 140-byte string literal not displayed */
}

type RpmRepoSet struct {
	// Description is a human-readable description (diagnostic only).
	Description string `` /* 145-byte string literal not displayed */

	// Template is the name of the [RpmRepoSetTemplate] to instantiate. Must
	// resolve to a defined template at validation time.
	Template string `` /* 129-byte string literal not displayed */

	// BaseURI is the URL prefix under which all sub-repos for this deployment
	// live. The synthesized repo's `base-uri` is `BaseURI/<subrepo.subpath>`.
	BaseURI string `` /* 171-byte string literal not displayed */

	// NamePrefix is prepended to each sub-repo's `name` to form the synthesized
	// repo ID. May be empty, in which case bare sub-repo names are used (only
	// safe when no other set or explicit repo collides with those names).
	NamePrefix string `` /* 153-byte string literal not displayed */

	// GPGKey is the shared GPG key for sub-repos in this set; same shape rules
	// as [RpmRepoResource.GPGKey] apply.
	GPGKey string `` /* 240-byte string literal not displayed */

	// DisableGPGCheck opts out of GPG signature verification for sub-repos in
	// this set; same default semantics as [RpmRepoResource.DisableGPGCheck].
	DisableGPGCheck bool `` /* 176-byte string literal not displayed */

	// Arches optionally restricts every synthesized repo in this set to a
	// specific list of target architectures. Empty = all.
	Arches []string `` /* 140-byte string literal not displayed */

	// Subrepos is an optional allowlist of sub-repo names from the referenced
	// template to instantiate. When unset (or empty), every sub-repo in the
	// template is instantiated. When non-empty, only the listed sub-repos are
	// instantiated. Listed names must match a sub-repo declared in the
	// referenced template.
	Subrepos []string `` /* 154-byte string literal not displayed */
}

type RpmRepoSetTemplate struct {
	// Description is a human-readable description of the layout (diagnostic only).
	Description string `` /* 145-byte string literal not displayed */

	// Subrepos is the ordered list of sub-repo entries that make up the layout.
	Subrepos []SubrepoSpec `toml:"subrepos" json:"subrepos" jsonschema:"required,title=Sub-repos,description=Ordered list of sub-repos in the layout"`
}

type RpmRepoType string

type SourceFileReference struct {
	// Reference to the component to which the source file belongs.
	Component ComponentReference `toml:"-" json:"-" fingerprint:"-"`

	// Name of the source file; must be non-empty.
	Filename string `toml:"filename" json:"filename"`

	// Hash of the source file, expressed as a hex string.
	Hash string `toml:"hash,omitempty" json:"hash,omitempty"`

	// Type of hash used by Hash (e.g., "SHA256", "SHA512").
	HashType fileutils.HashType `` /* 156-byte string literal not displayed */

	// Origin for this source file. When omitted, the file is resolved via the lookaside cache.
	Origin Origin `toml:"origin,omitempty" json:"origin,omitempty"`

	// ReplaceUpstream, when true, intentionally replaces an upstream entry with the same
	// [SourceFileReference.Filename] in the dist-git 'sources' file. The matching upstream
	// entry must exist or source preparation fails. When false (the default), a filename
	// collision with an existing 'sources' entry is treated as an error.
	// [SourceFileReference.ReplaceReason] is required when this is true.
	ReplaceUpstream bool `` /* 228-byte string literal not displayed */

	// ReplaceReason is a human-readable explanation for why an upstream 'sources' entry is
	// being replaced. Required when [SourceFileReference.ReplaceUpstream] is true; must be
	// empty otherwise. Excluded from the fingerprint because it is documentation only.
	ReplaceReason string `` /* 214-byte string literal not displayed */
}

type SpecSource struct {
	// SourceType indicates the type of source for the spec.
	SourceType SpecSourceType `` /* 186-byte string literal not displayed */

	// Path indicates the path to the spec file; only relevant for local specs.
	// Excluded from fingerprint because it contains an absolute path that varies by checkout
	// location. Spec content identity is captured separately via [fingerprint.IdentityOptions.SourceIdentity].
	Path string `` /* 239-byte string literal not displayed */

	// UpstreamDistro indicates the upstream distro providing the spec; only relevant for upstream specs.
	UpstreamDistro DistroReference `` /* 163-byte string literal not displayed */

	// UpstreamName indicates the name of the component in the upstream distro; only relevant for upstream specs.
	UpstreamName string `` /* 230-byte string literal not displayed */

	// UpstreamCommit pins the upstream spec to a specific git commit hash; only relevant for upstream specs.
	// When set, this takes priority over the snapshot date-time on the distro reference.
	UpstreamCommit string `` /* 339-byte string literal not displayed */
}

type SpecSourceType string

type SubrepoKind string

type SubrepoSpec struct {
	// Name is a stable short identifier for this sub-repo within the template
	// (e.g., "base", "base-debug"). Combined with the [RpmRepoSet]'s
	// `name-prefix` it forms the synthesized repo's ID, so it must satisfy the
	// same grammar as [RpmRepoResource] names.
	Name string `` /* 149-byte string literal not displayed */

	// Subpath is the relative path (under the set's base URI) that hosts the
	// sub-repo's repodata. May contain dnf-side variables such as `$basearch`,
	// which are passed through verbatim.
	Subpath string `` /* 140-byte string literal not displayed */

	// Kind classifies the sub-repo (binary, debug, source). Defaults to "binary".
	// Authors of [RpmRepoSet] entries can filter by kind only indirectly, by
	// listing specific sub-repo names in `subrepos`.
	Kind SubrepoKind `` /* 158-byte string literal not displayed */
}

type TestSuiteConfig struct {
	// The test suite's name; not present in serialized TOML files (populated from the map key).
	Name string `toml:"-" json:"name" table:",sortkey"`

	// Description of the test suite.
	Description string `` /* 131-byte string literal not displayed */

	// Type indicates the test framework to use.
	Type TestType `` /* 130-byte string literal not displayed */

	// Pytest holds pytest-specific configuration. Required when Type is "pytest".
	Pytest *PytestConfig `` /* 153-byte string literal not displayed */

	// Reference to the source config file that this definition came from; not present
	// in serialized files.
	SourceConfigFile *ConfigFile `toml:"-" json:"-" table:"-"`
}

type TestSuiteRef struct {
	// Name is the key into the top-level [test-suites] map.
	Name string `` /* 127-byte string literal not displayed */
}

type TestType string

type ToolsConfig struct {
	// Configuration for the Image Customizer tool.
	ImageCustomizer ImageCustomizerConfig `` /* 176-byte string literal not displayed */
}

type URLRef struct {
	// URL is the http(s) link to the referenced resource. Required.
	URL string `` /* 164-byte string literal not displayed */
}