Merge pull request #2 from mamoniot/combinator

Combinator is now main branch

.vscode/factorio/runtime-api-LuaAISettings.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaAISettings
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaAccumulatorControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaAccumulatorControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaAchievementPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaAchievementPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaAmmoCategoryPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaAmmoCategoryPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaArithmeticCombinatorControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaArithmeticCombinatorControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaAutoplaceControlPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaAutoplaceControlPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaBootstrap.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaBootstrap
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaBurner.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaBurner
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaBurnerPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaBurnerPrototype
 -- This file is automatically generated. Edits will be overwritten.
@@ -19,6 +19,7 @@
 ---[View documentation](https://lua-api.factorio.com/latest/LuaBurnerPrototype.html#LuaBurnerPrototype.effectivity)
 ---@field effectivity double 
 ---[R]  
+---The emissions of this energy source in `pollution/Joule`. Multiplying it by energy consumption in `Watt` gives `pollution/second`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaBurnerPrototype.html#LuaBurnerPrototype.emissions)
 ---@field emissions double 

.vscode/factorio/runtime-api-LuaChunkIterator.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaChunkIterator
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaCircuitNetwork.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaCircuitNetwork
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaCombinatorControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaCombinatorControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaCommandProcessor.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaCommandProcessor
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaConstantCombinatorControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaConstantCombinatorControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaContainerControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaContainerControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaControl.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaControl
 -- This file is automatically generated. Edits will be overwritten.
@@ -206,14 +206,14 @@
 ---
 ---This is the GUI that will asked to close (by firing the [on_gui_closed](https://lua-api.factorio.com/latest/events.html#on_gui_closed) event) when the `Esc` or `E` keys are pressed. If this attribute is not `nil`, and a new GUI is written to it, the existing one will be asked to close.
 ---
----**Note:** Write supports any of the types. Read will return the `entity`, `equipment`, `equipment-grid`, `player`, `element`, `inventory` or `nil`.
+---**Note:** Write supports any of the types. Read will return the `entity`, `equipment`, `equipment-grid`, `player`, `element`, `inventory`, `technology`, or `nil`.
 ---
 ---**Events:**  
 --- * May raise [on_gui_opened](https://lua-api.factorio.com/latest/events.html#on_gui_opened) instantly.  
 ---Raised when writing a valid GUI target to this attribute.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.opened)
----@field opened? LuaEntity|LuaItemStack|LuaEquipment|LuaEquipmentGrid|LuaPlayer|LuaGuiElement|LuaInventory|defines.gui_type 
+---@field opened? LuaEntity|LuaItemStack|LuaEquipment|LuaEquipmentGrid|LuaPlayer|LuaGuiElement|LuaInventory|LuaTechnology|defines.gui_type 
 ---[R]
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.opened_gui_type)
@@ -244,7 +244,7 @@
 ---[View documentation](https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.resource_reach_distance)
 ---@field resource_reach_distance double 
 ---[RW]  
----Current riding state of this car or the vehicle this player is riding in.
+---Current riding state of this car, or of the car this player is riding in.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.riding_state)
 ---@field riding_state RidingState 
@@ -426,13 +426,13 @@ get_item_count=function(item)end,
 ---[View documentation](https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.get_main_inventory)
 ---@return LuaInventory?@The inventory or `nil` if this entity is not a character or player.
 get_main_inventory=function()end,
----Gets the parameters of a personal logistic request and auto-trash slot. Only used on `spider-vehicle`.
+---Gets the parameters of a personal logistic request and auto-trash slot.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.get_personal_logistic_slot)
 ---@param slot_index uint@The slot to get.
 ---@return LogisticParameters@The logistic parameters. If personal logistics are not researched yet, their `name` will be `nil`.
 get_personal_logistic_slot=function(slot_index)end,
----Gets the parameters of a vehicle logistic request and auto-trash slot.
+---Gets the parameters of a vehicle logistic request and auto-trash slot. Only used on `spider-vehicle`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.get_vehicle_logistic_slot)
 ---@param slot_index uint@The slot to get.

.vscode/factorio/runtime-api-LuaControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaCustomChartTag.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaCustomChartTag
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaCustomInputPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaCustomInputPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaCustomTable.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaCustomTable
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaDamagePrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaDamagePrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaDeciderCombinatorControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaDeciderCombinatorControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaDecorativePrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaDecorativePrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaElectricEnergySourcePrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaElectricEnergySourcePrototype
 -- This file is automatically generated. Edits will be overwritten.
@@ -19,6 +19,7 @@
 ---[View documentation](https://lua-api.factorio.com/latest/LuaElectricEnergySourcePrototype.html#LuaElectricEnergySourcePrototype.drain)
 ---@field drain double 
 ---[R]  
+---The emissions of this energy source in `pollution/Joule`. Multiplying it by energy consumption in `Watt` gives `pollution/second`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaElectricEnergySourcePrototype.html#LuaElectricEnergySourcePrototype.emissions)
 ---@field emissions double 

.vscode/factorio/runtime-api-LuaEntity.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaEntity
 -- This file is automatically generated. Edits will be overwritten.
@@ -282,6 +282,8 @@
 ---Whether the driver of this car or spidertron is the gunner. If `false`, the passenger is the gunner. `nil` if this is neither a car or a spidertron.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.driver_is_gunner)
+---
+---_Can only be used if this is Car or SpiderVehicle_
 ---@field driver_is_gunner? boolean 
 ---[RW]  
 ---Position where the entity puts its stuff.
@@ -884,7 +886,7 @@
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.selected_gun_index)
 ---
----_Can only be used if this is Character or Car_
+---_Can only be used if this is Character, Car or SpiderVehicle_
 ---@field selected_gun_index? uint 
 ---[R]  
 ---[LuaEntityPrototype::selection_box](https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.selection_box) around entity's given position and respecting the current entity orientation.
@@ -892,7 +894,7 @@
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.selection_box)
 ---@field selection_box BoundingBox 
 ---[RW]  
----The shooting target for this turret, if any.
+---The shooting target for this turret, if any. Can't be set to `nil` via script.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.shooting_target)
 ---@field shooting_target? LuaEntity 
