change requirements to use toml files for requirements

docs/requirements.md

@@ -2,39 +2,39 @@
 
 ## Config Files
 
-The following config files drive game parameters:
+Config files use the TOML format. The following config files drive game parameters:
 
-- **world.config** — world dimensions, region widths, expansion amounts, building refund percentage, wave timing, enemy ship level formula.
+- **world.toml** — world dimensions, region widths, expansion amounts, building refund percentage, wave timing, enemy ship level formula.
-- **buildings.config** — building block cost per building type.
+- **buildings.toml** — building block cost per building type.
-- **recipes.config** — crafting recipes: inputs, outputs, quantities, durations, and reprocessing plant probabilities.
+- **recipes.toml** — crafting recipes: inputs, outputs, quantities, durations, and reprocessing plant probabilities.
-- **ships.config** — ship stats (HP, speed, damage, attack range, attack rate) as formulas of ship level, required materials per blueprint, threat cost formula, and whether each blueprint is available from the start or unlocked via loot.
+- **ships.toml** — ship stats (HP, speed, damage, attack range, attack rate) as formulas of ship level, required materials per blueprint, threat cost formula, and whether each blueprint is available from the start or unlocked via loot.
-- **stations.config** — HP, damage, range, and fire rate for player and enemy defence stations.
+- **stations.toml** — HP, damage, range, and fire rate for player and enemy defence stations.
 
 ## Game World
 
 - REQ-GW-TILE-SIZE: Tiles are 20×20 pixels. Items on belts are 10×10 pixels (half a tile), so each belt tile holds at most 2 items.
-- REQ-GW-HEIGHT: The world height (in tiles) is read from world.config.
+- REQ-GW-HEIGHT: The world height (in tiles) is read from world.toml.
-- REQ-GW-REGIONS: The world is divided into horizontal regions whose widths (in tiles) are all read from world.config:
+- REQ-GW-REGIONS: The world is divided into horizontal regions whose widths (in tiles) are all read from world.toml:
   - **Asteroid** — the player's build area.
   - **Player buffer zone** — space between the asteroid and the player's defence stations.
   - **Contest zone** — space between the player's and enemy's defence stations. This is where combat happens.
   - **Enemy buffer zone** — space between the enemy's defence stations and the enemy spawn boundary.
 - REQ-GW-SCROLL-LIMIT: The player can scroll the view horizontally from the asteroid's left edge to the current set of enemy defence stations (the enemy buffer zone is not visible).
-- REQ-GW-PUSH-EXPAND: When the player destroys a set of enemy defence stations, the scrollable area is extended by a configurable number of tiles (world.config). A new enemy buffer zone of the same configurable width is added beyond the new enemy defence stations.
+- REQ-GW-PUSH-EXPAND: When the player destroys a set of enemy defence stations, the scrollable area is extended by a configurable number of tiles (world.toml). A new enemy buffer zone of the same configurable width is added beyond the new enemy defence stations.
-- REQ-GW-ASTEROID-EXPAND: When the player unlocks an asteroid expansion, a configurable number of tile columns (world.config) is added to the left of the asteroid.
+- REQ-GW-ASTEROID-EXPAND: When the player unlocks an asteroid expansion, a configurable number of tile columns (world.toml) is added to the left of the asteroid.
 
 ## HQ & Game Over
 
 - REQ-HQ-PLACEMENT: The HQ is pre-placed at the asteroid's right edge at game start.
 - REQ-HQ-BELT-INPUT: The HQ has a belt input port. Building blocks delivered to it are added to the global building blocks stock.
-- REQ-HQ-STATS: HQ stats (HP) are read from stations.config.
+- REQ-HQ-STATS: HQ stats (HP) are read from stations.toml.
 - REQ-HQ-GAME-OVER: If the HQ is destroyed, the game ends and the final survival time is shown.
 - REQ-HQ-INVULNERABLE: Factory buildings (other than the HQ) are never targeted or destroyed by enemies.
 
 ## Building Placement & Management
 
