typed-factorio 1.8.1 → 1.10.0

package/{generated → runtime/generated}/classes.d.ts

@@ -204,7 +204,7 @@ interface LuaAutoplaceControlPrototype {
 interface LuaBootstrap {
   /**
    * 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 {@linkplain 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.
-   * @param f The handler for this event. Passing `nil` will unregister it.
+   * @param handler The handler for this event. Passing `nil` will unregister it.
    * @example Initialize a `players` table in `global` for later use.
    *
    * ```
@@ -215,7 +215,7 @@ interface LuaBootstrap {
    * @remarks For more context, refer to the {@linkplain https://lua-api.factorio.com/latest/Data-Lifecycle.html Data Lifecycle} page.
    * @see {@link https://lua-api.factorio.com/latest/LuaBootstrap.html#LuaBootstrap.on_init Online documentation}
    */
-  on_init(f: (() => void) | nil): void
+  on_init(handler: (() => void) | nil): 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} is not available. The {@linkplain 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.
    *
@@ -225,11 +225,11 @@ interface LuaBootstrap {
    * - Create local references to data stored in the {@linkplain 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 {@linkplain https://lua-api.factorio.com/latest/Migrations.html migrations} should be used instead.
-   * @param f The handler for this event. Passing `nil` will unregister it.
+   * @param handler The handler for this event. Passing `nil` will unregister it.
    * @remarks For more context, refer to the {@linkplain https://lua-api.factorio.com/latest/Data-Lifecycle.html Data Lifecycle} page.
    * @see {@link https://lua-api.factorio.com/latest/LuaBootstrap.html#LuaBootstrap.on_load Online documentation}
    */
-  on_load(f: (() => void) | nil): void
+  on_load(handler: (() => void) | nil): void
   /**
    * Register a metatable to have linkage recorded and restored when saving/loading. The metatable itself will not be saved. Instead, only the linkage to a registered metatable is saved, and the metatable registered under that name will be used when loading the table.
    * @param name The name of this metatable. Names must be unique per mod.
@@ -240,15 +240,15 @@ interface LuaBootstrap {
   register_metatable(name: string, metatable: table): void
   /**
    * 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 {@linkplain https://lua-api.factorio.com/latest/Global.html global} table or to the game state through {@link LuaGameScript}.
-   * @param f The handler for this event. Passing `nil` will unregister it.
+   * @param handler The handler for this event. Passing `nil` will unregister it.
    * @remarks For more context, refer to the {@linkplain https://lua-api.factorio.com/latest/Data-Lifecycle.html Data Lifecycle} page.
    * @see {@link https://lua-api.factorio.com/latest/LuaBootstrap.html#LuaBootstrap.on_configuration_changed Online documentation}
    */
-  on_configuration_changed(f: ((arg1: ConfigurationChangedData) => void) | nil): void
+  on_configuration_changed(handler: ((arg1: ConfigurationChangedData) => void) | nil): void
   /**
    * Register a handler to run on the specified event(s). Each mod can only register once for every event, as any additional registration will overwrite the previous one. This holds true even if different filters are used for subsequent registrations.
    * @param event The event(s) or custom-input to invoke the handler on.
-   * @param f The handler for this event. Passing `nil` will unregister it.
+   * @param handler The handler for this event. Passing `nil` will unregister it.
    * @param filters The filters for this event. Can only be used when registering for individual events.
    * @example Register for the {@link OnTickEvent on_tick} event to print the current tick to console each tick.
    *
@@ -275,10 +275,10 @@ interface LuaBootstrap {
   /**
    * Register a handler to run every nth-tick(s). When the game is on tick 0 it will trigger all registered handlers.
    * @param tick The nth-tick(s) to invoke the handler on. Passing `nil` as the only parameter will unregister all nth-tick handlers.
-   * @param f The handler to run. Passing `nil` will unregister it for the provided nth-tick(s).
+   * @param handler The handler to run. Passing `nil` will unregister it for the provided nth-tick(s).
    * @see {@link https://lua-api.factorio.com/latest/LuaBootstrap.html#LuaBootstrap.on_nth_tick Online documentation}
    */
-  on_nth_tick(tick: uint | readonly uint[] | nil, f: ((arg1: NthTickEventData) => void) | nil): void
+  on_nth_tick(tick: uint | readonly uint[] | nil, handler: ((arg1: NthTickEventData) => void) | nil): void
   /**
    * Registers an entity so that after it's destroyed, {@link OnEntityDestroyedEvent on_entity_destroyed} is called. Once an entity is registered, it stays registered until it is actually destroyed, even through save/load cycles. The registration is global across all mods, meaning once one mod registers an entity, all mods listening to {@link OnEntityDestroyedEvent on_entity_destroyed} will receive the event when it is destroyed. Registering the same entity multiple times will still only fire the destruction event once, and will return the same registration number.
    * @param entity The entity to register.
@@ -618,6 +618,10 @@ interface LuaBurner {
  * @noSelf
  */
 interface LuaBurnerPrototype {
+  /**
+   * The emissions of this energy source in `pollution/Joule`. Multiplying it by energy consumption in `Watt` gives `pollution/second`.
+   * @see {@link https://lua-api.factorio.com/latest/LuaBurnerPrototype.html#LuaBurnerPrototype.emissions Online documentation}
+   */
   readonly emissions: double
   readonly render_no_network_icon: boolean
   readonly render_no_power_icon: boolean
@@ -680,7 +684,7 @@ interface LuaBurnerPrototype {
 interface LuaChunkIterator extends LuaIterable<ChunkPositionAndArea> {
   /**
    * Gets the next chunk position if the iterator is not yet done and increments the it.
-   * @see {@link https://lua-api.factorio.com/latest/LuaChunkIterator.html#LuaChunkIterator.operator%20() Online documentation}
+   * @see {@link https://lua-api.factorio.com/latest/LuaChunkIterator.html#LuaChunkIterator.call_operator Online documentation}
    */
   (): ChunkPositionAndArea | nil
   /**
@@ -1182,14 +1186,14 @@ interface LuaControl {
    */
   set_vehicle_logistic_slot(slot_index: uint, value: LogisticParameters): boolean
   /**
-   * Gets the parameters of a personal logistic request and auto-trash slot. Only used on `spider-vehicle`.
+   * Gets the parameters of a personal logistic request and auto-trash slot.
    * @param slot_index The slot to get.
    * @returns The logistic parameters. If personal logistics are not researched yet, their `name` will be `nil`.
    * @see {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.get_personal_logistic_slot Online documentation}
    */
   get_personal_logistic_slot(slot_index: uint): LogisticParameters
   /**
-   * Gets the parameters of a vehicle logistic request and auto-trash slot.
+   * Gets the parameters of a vehicle logistic request and auto-trash slot. Only used on `spider-vehicle`.
    * @param slot_index The slot to get.
    * @returns The logistic parameters. If the vehicle does not use logistics, their `name` will be `nil`.
    * @see {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.get_vehicle_logistic_slot Online documentation}
@@ -1265,7 +1269,7 @@ interface LuaControl {
    *
    * **Raised events:**
    * - {@link OnGuiOpenedEvent on_gui_opened}? _instantly_ Raised when writing a valid GUI target to this attribute.
-   * @remarks Write supports any of the types. Read will return the `entity`, `equipment`, `equipment-grid`, `player`, `element`, `inventory` or `nil`.
+   * @remarks Write supports any of the types. Read will return the `entity`, `equipment`, `equipment-grid`, `player`, `element`, `inventory`, `technology`, or `nil`.
    * @see {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.opened Online documentation}
    */
   set opened(
@@ -1277,10 +1281,19 @@ interface LuaControl {
       | LuaPlayer
       | LuaGuiElement
       | LuaInventory
+      | LuaTechnology
       | defines.gui_type
       | nil
   )
-  get opened(): LuaEntity | LuaEquipment | LuaEquipmentGrid | LuaPlayer | LuaGuiElement | LuaInventory | nil
+  get opened():
+    | LuaEntity
+    | LuaEquipment
+    | LuaEquipmentGrid
+    | LuaPlayer
+    | LuaGuiElement
+    | LuaInventory
+    | LuaTechnology
+    | nil
   /**
    * Size of the crafting queue.
    * @see {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.crafting_queue_size Online documentation}
@@ -1311,7 +1324,7 @@ interface LuaControl {
     readonly direction: defines.direction
   }
   /**
-   * Current riding state of this car or the vehicle this player is riding in.
+   * Current riding state of this car, or of the car this player is riding in.
    * @see {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.riding_state Online documentation}
    */
   riding_state: RidingState
@@ -1733,7 +1746,7 @@ interface LuaCustomInputPrototype {
 type CustomTableIndexer<K extends string | number, V> =
   /**
    * Access an element of this custom table.
-   * @see {@link https://lua-api.factorio.com/latest/LuaCustomTable.html#LuaCustomTable.operator%20[] Online documentation}
+   * @see {@link https://lua-api.factorio.com/latest/LuaCustomTable.html#LuaCustomTable.index_operator Online documentation}
    */
   {
     [P in K]: V
@@ -1745,7 +1758,7 @@ type CustomTableIndexer<K extends string | number, V> =
 interface LuaCustomTableMembers {
   /**
    * Number of elements in this table.
-   * @see {@link https://lua-api.factorio.com/latest/LuaCustomTable.html#LuaCustomTable.operator%20# Online documentation}
+   * @see {@link https://lua-api.factorio.com/latest/LuaCustomTable.html#LuaCustomTable.length_operator Online documentation}
    */
   readonly length: LuaLengthMethod<uint>
   /**
@@ -1920,6 +1933,10 @@ interface LuaElectricEnergySourcePrototype {
   readonly input_flow_limit: double
   readonly output_flow_limit: double
   readonly drain: double
+  /**
+   * The emissions of this energy source in `pollution/Joule`. Multiplying it by energy consumption in `Watt` gives `pollution/second`.
+   * @see {@link https://lua-api.factorio.com/latest/LuaElectricEnergySourcePrototype.html#LuaElectricEnergySourcePrototype.emissions Online documentation}
+   */
   readonly emissions: double
   readonly render_no_network_icon: boolean
   readonly render_no_power_icon: boolean
@@ -1975,7 +1992,7 @@ interface LuaEntity extends LuaControl {
    * _Can only be used if this is EntityWithHealth_
    * @param damage The amount of damage to be done.
    * @param force The force that will be doing the damage.
-   * @param type The type of damage to be done, defaults to "impact".
+   * @param type The type of damage to be done, defaults to "impact". Can't be `nil`.
    * @param dealer The entity to consider as the damage dealer. Needs to be on the same surface as the entity being damaged.
    * @returns the total damage actually applied after resistances.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.damage Online documentation}
@@ -2442,13 +2459,13 @@ interface LuaEntity extends LuaControl {
   /**
    * Set the filter for a slot in an inserter, loader, or logistic storage container.
    * @param slot_index Index of the slot to set the filter for.
-   * @param item Prototype name of the item to filter.
+   * @param item Prototype name of the item to filter, or `nil` to clear the filter.
    * @remarks The entity must allow filters.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_filter Online documentation}
    */
-  set_filter(slot_index: uint, item: string): void
+  set_filter(slot_index: uint, item: string | nil): void
   /**
-   * Gets the filter for this infinity container at the given index or `nil` if the filter index doesn't exist or is empty.
+   * Gets the filter for this infinity container at the given index, or `nil` if the filter index doesn't exist or is empty.
    *
    * _Can only be used if this is InfinityContainer_
    * @param index The index to get.
@@ -2460,12 +2477,12 @@ interface LuaEntity extends LuaControl {
    *
    * _Can only be used if this is InfinityContainer_
    * @param index The index to set.
-   * @param filter The new filter or `nil` to clear the filter.
+   * @param filter The new filter, or `nil` to clear the filter.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_infinity_container_filter Online documentation}
    */
   set_infinity_container_filter(index: uint, filter: InfinityInventoryFilter | nil): void
   /**
-   * Gets the filter for this infinity pipe or `nil` if the filter is empty.
+   * Gets the filter for this infinity pipe, or `nil` if the filter is empty.
    *
    * _Can only be used if this is InfinityPipe_
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.get_infinity_pipe_filter Online documentation}
@@ -2475,7 +2492,7 @@ interface LuaEntity extends LuaControl {
    * Sets the filter for this infinity pipe.
    *
    * _Can only be used if this is InfinityPipe_
-   * @param filter The new filter or `nil` to clear the filter.
+   * @param filter The new filter, or `nil` to clear the filter.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_infinity_pipe_filter Online documentation}
    */
   set_infinity_pipe_filter(filter: InfinityPipeFilter | nil): void
@@ -2645,7 +2662,7 @@ interface LuaEntity extends LuaControl {
   /**
    * Gets the passenger of this car or spidertron if any.
    *
-   * _Can only be used if this is Vehicle_
+   * _Can only be used if this is Car or SpiderVehicle_
    * @returns `nil` if the vehicle contains no passenger. To check if there's a driver see {@link LuaEntity#get_driver LuaEntity::get_driver}.
    * @remarks This differs over {@link LuaEntity#get_driver LuaEntity::get_driver} in that the passenger can't drive the car.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.get_passenger Online documentation}
@@ -2657,7 +2674,7 @@ interface LuaEntity extends LuaControl {
    * **Raised events:**
    * - {@link OnPlayerDrivingChangedStateEvent on_player_driving_changed_state}? _instantly_
    *
-   * _Can only be used if this is Vehicle_
+   * _Can only be used if this is Car or SpiderVehicle_
    * @remarks This differs over {@link LuaEntity#get_driver LuaEntity::get_driver} in that the passenger can't drive the car.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_passenger Online documentation}
    */
@@ -2946,7 +2963,7 @@ interface LuaEntity extends LuaControl {
    */
   get_spider_legs(): LuaEntity[]
   /**
-   * Stops the given SpiderVehicle.
+   * Sets the {@link LuaEntity#speed speed} of the given SpiderVehicle to zero. Notably does not clear its {@link LuaEntity#autopilot_destination autopilot_destination}, which it will continue moving towards if set.
    *
    * _Can only be used if this is SpiderVehicle_
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.stop_spider Online documentation}
@@ -3104,6 +3121,8 @@ interface LuaEntity extends LuaControl {
   friction_modifier: float
   /**
    * Whether the driver of this car or spidertron is the gunner. If `false`, the passenger is the gunner. `nil` if this is neither a car or a spidertron.
+   *
+   * _Can only be used if this is Car or SpiderVehicle_
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.driver_is_gunner Online documentation}
    */
   driver_is_gunner?: boolean
@@ -3176,7 +3195,7 @@ interface LuaEntity extends LuaControl {
   /**
    * Index of the currently selected weapon slot of this character, car, or spidertron. `nil` if this entity doesn't have guns.
    *
-   * _Can only be used if this is Character or Car_
+   * _Can only be used if this is Character, Car or SpiderVehicle_
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.selected_gun_index Online documentation}
    */
   selected_gun_index?: uint
@@ -3590,7 +3609,7 @@ interface LuaEntity extends LuaControl {
    */
   readonly burner?: LuaBurner
   /**
-   * The shooting target for this turret, if any.
+   * The shooting target for this turret, if any. Can't be set to `nil` via script.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.shooting_target Online documentation}
    */
   shooting_target?: LuaEntity
@@ -4303,11 +4322,11 @@ interface BaseEntity extends LuaControl {
   /**
    * Set the filter for a slot in an inserter, loader, or logistic storage container.
    * @param slot_index Index of the slot to set the filter for.
-   * @param item Prototype name of the item to filter.
+   * @param item Prototype name of the item to filter, or `nil` to clear the filter.
    * @remarks The entity must allow filters.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_filter Online documentation}
    */
-  set_filter(slot_index: uint, item: string): void
+  set_filter(slot_index: uint, item: string | nil): void
   /**
    * Gets the control behavior of the entity (if any).
    * @returns The control behavior or `nil`.
@@ -4678,11 +4697,6 @@ interface BaseEntity extends LuaControl {
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.relative_turret_orientation Online documentation}
    */
   relative_turret_orientation?: RealOrientation
-  /**
-   * Whether the driver of this car or spidertron is the gunner. If `false`, the passenger is the gunner. `nil` if this is neither a car or a spidertron.
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.driver_is_gunner Online documentation}
-   */
-  driver_is_gunner?: boolean
   /**
    * The current speed if this is a car, rolling stock, projectile or spidertron, or the maximum speed if this is a unit. The speed is in tiles per tick. `nil` if this is not a car, rolling stock, unit, projectile or spidertron.
    *
@@ -4946,7 +4960,7 @@ interface BaseEntity extends LuaControl {
    */
   readonly burner?: LuaBurner
   /**
-   * The shooting target for this turret, if any.
+   * The shooting target for this turret, if any. Can't be set to `nil` via script.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.shooting_target Online documentation}
    */
   shooting_target?: LuaEntity
@@ -5116,7 +5130,7 @@ interface EntityWithHealthEntity extends BaseEntity {
    * _Can only be used if this is EntityWithHealth_
    * @param damage The amount of damage to be done.
    * @param force The force that will be doing the damage.
-   * @param type The type of damage to be done, defaults to "impact".
+   * @param type The type of damage to be done, defaults to "impact". Can't be `nil`.
    * @param dealer The entity to consider as the damage dealer. Needs to be on the same surface as the entity being damaged.
    * @returns the total damage actually applied after resistances.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.damage Online documentation}
@@ -5589,7 +5603,7 @@ interface RailChainSignalEntity extends BaseEntity {
  */
 interface InfinityContainerEntity extends BaseEntity {
   /**
-   * Gets the filter for this infinity container at the given index or `nil` if the filter index doesn't exist or is empty.
+   * Gets the filter for this infinity container at the given index, or `nil` if the filter index doesn't exist or is empty.
    *
    * _Can only be used if this is InfinityContainer_
    * @param index The index to get.
@@ -5601,7 +5615,7 @@ interface InfinityContainerEntity extends BaseEntity {
    *
    * _Can only be used if this is InfinityContainer_
    * @param index The index to set.
-   * @param filter The new filter or `nil` to clear the filter.
+   * @param filter The new filter, or `nil` to clear the filter.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_infinity_container_filter Online documentation}
    */
   set_infinity_container_filter(index: uint, filter: InfinityInventoryFilter | nil): void
@@ -5626,7 +5640,7 @@ interface InfinityContainerEntity extends BaseEntity {
  */
 interface InfinityPipeEntity extends BaseEntity {
   /**
-   * Gets the filter for this infinity pipe or `nil` if the filter is empty.
+   * Gets the filter for this infinity pipe, or `nil` if the filter is empty.
    *
    * _Can only be used if this is InfinityPipe_
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.get_infinity_pipe_filter Online documentation}
@@ -5636,7 +5650,7 @@ interface InfinityPipeEntity extends BaseEntity {
    * Sets the filter for this infinity pipe.
    *
    * _Can only be used if this is InfinityPipe_
-   * @param filter The new filter or `nil` to clear the filter.
+   * @param filter The new filter, or `nil` to clear the filter.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_infinity_pipe_filter Online documentation}
    */
   set_infinity_pipe_filter(filter: InfinityPipeFilter | nil): void
@@ -5734,9 +5748,22 @@ interface VehicleEntity extends BaseEntity {
    */
   set_driver(driver: LuaEntity | PlayerIdentification | nil): void
   /**
-   * Gets the passenger of this car or spidertron if any.
+   * Whether equipment grid logistics are enabled while this vehicle is moving.
    *
    * _Can only be used if this is Vehicle_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.enable_logistics_while_moving Online documentation}
+   */
+  enable_logistics_while_moving: boolean
+}
+
+/**
+ * @noSelf
+ */
+interface CarEntity extends BaseEntity {
+  /**
+   * Gets the passenger of this car or spidertron if any.
+   *
+   * _Can only be used if this is Car or SpiderVehicle_
    * @returns `nil` if the vehicle contains no passenger. To check if there's a driver see {@link LuaEntity#get_driver LuaEntity::get_driver}.
    * @remarks This differs over {@link LuaEntity#get_driver LuaEntity::get_driver} in that the passenger can't drive the car.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.get_passenger Online documentation}
@@ -5748,18 +5775,156 @@ interface VehicleEntity extends BaseEntity {
    * **Raised events:**
    * - {@link OnPlayerDrivingChangedStateEvent on_player_driving_changed_state}? _instantly_
    *
-   * _Can only be used if this is Vehicle_
+   * _Can only be used if this is Car or SpiderVehicle_
    * @remarks This differs over {@link LuaEntity#get_driver LuaEntity::get_driver} in that the passenger can't drive the car.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_passenger Online documentation}
    */
   set_passenger(passenger: LuaEntity | PlayerIdentification): void
   /**
-   * Whether equipment grid logistics are enabled while this vehicle is moving.
+   * Multiplies the acceleration the vehicle can create for one unit of energy. Defaults to `1`.
    *
-   * _Can only be used if this is Vehicle_
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.enable_logistics_while_moving Online documentation}
+   * _Can only be used if this is Car_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.effectivity_modifier Online documentation}
    */
-  enable_logistics_while_moving: boolean
+  effectivity_modifier: float
+  /**
+   * Multiplies the energy consumption.
+   *
+   * _Can only be used if this is Car_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.consumption_modifier Online documentation}
+   */
+  consumption_modifier: float
+  /**
+   * Multiplies the car friction rate.
+   *
+   * _Can only be used if this is Car_
+   * @example This will allow the car to go much faster
+   *
+   * ```
+   * game.player.vehicle.friction_modifier = 0.5
+   * ```
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.friction_modifier Online documentation}
+   */
+  friction_modifier: float
+  /**
+   * Whether the driver of this car or spidertron is the gunner. If `false`, the passenger is the gunner. `nil` if this is neither a car or a spidertron.
+   *
+   * _Can only be used if this is Car or SpiderVehicle_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.driver_is_gunner Online documentation}
+   */
+  driver_is_gunner?: boolean
+  /**
+   * Index of the currently selected weapon slot of this character, car, or spidertron. `nil` if this entity doesn't have guns.
+   *
+   * _Can only be used if this is Character, Car or SpiderVehicle_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.selected_gun_index Online documentation}
+   */
+  selected_gun_index?: uint
+}
+
+/**
+ * @noSelf
+ */
+interface SpiderVehicleEntity extends BaseEntity {
+  /**
+   * Gets the passenger of this car or spidertron if any.
+   *
+   * _Can only be used if this is Car or SpiderVehicle_
+   * @returns `nil` if the vehicle contains no passenger. To check if there's a driver see {@link LuaEntity#get_driver LuaEntity::get_driver}.
+   * @remarks This differs over {@link LuaEntity#get_driver LuaEntity::get_driver} in that the passenger can't drive the car.
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.get_passenger Online documentation}
+   */
+  get_passenger(): LuaEntity | LuaPlayer | nil
+  /**
+   * 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 Car or SpiderVehicle_
+   * @remarks This differs over {@link LuaEntity#get_driver LuaEntity::get_driver} in that the passenger can't drive the car.
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.set_passenger Online documentation}
+   */
+  set_passenger(passenger: LuaEntity | PlayerIdentification): void
+  /**
+   * Adds the given position to this spidertron's autopilot's queue of destinations.
+   *
+   * _Can only be used if this is SpiderVehicle_
+   * @param position The position the spidertron should move to.
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.add_autopilot_destination Online documentation}
+   */
+  add_autopilot_destination(position: MapPosition | MapPositionArray): void
+  /**
+   * Gets legs of given SpiderVehicle.
+   *
+   * _Can only be used if this is SpiderVehicle_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.get_spider_legs Online documentation}
+   */
+  get_spider_legs(): LuaEntity[]
+  /**
+   * Sets the {@link LuaEntity#speed speed} of the given SpiderVehicle to zero. Notably does not clear its {@link LuaEntity#autopilot_destination autopilot_destination}, which it will continue moving towards if set.
+   *
+   * _Can only be used if this is SpiderVehicle_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.stop_spider Online documentation}
+   */
+  stop_spider(): void
+  /**
+   * The torso orientation of this spider vehicle.
+   *
+   * _Can only be used if this is SpiderVehicle_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.torso_orientation Online documentation}
+   */
+  torso_orientation: RealOrientation
+  /**
+   * Whether the driver of this car or spidertron is the gunner. If `false`, the passenger is the gunner. `nil` if this is neither a car or a spidertron.
+   *
+   * _Can only be used if this is Car or SpiderVehicle_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.driver_is_gunner Online documentation}
+   */
+  driver_is_gunner?: boolean
+  /**
+   * Read when this spidertron auto-targets enemies
+   *
+   * _Can only be used if this is SpiderVehicle_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.vehicle_automatic_targeting_parameters Online documentation}
+   */
+  vehicle_automatic_targeting_parameters: VehicleAutomaticTargetingParameters
+  /**
+   * Index of the currently selected weapon slot of this character, car, or spidertron. `nil` if this entity doesn't have guns.
+   *
+   * _Can only be used if this is Character, Car or SpiderVehicle_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.selected_gun_index Online documentation}
+   */
+  selected_gun_index?: uint
+  /**
+   * Destination of this spidertron's autopilot, if any.
+   *
+   * _Can only be used if this is SpiderVehicle_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.autopilot_destination Online documentation}
+   */
+  get autopilot_destination(): MapPosition | nil
+  set autopilot_destination(value: MapPosition | MapPositionArray | nil)
+  /**
+   * The queued destination positions of spidertron's autopilot.
+   *
+   * _Can only be used if this is SpiderVehicle_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.autopilot_destinations Online documentation}
+   */
+  readonly autopilot_destinations: MapPosition[]
+  /**
+   * The follow target of this spidertron, if any.
+   *
+   * _Can only be used if this is SpiderVehicle_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.follow_target Online documentation}
+   */
+  follow_target?: LuaEntity
+  /**
+   * The follow offset of this spidertron, if any entity is being followed. This is randomized each time the follow entity is set.
+   *
+   * _Can only be used if this is SpiderVehicle_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.follow_offset Online documentation}
+   */
+  follow_offset?: Vector
 }
 
 /**
@@ -5877,77 +6042,6 @@ interface ResourceEntity extends BaseEntity {
   initial_amount?: uint
 }
 
-/**
- * @noSelf
- */
-interface SpiderVehicleEntity extends BaseEntity {
-  /**
-   * Adds the given position to this spidertron's autopilot's queue of destinations.
-   *
-   * _Can only be used if this is SpiderVehicle_
-   * @param position The position the spidertron should move to.
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.add_autopilot_destination Online documentation}
-   */
-  add_autopilot_destination(position: MapPosition | MapPositionArray): void
-  /**
-   * Gets legs of given SpiderVehicle.
-   *
-   * _Can only be used if this is SpiderVehicle_
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.get_spider_legs Online documentation}
-   */
-  get_spider_legs(): LuaEntity[]
-  /**
-   * Stops the given SpiderVehicle.
-   *
-   * _Can only be used if this is SpiderVehicle_
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.stop_spider Online documentation}
-   */
-  stop_spider(): void
-  /**
-   * The torso orientation of this spider vehicle.
-   *
-   * _Can only be used if this is SpiderVehicle_
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.torso_orientation Online documentation}
-   */
-  torso_orientation: RealOrientation
-  /**
-   * Read when this spidertron auto-targets enemies
-   *
-   * _Can only be used if this is SpiderVehicle_
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.vehicle_automatic_targeting_parameters Online documentation}
-   */
-  vehicle_automatic_targeting_parameters: VehicleAutomaticTargetingParameters
-  /**
-   * Destination of this spidertron's autopilot, if any.
-   *
-   * _Can only be used if this is SpiderVehicle_
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.autopilot_destination Online documentation}
-   */
-  get autopilot_destination(): MapPosition | nil
-  set autopilot_destination(value: MapPosition | MapPositionArray | nil)
-  /**
-   * The queued destination positions of spidertron's autopilot.
-   *
-   * _Can only be used if this is SpiderVehicle_
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.autopilot_destinations Online documentation}
-   */
-  readonly autopilot_destinations: MapPosition[]
-  /**
-   * The follow target of this spidertron, if any.
-   *
-   * _Can only be used if this is SpiderVehicle_
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.follow_target Online documentation}
-   */
-  follow_target?: LuaEntity
-  /**
-   * The follow offset of this spidertron, if any entity is being followed. This is randomized each time the follow entity is set.
-   *
-   * _Can only be used if this is SpiderVehicle_
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.follow_offset Online documentation}
-   */
-  follow_offset?: Vector
-}
-
 /**
  * @noSelf
  */
@@ -6025,42 +6119,6 @@ interface GhostEntity extends BaseEntity {
   readonly ghost_prototype: LuaEntityPrototype | LuaTilePrototype
 }
 
-interface CarEntity extends BaseEntity {
-  /**
-   * Multiplies the acceleration the vehicle can create for one unit of energy. Defaults to `1`.
-   *
-   * _Can only be used if this is Car_
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.effectivity_modifier Online documentation}
-   */
-  effectivity_modifier: float
-  /**
-   * Multiplies the energy consumption.
-   *
-   * _Can only be used if this is Car_
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.consumption_modifier Online documentation}
-   */
-  consumption_modifier: float
-  /**
-   * Multiplies the car friction rate.
-   *
-   * _Can only be used if this is Car_
-   * @example This will allow the car to go much faster
-   *
-   * ```
-   * game.player.vehicle.friction_modifier = 0.5
-   * ```
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.friction_modifier Online documentation}
-   */
-  friction_modifier: float
-  /**
-   * Index of the currently selected weapon slot of this character, car, or spidertron. `nil` if this entity doesn't have guns.
-   *
-   * _Can only be used if this is Character or Car_
-   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.selected_gun_index Online documentation}
-   */
-  selected_gun_index?: uint
-}
-
 interface ItemEntity extends BaseEntity {
   /**
    * _Can only be used if this is ItemEntity_
@@ -6120,7 +6178,7 @@ interface CharacterEntity extends BaseEntity {
   /**
    * Index of the currently selected weapon slot of this character, car, or spidertron. `nil` if this entity doesn't have guns.
    *
-   * _Can only be used if this is Character or Car_
+   * _Can only be used if this is Character, Car or SpiderVehicle_
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.selected_gun_index Online documentation}
    */
   selected_gun_index?: uint
@@ -7351,6 +7409,13 @@ interface LuaEntityPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.create_ghost_on_death Online documentation}
    */
   readonly create_ghost_on_death: boolean
+  /**
+   * Name of the ammo category of this land mine.
+   *
+   * _Can only be used if this is LandMine_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.ammo_category Online documentation}
+   */
+  readonly ammo_category?: string
   /**
    * The time it takes this land mine to arm.
    *
@@ -7390,6 +7455,53 @@ interface LuaEntityPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.belt_length Online documentation}
    */
   readonly belt_length?: double
+  /**
+   * Everything in the following list is considered a building.
+   *
+   * - AccumulatorPrototype
+   * - ArtilleryTurretPrototype
+   * - BeaconPrototype
+   * - BoilerPrototype
+   * - BurnerGeneratorPrototype
+   * - CombinatorPrototype → ArithmeticCombinator, DeciderCombinator
+   * - ConstantCombinatorPrototype
+   * - ContainerPrototype → LogisticContainer, InfinityContainer
+   * - CraftingMachinePrototype → AssemblingMachine, RocketSilo, Furnace
+   * - ElectricEnergyInterfacePrototype
+   * - ElectricPolePrototype
+   * - EnemySpawnerPrototype
+   * - GatePrototype
+   * - GeneratorPrototype
+   * - HeatInterfacePrototype
+   * - HeatPipePrototype
+   * - InserterPrototype
+   * - LabPrototype
+   * - LampPrototype
+   * - LinkedContainerPrototype
+   * - MarketPrototype
+   * - MiningDrillPrototype
+   * - OffshorePumpPrototype
+   * - PipePrototype → InfinityPipe
+   * - PipeToGroundPrototype
+   * - PlayerPortPrototype
+   * - PowerSwitchPrototype
+   * - ProgrammableSpeakerPrototype
+   * - PumpPrototype
+   * - RadarPrototype
+   * - RailPrototype → CurvedRail, StraightRail
+   * - RailSignalBasePrototype → RailChainSignal, RailSignal
+   * - ReactorPrototype
+   * - RoboportPrototype
+   * - SimpleEntityPrototype
+   * - SimpleEntityWithOwnerPrototype → SimpleEntityWithForce
+   * - SolarPanelPrototype
+   * - StorageTankPrototype
+   * - TrainStopPrototype
+   * - TransportBeltConnectablePrototype → LinkedBelt, Loader1x1, Loader1x2, Splitter, TransportBelt, UndergroundBelt
+   * - TurretPrototype → AmmoTurret, ElectricTurret, FluidTurret
+   * - WallPrototype
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.is_building Online documentation}
+   */
   readonly is_building: boolean
   /**
    * The amount of ammo that inserters automatically insert into this ammo-turret or artillery-turret.
@@ -8288,6 +8400,53 @@ interface BaseEntityPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.fluidbox_prototypes Online documentation}
    */
   readonly fluidbox_prototypes: LuaFluidBoxPrototype[]
+  /**
+   * Everything in the following list is considered a building.
+   *
+   * - AccumulatorPrototype
+   * - ArtilleryTurretPrototype
+   * - BeaconPrototype
+   * - BoilerPrototype
+   * - BurnerGeneratorPrototype
+   * - CombinatorPrototype → ArithmeticCombinator, DeciderCombinator
+   * - ConstantCombinatorPrototype
+   * - ContainerPrototype → LogisticContainer, InfinityContainer
+   * - CraftingMachinePrototype → AssemblingMachine, RocketSilo, Furnace
+   * - ElectricEnergyInterfacePrototype
+   * - ElectricPolePrototype
+   * - EnemySpawnerPrototype
+   * - GatePrototype
+   * - GeneratorPrototype
+   * - HeatInterfacePrototype
+   * - HeatPipePrototype
+   * - InserterPrototype
+   * - LabPrototype
+   * - LampPrototype
+   * - LinkedContainerPrototype
+   * - MarketPrototype
+   * - MiningDrillPrototype
+   * - OffshorePumpPrototype
+   * - PipePrototype → InfinityPipe
+   * - PipeToGroundPrototype
+   * - PlayerPortPrototype
+   * - PowerSwitchPrototype
+   * - ProgrammableSpeakerPrototype
+   * - PumpPrototype
+   * - RadarPrototype
+   * - RailPrototype → CurvedRail, StraightRail
+   * - RailSignalBasePrototype → RailChainSignal, RailSignal
+   * - ReactorPrototype
+   * - RoboportPrototype
+   * - SimpleEntityPrototype
+   * - SimpleEntityWithOwnerPrototype → SimpleEntityWithForce
+   * - SolarPanelPrototype
+   * - StorageTankPrototype
+   * - TrainStopPrototype
+   * - TransportBeltConnectablePrototype → LinkedBelt, Loader1x1, Loader1x2, Splitter, TransportBelt, UndergroundBelt
+   * - TurretPrototype → AmmoTurret, ElectricTurret, FluidTurret
+   * - WallPrototype
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.is_building Online documentation}
+   */
   readonly is_building: boolean
   /**
    * The radius of this entity prototype.
@@ -9553,6 +9712,13 @@ interface RoboportEntityPrototype extends BaseEntityPrototype {
 }
 
 interface LandMineEntityPrototype extends BaseEntityPrototype {
+  /**
+   * Name of the ammo category of this land mine.
+   *
+   * _Can only be used if this is LandMine_
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.ammo_category Online documentation}
+   */
+  readonly ammo_category?: string
   /**
    * The time it takes this land mine to arm.
    *
@@ -10139,10 +10305,12 @@ interface LuaEquipmentPrototype {
   readonly energy_per_shield: double
   /**
    * The logistic parameters for this roboport equipment.
+   *
+   * _Can only be used if this is RoboportEquipment_
    * @remarks Both the `charging_station_shift` and `stationing_offset` vectors are tables with `x` and `y` keys instead of an array.
    * @see {@link https://lua-api.factorio.com/latest/LuaEquipmentPrototype.html#LuaEquipmentPrototype.logistic_parameters Online documentation}
    */
-  readonly logistic_parameters: {
+  readonly logistic_parameters?: {
     readonly spawn_and_station_height: float
     readonly spawn_and_station_shadow_height_offset: float
     readonly charge_approach_distance: float
@@ -10161,10 +10329,10 @@ interface LuaEquipmentPrototype {
   }
   readonly energy_consumption: double
   /**
-   * _Can only be used if this is MovementBonusEquipmentPrototype_
+   * _Can only be used if this is MovementBonusEquipment_
    * @see {@link https://lua-api.factorio.com/latest/LuaEquipmentPrototype.html#LuaEquipmentPrototype.movement_bonus Online documentation}
    */
-  readonly movement_bonus: float
+  readonly movement_bonus?: float
   /**
    * The energy source prototype for the equipment.
    * @see {@link https://lua-api.factorio.com/latest/LuaEquipmentPrototype.html#LuaEquipmentPrototype.energy_source Online documentation}
@@ -10269,28 +10437,6 @@ interface BaseEquipmentPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaEquipmentPrototype.html#LuaEquipmentPrototype.energy_per_shield Online documentation}
    */
   readonly energy_per_shield: double
-  /**
-   * The logistic parameters for this roboport equipment.
-   * @remarks Both the `charging_station_shift` and `stationing_offset` vectors are tables with `x` and `y` keys instead of an array.
-   * @see {@link https://lua-api.factorio.com/latest/LuaEquipmentPrototype.html#LuaEquipmentPrototype.logistic_parameters Online documentation}
-   */
-  readonly logistic_parameters: {
-    readonly spawn_and_station_height: float
-    readonly spawn_and_station_shadow_height_offset: float
-    readonly charge_approach_distance: float
-    readonly logistic_radius: float
-    readonly construction_radius: float
-    readonly charging_station_count: uint
-    readonly charging_distance: float
-    readonly charging_station_shift: Vector
-    readonly charging_energy: double
-    readonly charging_threshold_distance: float
-    readonly robot_vertical_acceleration: float
-    readonly stationing_offset: Vector
-    readonly robot_limit: uint
-    readonly logistics_connection_distance: float
-    readonly robots_shrink_when_entering_and_exiting: boolean
-  }
   readonly energy_consumption: double
   /**
    * The energy source prototype for the equipment.
@@ -10336,12 +10482,39 @@ interface BaseEquipmentPrototype {
   help(): string
 }
 
+interface RoboportEquipmentPrototype extends BaseEquipmentPrototype {
+  /**
+   * The logistic parameters for this roboport equipment.
+   *
+   * _Can only be used if this is RoboportEquipment_
+   * @remarks Both the `charging_station_shift` and `stationing_offset` vectors are tables with `x` and `y` keys instead of an array.
+   * @see {@link https://lua-api.factorio.com/latest/LuaEquipmentPrototype.html#LuaEquipmentPrototype.logistic_parameters Online documentation}
+   */
+  readonly logistic_parameters?: {
+    readonly spawn_and_station_height: float
+    readonly spawn_and_station_shadow_height_offset: float
+    readonly charge_approach_distance: float
+    readonly logistic_radius: float
+    readonly construction_radius: float
+    readonly charging_station_count: uint
+    readonly charging_distance: float
+    readonly charging_station_shift: Vector
+    readonly charging_energy: double
+    readonly charging_threshold_distance: float
+    readonly robot_vertical_acceleration: float
+    readonly stationing_offset: Vector
+    readonly robot_limit: uint
+    readonly logistics_connection_distance: float
+    readonly robots_shrink_when_entering_and_exiting: boolean
+  }
+}
+
 interface MovementBonusEquipmentPrototype extends BaseEquipmentPrototype {
   /**
-   * _Can only be used if this is MovementBonusEquipmentPrototype_
+   * _Can only be used if this is MovementBonusEquipment_
    * @see {@link https://lua-api.factorio.com/latest/LuaEquipmentPrototype.html#LuaEquipmentPrototype.movement_bonus Online documentation}
    */
-  readonly movement_bonus: float
+  readonly movement_bonus?: float
 }
 
 interface ActiveDefenseEquipmentPrototype extends BaseEquipmentPrototype {
@@ -10507,7 +10680,7 @@ interface LuaFluidBox extends Array<Fluid | nil> {
    * @remarks Some entities cannot have their fluidbox filter set, notably fluid wagons and crafting machines.
    * @see {@link https://lua-api.factorio.com/latest/LuaFluidBox.html#LuaFluidBox.set_filter Online documentation}
    */
-  set_filter(index: uint, filter?: FluidBoxFilterSpec): boolean
+  set_filter(index: uint, filter: FluidBoxFilterSpec | nil): boolean
   /**
    * Flow through the fluidbox in the last tick. It is the larger of in-flow and out-flow.
    * @remarks Fluid wagons do not track it and will return 0.
@@ -10534,14 +10707,14 @@ interface LuaFluidBox extends Array<Fluid | nil> {
   flush(index: uint, fluid?: FluidIdentification): Record<string, float>
   /**
    * Number of fluid boxes.
-   * @see {@link https://lua-api.factorio.com/latest/LuaFluidBox.html#LuaFluidBox.operator%20# Online documentation}
+   * @see {@link https://lua-api.factorio.com/latest/LuaFluidBox.html#LuaFluidBox.length_operator Online documentation}
    */
   readonly length: uint
   /**
-   * Access, set or clear a fluid box. The index must always be in bounds (see {@link LuaFluidBox#index LuaFluidBox::index}). New fluidboxes may not be added or removed using this operator.
+   * Access, set or clear a fluid box. The index must always be in bounds (see {@link LuaFluidBox#length LuaFluidBox::length_operator}). New fluidboxes may not be added or removed using this operator.
    *
    * Is `nil` if the given fluid box does not contain any fluid. Writing `nil` removes all fluid from the fluid box.
-   * @see {@link https://lua-api.factorio.com/latest/LuaFluidBox.html#LuaFluidBox.operator%20[] Online documentation}
+   * @see {@link https://lua-api.factorio.com/latest/LuaFluidBox.html#LuaFluidBox.index_operator Online documentation}
    */
   [index: number]: Fluid | nil
   /**
@@ -10638,6 +10811,10 @@ interface LuaFluidBoxPrototype {
  * @noSelf
  */
 interface LuaFluidEnergySourcePrototype {
+  /**
+   * The emissions of this energy source in `pollution/Joule`. Multiplying it by energy consumption in `Watt` gives `pollution/second`.
+   * @see {@link https://lua-api.factorio.com/latest/LuaFluidEnergySourcePrototype.html#LuaFluidEnergySourcePrototype.emissions Online documentation}
+   */
   readonly emissions: double
   readonly render_no_network_icon: boolean
   readonly render_no_power_icon: boolean
@@ -11018,7 +11195,7 @@ interface LuaForce {
    */
   print(message: LocalisedString, color?: Color | ColorArray): void
   /**
-   * @param surface If given only trains on the surface are returned.
+   * @param surface The surface to search. Not providing a surface will match trains on any surface.
    * @see {@link https://lua-api.factorio.com/latest/LuaForce.html#LuaForce.get_trains Online documentation}
    */
   get_trains(surface?: SurfaceIdentification): LuaTrain[]
@@ -11084,7 +11261,13 @@ interface LuaForce {
    * @see {@link https://lua-api.factorio.com/latest/LuaForce.html#LuaForce.get_train_stops Online documentation}
    */
   get_train_stops(params?: {
+    /**
+     * The name(s) of the train stops. Not providing names will match any stop.
+     */
     readonly name?: string | readonly string[]
+    /**
+     * The surface to search. Not providing a surface will match stops on any surface.
+     */
     readonly surface?: SurfaceIdentification
   }): LuaEntity[]
   /**
@@ -11443,15 +11626,15 @@ interface LuaFuelCategoryPrototype {
  */
 interface LuaGameScript {
   /**
-   * Set scenario state.
+   * Set scenario state. Any parameters not provided do not change the current state.
    * @see {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.set_game_state Online documentation}
    */
   set_game_state(params: {
-    readonly game_finished: boolean
-    readonly player_won: boolean
-    readonly next_level: string
-    readonly can_continue: boolean
-    readonly victorious_force: ForceIdentification
+    readonly game_finished?: boolean
+    readonly player_won?: boolean
+    readonly next_level?: string
+    readonly can_continue?: boolean
+    readonly victorious_force?: ForceIdentification
   }): void
   /**
    * Reset scenario state (game_finished, player_won, etc.).
@@ -11682,14 +11865,14 @@ interface LuaGameScript {
    */
   create_force(force: string): LuaForce
   /**
-   * Marks two forces to be merged together. All entities in the source force will be reassigned to the target force. The source force will then be destroyed.
+   * Marks two forces to be merged together. All players and entities in the source force will be reassigned to the target force. The source force will then be destroyed. Importantly, this does not merge technologies or bonuses, which are instead retained from the target force.
    *
    * **Raised events:**
    * - {@link OnForcesMergingEvent on_forces_merging} _future_tick_
    * - {@link OnForcesMergedEvent on_forces_merged} _future_tick_
    * @param source The force to remove.
    * @param destination The force to reassign all entities to.
-   * @remarks The three built-in forces -- player, enemy and neutral -- can't be destroyed. I.e. they can't be used as the source argument to this function.<br>The source force is not removed until the end of the current tick, or if called during the {@link OnForcesMergingEvent on_forces_merging} or {@link OnForcesMergedEvent on_forces_merged} event, the end of the next tick.
+   * @remarks The three built-in forces (player, enemy and neutral) can't be destroyed, meaning they can't be used as the source argument to this function.<br>The source force is not removed until the end of the current tick, or if called during the {@link OnForcesMergingEvent on_forces_merging} or {@link OnForcesMergedEvent on_forces_merged} event, the end of the next tick.
    * @see {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.merge_forces Online documentation}
    */
   merge_forces(source: ForceIdentification, destination: ForceIdentification): void
@@ -11868,7 +12051,7 @@ interface LuaGameScript {
   is_multiplayer(): boolean
   /**
    * Gets the number of entities that are active (updated each tick).
-   * @param surface If give, only the entities active on this surface are counted.
+   * @param surface If given, only the entities active on this surface are counted.
    * @remarks This is very expensive to determine.
    * @see {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.get_active_entities_count Online documentation}
    */
@@ -11888,8 +12071,17 @@ interface LuaGameScript {
    * @see {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.get_train_stops Online documentation}
    */
   get_train_stops(params?: {
+    /**
+     * The name(s) of the train stops. Not providing names will match any stop.
+     */
     readonly name?: string | readonly string[]
+    /**
+     * The surface to search. Not providing a surface will match stops on any surface.
+     */
     readonly surface?: SurfaceIdentification
+    /**
+     * The force to search. Not providing a force will match stops in any force.
+     */
     readonly force?: ForceIdentification
   }): LuaEntity[]
   /**
@@ -12454,17 +12646,15 @@ interface LuaGroup {
    */
   readonly group?: LuaGroup
   /**
-   * Subgroups of this group.
-   * @remarks Can only be used on groups, not on subgroups.
+   * Subgroups of this group. Can only be used on groups, not on subgroups.
    * @see {@link https://lua-api.factorio.com/latest/LuaGroup.html#LuaGroup.subgroups Online documentation}
    */
-  readonly subgroups: LuaGroup[]
+  readonly subgroups?: LuaGroup[]
   /**
-   * The additional order value used in recipe ordering.
-   * @remarks Can only be used on groups, not on subgroups.
+   * The additional order value used in recipe ordering. Can only be used on groups, not on subgroups.
    * @see {@link https://lua-api.factorio.com/latest/LuaGroup.html#LuaGroup.order_in_recipe Online documentation}
    */
-  readonly order_in_recipe: string
+  readonly order_in_recipe?: string
   /**
    * The string used to alphabetically sort these prototypes. It is a simple string that has no additional semantic meaning.
    * @see {@link https://lua-api.factorio.com/latest/LuaGroup.html#LuaGroup.order Online documentation}
@@ -12613,7 +12803,7 @@ interface BaseGuiSpec {
    */
   readonly ignored_by_interaction?: boolean
   /**
-   * Style of the child element.
+   * The name of the style prototype to apply to the new element.
    */
   readonly style?: string
   /**
@@ -13143,7 +13333,7 @@ type GuiSpec =
 interface GuiElementIndexer {
   /**
    * The indexing operator. Gets children by name.
-   * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.operator%20[] Online documentation}
+   * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.index_operator Online documentation}
    */
   readonly [name: string]: LuaGuiElement | nil
 }
@@ -13412,17 +13602,23 @@ interface DropDownGuiElementMembers extends BaseGuiElement {
   readonly type: "drop-down"
   /**
    * Removes the items in this dropdown or listbox.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.clear_items Online documentation}
    */
   clear_items(): void
   /**
    * Gets the item at the given index from this dropdown or listbox.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @param index The index to get
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.get_item Online documentation}
    */
   get_item(index: uint): LocalisedString
   /**
    * Sets the given string at the given index in this dropdown or listbox.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @param index The index whose text to replace.
    * @param string The text to set at the given index.
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.set_item Online documentation}
@@ -13430,6 +13626,8 @@ interface DropDownGuiElementMembers extends BaseGuiElement {
   set_item(index: uint, string: LocalisedString): void
   /**
    * Inserts a string at the end or at the given index of this dropdown or listbox.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @param string The text to insert.
    * @param index The index at which to insert the item.
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.add_item Online documentation}
@@ -13437,17 +13635,28 @@ interface DropDownGuiElementMembers extends BaseGuiElement {
   add_item(string: LocalisedString, index?: uint): void
   /**
    * Removes the item at the given index from this dropdown or listbox.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @param index The index
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.remove_item Online documentation}
    */
   remove_item(index: uint): void
+  /**
+   * Closes the dropdown list if this is a dropdown and it is open.
+   * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.close_dropdown Online documentation}
+   */
+  close_dropdown(): void
   /**
    * The items in this dropdown or listbox.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.items Online documentation}
    */
   items: LocalisedString[]
   /**
    * The selected index for this dropdown or listbox. Returns `0` if none is selected.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.selected_index Online documentation}
    */
   selected_index: uint
@@ -13489,6 +13698,8 @@ interface EntityPreviewGuiElementMembers extends BaseGuiElement {
   readonly type: "entity-preview"
   /**
    * The entity associated with this entity-preview, camera, minimap, if any.
+   *
+   * _Can only be used if this is entity-preview, camera or minimap_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.entity Online documentation}
    */
   entity: LuaEntity
@@ -13507,17 +13718,23 @@ interface ListBoxGuiElementMembers extends BaseGuiElement {
   readonly type: "list-box"
   /**
    * Removes the items in this dropdown or listbox.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.clear_items Online documentation}
    */
   clear_items(): void
   /**
    * Gets the item at the given index from this dropdown or listbox.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @param index The index to get
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.get_item Online documentation}
    */
   get_item(index: uint): LocalisedString
   /**
    * Sets the given string at the given index in this dropdown or listbox.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @param index The index whose text to replace.
    * @param string The text to set at the given index.
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.set_item Online documentation}
@@ -13525,6 +13742,8 @@ interface ListBoxGuiElementMembers extends BaseGuiElement {
   set_item(index: uint, string: LocalisedString): void
   /**
    * Inserts a string at the end or at the given index of this dropdown or listbox.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @param string The text to insert.
    * @param index The index at which to insert the item.
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.add_item Online documentation}
@@ -13532,6 +13751,8 @@ interface ListBoxGuiElementMembers extends BaseGuiElement {
   add_item(string: LocalisedString, index?: uint): void
   /**
    * Removes the item at the given index from this dropdown or listbox.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @param index The index
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.remove_item Online documentation}
    */
@@ -13547,11 +13768,15 @@ interface ListBoxGuiElementMembers extends BaseGuiElement {
   scroll_to_item(index: int, scroll_mode?: "in-view" | "top-third"): void
   /**
    * The items in this dropdown or listbox.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.items Online documentation}
    */
   items: LocalisedString[]
   /**
    * The selected index for this dropdown or listbox. Returns `0` if none is selected.
+   *
+   * _Can only be used if this is drop-down or list-box_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.selected_index Online documentation}
    */
   selected_index: uint
@@ -13630,34 +13855,44 @@ interface SpriteButtonGuiElementMembers extends BaseGuiElement {
    */
   readonly type: "sprite-button"
   /**
-   * The image to display on this sprite-button or sprite in the default state.
+   * The sprite to display on this sprite-button or sprite in the default state.
+   *
+   * _Can only be used if this is sprite-button or sprite_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.sprite Online documentation}
    */
   sprite: SpritePath
   /**
-   * The image to display on this sprite-button when it is hovered.
+   * The sprite to display on this sprite-button when it is hovered.
    *
    * _Can only be used if this is sprite-button_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.hovered_sprite Online documentation}
    */
   hovered_sprite: SpritePath
   /**
-   * The image to display on this sprite-button when it is clicked.
+   * The sprite to display on this sprite-button when it is clicked.
+   *
+   * _Can only be used if this is sprite-button_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.clicked_sprite Online documentation}
    */
   clicked_sprite: SpritePath
   /**
    * The number to be shown in the bottom right corner of this sprite-button. Set this to `nil` to show nothing.
+   *
+   * _Can only be used if this is sprite-button_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.number Online documentation}
    */
   number: double | nil
   /**
    * Related to the number to be shown in the bottom right corner of this sprite-button. When set to `true`, numbers that are non-zero and smaller than one are shown as a percentage rather than the value. For example, `0.5` will be shown as `50%` instead.
+   *
+   * _Can only be used if this is sprite-button_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.show_percent_for_small_numbers Online documentation}
    */
   show_percent_for_small_numbers: boolean
   /**
    * The mouse button filters for this button or sprite-button.
+   *
+   * _Can only be used if this is button or sprite-button_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.mouse_button_filter Online documentation}
    */
   get mouse_button_filter(): MouseButtonFlags
@@ -13702,6 +13937,8 @@ interface TabbedPaneGuiElementMembers extends BaseGuiElement {
   selected_tab_index?: uint
   /**
    * The tabs and contents being shown in this tabbed-pane.
+   *
+   * _Can only be used if this is tabbed-pane_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.tabs Online documentation}
    */
   readonly tabs: TabAndContent[]
@@ -13819,6 +14056,8 @@ interface ButtonGuiElementMembers extends BaseGuiElement {
   readonly type: "button"
   /**
    * The mouse button filters for this button or sprite-button.
+   *
+   * _Can only be used if this is button or sprite-button_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.mouse_button_filter Online documentation}
    */
   get mouse_button_filter(): MouseButtonFlags
@@ -13835,22 +14074,30 @@ interface CameraGuiElementMembers extends BaseGuiElement {
   readonly type: "camera"
   /**
    * The position this camera or minimap is focused on, if any.
+   *
+   * _Can only be used if this is camera or minimap_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.position Online documentation}
    */
   get position(): MapPosition
   set position(value: MapPosition | MapPositionArray)
   /**
    * The surface index this camera or minimap is using.
+   *
+   * _Can only be used if this is camera or minimap_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.surface_index Online documentation}
    */
   surface_index: SurfaceIndex
   /**
    * The zoom this camera or minimap is using. This value must be positive.
+   *
+   * _Can only be used if this is camera or minimap_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.zoom Online documentation}
    */
   zoom: double
   /**
    * The entity associated with this entity-preview, camera, minimap, if any.
+   *
+   * _Can only be used if this is entity-preview, camera or minimap_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.entity Online documentation}
    */
   entity: LuaEntity
@@ -13867,7 +14114,7 @@ interface CheckboxGuiElementMembers extends BaseGuiElement {
   /**
    * Is this checkbox or radiobutton checked?
    *
-   * _Can only be used if this is CheckBox or RadioButton_
+   * _Can only be used if this is checkbox or radiobutton_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.state Online documentation}
    */
   state: boolean
@@ -14012,17 +14259,23 @@ interface MinimapGuiElementMembers extends BaseGuiElement {
   readonly type: "minimap"
   /**
    * The position this camera or minimap is focused on, if any.
+   *
+   * _Can only be used if this is camera or minimap_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.position Online documentation}
    */
   get position(): MapPosition
   set position(value: MapPosition | MapPositionArray)
   /**
    * The surface index this camera or minimap is using.
+   *
+   * _Can only be used if this is camera or minimap_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.surface_index Online documentation}
    */
   surface_index: SurfaceIndex
   /**
    * The zoom this camera or minimap is using. This value must be positive.
+   *
+   * _Can only be used if this is camera or minimap_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.zoom Online documentation}
    */
   zoom: double
@@ -14035,11 +14288,15 @@ interface MinimapGuiElementMembers extends BaseGuiElement {
   minimap_player_index: uint
   /**
    * The force this minimap is using, if any.
+   *
+   * _Can only be used if this is minimap_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.force Online documentation}
    */
   force: string
   /**
    * The entity associated with this entity-preview, camera, minimap, if any.
+   *
+   * _Can only be used if this is entity-preview, camera or minimap_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.entity Online documentation}
    */
   entity: LuaEntity
@@ -14073,7 +14330,7 @@ interface RadioButtonGuiElementMembers extends BaseGuiElement {
   /**
    * Is this checkbox or radiobutton checked?
    *
-   * _Can only be used if this is CheckBox or RadioButton_
+   * _Can only be used if this is checkbox or radiobutton_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.state Online documentation}
    */
   state: boolean
@@ -14155,12 +14412,16 @@ interface SpriteGuiElementMembers extends BaseGuiElement {
    */
   readonly type: "sprite"
   /**
-   * The image to display on this sprite-button or sprite in the default state.
+   * The sprite to display on this sprite-button or sprite in the default state.
+   *
+   * _Can only be used if this is sprite-button or sprite_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.sprite Online documentation}
    */
   sprite: SpritePath
   /**
-   * Whether the image widget should resize according to the sprite in it. Defaults to `true`.
+   * Whether the sprite widget should resize according to the sprite in it. Defaults to `true`.
+   *
+   * _Can only be used if this is sprite_
    * @see {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.resize_to_sprite Online documentation}
    */
   resize_to_sprite: boolean
@@ -14503,6 +14764,10 @@ interface LuaHeatBufferPrototype {
  * @noSelf
  */
 interface LuaHeatEnergySourcePrototype {
+  /**
+   * The emissions of this energy source in `pollution/Joule`. Multiplying it by energy consumption in `Watt` gives `pollution/second`.
+   * @see {@link https://lua-api.factorio.com/latest/LuaHeatEnergySourcePrototype.html#LuaHeatEnergySourcePrototype.emissions Online documentation}
+   */
   readonly emissions: double
   readonly render_no_network_icon: boolean
   readonly render_no_power_icon: boolean
@@ -14733,7 +14998,7 @@ interface LuaInventory extends ReadonlyArray<LuaItemStack> {
    * ```
    * game.player.print(#game.player.get_main_inventory())
    * ```
-   * @see {@link https://lua-api.factorio.com/latest/LuaInventory.html#LuaInventory.operator%20# Online documentation}
+   * @see {@link https://lua-api.factorio.com/latest/LuaInventory.html#LuaInventory.length_operator Online documentation}
    */
   readonly length: uint
   /**
@@ -14743,7 +15008,7 @@ interface LuaInventory extends ReadonlyArray<LuaItemStack> {
    * ```
    * game.player.get_main_inventory()[1]
    * ```
-   * @see {@link https://lua-api.factorio.com/latest/LuaInventory.html#LuaInventory.operator%20[] Online documentation}
+   * @see {@link https://lua-api.factorio.com/latest/LuaInventory.html#LuaInventory.index_operator Online documentation}
    */
   readonly [index: number]: LuaItemStack
   /**
@@ -14806,7 +15071,7 @@ interface LuaItemPrototype {
    * The type of this ammo prototype.
    *
    * _Can only be used if this is AmmoItem_
-   * @param ammo_source_type "default", "player", "turret", or "vehicle"
+   * @param ammo_source_type One of `"default"`, `"player"`, `"turret"`, or `"vehicle"`. Defaults to `"default"`.
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.get_ammo_type Online documentation}
    */
   get_ammo_type(ammo_source_type?: "default" | "player" | "turret" | "vehicle"): AmmoType | nil
@@ -15114,6 +15379,13 @@ interface LuaItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_selection_border_color Online documentation}
    */
   readonly reverse_selection_border_color?: Color
+  /**
+   * The color used when doing alt reverse selection with this selection tool prototype.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_selection_border_color Online documentation}
+   */
+  readonly alt_reverse_selection_border_color?: Color
   /**
    * Flags that affect which entities will be selected.
    *
@@ -15135,6 +15407,13 @@ interface LuaItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_selection_mode_flags Online documentation}
    */
   readonly reverse_selection_mode_flags?: SelectionModeFlags
+  /**
+   * Flags that affect which entities will be selected during alt reverse selection.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_selection_mode_flags Online documentation}
+   */
+  readonly alt_reverse_selection_mode_flags?: SelectionModeFlags
   /**
    * _Can only be used if this is SelectionTool_
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.selection_cursor_box_type Online documentation}
@@ -15150,6 +15429,11 @@ interface LuaItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_selection_cursor_box_type Online documentation}
    */
   readonly reverse_selection_cursor_box_type?: string
+  /**
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_selection_cursor_box_type Online documentation}
+   */
+  readonly alt_reverse_selection_cursor_box_type?: string
   /**
    * If tiles area always included when doing selection with this selection tool prototype.
    *
@@ -15178,6 +15462,13 @@ interface LuaItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_alt_entity_filter_mode Online documentation}
    */
   readonly reverse_alt_entity_filter_mode?: string
+  /**
+   * The alt reverse entity filter mode used by this selection tool.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_alt_entity_filter_mode Online documentation}
+   */
+  readonly alt_reverse_alt_entity_filter_mode?: string
   /**
    * The tile filter mode used by this selection tool.
    *
@@ -15199,6 +15490,13 @@ interface LuaItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_tile_filter_mode Online documentation}
    */
   readonly reverse_tile_filter_mode?: string
+  /**
+   * The alt reverse tile filter mode used by this selection tool.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_tile_filter_mode Online documentation}
+   */
+  readonly alt_reverse_tile_filter_mode?: string
   /**
    * The entity filters used by this selection tool indexed by entity name.
    *
@@ -15220,6 +15518,13 @@ interface LuaItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_entity_filters Online documentation}
    */
   readonly reverse_entity_filters?: Record<string, LuaEntityPrototype>
+  /**
+   * The alt reverse entity filters used by this selection tool indexed by entity name.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_entity_filters Online documentation}
+   */
+  readonly alt_reverse_entity_filters?: Record<string, LuaEntityPrototype>
   /**
    * The entity type filters used by this selection tool indexed by entity type.
    *
@@ -15244,6 +15549,14 @@ interface LuaItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_entity_type_filters Online documentation}
    */
   readonly reverse_entity_type_filters?: Record<string, boolean>
+  /**
+   * The alt reverse entity type filters used by this selection tool indexed by entity type.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @remarks The boolean value is meaningless and is used to allow easy lookup if a type exists in the dictionary.
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_entity_type_filters Online documentation}
+   */
+  readonly alt_reverse_entity_type_filters?: Record<string, boolean>
   /**
    * The tile filters used by this selection tool indexed by tile name.
    *
@@ -15265,6 +15578,13 @@ interface LuaItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_tile_filters Online documentation}
    */
   readonly reverse_tile_filters?: Record<string, LuaTilePrototype>
+  /**
+   * The alt reverse tile filters used by this selection tool indexed by tile name.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_tile_filters Online documentation}
+   */
+  readonly alt_reverse_tile_filters?: Record<string, LuaTilePrototype>
   /**
    * The number of entity filters this deconstruction item has.
    *
@@ -15460,7 +15780,7 @@ interface AmmoItemPrototype extends BaseItemPrototype {
    * The type of this ammo prototype.
    *
    * _Can only be used if this is AmmoItem_
-   * @param ammo_source_type "default", "player", "turret", or "vehicle"
+   * @param ammo_source_type One of `"default"`, `"player"`, `"turret"`, or `"vehicle"`. Defaults to `"default"`.
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.get_ammo_type Online documentation}
    */
   get_ammo_type(ammo_source_type?: "default" | "player" | "turret" | "vehicle"): AmmoType | nil
@@ -15688,6 +16008,13 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_selection_border_color Online documentation}
    */
   readonly reverse_selection_border_color?: Color
+  /**
+   * The color used when doing alt reverse selection with this selection tool prototype.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_selection_border_color Online documentation}
+   */
+  readonly alt_reverse_selection_border_color?: Color
   /**
    * Flags that affect which entities will be selected.
    *
@@ -15709,6 +16036,13 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_selection_mode_flags Online documentation}
    */
   readonly reverse_selection_mode_flags?: SelectionModeFlags
+  /**
+   * Flags that affect which entities will be selected during alt reverse selection.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_selection_mode_flags Online documentation}
+   */
+  readonly alt_reverse_selection_mode_flags?: SelectionModeFlags
   /**
    * _Can only be used if this is SelectionTool_
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.selection_cursor_box_type Online documentation}
@@ -15724,6 +16058,11 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_selection_cursor_box_type Online documentation}
    */
   readonly reverse_selection_cursor_box_type?: string
+  /**
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_selection_cursor_box_type Online documentation}
+   */
+  readonly alt_reverse_selection_cursor_box_type?: string
   /**
    * If tiles area always included when doing selection with this selection tool prototype.
    *
@@ -15752,6 +16091,13 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_alt_entity_filter_mode Online documentation}
    */
   readonly reverse_alt_entity_filter_mode?: string
+  /**
+   * The alt reverse entity filter mode used by this selection tool.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_alt_entity_filter_mode Online documentation}
+   */
+  readonly alt_reverse_alt_entity_filter_mode?: string
   /**
    * The tile filter mode used by this selection tool.
    *
@@ -15773,6 +16119,13 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_tile_filter_mode Online documentation}
    */
   readonly reverse_tile_filter_mode?: string
+  /**
+   * The alt reverse tile filter mode used by this selection tool.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_tile_filter_mode Online documentation}
+   */
+  readonly alt_reverse_tile_filter_mode?: string
   /**
    * The entity filters used by this selection tool indexed by entity name.
    *
@@ -15794,6 +16147,13 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_entity_filters Online documentation}
    */
   readonly reverse_entity_filters?: Record<string, LuaEntityPrototype>
+  /**
+   * The alt reverse entity filters used by this selection tool indexed by entity name.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_entity_filters Online documentation}
+   */
+  readonly alt_reverse_entity_filters?: Record<string, LuaEntityPrototype>
   /**
    * The entity type filters used by this selection tool indexed by entity type.
    *
@@ -15818,6 +16178,14 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_entity_type_filters Online documentation}
    */
   readonly reverse_entity_type_filters?: Record<string, boolean>
+  /**
+   * The alt reverse entity type filters used by this selection tool indexed by entity type.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @remarks The boolean value is meaningless and is used to allow easy lookup if a type exists in the dictionary.
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_entity_type_filters Online documentation}
+   */
+  readonly alt_reverse_entity_type_filters?: Record<string, boolean>
   /**
    * The tile filters used by this selection tool indexed by tile name.
    *
@@ -15839,6 +16207,13 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_tile_filters Online documentation}
    */
   readonly reverse_tile_filters?: Record<string, LuaTilePrototype>
+  /**
+   * The alt reverse tile filters used by this selection tool indexed by tile name.
+   *
+   * _Can only be used if this is SelectionTool_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_reverse_tile_filters Online documentation}
+   */
+  readonly alt_reverse_tile_filters?: Record<string, LuaTilePrototype>
 }
 
 interface DeconstructionItemPrototype extends BaseItemPrototype {
@@ -17531,7 +17906,7 @@ interface LuaLogisticCell {
  */
 interface LuaLogisticContainerControlBehavior extends LuaControlBehavior {
   /**
-   * The circuit mode of operations for the logistic container.
+   * The circuit mode of operations for the logistic container. Can only be set on containers whose {@link LuaEntityPrototype#logistic_mode logistic_mode} is set to "requester".
    * @see {@link https://lua-api.factorio.com/latest/LuaLogisticContainerControlBehavior.html#LuaLogisticContainerControlBehavior.circuit_mode_of_operation Online documentation}
    */
   circuit_mode_of_operation: defines.control_behavior.logistic_container.circuit_mode_of_operation
@@ -18435,20 +18810,20 @@ interface LuaPlayer extends LuaControl {
    */
   pipette_entity(entity: string | LuaEntity | LuaEntityPrototype): boolean
   /**
-   * Checks if this player can build the give entity at the given location on the surface the player is on.
+   * Checks if this player can build the given entity at the given location on the surface the player is on.
    * @see {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.can_place_entity Online documentation}
    */
   can_place_entity(params: {
     /**
-     * Name of the entity to check
+     * Name of the entity to check.
      */
     readonly name: string
     /**
-     * Where the entity would be placed
+     * Where the entity would be placed.
      */
     readonly position: MapPosition | MapPositionArray
     /**
-     * Direction the entity would be placed
+     * Direction the entity would be placed. Defaults to `north`.
      */
     readonly direction?: defines.direction
   }): boolean
@@ -18710,8 +19085,6 @@ interface LuaPlayer extends LuaControl {
   get_infinity_inventory_filter(index: uint): InfinityInventoryFilter | nil
   /**
    * Sets the filter for this map editor infinity filters at the given index.
-   *
-   * _Can only be used if this is InfinityContainer_
    * @param index The index to set.
    * @param filter The new filter or `nil` to clear the filter.
    * @see {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.set_infinity_inventory_filter Online documentation}
@@ -19157,7 +19530,7 @@ interface LuaRandomGenerator {
    * Generates a random number. If no parameters are given a number in the [0, 1) range is returned. If a single parameter is given a floored number in the [1, N] range is returned. If 2 parameters are given a floored number in the [N1, N2] range is returned.
    * @param lower Inclusive lower bound on the result
    * @param upper Inclusive upper bound on the result
-   * @see {@link https://lua-api.factorio.com/latest/LuaRandomGenerator.html#LuaRandomGenerator.operator%20() Online documentation}
+   * @see {@link https://lua-api.factorio.com/latest/LuaRandomGenerator.html#LuaRandomGenerator.call_operator Online documentation}
    */
   (lower?: int, upper?: int): double
   /**
@@ -19476,9 +19849,8 @@ interface LuaRecipePrototype {
 interface LuaRemote {
   /**
    * Add a remote interface.
-   * @param name Name of the interface.
+   * @param name Name of the interface. If the name matches any existing interface, an error is thrown.
    * @param functions List of functions that are members of the new interface.
-   * @remarks It is an error if the given interface `name` is already registered.
    * @see {@link https://lua-api.factorio.com/latest/LuaRemote.html#LuaRemote.add_interface Online documentation}
    */
   add_interface(name: string, functions: Record<string, (...args: any) => void>): void
@@ -19492,14 +19864,14 @@ interface LuaRemote {
   /**
    * Call a function of an interface.
    * @param _interface Interface to look up `function` in.
-   * @param _function Function name that belongs to `interface`.
-   * @param args Arguments to pass to the called function.
+   * @param _function Function name that belongs to the `interface`.
+   * @param args Arguments to pass to the called function. Note that any arguments passed through the interface are a copy of the original, not a reference. Metatables are not retained, while references to LuaObjects stay intact.
    * @see {@link https://lua-api.factorio.com/latest/LuaRemote.html#LuaRemote.call Online documentation}
    */
   call<T extends (...args: any) => any>(_interface: string, _function: string, ...args: Parameters<T>): ReturnType<T>
   call(_interface: string, _function: string, ...args: readonly Any[]): Any | nil
   /**
-   * List of all registered interfaces. For each interface name, `remote.interfaces[name]` is a dictionary mapping the interface's registered functions to the value `true`.
+   * List of all registered interfaces. For each interface name, `remote.interfaces[name]` is a dictionary mapping the interface's registered functions to `true`.
    * @example Assuming the "human interactor" interface is registered as above
    *
    * ```
@@ -19508,7 +19880,7 @@ interface LuaRemote {
    * ```
    * @see {@link https://lua-api.factorio.com/latest/LuaRemote.html#LuaRemote.interfaces Online documentation}
    */
-  readonly interfaces: Record<string, Record<string, boolean>>
+  readonly interfaces: Record<string, Record<string, true>>
   /**
    * This object's name.
    */
@@ -21808,6 +22180,24 @@ interface BeamSurfaceCreateEntity extends BaseSurfaceCreateEntity {
   readonly source_offset?: Vector
 }
 
+/**
+ * `"stream"` variant of {@link SurfaceCreateEntity}.
+ */
+interface StreamSurfaceCreateEntity extends BaseSurfaceCreateEntity {
+  /**
+   * Absolute target position that can be used instead of target entity (entity has precedence if both entity and position are defined).
+   */
+  readonly target_position?: MapPosition | MapPositionArray
+  /**
+   * Absolute source position that can be used instead of source entity (entity has precedence if both entity and position are defined).
+   */
+  readonly source_position?: MapPosition | MapPositionArray
+  /**
+   * Source position will be offset by this value when rendering the stream.
+   */
+  readonly source_offset?: Vector
+}
+
 /**
  * `"container"` variant of {@link SurfaceCreateEntity}.
  */
@@ -21955,7 +22345,15 @@ interface ArtilleryFlareSurfaceCreateEntity extends BaseSurfaceCreateEntity {
  */
 interface ProjectileSurfaceCreateEntity extends BaseSurfaceCreateEntity {
   readonly speed: double
-  readonly max_range: double
+  readonly max_range?: double
+}
+
+/**
+ * `"artillery-projectile"` variant of {@link SurfaceCreateEntity}.
+ */
+interface ArtilleryProjectileSurfaceCreateEntity extends BaseSurfaceCreateEntity {
+  readonly speed: double
+  readonly max_range?: double
 }
 
 /**
@@ -22054,6 +22452,7 @@ interface SimpleEntityWithForceSurfaceCreateEntity extends BaseSurfaceCreateEnti
 type SurfaceCreateEntity =
   | AssemblingMachineSurfaceCreateEntity
   | BeamSurfaceCreateEntity
+  | StreamSurfaceCreateEntity
   | ContainerSurfaceCreateEntity
   | CliffSurfaceCreateEntity
   | FlyingTextSurfaceCreateEntity
@@ -22068,6 +22467,7 @@ type SurfaceCreateEntity =
   | ParticleSurfaceCreateEntity
   | ArtilleryFlareSurfaceCreateEntity
   | ProjectileSurfaceCreateEntity
+  | ArtilleryProjectileSurfaceCreateEntity
   | ResourceSurfaceCreateEntity
   | UndergroundBeltSurfaceCreateEntity
   | ProgrammableSpeakerSurfaceCreateEntity
@@ -22108,19 +22508,19 @@ interface LuaSurface {
      */
     readonly position: MapPosition | MapPositionArray
     /**
-     * Direction of the placed entity.
+     * Direction of the placed entity. Defaults to `north`.
      */
     readonly direction?: defines.direction
     /**
-     * The force that would place the entity. If not specified, the enemy force is assumed.
+     * The force that would place the entity. Defaults to the `"neutral"` force.
      */
     readonly force?: ForceIdentification
     /**
-     * Which type of check should be carried out.
+     * Which type of check should be carried out. Defaults to `ghost_revive`.
      */
     readonly build_check_type?: defines.build_check_type
     /**
-     * If `true`, entities that can be marked for deconstruction are ignored. Only used if `build_check_type` is either `manual_ghost`, `script_ghost` or `blueprint_ghost`.
+     * If `true`, entities that can be marked for deconstruction are ignored. Only used if `build_check_type` is either `manual_ghost`, `script_ghost` or `blueprint_ghost`. Defaults to `false`.
      */
     readonly forced?: boolean
     /**
@@ -22134,19 +22534,19 @@ interface LuaSurface {
    */
   can_fast_replace(params: {
     /**
-     * Name of the entity to check
+     * Name of the entity to check.
      */
     readonly name: string
     /**
-     * Where the entity would be placed
+     * Where the entity would be placed.
      */
     readonly position: MapPosition | MapPositionArray
     /**
-     * Direction the entity would be placed
+     * Direction the entity would be placed. Defaults to `north`.
      */
     readonly direction?: defines.direction
     /**
-     * The force that would place the entity. If not specified, the enemy force is assumed.
+     * The force that would place the entity. Defaults to the `"neutral"` force.
      */
     readonly force?: ForceIdentification
   }): boolean
@@ -22477,6 +22877,7 @@ interface LuaSurface {
    * Other attributes may be specified depending on the type of entity:
    * - `"assembling-machine"`: {@link AssemblingMachineSurfaceCreateEntity}
    * - `"beam"`: {@link BeamSurfaceCreateEntity}
+   * - `"stream"`: {@link StreamSurfaceCreateEntity}
    * - `"container"`: {@link ContainerSurfaceCreateEntity}
    * - `"cliff"`: {@link CliffSurfaceCreateEntity}
    * - `"flying-text"`: {@link FlyingTextSurfaceCreateEntity}
@@ -22491,6 +22892,7 @@ interface LuaSurface {
    * - `"particle"`: {@link ParticleSurfaceCreateEntity}
    * - `"artillery-flare"`: {@link ArtilleryFlareSurfaceCreateEntity}
    * - `"projectile"`: {@link ProjectileSurfaceCreateEntity}
+   * - `"artillery-projectile"`: {@link ArtilleryProjectileSurfaceCreateEntity}
    * - `"resource"`: {@link ResourceSurfaceCreateEntity}
    * - `"underground-belt"`: {@link UndergroundBeltSurfaceCreateEntity}
    * - `"programmable-speaker"`: {@link ProgrammableSpeakerSurfaceCreateEntity}
@@ -22596,8 +22998,8 @@ interface LuaSurface {
    */
   build_enemy_base(position: MapPosition | MapPositionArray, unit_count: uint, force?: ForceIdentification): void
   /**
-   * Get the tile at a given position.
-   * @remarks The input position params can also be a single tile position.
+   * Get the tile at a given position. An alternative call signature for this method is passing it a single {@link TilePosition}.
+   * @remarks Non-integer values will result in them being rounded down.
    * @see {@link https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.get_tile Online documentation}
    */
   get_tile(x: int, y: int): LuaTile
@@ -22916,7 +23318,7 @@ interface LuaSurface {
     readonly invert?: boolean
   }): DecorativeResult[]
   /**
-   * @param force If given only trains matching this force are returned.
+   * @param force The force to search. Not providing a force will match trains in any force.
    * @see {@link https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.get_trains Online documentation}
    */
   get_trains(force?: ForceIdentification): LuaTrain[]
@@ -23204,7 +23606,13 @@ interface LuaSurface {
    * @see {@link https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.get_train_stops Online documentation}
    */
   get_train_stops(params?: {
+    /**
+     * The name(s) of the train stops. Not providing names will match any stop.
+     */
     readonly name?: string | readonly string[]
+    /**
+     * The force to search. Not providing a force will match stops in any force.
+     */
     readonly force?: ForceIdentification
   }): LuaEntity[]
   /**
@@ -24184,12 +24592,12 @@ interface LuaTransportLine extends ReadonlyArray<LuaItemStack> {
   line_equals(other: LuaTransportLine): boolean
   /**
    * Get the number of items on this transport line.
-   * @see {@link https://lua-api.factorio.com/latest/LuaTransportLine.html#LuaTransportLine.operator%20# Online documentation}
+   * @see {@link https://lua-api.factorio.com/latest/LuaTransportLine.html#LuaTransportLine.length_operator Online documentation}
    */
   readonly length: uint
   /**
    * The indexing operator.
-   * @see {@link https://lua-api.factorio.com/latest/LuaTransportLine.html#LuaTransportLine.operator%20[] Online documentation}
+   * @see {@link https://lua-api.factorio.com/latest/LuaTransportLine.html#LuaTransportLine.index_operator Online documentation}
    */
   readonly [index: number]: LuaItemStack
   /**
@@ -24382,7 +24790,7 @@ interface LuaVirtualSignalPrototype {
   readonly localised_name: LocalisedString
   readonly localised_description: LocalisedString
   /**
-   * If this is a special signal
+   * Whether this is a special signal. The `everything`, `anything`, `each`, and `unknown` signals are considered special.
    * @see {@link https://lua-api.factorio.com/latest/LuaVirtualSignalPrototype.html#LuaVirtualSignalPrototype.special Online documentation}
    */
   readonly special: boolean
@@ -24407,6 +24815,10 @@ interface LuaVirtualSignalPrototype {
  * @noSelf
  */
 interface LuaVoidEnergySourcePrototype {
+  /**
+   * The emissions of this energy source in `pollution/Joule`. Multiplying it by energy consumption in `Watt` gives `pollution/second`.
+   * @see {@link https://lua-api.factorio.com/latest/LuaVoidEnergySourcePrototype.html#LuaVoidEnergySourcePrototype.emissions Online documentation}
+   */
   readonly emissions: double
   readonly render_no_network_icon: boolean
   readonly render_no_power_icon: boolean