@@ -1513,7 +1515,7 @@ get_heat_setting=function()end,
 ---_Can only be used if this is Rail_
 ---@return LuaEntity[]
 get_inbound_signals=function()end,
----Gets the filter for this infinity container at the given index or `nil` if the filter index doesn't exist or is empty.
+---Gets the filter for this infinity container at the given index, or `nil` if the filter index doesn't exist or is empty.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.get_infinity_container_filter)
 ---
@@ -1521,7 +1523,7 @@ get_inbound_signals=function()end,
 ---@param index uint@The index to get.
 ---@return InfinityInventoryFilter?
 get_infinity_container_filter=function(index)end,
----Gets the filter for this infinity pipe or `nil` if the filter is empty.
+---Gets the filter for this infinity pipe, or `nil` if the filter is empty.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.get_infinity_pipe_filter)
 ---
@@ -1598,7 +1600,7 @@ get_parent_signals=function()end,
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.get_passenger)
 ---
----_Can only be used if this is Vehicle_
+---_Can only be used if this is Car or SpiderVehicle_
 ---@return LuaEntity|LuaPlayer?@`nil` if the vehicle contains no passenger. To check if there's a driver see [LuaEntity::get_driver](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.get_driver).
 get_passenger=function()end,
 ---The radius of this entity.
@@ -2065,7 +2067,7 @@ set_driver=function(driver)end,
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_filter)
 ---@param slot_index uint@Index of the slot to set the filter for.
----@param item string@Prototype name of the item to filter.
+---@param item string|nil@Prototype name of the item to filter, or `nil` to clear the filter.
 set_filter=function(slot_index,item)end,
 ---Sets the heat setting for this heat interface.
 ---
@@ -2080,14 +2082,14 @@ set_heat_setting=function(filter)end,
 ---
 ---_Can only be used if this is InfinityContainer_
 ---@param index uint@The index to set.
----@param filter InfinityInventoryFilter@The new filter or `nil` to clear the filter.
+---@param filter InfinityInventoryFilter|nil@The new filter, or `nil` to clear the filter.
 set_infinity_container_filter=function(index,filter)end,
 ---Sets the filter for this infinity pipe.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_infinity_pipe_filter)
 ---
 ---_Can only be used if this is InfinityPipe_
----@param filter InfinityPipeFilter@The new filter or `nil` to clear the filter.
+---@param filter InfinityPipeFilter|nil@The new filter, or `nil` to clear the filter.
 set_infinity_pipe_filter=function(filter)end,
 ---Sets the passenger of this car or spidertron.
 ---
@@ -2098,7 +2100,7 @@ set_infinity_pipe_filter=function(filter)end,
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_passenger)
 ---
----_Can only be used if this is Vehicle_
+---_Can only be used if this is Car or SpiderVehicle_
 ---@param passenger LuaEntity|PlayerIdentification
 set_passenger=function(passenger)end,
 ---Sets the current recipe in this assembly machine.
@@ -2153,7 +2155,7 @@ spawn_decorations=function()end,
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.start_fading_out)
 start_fading_out=function()end,
----Stops the given SpiderVehicle.
+---Sets the [speed](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.speed) of the given SpiderVehicle to zero. Notably does not clear its [autopilot_destination](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.autopilot_destination), which it will continue moving towards if set.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.stop_spider)
 ---

.vscode/factorio/runtime-api-LuaEntityPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaEntityPrototype
 -- This file is automatically generated. Edits will be overwritten.
@@ -129,6 +129,13 @@
 ---_Can only be used if this is Lamp_
 ---@field always_on? boolean 
 ---[R]  
+---Name of the ammo category of this land mine.
+---
+---[View documentation](https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.ammo_category)
+---
+---_Can only be used if this is LandMine_
+---@field ammo_category? string 
+---[R]  
 ---The animation speed coefficient of this belt connectable prototype.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.animation_speed_coefficient)
@@ -743,6 +750,50 @@
 ---_Can only be used if this is ProgrammableSpeaker_
 ---@field instruments? ProgrammableSpeakerInstrument[] 
 ---[R]  
+---Everything in the following list is considered a building.
+---
+---- AccumulatorPrototype  
+---- ArtilleryTurretPrototype  
+---- BeaconPrototype  
+---- BoilerPrototype  
+---- BurnerGeneratorPrototype  
+---- CombinatorPrototype → ArithmeticCombinator, DeciderCombinator  
+---- ConstantCombinatorPrototype  
+---- ContainerPrototype → LogisticContainer, InfinityContainer  
+---- CraftingMachinePrototype → AssemblingMachine, RocketSilo, Furnace  
+---- ElectricEnergyInterfacePrototype  
+---- ElectricPolePrototype  
+---- EnemySpawnerPrototype  
+---- GatePrototype  
+---- GeneratorPrototype  
+---- HeatInterfacePrototype  
+---- HeatPipePrototype  
+---- InserterPrototype  
+---- LabPrototype  
+---- LampPrototype  
+---- LinkedContainerPrototype  
+---- MarketPrototype  
+---- MiningDrillPrototype  
+---- OffshorePumpPrototype  
+---- PipePrototype → InfinityPipe  
+---- PipeToGroundPrototype  
+---- PlayerPortPrototype  
+---- PowerSwitchPrototype  
+---- ProgrammableSpeakerPrototype  
+---- PumpPrototype  
+---- RadarPrototype  
+---- RailPrototype → CurvedRail, StraightRail  
+---- RailSignalBasePrototype → RailChainSignal, RailSignal  
+---- ReactorPrototype  
+---- RoboportPrototype  
+---- SimpleEntityPrototype  
+---- SimpleEntityWithOwnerPrototype → SimpleEntityWithForce  
+---- SolarPanelPrototype  
+---- StorageTankPrototype  
+---- TrainStopPrototype  
+---- TransportBeltConnectablePrototype → LinkedBelt, Loader1x1, Loader1x2, Splitter, TransportBelt, UndergroundBelt  
+---- TurretPrototype → AmmoTurret, ElectricTurret, FluidTurret  
+---- WallPrototype
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.is_building)
 ---@field is_building boolean 