-- REQ-BLD-COST: The player places buildings from a build menu. Placement costs building blocks from the global stock. The cost per building type is read from buildings.config.
+- REQ-BLD-COST: The player places buildings from a build menu. Placement costs building blocks from the global stock. The cost per building type is read from buildings.toml.
-- REQ-BLD-QUEUE: Placed buildings enter a construction queue and are built one at a time. Each building takes a duration defined in recipes.config to construct.
+- REQ-BLD-QUEUE: Placed buildings enter a construction queue and are built one at a time. Each building takes a duration defined in recipes.toml to construct.
 - REQ-BLD-ASTEROID-ONLY: Buildings can only be placed on asteroid tiles.
 - REQ-BLD-SHIPYARD-EDGE: Shipyards must be placed at the asteroid's right edge.
 - REQ-BLD-BUILDER-MODE: Clicking a build button activates builder mode for that building type. Builder mode is exited by pressing Escape, right-clicking in the game world, or clicking the same build button again.
@@ -42,15 +42,15 @@ The following config files drive game parameters:
 - REQ-BLD-ROTATE: While in builder mode, pressing E rotates the ghost 90° clockwise and Q rotates it 90° counter-clockwise. Rotation affects the direction of the output port.
 - REQ-BLD-PLACE: Clicking a valid tile in builder mode places a construction site and adds it to the build queue, consuming building blocks from the global stock.
 - REQ-BLD-BELT-DRAG: For belts, the player can click and drag across multiple tiles to place a construction site on each tile in one gesture.
-- REQ-BLD-DEMOLISH: The player can demolish a placed building. Demolition returns a configurable percentage of the original building block cost (default 75%) to the global stock. The refund percentage is read from world.config.
+- REQ-BLD-DEMOLISH: The player can demolish a placed building. Demolition returns a configurable percentage of the original building block cost (default 75%) to the global stock. The refund percentage is read from world.toml.
 
 ## Building Types
 
-- REQ-BLD-MINER: **Miner** (2×2): The player selects which ore type it extracts. Produces ore at a rate defined in recipes.config. Ore never depletes.
+- REQ-BLD-MINER: **Miner** (2×2): The player selects which ore type it extracts. Produces ore at a rate defined in recipes.toml. Ore never depletes.
-- REQ-BLD-SMELTER: **Smelter** (2×2): Converts ore or scrap into basic materials. No recipe selection required. Inputs, outputs, and rates are defined in recipes.config.
+- REQ-BLD-SMELTER: **Smelter** (2×2): Converts ore or scrap into basic materials. No recipe selection required. Inputs, outputs, and rates are defined in recipes.toml.
-- REQ-BLD-ASSEMBLER: **Assembler** (3×3): The player selects a recipe from the config-defined crafting tree. Produces the selected output item at the rate defined in recipes.config.
+- REQ-BLD-ASSEMBLER: **Assembler** (3×3): The player selects a recipe from the config-defined crafting tree. Produces the selected output item at the rate defined in recipes.toml.
-- REQ-BLD-REPROCESSING: **Reprocessing Plant** (3×3): Consumes scrap per cycle (quantity from recipes.config) and produces higher-level intermediate products. Each product type has a fixed drop probability per cycle, defined in recipes.config.
+- REQ-BLD-REPROCESSING: **Reprocessing Plant** (3×3): Consumes scrap per cycle (quantity from recipes.toml) and produces higher-level intermediate products. Each product type has a fixed drop probability per cycle, defined in recipes.toml.
-- REQ-BLD-SHIPYARD: **Shipyard** (4×2): The player selects a blueprint. Automatically produces one ship of that type at a fixed level (defined in ships.config, default: 5) whenever all required materials are present in its input buffer. Ship material requirements are defined in ships.config.
+- REQ-BLD-SHIPYARD: **Shipyard** (4×2): The player selects a blueprint. Automatically produces one ship of that type at a fixed level (defined in ships.toml, default: 5) whenever all required materials are present in its input buffer. Ship material requirements are defined in ships.toml.
 - REQ-BLD-SALVAGE-BAY: **Salvage Bay** (3×2): A dedicated drop-off point for salvage ships. Scrap delivered here is placed onto connected output belts.
 - REQ-BLD-BELT: **Belt** (1×1): Transports items. Available in straight and curved variants.
 - REQ-BLD-SPLITTER: **Splitter** (1×1): Distributes incoming items between two output directions. Each output can optionally have a filter (a list of item types), configurable via the selected building panel. Routing rules:
