elevationPreviewCtx.ts

import { readClimateControls } from "./climateReads";
import type { Point, VulcanusResourceControls } from "../noise/eval/ctx";
import { readMapType } from "./mapType";
import { readResourceControls, readVulcanusResourceControls } from "./resourceReads";
import type { ResourceControlLevers } from "../noise/resources/resourceCatalog";
import type { Preset } from "./types";
import { ENEMY_CONTROL_NAME, type EnemyControls } from "../noise/enemies/enemyCatalog";
import {
  CLIFF_CONTROL_NAME,
  type CliffControls,
  type CliffSettingsInput,
} from "../noise/cliffs/cliffCatalog";

export interface ElevationPreviewCtx {
  /** false => the active map type has no client renderer (unknown/modded map type). */
  supported: boolean;
  /** Which client renderer to use when supported. */
  mapType: "lakes" | "nauvis" | "island";
  /** Resolved map-type label, for the "not available for <label>" message. */
  mapTypeLabel: string;
  /**
   * Per-resource control levers (control:<res>:frequency|size|richness), keyed by
   * controlName - consumed only by the `view: "resources"` overlay (renderResources).
   * Absent resources default to 1/1/1. Faithful only on the Nauvis map type, same as
   * the terrain view.
   */
  resourceControls: Record<string, ResourceControlLevers>;
  /**
   * The four Vulcanus resource autoplace controls (control:tungsten-ore:*,
   * control:vulcanus-coal:*, control:calcite:*, control:sulfuric-acid-geyser:*) -
   * consumed only by the Vulcanus `view: "resources"` overlay
   * (renderVulcanusResources). Absent controls default to `{ frequency: 1,
   * size: 1 }`.
   */
  vulcanusResourceControls: VulcanusResourceControls;
  /**
   * The enemy-base autoplace control's frequency/size (control:enemy-base:*) -
   * consumed only by the `view: "enemies"` overlay (renderEnemies). Absent
   * defaults to `{ frequency: 1, size: 1 }`. Faithful only on the Nauvis map
   * type, same as the terrain/resources views.
   */
  enemyControls: EnemyControls;
  /**
   * The `nauvis_cliff` autoplace control's frequency/size (control:nauvis_cliff:*,
   * size doubles as continuity) - consumed only by the `view: "cliffs"` overlay
   * (renderCliffs). Absent defaults to `{ frequency: 1, continuity: 1 }`.
   * Faithful only on the Nauvis map type, same as the terrain/resources/enemies
   * views.
   */
  cliffControls: CliffControls;
  /**
   * The cliff-related MapGenSettings fields (cliff_elevation_0,
   * cliff_elevation_interval, cliff richness), read straight off
   * `preset.cliffSettings` - consumed only by the `view: "cliffs"` overlay.
   */
  cliffSettings: CliffSettingsInput;
  /**
   * The `trees` autoplace control's frequency/size (control:trees:*) - consumed
   * only by the `view: "trees"` overlay (renderTrees). Absent defaults to
   * `{ frequency: 1, size: 1 }`. Faithful only on the Nauvis map type, same as
   * the terrain/resources/enemies/cliffs views.
   */
  treeControls: { readonly frequency: number; readonly size: number };
  /**
   * The `rocks` autoplace control's frequency/size (control:rocks:*) - consumed
   * only by the `view: "rocks"` overlay (renderRocks). Absent defaults to
   * `{ frequency: 1, size: 1 }`. Nauvis-only, same as the other overlays.
   */
  rockControls: { readonly frequency: number; readonly size: number };
  /**
   * The `fulgora_islands` autoplace control's frequency/size - consumed only
   * when the selected planet is Fulgora. Defaults to `{ frequency: 1, size: 1 }`.
   *
   * Read from the preset even though a default preset never sets it, because
   * both levers default to the one value that hides its own implementation:
   * frequency 1 makes the Voronoi grid exactly 175 (so its truncation to a u16
   * is a no-op) and size 1 makes `slider_rescale(size, 2)` exactly 1 (so
   * `fulgora_natural`'s scaling term vanishes).
   */
  fulgoraIslandControls: { readonly frequency: number; readonly size: number };
  /**
   * The `vulcanus_volcanism` autoplace control's frequency/size - consumed only
   * when the selected planet is Vulcanus. Defaults to `{ frequency: 1, size: 1 }`.
   *
   * Neither slider touches the cliff rule or the tile catalog directly:
   * frequency is the input scale of the mountain and crack noise, and size sets
   * the volcano spot radius, spacing and density - so both move the elevation
   * contours every other Vulcanus field sits on. Like the Fulgora pair, each
   * defaults to the one value that hides itself: `slider_rescale(1, 3)` is
   * exactly 1, so at the default both terms vanish and a render that ignored
   * the control would look right until the slider moved.
   */
  vulcanusVolcanismControls: { readonly frequency: number; readonly size: number };
  /**
   * Non-seed free variables for renderElevation/renderTerrain
   * (Omit<..., "seed0">-compatible). The climate fields (aux/moisture
   * frequency+bias, starting-area moisture) are consumed only by
   * renderTerrain's tile resolver - the elevation renderers ignore them.
   *
   * Task 12b: non-default climate values are faithful ports of the game's
   * climate tree (same caveat as the starting-area/starting-lake elevation
   * levers above) but are NOT themselves oracle-validated point-by-point -
   * only the all-defaults path (Task 10's fixtures) is.
   */
  ctx: {
    waterLevel: number;
    segmentationMultiplier: number;
    startingPositions: Point[];
    moistureFrequency: number;
    moistureBias: number;
    auxFrequency: number;
    auxBias: number;
    /** Consumed only by the trees overlay - tile selection is aux + moisture. */
    temperatureFrequency: number;
    temperatureBias: number;
    startingAreaMoistureSize: number;
    startingAreaMoistureFrequency: number;
  };
}