.vscode/factorio/runtime-api-LuaEquipment.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaEquipment
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaEquipmentCategoryPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaEquipmentCategoryPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaEquipmentGrid.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaEquipmentGrid
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaEquipmentGridPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaEquipmentGridPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaEquipmentPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaEquipmentPrototype
 -- This file is automatically generated. Edits will be overwritten.
@@ -75,13 +75,15 @@
 ---**Note:** Both the `charging_station_shift` and `stationing_offset` vectors are tables with `x` and `y` keys instead of an array.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEquipmentPrototype.html#LuaEquipmentPrototype.logistic_parameters)
----@field logistic_parameters LuaEquipmentPrototype.logistic_parameters 
+---
+---_Can only be used if this is RoboportEquipment_
+---@field logistic_parameters? LuaEquipmentPrototype.logistic_parameters 
 ---[R]
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaEquipmentPrototype.html#LuaEquipmentPrototype.movement_bonus)
 ---
----_Can only be used if this is MovementBonusEquipmentPrototype_
+---_Can only be used if this is MovementBonusEquipment_
----@field movement_bonus float 
+---@field movement_bonus? float 
 ---[R]  
 ---Name of this prototype.
 ---

.vscode/factorio/runtime-api-LuaFlowStatistics.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaFlowStatistics
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaFluidBox.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaFluidBox
 -- This file is automatically generated. Edits will be overwritten.
@@ -41,7 +41,7 @@
 ---[View documentation](https://lua-api.factorio.com/latest/LuaFluidBox.html#LuaFluidBox.length)
 ---@operator len: uint
 ---[R]  
----Access, set or clear a fluid box. The index must always be in bounds (see [LuaFluidBox::index](https://lua-api.factorio.com/latest/LuaFluidBox.html#LuaFluidBox.index)). New fluidboxes may not be added or removed using this operator.
+---Access, set or clear a fluid box. The index must always be in bounds (see [LuaFluidBox::length_operator](https://lua-api.factorio.com/latest/LuaFluidBox.html#LuaFluidBox.length_operator)). New fluidboxes may not be added or removed using this operator.
 ---
 ---Is `nil` if the given fluid box does not contain any fluid. Writing `nil` removes all fluid from the fluid box.
 ---
@@ -110,7 +110,7 @@ help=function()end,
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaFluidBox.html#LuaFluidBox.set_filter)
 ---@param index uint@The index of the filter to set.
----@param filter FluidBoxFilterSpec?@The filter to set. Setting `nil` clears the filter.
+---@param filter FluidBoxFilterSpec|nil@The filter to set. Setting `nil` clears the filter.
 ---@return boolean@Whether the filter was set successfully.
 set_filter=function(index,filter)end,
 }

.vscode/factorio/runtime-api-LuaFluidBoxPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaFluidBoxPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaFluidEnergySourcePrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaFluidEnergySourcePrototype
 -- This file is automatically generated. Edits will be overwritten.
@@ -23,6 +23,7 @@
 ---[View documentation](https://lua-api.factorio.com/latest/LuaFluidEnergySourcePrototype.html#LuaFluidEnergySourcePrototype.effectivity)
 ---@field effectivity double 
 ---[R]  
+---The emissions of this energy source in `pollution/Joule`. Multiplying it by energy consumption in `Watt` gives `pollution/second`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaFluidEnergySourcePrototype.html#LuaFluidEnergySourcePrototype.emissions)
 ---@field emissions double 

.vscode/factorio/runtime-api-LuaFluidPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaFluidPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaFontPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaFontPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaForce.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaForce
 -- This file is automatically generated. Edits will be overwritten.
@@ -502,8 +502,12 @@ get_saved_technology_progress=function(technology)end,
 get_spawn_position=function(surface)end,
 ---[View documentation](https://lua-api.factorio.com/latest/LuaForce.html#LuaForce.get_train_stops)
 ---@class LuaForce.get_train_stops_param
+---The name(s) of the train stops. Not providing names will match any stop.
+---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaForce.html#LuaForce.get_train_stops)
 ---@field name? string|string[] 
+---The surface to search. Not providing a surface will match stops on any surface.
+---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaForce.html#LuaForce.get_train_stops)
 ---@field surface? SurfaceIdentification 
 
@@ -515,7 +519,7 @@ get_spawn_position=function(surface)end,
 ---@return LuaEntity[]
 get_train_stops=function(param)end,
 ---[View documentation](https://lua-api.factorio.com/latest/LuaForce.html#LuaForce.get_trains)
----@param surface SurfaceIdentification?@If given only trains on the surface are returned.
+---@param surface SurfaceIdentification?@The surface to search. Not providing a surface will match trains on any surface.
 ---@return LuaTrain[]
 get_trains=function(surface)end,
 ---[View documentation](https://lua-api.factorio.com/latest/LuaForce.html#LuaForce.get_turret_attack_modifier)

.vscode/factorio/runtime-api-LuaFuelCategoryPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaFuelCategoryPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaGameScript.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaGameScript
 -- This file is automatically generated. Edits will be overwritten.
@@ -500,7 +500,7 @@ force_crc=function()end,
 ---**Note:** This is very expensive to determine.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.get_active_entities_count)
----@param surface SurfaceIdentification?@If give, only the entities active on this surface are counted.
+---@param surface SurfaceIdentification?@If given, only the entities active on this surface are counted.
 ---@return uint
 get_active_entities_count=function(surface)end,
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.get_entity_by_tag)
@@ -656,10 +656,16 @@ get_script_inventories=function(mod)end,
 get_surface=function(surface)end,
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.get_train_stops)
 ---@class LuaGameScript.get_train_stops_param
+---The name(s) of the train stops. Not providing names will match any stop.
+---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.get_train_stops)
 ---@field name? string|string[] 
+---The surface to search. Not providing a surface will match stops on any surface.
+---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.get_train_stops)
 ---@field surface? SurfaceIdentification 
+---The force to search. Not providing a force will match stops in any force.
+---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.get_train_stops)
 ---@field force? ForceIdentification 
 
@@ -841,18 +847,18 @@ server_save=function(name)end,
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.set_game_state)
 ---@class LuaGameScript.set_game_state_param
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.set_game_state)
----@field game_finished boolean 
+---@field game_finished? boolean 
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.set_game_state)
----@field player_won boolean 
+---@field player_won? boolean 
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.set_game_state)
----@field next_level string 
+---@field next_level? string 
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.set_game_state)
----@field can_continue boolean 
+---@field can_continue? boolean 
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.set_game_state)
----@field victorious_force ForceIdentification 
+---@field victorious_force? ForceIdentification 
 
 
----Set scenario state.
+---Set scenario state. Any parameters not provided do not change the current state.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.set_game_state)
 ---@param param LuaGameScript.set_game_state_param

