typed-factorio 1.0.0 → 1.3.0

package/generated/classes.d.ts

@@ -83,7 +83,7 @@ interface LuaAchievementPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaAchievementPrototype.html#LuaAchievementPrototype.order View documentation}
    */
@@ -120,7 +120,7 @@ interface LuaAmmoCategoryPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaAmmoCategoryPrototype.html#LuaAmmoCategoryPrototype.order View documentation}
    */
@@ -150,10 +150,10 @@ interface LuaAmmoCategoryPrototype {
  */
 interface LuaArithmeticCombinatorControlBehavior extends LuaCombinatorControlBehavior {
   /**
-   * The arithmetic combinator parameters.
+   * This arithmetic combinator's parameters.
    *
    * {@link https://lua-api.factorio.com/latest/LuaArithmeticCombinatorControlBehavior.html#LuaArithmeticCombinatorControlBehavior.parameters View documentation}
-   * @remarks `parameters` may be `nil` in order to clear the parameters.
+   * @remarks Writing `nil` clears the combinator's parameters.
    */
   parameters: ArithmeticCombinatorParameters
   /**
@@ -184,7 +184,7 @@ interface LuaAutoplaceControlPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaAutoplaceControlPrototype.html#LuaAutoplaceControlPrototype.order View documentation}
    */
@@ -222,10 +222,11 @@ interface LuaAutoplaceControlPrototype {
  */
 interface LuaBootstrap {
   /**
-   * 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} 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} and the {@link https://lua-api.factorio.com/latest/Global.html 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaBootstrap.html#LuaBootstrap.on_init View documentation}
    * @param f The handler for this event. Passing `nil` will unregister it.
+   * @remarks For more context, refer to the {@link https://lua-api.factorio.com/latest/Data-Lifecycle.html Data Lifecycle} page.
    * @example Initialize a `players` table in `global` for later use.
    *
    * ```
@@ -236,24 +237,26 @@ interface LuaBootstrap {
    */
   on_init(f: (() => void) | undefined): 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} and {@link 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} is not available. The {@link https://lua-api.factorio.com/latest/Global.html 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 https://www.lua.org/pil/13.html metatables} as they are not persisted through save-load.
-   * - Re-setup conditional event handlers.
+   * The only legitimate uses of this event are the following:
+   * - Re-setup {@link https://www.lua.org/pil/13.html metatables} 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 https://lua-api.factorio.com/latest/Global.html 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 https://lua-api.factorio.com/latest/Migrations.html migrations} should be used instead.
    *
    * {@link https://lua-api.factorio.com/latest/LuaBootstrap.html#LuaBootstrap.on_load View documentation}
    * @param f The handler for this event. Passing `nil` will unregister it.
+   * @remarks For more context, refer to the {@link https://lua-api.factorio.com/latest/Data-Lifecycle.html Data Lifecycle} page.
    */
   on_load(f: (() => void) | undefined): 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}.
+   * 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 https://lua-api.factorio.com/latest/Global.html global} table or to the game state through {@link LuaGameScript}.
    *
    * {@link https://lua-api.factorio.com/latest/LuaBootstrap.html#LuaBootstrap.on_configuration_changed View documentation}
    * @param f The handler for this event. Passing `nil` will unregister it.
+   * @remarks For more context, refer to the {@link https://lua-api.factorio.com/latest/Data-Lifecycle.html Data Lifecycle} page.
    */
   on_configuration_changed(f: ((param1: ConfigurationChangedData) => void) | undefined): void
   /**
@@ -915,12 +918,12 @@ interface LuaConstantCombinatorControlBehavior extends LuaControlBehavior {
    */
   get_signal(index: uint): Signal
   /**
-   * The constant combinator parameters
+   * This constant combinator's parameters, or `nil` if the {@link LuaEntityPrototype#item_slot_count item_slot_count} of the combinator's prototype is `0`.
    *
    * {@link https://lua-api.factorio.com/latest/LuaConstantCombinatorControlBehavior.html#LuaConstantCombinatorControlBehavior.parameters View documentation}
-   * @remarks Setting to `nil` clears the parameters.
+   * @remarks Writing `nil` clears the combinator's parameters.
    */
-  parameters: ConstantCombinatorParameters[]
+  parameters: ConstantCombinatorParameters[] | undefined
   /**
    * Turns this constant combinator on and off.
    *
@@ -1281,7 +1284,7 @@ interface LuaControl {
    */
   set_personal_logistic_slot(slot_index: uint, value: LogisticParameters): boolean
   /**
-   * 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`.
    *
    * **Raised events:**
    * - {@link OnEntityLogisticSlotChangedEvent on_entity_logistic_slot_changed}? _instantly_ Raised if setting of logistic slot was successful.
@@ -1294,7 +1297,7 @@ interface LuaControl {
    */
   set_vehicle_logistic_slot(slot_index: uint, value: LogisticParameters): boolean
   /**
-   * 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`.
    *
    * {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.get_personal_logistic_slot View documentation}
    * @param slot_index The slot to get.
@@ -1420,7 +1423,7 @@ interface LuaControl {
    *
    * {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.crafting_queue_progress View documentation}
    */
-  readonly crafting_queue_progress: double
+  crafting_queue_progress: double
   /**
    * Current walking state.
    *
@@ -1551,6 +1554,10 @@ interface LuaControl {
   /**
    * `true` if the player is in a vehicle. Writing to this attribute puts the player in or out of a vehicle.
    *
+   * **Raised events:**
+   * - {@link OnPlayerDrivingChangedStateEvent on_player_driving_changed_state}? _instantly_ Raised if the driving state successfully changed.
+   *
+   *
    * {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.driving View documentation}
    */
   driving: boolean
@@ -1857,7 +1864,7 @@ interface LuaCustomInputPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaCustomInputPrototype.html#LuaCustomInputPrototype.order View documentation}
    */
@@ -2021,7 +2028,7 @@ interface LuaDamagePrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaDamagePrototype.html#LuaDamagePrototype.order View documentation}
    */
@@ -2056,10 +2063,10 @@ interface LuaDamagePrototype {
  */
 interface LuaDeciderCombinatorControlBehavior extends LuaCombinatorControlBehavior {
   /**
-   * The decider combinator parameters
+   * This decider combinator's parameters.
    *
    * {@link https://lua-api.factorio.com/latest/LuaDeciderCombinatorControlBehavior.html#LuaDeciderCombinatorControlBehavior.parameters View documentation}
-   * @remarks Setting to `nil` clears the parameters.
+   * @remarks Writing `nil` clears the combinator's parameters.
    */
   parameters: DeciderCombinatorParameters
   /**
@@ -2090,7 +2097,7 @@ interface LuaDecorativePrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaDecorativePrototype.html#LuaDecorativePrototype.order View documentation}
    */
@@ -2169,7 +2176,7 @@ interface LuaElectricEnergySourcePrototype {
  */
 interface LuaEntity extends LuaControl {
   /**
-   * Gets the entities output inventory if it has one.
+   * Gets the entity's output inventory if it has one.
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.get_output_inventory View documentation}
    * @returns A reference to the entity's output inventory.
@@ -2882,6 +2889,9 @@ interface LuaEntity extends LuaControl {
   /**
    * Sets the driver of this vehicle.
    *
+   * **Raised events:**
+   * - {@link OnPlayerDrivingChangedStateEvent on_player_driving_changed_state}? _instantly_
+   *
    * _Can only be used if this is Vehicle_
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_driver View documentation}
@@ -2902,6 +2912,9 @@ interface LuaEntity extends LuaControl {
   /**
    * Sets the passenger of this car or spidertron.
    *
+   * **Raised events:**
+   * - {@link OnPlayerDrivingChangedStateEvent on_player_driving_changed_state}? _instantly_
+   *
    * _Can only be used if this is Vehicle_
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_passenger View documentation}
@@ -2909,7 +2922,7 @@ interface LuaEntity extends LuaControl {
    */
   set_passenger(passenger: LuaEntity | PlayerIdentification): 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.is_connected_to_electric_network View documentation}
    */
@@ -3755,13 +3768,16 @@ interface LuaEntity extends LuaControl {
    */
   kills: uint
   /**
-   * 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}, while {@link PlayerIdentification} can be used when writing.
    *
    * _Can only be used if this is EntityWithOwner_
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.last_user View documentation}
    */
-  last_user: LuaPlayer | undefined
+  get last_user(): LuaPlayer | LuaPlayer | undefined
+  set last_user(value: LuaPlayer | PlayerIdentification | undefined)
   /**
    * The buffer size for the electric energy source or nil if the entity doesn't have an electric energy source.
    *
@@ -3842,7 +3858,7 @@ interface LuaEntity extends LuaControl {
    */
   readonly bounding_box: BoundingBoxRead
   /**
-   * 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.secondary_bounding_box View documentation}
    */
@@ -3854,7 +3870,7 @@ interface LuaEntity extends LuaControl {
    */
   readonly selection_box: BoundingBoxRead
   /**
-   * 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.secondary_selection_box View documentation}
    */
@@ -4087,14 +4103,19 @@ interface LuaEntity extends LuaControl {
    */
   character_corpse_death_cause: LocalisedString
   /**
-   * 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}, while {@link PlayerIdentification} can be used when writing.
    *
    * _Can only be used if this is Character_
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.associated_player View documentation}
-   * @remarks A character associated with a player is not directly controlled by any player.<br>Set to `nil` to clear. The player will be automatically disassociated when a controller is set on the character.
+   * @remarks A character associated with a player is not directly controlled by any player.
    */
-  associated_player: LuaPlayer | undefined
+  get associated_player(): LuaPlayer | LuaPlayer | undefined
+  set associated_player(value: LuaPlayer | PlayerIdentification | undefined)
   /**
    * The last tick this character entity was attacked.
    *
@@ -4240,9 +4261,12 @@ 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}, while {@link PlayerIdentification} can be used when writing.
+   *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.render_player View documentation}
    */
-  render_player: LuaPlayer | undefined
+  get render_player(): LuaPlayer | LuaPlayer | undefined
+  set render_player(value: LuaPlayer | PlayerIdentification | undefined)
   /**
    * 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.
    *
@@ -4486,7 +4510,7 @@ interface LuaEntity extends LuaControl {
  */
 interface BaseEntity extends LuaControl {
   /**
-   * Gets the entities output inventory if it has one.
+   * Gets the entity's output inventory if it has one.
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.get_output_inventory View documentation}
    * @returns A reference to the entity's output inventory.
@@ -4876,7 +4900,7 @@ interface BaseEntity extends LuaControl {
     readonly force?: LuaForce | string
   }): LuaMultiReturn<[boolean, Record<string, uint> | undefined]>
   /**
-   * 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.is_connected_to_electric_network View documentation}
    */
@@ -5388,7 +5412,7 @@ interface BaseEntity extends LuaControl {
    */
   readonly bounding_box: BoundingBoxRead
   /**
-   * 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.secondary_bounding_box View documentation}
    */
@@ -5400,7 +5424,7 @@ interface BaseEntity extends LuaControl {
    */
   readonly selection_box: BoundingBoxRead
   /**
-   * 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.secondary_selection_box View documentation}
    */
@@ -5556,9 +5580,12 @@ interface BaseEntity 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}, while {@link PlayerIdentification} can be used when writing.
+   *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.render_player View documentation}
    */
-  render_player: LuaPlayer | undefined
+  get render_player(): LuaPlayer | LuaPlayer | undefined
+  set render_player(value: LuaPlayer | PlayerIdentification | undefined)
   /**
    * 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.
    *
@@ -6276,6 +6303,9 @@ interface VehicleEntity extends BaseEntity {
   /**
    * Sets the driver of this vehicle.
    *
+   * **Raised events:**
+   * - {@link OnPlayerDrivingChangedStateEvent on_player_driving_changed_state}? _instantly_
+   *
    * _Can only be used if this is Vehicle_
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_driver View documentation}
@@ -6296,6 +6326,9 @@ interface VehicleEntity extends BaseEntity {
   /**
    * Sets the passenger of this car or spidertron.
    *
+   * **Raised events:**
+   * - {@link OnPlayerDrivingChangedStateEvent on_player_driving_changed_state}? _instantly_
+   *
    * _Can only be used if this is Vehicle_
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_passenger View documentation}
@@ -6718,14 +6751,19 @@ interface CharacterEntity extends BaseEntity {
    */
   readonly player: LuaPlayer | undefined
   /**
-   * 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}, while {@link PlayerIdentification} can be used when writing.
    *
    * _Can only be used if this is Character_
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.associated_player View documentation}
-   * @remarks A character associated with a player is not directly controlled by any player.<br>Set to `nil` to clear. The player will be automatically disassociated when a controller is set on the character.
+   * @remarks A character associated with a player is not directly controlled by any player.
    */
-  associated_player: LuaPlayer | undefined
+  get associated_player(): LuaPlayer | LuaPlayer | undefined
+  set associated_player(value: LuaPlayer | PlayerIdentification | undefined)
   /**
    * The last tick this character entity was attacked.
    *
@@ -6825,13 +6863,16 @@ interface TurretEntity extends BaseEntity {
 
 interface EntityWithOwnerEntity extends BaseEntity {
   /**
-   * 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}, while {@link PlayerIdentification} can be used when writing.
    *
    * _Can only be used if this is EntityWithOwner_
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.last_user View documentation}
    */
-  last_user: LuaPlayer | undefined
+  get last_user(): LuaPlayer | LuaPlayer | undefined
+  set last_user(value: LuaPlayer | PlayerIdentification | undefined)
 }
 
 interface ElectricEnergyInterfaceEntity extends BaseEntity {
@@ -7186,7 +7227,7 @@ interface LuaEntityPrototype {
    */
   readonly default_collision_mask_with_flags: CollisionMaskWithFlags
   /**
-   * Order string of this prototype.
+   * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.order View documentation}
    */
@@ -7570,6 +7611,12 @@ interface LuaEntityPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.guns View documentation}
    */
   readonly guns: Record<string, LuaItemPrototype> | undefined
+  /**
+   * A vector of the gun prototypes this prototype uses, or `nil`.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.indexed_guns View documentation}
+   */
+  readonly indexed_guns: LuaItemPrototype[] | undefined
   /**
    * The default speed of this flying robot, rolling stock or unit, `nil` if not one of these.
    *
@@ -8309,6 +8356,58 @@ interface LuaEntityPrototype {
         readonly robots_shrink_when_entering_and_exiting: boolean
       }
     | undefined
+  /**
+   * Gets the height of this prototype. `nil` if this is not a spider vechicle.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.height View documentation}
+   */
+  readonly height: double | undefined
+  /**
+   * Gets the torso rotation speed of this prototype. `nil` if this is not a spider vechicle.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.torso_rotation_speed View documentation}
+   */
+  readonly torso_rotation_speed: double | undefined
+  /**
+   * Does this prototoype automaticly cycle weapons. `nil` if this is not a spider vechicle.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.automatic_weapon_cycling View documentation}
+   */
+  readonly automatic_weapon_cycling: boolean | undefined
+  /**
+   * Gets the chain shooting cooldown modifier of this prototype. `nil` if this is not a spider vechicle.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.chain_shooting_cooldown_modifier View documentation}
+   */
+  readonly chain_shooting_cooldown_modifier: double | undefined
+  /**
+   * Gets the chunk exploration radius of this prototype. `nil` if this is not a spider vechicle.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.chunk_exploration_radius View documentation}
+   */
+  readonly chunk_exploration_radius: double | undefined
+  /**
+   * Gets the animation speed coefficient of this belt . `nil` if this is not transport belt connectable.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.animation_speed_coefficient View documentation}
+   */
+  readonly animation_speed_coefficient: double | undefined
+  /**
+   * Get the manual range modifier for artillery turret and artillery wagon prototypes. `nil` if not artillery type prototype
+   *
+   * subclass(ArtilleryWagon, ArtilleryTurret)
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.manual_range_modifier View documentation}
+   */
+  readonly manual_range_modifier: double | undefined
+  /**
+   * The dying time of this corpse prototype. `nil` if not a corpse prototype.
+   *
+   * _Can only be used if this is Corpse_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.dying_speed View documentation}
+   */
+  readonly dying_speed: float | undefined
   /**
    * Gets the current movement speed of this character, including effects from exoskeletons, tiles, stickers and shooting.
    *
@@ -8575,7 +8674,7 @@ interface BaseEntityPrototype {
    */
   readonly default_collision_mask_with_flags: CollisionMaskWithFlags
   /**
-   * Order string of this prototype.
+   * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.order View documentation}
    */
@@ -8959,6 +9058,12 @@ interface BaseEntityPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.guns View documentation}
    */
   readonly guns: Record<string, LuaItemPrototype> | undefined
+  /**
+   * A vector of the gun prototypes this prototype uses, or `nil`.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.indexed_guns View documentation}
+   */
+  readonly indexed_guns: LuaItemPrototype[] | undefined
   /**
    * The default speed of this flying robot, rolling stock or unit, `nil` if not one of these.
    *
@@ -9620,6 +9725,50 @@ interface BaseEntityPrototype {
         readonly robots_shrink_when_entering_and_exiting: boolean
       }
     | undefined
+  /**
+   * Gets the height of this prototype. `nil` if this is not a spider vechicle.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.height View documentation}
+   */
+  readonly height: double | undefined
+  /**
+   * Gets the torso rotation speed of this prototype. `nil` if this is not a spider vechicle.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.torso_rotation_speed View documentation}
+   */
+  readonly torso_rotation_speed: double | undefined
+  /**
+   * Does this prototoype automaticly cycle weapons. `nil` if this is not a spider vechicle.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.automatic_weapon_cycling View documentation}
+   */
+  readonly automatic_weapon_cycling: boolean | undefined
+  /**
+   * Gets the chain shooting cooldown modifier of this prototype. `nil` if this is not a spider vechicle.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.chain_shooting_cooldown_modifier View documentation}
+   */
+  readonly chain_shooting_cooldown_modifier: double | undefined
+  /**
+   * Gets the chunk exploration radius of this prototype. `nil` if this is not a spider vechicle.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.chunk_exploration_radius View documentation}
+   */
+  readonly chunk_exploration_radius: double | undefined
+  /**
+   * Gets the animation speed coefficient of this belt . `nil` if this is not transport belt connectable.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.animation_speed_coefficient View documentation}
+   */
+  readonly animation_speed_coefficient: double | undefined
+  /**
+   * Get the manual range modifier for artillery turret and artillery wagon prototypes. `nil` if not artillery type prototype
+   *
+   * subclass(ArtilleryWagon, ArtilleryTurret)
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.manual_range_modifier View documentation}
+   */
+  readonly manual_range_modifier: double | undefined
   /**
    * 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.
    */
@@ -9727,6 +9876,17 @@ interface EntityWithOwnerEntityPrototype extends BaseEntityPrototype {
   readonly allow_run_time_change_of_is_military_target: boolean
 }
 
+interface CorpseEntityPrototype extends BaseEntityPrototype {
+  /**
+   * The dying time of this corpse prototype. `nil` if not a corpse prototype.
+   *
+   * _Can only be used if this is Corpse_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.dying_speed View documentation}
+   */
+  readonly dying_speed: float | undefined
+}
+
 interface CharacterEntityPrototype extends BaseEntityPrototype {
   /**
    * Gets the current movement speed of this character, including effects from exoskeletons, tiles, stickers and shooting.
@@ -9936,7 +10096,7 @@ interface LuaEquipmentCategoryPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaEquipmentCategoryPrototype.html#LuaEquipmentCategoryPrototype.order View documentation}
    */
@@ -10154,7 +10314,7 @@ interface LuaEquipmentGridPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaEquipmentGridPrototype.html#LuaEquipmentGridPrototype.order View documentation}
    */
@@ -10209,7 +10369,7 @@ interface LuaEquipmentPrototype {
    */
   readonly type: 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaEquipmentPrototype.html#LuaEquipmentPrototype.order View documentation}
    */
@@ -10344,7 +10504,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.
  *
  * {@link https://lua-api.factorio.com/latest/LuaFlowStatistics.html View documentation}
@@ -10382,7 +10542,11 @@ interface LuaFlowStatistics {
    */
   set_output_count(name: string, count: uint64 | double): void
   /**
-   * Gets the flow count value for the given time frame.
+   * 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaFlowStatistics.html#LuaFlowStatistics.get_flow_count View documentation}
    */
@@ -10396,11 +10560,15 @@ interface LuaFlowStatistics {
      */
     readonly input: boolean
     /**
-     * The precision to read.
+     * The precision range to read.
      */
     readonly precision_index: defines.flow_precision_index
     /**
-     * If true, the count is returned instead of the per-time-frame value.
+     * 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.
+     */
+    readonly sample_index?: uint16
+    /**
+     * If true, the count of items/fluids/entities is returned instead of the per-time-frame value.
      */
     readonly count?: boolean
   }): double
@@ -10481,7 +10649,7 @@ interface LuaFluidBox extends Array<Fluid | undefined> {
    */
   get_capacity(index: uint): double
   /**
-   * The fluidbox connections for the given fluidbox index.
+   * The fluidboxes to which the fluidbox at the given index is connected.
    *
    * {@link https://lua-api.factorio.com/latest/LuaFluidBox.html#LuaFluidBox.get_connections View documentation}
    */
@@ -10719,7 +10887,7 @@ interface LuaFluidPrototype {
    */
   readonly heat_capacity: double
   /**
-   * Order string for this prototype.
+   * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
    *
    * {@link https://lua-api.factorio.com/latest/LuaFluidPrototype.html#LuaFluidPrototype.order View documentation}
    */
@@ -11546,7 +11714,7 @@ interface LuaFuelCategoryPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaFuelCategoryPrototype.html#LuaFuelCategoryPrototype.order View documentation}
    */
@@ -11959,11 +12127,10 @@ interface LuaGameScript {
    */
   is_valid_sound_path(sound_path: SoundPath): boolean
   /**
-   * Checks if the given SpritePath is valid and contains a loaded sprite.
+   * 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`.
    *
    * {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.is_valid_sprite_path View documentation}
    * @param sprite_path Path to the image.
-   * @remarks The existence of the image is not checked for paths of type `file`.
    */
   is_valid_sprite_path(sprite_path: SpritePath): boolean
   /**
@@ -12279,7 +12446,9 @@ interface LuaGameScript {
    */
   decode_string(string: string): string | undefined
   /**
-   * 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 LuaCommandProcessor custom command} handlers and when writing {@link https://wiki.factorio.com/Console#Scripting_and_cheat_commands Lua console commands}. Returns the player that is typing the command, `nil` in all other instances.
+   *
+   * See {@link LuaGameScript#players LuaGameScript::players} for accessing all players.
    *
    * {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.player View documentation}
    */
@@ -12727,6 +12896,11 @@ interface LuaGroup {
    * @remarks Can only be used on groups, not on subgroups.
    */
   readonly order_in_recipe: string
+  /**
+   * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaGroup.html#LuaGroup.order View documentation}
+   */
   readonly order: string
   /**
    * 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.
@@ -12753,6 +12927,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.
+   *
    * {@link https://lua-api.factorio.com/latest/LuaGui.html#LuaGui.is_valid_sprite_path View documentation}
    * @param sprite_path Path to a image.
    */
@@ -12852,7 +13028,7 @@ interface BaseGuiSpec {
    */
   readonly type: GuiElementType
   /**
-   * Name of the child element.
+   * Name of the child element. It must be unique within the parent element.
    */
   readonly name?: string
   /**
@@ -13371,7 +13547,7 @@ interface BaseGuiElement {
    * Other attributes may be specified depending on `type`:
    *
    * {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.add View documentation}
-   * @returns The added GUI element.
+   * @returns The GUI element that was added.
    */
   add<Type extends GuiElementType>(
     element: GuiSpec & {
@@ -13460,7 +13636,7 @@ interface BaseGuiElement {
    */
   readonly parent: LuaGuiElement | undefined
   /**
-   * The name of this element.
+   * The name of this element. `""` if no name was set.
    *
    * {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.name View documentation}
    * @example
@@ -13585,20 +13761,7 @@ interface ChooseElemButtonGuiElementMembers extends BaseGuiElement {
    */
   elem_value: (this["elem_type"] extends "signal" ? SignalID : string) | undefined
   /**
-   * 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}
-   * - Type `"tile"` - {@link TilePrototypeFilter}
-   * - Type `"entity"` - {@link EntityPrototypeFilter}
-   * - Type `"signal"` - Does not support filters
-   * - Type `"fluid"` - {@link FluidPrototypeFilter}
-   * - Type `"recipe"` - {@link RecipePrototypeFilter}
-   * - Type `"decorative"` - {@link DecorativePrototypeFilter}
-   * - Type `"item-group"` - Does not support filters
-   * - Type `"achievement"` - {@link AchievementPrototypeFilter}
-   * - Type `"equipment"` - {@link EquipmentPrototypeFilter}
-   * - Type `"technology"` - {@link 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`.
    *
    * _Can only be used if this is choose-elem-button_
    *
@@ -15223,7 +15386,7 @@ interface LuaItemPrototype {
   readonly localised_name: LocalisedString
   readonly localised_description: LocalisedString
   /**
-   * Order string.
+   * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
    *
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.order View documentation}
    */
@@ -15461,13 +15624,13 @@ interface LuaItemPrototype {
    */
   readonly speed: float | undefined
   /**
-   * Effects of this module; `nil` if this is not a module.
+   * Effects of this module.
    *
    * _Can only be used if this is ModuleItem_
    *
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.module_effects View documentation}
    */
-  readonly module_effects: ModuleEffects | undefined
+  readonly module_effects: ModuleEffects
   /**
    * The name of a {@link LuaModuleCategoryPrototype}. Used when upgrading modules: Ctrl + click modules into an entity and it will replace lower tier modules of the same category with higher tier modules.
    *
@@ -15816,7 +15979,7 @@ interface BaseItemPrototype {
   readonly localised_name: LocalisedString
   readonly localised_description: LocalisedString
   /**
-   * Order string.
+   * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
    *
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.order View documentation}
    */
@@ -16078,13 +16241,13 @@ interface ItemWithLabelItemPrototype extends BaseItemPrototype {
 
 interface ModuleItemPrototype extends BaseItemPrototype {
   /**
-   * Effects of this module; `nil` if this is not a module.
+   * Effects of this module.
    *
    * _Can only be used if this is ModuleItem_
    *
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.module_effects View documentation}
    */
-  readonly module_effects: ModuleEffects | undefined
+  readonly module_effects: ModuleEffects
   /**
    * The name of a {@link LuaModuleCategoryPrototype}. Used when upgrading modules: Ctrl + click modules into an entity and it will replace lower tier modules of the same category with higher tier modules.
    *
@@ -16484,8 +16647,8 @@ interface LuaItemStack {
    * Set this item stack to another item stack.
    *
    * {@link https://lua-api.factorio.com/latest/LuaItemStack.html#LuaItemStack.set_stack View documentation}
-   * @param stack Item stack to set this one to. Omitting this parameter or passing `nil` will clear this item stack, as if by calling {@link LuaItemStack#clear LuaItemStack::clear}.
-   * @returns Was the stack set successfully?
+   * @param stack Item stack to set it to. Omitting this parameter or passing `nil` will clear this item stack, as if {@link LuaItemStack#clear LuaItemStack::clear} was called.
+   * @returns Whether the stack was set successfully. Returns `false` if this stack was not {@link LuaItemStack#can_set_stack valid for write}.
    */
   set_stack(stack?: ItemStackIdentification): boolean
   /**
@@ -17219,8 +17382,8 @@ interface BaseItemStack {
    * Set this item stack to another item stack.
    *
    * {@link https://lua-api.factorio.com/latest/LuaItemStack.html#LuaItemStack.set_stack View documentation}
-   * @param stack Item stack to set this one to. Omitting this parameter or passing `nil` will clear this item stack, as if by calling {@link LuaItemStack#clear LuaItemStack::clear}.
-   * @returns Was the stack set successfully?
+   * @param stack Item stack to set it to. Omitting this parameter or passing `nil` will clear this item stack, as if {@link LuaItemStack#clear LuaItemStack::clear} was called.
+   * @returns Whether the stack was set successfully. Returns `false` if this stack was not {@link LuaItemStack#can_set_stack valid for write}.
    */
   set_stack(stack?: ItemStackIdentification): boolean
   /**
@@ -18619,7 +18782,7 @@ interface LuaModSettingPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaModSettingPrototype.html#LuaModSettingPrototype.order View documentation}
    */
@@ -18703,7 +18866,7 @@ interface LuaModuleCategoryPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaModuleCategoryPrototype.html#LuaModuleCategoryPrototype.order View documentation}
    */
@@ -18738,7 +18901,7 @@ interface LuaNamedNoiseExpression {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaNamedNoiseExpression.html#LuaNamedNoiseExpression.order View documentation}
    */
@@ -18785,7 +18948,7 @@ interface LuaNoiseLayerPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaNoiseLayerPrototype.html#LuaNoiseLayerPrototype.order View documentation}
    */
@@ -18820,7 +18983,7 @@ interface LuaParticlePrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaParticlePrototype.html#LuaParticlePrototype.order View documentation}
    */
@@ -19123,6 +19286,10 @@ interface LuaPlayer extends LuaControl {
   /**
    * Invokes the "clear cursor" action on the player as if the user pressed it.
    *
+   * **Raised events:**
+   * - {@link OnPlayerCursorStackChangedEvent on_player_cursor_stack_changed}? _current_tick_ Raised when the cursor was successfully cleared.
+   *
+   *
    * {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.clear_cursor View documentation}
    * @returns Whether the cursor is now empty.
    */
@@ -19595,7 +19762,7 @@ interface LuaPlayer extends LuaControl {
    */
   readonly cutscene_character: LuaEntity | undefined
   /**
-   * 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 OnPlayerCreatedEvent created} and remains assigned to them until they are {@link OnPlayerRemovedEvent removed}.
    *
    * {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.index View documentation}
    */
@@ -20143,7 +20310,7 @@ interface LuaRecipe {
    */
   readonly energy: double
   /**
-   * 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaRecipe.html#LuaRecipe.order View documentation}
    */
@@ -20194,7 +20361,7 @@ interface LuaRecipeCategoryPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaRecipeCategoryPrototype.html#LuaRecipeCategoryPrototype.order View documentation}
    */
@@ -20296,7 +20463,7 @@ interface LuaRecipePrototype {
    */
   readonly energy: double
   /**
-   * 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaRecipePrototype.html#LuaRecipePrototype.order View documentation}
    */
@@ -20502,11 +20669,11 @@ interface LuaRendering {
      */
     readonly time_to_live?: uint
     /**
-     * The forces that this object is rendered to.
+     * The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      */
     readonly forces?: readonly ForceIdentification[]
     /**
-     * The players that this object is rendered to.
+     * The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      */
     readonly players?: readonly PlayerIdentification[]
     /**
@@ -20551,11 +20718,11 @@ interface LuaRendering {
      */
     readonly time_to_live?: uint
     /**
-     * The forces that this object is rendered to.
+     * The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      */
     readonly forces?: readonly ForceIdentification[]
     /**
-     * The players that this object is rendered to.
+     * The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      */
     readonly players?: readonly PlayerIdentification[]
     /**
@@ -20618,11 +20785,11 @@ interface LuaRendering {
      */
     readonly time_to_live?: uint
     /**
-     * The forces that this object is rendered to.
+     * The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      */
     readonly forces?: readonly ForceIdentification[]
     /**
-     * The players that this object is rendered to.
+     * The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      */
     readonly players?: readonly PlayerIdentification[]
     /**
@@ -20670,11 +20837,11 @@ interface LuaRendering {
      */
     readonly time_to_live?: uint
     /**
-     * The forces that this object is rendered to.
+     * The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      */
     readonly forces?: readonly ForceIdentification[]
     /**
-     * The players that this object is rendered to.
+     * The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      */
     readonly players?: readonly PlayerIdentification[]
     /**
@@ -20725,11 +20892,11 @@ interface LuaRendering {
      */
     readonly time_to_live?: uint
     /**
-     * The forces that this object is rendered to.
+     * The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      */
     readonly forces?: readonly ForceIdentification[]
     /**
-     * The players that this object is rendered to.
+     * The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      */
     readonly players?: readonly PlayerIdentification[]
     /**
@@ -20780,11 +20947,11 @@ interface LuaRendering {
      */
     readonly time_to_live?: uint
     /**
-     * The forces that this object is rendered to.
+     * The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      */
     readonly forces?: readonly ForceIdentification[]
     /**
-     * The players that this object is rendered to.
+     * The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      */
     readonly players?: readonly PlayerIdentification[]
     /**
@@ -20858,11 +21025,11 @@ interface LuaRendering {
      */
     readonly time_to_live?: uint
     /**
-     * The forces that this object is rendered to.
+     * The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      */
     readonly forces?: readonly ForceIdentification[]
     /**
-     * The players that this object is rendered to.
+     * The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      */
     readonly players?: readonly PlayerIdentification[]
     /**
@@ -20921,11 +21088,11 @@ interface LuaRendering {
      */
     readonly time_to_live?: uint
     /**
-     * The forces that this object is rendered to.
+     * The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      */
     readonly forces?: readonly ForceIdentification[]
     /**
-     * The players that this object is rendered to.
+     * The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      */
     readonly players?: readonly PlayerIdentification[]
     /**
@@ -20996,11 +21163,11 @@ interface LuaRendering {
      */
     readonly time_to_live?: uint
     /**
-     * The forces that this object is rendered to.
+     * The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      */
     readonly forces?: readonly ForceIdentification[]
     /**
-     * The players that this object is rendered to.
+     * The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      */
     readonly players?: readonly PlayerIdentification[]
     /**
@@ -21793,7 +21960,7 @@ interface LuaResourceCategoryPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaResourceCategoryPrototype.html#LuaResourceCategoryPrototype.order View documentation}
    */
@@ -21907,7 +22074,7 @@ interface LuaShortcutPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaShortcutPrototype.html#LuaShortcutPrototype.order View documentation}
    */
@@ -22161,7 +22328,7 @@ interface LuaStyle {
   /**
    * Horizontal space between individual cells.
    *
-   * _Can only be used if this is LuaTableStyle, LuaFlowStyle or LuaHorizontalFlow_
+   * _Can only be used if this is LuaTableStyle, LuaFlowStyle or LuaHorizontalFlowStyle_
    *
    * {@link https://lua-api.factorio.com/latest/LuaStyle.html#LuaStyle.horizontal_spacing View documentation}
    */
@@ -22336,13 +22503,13 @@ interface LuaStyle {
    */
   set cell_padding(value: int)
   /**
-   * 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaStyle.html#LuaStyle.extra_padding_when_activated View documentation}
    */
   set extra_padding_when_activated(value: int | StyleValuesArray)
   /**
-   * 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaStyle.html#LuaStyle.extra_margin_when_activated View documentation}
    */
@@ -22551,7 +22718,7 @@ interface TableStyle extends BaseStyle {
   /**
    * Horizontal space between individual cells.
    *
-   * _Can only be used if this is LuaTableStyle, LuaFlowStyle or LuaHorizontalFlow_
+   * _Can only be used if this is LuaTableStyle, LuaFlowStyle or LuaHorizontalFlowStyle_
    *
    * {@link https://lua-api.factorio.com/latest/LuaStyle.html#LuaStyle.horizontal_spacing View documentation}
    */
@@ -22725,7 +22892,7 @@ interface FlowStyle extends BaseStyle {
   /**
    * Horizontal space between individual cells.
    *
-   * _Can only be used if this is LuaTableStyle, LuaFlowStyle or LuaHorizontalFlow_
+   * _Can only be used if this is LuaTableStyle, LuaFlowStyle or LuaHorizontalFlowStyle_
    *
    * {@link https://lua-api.factorio.com/latest/LuaStyle.html#LuaStyle.horizontal_spacing View documentation}
    */
@@ -22744,7 +22911,7 @@ interface HorizontalFlowStyle extends BaseStyle {
   /**
    * Horizontal space between individual cells.
    *
-   * _Can only be used if this is LuaTableStyle, LuaFlowStyle or LuaHorizontalFlow_
+   * _Can only be used if this is LuaTableStyle, LuaFlowStyle or LuaHorizontalFlowStyle_
    *
    * {@link https://lua-api.factorio.com/latest/LuaStyle.html#LuaStyle.horizontal_spacing View documentation}
    */
@@ -22848,13 +23015,13 @@ interface ScrollPaneStyle extends BaseStyle {
    */
   extra_right_margin_when_activated: int
   /**
-   * 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaStyle.html#LuaStyle.extra_padding_when_activated View documentation}
    */
   set extra_padding_when_activated(value: int | StyleValuesArray)
   /**
-   * 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaStyle.html#LuaStyle.extra_margin_when_activated View documentation}
    */
@@ -22890,11 +23057,11 @@ interface BaseSurfaceCreateEntity {
   /**
    * Entity with health for the new entity to target.
    */
-  readonly target?: LuaEntity
+  readonly target?: LuaEntity | MapPosition
   /**
    * Source entity. Used for beams and highlight-boxes.
    */
-  readonly source?: LuaEntity
+  readonly source?: LuaEntity | MapPosition
   /**
    * If true, building will attempt to simulate fast-replace building.
    */
@@ -23099,7 +23266,7 @@ interface CharacterCorpseSurfaceCreateEntity extends BaseSurfaceCreateEntity {
 
 interface HighlightBoxSurfaceCreateEntity extends BaseSurfaceCreateEntity {
   /**
-   * 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.
    */
   readonly bounding_box?: BoundingBox
   /**
@@ -23268,7 +23435,10 @@ 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.
+   * - 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.find_entities_filtered View documentation}
    * @example
@@ -23288,9 +23458,6 @@ interface LuaSurface {
      * Has precedence over area field.
      */
     readonly position?: MapPosition
-    /**
-     * If given with position, will return all entities within the radius of the position.
-     */
     readonly radius?: double
     readonly name?: string | readonly string[]
     readonly type?: string | readonly string[]
@@ -23304,7 +23471,7 @@ interface LuaSurface {
     readonly limit?: uint
     readonly is_military_target?: boolean
     /**
-     * If the filters should be inverted.
+     * Whether the filters should be inverted.
      */
     readonly invert?: boolean
   }): LuaEntity[]
@@ -23328,9 +23495,22 @@ interface LuaSurface {
      */
     readonly radius?: double
     readonly name?: string | readonly string[]
+    readonly force?: ForceIdentification | readonly ForceIdentification[]
     readonly limit?: uint
     readonly has_hidden_tile?: boolean
+    /**
+     * Can be further filtered by supplying a `force` filter.
+     */
+    readonly has_tile_ghost?: boolean
+    /**
+     * Can be further filtered by supplying a `force` filter.
+     */
+    readonly to_be_deconstructed?: boolean
     readonly collision_mask?: CollisionMaskLayer | readonly CollisionMaskLayer[]
+    /**
+     * Whether the filters should be inverted.
+     */
+    readonly invert?: boolean
   }): LuaTile[]
   /**
    * Count entities of given type or name in a given area. Works just like {@link LuaSurface#find_entities_filtered LuaSurface::find_entities_filtered}, except this only returns the count. As it doesn't construct all the wrapper objects, this is more efficient if one is only interested in the number of entities.
@@ -23358,7 +23538,7 @@ interface LuaSurface {
     readonly limit?: uint
     readonly is_military_target?: boolean
     /**
-     * If the filters should be inverted.
+     * Whether the filters should be inverted.
      */
     readonly invert?: boolean
   }): uint
@@ -23380,9 +23560,22 @@ interface LuaSurface {
      */
     readonly radius?: double
     readonly name?: string | readonly string[]
+    readonly force?: ForceIdentification | readonly ForceIdentification[]
     readonly limit?: uint
     readonly has_hidden_tile?: boolean
+    /**
+     * Can be further filtered by supplying a `force` filter.
+     */
+    readonly has_tile_ghost?: boolean
+    /**
+     * Can be further filtered by supplying a `force` filter.
+     */
+    readonly to_be_deconstructed?: boolean
     readonly collision_mask?: CollisionMaskLayer | readonly CollisionMaskLayer[]
+    /**
+     * If the filters should be inverted.
+     */
+    readonly invert?: boolean
   }): uint
   /**
    * Find a non-colliding position within a given radius.
@@ -23931,6 +24124,13 @@ interface LuaSurface {
     readonly area?: BoundingBox
     readonly position?: TilePosition
     readonly name?: string | readonly string[] | LuaDecorativePrototype | readonly LuaDecorativePrototype[]
+    readonly collision_mask?: CollisionMaskLayer | readonly CollisionMaskLayer[]
+    readonly from_layer?: string
+    readonly to_layer?: string
+    /**
+     * Soft decoratives can be drawn over rails.
+     */
+    readonly exclude_soft?: boolean
     readonly limit?: uint
     /**
      * If the filters should be inverted.
@@ -23967,6 +24167,13 @@ interface LuaSurface {
     readonly area?: BoundingBox
     readonly position?: TilePosition
     readonly name?: string | readonly string[] | LuaDecorativePrototype | readonly LuaDecorativePrototype[]
+    readonly collision_mask?: CollisionMaskLayer | readonly CollisionMaskLayer[]
+    readonly from_layer?: string
+    readonly to_layer?: string
+    /**
+     * Soft decoratives can be drawn over rails.
+     */
+    readonly exclude_soft?: boolean
     readonly limit?: uint
     /**
      * If the filters should be inverted.
@@ -24597,7 +24804,7 @@ interface LuaTechnology {
    */
   readonly research_unit_energy: double
   /**
-   * Order string for this prototype.
+   * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
    *
    * {@link https://lua-api.factorio.com/latest/LuaTechnology.html#LuaTechnology.order View documentation}
    */
@@ -24711,7 +24918,7 @@ interface LuaTechnologyPrototype {
    */
   readonly research_unit_energy: double
   /**
-   * Order string for this prototype.
+   * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
    *
    * {@link https://lua-api.factorio.com/latest/LuaTechnologyPrototype.html#LuaTechnologyPrototype.order View documentation}
    */
@@ -24770,8 +24977,9 @@ interface LuaTile {
    * Is this tile marked for deconstruction?
    *
    * {@link https://lua-api.factorio.com/latest/LuaTile.html#LuaTile.to_be_deconstructed View documentation}
+   * @param force The force who did the deconstruction order.
    */
-  to_be_deconstructed(): boolean
+  to_be_deconstructed(force?: ForceIdentification): boolean
   /**
    * Orders deconstruction of this tile by the given force.
    *
@@ -24797,6 +25005,20 @@ interface LuaTile {
    * @param player The player to set the last_user to if any.
    */
   cancel_deconstruction(force: ForceIdentification, player?: PlayerIdentification): void
+  /**
+   * Does this tile have any tile ghosts on it.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaTile.html#LuaTile.has_tile_ghost View documentation}
+   * @param force Check for tile ghosts of this force.
+   */
+  has_tile_ghost(force?: ForceIdentification): boolean
+  /**
+   * Gets all tile ghosts on this tile.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaTile.html#LuaTile.get_tile_ghosts View documentation}
+   * @param force Get tile ghosts of this force.
+   */
+  get_tile_ghosts(force?: ForceIdentification): LuaTile[]
   /**
    * Prototype name of this tile. E.g. `"sand-3"` or `"grass-2"`.
    *
@@ -24850,7 +25072,7 @@ interface LuaTilePrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaTilePrototype.html#LuaTilePrototype.order View documentation}
    */
@@ -24896,11 +25118,11 @@ interface LuaTilePrototype {
     /**
      * Energy required to mine a tile.
      */
-    readonly miningtime: double
+    readonly mining_time: double
     /**
      * Prototype name of the particle produced when mining this tile. Will only be present if this tile produces any particle during mining.
      */
-    readonly miningparticle?: string
+    readonly mining_particle?: string
     /**
      * Products obtained by mining this tile.
      */
@@ -24913,11 +25135,11 @@ interface LuaTilePrototype {
    */
   readonly next_direction: LuaTilePrototype | undefined
   /**
-   * 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaTilePrototype.html#LuaTilePrototype.items_to_place_this View documentation}
    */
-  readonly items_to_place_this: SimpleItemStack[]
+  readonly items_to_place_this: SimpleItemStack[] | undefined
   /**
    * False if this tile is not allowed in blueprints regardless of the ability to build it.
    *
@@ -25465,7 +25687,7 @@ interface LuaTrivialSmokePrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaTrivialSmokePrototype.html#LuaTrivialSmokePrototype.order View documentation}
    */
@@ -25626,7 +25848,7 @@ interface LuaVirtualSignalPrototype {
    */
   readonly 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.
    *
    * {@link https://lua-api.factorio.com/latest/LuaVirtualSignalPrototype.html#LuaVirtualSignalPrototype.order View documentation}
    */