common

type DifficultySpec struct {
	VineCountRange   [2]int
	AvgLengthRange   [2]int
	MaxBlockingDepth int
	ColorCountRange  [2]int
	MinGridOccupancy float64
	DefaultGrace     int
}

type GeneratorConfig struct {
	MaxSeedRetries    int // retries to find a seed that can grow
	LocalRepairRadius int // radius for local repair tiles
	RepairRetries     int // number of local repair attempts per stuck region
}

type Level struct {
	ID         int    `json:"id"`
	Name       string `json:"name"`
	Difficulty string `json:"difficulty"` // "Tutorial", "Seedling", "Sprout", "Nurturing", "Flourishing", "Transcendent"
	GridSize   [2]int `json:"grid_size"`  // [width, height]
	Mask       *Mask  `json:"mask"`
	Vines      []Vine `json:"vines"`
	MaxMoves   int    `json:"max_moves"`
	MinMoves   int    `json:"min_moves"`
	Complexity string `json:"complexity"` // "tutorial", "low", "medium", "high", "extreme"
	Grace      int    `json:"grace"`      // 3 or 4
	// Generation metadata persisted for reproducibility & diagnostics
	GenerationSeed      int64   `json:"generation_seed,omitempty"`
	GenerationAttempts  int     `json:"generation_attempts,omitempty"`
	GenerationElapsedMS int64   `json:"generation_elapsed_ms,omitempty"`
	GenerationScore     float64 `json:"generation_score,omitempty"`
	// These are populated during validation but not persisted
	OccupancyPercent  float64             `json:"-"`
	ColorDistribution map[string]float64  `json:"-"`
	BlockingGraph     map[string][]string `json:"-"`
}

type Mask struct {
	Mode   string `json:"mode"`   // "show-all", "hide", "show"
	Points []any  `json:"points"` // [][]int or []Point
}

type Module struct {
	ID            int      `json:"id"`
	Name          string   `json:"name"`
	LevelRange    [2]int   `json:"level_range"`
	Parable       *Parable `json:"parable"`
	UnlockMessage string   `json:"unlock_message"`
}

type ModuleData struct {
	Version           string                 `json:"version"`
	Modules           []Module               `json:"modules"`
	ColorDistribution map[string]interface{} `json:"color_distribution"`
	BlockingGraph     map[string]interface{} `json:"blocking_graph"`
}

type ModuleRange struct {
	ID    int
	Name  string
	Start int
	End   int
}

type Parable struct {
	Title           string `json:"title"`
	Scripture       string `json:"scripture"`
	Content         string `json:"content"`
	Reflection      string `json:"reflection"`
	BackgroundImage string `json:"background_image"`
}

type Point struct {
	X int `json:"x"`
	Y int `json:"y"`
}

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

type ValidationResult struct {
	Filename   string
	Violations []string
	Warnings   []string
	Valid      bool
	Timestamp  time.Time
}

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

type VarietyProfile struct {
	LengthMix  map[string]float64 // keys: "short","medium","long" => relative weights
	TurnMix    float64            // 0..1 proportion of turns (bendiness)
	RegionBias string             // "edge","center","balanced"
	DirBalance map[string]float64 // desired head dir distribution (right,left,up,down)
}

type Vine struct {
	ID            string   `json:"id"`
	HeadDirection string   `json:"head_direction"` // "up", "down", "left", "right"
	OrderedPath   []Point  `json:"ordered_path"`
	VineColor     string   `json:"vine_color"`
	Blocks        []string `json:"blocks"`
}