factorio-types 0.0.14 → 0.0.18

package/dist/classes.d.ts

@@ -2,7 +2,7 @@
 // Factorio API reference https://lua-api.factorio.com/latest/index.html
 // Generated from JSON source https://lua-api.factorio.com/latest/runtime-api.json
 // Definition source https://github.com/sguest/factorio-types
-// Factorio version 1.1.42
+// Factorio version 1.1.49
 // API version 1
 
 /**
@@ -299,10 +299,12 @@ interface LuaBootstrap {
 
     /**
      * Register a function to be run on save load. This is only called for mods that have been part of the save previously, or for players connecting to a running multiplayer session. It gives the mod the opportunity to do some very specific actions, should it need to. Doing anything other than these three will lead to desyncs, which breaks multiplayer and replay functionality. Access to {@link LuaGameScript | LuaGameScript} and {@link LuaRendering | LuaRendering} is not available. The `global` table can be accessed and is safe to read from, but not write to.
+     * 
      * The only legitimate uses of this event are these three:
      * - Re-setup {@link metatables | https://www.lua.org/pil/13.html} as they are not persisted through save-load.
      * - Re-setup conditional event handlers.
      * - Create local references to data stored in the {@link global | Global.html} table.
+     * 
      * For all other purposes, {@link LuaBootstrap::on_init | LuaBootstrap::on_init}, {@link LuaBootstrap::on_configuration_changed | LuaBootstrap::on_configuration_changed} or migration scripts should be used instead.
      * @param f - The handler for this event. Passing `nil` will unregister it.
      */
@@ -340,6 +342,7 @@ interface LuaBootstrap {
 
     /**
      * Raise an event. Only events generated with {@link LuaBootstrap::generate_event_name | LuaBootstrap::generate_event_name} and the following can be raised:
+     * 
      * - {@link on_console_chat | on_console_chat}
      * - {@link on_player_crafted_item | on_player_crafted_item}
      * - {@link on_player_fast_transferred | on_player_fast_transferred}
@@ -626,6 +629,7 @@ interface LuaBurnerPrototype {
 
 /**
  * A chunk iterator can be used for iterating chunks coordinates of a surface.
+ * 
  * The returned type is a {@link ChunkPositionAndArea | ChunkPositionAndArea} containing the chunk coordinates and its area.
  * @example
  * ```
@@ -985,23 +989,19 @@ interface LuaControl {
 
     /**
      * Gets the parameters of a personal logistic request and auto-trash slot.
-     * @remarks
-     * This will silently return an empty value (`name` will be `nil`) if personal logistics are not researched yet.
-     *
      * @param slot_index - The slot to get.
+     * @returns The logistic parameters. If personal logistics are not researched yet, their `name` will be `nil`.
      */
     get_personal_logistic_slot(this: void,
-        slot_index: number): PersonalLogisticParameters
+        slot_index: number): LogisticParameters
 
     /**
      * Gets the parameters of a vehicle logistic request and auto-trash slot.
-     * @remarks
-     * This will silently return an empty value (`name` will be `nil`) if the vehicle does not use logistics.
-     *
      * @param slot_index - The slot to get.
+     * @returns The logistic parameters. If the vehicle does not use logistics, their `name` will be `nil`.
      */
     get_vehicle_logistic_slot(this: void,
-        slot_index: number): PersonalLogisticParameters
+        slot_index: number): LogisticParameters
 
     /**
      * Does this entity have any item inside it?
@@ -1017,7 +1017,10 @@ interface LuaControl {
         items: ItemStackIdentification): number
 
     /**
-     * Returns whether the player is holding a blueprint, it takes into account a blueprint as an item as well as blueprint from the blueprint record from the blueprint library. Note that the is_cursor_blueprint and get_cursor_blueprint_entities refer to the currently selected blueprint, so it returns blueprint related information also when holding a blueprint book with a blueprint being selected in it.
+     * Returns whether the player is holding a blueprint. This takes both blueprint items as well as blueprint records from the blueprint library into account.
+     * @remarks
+     * Both this method and {@link LuaControl::get_blueprint_entities | LuaControl::get_blueprint_entities} refer to the currently selected blueprint, meaning a blueprint book with a selected blueprint will return the information as well.
+     *
      */
     is_cursor_blueprint(this: void): boolean
 
@@ -1077,29 +1080,23 @@ interface LuaControl {
 
     /**
      * Sets a personal logistic request and auto-trash slot to the given value.
-     * @remarks
-     * This will silently fail if personal logistics are not researched yet.
-     *
      * @param slot_index - The slot to set.
      * @param value - The logistic request parameters.
-     * @returns Whether the slot was set successfully.
+     * @returns Whether the slot was set successfully. `false` if personal logistics are not researched yet.
      */
     set_personal_logistic_slot(this: void,
         slot_index: number,
-        value: PersonalLogisticParameters): boolean
+        value: LogisticParameters): boolean
 
     /**
      * Sets a vehicle logistic request and auto-trash slot to the given value.
-     * @remarks
-     * This will silently fail if the vehicle does not use logistics.
-     *
      * @param slot_index - The slot to set.
      * @param value - The logistic request parameters.
-     * @returns Whether the slot was set successfully.
+     * @returns Whether the slot was set successfully. `false` if the vehicle does not use logistics.
      */
     set_vehicle_logistic_slot(this: void,
         slot_index: number,
-        value: PersonalLogisticParameters): boolean
+        value: LogisticParameters): boolean
 
     /**
      * Teleport the entity to a given position, possibly on another surface.
@@ -1112,7 +1109,7 @@ interface LuaControl {
      * @returns `true` when the entity was successfully teleported.
      */
     teleport(this: void,
-        position: Position,
+        position: MapPosition,
         surface?: SurfaceIdentification): boolean
 
     /**
@@ -1120,7 +1117,7 @@ interface LuaControl {
      * @param position - Position of the entity to select
      */
     update_selected_entity(this: void,
-        position: Position): void
+        position: MapPosition): void
 
     /**
      * The build distance of this character or max uint when not a character or player connected to a character.
@@ -1278,7 +1275,7 @@ interface LuaControl {
      * ```
      *
      */
-    readonly cursor_stack: LuaItemStack
+    readonly cursor_stack?: LuaItemStack
 
     /**
      * `true` if the player is in a vehicle. Writing to this attribute puts the player in or out of a vehicle.
@@ -1328,17 +1325,18 @@ interface LuaControl {
 
     /**
      * The GUI the player currently has open, or `nil` if no GUI is open. Writing to it fires the {@link on_gui_opened | on_gui_opened} event.
+     * 
      * This is the GUI that will asked to close (by firing the {@link on_gui_closed | on_gui_closed} event) when the `Esc` or `E` keys are pressed. If this attribute is not `nil`, and a new GUI is written to it, the existing one will be asked to close.
      * @remarks
      * Write supports any of the types. Read will return the `entity`, `equipment`, `equipment-grid`, `player`, `element` or `nil`.
      *
      */
-    opened: LuaEntity | LuaItemStack | LuaEquipment | LuaEquipmentGrid | LuaPlayer | LuaGuiElement | defines.gui_type
+    opened?: LuaEntity | LuaItemStack | LuaEquipment | LuaEquipmentGrid | LuaPlayer | LuaGuiElement | defines.gui_type
 
     /**
      * Returns the {@link defines.gui_type | defines.gui_type} or `nil`.
      */
-    readonly opened_gui_type: defines.gui_type
+    readonly opened_gui_type?: defines.gui_type
 
     /**
      * Current item-picking state.
@@ -1348,7 +1346,7 @@ interface LuaControl {
     /**
      * Current position of the entity.
      */
-    readonly position: Position
+    readonly position: MapPosition
 
     /**
      * The reach distance of this character or max uint when not a character or player connected to a character.
@@ -1541,7 +1539,7 @@ interface LuaCustomInputPrototype {
     /**
      * The item that gets spawned when this custom input is fired or `nil`.
      */
-    readonly item_to_spawn: LuaItemPrototype
+    readonly item_to_spawn?: LuaItemPrototype
 
     /**
      * The default key sequence for this custom input.
@@ -1551,7 +1549,7 @@ interface LuaCustomInputPrototype {
     /**
      * The linked game control name or `nil`.
      */
-    readonly linked_game_control: string
+    readonly linked_game_control?: string
 
     readonly localised_description: LocalisedString
 