@@ -72,15 +72,15 @@ The following config files drive game parameters:
 ## Resources
 
 - REQ-RES-ORE: Ore is extracted by miners and smelted into basic materials by smelters.
-- REQ-RES-SCRAP-DROP: Destroyed ships (both player and enemy) and destroyed defence stations (both player and enemy) drop scrap at their location. The scrap amount per unit is defined in ships.config and stations.config respectively. Scrap despawns after a configurable duration (world.config) if not collected.
+- REQ-RES-SCRAP-DROP: Destroyed ships (both player and enemy) and destroyed defence stations (both player and enemy) drop scrap at their location. The scrap amount per unit is defined in ships.toml and stations.toml respectively. Scrap despawns after a configurable duration (world.toml) if not collected.
 - REQ-RES-SCRAP-COLLECT: Scrap is collected by salvage ships and delivered to a Salvage Bay on the asteroid. From there it can be fed via belt into a smelter (same output as ore) or a Reprocessing Plant.
 - REQ-RES-BUILDING-BLOCKS: Building blocks are produced by an assembler recipe and are the only globally pooled resource. They are added to the global stock when delivered to the HQ via belt.
-- REQ-RES-CONFIG: All recipes, production rates, and reprocessing probabilities are defined in recipes.config.
+- REQ-RES-CONFIG: All recipes, production rates, and reprocessing probabilities are defined in recipes.toml.
 
 ## Ships
 
 - REQ-SHP-AUTONOMOUS: Ships are produced by shipyards and are fully autonomous once produced.
-- REQ-SHP-STATS: All ship stats (HP, speed, damage, attack range, attack rate) are defined as formulas of ship level in ships.config. Required build materials and whether each blueprint is available from game start or must be unlocked are also defined there.
+- REQ-SHP-STATS: All ship stats (HP, speed, damage, attack range, attack rate) are defined as formulas of ship level in ships.toml. Required build materials and whether each blueprint is available from game start or must be unlocked are also defined there.
 - REQ-SHP-NO-COLLISION: Ships move independently with no collision between them.
 - REQ-SHP-COMBAT: **Combat ships** — move right through space and engage enemy ships. The player can configure the following per shipyard (applied to all ships produced by that shipyard):
   - Stance: aggressive (advance toward enemies) / defensive (hold position near asteroid).
@@ -92,8 +92,8 @@ The following config files drive game parameters:
 
 ## Defence Stations
 
-- REQ-DEF-PLAYER-PLACEMENT: 2 player defence stations are pre-placed in space at the start. Their positions are determined by the world region widths in world.config.
+- REQ-DEF-PLAYER-PLACEMENT: 2 player defence stations are pre-placed in space at the start. Their positions are determined by the world region widths in world.toml.
-- REQ-DEF-PLAYER-FIRE: Player defence stations automatically fire at approaching enemy ships. Stats are read from stations.config.
+- REQ-DEF-PLAYER-FIRE: Player defence stations automatically fire at approaching enemy ships. Stats are read from stations.toml.
 - REQ-DEF-PLAYER-DESTRUCTIBLE: Player defence stations can be destroyed by enemies and repaired by repair ships.
 - REQ-DEF-ENEMY-PLACEMENT: 2 enemy defence stations are placed at the right boundary of the scrollable area at game start, and again each time a new set is spawned after a push. Stats scale with the station generation (REQ-PSH-STATION-STATS).
 - REQ-DEF-ENEMY-FIRE: Enemy defence stations automatically fire at player ships within range.
@@ -102,25 +102,25 @@ The following config files drive game parameters:
 
 ## Threat Level & Enemy Waves
 