/**
 * Map the active preset onto the free variables the elevation renderer needs,
 * and report which client tree (nauvis, lakes, or island) renders it. waterLevel =
 * 10*log2(control:water:size), segmentation = control:water:frequency; an
 * absent water control collapses to the renderer's own defaults (waterLevel 0,
 * seg 1). A disabled control (size <= 0) is guarded to size 1 rather than
 * emitting -Infinity. The climate fields (moisture/aux frequency+bias,
 * starting-area moisture) come from `readClimateControls`, which applies the
 * game's own defaults for any absent key.
 */
export function elevationCtxFromPreset(preset: Preset): ElevationPreviewCtx {
  const mt = readMapType(preset.propertyExpressionNames);
  const water = preset.autoplaceControls.water;
  const size = water && water.size > 0 ? water.size : 1;
  const startingPositions: Point[] =
    preset.startingPoints.length > 0
      ? preset.startingPoints.map((p) => ({ x: p.x, y: p.y }))
      : [{ x: 0, y: 0 }];
  const climate = readClimateControls(preset.propertyExpressionNames);

  const supported = mt.id === "nauvis" || mt.id === "lakes" || mt.id === "island";
  const mapType = mt.id === "nauvis" ? "nauvis" : mt.id === "island" ? "island" : "lakes";
  const eb = preset.autoplaceControls[ENEMY_CONTROL_NAME];
  const cc = preset.autoplaceControls[CLIFF_CONTROL_NAME];
  const tc = preset.autoplaceControls.trees;
  const rk = preset.autoplaceControls.rocks;
  const fi = preset.autoplaceControls.fulgora_islands;
  const vv = preset.autoplaceControls.vulcanus_volcanism;
  return {
    supported,
    mapType,
    mapTypeLabel: mt.label,
    resourceControls: readResourceControls(preset),
    vulcanusResourceControls: readVulcanusResourceControls(preset),
    enemyControls: eb ? { frequency: eb.frequency, size: eb.size } : { frequency: 1, size: 1 },
    cliffControls: cc
      ? { frequency: cc.frequency, continuity: cc.size }
      : { frequency: 1, continuity: 1 },
    cliffSettings: {
      cliffElevation0: preset.cliffSettings.cliffElevation0,
      cliffElevationInterval: preset.cliffSettings.cliffElevationInterval,
      richness: preset.cliffSettings.richness,
    },
    treeControls: tc ? { frequency: tc.frequency, size: tc.size } : { frequency: 1, size: 1 },
    rockControls: rk ? { frequency: rk.frequency, size: rk.size } : { frequency: 1, size: 1 },
    fulgoraIslandControls: fi
      ? { frequency: fi.frequency, size: fi.size }
      : { frequency: 1, size: 1 },
    vulcanusVolcanismControls: vv
      ? { frequency: vv.frequency, size: vv.size }
      : { frequency: 1, size: 1 },
    ctx: {
      waterLevel: 10 * Math.log2(size),
      segmentationMultiplier: water?.frequency ?? 1,
      startingPositions,
      moistureFrequency: climate.moisture.frequency,
      moistureBias: climate.moisture.bias,
      temperatureFrequency: climate.temperature.frequency,
      temperatureBias: climate.temperature.bias,
      auxFrequency: climate.aux.frequency,
      auxBias: climate.aux.bias,
      startingAreaMoistureSize: climate.startingAreaMoisture.size,
      startingAreaMoistureFrequency: climate.startingAreaMoisture.frequency,
    },
  };
}