.vscode/factorio/runtime-api-LuaGenericOnOffControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaGenericOnOffControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaGroup.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaGroup
 -- This file is automatically generated. Edits will be overwritten.
@@ -35,19 +35,15 @@
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGroup.html#LuaGroup.order)
 ---@field order string 
 ---[R]  
----The additional order value used in recipe ordering.
+---The additional order value used in recipe ordering. Can only be used on groups, not on subgroups.
----
----**Note:** Can only be used on groups, not on subgroups.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGroup.html#LuaGroup.order_in_recipe)
----@field order_in_recipe string 
+---@field order_in_recipe? string 
 ---[R]  
----Subgroups of this group.
+---Subgroups of this group. Can only be used on groups, not on subgroups.
----
----**Note:** Can only be used on groups, not on subgroups.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGroup.html#LuaGroup.subgroups)
----@field subgroups LuaGroup[] 
+---@field subgroups? LuaGroup[] 
 ---[R]
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGroup.html#LuaGroup.type)

.vscode/factorio/runtime-api-LuaGui.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaGui
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaGuiElement.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaGuiElement
 -- This file is automatically generated. Edits will be overwritten.
@@ -127,9 +127,11 @@
 ---_Can only be used if this is textfield or text-box_
 ---@field clear_and_focus_on_right_click boolean 
 ---[RW]  
----The image to display on this sprite-button when it is clicked.
+---The sprite to display on this sprite-button when it is clicked.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.clicked_sprite)
+---
+---_Can only be used if this is sprite-button_
 ---@field clicked_sprite SpritePath 
 ---[R]  
 ---The number of columns in this table.
@@ -236,11 +238,15 @@
 ---The entity associated with this entity-preview, camera, minimap, if any.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.entity)
+---
+---_Can only be used if this is entity-preview, camera or minimap_
 ---@field entity? LuaEntity 
 ---[RW]  
 ---The force this minimap is using, if any.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.force)
+---
+---_Can only be used if this is minimap_
 ---@field force? string 
 ---[R]  
 ---The GUI this element is a child of.
@@ -255,7 +261,7 @@
 ---_Can only be used if this is scroll-pane_
 ---@field horizontal_scroll_policy string 
 ---[RW]  
----The image to display on this sprite-button when it is hovered.
+---The sprite to display on this sprite-button when it is hovered.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.hovered_sprite)
 ---
@@ -282,6 +288,8 @@
 ---The items in this dropdown or listbox.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.items)
+---
+---_Can only be used if this is drop-down or list-box_
 ---@field items LocalisedString[] 
 ---[RW]  
 ---The text shown for the left switch label.
@@ -327,6 +335,8 @@
 ---The mouse button filters for this button or sprite-button.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.mouse_button_filter)
+---
+---_Can only be used if this is button or sprite-button_
 ---@field mouse_button_filter MouseButtonFlags 
 ---[RW]  
 ---The name of this element. `""` if no name was set.
@@ -342,6 +352,8 @@
 ---The number to be shown in the bottom right corner of this sprite-button. Set this to `nil` to show nothing.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.number)
+---
+---_Can only be used if this is sprite-button_
 ---@field number double 
 ---[RW]  
 ---Whether this textfield is limited to only numberic characters.
@@ -369,6 +381,8 @@
 ---The position this camera or minimap is focused on, if any.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.position)
+---
+---_Can only be used if this is camera or minimap_
 ---@field position MapPosition 
 ---[RW]  
 ---Whether this text-box is read-only. Defaults to `false`.
@@ -378,9 +392,11 @@
 ---_Can only be used if this is text-box_
 ---@field read_only boolean 
 ---[RW]  
----Whether the image widget should resize according to the sprite in it. Defaults to `true`.
+---Whether the sprite widget should resize according to the sprite in it. Defaults to `true`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.resize_to_sprite)
+---
+---_Can only be used if this is sprite_
 ---@field resize_to_sprite boolean 
 ---[RW]  
 ---The text shown for the right switch label.
@@ -407,6 +423,8 @@
 ---The selected index for this dropdown or listbox. Returns `0` if none is selected.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.selected_index)
+---
+---_Can only be used if this is drop-down or list-box_
 ---@field selected_index uint 
 ---[RW]  
 ---The selected tab index for this tabbed pane, if any.
@@ -419,6 +437,8 @@
 ---Related to the number to be shown in the bottom right corner of this sprite-button. When set to `true`, numbers that are non-zero and smaller than one are shown as a percentage rather than the value. For example, `0.5` will be shown as `50%` instead.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.show_percent_for_small_numbers)
+---
+---_Can only be used if this is sprite-button_
 ---@field show_percent_for_small_numbers boolean 
 ---[RW]  
 ---The value of this slider element.
@@ -428,16 +448,18 @@
 ---_Can only be used if this is slider_
 ---@field slider_value double 
 ---[RW]  
----The image to display on this sprite-button or sprite in the default state.
+---The sprite to display on this sprite-button or sprite in the default state.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.sprite)
+---
+---_Can only be used if this is sprite-button or sprite_
 ---@field sprite SpritePath 
 ---[RW]  
 ---Is this checkbox or radiobutton checked?
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.state)
 ---