@@ -1581,6 +1579,7 @@ interface LuaCustomInputPrototype {
 
 /**
  * Lazily evaluated table. For performance reasons, we sometimes return a custom table-like type instead of a native Lua table. This custom type lazily constructs the necessary Lua wrappers of the corresponding C++ objects, therefore preventing their unnecessary construction in some cases.
+ * 
  * There are some notable consequences to the usage of a custom table type rather than the native Lua table type: Iterating a custom table is only possible using the `pairs` Lua function; `ipairs` won't work. Another key difference is that custom tables cannot be serialised into a game save file -- if saving the game would require serialisation of a custom table, an error will be displayed and the game will not be saved.
  * @example
  * In previous versions of Factorio, this would create a [LuaPlayer](LuaPlayer) instance for every player in the game, even though only one such wrapper is needed. In the current version, accessing [game.players](LuaGameScript::players) by itself does not create any [LuaPlayer](LuaPlayer) instances; they are created lazily when accessed. Therefore, this example only constructs one [LuaPlayer](LuaPlayer) instance, no matter how many elements there are in `game.players`. 
@@ -1798,6 +1797,7 @@ interface LuaElectricEnergySourcePrototype {
 
 /**
  * The primary interface for interacting with entities through the Lua API. Entities are everything that exists on the map except for tiles (see {@link LuaTile | LuaTile}).
+ * 
  * Most functions on LuaEntity also work when the entity is contained in a ghost.
  */
 interface LuaEntity extends LuaControl {
@@ -1809,7 +1809,7 @@ interface LuaEntity extends LuaControl {
      * @param position - The position the spidertron should move to.
      */
     add_autopilot_destination(this: void,
-        position: Position): void
+        position: MapPosition): void
 
     /**
      * Offer a thing on the market.
@@ -1843,7 +1843,7 @@ interface LuaEntity extends LuaControl {
      */
     can_shoot(this: void,
         target: LuaEntity,
-        position: Position): boolean
+        position: MapPosition): boolean
 
     /**
      * Can wires reach between these entities.
@@ -1905,7 +1905,7 @@ interface LuaEntity extends LuaControl {
      */
     clone(this: void,
         table: {
-            position: Position,
+            position: MapPosition,
             surface?: LuaSurface,
             force?: ForceIdentification,
             create_build_effect_smoke?: boolean
@@ -1913,6 +1913,7 @@ interface LuaEntity extends LuaControl {
 
     /**
      * Connects current linked belt with another one.
+     * 
      * Neighbours have to be of different type. If given linked belt is connected to something else it will be disconnected first. If provided neighbour is connected to something else it will also be disconnected first. Automatically updates neighbour to be connected back to this one.
      * @remarks
      * Can also be used on entity ghost if it contains linked-belt
@@ -1925,6 +1926,7 @@ interface LuaEntity extends LuaControl {
 
     /**
      * Connect two devices with a circuit wire or copper cable. Depending on which type of connection should be made, there are different procedures:
+     * 
      * - To connect two electric poles, `target` must be a {@link LuaEntity | LuaEntity} that specifies another electric pole. This will connect them with copper cable.
      * - To connect two devices with circuit wire, `target` must be a table of type {@link WireConnectionDefinition | WireConnectionDefinition}.
      * @param target - The target with which to establish a connection.
@@ -1996,6 +1998,7 @@ interface LuaEntity extends LuaControl {
 
     /**
      * Immediately kills the entity. Does nothing if the entity doesn't have health.
+     * 
      * Unlike {@link LuaEntity::destroy | LuaEntity::destroy}, `die` will trigger the {@link on_entity_died | on_entity_died} event and the entity will produce a corpse and drop loot if it has any.
      * @remarks
      * If `force` is not specified, `on_entity_died` will blame the `"neutral"` force.
@@ -2025,6 +2028,7 @@ interface LuaEntity extends LuaControl {
 
     /**
      * Disconnect circuit wires or copper cables between devices. Depending on which type of connection should be cut, there are different procedures:
+     * 
      * - To remove all copper cables, leave the `target` parameter blank: `pole.disconnect_neighbour()`.
      * - To remove all wires of a specific color, set `target` to {@link defines.wire_type.red | defines.wire_type.red} or {@link defines.wire_type.green | defines.wire_type.green}.
      * - To remove a specific copper cable between two electric poles, `target` must be a {@link LuaEntity | LuaEntity} that specifies the other pole: `pole1.disconnect_neighbour(pole2)`.
@@ -2134,12 +2138,18 @@ interface LuaEntity extends LuaControl {
 
     /**
      * Get amounts of all fluids in this entity.
+     * @remarks
+     * If information about fluid temperatures is required, {@link LuaEntity::fluidbox | LuaEntity::fluidbox} should be used instead.
+     *
      * @returns The amounts, indexed by fluid names.
      */
     get_fluid_contents(this: void): {[key: string]: number}
 
     /**
      * Get the amount of all or some fluid in this entity.
+     * @remarks
+     * If information about fluid temperatures is required, {@link LuaEntity::fluidbox | LuaEntity::fluidbox} should be used instead.
+     *
      * @param fluid - Prototype name of the fluid to count. If not specified, count all fluids.
      */
     get_fluid_count(this: void,
@@ -2339,7 +2349,7 @@ interface LuaEntity extends LuaControl {
      * @remarks
      * Applies to subclasses: TransportBeltConnectable
      *
-     * @param index - Index of the requested transport line.
+     * @param index - Index of the requested transport line. Transport lines are 1-indexed.
      */
     get_transport_line(this: void,
         index: number): LuaTransportLine
@@ -2357,11 +2367,11 @@ interface LuaEntity extends LuaControl {
     get_upgrade_target(this: void): LuaEntityPrototype
 
     /**
-     * Same as {@link LuaEntity::has_flag | LuaEntity::has_flag} but targets the inner entity on a entity ghost.
+     * Same as {@link LuaEntity::has_flag | LuaEntity::has_flag}, but targets the inner entity on a entity ghost.
      * @remarks
      * Applies to subclasses: EntityGhost
      *
-     * @param flag - The flag to test
+     * @param flag - The flag to test. See [EntityPrototypeFlags](EntityPrototypeFlags) for a list of flags.
      * @returns `true` if the entity has the given flag set.
      */
     ghost_has_flag(this: void,
@@ -2376,12 +2386,12 @@ interface LuaEntity extends LuaControl {
     has_command(this: void): boolean
 
     /**
-     * Test whether this entity's prototype has a flag set.
+     * Test whether this entity's prototype has a certain flag set.
      * @remarks
      * `entity.has_flag(f)` is a shortcut for `entity.prototype.has_flag(f)`.
      *
-     * @param flag - The flag to test
-     * @returns `true` if the entity has the given flag set.
+     * @param flag - The flag to test. See [EntityPrototypeFlags](EntityPrototypeFlags) for a list of flags.
+     * @returns `true` if this entity has the given flag set.
      */
     has_flag(this: void,
         flag: string): boolean
@@ -2855,7 +2865,7 @@ interface LuaEntity extends LuaControl {
      * Applies to subclasses: Character
      *
      */
-    associated_player: LuaPlayer
+    associated_player?: LuaPlayer
 
     /**
      * Whether this rocket silo automatically launches the rocket when cargo is inserted.
@@ -2871,7 +2881,7 @@ interface LuaEntity extends LuaControl {
      * Applies to subclasses: SpiderVehicle
      *
      */
-    autopilot_destination: Position
+    autopilot_destination?: MapPosition
 
     /**
      * The queued destination positions of spidertron's autopilot.
@@ -2879,7 +2889,7 @@ interface LuaEntity extends LuaControl {
      * Applies to subclasses: SpiderVehicle
      *
      */
-    readonly autopilot_destinations: Position[]
+    readonly autopilot_destinations: MapPosition[]
 
     /**
      * The backer name assigned to this entity, or `nil` if this entity doesn't support backer names. Entities that support backer names are labs, locomotives, radars, roboports, and train stops.
@@ -2887,7 +2897,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
+    backer_name?: string
 
     /**
      * The belt connectable neighbours of this belt connectable entity. Only entities that input to or are outputs of this entity. Does not contain the other end of an underground belt, see {@link LuaEntity::neighbours | LuaEntity::neighbours} for that. This is a dictionary with `"inputs"`, `"outputs"` entries that are arrays of transport belt connectable entities, or empty tables if no entities.
@@ -2908,7 +2918,7 @@ interface LuaEntity extends LuaControl {
     /**
      * The bonus mining progress for this mining drill or `nil` if this isn't a mining drill. Read yields a number in range [0, mining_target.prototype.mineable_properties.mining_time]
      */
-    bonus_mining_progress: number
+    bonus_mining_progress?: number
 
     /**
      * The current productivity bonus progress, as a number in range [0, 1].
@@ -2926,7 +2936,7 @@ interface LuaEntity extends LuaControl {
     /**
      * The burner energy source for this entity or `nil` if there isn't one.
      */
-    readonly burner: LuaBurner
+    readonly burner?: LuaBurner
 
     /**
      * The state of this chain signal.
@@ -2982,7 +2992,7 @@ interface LuaEntity extends LuaControl {
      * Car color is overridden by the color of the current driver/passenger, if there is one.
      *
      */
-    color: Color
+    color?: Color
 
     /**
      * The owner of this combat robot if any.
@@ -2995,7 +3005,7 @@ interface LuaEntity extends LuaControl {
      * Applies to subclasses: Unit
      *
      */
-    readonly command: Command
+    readonly command?: Command
 
     /**
      * The rail entity this train stop is connected to or `nil` if there is none.
@@ -3003,7 +3013,15 @@ interface LuaEntity extends LuaControl {
      * Applies to subclasses: TrainStop
      *
      */
-    readonly connected_rail: LuaEntity
+    readonly connected_rail?: LuaEntity
+
+    /**
+     * Rail direction to which this train stop is binding. This returns a value even when no rails are present.
+     * @remarks
+     * Applies to subclasses: TrainStop
+     *
+     */
+    readonly connected_rail_direction: defines.rail_direction
 
     /**
      * The consumption bonus of this entity.
@@ -3078,7 +3096,7 @@ interface LuaEntity extends LuaControl {
      * Applies to subclasses: Unit
      *
      */
-    readonly distraction_command: Command
+    readonly distraction_command?: Command
 
     /**
      * Whether the driver of this car or spidertron is the gunner, if false, the passenger is the gunner.
@@ -3094,12 +3112,12 @@ interface LuaEntity extends LuaControl {
     drop_position: Position
 
     /**
-     * The entity this entity is putting its stuff to or `nil` if there is no such entity.
+     * The entity this entity is putting its items to, or `nil` if there is no such entity. If there are multiple possible entities at the drop-off point, writing to this attribute allows a mod to choose which one to drop off items to. The entity needs to collide with the tile box under the drop-off position.
      * @remarks
-     * Meaningful only for entities that put stuff somewhere, such as mining drills or inserters.
+     * Meaningful only for entities that put items somewhere, such as mining drills or inserters. Returns `nil` for any other entity.
      *
      */
-    drop_target: LuaEntity
+    drop_target?: LuaEntity
 
     /**
      * The current speed of this unit in tiles per tick, taking into account any walking speed modifier given by the tile the unit is standing on.
@@ -3120,7 +3138,7 @@ interface LuaEntity extends LuaControl {
     /**
      * The effects being applied to this entity or `nil`. For beacons this is the effect the beacon is broadcasting.
      */
-    readonly effects: ModuleEffects
+    readonly effects?: ModuleEffects
 
     /**
      * The buffer size for the electric energy source or nil if the entity doesn't have an electric energy source.
@@ -3148,7 +3166,7 @@ interface LuaEntity extends LuaControl {
     /**
      * Returns the id of the electric network that this entity is connected to or `nil`.
      */
-    readonly electric_network_id: number
+    readonly electric_network_id?: number
 
     /**
      * The electric network statistics for this electric pole.
@@ -3196,7 +3214,7 @@ interface LuaEntity extends LuaControl {
      * only usable on entities that have labels (currently only spider-vehicles).
      *
      */
-    entity_label: string
+    entity_label?: string
 
     /**
      * The number of filter slots this inserter, loader, or logistic storage container has. 0 if not one of those entities.
@@ -3288,12 +3306,12 @@ interface LuaEntity extends LuaControl {
     /**
      * The graphics variation for this entity or `nil` if this entity doesn't use graphics variations.
      */
-    graphics_variation: number
+    graphics_variation?: number
 
     /**
      * The equipment grid or `nil` if this entity doesn't have an equipment grid.
      */
-    readonly grid: LuaEquipmentGrid
+    readonly grid?: LuaEquipmentGrid
 
     /**
      * The current health of the entity, or `nil` if it doesn't have health. Health is automatically clamped to be between `0` and max health (inclusive). Entities with a health of `0` can not be attacked.
@@ -3301,7 +3319,7 @@ interface LuaEntity extends LuaControl {
      * To get the maximum possible health of this entity, see {@link LuaEntityPrototype::max_health | LuaEntityPrototype::max_health} on its prototype.
      *
      */
-    health: number
+    health?: number
 
     /**
      * The item stack currently held in an inserter's hand.
@@ -3358,7 +3376,7 @@ interface LuaEntity extends LuaControl {
      * Applies to subclasses: Inserter
      *
      */
-    inserter_filter_mode: string
+    inserter_filter_mode?: string
 
     /**
      * Sets the stack size limit on this inserter. If the stack size is > than the force stack size limit the value is ignored.
@@ -3473,7 +3491,7 @@ interface LuaEntity extends LuaControl {
     /**
      * The mining progress for this mining drill or `nil` if this isn't a mining drill. Is a number in range [0, mining_target.prototype.mineable_properties.mining_time]
      */
-    mining_progress: number
+    mining_progress?: number
 
     /**
      * The mining target or `nil` if none
@@ -3481,7 +3499,7 @@ interface LuaEntity extends LuaControl {
      * Applies to subclasses: MiningDrill
      *
      */
-    readonly mining_target: LuaEntity
+    readonly mining_target?: LuaEntity
 
     /**
      * Returns true if this unit is moving.
@@ -3510,7 +3528,7 @@ interface LuaEntity extends LuaControl {
      * - When called on an underground transport belt, this is the other end of the underground belt connection, or `nil` if none.
      * - When called on a wall-connectable entity or reactor, this is a dictionary of all connections indexed by the connection direction "north", "south", "east", and "west".
      */
-    readonly neighbours: {[key: string]: LuaEntity[]} | Array<LuaEntity[]> | LuaEntity
+    readonly neighbours?: {[key: string]: LuaEntity[]} | Array<LuaEntity[]> | LuaEntity
 
     /**
      * 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.
@@ -3544,12 +3562,12 @@ interface LuaEntity extends LuaControl {
     pickup_position: Position
 
     /**
-     * The entity the inserter will attempt to pick up from. For example, this can be a transport belt or a storage chest.
+     * The entity this inserter will attempt to pick up items from, or `nil` if there is no such entity. If there are multiple possible entities at the pick-up point, writing to this attribute allows a mod to choose which one to pick up items from. The entity needs to collide with the tile box under the pick-up position.
      * @remarks
      * Applies to subclasses: Inserter
      *
      */
-    pickup_target: LuaEntity
+    pickup_target?: LuaEntity
 
     /**
      * The player connected to this character or `nil` if none.
@@ -3557,7 +3575,7 @@ interface LuaEntity extends LuaControl {
      * Applies to subclasses: Character
      *
      */
-    readonly player: LuaPlayer
+    readonly player?: LuaPlayer
 
     /**
      * The pollution bonus of this entity.
@@ -3617,7 +3635,7 @@ interface LuaEntity extends LuaControl {
     /**
      * The target entity for this item-request-proxy or `nil`
      */
-    readonly proxy_target: LuaEntity
+    readonly proxy_target?: LuaEntity
 
     /**
      * The rail target of this pump or `nil`.
@@ -3625,7 +3643,7 @@ interface LuaEntity extends LuaControl {
      * Applies to subclasses: Pump
      *
      */
-    readonly pump_rail_target: LuaEntity
+    readonly pump_rail_target?: LuaEntity
 
     /**
      * When locked; the recipe in this assembling machine can't be changed by the player.
@@ -3641,7 +3659,7 @@ interface LuaEntity extends LuaControl {
      * Writing does nothing if the vehicle doesn't have a turret.
      *
      */
-    relative_turret_orientation: RealOrientation
+    relative_turret_orientation?: RealOrientation
 
     /**
      * If items not included in this infinity container filters should be removed from the container.
@@ -3696,12 +3714,12 @@ interface LuaEntity extends LuaControl {
     /**
      * The secondary bounding box of this entity or `nil` if it doesn't have one.
      */
-    readonly secondary_bounding_box: BoundingBox
+    readonly secondary_bounding_box?: BoundingBox
 
     /**
      * The secondary selection box of this entity or `nil` if it doesn't have one.
      */
-    readonly secondary_selection_box: BoundingBox
+    readonly secondary_selection_box?: BoundingBox
 
     /**
      * Index of the currently selected weapon slot of this character, car, or spidertron, or `nil` if the car/spidertron doesn't have guns.
@@ -3709,7 +3727,7 @@ interface LuaEntity extends LuaControl {
      * Applies to subclasses: Character,Car
      *
      */
-    selected_gun_index: number
+    selected_gun_index?: number
 
     /**
      * {@link LuaEntityPrototype::selection_box | LuaEntityPrototype::selection_box} around entity's given position and respecting the current entity orientation.
@@ -3719,7 +3737,7 @@ interface LuaEntity extends LuaControl {
     /**
      * The shooting target for this turret or `nil`.
      */
-    shooting_target: LuaEntity
+    shooting_target?: LuaEntity
 
     /**
      * The state of this rail signal.
@@ -3732,7 +3750,7 @@ interface LuaEntity extends LuaControl {
     /**
      * The spawner associated with this unit entity or `nil` if the unit has no associated spawner.
      */
-    readonly spawner: LuaEntity
+    readonly spawner?: LuaEntity
 
     /**
      * The current speed of this car in tiles per tick, rolling stock, projectile or spider vehicle, or current max speed of the unit. Only the speed of units, cars, and projectiles are writable.
@@ -3753,7 +3771,7 @@ interface LuaEntity extends LuaControl {
      * Applies to subclasses: Splitter
      *
      */
-    splitter_filter: LuaItemPrototype
+    splitter_filter?: LuaItemPrototype
 
     /**
      * The input priority for this splitter : "left", "none", or "right".
@@ -3781,7 +3799,7 @@ interface LuaEntity extends LuaControl {
     /**
      * The status of this entity or `nil` if no status.
      */
-    readonly status: defines.entity_status
+    readonly status?: defines.entity_status
 
     /**
      * The entity this sticker is sticked to.
@@ -3791,7 +3809,7 @@ interface LuaEntity extends LuaControl {
     /**
      * The sticker entities attached to this entity or `nil` if none.
      */
-    readonly stickers: LuaEntity[]
+    readonly stickers?: LuaEntity[]
 
     /**
      * The storage filter for this logistic storage container.
@@ -3806,12 +3824,12 @@ interface LuaEntity extends LuaControl {
     /**
      * The tags associated with this entity ghost or `nil` if not an entity ghost.
      */
-    tags: Tags
+    tags?: Tags
 
     /**
      * The temperature of this entities heat energy source if this entity uses a heat energy source or `nil`.
      */
-    temperature: number
+    temperature?: number
 
     /**
      * The text of this flying-text entity.
@@ -3839,6 +3857,7 @@ interface LuaEntity extends LuaControl {
 
     /**
      * The ticks left before a ghost, combat robot, highlight box or smoke with trigger is destroyed.
+     * 
      * - for ghosts set to uint32 max (4,294,967,295) to never expire.
      * - for ghosts Cannot be set higher than {@link LuaForce::ghost_time_to_live | LuaForce::ghost_time_to_live} of the entity's force.
      */
@@ -3949,7 +3968,7 @@ interface LuaEntity extends LuaControl {
      * Applies to subclasses: Unit
      *
      */
-    readonly unit_group: LuaUnitGroup
+    readonly unit_group?: LuaUnitGroup
 
     /**
      * The unit number or nil if the entity doesn't have one. This is universally unique for every entity that has one, for the lifetime of a whole game.
@@ -3987,30 +4006,9 @@ interface LuaEntityPrototype {
         index: defines.inventory): number
 
     /**
-     * Does this prototype have a flag enabled?
-     * @param flag - The flag to check. Must be one of 
-- `"not-rotatable"`
-- `"placeable-neutral"`
-- `"placeable-player"`
-- `"placeable-enemy"`
-- `"placeable-off-grid"`
-- `"player-creation"`
-- `"building-direction-8-way"`
-- `"filter-directions"`
-- `"fast-replaceable-no-build-while-moving"`
-- `"breaths-air"`
-- `"not-repairable"`
-- `"not-on-map"`
-- `"not-deconstructable"`
-- `"not-blueprintable"`
-- `"hide-from-bonus-gui"`
-- `"hide-alt-info"`
-- `"fast-replaceable-no-cross-type-while-moving"`
-- `"no-gap-fill-while-building"`
-- `"not-flammable"`
-- `"no-automated-item-removal"`
-- `"no-automated-item-insertion"`
-- `"not-upgradable"`
+     * Test whether this entity prototype has a certain flag set.
+     * @param flag - The flag to test. See [EntityPrototypeFlags](EntityPrototypeFlags) for a list of flags.
+     * @returns `true` if this prototype has the given flag set.
      */
     has_flag(this: void,
         flag: string): boolean
@@ -4052,12 +4050,12 @@ interface LuaEntityPrototype {
     /**
      * Whether this unit prototype is affected by tile walking speed modifiers or `nil`.
      */
-    readonly affected_by_tiles: boolean
+    readonly affected_by_tiles?: boolean
 
     /**
      * The air resistance of this rolling stock prototype or `nil` if not a rolling stock prototype.
      */
-    readonly air_resistance: number
+    readonly air_resistance?: number
 
     /**
      * The alert icon shift of this entity prototype.
@@ -4067,12 +4065,12 @@ interface LuaEntityPrototype {
     /**
      * Does this turret prototype alert when attacking? or `nil` if not turret prototype.
      */
-    readonly alert_when_attacking: boolean
+    readonly alert_when_attacking?: boolean
 
     /**
      * Does this entity with health prototype alert when damaged? or `nil` if not entity with health prototype.
      */
-    readonly alert_when_damaged: boolean
+    readonly alert_when_damaged?: boolean
 
     /**
      * If this market allows access to all forces or just friendly ones.
@@ -4102,17 +4100,17 @@ interface LuaEntityPrototype {
     /**
      * The allowed module effects for this entity or `nil`.
      */
-    readonly allowed_effects: {[key: string]: boolean}
+    readonly allowed_effects?: {[key: string]: boolean}
 
     /**
      * Whether the lamp is always on (except when out of power or turned off by the circuit network) or `nil`.
      */
-    readonly always_on: boolean
+    readonly always_on?: boolean
 
     /**
      * The attack parameters for this entity or `nil` if the entity doesn't use attack parameters.
      */
-    readonly attack_parameters: AttackParameters
+    readonly attack_parameters?: AttackParameters
 
     /**
      * The attack result of this entity if the entity has one, else `nil`.
@@ -4122,7 +4120,7 @@ interface LuaEntityPrototype {
     /**
      * The amount of ammo that inserters automatically insert into this ammo-turret or artillery-turret or `nil`.
      */
-    readonly automated_ammo_count: number
+    readonly automated_ammo_count?: number
 
     /**
      * Autoplace specification for this entity prototype. `nil` if none.
@@ -4132,7 +4130,7 @@ interface LuaEntityPrototype {
     /**
      * The base productivity of this crafting machine, lab, or mining drill, or `nil`.
      */
-    readonly base_productivity: number
+    readonly base_productivity?: number
 
     /**
      * @remarks
@@ -4151,12 +4149,12 @@ interface LuaEntityPrototype {
     /**
      * The speed of this transport belt or `nil` if this isn't a transport belt related prototype.
      */
-    readonly belt_speed: number
+    readonly belt_speed?: number
 
     /**
      * The braking force of this vehicle prototype or `nil` if not a vehicle prototype.
      */
-    readonly braking_force: number
+    readonly braking_force?: number
 
     /**
      * The evolution requirement to build this entity as a base when expanding enemy bases.
@@ -4178,14 +4176,14 @@ interface LuaEntityPrototype {
     /**
      * The burner energy source prototype this entity uses or `nil`.
      */
-    readonly burner_prototype: LuaBurnerPrototype
+    readonly burner_prototype?: LuaBurnerPrototype
 
     readonly call_for_help_radius: number
 
     /**
      * Whether this unit prototype can open gates or `nil`.
      */
-    readonly can_open_gates: boolean
+    readonly can_open_gates?: boolean
 
     /**
      * The collision mask used only for collision test with tile directly at offshore pump position.
@@ -4205,7 +4203,7 @@ interface LuaEntityPrototype {
     /**
      * The item prototype name used to destroy this cliff or `nil`.
      */
-    readonly cliff_explosive_prototype: string
+    readonly cliff_explosive_prototype?: string
 
     /**
      * The bounding box used for collision checking.
@@ -4237,17 +4235,17 @@ interface LuaEntityPrototype {
     /**
      * The color of the prototype, or `nil` if the prototype doesn't have color.
      */
-    readonly color: Color
+    readonly color?: Color
 
     /**
      * The construction radius for this roboport prototype or `nil`.
      */
-    readonly construction_radius: number
+    readonly construction_radius?: number
 
     /**
      * The energy consumption of this car prototype or `nil` if not a car prototype.
      */
-    readonly consumption: number
+    readonly consumption?: number
 
     /**
      * @remarks
@@ -4277,7 +4275,7 @@ interface LuaEntityPrototype {
     /**
      * The crafting speed of this crafting-machine or `nil`.
      */
-    readonly crafting_speed: number
+    readonly crafting_speed?: number
 
     /**
      * If this prototype will attempt to create a ghost of itself on death.
@@ -4290,12 +4288,12 @@ interface LuaEntityPrototype {
     /**
      * The trigger run when this entity is created or `nil`.
      */
-    readonly created_effect: TriggerItem[]
+    readonly created_effect?: TriggerItem[]
 
     /**
      * The smoke trigger run when this entity is built or `nil`.
      */
-    readonly created_smoke: { initial_height: number, max_radius?: number, offset_deviation: BoundingBox, offsets: Vector[], smoke_name: string, speed: Vector, speed_from_center: number, speed_from_center_deviation: number, speed_multiplier: number, speed_multiplier_deviation: number, starting_frame: number, starting_frame_deviation: number, starting_frame_speed: number, starting_frame_speed_deviation: number }
+    readonly created_smoke?: { initial_height: number, max_radius?: number, offset_deviation: BoundingBox, offsets: Vector[], smoke_name: string, speed: Vector, speed_from_center: number, speed_from_center_deviation: number, speed_multiplier: number, speed_multiplier_deviation: number, starting_frame: number, starting_frame_deviation: number, starting_frame_speed: number, starting_frame_speed_deviation: number }
 
     /**
      * @remarks
@@ -4307,12 +4305,12 @@ interface LuaEntityPrototype {
     /**
      * Value between 0 and 1 darkness where all lamps of this lamp prototype are off or `nil`.
      */
-    readonly darkness_for_all_lamps_off: number
+    readonly darkness_for_all_lamps_off?: number
 
     /**
      * Value between 0 and 1 darkness where all lamps of this lamp prototype are on or `nil`.
      */
-    readonly darkness_for_all_lamps_on: number
+    readonly darkness_for_all_lamps_on?: number
 
     /**
      * The hardcoded default collision mask (with flags) for this entity prototype type.
@@ -4322,22 +4320,22 @@ interface LuaEntityPrototype {
     /**
      * The distraction cooldown of this unit prototype or `nil`.
      */
-    readonly distraction_cooldown: number
+    readonly distraction_cooldown?: number
 
     /**
      * The distribution effectivity for this beacon prototype or `nil` if not a beacon prototype.
      */
-    readonly distribution_effectivity: number
+    readonly distribution_effectivity?: number
 
     /**
      * The door opening speed for this rocket silo prototype or `nil`.
      */
-    readonly door_opening_speed: number
+    readonly door_opening_speed?: number
 
     /**
      * Whether this logistics or construction robot renders its cargo when flying or `nil`.
      */
-    readonly draw_cargo: boolean
+    readonly draw_cargo?: boolean
 
     /**
      * The bounding box used for drawing the entity icon.
@@ -4354,12 +4352,12 @@ interface LuaEntityPrototype {
     /**
      * The effectivity of this car prototype, generator prototype or `nil`.
      */
-    readonly effectivity: number
+    readonly effectivity?: number
 
     /**
      * The electric energy source prototype this entity uses or `nil`.
      */
-    readonly electric_energy_source_prototype: LuaElectricEnergySourcePrototype
+    readonly electric_energy_source_prototype?: LuaElectricEnergySourcePrototype
 
     /**
      * Amount of pollution emissions per second this entity will create.
@@ -4374,27 +4372,27 @@ interface LuaEntityPrototype {
     /**
      * The energy used per hitpoint taken for this vehicle during collisions or `nil`.
      */
-    readonly energy_per_hit_point: number
+    readonly energy_per_hit_point?: number
 
     /**
      * The energy consumed per tile moved for this flying robot or `nil`.
      */
-    readonly energy_per_move: number
+    readonly energy_per_move?: number
 
     /**
      * The energy consumed per tick for this flying robot or `nil`.
      */
-    readonly energy_per_tick: number
+    readonly energy_per_tick?: number
 
     /**
      * The direct energy usage of this entity or `nil` if this entity doesn't have a direct energy usage.
      */
-    readonly energy_usage: number
+    readonly energy_usage?: number
 
     /**
      * The engine starting speed for this rocket silo rocket prototype or `nil`.
      */
-    readonly engine_starting_speed: number
+    readonly engine_starting_speed?: number
 
     /**
      * @remarks
@@ -4406,12 +4404,12 @@ interface LuaEntityPrototype {
     /**
      * Does this explosion have a beam or `nil` if not an explosion prototype.
      */
-    readonly explosion_beam: number
+    readonly explosion_beam?: number
 
     /**
      * Does this explosion rotate or `nil` if not an explosion prototype.
      */
-    readonly explosion_rotate: number
+    readonly explosion_rotate?: number
 
     /**
      * The group of mutually fast-replaceable entities. Possibly `nil`.
@@ -4421,7 +4419,7 @@ interface LuaEntityPrototype {
     /**
      * The filter count of this inserter, loader, or logistic chest or `nil`. For logistic containers, `nil` means no limit.
      */
-    readonly filter_count: number
+    readonly filter_count?: number
 
     /**
      * The final attack result for projectiles `nil` if not a projectile
@@ -4431,17 +4429,17 @@ interface LuaEntityPrototype {
     /**
      * The fixed recipe name for this assembling machine prototype or `nil`.
      */
-    readonly fixed_recipe: string
+    readonly fixed_recipe?: string
 
     /**
-     * The entity prototype flags for this entity.
+     * The flags for this entity prototype.
      */
     readonly flags: EntityPrototypeFlags
 
     /**
      * The fluid this offshore pump produces or `nil`.
      */
-    readonly fluid: LuaFluidPrototype
+    readonly fluid?: LuaFluidPrototype
 
     /**
      * The fluid capacity of this entity or 0 if this entity doesn't support fluids.
@@ -4454,12 +4452,12 @@ interface LuaEntityPrototype {
     /**
      * The fluid energy source prototype this entity uses or `nil`.
      */
-    readonly fluid_energy_source_prototype: LuaFluidEnergySourcePrototype
+    readonly fluid_energy_source_prototype?: LuaFluidEnergySourcePrototype
 
     /**
      * The fluid usage of this generator prototype or `nil`.
      */
-    readonly fluid_usage_per_tick: number
+    readonly fluid_usage_per_tick?: number
 
     /**
      * The fluidbox prototypes for this entity.
@@ -4469,17 +4467,17 @@ interface LuaEntityPrototype {
     /**
      * The flying acceleration for this rocket silo rocket prototype or `nil`.
      */
-    readonly flying_acceleration: number
+    readonly flying_acceleration?: number
 
     /**
      * The flying speed for this rocket silo rocket prototype or `nil`.
      */
-    readonly flying_speed: number
+    readonly flying_speed?: number
 
     /**
      * The friction of this vehicle prototype or `nil` if not a vehicle prototype.
      */
-    readonly friction_force: number
+    readonly friction_force?: number
 
     /**
      * The friendly map color used when charting this entity.
@@ -4489,7 +4487,7 @@ interface LuaEntityPrototype {
     /**
      * The equipment grid prototype for this entity or `nil`.
      */
-    readonly grid_prototype: LuaEquipmentGridPrototype
+    readonly grid_prototype?: LuaEquipmentGridPrototype
 
     /**
      * Group of this entity.
@@ -4499,7 +4497,7 @@ interface LuaEntityPrototype {
     /**
      * The guns this prototype uses or `nil`.
      */
-    readonly guns: {[key: string]: LuaItemPrototype}
+    readonly guns?: {[key: string]: LuaItemPrototype}
 
     /**
      * Whether this unit, car, or character prototype has belt immunity, `nil` if not car, unit, or character prototype.
@@ -4514,7 +4512,7 @@ interface LuaEntityPrototype {
     /**
      * The heat energy source prototype this entity uses or `nil`.
      */
-    readonly heat_energy_source_prototype: LuaHeatEnergySourcePrototype
+    readonly heat_energy_source_prototype?: LuaHeatEnergySourcePrototype
 
     /**
      * Every time this infinite resource 'ticks' down it is reduced by this amount. `nil` when not a resource. Meaningless if this isn't an infinite type resource.
@@ -4529,37 +4527,42 @@ interface LuaEntityPrototype {
     /**
      * The max number of ingredients this crafting-machine prototype supports or `nil` if this isn't a crafting-machine prototype.
      */
-    readonly ingredient_count: number
+    readonly ingredient_count?: number
 
     /**
      * True if this inserter chases items on belts for pickup or `nil`.
      */
-    readonly inserter_chases_belt_items: boolean
+    readonly inserter_chases_belt_items?: boolean
 
     /**
      * The drop position for this inserter or `nil`.
      */
-    readonly inserter_drop_position: Vector
+    readonly inserter_drop_position?: Vector
 
     /**
      * The extension speed of this inserter or `nil`.
      */
-    readonly inserter_extension_speed: number
+    readonly inserter_extension_speed?: number
 
     /**
      * The pickup position for this inserter or `nil`.
      */
-    readonly inserter_pickup_position: Vector
+    readonly inserter_pickup_position?: Vector
 
     /**
      * The rotation speed of this inserter or `nil`.
      */
-    readonly inserter_rotation_speed: number
+    readonly inserter_rotation_speed?: number
+
+    /**
+     * Gets the built-in stack size bonus of this inserter prototype. `nil` if this is not an inserter.
+     */
+    readonly inserter_stack_size_bonus: number
 
     /**
      * The instruments for this programmable speaker or `nil`.
      */
-    readonly instruments: ProgrammableSpeakerInstrument[]
+    readonly instruments?: ProgrammableSpeakerInstrument[]
 
     readonly is_building: boolean
 
@@ -4573,27 +4576,27 @@ interface LuaEntityPrototype {
     /**
      * The item slot count of this constant combinator prototype or `nil`.
      */
-    readonly item_slot_count: number
+    readonly item_slot_count?: number
 
     /**
      * Items that, when placed, will produce this entity. It is an array of items, or `nil` if no items place this entity. Construction bots will always choose the first item in this list to build this entity.
      */
-    readonly items_to_place_this: SimpleItemStack[]
+    readonly items_to_place_this?: SimpleItemStack[]
 
     /**
      * The item prototype names that are the inputs of this lab prototype or `nil`.
      */
-    readonly lab_inputs: string[]
+    readonly lab_inputs?: string[]
 
     /**
      * The rocket launch delay for this rocket silo prototype or `nil`.
      */
-    readonly launch_wait_time: number
+    readonly launch_wait_time?: number
 
     /**
      * The light blinking speed for this rocket silo prototype or `nil`.
      */
-    readonly light_blinking_speed: number
+    readonly light_blinking_speed?: number
 
     readonly localised_description: LocalisedString
 
@@ -4602,12 +4605,12 @@ interface LuaEntityPrototype {
     /**
      * The logistic mode of this logistic container or `nil` if this isn't a logistic container prototype. One of `"requester"`, `"active-provider"`, `"passive-provider"`, `"buffer"`, `"storage"`, `"none"`.
      */
-    readonly logistic_mode: string
+    readonly logistic_mode?: string
 
     /**
      * The logistic radius for this roboport prototype or `nil`.
      */
-    readonly logistic_radius: number
+    readonly logistic_radius?: number
 
     /**
      * Loot that will be dropped when this entity is killed. `nil` if there is no loot.
@@ -4624,7 +4627,7 @@ interface LuaEntityPrototype {
     /**
      * The map color used when charting this entity if a friendly or enemy color isn't defined or `nil`.
      */
-    readonly map_color: Color
+    readonly map_color?: Color
 
     /**
      * The bounding box used for map generator collision checking.
@@ -4659,7 +4662,7 @@ interface LuaEntityPrototype {
     /**
      * The max energy for this flying robot or `nil`.
      */
-    readonly max_energy: number
+    readonly max_energy?: number
 
     /**
      * The theoretical maximum energy production for this this entity.
@@ -4684,32 +4687,32 @@ interface LuaEntityPrototype {
     /**
      * The max payload size of this logistics or construction robot or `nil`.
      */
-    readonly max_payload_size: number
+    readonly max_payload_size?: number
 
     /**
      * The maximum polyphony for this programmable speaker or `nil`.
      */
-    readonly max_polyphony: number
+    readonly max_polyphony?: number
 
     /**
      * The maximum pursue distance of this unit prototype or `nil`.
      */
-    readonly max_pursue_distance: number
+    readonly max_pursue_distance?: number
 
     /**
      * The max speed of this projectile prototype or flying robot prototype or `nil`.
      */
-    readonly max_speed: number
+    readonly max_speed?: number
 
     /**
      * The maximum energy for this flying robot above which it won't try to recharge when stationing or `nil`.
      */
-    readonly max_to_charge: number
+    readonly max_to_charge?: number
 
     /**
      * The max underground distance for underground belts and underground pipes or `nil` if this isn't one of those prototypes.
      */
-    readonly max_underground_distance: number
+    readonly max_underground_distance?: number
 
     /**
      * The maximum wire distance for this entity. 0 when the entity doesn't support wires.
@@ -4726,7 +4729,7 @@ interface LuaEntityPrototype {
     /**
      * The maximum fluid temperature of this generator prototype or `nil`.
      */
-    readonly maximum_temperature: number
+    readonly maximum_temperature?: number
 
     /**
      * The minimum darkness at which this unit spawner can spawn entities.
@@ -4736,12 +4739,12 @@ interface LuaEntityPrototype {
     /**
      * The minimum pursue time of this unit prototype or `nil`.
      */
-    readonly min_pursue_time: number
+    readonly min_pursue_time?: number
 
     /**
      * The minimum energy for this flying robot before it tries to recharge or `nil`.
      */
-    readonly min_to_charge: number
+    readonly min_to_charge?: number
 
     /**
      * Whether this entity is minable and what can be obtained by mining it.
@@ -4756,22 +4759,22 @@ interface LuaEntityPrototype {
     /**
      * The mining radius of this mining drill prototype or `nil` if this isn't a mining drill prototype.
      */
-    readonly mining_drill_radius: number
+    readonly mining_drill_radius?: number
 
     /**
      * The mining speed of this mining drill/character prototype or `nil`.
      */
-    readonly mining_speed: number
+    readonly mining_speed?: number
 
     /**
      * The module inventory size or `nil` if this entity doesn't support modules.
      */
-    readonly module_inventory_size: number
+    readonly module_inventory_size?: number
 
     /**
      * Whether this unit prototype can move while shooting or `nil`.
      */
-    readonly move_while_shooting: boolean
+    readonly move_while_shooting?: boolean
 
     /**
      * Name of this prototype.
@@ -4796,7 +4799,7 @@ interface LuaEntityPrototype {
     /**
      * The next upgrade for this entity or `nil`.
      */
-    readonly next_upgrade: LuaEntityPrototype
+    readonly next_upgrade?: LuaEntityPrototype
 
     /**
      * The normal amount for this resource. `nil` when not a resource.
@@ -4821,12 +4824,12 @@ interface LuaEntityPrototype {
     /**
      * The pumping speed of this offshore pump, normal pump, or `nil`.
      */
-    readonly pumping_speed: number
+    readonly pumping_speed?: number
 
     /**
      * The radar range of this unit prototype or `nil`.
      */
-    readonly radar_range: number
+    readonly radar_range?: number
 
     /**
      * The radius of this entity prototype.
@@ -4869,7 +4872,7 @@ interface LuaEntityPrototype {
     /**
      * The base researching speed of this lab prototype or `nil`.
      */
-    readonly researching_speed: number
+    readonly researching_speed?: number
 
     /**
      * List of resistances towards each damage type. It is a dictionary indexed by damage type names (see `data/base/prototypes/damage-type.lua`).
@@ -4882,7 +4885,7 @@ interface LuaEntityPrototype {
      * The value in the dictionary is meaningless and exists just to allow the dictionary type for easy lookup.
      *
      */
-    readonly resource_categories: {[key: string]: boolean}
+    readonly resource_categories?: {[key: string]: boolean}
 
     /**
      * Name of the category of this resource or `nil` when not a resource.
@@ -4890,7 +4893,7 @@ interface LuaEntityPrototype {
      * During data stage this property is named "category".
      *
      */
-    readonly resource_category: string
+    readonly resource_category?: string
 
     /**
      * @remarks
@@ -4907,27 +4910,27 @@ interface LuaEntityPrototype {
     /**
      * The rising speed for this rocket silo rocket prototype or `nil`.
      */
-    readonly rising_speed: number
+    readonly rising_speed?: number
 
     /**
      * The rocket entity prototype associated with this rocket silo prototype or `nil`.
      */
-    readonly rocket_entity_prototype: LuaEntityPrototype
+    readonly rocket_entity_prototype?: LuaEntityPrototype
 
     /**
      * The rocket parts required for this rocket silo prototype or `nil`.
      */
-    readonly rocket_parts_required: number
+    readonly rocket_parts_required?: number
 
     /**
      * The rocket rising delay for this rocket silo prototype or `nil`.
      */
-    readonly rocket_rising_delay: number
+    readonly rocket_rising_delay?: number
 
     /**
      * The rotation speed of this car prototype or `nil` if not a car prototype.
      */
-    readonly rotation_speed: number
+    readonly rotation_speed?: number
 
     /**
      * Gets the current movement speed of this character, including effects from exoskeletons, tiles, stickers and shooting.
@@ -4940,7 +4943,7 @@ interface LuaEntityPrototype {
     /**
      * The secondary bounding box used for collision checking, or `nil` if it doesn't have one. This is only used in rails and rail remnants.
      */
-    readonly secondary_collision_box: BoundingBox
+    readonly secondary_collision_box?: BoundingBox
 
     /**
      * Is this entity selectable?
@@ -4965,7 +4968,7 @@ interface LuaEntityPrototype {
     /**
      * The spawning cooldown for this enemy spawner prototype or `nil`.
      */
-    readonly spawn_cooldown: { max: number, min: number }
+    readonly spawn_cooldown?: { max: number, min: number }
 
     /**
      * How far from the spawner can the units be spawned.
@@ -4980,7 +4983,7 @@ interface LuaEntityPrototype {
     /**
      * The spawning time modifier of this unit prototype or `nil`.
      */
-    readonly spawning_time_modifier: number
+    readonly spawning_time_modifier?: number
 
     /**
      * The default speed of this flying robot, rolling stock or unit, `nil` if not one of these.
@@ -4993,7 +4996,7 @@ interface LuaEntityPrototype {
     /**
      * The speed multiplier when this flying robot is out of energy or `nil`.
      */
-    readonly speed_multiplier_when_out_of_energy: number
+    readonly speed_multiplier_when_out_of_energy?: number
 
     /**
      * If this inserter is a stack-type.
@@ -5013,7 +5016,7 @@ interface LuaEntityPrototype {
     /**
      * The supply area of this electric pole, beacon, or `nil` if this is neither.
      */
-    readonly supply_area_distance: number
+    readonly supply_area_distance?: number
 
     /**
      * If this entity prototype could possibly ever be rotated.
@@ -5023,12 +5026,12 @@ interface LuaEntityPrototype {
     /**
      * If this car prototype uses tank controls to drive or `nil` if this is not a car prototype.
      */
-    readonly tank_driving: boolean
+    readonly tank_driving?: boolean
 
     /**
      * The target temperature of this boiler prototype or `nil`.
      */
-    readonly target_temperature: number
+    readonly target_temperature?: number
 
     /**
      * The terrain friction modifier for this vehicle.
@@ -5074,12 +5077,12 @@ interface LuaEntityPrototype {
     /**
      * The range of this turret or `nil` if this isn't a turret related prototype.
      */
-    readonly turret_range: number
+    readonly turret_range?: number
 
     /**
      * The turret rotation speed of this car prototype or `nil` if not a car prototype.
      */
-    readonly turret_rotation_speed: number
+    readonly turret_rotation_speed?: number
 
     /**
      * Type of this prototype.
@@ -5094,17 +5097,17 @@ interface LuaEntityPrototype {
     /**
      * The vision distance of this unit prototype or `nil`.
      */
-    readonly vision_distance: number
+    readonly vision_distance?: number
 
     /**
      * The void energy source prototype this entity uses or `nil`.
      */
-    readonly void_energy_source_prototype: LuaVoidEnergySourcePrototype
+    readonly void_energy_source_prototype?: LuaVoidEnergySourcePrototype
 
     /**
      * The weight of this vehicle prototype or `nil` if not a vehicle prototype.
      */
-    readonly weight: number
+    readonly weight?: number
 
 }
 
@@ -5123,7 +5126,7 @@ interface LuaEquipment {
     /**
      * The burner energy source for this equipment or `nil` if there isn't one.
      */
-    readonly burner: LuaBurner
+    readonly burner?: LuaBurner
 
     /**
      * Current available energy.
@@ -5447,7 +5450,7 @@ interface LuaEquipmentPrototype {
     /**
      * The equipment attack parameters or `nil`.
      */
-    readonly attack_parameters: AttackParameters
+    readonly attack_parameters?: AttackParameters
 
     /**
      * Is this active defense equipment automatic. Returns false if not active defense equipment.
@@ -5462,12 +5465,12 @@ interface LuaEquipmentPrototype {
     /**
      * The burner energy source prototype this equipment uses or `nil`.
      */
-    readonly burner_prototype: LuaBurnerPrototype
+    readonly burner_prototype?: LuaBurnerPrototype
 
     /**
      * The electric energy source prototype this equipment uses or `nil`.
      */
-    readonly electric_energy_source_prototype: LuaElectricEnergySourcePrototype
+    readonly electric_energy_source_prototype?: LuaElectricEnergySourcePrototype
 
     readonly energy_consumption: number
 
@@ -5555,6 +5558,7 @@ interface LuaEquipmentPrototype {
 
 /**
  * Encapsulates statistic data for different parts of the game. In the context of flow statistics, `input` and `output` describe on which side of the associated GUI the values are shown. Input values are shown on the left side, output values on the right side.
+ * 
  * Examples:
  * - The item production GUI shows "consumption" on the right, thus `output` describes the item consumption numbers. The same goes for fluid consumption.
  * - The kills gui shows "losses" on the right, so `output` describes how many of the force's entities were killed by enemies.
@@ -5630,7 +5634,7 @@ interface LuaFlowStatistics {
     /**
      * The force these statistics belong to or `nil` for pollution statistics.
      */
-    readonly force: LuaForce
+    readonly force?: LuaForce
 
     /**
      * List of input counts indexed by prototype name. Represents the data that is shown on the left side of the GUI for the given statistics.
@@ -5656,7 +5660,9 @@ interface LuaFlowStatistics {
 
 /**
  * An array of fluid boxes of an entity. Entities may contain more than one fluid box, and some can change the number of fluid boxes -- for instance, an assembling machine will change its number of fluid boxes depending on its active recipe.
+ * 
  * See {@link Fluid | Fluid}
+ * 
  * Do note that reading from a {@link LuaFluidBox | LuaFluidBox} creates a new table and writing will copy the given fields from the table into the engine's own fluid box structure. Therefore, the correct way to update a fluidbox of an entity is to read it first, modify the table, then write the modified table back. Directly accessing the returned table's attributes won't have the desired effect.
  * @example
  * Double the temperature of the fluid in `entity`'s first fluid box. 
@@ -5787,7 +5793,7 @@ interface LuaFluidBoxPrototype {
     /**
      * The filter or `nil` if no filter is set.
      */
-    readonly filter: LuaFluidPrototype
+    readonly filter?: LuaFluidPrototype
 
     readonly height: number
 
@@ -5799,12 +5805,12 @@ interface LuaFluidBoxPrototype {
     /**
      * The maximum temperature or `nil` if none is set.
      */
-    readonly maximum_temperature: number
+    readonly maximum_temperature?: number
 
     /**
      * The minimum temperature or `nil` if none is set.
      */
-    readonly minimum_temperature: number
+    readonly minimum_temperature?: number
 
     /**
      * The class name of this object. Available even when `valid` is false. For LuaStruct objects it may also be suffixed with a dotted path to a member of the struct.
@@ -5851,6 +5857,8 @@ interface LuaFluidEnergySourcePrototype {
 
     readonly burns_fluid: boolean
 
+    readonly destroy_non_fuel_fluid: boolean
+
     readonly effectivity: number
 
     readonly emissions: number
@@ -5985,7 +5993,7 @@ interface LuaFontPrototype {
     /**
      * The border color or `nil` if not set.
      */
-    readonly border_color: Color
+    readonly border_color?: Color
 
     readonly filtered: boolean
 
@@ -6435,6 +6443,7 @@ interface LuaForce {
 
     /**
      * The connected players belonging to this force.
+     * 
      * This is primarily useful when you want to do some action against all online players of this force.
      * @remarks
      * This does *not* index using player index. See {@link LuaPlayer::index | LuaPlayer::index} on each player instance for the player index.
@@ -6445,7 +6454,7 @@ interface LuaForce {
     /**
      * The current technology in research, or `nil` if no research is currently ongoing.
      */
-    readonly current_research: LuaTechnology
+    readonly current_research?: LuaTechnology
 
     /**
      * The time, in ticks, before a deconstruction order is removed.
@@ -6604,12 +6613,13 @@ interface LuaForce {
 
     /**
      * The research queue of this force. The first technology in the array is the currently active one. Reading this attribute gives an array of {@link LuaTechnology | LuaTechnology}.
+     * 
      * To write to this, the entire table must be written. Providing an empty table or `nil` will empty the research queue and cancel the current research. Writing to this when the research queue is disabled will simply set the last research in the table as the current research.
      * @remarks
      * This only allows mods to queue research that this force is able to research in the first place. As an example, an already researched technology or one whose prerequisites are not fulfilled will not be queued, but dropped silently instead.
      *
      */
-    research_queue: TechnologyIdentification[]
+    research_queue?: TechnologyIdentification[]
 
     /**
      * Whether the research queue is available for this force.
@@ -7199,6 +7209,11 @@ interface LuaGameScript {
     remove_path(this: void,
         path: string): void
 
+    /**
+     * Reset scenario state (game_finished, player_won, etc.).
+     */
+    reset_game_state(this: void): void
+
     /**
      * Resets the amount of time played for this map.
      */
@@ -7390,6 +7405,7 @@ interface LuaGameScript {
 
     /**
      * The players that are currently online.
+     * 
      * This is primarily useful when you want to do some action against all online players.
      * @remarks
      * This does *not* index using player index. See {@link LuaPlayer::index | LuaPlayer::index} on each player instance for the player index.
@@ -7464,10 +7480,15 @@ interface LuaGameScript {
     readonly equipment_prototypes: {[key: string]: LuaEquipmentPrototype}
 
     /**
-     * Is the scenario finished?
+     * True while the victory screen is shown.
      */
     readonly finished: boolean
 
+    /**
+     * True after players finished the game and clicked "continue".
+     */
+    readonly finished_but_continuing: boolean
+
     /**
      * A dictionary containing every LuaFluidPrototype indexed by `name`.
      */
@@ -7857,7 +7878,9 @@ interface LuaGui {
 
 /**
  * An element of a custom GUI. This type is used to represent any kind of a GUI element - labels, buttons and frames are all instances of this type. Just like {@link LuaEntity | LuaEntity}, different kinds of elements support different attributes; attempting to access an attribute on an element that doesn't support it (for instance, trying to access the `column_count` of a `textfield`) will result in a runtime error.
+ * 
  * The following types of GUI element are supported:
+ * 
  * - `"button"`: A clickable element. Relevant event: {@link on_gui_click | on_gui_click}
  * - `"sprite-button"`: A `button` that displays a sprite rather than text. Relevant event: {@link on_gui_click | on_gui_click}
  * - `"checkbox"`: A clickable element with a check mark that can be turned off or on. Relevant event: {@link on_gui_checked_state_changed | on_gui_checked_state_changed}
@@ -7883,6 +7906,7 @@ interface LuaGui {
  * - `"tabbed-pane"`: A collection of `tab`s and their contents. Relevant event: {@link on_gui_selected_tab_changed | on_gui_selected_tab_changed}
  * - `"tab"`: A tab for use in a `tabbed-pane`.
  * - `"switch"`: A switch with three possible states. Can have labels attached to either side. Relevant event: {@link on_gui_switch_state_changed | on_gui_switch_state_changed}
+ * 
  * Each GUI element allows access to its children by having them as attributes. Thus, one can use the `parent.child` syntax to refer to children. Lua also supports the `parent["child"]` syntax to refer to the same element. This can be used in cases where the child has a name that isn't a valid Lua identifier.
  * @example
  * This will add a label called `greeting` to the top flow. Immediately after, it will change its text to illustrate accessing child elements. 
@@ -8183,6 +8207,15 @@ interface LuaGuiElement {
     set_slider_value_step(this: void,
         value: number): void
 
+    /**
+     * Swaps the children at the given indices in this element.
+     * @param index_1 - The index of the first child.
+     * @param index_2 - The index of the second child.
+     */
+    swap_children(this: void,
+        index_1: number,
+        index_2: number): void
+
     /**
      * Whether this textfield (when in numeric mode) allows decimal numbers.
      * @remarks
@@ -8312,6 +8345,7 @@ interface LuaGuiElement {
 
     /**
      * The elem filters of this choose-elem-button or `nil` if there are no filters.
+     * 
      * The compatible type of filter is determined by elem_type:
      * - Type `"item"` - {@link ItemPrototypeFilter | ItemPrototypeFilter}
      * - Type `"tile"` - {@link TilePrototypeFilter | TilePrototypeFilter}
@@ -8347,7 +8381,7 @@ interface LuaGuiElement {
      * ```
      *
      */
-    elem_filters: ItemPrototypeFilter | TilePrototypeFilter | EntityPrototypeFilter | FluidPrototypeFilter | RecipePrototypeFilter | DecorativePrototypeFilter | AchievementPrototypeFilter | EquipmentPrototypeFilter | TechnologyPrototypeFilter[]
+    elem_filters?: ItemPrototypeFilter | TilePrototypeFilter | EntityPrototypeFilter | FluidPrototypeFilter | RecipePrototypeFilter | DecorativePrototypeFilter | AchievementPrototypeFilter | EquipmentPrototypeFilter | TechnologyPrototypeFilter[]
 
     /**
      * The elem type of this choose-elem-button.
@@ -8364,7 +8398,7 @@ interface LuaGuiElement {
      * Applies to subclasses: choose-elem-button
      *
      */
-    elem_value: string | SignalID
+    elem_value?: string | SignalID
 
     /**
      * Whether this GUI element is enabled. Disabled GUI elements don't trigger events when clicked.
@@ -8374,12 +8408,12 @@ interface LuaGuiElement {
     /**
      * The entity associated with this entity-preview, camera, minimap or `nil` if no entity is associated.
      */
-    entity: LuaEntity
+    entity?: LuaEntity
 
     /**
      * The force this minimap is using or `nil` if no force is set.
      */
-    force: string
+    force?: string
 
     /**
      * The GUI this element is a child of.
@@ -8444,7 +8478,7 @@ interface LuaGuiElement {
     /**
      * The location of this widget when stored in {@link LuaGui::screen | LuaGui::screen}, or `nil` if not set or not in {@link LuaGui::screen | LuaGui::screen}.
      */
-    location: GuiLocation
+    location?: GuiLocation
 
     /**
      * Whether this choose-elem-button can be changed by the player.
@@ -8566,7 +8600,7 @@ interface LuaGuiElement {
      * Applies to subclasses: tabbed-pane
      *
      */
-    selected_tab_index: number
+    selected_tab_index?: number
 
     /**
      * 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.
@@ -8974,22 +9008,22 @@ interface LuaInventory {
     /**
      * The entity that owns this inventory or `nil` if this isn't owned by an entity.
      */
-    readonly entity_owner: LuaEntity
+    readonly entity_owner?: LuaEntity
 
     /**
      * The equipment that owns this inventory or `nil` if this isn't owned by an equipment.
      */
-    readonly equipment_owner: LuaEquipment
+    readonly equipment_owner?: LuaEquipment
 
     /**
      * The inventory index this inventory uses, or `nil` if the inventory doesn't have an index.
      */
-    readonly index: defines.inventory
+    readonly index?: defines.inventory
 
     /**
      * The mod that owns this inventory or `nil` if this isn't owned by a mod.
      */
-    readonly mod_owner: string
+    readonly mod_owner?: 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.
@@ -8999,7 +9033,7 @@ interface LuaInventory {
     /**
      * The player that owns this inventory or `nil` if this isn't owned by a player.
      */
-    readonly player_owner: LuaPlayer
+    readonly player_owner?: LuaPlayer
 
     /**
      * 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.
@@ -9050,9 +9084,9 @@ interface LuaItemPrototype {
         ammo_source_type?: string): AmmoType
 
     /**
-     * Does this prototype have a flag enabled?
-     * Any other value will cause an error.
-     * @param flag - The flag to check. Can be one of [ItemPrototypeFlags](ItemPrototypeFlags)
+     * Test whether this item prototype has a certain flag set.
+     * @param flag - The flag to test. See [ItemPrototypeFlags](ItemPrototypeFlags) for a list of flags.
+     * @returns `true` if this prototype has the given flag set.
      */
     has_flag(this: void,
         flag: string): boolean
@@ -9137,12 +9171,12 @@ interface LuaItemPrototype {
     /**
      * The gun attack parameters or `nil` if not a gun item prototype.
      */
-    readonly attack_parameters: AttackParameters
+    readonly attack_parameters?: AttackParameters
 
     /**
      * The result of burning this item as fuel or `nil`.
      */
-    readonly burnt_result: LuaItemPrototype
+    readonly burnt_result?: LuaItemPrototype
 
     /**
      * If this item can be mod-opened.
@@ -9152,7 +9186,7 @@ interface LuaItemPrototype {
     /**
      * The capsule action for this capsule item prototype or `nil` if this isn't a capsule item prototype.
      */
-    readonly capsule_action: CapsuleAction
+    readonly capsule_action?: CapsuleAction
 
     /**
      * The name of a {@link LuaModuleCategoryPrototype | LuaModuleCategoryPrototype}. Used when upgrading modules: Ctrl + click modules into an entity and it will replace lower tier modules of the same category with higher tier modules.
@@ -9197,7 +9231,7 @@ interface LuaItemPrototype {
      * Applies to subclasses: ToolItem
      *
      */
-    readonly durability: number
+    readonly durability?: number
 
     /**
      * The durability message key used when displaying the durability of this tool.
@@ -9221,7 +9255,7 @@ interface LuaItemPrototype {
      * Applies to subclasses: DeconstructionItem
      *
      */
-    readonly entity_filter_slots: number
+    readonly entity_filter_slots?: number
 
     /**
      * The entity filters used by this selection tool indexed by entity name.
@@ -9243,7 +9277,7 @@ interface LuaItemPrototype {
     /**
      * The prototype of this armor equipment grid or `nil` if none or this is not an armor item.
      */
-    readonly equipment_grid: LuaEquipmentGridPrototype
+    readonly equipment_grid?: LuaEquipmentGridPrototype
 
     /**
      * If this item with inventory extends the inventory it resides in by default.
@@ -9262,7 +9296,7 @@ interface LuaItemPrototype {
     readonly filter_mode: string
 
     /**
-     * The item prototype flags for this item prototype.
+     * The flags for this item prototype.
      */
     readonly flags: ItemPrototypeFlags
 
@@ -9274,7 +9308,7 @@ interface LuaItemPrototype {
     /**
      * The fuel category or `nil`.
      */
-    readonly fuel_category: string
+    readonly fuel_category?: string
 
     /**
      * The emissions multiplier if this is used as fuel.
@@ -9416,7 +9450,7 @@ interface LuaItemPrototype {
     /**
      * Prototype of the equipment that will be created by placing this item in an equipment grid or `nil` if there is no equipment defined.
      */
-    readonly place_as_equipment_result: LuaEquipmentPrototype
+    readonly place_as_equipment_result?: LuaEquipmentPrototype
 
     /**
      * The place-as-tile result if one is defined, else `nil`.
@@ -9426,12 +9460,12 @@ interface LuaItemPrototype {
     /**
      * Prototype of the entity that will be created by placing this item, or `nil` if there is no such entity.
      */
-    readonly place_result: LuaEntityPrototype
+    readonly place_result?: LuaEntityPrototype
 
     /**
      * Amount of extra time (in ticks) it takes to reload the weapon after depleting the magazine or `nil` if this is not an ammo item.
      */
-    readonly reload_time: number
+    readonly reload_time?: number
 
     /**
      * The repair result of this repair tool prototype or `nil` if this isn't a repair tool prototype.
@@ -9439,7 +9473,7 @@ interface LuaItemPrototype {
      * Applies to subclasses: RepairTool
      *
      */
-    readonly repair_result: TriggerItem[]
+    readonly repair_result?: TriggerItem[]
 
     /**
      * Resistances of this armour item, indexed by damage type name. `nil` if not an armor or the armor has no resistances.
@@ -9524,7 +9558,7 @@ interface LuaItemPrototype {
      * Applies to subclasses: DeconstructionItem
      *
      */
-    readonly tile_filter_slots: number
+    readonly tile_filter_slots?: number
 
     /**
      * The tile filters used by this selection tool indexed by tile name.
@@ -9580,7 +9614,6 @@ interface LuaItemStack {
         amount: number): void
 
     /**
-     * Build this blueprint
      * @remarks
      * Built entities can be come invalid between the building of the blueprint and the function returning if by_player or raise_built is used and one of those events invalidates the entity.
      *
@@ -9731,7 +9764,7 @@ interface LuaItemStack {
         amount: number): void
 
     /**
-     * Export a supported item (blueprint, blueprint-book, deconstruction-planner, upgrade-planner, item-with-tags) to a string
+     * Export a supported item (blueprint, blueprint-book, deconstruction-planner, upgrade-planner, item-with-tags) to a string.
      * @returns The exported string
      */
     export_stack(this: void): string
@@ -9834,7 +9867,7 @@ interface LuaItemStack {
     help(this: void): string
 
     /**
-     * Import a supported item (blueprint, blueprint-book, deconstruction-planner, upgrade-planner, item-with-tags) from a string
+     * Import a supported item (blueprint, blueprint-book, deconstruction-planner, upgrade-planner, item-with-tags) from a string.
      * @param data - The string to import
      * @returns 0 if the import succeeded with no errors. -1 if the import succeeded with errors. 1 if the import failed.
      */
@@ -10098,7 +10131,7 @@ interface LuaItemStack {
     /**
      * The equipment grid of this item or `nil` if this item doesn't have a grid.
      */
-    readonly grid: LuaEquipmentGrid
+    readonly grid?: LuaEquipmentGrid
 
     /**
      * How much health the item has, as a number in range [0, 1].
@@ -10177,6 +10210,7 @@ interface LuaItemStack {
 
     /**
      * The unique identifier for this item if it has one, `nil` otherwise. Note that this ID stays the same no matter where the item is moved to.
+     * 
      * Only these types of items have unique IDs:
      * - `"armor"`
      * - `"spidertron-remote"`
@@ -10304,7 +10338,7 @@ interface LuaLampControlBehavior extends LuaGenericOnOffControlBehavior {
     /**
      * The color the lamp is showing or `nil` if not using any color.
      */
-    readonly color: Color
+    readonly color?: Color
 
     /**
      * 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.
@@ -10325,6 +10359,7 @@ interface LuaLampControlBehavior extends LuaGenericOnOffControlBehavior {
 
 /**
  * A lazily loaded value. For performance reasons, we sometimes return a custom lazily-loaded value type instead of the native Lua value. This custom type lazily constructs the necessary value when {@link LuaLazyLoadedValue::get | LuaLazyLoadedValue::get} is called, therefore preventing its unnecessary construction in some cases.
+ * 
  * An instance of LuaLazyLoadedValue is only valid during the event it was created from and cannot be saved.
  */
 interface LuaLazyLoadedValue<T> {
@@ -10400,7 +10435,7 @@ interface LuaLogisticCell {
     /**
      * The network that owns this cell or `nil`.
      */
-    readonly logistic_network: LuaLogisticNetwork
+    readonly logistic_network?: LuaLogisticNetwork
 
     /**
      * Logistic radius of this cell.
@@ -10707,7 +10742,7 @@ interface LuaLogisticPoint {
      * The returned array will always have an entry for each filter and will be indexed in sequence when not nil.
      *
      */
-    readonly filters: LogisticFilter[]
+    readonly filters?: LogisticFilter[]
 
     /**
      * The force of this logistic point.
@@ -10809,17 +10844,17 @@ interface LuaModSettingPrototype {
     /**
      * If this string setting allows blank values or `nil` if not a string setting.
      */
-    readonly allow_blank: boolean
+    readonly allow_blank?: boolean
 
     /**
      * The allowed values for this setting or `nil` if this setting doesn't use the a fixed set of values.
      */
-    readonly allowed_values: string[] | number[]
+    readonly allowed_values?: string[] | number[]
 
     /**
      * If this string setting auto-trims values or `nil` if not a string setting.
      */
-    readonly auto_trim: boolean
+    readonly auto_trim?: boolean
 
     /**
      * The default value of this setting.
@@ -10838,12 +10873,12 @@ interface LuaModSettingPrototype {
     /**
      * The maximum value for this setting or `nil` if this setting type doesn't support a maximum.
      */
-    readonly maximum_value: number
+    readonly maximum_value?: number
 
     /**
      * The minimum value for this setting or `nil` if this setting type doesn't support a minimum.
      */
-    readonly minimum_value: number
+    readonly minimum_value?: number
 
     /**
      * The mod that owns this setting.
@@ -11225,7 +11260,7 @@ interface LuaPlayer extends LuaControl {
      */
     build_from_cursor(this: void,
         table: {
-            position: Position,
+            position: MapPosition,
             direction?: defines.direction,
             alt?: boolean,
             terrain_building_size?: number,
@@ -11242,7 +11277,7 @@ interface LuaPlayer extends LuaControl {
      */
     can_build_from_cursor(this: void,
         table: {
-            position: Position,
+            position: MapPosition,
             direction?: defines.direction,
             alt?: boolean,
             terrain_building_size?: number,
@@ -11258,7 +11293,7 @@ interface LuaPlayer extends LuaControl {
     can_place_entity(this: void,
         table: {
             name: string,
-            position: Position,
+            position: MapPosition,
             direction?: defines.direction
         }): boolean
 
@@ -11332,7 +11367,7 @@ interface LuaPlayer extends LuaControl {
     create_local_flying_text(this: void,
         table: {
             text: LocalisedString,
-            position?: Position,
+            position?: MapPosition,
             create_at_cursor?: boolean,
             color?: Color,
             time_to_live?: number,
@@ -11373,7 +11408,7 @@ interface LuaPlayer extends LuaControl {
      */
     drag_wire(this: void,
         table: {
-            position: Position
+            position: MapPosition
         }): boolean
 
     /**
@@ -11504,7 +11539,7 @@ interface LuaPlayer extends LuaControl {
      * Queues a request to open the map at the specified position. If the map is already opened, the request will simply set the position (and scale). Render mode change requests are processed before rendering of the next frame.
      */
     open_map(this: void,
-        position: Position,
+        position: MapPosition,
         scale?: number): void
 
     /**
@@ -11675,7 +11710,7 @@ interface LuaPlayer extends LuaControl {
      * @param selection_mode - The type of selection to start. Can be `select`, `alternative-select`, `reverse-select`.
      */
     start_selection(this: void,
-        position: Position,
+        position: MapPosition,
         selection_mode: string): void
 
     /**
@@ -11708,7 +11743,7 @@ interface LuaPlayer extends LuaControl {
      * Queues a request to zoom to world at the specified position. If the player is already zooming to world, the request will simply set the position (and scale). Render mode change requests are processed before rendering of the next frame.
      */
     zoom_to_world(this: void,
-        position: Position,
+        position: MapPosition,
         scale?: number): void
 
     /**
@@ -11740,7 +11775,7 @@ interface LuaPlayer extends LuaControl {
      * Will also return `nil` when the player is disconnected (see {@link LuaPlayer::connected | LuaPlayer::connected}).
      *
      */
-    character: LuaEntity
+    character?: LuaEntity
 
     /**
      * The color used when this player talks in game.
@@ -11785,6 +11820,7 @@ interface LuaPlayer extends LuaControl {
 
     /**
      * The source entity used during entity settings copy-paste if any.
+     * 
      * `nil` if there isn't currently a source entity.
      */
     readonly entity_copy_source: LuaEntity
@@ -11857,7 +11893,7 @@ interface LuaPlayer extends LuaControl {
     /**
      * The permission group this player is part of or `nil` if not part of any group.
      */
-    permission_group: LuaPermissionGroup
+    permission_group?: LuaPermissionGroup
 
     /**
      * If items not included in this map editor infinity inventory filters should be removed.
@@ -11869,6 +11905,11 @@ interface LuaPlayer extends LuaControl {
      */
     readonly render_mode: defines.render_mode
 
+    /**
+     * If `true`, circle and name of given player is rendered on the map/chart.
+     */
+    show_on_map: boolean
+
     /**
      * If `true`, zoom-to-world noise effect will be disabled and environmental sounds will be based on zoom-to-world view instead of position of player's character.
      */
@@ -11880,7 +11921,7 @@ interface LuaPlayer extends LuaControl {
      * This is mainly useful when a player is in the map editor.
      *
      */
-    readonly stashed_controller_type: defines.controllers
+    readonly stashed_controller_type?: defines.controllers
 
     /**
      * The tag that is shown after the player in chat and on the map.
@@ -11894,7 +11935,7 @@ interface LuaPlayer extends LuaControl {
      * Set to any positive value to trigger the respawn state for this player.
      *
      */
-    ticks_to_respawn: number
+    ticks_to_respawn?: number
 
     /**
      * Is this object valid? This Lua object holds a reference to an object within the game engine. It is possible that the game-engine object is removed whilst a mod still holds the corresponding Lua object. If that happens, the object becomes invalid, i.e. this attribute will be `false`. Mods are advised to check for object validity if any change to the game state might have occurred between the creation of the Lua object and its access.
@@ -13830,6 +13871,7 @@ interface LuaSettings {
 
     /**
      * The current global mod settings, indexed by prototype name.
+     * 
      * Even though these are marked as read-only, they can be changed by overwriting individual {@link ModSetting | ModSetting} tables in the custom table. Mods can only change their own settings. Using the in-game console, all global settings can be changed.
      */
     readonly global: {[key: string]: ModSetting}
@@ -13841,6 +13883,7 @@ interface LuaSettings {
 
     /**
      * The default player mod settings for this map, indexed by prototype name.
+     * 
      * Even though these are marked as read-only, they can be changed by overwriting individual {@link ModSetting | ModSetting} tables in the custom table. Mods can only change their own settings. Using the in-game console, all player settings can be changed.
      */
     readonly player: {[key: string]: ModSetting}
@@ -13941,6 +13984,13 @@ interface LuaStyle {
      */
     badge_horizontal_spacing: number
 
+    /**
+     * @remarks
+     * Applies to subclasses: LuaProgressBarStyle
+     *
+     */
+    bar_width: number
+
     /**
      * Space between the table cell contents bottom and border.
      * @remarks
@@ -14534,6 +14584,7 @@ interface LuaSurface {
 
     /**
      * Count entities of given type or name in a given area. Works just like {@link LuaSurface::find_entities_filtered | LuaSurface::find_entities_filtered}, except this only returns the count. As it doesn't construct all the wrapper objects, this is more efficient if one is only interested in the number of entities.
+     * 
      * If no `area` or `position` are given, the entire surface is searched. If `position` is given, this returns the entities colliding with that position (i.e the given position is within the entity's collision box). If `position` and `radius` are given, this returns entities in the radius of the position. If `area` is specified, this returns entities colliding with that area.
      * @param table.invert - If the filters should be inverted. These filters are: name, type, ghost_name, ghost_type, direction, collision_mask, force.
      * @param table.radius - If given with position, will count all entities within the radius of the position.
@@ -14558,6 +14609,7 @@ interface LuaSurface {
 
     /**
      * Count tiles of a given name in a given area. Works just like {@link LuaSurface::find_tiles_filtered | LuaSurface::find_tiles_filtered}, except this only returns the count. As it doesn't construct all the wrapper objects, this is more efficient if one is only interested in the number of tiles.
+     * 
      * If no `area` or `position` and `radius` is given, the entire surface is searched. If `position` and `radius` are given, only tiles within the radius of the position are included.
      * @param table.position - Ignored if not given with radius.
      * @param table.radius - If given with position, will return all entities within the radius of the position.
@@ -14743,6 +14795,7 @@ interface LuaSurface {
 
     /**
      * Find decoratives of a given name in a given area.
+     * 
      * If no filters are given, returns all decoratives in the search area. If multiple filters are specified, returns only decoratives matching every given filter. If no area and no position are given, the entire surface is searched.
      * @param table.invert - If the filters should be inverted.
      * @example
@@ -14783,6 +14836,7 @@ interface LuaSurface {
 
     /**
      * Find entities in a given area.
+     * 
      * If no area is given all entities on the surface are returned.
      * @example
      * Will evaluate to a list of all entities within given area. 
@@ -14796,7 +14850,9 @@ interface LuaSurface {
 
     /**
      * Find all entities of the given type or name in the given area.
+     * 
      * If no filters (`name`, `type`, `force`, etc.) are given, this returns all entities in the search area. If multiple filters are specified, only entities matching all given filters are returned.
+     * 
      * If no `area` or `position` are given, the entire surface is searched. If `position` is given, this returns the entities colliding with that position (i.e the given position is within the entity's collision box). If `position` and `radius` are given, this returns the entities within the radius of the position. If `area` is specified, this returns the entities colliding with that area.
      * @param table.invert - If the filters should be inverted. These filters are: name, type, ghost_name, ghost_type, direction, collision_mask, force.
      * @param table.position - Has precedence over area field.
@@ -14925,7 +14981,9 @@ interface LuaSurface {
 
     /**
      * Find all tiles of the given name in the given area.
+     * 
      * If no filters are given, this returns all tiles in the search area.
+     * 
      * If no `area` or `position` and `radius` is given, the entire surface is searched. If `position` and `radius` are given, only tiles within the radius of the position are included.
      * @param table.position - Ignored if not given with radius.
      * @param table.radius - If given with position, will return all entities within the radius of the position.
@@ -15192,6 +15250,7 @@ interface LuaSurface {
 
     /**
      * Generates a path with the specified constraints (as an array of {@link PathfinderWaypoints | PathfinderWaypoint}) using the unit pathfinding algorithm. This path can be used to emulate pathing behavior by script for non-unit entities. If you want to command actual units to move, use the {@link LuaEntity::set_command | LuaEntity::set_command} functionality instead.
+     * 
      * The resulting path is ultimately returned asynchronously via {@link on_script_path_request_finished | on_script_path_request_finished}.
      * @param table.bounding_box - The dimensions of the object that's supposed to travel the path.
      * @param table.can_open_gates - Whether the path request can open gates. Defaults to `false`.
@@ -15263,6 +15322,7 @@ interface LuaSurface {
 
     /**
      * Set tiles at specified locations. Can automatically correct the edges around modified tiles.
+     * 
      * Placing a {@link mineable | LuaTilePrototype::mineable_properties} tile on top of a non-mineable one will turn the latter into the {@link LuaTile::hidden_tile | LuaTile::hidden_tile} for that tile. Placing a mineable tile on a mineable one or a non-mineable tile on a non-mineable one will not modify the hidden tile. This restriction can however be circumvented by using {@link LuaSurface::set_hidden_tile | LuaSurface::set_hidden_tile}.
      * @remarks
      * It is recommended to call this method once for all the tiles you want to change rather than calling it individually for every tile. As the tile correction is used after every step, calling it one by one could cause the tile correction logic to redo some of the changes. Also, many small API calls are generally more performance intensive than one big one.
@@ -15319,7 +15379,9 @@ interface LuaSurface {
 
     /**
      * Defines how surface daytime brightness influences each color channel of the current color lookup table (LUT).
+     * 
      * The LUT is multiplied by `((1 - weight) + brightness * weight)` and result is clamped to range [0, 1].
+     * 
      * Default is `{0, 0, 0}`, which means no influence.
      * @example
      * Makes night on the surface pitch black, assuming [LuaSurface::min_brightness](LuaSurface::min_brightness) being set to default value `0.15`. 
@@ -15720,7 +15782,7 @@ interface LuaTile {
     /**
      * The name of the {@link LuaTilePrototype | LuaTilePrototype} hidden under this tile or `nil` if there is no hidden tile. During normal gameplay, only {@link non-mineable | LuaTilePrototype::mineable_properties} tiles can become hidden. This can however be circumvented with {@link LuaSurface::set_hidden_tile | LuaSurface::set_hidden_tile}.
      */
-    readonly hidden_tile: string
+    readonly hidden_tile?: string
 
     /**
      * Prototype name of this tile. E.g. `"sand-3"` or `"grass-2"`.
@@ -15819,7 +15881,7 @@ interface LuaTilePrototype {
     /**
      * The next direction of this tile or `nil` - used when a tile has multiple directions (such as hazard concrete)
      */
-    readonly next_direction: LuaTilePrototype
+    readonly next_direction?: LuaTilePrototype
 
     /**
      * 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.
@@ -15942,7 +16004,7 @@ interface LuaTrain {
     /**
      * The back stock of this train or `nil`.
      */
-    readonly back_stock: LuaEntity
+    readonly back_stock?: LuaEntity
 
     /**
      * The cargo carriages the train contains.
@@ -15967,7 +16029,7 @@ interface LuaTrain {
     /**
      * The front stock of this train or `nil`.
      */
-    readonly front_stock: LuaEntity
+    readonly front_stock?: LuaEntity
 
     /**
      * If this train has a path.
@@ -15986,7 +16048,8 @@ interface LuaTrain {
 
     /**
      * The players killed by this train.
-     * The keys are the player indexes, the values are how often this train killed that player.
+     * 
+     * The keys are the player indices, the values are how often this train killed that player.
      */
     readonly killed_players: {[key: number]: number}
 
@@ -16026,17 +16089,17 @@ interface LuaTrain {
     /**
      * The path this train is using or `nil` if none.
      */
-    readonly path: LuaRailPath
+    readonly path?: LuaRailPath
 
     /**
      * The destination rail this train is currently pathing to or `nil`.
      */
-    readonly path_end_rail: LuaEntity
+    readonly path_end_rail?: LuaEntity
 
     /**
      * The destination train stop this train is currently pathing to or `nil`.
      */
-    readonly path_end_stop: LuaEntity
+    readonly path_end_stop?: LuaEntity
 
     readonly rail_direction_from_back_rail: defines.rail_direction
 
@@ -16053,12 +16116,12 @@ interface LuaTrain {
      * The schedule can't be changed by modifying the returned table. Instead, changes must be made by assigning a new table to this attribute.
      *
      */
-    schedule: TrainSchedule
+    schedule?: TrainSchedule
 
     /**
      * The signal this train is arriving or waiting at or `nil` if none.
      */
-    readonly signal: LuaEntity
+    readonly signal?: LuaEntity
 
     /**
      * Current speed.
@@ -16076,7 +16139,7 @@ interface LuaTrain {
     /**
      * The train stop this train is stopped at or `nil`.
      */
-    readonly station: LuaEntity
+    readonly station?: LuaEntity
 
     /**
      * 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.
@@ -16421,12 +16484,12 @@ interface LuaUnitGroup {
     /**
      * The command given to this group or `nil` is the group has no command.
      */
-    readonly command: Command
+    readonly command?: Command
 
     /**
      * The distraction command given to this group or `nil` is the group currently isn't distracted.
      */
-    readonly distraction_command: Command
+    readonly distraction_command?: Command
 
     /**
      * The force of this unit group.