factorio-types 0.0.21 → 0.0.24

package/dist/classes.d.ts

@@ -2,7 +2,7 @@
 // Factorio API reference https://lua-api.factorio.com/latest/index.html
 // Generated from JSON source https://lua-api.factorio.com/latest/runtime-api.json
 // Definition source https://github.com/sguest/factorio-types
-// Factorio version 1.1.54
+// Factorio version 1.1.60
 // API version 2
 
 /**
@@ -97,7 +97,7 @@ interface LuaAchievementPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -134,7 +134,7 @@ interface LuaAmmoCategoryPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -160,9 +160,9 @@ interface LuaArithmeticCombinatorControlBehavior extends LuaCombinatorControlBeh
     readonly object_name: string
 
     /**
-     * The arithmetic combinator parameters.
+     * This arithmetic combinator's parameters.
      * @remarks
-     * `parameters` may be `nil` in order to clear the parameters.
+     * Writing `nil` clears the combinator's parameters.
      *
      */
     parameters: ArithmeticCombinatorParameters
@@ -207,7 +207,7 @@ interface LuaAutoplaceControlPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -249,7 +249,10 @@ interface LuaBootstrap {
     get_event_order(this: void): void
 
     /**
-     * Register a function to be run when mod configuration changes. This is called when the game version or any mod version changes; when any mod is added or removed; or when prototypes or startup mod settings have changed. It allows the mod to make any changes it deems appropriate to both the data structures in its `global` table or to the game state through {@link LuaGameScript | LuaGameScript}.
+     * Register a function to be run when mod configuration changes. This is called when the major game version or any mod version changed, when any mod was added or removed, when a startup setting has changed, or when any prototypes have been added or removed. It allows the mod to make any changes it deems appropriate to both the data structures in its {@link global | global} table or to the game state through {@link LuaGameScript | LuaGameScript}.
+     * @remarks
+     * For more context, refer to the {@link Data Lifecycle | data-lifecycle} page.
+     *
      * @param f - The handler for this event. Passing `nil` will unregister it.
      */
     on_configuration_changed(this: void,
@@ -282,7 +285,10 @@ interface LuaBootstrap {
         filters?: EventFilter[]): void
 
     /**
-     * Register a callback to be run on mod initialization. This is only called when a new save game is created or when a save file is loaded that previously didn't contain the mod. During it, the mod gets the chance to set up initial values that it will use for its lifetime. It has full access to {@link LuaGameScript | LuaGameScript} and the `global` table and can change anything about them that it deems appropriate. No other events will be raised for the mod until it has finished this step.
+     * Register a function to be run on mod initialization. This is only called when a new save game is created or when a save file is loaded that previously didn't contain the mod. During it, the mod gets the chance to set up initial values that it will use for its lifetime. It has full access to {@link LuaGameScript | LuaGameScript} and the {@link global | global} table and can change anything about them that it deems appropriate. No other events will be raised for the mod until it has finished this step.
+     * @remarks
+     * For more context, refer to the {@link Data Lifecycle | data-lifecycle} page.
+     *
      * @param f - The handler for this event. Passing `nil` will unregister it.
      * @example
      * Initialize a `players` table in `global` for later use. 
@@ -297,14 +303,17 @@ interface LuaBootstrap {
         f: (this: void) => any): void
 
     /**
-     * Register a function to be run on save load. This is only called for mods that have been part of the save previously, or for players connecting to a running multiplayer session. It gives the mod the opportunity to do some very specific actions, should it need to. Doing anything other than these three will lead to desyncs, which breaks multiplayer and replay functionality. Access to {@link LuaGameScript | LuaGameScript} and {@link LuaRendering | LuaRendering} is not available. The `global` table can be accessed and is safe to read from, but not write to.
+     * Register a function to be run on save load. This is only called for mods that have been part of the save previously, or for players connecting to a running multiplayer session. It gives the mod the opportunity to do some very specific actions, should it need to. Doing anything other than these three will lead to desyncs, which breaks multiplayer and replay functionality. Access to {@link LuaGameScript | LuaGameScript} is not available. The {@link global | global} table can be accessed and is safe to read from, but not write to, as doing so will lead to an error.
      * 
-     * The only legitimate uses of this event are these three:
-     * - Re-setup {@link metatables | https://www.lua.org/pil/13.html} as they are not persisted through save-load.
-     * - Re-setup conditional event handlers.
-     * - Create local references to data stored in the {@link global | Global.html} table.
+     * The only legitimate uses of this event are the following:
+     * - Re-setup {@link metatables | https://www.lua.org/pil/13.html} as they are not persisted through the save/load cycle.
+     * - Re-setup conditional event handlers, meaning subscribing to an event only when some condition is met to save processing time.
+     * - Create local references to data stored in the {@link global | global} table.
      * 
-     * For all other purposes, {@link LuaBootstrap::on_init | LuaBootstrap::on_init}, {@link LuaBootstrap::on_configuration_changed | LuaBootstrap::on_configuration_changed} or migration scripts should be used instead.
+     * For all other purposes, {@link LuaBootstrap::on_init | LuaBootstrap::on_init}, {@link LuaBootstrap::on_configuration_changed | LuaBootstrap::on_configuration_changed} or {@link migrations | migrations} should be used instead.
+     * @remarks
+     * For more context, refer to the {@link Data Lifecycle | data-lifecycle} page.
+     *
      * @param f - The handler for this event. Passing `nil` will unregister it.
      */
     on_load(this: void,
@@ -819,12 +828,12 @@ interface LuaConstantCombinatorControlBehavior extends LuaControlBehavior {
     readonly object_name: string
 
     /**
-     * The constant combinator parameters
+     * This constant combinator's parameters, or `nil` if the {@link item_slot_count | LuaEntityPrototype::item_slot_count} of the combinator's prototype is `0`.
      * @remarks
-     * Setting to `nil` clears the parameters.
+     * Writing `nil` clears the combinator's parameters.
      *
      */
-    parameters: ConstantCombinatorParameters[]
+    parameters?: ConstantCombinatorParameters[]
 
     /**
      * The number of signals this constant combinator supports
@@ -977,7 +986,7 @@ interface LuaControl {
     get_main_inventory(this: void): void
 
     /**
-     * Gets the parameters of a personal logistic request and auto-trash slot.
+     * Gets the parameters of a personal logistic request and auto-trash slot. Only used on `spider-vehicle`.
      * @param slot_index - The slot to get.
      */
     get_personal_logistic_slot(this: void,
@@ -1073,7 +1082,7 @@ interface LuaControl {
         value: LogisticParameters): void
 
     /**
-     * Sets a vehicle logistic request and auto-trash slot to the given value. Only used on `spider-vehicule`s.
+     * Sets a vehicle logistic request and auto-trash slot to the given value. Only used on `spider-vehicle`.
      * @param slot_index - The slot to set.
      * @param value - The logistic request parameters.
      */
@@ -1498,22 +1507,22 @@ interface LuaCustomInputPrototype {
     readonly consuming: string
 
     /**
-     * If this custom input is enabled. Disabled custom inputs exist but are not used by the game.
+     * Whether this custom input is enabled. Disabled custom inputs exist but are not used by the game.
      */
     readonly enabled: boolean
 
     /**
-     * If this custom input is enabled while using the cutscene controller.
+     * Whether this custom input is enabled while using the cutscene controller.
      */
     readonly enabled_while_in_cutscene: boolean
 
     /**
-     * If this custom input is enabled while using the spectator controller.
+     * Whether this custom input is enabled while using the spectator controller.
      */
     readonly enabled_while_spectating: boolean
 
     /**
-     * If this custom input will include the selected prototype (if any) when triggered.
+     * Whether this custom input will include the selected prototype (if any) when triggered.
      */
     readonly include_selected_prototype: boolean
 
@@ -1547,7 +1556,7 @@ interface LuaCustomInputPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -1647,7 +1656,7 @@ interface LuaDamagePrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -1673,9 +1682,9 @@ interface LuaDeciderCombinatorControlBehavior extends LuaCombinatorControlBehavi
     readonly object_name: string
 
     /**
-     * The decider combinator parameters
+     * This decider combinator's parameters.
      * @remarks
-     * Setting to `nil` clears the parameters.
+     * Writing `nil` clears the combinator's parameters.
      *
      */
     parameters: DeciderCombinatorParameters
@@ -1728,7 +1737,7 @@ interface LuaDecorativePrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -2199,7 +2208,7 @@ interface LuaEntity extends LuaControl {
     get_or_create_control_behavior(this: void): void
 
     /**
-     * Gets the entities output inventory if it has one.
+     * Gets the entity's output inventory if it has one.
      */
     get_output_inventory(this: void): void
 
@@ -2375,12 +2384,12 @@ interface LuaEntity extends LuaControl {
     is_closing(this: void): void
 
     /**
-     * Returns true if this entity is connected to an electric network.
+     * Returns `true` if this entity produces or consumes electricity and is connected to an electric network that has at least one entity that can produce power.
      */
     is_connected_to_electric_network(this: void): void
 
     /**
-     * Returns whether a craft is currently in process. It does not indicate whether progress is currently being made, but whether any crafting action has made progress in this machine.
+     * Returns whether a craft is currently in process. It does not indicate whether progress is currently being made, but whether a crafting process has been started in this machine.
      * @remarks
      * Applies to subclasses: CraftingMachine
      *
@@ -2788,14 +2797,17 @@ interface LuaEntity extends LuaControl {
     readonly armed: boolean
 
     /**
-     * The player this character is associated with or `nil` if none. When the player logs off in multiplayer all of the associated characters will be logged off with him.
+     * The player this character is associated with, or `nil` if there isn't one. Set to `nil` to clear.
+     * 
+     * The player will be automatically disassociated when a controller is set on the character. Also, all characters associated to a player will be logged off when the player logs off in multiplayer.
+     * 
+     * Reading this property will return a {@link LuaPlayer | LuaPlayer}, while {@link PlayerIdentification | PlayerIdentification} can be used when writing.
      * @remarks
      * A character associated with a player is not directly controlled by any player.
-     * Set to `nil` to clear. The player will be automatically disassociated when a controller is set on the character.
      * Applies to subclasses: Character
      *
      */
-    associated_player?: LuaPlayer
+    associated_player?: LuaPlayer | PlayerIdentification
 
     /**
      * Whether this rocket silo automatically launches the rocket when cargo is inserted.
@@ -3349,12 +3361,14 @@ interface LuaEntity extends LuaControl {
     kills: number
 
     /**
-     * The last player that changed any setting on this entity. This includes building the entity, changing its color, or configuring its circuit network. Can be `nil` if the last user is not part of the save anymore. Mods can overwrite it if desired.
+     * The last player that changed any setting on this entity. This includes building the entity, changing its color, or configuring its circuit network. Can be `nil` if the last user is not part of the save anymore.
+     * 
+     * Reading this property will return a {@link LuaPlayer | LuaPlayer}, while {@link PlayerIdentification | PlayerIdentification} can be used when writing.
      * @remarks
      * Applies to subclasses: EntityWithOwner
      *
      */
-    last_user: LuaPlayer
+    last_user: LuaPlayer | PlayerIdentification
 
     /**
      * The link ID this linked container is using.
@@ -3582,6 +3596,14 @@ interface LuaEntity extends LuaControl {
      */
     readonly pump_rail_target?: LuaEntity
 
+    /**
+     * The current radar scan progress, as a number in range [0, 1].
+     * @remarks
+     * Applies to subclasses: Radar
+     *
+     */
+    readonly radar_scan_progress: number
+
     /**
      * When locked; the recipe in this assembling machine can't be changed by the player.
      * @remarks
@@ -3608,8 +3630,10 @@ interface LuaEntity extends LuaControl {
 
     /**
      * The player that this `simple-entity-with-owner`, `simple-entity-with-force`, `flying-text`, or `highlight-box` is visible to. `nil` means it is rendered for every player.
+     * 
+     * Reading this property will return a {@link LuaPlayer | LuaPlayer}, while {@link PlayerIdentification | PlayerIdentification} can be used when writing.
      */
-    render_player: LuaPlayer
+    render_player: LuaPlayer | PlayerIdentification
 
     /**
      * The forces that this `simple-entity-with-owner`, `simple-entity-with-force`, or `flying-text` is visible to. `nil` or an empty array means it is rendered for every force.
@@ -3649,12 +3673,12 @@ interface LuaEntity extends LuaControl {
     rotatable: boolean
 
     /**
-     * The secondary bounding box of this entity or `nil` if it doesn't have one.
+     * The secondary bounding box of this entity or `nil` if it doesn't have one. This only exists for curved rails, and is automatically determined by the game.
      */
     readonly secondary_bounding_box?: BoundingBox
 
     /**
-     * The secondary selection box of this entity or `nil` if it doesn't have one.
+     * The secondary selection box of this entity or `nil` if it doesn't have one. This only exists for curved rails, and is automatically determined by the game.
      */
     readonly secondary_selection_box?: BoundingBox
 
@@ -4051,6 +4075,11 @@ interface LuaEntityPrototype {
      */
     readonly always_on?: boolean
 
+    /**
+     * Gets the animation speed coefficient of this belt . `nil` if this is not transport belt connectable.
+     */
+    readonly animation_speed_coefficient: number
+
     /**
      * The attack parameters for this entity or `nil` if the entity doesn't use attack parameters.
      */
@@ -4066,6 +4095,11 @@ interface LuaEntityPrototype {
      */
     readonly automated_ammo_count?: number
 
+    /**
+     * Does this prototoype automaticly cycle weapons. `nil` if this is not a spider vechicle.
+     */
+    readonly automatic_weapon_cycling: boolean
+
     /**
      * Autoplace specification for this entity prototype. `nil` if none.
      */
@@ -4122,6 +4156,11 @@ interface LuaEntityPrototype {
      */
     readonly burner_prototype?: LuaBurnerPrototype
 
+    /**
+     * If this generator prototype burns fluid.
+     */
+    readonly burns_fluid: boolean
+
     readonly call_for_help_radius: number
 
     /**
@@ -4137,6 +4176,11 @@ interface LuaEntityPrototype {
      */
     readonly center_collision_mask: CollisionMask
 
+    /**
+     * Gets the chain shooting cooldown modifier of this prototype. `nil` if this is not a spider vechicle.
+     */
+    readonly chain_shooting_cooldown_modifier: number
+
     /**
      * @remarks
      * Applies to subclasses: Character
@@ -4144,6 +4188,11 @@ interface LuaEntityPrototype {
      */
     readonly character_corpse: LuaEntityPrototype
 
+    /**
+     * Gets the chunk exploration radius of this prototype. `nil` if this is not a spider vechicle.
+     */
+    readonly chunk_exploration_radius: number
+
     /**
      * The item prototype name used to destroy this cliff or `nil`.
      */
@@ -4261,6 +4310,11 @@ interface LuaEntityPrototype {
      */
     readonly default_collision_mask_with_flags: CollisionMaskWithFlags
 
+    /**
+     * If this generator prototype destroys non fuel fluids.
+     */
+    readonly destroy_non_fuel_fluid: boolean
+
     /**
      * The distraction cooldown of this unit prototype or `nil`.
      */
@@ -4293,6 +4347,14 @@ interface LuaEntityPrototype {
      */
     readonly drop_item_distance: number
 
+    /**
+     * The dying time of this corpse prototype. `nil` if not a corpse prototype.
+     * @remarks
+     * Applies to subclasses: Corpse
+     *
+     */
+    readonly dying_speed: number
+
     /**
      * The effectivity of this car prototype, generator prototype or `nil`.
      */
@@ -4453,11 +4515,21 @@ interface LuaEntityPrototype {
      */
     readonly healing_per_tick: number
 
+    /**
+     * The heat buffer prototype this entity uses or `nil`.
+     */
+    readonly heat_buffer_prototype?: LuaHeatBufferPrototype
+
     /**
      * The heat energy source prototype this entity uses or `nil`.
      */
     readonly heat_energy_source_prototype?: LuaHeatEnergySourcePrototype
 
+    /**
+     * Gets the height of this prototype. `nil` if this is not a spider vechicle.
+     */
+    readonly height: number
+
     /**
      * Every time this infinite resource 'ticks' down it is reduced by this amount. `nil` when not a resource. Meaningless if this isn't an infinite type resource.
      */
@@ -4564,6 +4636,14 @@ interface LuaEntityPrototype {
      */
     readonly logistic_mode?: string
 
+    /**
+     * The logistic parameters for this roboport. or `nil`.
+     * @remarks
+     * Both the `charging_station_shift` and `stationing_offset` vectors are tables with `x` and `y` keys instead of an array.
+     *
+     */
+    readonly logistic_parameters?: { charge_approach_distance: number, charging_distance: number, charging_energy: number, charging_station_count: number, charging_station_shift: Vector, charging_threshold_distance: number, construction_radius: number, logistic_radius: number, logistics_connection_distance: number, robot_limit: number, robot_vertical_acceleration: number, robots_shrink_when_entering_and_exiting: boolean, spawn_and_station_height: number, spawn_and_station_shadow_height_offset: number, stationing_offset: Vector }
+
     /**
      * The logistic radius for this roboport prototype or `nil`.
      */
@@ -4581,6 +4661,13 @@ interface LuaEntityPrototype {
      */
     readonly loot_pickup_distance: number
 
+    /**
+     * Get the manual range modifier for artillery turret and artillery wagon prototypes. `nil` if not artillery type prototype
+     * 
+     * subclass(ArtilleryWagon, ArtilleryTurret)
+     */
+    readonly manual_range_modifier: number
+
     /**
      * The map color used when charting this entity if a friendly or enemy color isn't defined or `nil`.
      */
@@ -4651,6 +4738,11 @@ interface LuaEntityPrototype {
      */
     readonly max_polyphony?: number
 
+    /**
+     * The default maximum power output of this generator prototype or `nil`.
+     */
+    readonly max_power_output?: number
+
     /**
      * The maximum pursue distance of this unit prototype or `nil`.
      */
@@ -4761,7 +4853,7 @@ interface LuaEntityPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -4894,6 +4986,11 @@ interface LuaEntityPrototype {
      */
     readonly running_speed: number
 
+    /**
+     * If this generator prototype scales fluid usage.
+     */
+    readonly scale_fluid_usage: boolean
+
     /**
      * The secondary bounding box used for collision checking, or `nil` if it doesn't have one. This is only used in rails and rail remnants.
      */
@@ -5023,6 +5120,11 @@ interface LuaEntityPrototype {
      */
     readonly timeout: number
 
+    /**
+     * Gets the torso rotation speed of this prototype. `nil` if this is not a spider vechicle.
+     */
+    readonly torso_rotation_speed: number
+
     /**
      * If it is a tree, return the number of colors it supports. `nil` otherwise.
      */
@@ -5182,7 +5284,7 @@ interface LuaEquipmentCategoryPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -5376,7 +5478,7 @@ interface LuaEquipmentGridPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -5475,7 +5577,7 @@ interface LuaEquipmentPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -5511,7 +5613,7 @@ interface LuaEquipmentPrototype {
  * 
  * Examples:
  * - The item production GUI shows "consumption" on the right, thus `output` describes the item consumption numbers. The same goes for fluid consumption.
- * - The kills gui shows "losses" on the right, so `output` describes how many of the force's entities were killed by enemies.
+ * - The kills GUI shows "losses" on the right, so `output` describes how many of the force's entities were killed by enemies.
  * - The electric network GUI shows "power consumption" on the left side, so in this case `input` describes the power consumption numbers.
  */
 interface LuaFlowStatistics {
@@ -5521,17 +5623,23 @@ interface LuaFlowStatistics {
     clear(this: void): void
 
     /**
-     * Gets the flow count value for the given time frame.
-     * @param table.count - If true, the count is returned instead of the per-time-frame value.
+     * Gets the flow count value for the given time frame. If `sample_index` is not provided, then the value returned is the average across the provided precision time period. These are the values shown in the bottom section of the statistics GUIs.
+     * 
+     * Use `sample_index` to access the data used to generate the statistics graphs. Each precision level contains 300 samples of data so at a precision of 1 minute, each sample contains data averaged across 60s / 300 = 0.2s = 12 ticks.
+     * 
+     * All return values are normalized to be per-tick for electric networks and per-minute for all other types.
+     * @param table.count - If true, the count of items/fluids/entities is returned instead of the per-time-frame value.
      * @param table.input - Read the input values or the output values
      * @param table.name - The prototype name.
-     * @param table.precision_index - The precision to read.
+     * @param table.precision_index - The precision range to read.
+     * @param table.sample_index - The sample index to read from within the precision range. If not provided, the entire precision range is read. Must be between 1 and 300 where 1 is the most recent sample and 300 is the oldest.
      */
     get_flow_count(this: void,
         table: {
             name: string,
             input: boolean,
             precision_index: defines.flow_precision_index,
+            sample_index?: number,
             count?: boolean
         }): void
 
@@ -5639,7 +5747,7 @@ interface LuaFluidBox {
         index: number): void
 
     /**
-     * The fluidbox connections for the given fluidbox index.
+     * The fluidboxes to which the fluidbox at the given index is connected.
      */
     get_connections(this: void,
         index: number): void
@@ -5916,7 +6024,7 @@ interface LuaFluidPrototype {
     readonly object_name: string
 
     /**
-     * Order string for this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -6664,7 +6772,7 @@ interface LuaFuelCategoryPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -7026,10 +7134,7 @@ interface LuaGameScript {
         sound_path: SoundPath): void
 
     /**
-     * Checks if the given SpritePath is valid and contains a loaded sprite.
-     * @remarks
-     * The existence of the image is not checked for paths of type `file`.
-     *
+     * Checks if the given SpritePath is valid and contains a loaded sprite. The existence of the image is not checked for paths of type `file`.
      * @param sprite_path - Path to the image.
      */
     is_valid_sprite_path(this: void,
@@ -7145,8 +7250,8 @@ interface LuaGameScript {
         players?: Array<LuaPlayer | string>): void
 
     /**
-     * Remove file or directory. Given path is taken relative to the script output directory. Can be used to remove files created by {@link LuaGameScript::write_file | LuaGameScript::write_file}.
-     * @param path - Path to remove, relative to the script output directory
+     * Remove a file or directory in the `script-output` folder, located in the game's {@link user data directory | https://wiki.factorio.com/User_data_directory}. Can be used to remove files created by {@link LuaGameScript::write_file | LuaGameScript::write_file}.
+     * @param path - The path to the file or directory to remove, relative to `script-output`.
      */
     remove_path(this: void,
         path: string): void
@@ -7220,7 +7325,7 @@ interface LuaGameScript {
         data: Table): void
 
     /**
-     * Take a screenshot and save it to a file. The filename should include a file extension indicating the desired image format. Supports `.png`, `.jpg` / `.jpeg`, `.tga` and `.bmp`.
+     * Take a screenshot of the game and save it to the `script-output` folder, located in the game's {@link user data directory | https://wiki.factorio.com/User_data_directory}. The name of the image file can be specified via the `path` parameter.
      * @remarks
      * If Factorio is running headless, this function will do nothing.
      *
@@ -7229,7 +7334,7 @@ interface LuaGameScript {
      * @param table.by_player - If defined, the screenshot will only be taken for this player.
      * @param table.daytime - Overrides the current surface daytime for the duration of screenshot rendering.
      * @param table.force_render - Screenshot requests are processed in between game update and render. The game may skip rendering (ie. drop frames) if the previous frame has not finished rendering or the game simulation starts to fall below 60 updates per second. If `force_render` is set to `true`, the game won't drop frames and process the screenshot request at the end of the update in which the request was created. This is not honored on multiplayer clients that are catching up to server. Defaults to `false`.
-     * @param table.path - The sub-path in `"script-output"` to save the screenshot to. Defaults to `"screenshot.png"`.
+     * @param table.path - The name of the image file. It should include a file extension indicating the desired format. Supports `.png`, `.jpg` /`.jpeg`, `.tga` and `.bmp`. Providing a directory path (ex. `"save/here/screenshot.png"`) will create the necessary folder structure in `script-output`. Defaults to `"screenshot.png"`.
      * @param table.player - The player to focus on. Defaults to the local player.
      * @param table.position - If defined, the screenshot will be centered on this position. Otherwise, the screenshot will center on `player`.
      * @param table.quality - The `.jpg` render quality as a percentage (from 0% to 100% inclusive), if used. A lower value means a more compressed image. Defaults to `80`.
@@ -7262,10 +7367,10 @@ interface LuaGameScript {
         }): void
 
     /**
-     * Take a screenshot of the technology screen and save it to a file. The filename should include a file extension indicating the desired image format. Supports `.png`, `.jpg` / `.jpeg`, `.tga` and `.bmp`.
+     * Take a screenshot of the technology screen and save it to the `script-output` folder, located in the game's {@link user data directory | https://wiki.factorio.com/User_data_directory}. The name of the image file can be specified via the `path` parameter.
      * @param table.by_player - If given, the screenshot will only be taken for this player.
      * @param table.force - The force whose technology to screenshot. If not given, the `"player`" force is used.
-     * @param table.path - The sub-path in `"script-output"` to save the screenshot to. Defaults to `"technology-screenshot.png"`.
+     * @param table.path - The name of the image file. It should include a file extension indicating the desired format. Supports `.png`, `.jpg` /`.jpeg`, `.tga` and `.bmp`. Providing a directory path (ex. `"save/here/screenshot.png"`) will create the necessary folder structure in `script-output`. Defaults to `"technology-screenshot.png"`.
      * @param table.quality - The `.jpg` render quality as a percentage (from 0% to 100% inclusive), if used. A lower value means a more compressed image. Defaults to `80`.
      * @param table.selected_technology - The technology to highlight.
      * @param table.skip_disabled - If `true`, disabled technologies will be skipped. Their successors will be attached to the disabled technology's parents. Defaults to `false`.
@@ -7295,11 +7400,11 @@ interface LuaGameScript {
         player: PlayerIdentification): void
 
     /**
-     * Write a string to a file.
-     * @param append - When `true`, this will append to the end of the file. Defaults to `false`, which will overwrite any pre-existing file with the new data.
-     * @param data - File content
-     * @param filename - Path to the file to write to.
-     * @param for_player - If given, the file will only be written for this player_index. 0 means only the server if one exists.
+     * Write a file to the `script-output` folder, located in the game's {@link user data directory | https://wiki.factorio.com/User_data_directory}. The name and file extension of the file can be specified via the `filename` parameter.
+     * @param append - If `true`, `data` will be appended to the end of the file. Defaults to `false`, which will overwrite any pre-existing file with the new `data`.
+     * @param data - The content to write to the file.
+     * @param filename - The name of the file. Providing a directory path (ex. `"save/here/example.txt"`) will create the necessary folder structure in `script-output`.
+     * @param for_player - If given, the file will only be written for this `player_index`. Providing `0` will only write to the server's output if present.
      */
     write_file(this: void,
         filename: string,
@@ -7533,7 +7638,9 @@ interface LuaGameScript {
     readonly permissions: LuaPermissionGroups
 
     /**
-     * The player typing at the console - `nil` in all other instances. See {@link LuaGameScript::players | LuaGameScript::players} for accessing all players.
+     * This property is only populated inside {@link custom command | LuaCommandProcessor} handlers and when writing {@link Lua console commands | https://wiki.factorio.com/Console#Scripting_and_cheat_commands}. Returns the player that is typing the command, `nil` in all other instances.
+     * 
+     * See {@link LuaGameScript::players | LuaGameScript::players} for accessing all players.
      */
     readonly player: LuaPlayer
 
@@ -7720,6 +7827,9 @@ interface LuaGroup {
      */
     readonly object_name: string
 
+    /**
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
+     */
     readonly order: string
 
     /**
@@ -7761,6 +7871,8 @@ interface LuaGui {
 
     /**
      * Returns `true` if sprite_path is valid and contains loaded sprite, otherwise `false`. Sprite path of type `file` doesn't validate if file exists.
+     * 
+     * If you want to avoid needing a LuaGui object, {@link LuaGameScript::is_valid_sprite_path | LuaGameScript::is_valid_sprite_path} can be used instead.
      * @param sprite_path - Path to a image.
      */
     is_valid_sprite_path(this: void,
@@ -8293,20 +8405,7 @@ interface LuaGuiElement {
     draw_vertical_lines: boolean
 
     /**
-     * The elem filters of this choose-elem-button or `nil` if there are no filters.
-     * 
-     * The compatible type of filter is determined by elem_type:
-     * - Type `"item"` - {@link ItemPrototypeFilter | ItemPrototypeFilter}
-     * - Type `"tile"` - {@link TilePrototypeFilter | TilePrototypeFilter}
-     * - Type `"entity"` - {@link EntityPrototypeFilter | EntityPrototypeFilter}
-     * - Type `"signal"` - Does not support filters
-     * - Type `"fluid"` - {@link FluidPrototypeFilter | FluidPrototypeFilter}
-     * - Type `"recipe"` - {@link RecipePrototypeFilter | RecipePrototypeFilter}
-     * - Type `"decorative"` - {@link DecorativePrototypeFilter | DecorativePrototypeFilter}
-     * - Type `"item-group"` - Does not support filters
-     * - Type `"achievement"` - {@link AchievementPrototypeFilter | AchievementPrototypeFilter}
-     * - Type `"equipment"` - {@link EquipmentPrototypeFilter | EquipmentPrototypeFilter}
-     * - Type `"technology"` - {@link TechnologyPrototypeFilter | TechnologyPrototypeFilter}
+     * The elem filters of this choose-elem-button, or `nil` if there are no filters. The compatible type of filter is determined by `elem_type`.
      * @remarks
      * Writing to this field does not change or clear the currently selected element.
      * Applies to subclasses: choose-elem-button
@@ -8459,7 +8558,7 @@ interface LuaGuiElement {
     mouse_button_filter: MouseButtonFlags
 
     /**
-     * The name of this element.
+     * The name of this element. `""` if no name was set.
      * @example
      * ```
      * game.player.gui.top.greeting.name == "greeting"
@@ -8664,7 +8763,7 @@ interface LuaGuiElement {
     word_wrap: boolean
 
     /**
-     * The zoom this camera or minimap is using.
+     * The zoom this camera or minimap is using. This value must be positive.
      */
     zoom: number
 
@@ -8678,6 +8777,43 @@ interface LuaGuiElement {
 
 }
 
+/**
+ * Prototype of a heat buffer.
+ */
+interface LuaHeatBufferPrototype {
+    /**
+     * All methods and properties that this object supports.
+     */
+    help(this: void): void
+
+    readonly connections: HeatConnection[]
+
+    readonly default_temperature: number
+
+    readonly max_temperature: number
+
+    readonly max_transfer: number
+
+    readonly min_temperature_gradient: number
+
+    readonly min_working_temperature: number
+
+    readonly minimum_glow_temperature: number
+
+    /**
+     * The class name of this object. Available even when `valid` is false. For LuaStruct objects it may also be suffixed with a dotted path to a member of the struct.
+     */
+    readonly object_name: string
+
+    readonly specific_heat: number
+
+    /**
+     * Is this object valid? This Lua object holds a reference to an object within the game engine. It is possible that the game-engine object is removed whilst a mod still holds the corresponding Lua object. If that happens, the object becomes invalid, i.e. this attribute will be `false`. Mods are advised to check for object validity if any change to the game state might have occurred between the creation of the Lua object and its access.
+     */
+    readonly valid: boolean
+
+}
+
 /**
  * Prototype of a heat energy source.
  */
@@ -8693,6 +8829,8 @@ interface LuaHeatEnergySourcePrototype {
 
     readonly emissions: number
 
+    readonly heat_buffer_prototype: LuaHeatBufferPrototype
+
     readonly max_temperature: number
 
     readonly max_transfer: number
@@ -9359,7 +9497,7 @@ interface LuaItemPrototype {
     readonly mapper_count: number
 
     /**
-     * Effects of this module; `nil` if this is not a module.
+     * Effects of this module.
      * @remarks
      * Applies to subclasses: ModuleItem
      *
@@ -9377,7 +9515,7 @@ interface LuaItemPrototype {
     readonly object_name: string
 
     /**
-     * Order string.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -9414,6 +9552,70 @@ interface LuaItemPrototype {
      */
     readonly resistances: {[key: string]: Resistance}
 
+    /**
+     * The reverse entity filter mode used by this selection tool.
+     * @remarks
+     * Applies to subclasses: SelectionTool
+     *
+     */
+    readonly reverse_alt_entity_filter_mode: string
+
+    /**
+     * The reverse entity filters used by this selection tool indexed by entity name.
+     * @remarks
+     * Applies to subclasses: SelectionTool
+     *
+     */
+    readonly reverse_entity_filters: {[key: string]: LuaEntityPrototype}
+
+    /**
+     * The reverse entity type filters used by this selection tool indexed by entity type.
+     * @remarks
+     * The boolean value is meaningless and is used to allow easy lookup if a type exists in the dictionary.
+     * Applies to subclasses: SelectionTool
+     *
+     */
+    readonly reverse_entity_type_filters: {[key: string]: boolean}
+
+    /**
+     * The color used when doing reverse selection with this selection tool prototype.
+     * @remarks
+     * Applies to subclasses: SelectionTool
+     *
+     */
+    readonly reverse_selection_border_color: Color
+
+    /**
+     * @remarks
+     * Applies to subclasses: SelectionTool
+     *
+     */
+    readonly reverse_selection_cursor_box_type: string
+
+    /**
+     * Flags that affect which entities will be selected during reverse selection.
+     * @remarks
+     * Applies to subclasses: SelectionTool
+     *
+     */
+    readonly reverse_selection_mode_flags: SelectionModeFlags
+
+    /**
+     * The reverse tile filter mode used by this selection tool.
+     * @remarks
+     * Applies to subclasses: SelectionTool
+     *
+     */
+    readonly reverse_tile_filter_mode: string
+
+    /**
+     * The reverse tile filters used by this selection tool indexed by tile name.
+     * @remarks
+     * Applies to subclasses: SelectionTool
+     *
+     */
+    readonly reverse_tile_filters: {[key: string]: LuaTilePrototype}
+
     /**
      * The results from launching this item in a rocket.
      */
@@ -9889,7 +10091,7 @@ interface LuaItemStack {
 
     /**
      * Set this item stack to another item stack.
-     * @param stack - Item stack to set this one to. Omitting this parameter or passing `nil` will clear this item stack, as if by calling [LuaItemStack::clear](LuaItemStack::clear).
+     * @param stack - Item stack to set it to. Omitting this parameter or passing `nil` will clear this item stack, as if [LuaItemStack::clear](LuaItemStack::clear) was called.
      */
     set_stack(this: void,
         stack?: ItemStackIdentification): void
@@ -10812,7 +11014,7 @@ interface LuaModSettingPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -10849,7 +11051,7 @@ interface LuaModuleCategoryPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -10894,7 +11096,7 @@ interface LuaNamedNoiseExpression {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -10929,7 +11131,7 @@ interface LuaNoiseLayerPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -10974,7 +11176,7 @@ interface LuaParticlePrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -11737,7 +11939,7 @@ interface LuaPlayer extends LuaControl {
     hand_location: ItemStackLocation
 
     /**
-     * This player's index in {@link LuaGameScript::players | LuaGameScript::players}.
+     * This player's unique index in {@link LuaGameScript::players | LuaGameScript::players}. It is given to them when they are {@link created | on_player_created} and remains assigned to them until they are {@link removed | on_player_removed}.
      */
     readonly index: number
 
@@ -12196,7 +12398,7 @@ interface LuaRecipe {
     readonly object_name: string
 
     /**
-     * Order string. This is used to sort the crafting menu.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -12246,7 +12448,7 @@ interface LuaRecipeCategoryPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -12364,7 +12566,7 @@ interface LuaRecipePrototype {
     readonly object_name: string
 
     /**
-     * Order string. This is used to sort the crafting menu.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -12500,13 +12702,13 @@ interface LuaRendering {
      * @param table.animation - Name of an [animation prototype](https://wiki.factorio.com/Prototype/Animation).
      * @param table.animation_offset - Offset of the animation in frames. Default is 0.
      * @param table.animation_speed - How many frames the animation goes forward per tick. Default is 1.
-     * @param table.forces - The forces that this object is rendered to.
+     * @param table.forces - The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      * @param table.only_in_alt_mode - If this should only be rendered in alt mode. Defaults to false.
      * @param table.orientation - The orientation of the animation. Default is 0.
      * @param table.orientation_target - If given, the animation rotates so that it faces this target. Note that `orientation` is still applied to the animation.
      * @param table.orientation_target_offset - Only used if `orientation_target` is a LuaEntity.
      * @param table.oriented_offset - Offsets the center of the animation if `orientation_target` is given. This offset will rotate together with the animation.
-     * @param table.players - The players that this object is rendered to.
+     * @param table.players - The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      * @param table.target - Center of the animation.
      * @param table.target_offset - Only used if `target` is a LuaEntity.
      * @param table.time_to_live - In ticks. Defaults to living forever.
@@ -12541,11 +12743,11 @@ interface LuaRendering {
      * Create an arc.
      * @param table.angle - The angle of the arc, in radian.
      * @param table.draw_on_ground - If this should be drawn below sprites and entities.
-     * @param table.forces - The forces that this object is rendered to.
+     * @param table.forces - The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      * @param table.max_radius - The radius of the outer edge of the arc, in tiles.
      * @param table.min_radius - The radius of the inner edge of the arc, in tiles.
      * @param table.only_in_alt_mode - If this should only be rendered in alt mode. Defaults to false.
-     * @param table.players - The players that this object is rendered to.
+     * @param table.players - The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      * @param table.start_angle - Where the arc starts, in radian.
      * @param table.target_offset - Only used if `target` is a LuaEntity.
      * @param table.time_to_live - In ticks. Defaults to living forever.
@@ -12573,9 +12775,9 @@ interface LuaRendering {
      * Create a circle.
      * @param table.draw_on_ground - If this should be drawn below sprites and entities.
      * @param table.filled - If the circle should be filled.
-     * @param table.forces - The forces that this object is rendered to.
+     * @param table.forces - The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      * @param table.only_in_alt_mode - If this should only be rendered in alt mode. Defaults to false.
-     * @param table.players - The players that this object is rendered to.
+     * @param table.players - The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      * @param table.radius - In tiles.
      * @param table.target_offset - Only used if `target` is a LuaEntity.
      * @param table.time_to_live - In ticks. Defaults to living forever.
@@ -12605,13 +12807,13 @@ interface LuaRendering {
      * The base game uses the utility sprites `light_medium` and `light_small` for lights.
      *
      * @param table.color - Defaults to white (no tint).
-     * @param table.forces - The forces that this object is rendered to.
+     * @param table.forces - The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      * @param table.intensity - Default is 1.
      * @param table.minimum_darkness - The minimum darkness at which this light is rendered. Default is 0.
      * @param table.only_in_alt_mode - If this should only be rendered in alt mode. Defaults to false.
      * @param table.orientation - The orientation of the light. Default is 0.
      * @param table.oriented - If this light has the same orientation as the entity target, default is false. Note that `orientation` is still applied to the sprite.
-     * @param table.players - The players that this object is rendered to.
+     * @param table.players - The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      * @param table.scale - Default is 1.
      * @param table.target - Center of the light.
      * @param table.target_offset - Only used if `target` is a LuaEntity.
@@ -12641,11 +12843,11 @@ interface LuaRendering {
      * Create a line.
      * @param table.dash_length - Length of the dashes that this line has. Used only if gap_length > 0. Default is 0.
      * @param table.draw_on_ground - If this should be drawn below sprites and entities.
-     * @param table.forces - The forces that this object is rendered to.
+     * @param table.forces - The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      * @param table.from_offset - Only used if `from` is a LuaEntity.
      * @param table.gap_length - Length of the gaps that this line has, in tiles. Default is 0.
      * @param table.only_in_alt_mode - If this should only be rendered in alt mode. Defaults to false.
-     * @param table.players - The players that this object is rendered to.
+     * @param table.players - The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      * @param table.time_to_live - In ticks. Defaults to living forever.
      * @param table.to_offset - Only used if `to` is a LuaEntity.
      * @param table.visible - If this is rendered to anyone at all. Defaults to true.
@@ -12685,12 +12887,12 @@ interface LuaRendering {
     /**
      * Create a triangle mesh defined by a triangle strip.
      * @param table.draw_on_ground - If this should be drawn below sprites and entities.
-     * @param table.forces - The forces that this object is rendered to.
+     * @param table.forces - The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      * @param table.only_in_alt_mode - If this should only be rendered in alt mode. Defaults to false.
      * @param table.orientation - The orientation applied to all vertices. Default is 0.
      * @param table.orientation_target - If given, the vertices (that are not set to an entity) rotate so that it faces this target. Note that `orientation` is still applied.
      * @param table.orientation_target_offset - Only used if `orientation_target` is a LuaEntity.
-     * @param table.players - The players that this object is rendered to.
+     * @param table.players - The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      * @param table.target - Acts like an offset applied to all vertices that are not set to an entity.
      * @param table.target_offset - Only used if `target` is a LuaEntity.
      * @param table.time_to_live - In ticks. Defaults to living forever.
@@ -12718,10 +12920,10 @@ interface LuaRendering {
      * Create a rectangle.
      * @param table.draw_on_ground - If this should be drawn below sprites and entities.
      * @param table.filled - If the rectangle should be filled.
-     * @param table.forces - The forces that this object is rendered to.
+     * @param table.forces - The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      * @param table.left_top_offset - Only used if `left_top` is a LuaEntity.
      * @param table.only_in_alt_mode - If this should only be rendered in alt mode. Defaults to false.
-     * @param table.players - The players that this object is rendered to.
+     * @param table.players - The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      * @param table.right_bottom_offset - Only used if `right_bottom` is a LuaEntity.
      * @param table.time_to_live - In ticks. Defaults to living forever.
      * @param table.visible - If this is rendered to anyone at all. Defaults to true.
@@ -12747,13 +12949,13 @@ interface LuaRendering {
 
     /**
      * Create a sprite.
-     * @param table.forces - The forces that this object is rendered to.
+     * @param table.forces - The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      * @param table.only_in_alt_mode - If this should only be rendered in alt mode. Defaults to false.
      * @param table.orientation - The orientation of the sprite. Default is 0.
      * @param table.orientation_target - If given, the sprite rotates so that it faces this target. Note that `orientation` is still applied to the sprite.
      * @param table.orientation_target_offset - Only used if `orientation_target` is a LuaEntity.
      * @param table.oriented_offset - Offsets the center of the sprite if `orientation_target` is given. This offset will rotate together with the sprite.
-     * @param table.players - The players that this object is rendered to.
+     * @param table.players - The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      * @param table.target - Center of the sprite.
      * @param table.target_offset - Only used if `target` is a LuaEntity.
      * @param table.time_to_live - In ticks. Defaults to living forever.
@@ -12802,10 +13004,10 @@ interface LuaRendering {
      * @param table.alignment - Defaults to "left". Other options are "right" and "center".
      * @param table.draw_on_ground - If this should be drawn below sprites and entities.
      * @param table.font - Name of font to use. Defaults to the same font as flying-text.
-     * @param table.forces - The forces that this object is rendered to.
+     * @param table.forces - The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      * @param table.only_in_alt_mode - If this should only be rendered in alt mode. Defaults to false.
      * @param table.orientation - The orientation of the text. Default is 0.
-     * @param table.players - The players that this object is rendered to.
+     * @param table.players - The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      * @param table.scale_with_zoom - Defaults to false. If true, the text scales with player zoom, resulting in it always being the same size on screen, and the size compared to the game world changes.
      * @param table.target_offset - Only used if `target` is a LuaEntity.
      * @param table.text - The text to display.
@@ -13689,7 +13891,7 @@ interface LuaResourceCategoryPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -13808,7 +14010,7 @@ interface LuaShortcutPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -13975,12 +14177,12 @@ interface LuaStyle {
     extra_left_padding_when_activated: number
 
     /**
-     * Sets extra_top/right/bottom/left_margin_when_activated to this value. An array with two values sets top/bottom margin to the first value and left/right margin to the second value. An array with four values sets top, right, bottom, left margin respectively.
+     * Sets `extra_top/right/bottom/left_margin_when_activated` to this value. An array with two values sets top/bottom margin to the first value and left/right margin to the second value. An array with four values sets top, right, bottom, left margin respectively.
      */
     extra_margin_when_activated: number | number[]
 
     /**
-     * Sets extra_top/right/bottom/left_padding_when_actived to this value. An array with two values sets top/bottom padding to the first value and left/right padding to the second value. An array with four values sets top, right, bottom, left padding respectively.
+     * Sets `extra_top/right/bottom/left_padding_when_activated` to this value. An array with two values sets top/bottom padding to the first value and left/right padding to the second value. An array with four values sets top, right, bottom, left padding respectively.
      */
     extra_padding_when_activated: number | number[]
 
@@ -14034,7 +14236,7 @@ interface LuaStyle {
     /**
      * Horizontal space between individual cells.
      * @remarks
-     * Applies to subclasses: LuaTableStyle,LuaFlowStyle,LuaHorizontalFlow
+     * Applies to subclasses: LuaTableStyle,LuaFlowStyle,LuaHorizontalFlowStyle
      *
      */
     horizontal_spacing: number
@@ -14725,10 +14927,12 @@ interface LuaSurface {
      * 
      * If no filters (`name`, `type`, `force`, etc.) are given, this returns all entities in the search area. If multiple filters are specified, only entities matching all given filters are returned.
      * 
-     * If no `area` or `position` are given, the entire surface is searched. If `position` is given, this returns the entities colliding with that position (i.e the given position is within the entity's collision box). If `position` and `radius` are given, this returns the entities within the radius of the position. If `area` is specified, this returns the entities colliding with that area.
-     * @param table.invert - If the filters should be inverted.
+     * - If no `area` or `position` are given, the entire surface is searched.
+     * - If `position` is given, this returns the entities colliding with that position (i.e the given position is within the entity's collision box).
+     * - If `position` and `radius` are given, this returns the entities within the radius of the position. Looks for the center of entities.
+     * - If `area` is specified, this returns the entities colliding with that area.
+     * @param table.invert - Whether the filters should be inverted.
      * @param table.position - Has precedence over area field.
-     * @param table.radius - If given with position, will return all entities within the radius of the position.
      * @example
      * ```
      * game.surfaces[1].find_entities_filtered{area = {{-10, -10}, {10, 10}}, type = "resource"} -- gets all resources in the rectangle
@@ -15113,7 +15317,7 @@ interface LuaSurface {
         id: number): void
 
     /**
-     * Generates a path with the specified constraints (as an array of {@link PathfinderWaypoints | PathfinderWaypoint}) using the unit pathfinding algorithm. This path can be used to emulate pathing behavior by script for non-unit entities. If you want to command actual units to move, use the {@link LuaEntity::set_command | LuaEntity::set_command} functionality instead.
+     * Generates a path with the specified constraints (as an array of {@link PathfinderWaypoints | PathfinderWaypoint}) using the unit pathfinding algorithm. This path can be used to emulate pathing behavior by script for non-unit entities, such as vehicles. If you want to command actual units (such as biters or spitters) to move, use {@link LuaEntity::set_command | LuaEntity::set_command} instead.
      * 
      * The resulting path is ultimately returned asynchronously via {@link on_script_path_request_finished | on_script_path_request_finished}.
      * @param table.bounding_box - The dimensions of the object that's supposed to travel the path.
@@ -15421,7 +15625,7 @@ interface LuaTechnology {
     readonly object_name: string
 
     /**
-     * Order string for this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -15540,7 +15744,7 @@ interface LuaTechnologyPrototype {
     readonly object_name: string
 
     /**
-     * Order string for this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -15713,7 +15917,7 @@ interface LuaTilePrototype {
     readonly emissions_per_second: number
 
     /**
-     * Items that when placed will produce this tile. It is a dictionary indexed by the item prototype name.
+     * Items that when placed will produce this tile. It is a dictionary indexed by the item prototype name. `nil` (instead of an empty table) if no items can place this tile.
      */
     readonly items_to_place_this: SimpleItemStack[]
 
@@ -15725,7 +15929,7 @@ interface LuaTilePrototype {
 
     readonly map_color: Color
 
-    readonly mineable_properties: { minable: boolean, miningparticle?: string, miningtime: number, products: Product[] }
+    readonly mineable_properties: { minable: boolean, mining_particle?: string, mining_time: number, products: Product[] }
 
     /**
      * Name of this prototype.
@@ -15748,7 +15952,7 @@ interface LuaTilePrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -16261,7 +16465,7 @@ interface LuaTrivialSmokePrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -16406,7 +16610,7 @@ interface LuaVirtualSignalPrototype {
     readonly object_name: string
 
     /**
-     * Order string of this prototype.
+     * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
      */
     readonly order: string
 
@@ -16593,7 +16797,7 @@ interface LuaGuiElementAddParams {
     'index'?: number
 
     /**
-     * Name of the child element.
+     * Name of the child element. It must be unique within the parent element.
      */
     'name'?: string
 
@@ -16690,7 +16894,7 @@ interface LuaGuiElementAddParamsChooseElemButton extends LuaGuiElementAddParams
     'decorative'?: string
 
     /**
-     * Filters describing what to show in the selection window. See {@link LuaGuiElement::elem_filters | LuaGuiElement::elem_filters}.
+     * Filters describing what to show in the selection window. The applicable filter depends on the `elem_type`.
      */
     'elem_filters'?: ItemPrototypeFilter | TilePrototypeFilter | EntityPrototypeFilter | FluidPrototypeFilter | RecipePrototypeFilter | DecorativePrototypeFilter | AchievementPrototypeFilter | EquipmentPrototypeFilter | TechnologyPrototypeFilter[]
 
@@ -17184,7 +17388,7 @@ interface LuaSurfaceCreateEntityParams {
     /**
      * Source entity. Used for beams and highlight-boxes.
      */
-    'source'?: LuaEntity
+    'source'?: LuaEntity | MapPosition
 
     /**
      * If true, entity types that have spawn_decorations property will apply triggers defined in the property.
@@ -17199,7 +17403,7 @@ interface LuaSurfaceCreateEntityParams {
     /**
      * Entity with health for the new entity to target.
      */
-    'target'?: LuaEntity
+    'target'?: LuaEntity | MapPosition
 
 }
 
@@ -17363,7 +17567,7 @@ interface LuaSurfaceCreateEntityParamsHighlightBox extends LuaSurfaceCreateEntit
     'blink_interval'?: number
 
     /**
-     * The bounding box defining the highlight box using absolute map coordinates. If specified, the `position` parameter is ignored, but needs to be present anyways. If not specified, the game falls back to the `source` parameter first, then the `target` parameter second. One of these three parameters need to be specified.
+     * The bounding box defining the highlight box using absolute map coordinates. If specified, the general `position` parameter still needs to be present, but will be ignored. If not specified, the game falls back to the `source` parameter first, then the `target` parameter second. One of these three parameters need to be specified.
      */
     'bounding_box'?: BoundingBox