----_Can only be used if this is CheckBox or RadioButton_
+---_Can only be used if this is checkbox or radiobutton_
 ---@field state boolean 
 ---[RW]  
 ---The style of this element. When read, this evaluates to a [LuaStyle](https://lua-api.factorio.com/latest/LuaStyle.html). For writing, it only accepts a string that specifies the textual identifier (prototype name) of the desired style.
@@ -448,6 +470,8 @@
 ---The surface index this camera or minimap is using.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.surface_index)
+---
+---_Can only be used if this is camera or minimap_
 ---@field surface_index uint 
 ---[RW]  
 ---The switch state (left, none, right) for this switch.
@@ -462,6 +486,8 @@
 ---The tabs and contents being shown in this tabbed-pane.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.tabs)
+---
+---_Can only be used if this is tabbed-pane_
 ---@field tabs TabAndContent[] 
 ---[RW]  
 ---The tags associated with this LuaGuiElement.
@@ -526,6 +552,8 @@
 ---The zoom this camera or minimap is using. This value must be positive.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.zoom)
+---
+---_Can only be used if this is camera or minimap_
 ---@field zoom double 
 ---[R]  
 ---The indexing operator. Gets children by name.
@@ -563,7 +591,7 @@ local LuaGuiElement={
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.add)
 ---@field ignored_by_interaction? boolean 
----Style of the child element.
+---The name of the style prototype to apply to the new element.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.add)
 ---@field style? string 
@@ -905,6 +933,8 @@ add=function(param)end,
 ---Inserts a string at the end or at the given index of this dropdown or listbox.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.add_item)
+---
+---_Can only be used if this is drop-down or list-box_
 ---@param string LocalisedString@The text to insert.
 ---@param index uint?@The index at which to insert the item.
 add_item=function(string,index)end,
@@ -934,6 +964,8 @@ clear=function()end,
 ---Removes the items in this dropdown or listbox.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.clear_items)
+---
+---_Can only be used if this is drop-down or list-box_
 clear_items=function()end,
 ---Remove this element, along with its children. Any [LuaGuiElement](https://lua-api.factorio.com/latest/LuaGuiElement.html) objects referring to the destroyed elements become invalid after this operation.
 ---
@@ -969,6 +1001,8 @@ get_index_in_parent=function()end,
 ---Gets the item at the given index from this dropdown or listbox.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.get_item)
+---
+---_Can only be used if this is drop-down or list-box_
 ---@param index uint@The index to get
 ---@return LocalisedString
 get_item=function(index)end,
@@ -1012,6 +1046,8 @@ help=function()end,
 ---Removes the item at the given index from this dropdown or listbox.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.remove_item)
+---
+---_Can only be used if this is drop-down or list-box_
 ---@param index uint@The index
 remove_item=function(index)end,
 ---Removes the given tab and its associated content from this tabbed pane.
@@ -1094,6 +1130,8 @@ select_all=function()end,
 ---Sets the given string at the given index in this dropdown or listbox.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.set_item)
+---
+---_Can only be used if this is drop-down or list-box_
 ---@param index uint@The index whose text to replace.
 ---@param string LocalisedString@The text to set at the given index.
 set_item=function(index,string)end,

.vscode/factorio/runtime-api-LuaHeatBufferPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaHeatBufferPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaHeatEnergySourcePrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaHeatEnergySourcePrototype
 -- This file is automatically generated. Edits will be overwritten.
@@ -19,6 +19,7 @@
 ---[View documentation](https://lua-api.factorio.com/latest/LuaHeatEnergySourcePrototype.html#LuaHeatEnergySourcePrototype.default_temperature)
 ---@field default_temperature double 
 ---[R]  
+---The emissions of this energy source in `pollution/Joule`. Multiplying it by energy consumption in `Watt` gives `pollution/second`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaHeatEnergySourcePrototype.html#LuaHeatEnergySourcePrototype.emissions)
 ---@field emissions double 

.vscode/factorio/runtime-api-LuaInserterControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaInserterControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaInventory.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaInventory
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaItemPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaItemPrototype
 -- This file is automatically generated. Edits will be overwritten.
@@ -543,7 +543,7 @@ local LuaItemPrototype={
 ---[View documentation](https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.get_ammo_type)
 ---
 ---_Can only be used if this is AmmoItem_
----@param ammo_source_type string?@"default", "player", "turret", or "vehicle"
+---@param ammo_source_type string?@One of `"default"`, `"player"`, `"turret"`, or `"vehicle"`. Defaults to `"default"`.
 ---@return AmmoType?
 get_ammo_type=function(ammo_source_type)end,
 ---Does this prototype have a flag enabled?

.vscode/factorio/runtime-api-LuaItemStack.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaItemStack
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaLampControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaLampControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaLazyLoadedValue.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaLazyLoadedValue
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaLogisticCell.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaLogisticCell
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaLogisticContainerControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaLogisticContainerControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaLogisticNetwork.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaLogisticNetwork
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaLogisticPoint.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaLogisticPoint
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaMiningDrillControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaMiningDrillControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaModSettingPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaModSettingPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaModuleCategoryPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaModuleCategoryPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaNamedNoiseExpression.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaNamedNoiseExpression
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaNoiseLayerPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaNoiseLayerPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaParticlePrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaParticlePrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaPermissionGroup.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaPermissionGroup
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaPermissionGroups.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaPermissionGroups
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaPlayer.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaPlayer
 -- This file is automatically generated. Edits will be overwritten.
@@ -314,15 +314,15 @@ build_from_cursor=function(param)end,
 can_build_from_cursor=function(param)end,
 ---[View documentation](https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.can_place_entity)
 ---@class LuaPlayer.can_place_entity_param
----Name of the entity to check
+---Name of the entity to check.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.can_place_entity)
 ---@field name string 
----Where the entity would be placed
+---Where the entity would be placed.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.can_place_entity)
 ---@field position MapPosition 
----Direction the entity would be placed
+---Direction the entity would be placed. Defaults to `north`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.can_place_entity)
 ---@field direction? defines.direction 
@@ -744,7 +744,7 @@ set_goal_description=function(text,only_update)end,
 ---
 ---_Can only be used if this is InfinityContainer_
 ---@param index uint@The index to set.
