factorio-types 1.2.32 → 1.2.34

package/dist/classes.d.ts

@@ -2,7 +2,7 @@
 // Factorio API reference https://lua-api.factorio.com/latest/index.html
 // Generated from JSON source https://lua-api.factorio.com/latest/runtime-api.json
 // Definition source https://github.com/sguest/factorio-types
-// Factorio version 2.0.45
+// Factorio version 2.0.49
 // API version 6
 
 declare namespace runtime {
@@ -4714,7 +4714,7 @@ interface LuaCommandable {
      */
     readonly is_entity: boolean;
     /**
-     * Whether this unit group is controlled by a script or by the game engine. This can be changed using {@link LuaCommandable::set_autonomous | runtime:LuaCommandable::set_autonomous}.
+     * Whether this unit group is controlled by a script or by the game engine. This can be changed using {@link LuaCommandable::set_autonomous | runtime:LuaCommandable::set_autonomous}. Units created by {@link LuaSurface::create_unit_group | runtime:LuaSurface::create_unit_group} are considered script-driven.
      */
     readonly is_script_driven: boolean;
     /**
@@ -4899,6 +4899,10 @@ interface LuaControl {
      * @returns The inventory or `nil` if none with the given index was found.
      */
     get_inventory(this: void, inventory: defines.inventory): LuaInventory | null;
+    /**
+     * Get name of inventory. Names match keys of {@link defines.inventory | runtime:defines.inventory}.
+     */
+    get_inventory_name(this: void, inventory: defines.inventory): string | null;
     /**
      * Get the number of all or some items in this entity.
      * @param item The item to count. If not specified, count all items.
@@ -5957,6 +5961,15 @@ interface LuaEntity extends LuaControl {
      * @param fluid Prototype name of the fluid to count. If not specified, count all fluids.
      */
     get_fluid_count(this: void, fluid?: string): double;
+    /**
+     * Checks what is expected fluid to be produced from the offshore pump's source tile. It accounts for visible tile, hidden tile and double hidden tile. It ignores currently set fluid box filter.
+     * @returns Name of fluid that should be produced by this offshore pump based on existing tiles.
+     */
+    get_fluid_source_fluid(this: void): string | null;
+    /**
+     * Gives TilePosition of a tile which this offshore pump uses to check what fluid should be produced.
+     */
+    get_fluid_source_tile(this: void): TilePosition;
     /**
      * The fuel inventory for this entity or `nil` if this entity doesn't have a fuel inventory.
      */
@@ -6231,7 +6244,7 @@ interface LuaEntity extends LuaControl {
      */
     is_registered_for_deconstruction(this: void, force: ForceID): boolean;
     /**
-     * Is this entity registered for repair? If false, it means a construction robot has been dispatched to upgrade it, or it is not damaged. This is worst-case O(N) complexity where N is the current number of things in the repair queue.
+     * Is this entity registered for repair? If false, it means a construction robot has been dispatched to repair it, or it is not damaged. This is worst-case O(N) complexity where N is the current number of things in the repair queue.
      */
     is_registered_for_repair(this: void): boolean;
     /**
@@ -6239,9 +6252,10 @@ interface LuaEntity extends LuaControl {
      */
     is_registered_for_upgrade(this: void): boolean;
     /**
+     * @param character If provided, must be of `character` type.
      * @returns `true` if the rocket was successfully launched. Return value of `false` means the silo is not ready for launch.
      */
-    launch_rocket(this: void, destination?: CargoDestination): boolean;
+    launch_rocket(this: void, destination?: CargoDestination, character?: LuaEntity): boolean;
     /**
      * Mines this entity.
      *
@@ -6503,11 +6517,18 @@ interface LuaEntity extends LuaControl {
      *
      * The player will be automatically disassociated when a controller is set on the character. Also, all characters associated to a player will be logged off when the player logs off in multiplayer.
      *
-     * Reading this property will return a {@link LuaPlayer | runtime:LuaPlayer}, while {@link PlayerIdentification | runtime:PlayerIdentification} can be used when writing.
+     * A character associated with a player is not directly controlled by any player.
+     */
+    readonly associated_player?: LuaPlayer;
+    /**
+     * The player this character is associated with, if any. Set to `nil` to clear.
+     *
+     * The player will be automatically disassociated when a controller is set on the character. Also, all characters associated to a player will be logged off when the player logs off in multiplayer.
      *
      * A character associated with a player is not directly controlled by any player.
+     * @customName associated_player
      */
-    associated_player?: LuaPlayer | PlayerIdentification;
+    associated_player_write?: PlayerIdentification;
     /**
      * The cargo pod attached to this rocket silo rocket if any.
      */
@@ -6526,6 +6547,7 @@ interface LuaEntity extends LuaControl {
      * While train stops get the name of a backer when placed down, players can rename them if they want to. In this case, `backer_name` returns the player-given name of the entity.
      */
     backer_name?: string;
+    base_damage_modifiers: TriggerModifierData;
     /**
      * Number of beacons affecting this effect receiver. Can only be used when the entity has an effect receiver (AssemblingMachine, Furnace, Lab, MiningDrills)
      */
@@ -6553,6 +6575,7 @@ interface LuaEntity extends LuaControl {
      * Whether this underground belt goes into or out of the ground.
      */
     readonly belt_to_ground_type: 'input' | 'output';
+    bonus_damage_modifiers: TriggerModifierData;
     /**
      * The bonus mining progress for this mining drill. Read yields a number in range [0, mining_target.prototype.mineable_properties.mining_time]. `nil` if this isn't a mining drill.
      */
@@ -6569,6 +6592,10 @@ interface LuaEntity extends LuaControl {
      * The burner energy source for this entity, if any.
      */
     readonly burner?: LuaBurner;
+    /**
+     * The space platform hub or cargo landing pad this cargo bay is connected to if any.
+     */
+    readonly cargo_bay_connection_owner?: LuaEntity;
     /**
      * The cargo hatches owned by this entity if any.
      */
@@ -6941,6 +6968,10 @@ interface LuaEntity extends LuaControl {
      * If the entity is updatable.
      */
     readonly is_updatable: boolean;
+    /**
+     * The first found item request proxy targeting this entity.
+     */
+    readonly item_request_proxy?: LuaEntity;
     /**
      * Items this ghost will request when revived or items this item request proxy is requesting.
      */
@@ -6951,10 +6982,13 @@ interface LuaEntity extends LuaControl {
     kills: uint;
     /**
      * The last player that changed any setting on this entity. This includes building the entity, changing its color, or configuring its circuit network. `nil` if the last user is not part of the save anymore.
-     *
-     * Reading this property will return a {@link LuaPlayer | runtime:LuaPlayer}, while {@link PlayerIdentification | runtime:PlayerIdentification} can be used when writing.
      */
-    last_user?: LuaPlayer | PlayerIdentification;
+    readonly last_user?: LuaPlayer;
+    /**
+     * The last player that changed any setting on this entity. This includes building the entity, changing its color, or configuring its circuit network. `nil` if the last user is not part of the save anymore.
+     * @customName last_user
+     */
+    last_user_write?: PlayerIdentification;
     /**
      * The link ID this linked container is using.
      */
@@ -7070,6 +7104,10 @@ interface LuaEntity extends LuaControl {
      * The smooth orientation of this entity.
      */
     orientation: RealOrientation;
+    /**
+     * Plants registered by this agricultural tower.
+     */
+    readonly owned_plants: LuaEntity[];
     parameters: ProgrammableSpeakerParameters;
     /**
      * Where the inserter will pick up items from.
@@ -7173,10 +7211,13 @@ interface LuaEntity extends LuaControl {
     remove_unfiltered_items: boolean;
     /**
      * The player that this `simple-entity-with-owner`, `simple-entity-with-force`, or `highlight-box` is visible to. `nil` when this entity is rendered for all players.
-     *
-     * Reading this property will return a {@link LuaPlayer | runtime:LuaPlayer}, while {@link PlayerIdentification | runtime:PlayerIdentification} can be used when writing.
      */
-    render_player?: LuaPlayer | PlayerIdentification;
+    readonly render_player?: LuaPlayer;
+    /**
+     * The player that this `simple-entity-with-owner`, `simple-entity-with-force`, or `highlight-box` is visible to. `nil` when this entity is rendered for all players.
+     * @customName render_player
+     */
+    render_player_write?: PlayerIdentification;
     /**
      * The forces that this `simple-entity-with-owner` or `simple-entity-with-force` is visible to. `nil` or an empty array when this entity is rendered for all forces.
      *
@@ -7432,10 +7473,22 @@ interface LuaEntity extends LuaControl {
      * This has no effect if the prototype does not support filters.
      */
     use_filters: boolean;
+    /**
+     * When true, the rocket silo will request items for space platforms in orbit.
+     *
+     * Setting the value will have no effect when the silo doesn't support logistics.
+     */
+    use_transitional_requests: boolean;
     /**
      * Is this object valid? This Lua object holds a reference to an object within the game engine. It is possible that the game-engine object is removed whilst a mod still holds the corresponding Lua object. If that happens, the object becomes invalid, i.e. this attribute will be `false`. Mods are advised to check for object validity if any change to the game state might have occurred between the creation of the Lua object and its access.
      */
     readonly valid: boolean;
+    /**
+     * The threshold override of this valve, or `nil` if an override is not defined.
+     *
+     * If no override is defined, the threshold is taken from {@link LuaEntityPrototype::valve_threshold | runtime:LuaEntityPrototype::valve_threshold}.
+     */
+    valve_threshold_override?: float;
     /**
      * Read when this spidertron auto-targets enemies
      */
@@ -7513,6 +7566,10 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
      * The supply area of this electric pole or beacon prototype.
      */
     get_supply_area_distance(this: void, quality?: QualityID): double;
+    /**
+     * The maximum flow rate through this valve.
+     */
+    get_valve_flow_rate(this: void, quality?: QualityID): double;
     /**
      * Test whether this entity prototype has a certain flag set.
      * @param flag The flag to test.
@@ -7523,6 +7580,7 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
      * A table of pollutions amounts that has to be absorbed by the unit's spawner before the unit will leave the spawner and attack the source of the pollution, indexed by the name of each absorbed pollution type.
      */
     readonly absorptions_to_join_attack?: Record<string, float>;
+    readonly accepted_seeds?: string[];
     /**
      * The active energy usage of this rocket silo or combinator prototype.
      */
@@ -7535,6 +7593,7 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
      * Whether this unit prototype is affected by tile walking speed modifiers.
      */
     readonly affected_by_tiles?: boolean;
+    readonly agricultural_tower_radius?: double;
     /**
      * The air resistance of this rolling stock prototype.
      */
@@ -7725,6 +7784,10 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
      * The value in the dictionary is meaningless and exists just to allow for easy lookup.
      */
     readonly crafting_categories?: Record<string, true>;
+    /**
+     * The crane energy usage of this agricultural tower prototype.
+     */
+    readonly crane_energy_usage?: double;
     /**
      * If this prototype will attempt to create a ghost of itself on death.
      *
@@ -7878,6 +7941,7 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
      * The fluid energy source prototype this entity uses, if any.
      */
     readonly fluid_energy_source_prototype?: LuaFluidEnergySourcePrototype;
+    readonly fluid_source_offset?: Vector;
     /**
      * The fluid usage of this generator prototype. This property is deprecated in favor of {@link LuaEntityPrototype::get_fluid_usage_per_tick | runtime:LuaEntityPrototype::get_fluid_usage_per_tick} and should not be used.
      */
@@ -7906,6 +7970,7 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
      * The equipment grid prototype for this entity, if any.
      */
     readonly grid_prototype?: LuaEquipmentGridPrototype;
+    readonly growth_area_radius?: double;
     readonly growth_grid_tile_size?: uint;
     readonly growth_ticks?: uint;
     /**
@@ -8049,6 +8114,7 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
      * The lamp energy usage of this rocket silo prototype.
      */
     readonly lamp_energy_usage?: double;
+    readonly launch_to_space_platforms?: boolean;
     /**
      * The rocket launch delay for this rocket silo prototype.
      */
@@ -8296,6 +8362,10 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
      * The rocket rising delay for this rocket silo prototype.
      */
     readonly rocket_rising_delay?: uint8;
+    /**
+     * The rotation snap angle of this car prototype.
+     */
+    readonly rotation_snap_angle?: double;
     /**
      * The rotation speed of this car prototype.
      */
@@ -8332,6 +8402,9 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
      * The cursor size used when shooting at this entity.
      */
     readonly shooting_cursor_size: float;
+    readonly solar_panel_performance_at_day: double;
+    readonly solar_panel_performance_at_night: double;
+    readonly solar_panel_solar_coefficient_property: LuaSurfacePropertyPrototype;
     /**
      * The spawning cooldown for this enemy spawner prototype.
      */
@@ -8441,11 +8514,19 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
     /**
      * If this drill uses force productivity bonus
      */
-    readonly uses_force_mining_productivity_bonus?: bool;
+    readonly uses_force_mining_productivity_bonus?: boolean;
     /**
      * Is this object valid? This Lua object holds a reference to an object within the game engine. It is possible that the game-engine object is removed whilst a mod still holds the corresponding Lua object. If that happens, the object becomes invalid, i.e. this attribute will be `false`. Mods are advised to check for object validity if any change to the game state might have occurred between the creation of the Lua object and its access.
      */
     readonly valid: boolean;
+    /**
+     * The mode of operation of this valve.
+     */
+    readonly valve_mode?: ValveMode;
+    /**
+     * The default threshold of this valve.
+     */
+    readonly valve_threshold?: float;
     readonly vector_to_place_result?: Vector;
     /**
      * Vertical selection shift used by rolling stocks. It affects selection box vertical position but is also used to shift rolling stock graphics along the rails to fine tune train's look.
@@ -8503,7 +8584,7 @@ interface LuaEquipment {
      */
     readonly max_energy: double;
     /**
-     * Maximum shield value.
+     * Maximum shield value. `0` if this equipment doesn't have a shield.
      */
     readonly max_shield: double;
     /**
@@ -8539,9 +8620,9 @@ interface LuaEquipment {
         height: uint;
     };
     /**
-     * Current shield value of the equipment.
+     * Current shield value of the equipment. Can't be set higher than {@link LuaEquipment::max_shield | runtime:LuaEquipment::max_shield}.
      *
-     * Can't be set higher than {@link LuaEquipment::max_shield | runtime:LuaEquipment::max_shield}.
+     * Trying to write this value on non-shield equipment will throw an error.
      */
     shield: double;
     /**
@@ -8987,7 +9068,7 @@ interface LuaFluidBox {
      */
     flush(this: void, index: uint, fluid?: FluidID): Record<string, float>;
     /**
-     * The capacity of the given fluidbox index.
+     * The capacity of the given fluidbox segment.
      */
     get_capacity(this: void, index: uint): double;
     /**
@@ -9002,6 +9083,8 @@ interface LuaFluidBox {
     get_filter(this: void, index: uint): FluidBoxFilter | null;
     /**
      * Gets counts of all fluids in the fluid segment. May return `nil` for fluid wagon, fluid turret's internal buffer, or a fluidbox which does not belong to a fluid segment.
+     *
+     * Note that this method only ever returns one fluid, since fluids can't be mixed anymore.
      * @returns The counts, indexed by fluid name.
      */
     get_fluid_segment_contents(this: void, index: uint): Record<string, uint> | null;
@@ -10346,10 +10429,10 @@ interface LuaGenericOnOffControlBehavior extends LuaControlBehavior {
      * @example ```
     -- Tell an entity to be active (for example a lamp to be lit) when it receives a
     -- circuit signal of more than 4 chain signals.
-    a_behavior.circuit_condition = {condition={
+    a_behavior.circuit_condition = {
       comparator=">",
       first_signal={type="item", name="rail-chain-signal"},
-      constant=4}
+      constant=4
     }
     ```
      */
@@ -10371,10 +10454,10 @@ interface LuaGenericOnOffControlBehavior extends LuaControlBehavior {
      * @example ```
     -- Tell an entity to be active (for example a lamp to be lit) when the logistics
     -- network it's connected to has more than four chain signals.
-    a_behavior.logistic_condition = {condition={
+    a_behavior.logistic_condition = {
       comparator=">",
       first_signal={type="item", name="rail-chain-signal"},
-      constant=4}
+      constant=4
     }
     ```
      */
@@ -10879,6 +10962,15 @@ interface LuaGuiElement {
      * The position this camera or minimap is focused on, if any.
      */
     position: MapPosition;
+    /**
+     * The quality to be shown in the bottom left corner of this sprite-button, or `nil` to show nothing.
+     */
+    readonly quality?: LuaQualityPrototype;
+    /**
+     * The quality to be shown in the bottom left corner of this sprite-button, or `nil` to show nothing.
+     * @customName quality
+     */
+    quality_write?: QualityID;
     /**
      * Whether this element will raise {@link on_gui_hover | runtime:on_gui_hover} and {@link on_gui_leave | runtime:on_gui_leave}.
      */
@@ -11428,6 +11520,10 @@ interface LuaGuiElementAddParamsSpriteButton extends BaseLuaGuiElementAddParams
      * The number shown on the button.
      */
     'number'?: double;
+    /**
+     * The name of the quality shown on the button.
+     */
+    'quality'?: string;
     /**
      * Formats small numbers as percentages. Defaults to `false`.
      */
@@ -11893,6 +11989,10 @@ interface LuaInventory {
      * The mod that owns this inventory, if any.
      */
     readonly mod_owner?: string;
+    /**
+     * Name of this inventory, if any. Names match keys of {@link defines.inventory | runtime:defines.inventory}.
+     */
+    readonly name?: string;
     /**
      * The class name of this object. Available even when `valid` is false. For LuaStruct objects it may also be suffixed with a dotted path to a member of the struct.
      */
@@ -12150,7 +12250,7 @@ interface LuaItemCommon {
      *
      * In contrast to {@link LuaItemCommon::get_mapper | runtime:LuaItemCommon::get_mapper}, indices past the upgrade item's current size are valid and expand the list of mappings accordingly, if within reasonable bounds.
      * @param index The index of the mapper to set.
-     * @param mapper The mapper to set or `nil`
+     * @param mapper The mapper to set. Set `nil` to clear the mapper.
      */
     set_mapper(this: void, index: uint, type: 'from' | 'to', mapper: UpgradeMapperSource | UpgradeMapperDestination | nil): void;
     /**
@@ -12665,9 +12765,9 @@ interface LuaItemStack extends LuaItemCommon {
     swap_stack(this: void, stack: LuaItemStack): boolean;
     /**
      * Transfers the given item stack into this item stack.
-     * @returns `true` if the full stack was transferred.
+     * @returns `true` if the full stack (or requested amount) was transferred.
      */
-    transfer_stack(this: void, stack: ItemStackIdentification): boolean;
+    transfer_stack(this: void, stack: ItemStackIdentification, amount?: uint): boolean;
     /**
      * Use the capsule item with the entity as the source, targeting the given position.
      * @param entity The entity to use the capsule item with.
@@ -14204,9 +14304,63 @@ interface LuaPlayer extends LuaControl {
      */
     readonly valid: boolean;
     /**
-     * The player's zoom-level. Must be positive.
+     * The current player controller's zoom level. Must be positive. The baseline zoom level is 1. Values greater than 1 will zoom in closer to the world and values between 0 and 1 will zoom out away from the world.
+     *
+     * Writing values outside the current zoom limits is always valid, but read values will always be clamped to the range defined by {@link LuaPlayer::zoom_limits | runtime:LuaPlayer::zoom_limits}.
      */
     zoom: double;
+    /**
+     * The current player controller's zoom limits.
+     *
+     * Reading this field creates a copy, so modifying the returned table's fields directly will not alter the player's zoom limits. To change the zoom limits for the player's current controller, set the entire field to the desired {@link ZoomLimits | runtime:ZoomLimits} table.
+     *
+     * Zoom limits may or may not reset to default any time the player controller changes. Use the {@link defines.events.on_player_controller_changed | runtime:defines.events.on_player_controller_changed} event to respond to and correct the new controller's zoom limits.
+     * @example ```
+    -- Lets the player zoom in to 4x the standard zoom level. (3x is the default for most controllers.)
+    -- Increases the player zoom out level so that they can view approximately 800 tiles across.
+    -- Sets furthest_game_view to furthest so that all zoom levels are rendered in game view, never chart (map) view.
+    game.player.zoom_limits = {
+      closest = { zoom = 4 },
+      furthest = { distance = 800, max_distance = 1000 },
+      furthest_game_view = { distance = 800, max_distance = 1000 }
+    }
+    ```
+     * @example ```
+    -- Resets the closest and furthest_game_view limits to their defaults.
+    -- Increases the furthest a player can zoom out to approximately 400 tiles across. There's a hard zoom limit at
+    -- 800 tiles (either vertically or horizontally, whichever is more).
+    game.player.zoom_limits = {
+      furthest = { distance = 400, max_distance = 800 }
+    }
+    ```
+     * @example ```
+    -- Sets the closest that the player can zoom in to 3x (the default for most controllers).
+    -- Sets the furthest that the player can view in game view to some number GREATER than
+    -- closest, guaranteeing that the player can only view the chart. However, this does NOT mean that the player
+    -- can interact with the game as if in remote view if they are not explicitly using remote view.
+    game.player.zoom_limits = {
+      closest = { zoom = 3 },
+      furthest_game_view = { zoom = 4 }
+    }
+    ```
+     * @example ```
+    -- Save a copy of whatever zoom limits any script has previously set.
+    local custom_limits = game.player.zoom_limits
+    -- Resets all zoom limits to default.
+    game.player.zoom_limits = {}
+    -- Save a copy of whatever the default zoom limits are for the current controller.
+    local default_limits = game.player.zoom_limits
+    -- Set the zoom limits to a modification of the engine-default closest zoom limit (or 6 if the engine-default is
+    -- not a fixed zoom value), the furthest limit previously defined by script (or the engine default if not
+    -- previously set by a script), and some arbitrary value for `furthest_game_view`.
+    game.player.zoom_limits = {
+      closest = { zoom = (default_limits.furthest.zoom or 3.0) * 2 },
+      furthest = custom_limits.furthest,
+      furthest_game_view = { zoom = 0.25 }
+    }
+    ```
+     */
+    zoom_limits: ZoomLimits;
 }
 /**
  * Prototype of a procession inheritance group which synchronizes offsets between procession steps.
@@ -14878,10 +15032,19 @@ interface LuaReactorControlBehavior extends LuaControlBehavior {
  * A crafting recipe. Recipes belong to forces (see {@link LuaForce | runtime:LuaForce}) because some recipes are unlocked by research, and researches are per-force.
  */
 interface LuaRecipe {
+    /**
+     * Checks if recipe has given category
+     * @returns `true` if recipe has this category.
+     */
+    has_category(this: void, category: RecipeCategoryID): boolean;
     /**
      * Reload the recipe from the prototype.
      */
     reload(this: void): void;
+    /**
+     * Additional categories of this recipe.
+     */
+    readonly additional_categories: string[];
     /**
      * Category of the recipe.
      */
@@ -14977,6 +15140,15 @@ interface LuaRecipeCategoryPrototype extends LuaPrototypeBase {
  * A crafting recipe prototype.
  */
 interface LuaRecipePrototype extends LuaPrototypeBase {
+    /**
+     * Checks if recipe has given category
+     * @returns `true` if recipe has this category.
+     */
+    has_category(this: void, category: RecipeCategoryID): boolean;
+    /**
+     * Additional categories of the recipe.
+     */
+    readonly additional_categories: string[];
     /**
      * If this recipe is enabled for the purpose of intermediate hand-crafting.
      */
@@ -15241,9 +15413,8 @@ interface LuaRecord {
      *
      * In contrast to {@link LuaRecord::set_mapper | runtime:LuaRecord::set_mapper}, indices past the upgrade item's current size are considered to be out of bounds.
      * @param index The index of the mapper to read.
-     * @param type `"from"` or `"to"`.
      */
-    get_mapper(this: void, index: uint, type: string): UpgradeMapperSource | UpgradeMapperDestination;
+    get_mapper(this: void, index: uint, type: 'from' | 'to'): UpgradeMapperSource | UpgradeMapperDestination;
     /**
      * Gets the tile filter at the given index for this deconstruction planner.
      */
@@ -15285,10 +15456,9 @@ interface LuaRecord {
      *
      * In contrast to {@link LuaRecord::get_mapper | runtime:LuaRecord::get_mapper}, indices past the upgrade item's current size are valid and expand the list of mappings accordingly, if within reasonable bounds.
      * @param index The index of the mapper to set.
-     * @param type `"from"` or `"to"`.
-     * @param mapper The mapper to set or `nil`
+     * @param mapper The mapper to set. Set `nil` to clear the mapper.
      */
-    set_mapper(this: void, index: uint, type: string, mapper: UpgradeMapperSource | UpgradeMapperDestination): void;
+    set_mapper(this: void, index: uint, type: 'from' | 'to', mapper: UpgradeMapperSource | UpgradeMapperDestination | nil): void;
     /**
      * Sets the tile filter at the given index for this deconstruction planner.
      * @param filter Setting to nil erases the filter.
@@ -16308,6 +16478,7 @@ interface LuaSimulation {
      */
     deactivate_rail_planner(this: void): void;
     /**
+     * @param table.slot_index This index is 0-based, unlike other inventory indices.
      * @param table.inventory Defaults to `"character"`.
      * @returns Position of the GUI slot on the screen, if successfully found.
      */
@@ -16449,6 +16620,10 @@ interface LuaSpacePlatform {
      * Cancels deletion of this space platform if it was scheduled for deletion.
      */
     cancel_deletion(this: void): void;
+    /**
+     * Removes all ejected items from this space platform.
+     */
+    clear_ejected_items(this: void): void;
     /**
      * Creates the given asteroid chunks on this platform.
      */
@@ -16477,6 +16652,13 @@ interface LuaSpacePlatform {
         limit?: uint;
         invert?: boolean;
     }): void;
+    /**
+     * Ejects an item into space on this space platform.
+     *
+     * If a LuaItemStack is provided, the actual item is ejected and removed from the source.
+     * @param movement When inserters drop items into space, the {@link InserterPrototype::insert_position | prototype:InserterPrototype::insert_position} rotated to the inserter direction is used.
+     */
+    eject_item(this: void, item: ItemStackIdentification, position: MapPosition, movement: Vector): void;
     /**
      * Find asteroid chunks of a given name in a given area.
      *
@@ -16512,6 +16694,10 @@ interface LuaSpacePlatform {
      * It is represented as a number in range `[0, 1]`, with 0 being {@link LuaSpaceConnectionPrototype::from | runtime:LuaSpaceConnectionPrototype::from} and 1 being {@link LuaSpaceConnectionPrototype::to | runtime:LuaSpaceConnectionPrototype::to}.
      */
     distance?: double;
+    /**
+     * All items that have been thrown overboard.
+     */
+    readonly ejected_items: EjectedItem[];
     /**
      * The force of this space platform.
      */
@@ -17047,6 +17233,28 @@ interface LuaSurface {
         check_collision?: boolean;
         decoratives: Decorative[];
     }): void;
+    /**
+     * This method only works when used in simulations.
+     *
+     * Places entities via the given blueprint string. These entities are force-built.
+     * @param table.string The blueprint string to import.
+     * @param table.position The position to place the blueprint at.
+     * @param table.force The force to place the blueprint for. Defaults to the player force.
+     * @param table.direction The direction to place the blueprint in. Defaults to north.
+     * @param table.flip_horizontal Whether to flip the blueprint horizontally. Defaults to `false`.
+     * @param table.flip_vertical Whether to flip the blueprint vertically. Defaults to `false`.
+     * @param table.by_player The player that placed the blueprint. Defaults to `nil`.
+     * @returns If the blueprint string was invalid, `1` is returned. Otherwise, `nil` is returned.
+     */
+    create_entities_from_blueprint_string(this: void, table: {
+        string: string;
+        position: MapPosition;
+        force?: ForceID;
+        direction?: defines.direction;
+        flip_horizontal?: boolean;
+        flip_vertical?: boolean;
+        by_player?: PlayerIdentification;
+    }): int | null;
     /**
      * Create an entity on this surface.
      * @example ```
@@ -17587,6 +17795,14 @@ interface LuaSurface {
         force?: ForceID;
         unit_search_distance?: uint;
     }): uint;
+    /**
+     * Set the pollution for a given position.
+     *
+     * Pollution changes by this are not included in pollution statistics and do not affect evolution factors (as opposed to {@link LuaSurface::pollute | runtime:LuaSurface::pollute}).
+     * @param position The position to set the chunk's pollution
+     * @param amount New amount of pollution to be set on the chunk. Must be >= 0.
+     */
+    set_pollution(this: void, position: MapPosition, amount: double): void;
     /**
      * Sets the value of surface property on this surface.
      * @param property Property to change.
@@ -17616,6 +17832,7 @@ interface LuaSurface {
      * @param table.allow_belts Whether items can be spilled onto belts. Defaults to `true`.
      * @param table.max_radius Max radius from the specified `position` to spill items.
      * @param table.use_start_position_on_failure Allow spilling items at `position` if no non-colliding position is found. Note: Setting to false might cause some items not to be spilled. Defaults to `true`.
+     * @param table.drop_full_stack If item on ground should be made out of an entire provided stack. Defaults to `false`.
      * @returns The created item-on-ground entities.
      */
     spill_item_stack(this: void, table: {
@@ -17626,6 +17843,7 @@ interface LuaSurface {
         allow_belts?: boolean;
         max_radius?: double;
         use_start_position_on_failure?: boolean;
+        drop_full_stack?: boolean;
     }): LuaEntity[];
     /**
      * Place an upgrade request.
@@ -17670,6 +17888,29 @@ interface LuaSurface {
      * Current time of day, as a number in range `[0, 1)`.
      */
     daytime: double;
+    /**
+     * Parameters of daytime. Equivalent as reading {@link dusk | runtime:LuaSurface::dusk}, {@link evening | runtime:LuaSurface::evening}, {@link morning | runtime:LuaSurface::morning} and {@link dawn | runtime:LuaSurface::dawn} at the same time.
+     *
+     * In order for a write to take place, a new table needs to be written in one go: changing individual members of the returned table has no effect as those are value copies.
+     */
+    daytime_parameters: {
+        /**
+         * Must be < evening.
+         */
+        dusk: double;
+        /**
+         * Must be > dusk and < morning.
+         */
+        evening: double;
+        /**
+         * Must be > evening and < dawn.
+         */
+        morning: double;
+        /**
+         * Must be > morning.
+         */
+        dawn: double;
+    };
     /**
      * If this surface can be deleted.
      */
@@ -17691,9 +17932,13 @@ interface LuaSurface {
      */
     generate_with_lab_tiles: boolean;
     /**
-     * Surface-wide effects applied to entities with effect receivers. May be `nil` if surface is not using surface-wide effect source.
+     * Surface-wide effects applied to entities with effect receivers. `nil` if this surface is not using surface-wide effect source.
      */
     global_effect?: ModuleEffects;
+    /**
+     * The global electric network statistics for this surface.
+     */
+    readonly global_electric_network_statistics?: LuaFlowStatistics;
     /**
      * Whether this surface currently has a global electric network.
      */
@@ -17753,6 +17998,10 @@ interface LuaSurface {
      * The type of pollutant enabled on the surface, or `nil` if no pollutant is enabled.
      */
     readonly pollutant_type?: LuaAirbornePollutantPrototype;
+    /**
+     * The pollution statistics for this surface.
+     */
+    readonly pollution_statistics: LuaFlowStatistics;
     /**
      * If clouds are shown on this surface. If false, clouds are never shown. If true the player must also have clouds enabled in graphics settings for them to be shown.
      */
@@ -17782,7 +18031,7 @@ interface LuaSurface {
      */
     wind_speed: double;
 }
-type LuaSurfaceCreateEntityParams = BaseLuaSurfaceCreateEntityParams | LuaSurfaceCreateEntityParamsArtilleryFlare | LuaSurfaceCreateEntityParamsArtilleryProjectile | LuaSurfaceCreateEntityParamsAssemblingMachine | LuaSurfaceCreateEntityParamsBeam | LuaSurfaceCreateEntityParamsCharacterCorpse | LuaSurfaceCreateEntityParamsCliff | LuaSurfaceCreateEntityParamsContainer | LuaSurfaceCreateEntityParamsElectricPole | LuaSurfaceCreateEntityParamsEntityGhost | LuaSurfaceCreateEntityParamsFire | LuaSurfaceCreateEntityParamsHighlightBox | LuaSurfaceCreateEntityParamsInserter | LuaSurfaceCreateEntityParamsItemEntity | LuaSurfaceCreateEntityParamsItemRequestProxy | LuaSurfaceCreateEntityParamsLamp | LuaSurfaceCreateEntityParamsLoader | LuaSurfaceCreateEntityParamsLoader1x1 | LuaSurfaceCreateEntityParamsLocomotive | LuaSurfaceCreateEntityParamsLogisticContainer | LuaSurfaceCreateEntityParamsParticle | LuaSurfaceCreateEntityParamsPlant | LuaSurfaceCreateEntityParamsProgrammableSpeaker | LuaSurfaceCreateEntityParamsProjectile | LuaSurfaceCreateEntityParamsRailChainSignal | LuaSurfaceCreateEntityParamsRailSignal | LuaSurfaceCreateEntityParamsResource | LuaSurfaceCreateEntityParamsRollingStock | LuaSurfaceCreateEntityParamsSimpleEntityWithForce | LuaSurfaceCreateEntityParamsSimpleEntityWithOwner | LuaSurfaceCreateEntityParamsSpeechBubble | LuaSurfaceCreateEntityParamsStream | LuaSurfaceCreateEntityParamsTileGhost | LuaSurfaceCreateEntityParamsUndergroundBelt;
+type LuaSurfaceCreateEntityParams = BaseLuaSurfaceCreateEntityParams | LuaSurfaceCreateEntityParamsArtilleryFlare | LuaSurfaceCreateEntityParamsArtilleryProjectile | LuaSurfaceCreateEntityParamsAssemblingMachine | LuaSurfaceCreateEntityParamsBeam | LuaSurfaceCreateEntityParamsCharacterCorpse | LuaSurfaceCreateEntityParamsCliff | LuaSurfaceCreateEntityParamsContainer | LuaSurfaceCreateEntityParamsElectricPole | LuaSurfaceCreateEntityParamsEntityGhost | LuaSurfaceCreateEntityParamsFire | LuaSurfaceCreateEntityParamsHighlightBox | LuaSurfaceCreateEntityParamsInserter | LuaSurfaceCreateEntityParamsItemEntity | LuaSurfaceCreateEntityParamsItemRequestProxy | LuaSurfaceCreateEntityParamsLamp | LuaSurfaceCreateEntityParamsLoader | LuaSurfaceCreateEntityParamsLoader1x1 | LuaSurfaceCreateEntityParamsLocomotive | LuaSurfaceCreateEntityParamsLogisticContainer | LuaSurfaceCreateEntityParamsParticle | LuaSurfaceCreateEntityParamsPlant | LuaSurfaceCreateEntityParamsProgrammableSpeaker | LuaSurfaceCreateEntityParamsProjectile | LuaSurfaceCreateEntityParamsProjectile | LuaSurfaceCreateEntityParamsRailChainSignal | LuaSurfaceCreateEntityParamsRailSignal | LuaSurfaceCreateEntityParamsResource | LuaSurfaceCreateEntityParamsRollingStock | LuaSurfaceCreateEntityParamsSimpleEntityWithForce | LuaSurfaceCreateEntityParamsSimpleEntityWithOwner | LuaSurfaceCreateEntityParamsSpeechBubble | LuaSurfaceCreateEntityParamsStream | LuaSurfaceCreateEntityParamsTileGhost | LuaSurfaceCreateEntityParamsUndergroundBelt;
 interface BaseLuaSurfaceCreateEntityParams {
     /**
      * Cause entity / force. The entity or force that triggered the chain of events that led to this entity being created. Used for beams, projectiles, stickers, etc. so that the damage receiver can know which entity or force to retaliate against.
@@ -18137,6 +18386,14 @@ interface LuaSurfaceCreateEntityParamsProjectile extends BaseLuaSurfaceCreateEnt
      */
     'speed'?: double;
 }
+/**
+ *
+ * Applies to variant case `projectile`
+ */
+interface LuaSurfaceCreateEntityParamsProjectile extends BaseLuaSurfaceCreateEntityParams {
+    'base_damage_modifiers'?: TriggerModifierData;
+    'bonus_damage_modifiers'?: TriggerModifierData;
+}
 /**
  *
  * Applies to variant case `rail-chain-signal`
@@ -19058,6 +19315,10 @@ interface LuaTransportLine {
      * The entity this transport line belongs to.
      */
     readonly owner: LuaEntity;
+    /**
+     * Total length of segment which consists of this line, all lines in front and lines in the back directly connected.
+     */
+    readonly total_segment_length: double;
     /**
      * Is this object valid? This Lua object holds a reference to an object within the game engine. It is possible that the game-engine object is removed whilst a mod still holds the corresponding Lua object. If that happens, the object becomes invalid, i.e. this attribute will be `false`. Mods are advised to check for object validity if any change to the game state might have occurred between the creation of the Lua object and its access.
      */