api update

.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