----@param filter InfinityInventoryFilter@The new filter or `nil` to clear the filter.
+---@param filter InfinityInventoryFilter|nil@The new filter or `nil` to clear the filter.
 set_infinity_inventory_filter=function(index,filter)end,
 ---Sets the quick bar filter for the given slot.
 ---

.vscode/factorio/runtime-api-LuaProfiler.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaProfiler
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaProgrammableSpeakerControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaProgrammableSpeakerControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaRCON.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaRCON
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaRailChainSignalControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaRailChainSignalControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaRailPath.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaRailPath
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaRailSignalControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaRailSignalControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaRandomGenerator.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaRandomGenerator
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaRecipe.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaRecipe
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaRecipeCategoryPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaRecipeCategoryPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaRecipePrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaRecipePrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaRemote.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaRemote
 -- This file is automatically generated. Edits will be overwritten.
@@ -26,7 +26,7 @@
 ---```
 ---@class LuaRemote:LuaObject
 ---[R]  
----List of all registered interfaces. For each interface name, `remote.interfaces[name]` is a dictionary mapping the interface's registered functions to the value `true`.
+---List of all registered interfaces. For each interface name, `remote.interfaces[name]` is a dictionary mapping the interface's registered functions to `true`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaRemote.html#LuaRemote.interfaces)
 ---
@@ -36,7 +36,7 @@
 ---game.player.print(tostring(remote.interfaces["human interactor"]["hello"]))        -- prints true
 ---game.player.print(tostring(remote.interfaces["human interactor"]["nonexistent"]))  -- prints nil
 ---```
----@field interfaces {[string]: {[string]: boolean}} 
+---@field interfaces {[string]: {[string]: true}} 
 ---[R]  
 ---This object's name.
 ---
@@ -45,20 +45,18 @@
 remote={
 ---Add a remote interface.
 ---
----**Note:** It is an error if the given interface `name` is already registered.
----
 ---[View documentation](https://lua-api.factorio.com/latest/LuaRemote.html#LuaRemote.add_interface)
----@param name string@Name of the interface.
+---@param name string@Name of the interface. If the name matches any existing interface, an error is thrown.
 ---@param functions {[string]: fun()}@List of functions that are members of the new interface.
 add_interface=function(name,functions)end,
 ---Call a function of an interface.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaRemote.html#LuaRemote.call)
 ---@param interface string@Interface to look up `function` in.
----@param function_ string@Function name that belongs to `interface`.
+---@param function_ string@Function name that belongs to the `interface`.
 ---@vararg Any
 ---
----**vararg**: Arguments to pass to the called function.
+---**vararg**: Arguments to pass to the called function. Note that any arguments passed through the interface are a copy of the original, not a reference. Metatables are not retained, while references to LuaObjects stay intact.
 ---@return Any?
 call=function(interface,function_,...)end,
 ---Removes an interface with the given name.

.vscode/factorio/runtime-api-LuaRendering.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaRendering
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaResourceCategoryPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaResourceCategoryPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaRoboportControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaRoboportControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaSettings.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaSettings
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaShortcutPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaShortcutPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaStorageTankControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaStorageTankControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaStyle.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaStyle
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaSurface.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaSurface
 -- This file is automatically generated. Edits will be overwritten.
@@ -175,19 +175,19 @@ build_enemy_base=function(position,unit_count,force)end,
 calculate_tile_properties=function(property_names,positions)end,
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.can_fast_replace)
 ---@class LuaSurface.can_fast_replace_param
----Name of the entity to check
+---Name of the entity to check.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.can_fast_replace)
 ---@field name string 
----Where the entity would be placed
+---Where the entity would be placed.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.can_fast_replace)
 ---@field position MapPosition 
----Direction the entity would be placed
+---Direction the entity would be placed. Defaults to `north`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.can_fast_replace)
 ---@field direction? defines.direction 
----The force that would place the entity. If not specified, the enemy force is assumed.
+---The force that would place the entity. Defaults to the `"neutral"` force.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.can_fast_replace)
 ---@field force? ForceIdentification 
@@ -209,19 +209,19 @@ can_fast_replace=function(param)end,
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.can_place_entity)
 ---@field position MapPosition 
----Direction of the placed entity.
+---Direction of the placed entity. Defaults to `north`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.can_place_entity)
 ---@field direction? defines.direction 
----The force that would place the entity. If not specified, the enemy force is assumed.
+---The force that would place the entity. Defaults to the `"neutral"` force.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.can_place_entity)
 ---@field force? ForceIdentification 
----Which type of check should be carried out.
+---Which type of check should be carried out. Defaults to `ghost_revive`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.can_place_entity)
 ---@field build_check_type? defines.build_check_type 
----If `true`, entities that can be marked for deconstruction are ignored. Only used if `build_check_type` is either `manual_ghost`, `script_ghost` or `blueprint_ghost`.
+---If `true`, entities that can be marked for deconstruction are ignored. Only used if `build_check_type` is either `manual_ghost`, `script_ghost` or `blueprint_ghost`. Defaults to `false`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.can_place_entity)
 ---@field forced? boolean 
@@ -630,11 +630,17 @@ create_decoratives=function(param)end,
 ---Applies to **"beam"**: (optional)  
 ---Absolute target position that can be used instead of target entity (entity has precedence if both entity and position are defined).
 ---
+---Applies to **"stream"**: (optional)  
+---Absolute target position that can be used instead of target entity (entity has precedence if both entity and position are defined).
+---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.create_entity)
 ---@field target_position? MapPosition 
 ---Applies to **"beam"**: (optional)  
 ---Absolute source position that can be used instead of source entity (entity has precedence if both entity and position are defined).
 ---
+---Applies to **"stream"**: (optional)  
+---Absolute source position that can be used instead of source entity (entity has precedence if both entity and position are defined).
+---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.create_entity)
 ---@field source_position? MapPosition 
 ---Applies to **"beam"**: (optional)  
@@ -650,6 +656,9 @@ create_decoratives=function(param)end,
 ---Applies to **"beam"**: (optional)  
 ---Source position will be offset by this value when rendering the beam.
 ---
