generator

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

type Format string

type Generator interface {
	// Name returns the unique identifier for this generator.
	Name() string

	// Generate produces the Terraform configuration content.
	// Returns a map structure suitable for JSON/HCL serialization.
	Generate(ctx context.Context, genCtx *GeneratorContext) (map[string]any, error)

	// Validate checks if the generator context has sufficient data.
	Validate(genCtx *GeneratorContext) error

	// DefaultFilename returns the default output filename.
	DefaultFilename() string

	// ShouldGenerate returns true if this generator should run.
	// Based on whether relevant config exists.
	ShouldGenerate(genCtx *GeneratorContext) bool
}

type GeneratorContext struct {
	// AtmosConfig holds the Atmos configuration.
	AtmosConfig *schema.AtmosConfiguration

	// StackInfo holds the processed stack and component information.
	StackInfo *schema.ConfigAndStacksInfo

	// Component is the component name.
	Component string

	// Stack is the stack name.
	Stack string

	// ComponentPath is the path to the component directory.
	ComponentPath string

	// WorkingDir is the directory where generated files will be written.
	WorkingDir string

	// VarsSection contains the component variables.
	VarsSection map[string]any

	// ProvidersSection contains the provider configuration.
	ProvidersSection map[string]any

	// RequiredVersion is the Terraform version constraint (e.g., ">= 1.10.1").
	RequiredVersion string

	// RequiredProviders maps provider names to their configuration.
	// Example: {"aws": {"source": "hashicorp/aws", "version": "~> 5.0"}}.
	RequiredProviders map[string]map[string]any

	// BackendType is the Terraform backend type (e.g., "s3", "gcs").
	BackendType string

	// BackendConfig contains the backend configuration.
	BackendConfig map[string]any

	// DryRun when true, prevents file writes.
	DryRun bool

	// Format specifies the output format (JSON or HCL).
	Format Format

	// CustomFilename overrides the default filename when set.
	CustomFilename string
}

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

type InitGitOptions struct {
	TargetPath      string
	TemplateName    string
	TemplateVersion string
}

type MockWriter struct {
	// Written maps file paths to their written content.
	Written map[string]map[string]any
	// WriteErr if set, will be returned by Write operations.
	WriteErr error
}

type Option func(*GeneratorContext)

type PinOption func(*pinOptions)

type ProviderContributor interface {
	// Name is the unique contributor identifier.
	Name() string

	// Contribute returns a provider fragment keyed by Terraform provider name
	// (e.g. {"aws": {"skip_requesting_account_id": true, ...}}), or nil/empty when
	// this contributor does not apply to the component in genCtx.
	Contribute(ctx context.Context, genCtx *GeneratorContext) (map[string]any, error)
}

type Writer interface {
	// WriteJSON writes content as JSON to the specified directory and filename.
	WriteJSON(dir, filename string, data map[string]any) error
	// WriteHCL writes content as HCL to the specified directory and filename.
	WriteHCL(dir, filename string, data map[string]any) error
}

type WriterOption func(*FileWriter)