-- REQ-WAV-THREAT-RATE: A global **threat level** accumulates continuously over time. The rate of increase per second is determined by a formula read from world.config where the input is elapsed game time in seconds. Example: `1*t - 30` gives 0 threat/s at t=30s and increases linearly after that.
+- REQ-WAV-THREAT-RATE: A global **threat level** accumulates continuously over time. The rate of increase per second is determined by a formula read from world.toml where the input is elapsed game time in seconds. Example: `1*t - 30` gives 0 threat/s at t=30s and increases linearly after that.
-- REQ-WAV-GAP: At game start and immediately after each wave is triggered, a random inter-wave gap is drawn uniformly from a configurable [min, max] range (world.config, in seconds).
+- REQ-WAV-GAP: At game start and immediately after each wave is triggered, a random inter-wave gap is drawn uniformly from a configurable [min, max] range (world.toml, in seconds).
 - REQ-WAV-TRIGGER: When the gap expires, a wave is triggered. Ships are spawned using the accumulated threat level. Any threat not spent on ships carries over to the next wave. A longer gap results in a larger wave.
-- REQ-WAV-SHIP-LEVEL: Each wave's enemy ships are assigned a level determined by a formula of elapsed game time in seconds (t), read from world.config. This is the sole mechanism by which enemy waves grow stronger over time.
+- REQ-WAV-SHIP-LEVEL: Each wave's enemy ships are assigned a level determined by a formula of elapsed game time in seconds (t), read from world.toml. This is the sole mechanism by which enemy waves grow stronger over time.
-- REQ-WAV-THREAT-COST: Ships are spawned until the accumulated threat is exhausted. Each ship type has a threat cost defined as a formula of ship level in ships.config. Because enemy ship level increases with time, threat cost per ship rises naturally over the course of the game.
+- REQ-WAV-THREAT-COST: Ships are spawned until the accumulated threat is exhausted. Each ship type has a threat cost defined as a formula of ship level in ships.toml. Because enemy ship level increases with time, threat cost per ship rises naturally over the course of the game.
-- REQ-WAV-SPAWN-DURATION: Ships in a wave are spawned one at a time over the spawn duration. Spawning duration is read from world.config.
+- REQ-WAV-SPAWN-DURATION: Ships in a wave are spawned one at a time over the spawn duration. Spawning duration is read from world.toml.
-- REQ-WAV-SHIP-STATS: Per-ship stats (damage, attack rate, range, speed) and threat cost are each defined as formulas of ship level in ships.config.
+- REQ-WAV-SHIP-STATS: Per-ship stats (damage, attack rate, range, speed) and threat cost are each defined as formulas of ship level in ships.toml.
 - REQ-WAV-GRACE-PERIOD: The grace period before the first wave is implicit: threat accumulates from t=0 but the first wave does not trigger until the initial gap (drawn at game start) has elapsed.
 
 ## Push Scaling
 
-- REQ-PSH-ACCUMULATION: Each time the player destroys a set of enemy defence stations, a configurable push scaling factor (world.config) is multiplied permanently into the threat level accumulation rate. This causes all subsequent waves to be larger.
+- REQ-PSH-ACCUMULATION: Each time the player destroys a set of enemy defence stations, a configurable push scaling factor (world.toml) is multiplied permanently into the threat level accumulation rate. This causes all subsequent waves to be larger.
-- REQ-PSH-STATION-STATS: Enemy defence station stats (HP, damage, range, fire rate) are each defined as formulas in stations.config where x is the station generation — an integer starting at 0 for the initial set and incrementing by 1 each time a new set is placed.
+- REQ-PSH-STATION-STATS: Enemy defence station stats (HP, damage, range, fire rate) are each defined as formulas in stations.toml where x is the station generation — an integer starting at 0 for the initial set and incrementing by 1 each time a new set is placed.
 - REQ-PSH-STACKING: Push scaling factors stack multiplicatively with each other and with the time-based threat formula.
 
 ## Asteroid Expansion
 
 - REQ-EXP-UNLOCK: The player can unlock additional asteroid tile columns to the left of the existing asteroid by spending building blocks from the global stock.
-- REQ-EXP-COST: Each expansion adds a configurable number of columns (world.config) and costs a configurable amount of building blocks (world.config).
+- REQ-EXP-COST: Each expansion adds a configurable number of columns (world.toml) and costs a configurable amount of building blocks (world.toml).
 
 ## UI