+---Applies to **"stream"**: (optional)  
+---Source position will be offset by this value when rendering the stream.
+---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.create_entity)
 ---@field source_offset? Vector 
 ---Applies to **"container"**: (optional)  
@@ -761,12 +770,16 @@ create_decoratives=function(param)end,
 ---@field frame_speed float 
 ---Applies to **"projectile"**: (required)
 ---
----[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.create_entity)
+---Applies to **"artillery-projectile"**: (required)
----@field speed double 
----Applies to **"projectile"**: (required)
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.create_entity)
----@field max_range double 
+---@field speed double 
+---Applies to **"projectile"**: (optional)
+---
+---Applies to **"artillery-projectile"**: (optional)
+---
+---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.create_entity)
+---@field max_range? double 
 ---Applies to **"resource"**: (required)
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.create_entity)
@@ -1435,9 +1448,9 @@ get_script_positions=function(name)end,
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.get_starting_area_radius)
 ---@return double
 get_starting_area_radius=function()end,
----Get the tile at a given position.
+---Get the tile at a given position. An alternative call signature for this method is passing it a single [TilePosition](https://lua-api.factorio.com/latest/Concepts.html#TilePosition).
 ---
----**Note:** The input position params can also be a single tile position.
+---**Note:** Non-integer values will result in them being rounded down.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.get_tile)
 ---@param x int
@@ -1451,8 +1464,12 @@ get_tile=function(x,y)end,
 get_total_pollution=function()end,
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.get_train_stops)
 ---@class LuaSurface.get_train_stops_param
+---The name(s) of the train stops. Not providing names will match any stop.
+---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.get_train_stops)
 ---@field name? string|string[] 
+---The force to search. Not providing a force will match stops in any force.
+---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.get_train_stops)
 ---@field force? ForceIdentification 
 
@@ -1464,7 +1481,7 @@ get_total_pollution=function()end,
 ---@return LuaEntity[]
 get_train_stops=function(param)end,
 ---[View documentation](https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.get_trains)
----@param force ForceIdentification?@If given only trains matching this force are returned.
+---@param force ForceIdentification?@The force to search. Not providing a force will match trains in any force.
 ---@return LuaTrain[]
 get_trains=function(force)end,
 ---All methods and properties that this object supports.

.vscode/factorio/runtime-api-LuaTechnology.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaTechnology
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaTechnologyPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaTechnologyPrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaTile.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaTile
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaTilePrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaTilePrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaTrain.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaTrain
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaTrainStopControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaTrainStopControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaTransportBeltControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaTransportBeltControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaTransportLine.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaTransportLine
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaTrivialSmokePrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaTrivialSmokePrototype
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaUnitGroup.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaUnitGroup
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-LuaVirtualSignalPrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaVirtualSignalPrototype
 -- This file is automatically generated. Edits will be overwritten.
