templates

type CatalogEntry struct {
	Name        string `yaml:"name"`
	Description string `yaml:"description"`
	Cloud       string `yaml:"cloud"`
	Tier        string `yaml:"tier"`
	Source      string `yaml:"source"`
	Version     string `yaml:"version"`
}

type Configuration struct {
	Name        string `yaml:"name"`
	Description string `yaml:"description"`
	TemplateID  string `yaml:"template_id"`
	Version     string `yaml:"version"`
	Source      string `yaml:"source"`
	TargetDir   string `yaml:"target_dir"`
	Files       []File `yaml:"files"`
	README      string `yaml:"readme"`
	// ResolvedRef is the immutable reference fetched for Source: a Git commit
	// SHA for Git sources (set by pkg/generator/source's resolveRemote) or a
	// manifest digest for OCI sources (set by resolveOCI). It is empty for
	// S3, HTTP, and local sources, which have no equivalent concept.
	// Runtime-only -- never part of a template's own manifest -- so it's
	// excluded from serialization. --update-strategy=rendered uses this to
	// pin a reproducible "before" state instead of relying on a ref string
	// that may name a mutable branch.
	ResolvedRef string `yaml:"-"`
	// LocalDir is the real, on-disk directory a remote source (oci://,
	// git::, https://, s3://) was fetched into (set by resolveOCI/
	// resolveRemote), valid for the lifetime of the generation run that
	// fetched it. Source itself gets overwritten with the original remote
	// reference string right after fetching, for display/provenance
	// purposes -- see resolveOCI's own comment on that overwrite -- so it
	// is no longer a real, resolvable path by the time a scaffold.yaml is
	// re-parsed later in the same run (e.g. by RunSetupForm). LocalDir
	// preserves the one that still is. Empty for a local-directory or
	// embedded template, neither of which has a separate fetch directory
	// distinct from Source. Runtime-only, like ResolvedRef -- excluded
	// from serialization, and never copied into a persisted project
	// record. Use IncludeSourceDir, not this field directly, to decide
	// what a template's own local !include targets resolve against.
	LocalDir string `yaml:"-"`
}

type File struct {
	Path        string      `yaml:"path"`
	Content     string      `yaml:"content"`
	IsDirectory bool        `yaml:"is_directory"`
	IsTemplate  bool        `yaml:"is_template"`
	Permissions os.FileMode `yaml:"permissions"`
}

type LoadOption func(*loadOptions)