islaApocalypse-v2/Tools/Scripts/TerrainGenConfig.cs

using IslaApocalypse.Core;

namespace IslaApocalypse.Tools
{
	/// <summary>
	/// The generator's configuration, including the per-element ABLATION TOGGLES.
	///
	/// ═══ WHY EVERY PASS-1 ELEMENT IS GATED ═══
	///
	/// This is the standing A/B discipline: every shaping change ships behind a gate with the
	/// previous behaviour surviving on the other side, so changes stay comparable as a pair rather
	/// than as a memory of last week's render, and a rejected change costs a flipped default rather
	/// than a reverted commit. → `Design - Tooling - Iteration and Batching.md`.
	///
	/// For THIS task the gates do a second job: they are the PORT-FIDELITY CHECK. Generating
	/// base-noise-only, then adding one element at a time, shows each ported element doing what the
	/// reference's did — rather than judging six simultaneous changes by their sum.
	///
	/// ⚠ Lives in Tools/, not Core/. It configures the generator specifically; Core carries the
	/// world's data contracts and the scaling rule, not a tool's dials.
	/// </summary>
	public sealed class TerrainGenConfig
	{
		// ---- world ----------------------------------------------------------

		/// <summary>
		/// Map side in columns. A GENERATION PARAMETER — never baked in.
		/// Iteration runs small (2048–4096); the shape is scale-invariant by construction, so the
		/// island reads the same at any size and a full-size pass is confirmation, not iteration.
		/// </summary>
		public int MapSize = 2048;

		/// <summary>
		/// The noise seed. POSITIVE ONLY. Zero or negative means "pick one and print it" — a run
		/// whose seed is not recorded is a run that cannot be reproduced, so the resolved seed is
		/// always printed and always in the filename.
		/// </summary>
		public int Seed = 0;

		// ---- island shape (reference ConfigManager defaults, READ from source) ----

		/// <summary>Falloff X axis ratio. Reference: <c>ConfigManager.LEGACY_AXIS_X = 1.15f</c>.</summary>
		public float IslandAxisX = 1.15f;

		/// <summary>Falloff Y axis ratio. Reference: <c>ConfigManager.LEGACY_AXIS_Y = 0.90f</c>.</summary>
		public float IslandAxisY = 0.90f;

		/// <summary>
		/// Multiplier on the falloff term in the combine.
		/// Reference: <c>[Export] public float FalloffStrength = 1.0f;</c> (MapGenerator ~:11),
		/// and NOT overridden in MapPreview.tscn — so 1.0f is the value the island was tuned at.
		/// </summary>
		public float FalloffStrength = 1.0f;

		/// <summary>
		/// The flat sea level, in raw height units. Reference: <c>ConfigManager.SeaLevelValue = 0.15f</c>
		/// with <c>SeaLevelModel = "flat"</c>, so <c>GetSeaLevel</c> ignores latitude entirely.
		///
		/// ⚠ PHASE 1 USES THIS AS A VISUALIZATION THRESHOLD ONLY — the boundary between the
		/// bathymetric and hypsometric colour ramps. No water is modelled, no water bodies are
		/// identified, nothing floods. That is Phase 2.
		/// </summary>
		public float SeaLevel = 0.15f;

		// ---- ABLATION TOGGLES — the pass-1 ladder ---------------------------

		/// <summary>Rung 1: the base terrain noise, <c>(noise(x,y)+1)/2</c>. Off = flat zero.</summary>
		public bool BaseNoise = true;

		/// <summary>
		/// Rung 2: the island falloff/mask — squircle + ellipse blend, and the <c>Pow(·, 2.5f)</c>.
		/// ⚠ Off also disables rungs 3–5 in effect: edge noise, the sinker and the Trench are all
		/// modifiers OF the falloff, so with no falloff there is nothing for them to modify. The
		/// toggles stay independent so the ladder reads honestly; the report says so.
		/// </summary>
		public bool IslandFalloff = true;

		/// <summary>Rung 3: coastline edge roughness, modulated by the squircle.</summary>
		public bool EdgeNoise = true;

		/// <summary>Rung 4: the southern sinker — extra sinking pressure in the bottom 25%.</summary>
		public bool SouthernSinker = true;

		/// <summary>Rung 5: the Trench — the map-anchored outer-band wall that guarantees an ocean border.</summary>
		public bool Trench = true;

		/// <summary>Rung 6: the mountain spine up the centre-X axis.</summary>
		public bool MountainSpine = true;

		/// <summary>A short label for this variant, used in output filenames. E.g. "full", "base_only".</summary>
		public string VariantLabel = "full";

		/// <summary>The scale object every distance and frequency in the generator derives from.</summary>
		public GenerationScale Scale => new GenerationScale(MapSize);

		public TerrainGenConfig Clone() => (TerrainGenConfig)MemberwiseClone();

		public override string ToString() =>
			$"MapSize={MapSize} Seed={Seed} axis={IslandAxisX:F2}x/{IslandAxisY:F2}y " +
			$"falloffStrength={FalloffStrength:F2} sea={SeaLevel:F2} variant={VariantLabel} " +
			$"[base={BaseNoise} falloff={IslandFalloff} edge={EdgeNoise} sinker={SouthernSinker} " +
			$"trench={Trench} spine={MountainSpine}]";
	}
}