@@ -34,7 +34,7 @@
 ---[View documentation](https://lua-api.factorio.com/latest/LuaVirtualSignalPrototype.html#LuaVirtualSignalPrototype.order)
 ---@field order string 
 ---[R]  
----If this is a special signal
+---Whether this is a special signal. The `everything`, `anything`, `each`, and `unknown` signals are considered special.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaVirtualSignalPrototype.html#LuaVirtualSignalPrototype.special)
 ---@field special boolean 

.vscode/factorio/runtime-api-LuaVoidEnergySourcePrototype.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaVoidEnergySourcePrototype
 -- This file is automatically generated. Edits will be overwritten.
@@ -11,6 +11,7 @@
 ---[View documentation](https://lua-api.factorio.com/latest/LuaVoidEnergySourcePrototype.html)
 ---@class LuaVoidEnergySourcePrototype:LuaObject
 ---[R]  
+---The emissions of this energy source in `pollution/Joule`. Multiplying it by energy consumption in `Watt` gives `pollution/second`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/LuaVoidEnergySourcePrototype.html#LuaVoidEnergySourcePrototype.emissions)
 ---@field emissions double 

.vscode/factorio/runtime-api-LuaWallControlBehavior.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section LuaWallControlBehavior
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-builtin.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section builtin
 -- This file is automatically generated. Edits will be overwritten.

.vscode/factorio/runtime-api-concepts.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section concepts
 -- This file is automatically generated. Edits will be overwritten.
@@ -515,20 +515,41 @@
 
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#CapsuleAction)
 ---@class CapsuleAction
----One of `"throw"`, `"equipment-remote"`, `"use-on-self"`.
+---One of `"throw"`, `"equipment-remote"`, `"use-on-self"`, `"artillery-remote"`, `"destroy-cliffs"`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#CapsuleAction)
 ---@field type string 
----Only present when `type` is `"throw"` or `"use-on-self"`.
+---Applies to **"artillery-remote"**: (required)  
+---Name of the [flare prototype](https://lua-api.factorio.com/latest/LuaEntityPrototype.html).
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#CapsuleAction)
----@field attack_parameters? AttackParameters 
----Only present when `type` is `"equipment-remote"`. It is the equipment prototype name.
----
----[View documentation](https://lua-api.factorio.com/latest/Concepts.html#CapsuleAction)
----@field equipment? string 
----[View documentation](https://lua-api.factorio.com/latest/Concepts.html#CapsuleAction)
 ---@field flare? string 
+---Applies to **"throw"**: (required)
+---
+---Applies to **"use-on-self"**: (required)
+---
+---Applies to **"destroy-cliffs"**: (required)
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#CapsuleAction)
+---@field attack_parameters AttackParameters 
+---Applies to **"throw"**: (required)  
+---Whether using the capsule consumes an item from the stack.
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#CapsuleAction)
+---@field uses_stack boolean 
+---Applies to **"equipment-remote"**: (required)  
+---Name of the [LuaEquipmentPrototype](https://lua-api.factorio.com/latest/LuaEquipmentPrototype.html).
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#CapsuleAction)
+---@field equipment string 
+---Applies to **"destroy-cliffs"**: (required)
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#CapsuleAction)
+---@field radius float 
+---Applies to **"destroy-cliffs"**: (required)
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#CapsuleAction)
+---@field timeout uint 
 
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#ChartTagSpec)
 ---@class ChartTagSpec
@@ -662,7 +683,7 @@
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#CliffPlacementSettings)
 ---@field richness MapGenSize 
 
----A set of flags. Set flags are in the dictionary as `true`, while unset flags aren't present at all.
+---A set of flags. Active flags are in the dictionary as `true`, while inactive flags aren't present at all.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#CollisionMask)
 ---@alias CollisionMask {[CollisionMaskLayer]: true}
@@ -1163,7 +1184,7 @@
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#EntityPrototypeFilter)
 ---@field crafting_category string 
 
----A set of flags. Set flags are in the dictionary as `true`, while unset flags aren't present at all.
+---A set of flags. Active flags are in the dictionary as `true`, while inactive flags aren't present at all.
 ---
 ---By default, none of these flags are set.
 ---
@@ -1794,7 +1815,7 @@
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#ItemPrototypeFilter)
 ---@field value uint 
 
----A set of flags. Set flags are in the dictionary as `true`, while unset flags aren't present at all.
+---A set of flags. Active flags are in the dictionary as `true`, while inactive flags aren't present at all.
 ---
 ---By default, none of these flags are set.
 ---
@@ -2886,7 +2907,7 @@
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#ModuleEffects)
 ---@field pollution? ModuleEffectValue 
 
----A set of flags. Set flags are in the dictionary as `true`, while unset flags aren't present at all.
+---A set of flags. Active flags are in the dictionary as `true`, while inactive flags aren't present at all.
 ---
 ---To write to this, use an array[[string](https://lua-api.factorio.com/latest/Builtin-Types.html#string)] of the mouse buttons that should be possible to use with on button. The flag `"left-and-right"` can also be set, which will set `"left"` and `"right"` to `true`.
 ---
@@ -3144,7 +3165,7 @@
 ---The amount of pollution eaten by a chunk's tiles as a percentage of 1. Defaults to `1`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#PollutionMapSettings)
----@field aeging double 
+---@field ageing double 
 ---Any amount of pollution larger than this value is visualized as this value instead. Defaults to `150`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#PollutionMapSettings)
@@ -3405,50 +3426,98 @@
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectedPrototypeData)
 ---@field name string 
 
----A set of flags. Set flags are in the dictionary as `true`, while unset flags aren't present at all.
+---A set of flags on a selection tool that define how entities and tiles are selected. Active flags are in the dictionary as `true`, while inactive flags aren't present at all.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@class SelectionModeFlags
----Entities that can be selected for blueprint.
+---Selects entities and tiles as if selecting them for a blueprint.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["blueprint"] true|nil
----Entities that can be marked for deconstruction.
+---Selects entities and tiles as if selecting them for deconstruction.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["deconstruct"] true|nil
----Entities that can be marked for deconstruction cancelling.
+---Selects entities and tiles as if selecting them for deconstruction cancellation.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["cancel-deconstruct"] true|nil
----@field ["item"] true|nil
+---Selects items on the ground.
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
+---@field ["items"] true|nil
+---Selects trees.
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["trees"] true|nil
----Buildable entities.
+---Selects entities which are considered a [building](https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.is_building), plus landmines.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["buildable-type"] true|nil
----Only select an area.
+---Selects no entities or tiles, but is useful to select an area.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["nothing"] true|nil
----Entities that can be placed using an item.
+---Selects entities and tiles that can be [built by an item](https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.place_result).
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["items-to-place"] true|nil
+---Selects all entities.
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["any-entity"] true|nil
+---Selects all tiles.
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["any-tile"] true|nil
----Entities with the same force as the selector.
+---Selects entities with the same force as the selecting player.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["same-force"] true|nil
+---Selects entities with a different force as the selecting player.
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["not-same-force"] true|nil
+---Selects entities from a [friendly](https://lua-api.factorio.com/latest/LuaForce.html#LuaForce.is_friend) force.
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["friend"] true|nil
+---Selects entities from an [enemy](https://lua-api.factorio.com/latest/LuaForce.html#LuaForce.is_enemy) force.
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["enemy"] true|nil
+---Selects entities as if selecting them for upgrading.
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["upgrade"] true|nil
+---Selects entities as if selecting them for upgrade cancellation.
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["cancel-upgrade"] true|nil
+---Selects entities as if selecting them for downgrading.
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
+---@field ["downgrade"] true|nil
+---Selects entities that are [entities with health](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.is_entity_with_health).
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["entity-with-health"] true|nil
+---Deprecated. Replaced by `is-military-target`.
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["entity-with-force"] true|nil
+---Selects entities that are [military targets](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.is_military_target).
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
+---@field ["is-military-target"] true|nil
+---Selects entities that are [entities with owner](https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.is_entity_with_owner).
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
 ---@field ["entity-with-owner"] true|nil
+---Selects entities that are not `rolling-stocks`.
+---
+---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#SelectionModeFlags)
+---@field ["avoid-rolling-stock"] true|nil
 
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#Signal)
 ---@class Signal
@@ -4004,11 +4073,11 @@
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#WaitCondition)
 ---@field compare_type string 
----Number of ticks to wait or of inactivity. Only present when `type` is `"time"` or `"inactivity"`.
+---Number of ticks to wait when `type` is `"time"`, or number of ticks of inactivity when `type` is `"inactivity"`.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#WaitCondition)
 ---@field ticks? uint 
----Only present when `type` is `"item_count"`, `"circuit"` or `"fluid_count"`.
+---Only present when `type` is `"item_count"`, `"circuit"` or `"fluid_count"`, and a circuit condition is configured.
 ---
 ---[View documentation](https://lua-api.factorio.com/latest/Concepts.html#WaitCondition)
 ---@field condition? CircuitCondition 

.vscode/factorio/runtime-api-custom.lua

@@ -1,7 +1,7 @@
 ---@meta
 ---@diagnostic disable
 
---$Factorio 1.1.69
+--$Factorio 1.1.70
 --$Overlay 5
 --$Section custom
 -- This file is automatically generated. Edits will be overwritten.