factorio-types 0.0.34 → 0.0.36

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.78
+// Factorio version 1.1.84
 // API version 3
 
 /**
@@ -35,7 +35,7 @@ interface LuaAISettings {
     readonly object_name: string
 
     /**
-     * The pathing resolution modifier, must be between -8 and 8.
+     * Defines how coarse the pathfinder's grid is, where smaller values mean a coarser grid. Defaults to `0`, which equals a resolution of `1x1` tiles, centered on tile centers. Values range from `-8` to `8` inclusive, where each integer increment doubles/halves the resolution. So, a resolution of `-8` equals a grid of `256x256` tiles, and a resolution of `8` equals `1/256` of a tile.
      */
     path_resolution_modifier: number
 
@@ -366,6 +366,7 @@ interface LuaBootstrap {
      * - {@link script_raised_built | script_raised_built}
      * - {@link script_raised_destroy | script_raised_destroy}
      * - {@link script_raised_revive | script_raised_revive}
+     * - {@link script_raised_teleported | script_raised_teleported}
      * - {@link script_raised_set_tiles | script_raised_set_tiles}
      * @param data - Table with extra data that will be passed to the event handler. Any invalid LuaObjects will silently stop the event from being raised.
      * @param event - ID of the event to raise.
@@ -476,6 +477,22 @@ interface LuaBootstrap {
      *
      * @param metatable - The metatable to register.
      * @param name - The name of this metatable. Names must be unique per mod.
+     * @example
+     * The metatable first needs to be defined in the mod's root scope, then registered using this method. From then on, it will be properly restored for tables in [global](global). 
+     * ```
+     * local metatable = {
+     *    __index = function(key)
+     *       return "no value for key " .. key
+     *    end
+     * }
+     * script.register_metatable("my_metatable", metatable)
+     * ```
+     *  This previously defined `metatable` can then be set on any table as usual: 
+     * ```
+     * local table = {key="value"}
+     * setmetatable(table, metatable)
+     * ```
+     *
      */
     register_metatable(this: void,
         name: string,
@@ -589,7 +606,7 @@ interface LuaBurner {
     readonly burnt_result_inventory: LuaInventory
 
     /**
-     * The currently burning item.
+     * The currently burning item. Writing `nil` will void the currently burning item without producing a {@link LuaBurner::burnt_result | LuaBurner::burnt_result}.
      * @remarks
      * Writing to this automatically handles correcting {@link LuaBurner::remaining_burning_fuel | LuaBurner::remaining_burning_fuel}.
      *
@@ -884,11 +901,12 @@ interface LuaConstantCombinatorControlBehavior extends LuaControlBehavior {
     help(this: void): void
 
     /**
-     * Sets the signal at the given index
+     * Sets the signal at the given index.
+     * @param signal - Passing `nil` clears the signal.
      */
     set_signal(this: void,
         index: number,
-        signal: Signal): void
+        signal?: Signal): void
 
     /**
      * Turns this constant combinator on and off.
@@ -908,7 +926,7 @@ interface LuaConstantCombinatorControlBehavior extends LuaControlBehavior {
     parameters?: ConstantCombinatorParameters[]
 
     /**
-     * The number of signals this constant combinator supports
+     * The number of signals this constant combinator supports.
      */
     readonly signals_count: number
 
@@ -1058,7 +1076,12 @@ interface LuaControl {
     get_main_inventory(this: void): void
 
     /**
-     * The maximum inventory index this entity may use.
+     * The highest index of all inventories this entity can use. Allows iteration over all of them if desired.
+     * @example
+     * ```
+     *  for k = 1, entity.get_max_inventory_index() do [...] end
+     * ```
+     *
      */
     get_max_inventory_index(this: void): void
 
@@ -1372,7 +1395,7 @@ interface LuaControl {
     force: ForceIdentification
 
     /**
-     * Unique {@link index | LuaForce::index} associated with the force of this entity.
+     * Unique {@link index | LuaForce::index} (ID) associated with the force of this entity.
      */
     readonly force_index: number
 
@@ -1394,18 +1417,18 @@ interface LuaControl {
     /**
      * Current mining state.
      * @remarks
-     * When the player isn't mining tiles the player will mine what ever entity is currently selected. See {@link LuaControl::selected | LuaControl::selected} and {@link LuaControl::update_selected_entity | LuaControl::update_selected_entity}.
+     * When the player isn't mining tiles, the player will mine what ever entity is currently selected. See {@link LuaControl::selected | LuaControl::selected} and {@link LuaControl::update_selected_entity | LuaControl::update_selected_entity}.
      *
      */
     mining_state: {
         
         /**
-         * Whether the player is mining at all
+         * Whether the player is mining at all.
          */
         mining: boolean,
         
         /**
-         * What tiles the player is mining; only used when the player is mining tiles (holding a tile in the cursor).
+         * What location the player is mining. Only relevant if `mining` is `true`.
          */
         position?: MapPosition
     }
@@ -1490,7 +1513,7 @@ interface LuaControl {
     readonly surface: LuaSurface
 
     /**
-     * Unique {@link index | LuaSurface::index} associated with the surface this entity is currently on.
+     * Unique {@link index | LuaSurface::index} (ID) associated with the surface this entity is currently on.
      */
     readonly surface_index: number
 
@@ -1637,6 +1660,16 @@ interface LuaCustomInputPrototype {
      */
     readonly consuming: string
 
+    /**
+     * The default controller alternative key sequence for this custom input, if any
+     */
+    readonly controller_alternative_key_sequence?: string
+
+    /**
+     * The default controller key sequence for this custom input, if any
+     */
+    readonly controller_key_sequence?: string
+
     /**
      * Whether this custom input is enabled. Disabled custom inputs exist but are not used by the game.
      */
@@ -2458,7 +2491,7 @@ interface LuaEntity extends LuaControl {
         direction: defines.rail_direction): void
 
     /**
-     * Current recipe being assembled by this machine or `nil` if no recipe is set.
+     * Current recipe being assembled by this machine, if any.
      * @remarks
      * Applies to subclasses: CraftingMachine
      *
@@ -2822,13 +2855,13 @@ interface LuaEntity extends LuaControl {
     /**
      * Sets the driver of this vehicle.
      * @remarks
-     * This differs over {@link LuaEntity::set_passenger | LuaEntity::set_passenger} in that the passenger can't drive the vehicle.
+     * This differs from {@link LuaEntity::set_passenger | LuaEntity::set_passenger} in that the passenger can't drive the vehicle.
      * Applies to subclasses: Vehicle
      *
-     * @param driver - The new driver or `nil` to eject the current driver if any.
+     * @param driver - The new driver. Writing `nil` ejects the current driver, if any.
      */
     set_driver(this: void,
-        driver: LuaEntity | PlayerIdentification): void
+        driver?: LuaEntity | PlayerIdentification): void
 
     /**
      * Set the filter for a slot in an inserter, loader, or logistic storage container.
@@ -2877,22 +2910,23 @@ interface LuaEntity extends LuaControl {
     /**
      * Sets the passenger of this car or spidertron.
      * @remarks
-     * This differs over {@link LuaEntity::get_driver | LuaEntity::get_driver} in that the passenger can't drive the car.
+     * This differs from {@link LuaEntity::get_driver | LuaEntity::get_driver} in that the passenger can't drive the car.
      * Applies to subclasses: Car,SpiderVehicle
      *
+     * @param passenger - The new passenger. Writing `nil` ejects the current passenger, if any.
      */
     set_passenger(this: void,
-        passenger: LuaEntity | PlayerIdentification): void
+        passenger?: LuaEntity | PlayerIdentification): void
 
     /**
-     * Sets the current recipe in this assembly machine.
+     * Sets the given recipe in this assembly machine.
      * @remarks
      * Applies to subclasses: AssemblingMachine
      *
-     * @param recipe - The new recipe or `nil` to clear the recipe.
+     * @param recipe - The new recipe. Writing `nil` clears the recipe, if any.
      */
     set_recipe(this: void,
-        recipe: string | LuaRecipe): void
+        recipe?: string | LuaRecipe): void
 
     /**
      * Set a logistic requester slot.
@@ -3034,7 +3068,7 @@ interface LuaEntity extends LuaControl {
     auto_launch: boolean
 
     /**
-     * Destination of this spidertron's autopilot, if any.
+     * Destination of this spidertron's autopilot, if any. Writing `nil` clears all destinations.
      * @remarks
      * Applies to subclasses: SpiderVehicle
      *
@@ -3071,12 +3105,12 @@ interface LuaEntity extends LuaControl {
     readonly belt_neighbours: {[key: string]: LuaEntity[]}
 
     /**
-     * `"input"` or `"output"`, depending on whether this underground belt goes down or up.
+     * Whether this underground belt goes into or out of the ground.
      * @remarks
      * Applies to subclasses: TransportBeltToGround
      *
      */
-    readonly belt_to_ground_type: string
+    readonly belt_to_ground_type: 'input' | 'output'
 
     /**
      * The bonus mining progress for this mining drill. Read yields a number in range [0, mining_target.prototype.mineable_properties.mining_time]. `nil` if this isn't a mining drill.
@@ -3382,7 +3416,7 @@ interface LuaEntity extends LuaControl {
     readonly energy_generated_last_tick: number
 
     /**
-     * The label on this entity, if any. `nil` if this is not a spider-vehicle.
+     * The label on this spider-vehicle entity, if any. `nil` if this is not a spider-vehicle.
      */
     entity_label?: string
 
@@ -3641,12 +3675,12 @@ interface LuaEntity extends LuaControl {
     readonly loader_container?: LuaEntity
 
     /**
-     * `"input"` or `"output"`, depending on whether this loader puts to or gets from a container.
+     * Whether this loader gets items from or puts item into a container.
      * @remarks
      * Applies to subclasses: Loader
      *
      */
-    loader_type: string
+    loader_type: 'input' | 'output'
 
     readonly localised_description: LocalisedString
 
@@ -4073,7 +4107,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 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.
      */
     time_to_live: number
@@ -5148,9 +5182,9 @@ interface LuaEntityPrototype {
     readonly item_slot_count?: number
 
     /**
-     * Items that when placed will produce this entity, if any. Construction bots will always choose the first item in this list to build this entity.
+     * Items that when placed will produce this entity, if any. Construction bots will choose the first item in the list to build this entity.
      */
-    readonly items_to_place_this?: SimpleItemStack[]
+    readonly items_to_place_this?: ItemStackDefinition[]
 
     /**
      * The item prototype names that are the inputs of this lab prototype.
@@ -6230,7 +6264,7 @@ interface LuaEquipmentGrid {
     readonly height: number
 
     /**
-     * True if this movement bonus equipment is turned off, otherwise false.
+     * Whether this grid's equipment movement bonus is active.
      */
     inhibit_movement_bonus: boolean
 
@@ -7205,8 +7239,10 @@ interface LuaForce {
 
     /**
      * Force a rechart of the whole chart.
+     * @param surface - Which surface to rechart or all if not given.
      */
-    rechart(this: void): void
+    rechart(this: void,
+        surface?: SurfaceIdentification): void
 
     /**
      * Research all technologies.
@@ -7428,7 +7464,7 @@ interface LuaForce {
     ghost_time_to_live: number
 
     /**
-     * This force's unique ID, and index in {@link LuaGameScript::forces | LuaGameScript::forces}. It is assigned when a force is created, and remains so until it is {@link merged | on_force_merged} (ie. deleted). Indexes of merged forces can be reused.
+     * This force's index in {@link LuaGameScript::forces | LuaGameScript::forces} (unique ID). It is assigned when a force is created, and remains so until it is {@link merged | on_forces_merged} (ie. deleted). Indexes of merged forces can be reused.
      */
     readonly index: number
 
@@ -7744,7 +7780,7 @@ interface LuaGameScript {
     /**
      * Create a new surface.
      * @remarks
-     * The game currently supports a maximum of 4,294,967,295 surfaces, including the default surface.
+     * The game currently supports a maximum of 4'294'967'295 surfaces, including the default surface.
      * Surface names must be unique.
      *
      * @param name - Name of the new surface.
@@ -7808,7 +7844,7 @@ interface LuaGameScript {
         variables?: {[key: string]: number}): void
 
     /**
-     * Force a CRC check. Tells all peers to calculate their current map CRC; these CRC are then compared against each other. If a mismatch is detected, the game is desynced and some peers are forced to reconnect.
+     * Force a CRC check. Tells all peers to calculate their current CRC, which are then compared to each other. If a mismatch is detected, the game desyncs and some peers are forced to reconnect.
      */
     force_crc(this: void): void
 
@@ -7996,7 +8032,7 @@ interface LuaGameScript {
     is_demo(this: void): void
 
     /**
-     * Is the map loaded is multiplayer?
+     * Whether the save is loaded as a multiplayer map.
      */
     is_multiplayer(this: void): void
 
@@ -8426,7 +8462,7 @@ interface LuaGameScript {
     readonly font_prototypes: {[key: string]: LuaFontPrototype}
 
     /**
-     * Get a table of all the forces that currently exist. This sparse table allows you to find forces by indexing it with either their `name` or `index`. Iterating this table with `pairs()` will only iterate the array part of the table. Iterating with `ipairs()` will not work at all.
+     * Get a table of all the forces that currently exist. This sparse table allows you to find forces by indexing it with either their `name` or `index`. Iterating this table with `pairs()` will only iterate the hash part of the table. Iterating with `ipairs()` will not work at all.
      */
     readonly forces: {[key: string]: LuaForce}
 
@@ -8569,7 +8605,7 @@ interface LuaGameScript {
     readonly styles: {[key: string]: string}
 
     /**
-     * Get a table of all the surfaces that currently exist. This sparse table allows you to find surfaces by indexing it with either their `name` or `index`. Iterating this table with `pairs()` will only iterate the array part of the table. Iterating with `ipairs()` will not work at all.
+     * Get a table of all the surfaces that currently exist. This sparse table allows you to find surfaces by indexing it with either their `name` or `index`. Iterating this table with `pairs()` will only iterate the hash part of the table. Iterating with `ipairs()` will not work at all.
      */
     readonly surfaces: {[key: string]: LuaSurface}
 
@@ -8589,11 +8625,9 @@ interface LuaGameScript {
     tick_paused: boolean
 
     /**
-     * The number of ticks since this game was 'created'. A game is 'created' either by using "new game" or "new game from scenario".
-     * @remarks
-     * This differs over {@link LuaGameScript::tick | LuaGameScript::tick} in that making a game from a scenario always starts with ticks_played value at 0 even if the scenario has its own level data where the {@link LuaGameScript::tick | LuaGameScript::tick} is > 0.
-     * This value has no relation with {@link LuaGameScript::tick | LuaGameScript::tick} and can be completely different values.
-     *
+     * The number of ticks since this game was created using either "new game" or "new game from scenario". Notably, this number progresses even when the game is {@link tick_paused | LuaGameScript::tick_paused}.
+     * 
+     * This differs from {@link LuaGameScript::tick | LuaGameScript::tick} in that creating a game from a scenario always starts with this value at `0`, even if the scenario has its own level data where the `tick` has progressed past `0`.
      */
     readonly ticks_played: number
 
@@ -8814,7 +8848,7 @@ interface LuaGui {
  * - `"progressbar"`: A partially filled bar that can be used to indicate progress.
  * - `"table"`: An invisible container that lays out its children in a specific number of columns. The width of each column is determined by the widest element it contains.
  * - `"textfield"`: A single-line box the user can type into. Relevant events: {@link on_gui_text_changed | on_gui_text_changed}, {@link on_gui_confirmed | on_gui_confirmed}
- * - `"radiobutton"`: A clickable element that is functionally identical to a `checkbox`, but has a circular appearance. Relevant event: {@link on_gui_checked_state_changed | on_gui_checked_state_changed}
+ * - `"radiobutton"`: An element that is similar to a `checkbox`, but with a circular appearance. Clicking a selected radio button will not unselect it. Radio buttons are not linked to each other in any way. Relevant event: {@link on_gui_checked_state_changed | on_gui_checked_state_changed}
  * - `"sprite"`: An element that shows an image.
  * - `"scroll-pane"`: An invisible element that is similar to a `flow`, but has the ability to show and use scroll bars.
  * - `"drop-down"`: A drop-down containing strings of text. Relevant event: {@link on_gui_selection_state_changed | on_gui_selection_state_changed}
@@ -9196,6 +9230,14 @@ interface LuaGuiElement {
      */
     auto_center: boolean
 
+    /**
+     * Whether this button will automatically toggle when clicked.
+     * @remarks
+     * Applies to subclasses: button,sprite-button
+     *
+     */
+    auto_toggle: boolean
+
     /**
      * The text to display after the normal tab text (designed to work with numbers)
      * @remarks
@@ -9361,6 +9403,11 @@ interface LuaGuiElement {
      */
     force?: string
 
+    /**
+     * How this element should interact with game controllers.
+     */
+    game_controller_interaction: defines.game_controller_interaction
+
     /**
      * The GUI this element is a child of.
      */
@@ -9510,6 +9557,11 @@ interface LuaGuiElement {
      */
     position: MapPosition
 
+    /**
+     * Whether this element will raise {@link on_gui_hover | on_gui_hover} and {@link on_gui_leave | on_gui_leave}.
+     */
+    raise_hover_events: boolean
+
     /**
      * Whether this text-box is read-only. Defaults to `false`.
      * @remarks
@@ -9641,6 +9693,14 @@ interface LuaGuiElement {
      */
     text: string
 
+    /**
+     * Whether this button is currently toggled. When a button is toggled, it will use the `selected_graphical_set` and `selected_font_color` defined in its style.
+     * @remarks
+     * Applies to subclasses: button,sprite-button
+     *
+     */
+    toggled: boolean
+
     tooltip: LocalisedString
 
     /**
@@ -11255,7 +11315,7 @@ interface LuaItemStack {
      * Applies to subclasses: BlueprintItem
      *
      */
-    readonly default_icons: BlueprintItemIcon[]
+    readonly default_icons: BlueprintSignalIcon[]
 
     /**
      * Durability of the contained item. Automatically capped at the item's maximum durability.
@@ -12102,6 +12162,11 @@ interface LuaModSettingPrototype {
 
     readonly setting_type: string
 
+    /**
+     * Type of this prototype.
+     */
+    readonly type: string
+
     /**
      * Is this object valid? This Lua object holds a reference to an object within the game engine. It is possible that the game-engine object is removed whilst a mod still holds the corresponding Lua object. If that happens, the object becomes invalid, i.e. this attribute will be `false`. Mods are advised to check for object validity if any change to the game state might have occurred between the creation of the Lua object and its access.
      */
@@ -13029,7 +13094,7 @@ interface LuaPlayer extends LuaControl {
     hand_location?: ItemStackLocation
 
     /**
-     * This player's unique ID, and index in {@link LuaGameScript::players | LuaGameScript::players}. It is assigned when a player is created, and remains so (even when the player is not {@link connected | LuaPlayer::connected}) until the player is irreversably {@link removed | on_player_removed}. Indexes of removed players can be reused.
+     * This player's index in {@link LuaGameScript::players | LuaGameScript::players} (unique ID). It is assigned when a player is created, and remains so (even when the player is not {@link connected | LuaPlayer::connected}) until the player is irreversably {@link removed | on_player_removed}. Indexes of removed players can be reused.
      */
     readonly index: number
 
@@ -13038,6 +13103,11 @@ interface LuaPlayer extends LuaControl {
      */
     infinity_inventory_filters: InfinityInventoryFilter[]
 
+    /**
+     * The input method of the player, mouse and keyboard or game controller
+     */
+    readonly input_method: defines.input_method
+
     /**
      * At what tick this player was last online.
      */
@@ -13054,9 +13124,14 @@ interface LuaPlayer extends LuaControl {
     minimap_enabled: boolean
 
     /**
-     * The current per-player settings for the this player, indexed by prototype name. Returns the same structure as {@link LuaSettings::get_player_settings | LuaSettings::get_player_settings}.
-     * @remarks
-     * This table will become invalid if its associated player does.
+     * The current per-player settings for the this player, indexed by prototype name. Returns the same structure as {@link LuaSettings::get_player_settings | LuaSettings::get_player_settings}. This table becomes invalid if its associated player does.
+     * 
+     * Even though this attribute is marked as read-only, individual settings can be changed by overwriting their {@link ModSetting | ModSetting} table. Mods can only change their own settings. Using the in-game console, all player settings can be changed.
+     * @example
+     * ```
+     * -- Change the value of the "active_lifestyle" setting
+     * player.mod_settings["active_lifestyle"] = {value = true}
+     * ```
      *
      */
     readonly mod_settings: {[key: string]: ModSetting}
@@ -13460,17 +13535,11 @@ interface LuaRecipe {
     hidden_from_flow_stats: boolean
 
     /**
-     * Ingredients for this recipe.
+     * The ingredients to this recipe.
      * @example
-     * What the "steel-chest" recipe would return 
+     * The ingredients of `"advanced-oil-processing"` would look like this: 
      * ```
-     * {{type="item", name="steel-plate", amount=8}}
-     * ```
-     *
-     * @example
-     * What the "advanced-oil-processing" recipe would return 
-     * ```
-     * {{type="fluid", name="crude-oil", amount=10}, {type="fluid", name="water", amount=5}}
+     * {{type="fluid", name="crude-oil", amount=100}, {type="fluid", name="water", amount=50}}
      * ```
      *
      */
@@ -13499,7 +13568,13 @@ interface LuaRecipe {
     readonly order: string
 
     /**
-     * The results of this recipe.
+     * The results/products of this recipe.
+     * @example
+     * The products of `"advanced-oil-processing"` would look like this: 
+     * ```
+     * {{type="fluid", name="heavy-oil", amount=25}, {type="fluid", name="light-oil", amount=45}, {type="fluid", name="petroleum-gas", amount=55}}
+     * ```
+     *
      */
     readonly products: Product[]
 
@@ -13635,7 +13710,13 @@ interface LuaRecipePrototype {
     readonly hidden_from_player_crafting: boolean
 
     /**
-     * Ingredients for this recipe.
+     * The ingredients to this recipe.
+     * @example
+     * The ingredients of `"advanced-oil-processing"` would look like this: 
+     * ```
+     * {{type="fluid", name="crude-oil", amount=100}, {type="fluid", name="water", amount=50}}
+     * ```
+     *
      */
     readonly ingredients: Ingredient[]
 
@@ -13672,7 +13753,13 @@ interface LuaRecipePrototype {
     readonly overload_multiplier: number
 
     /**
-     * The results of this recipe.
+     * The results/products of this recipe.
+     * @example
+     * The products of `"advanced-oil-processing"` would look like this: 
+     * ```
+     * {{type="fluid", name="heavy-oil", amount=25}, {type="fluid", name="light-oil", amount=45}, {type="fluid", name="petroleum-gas", amount=55}}
+     * ```
+     *
      */
     readonly products: Product[]
 
@@ -13778,8 +13865,8 @@ interface LuaRendering {
         id: number): void
 
     /**
-     * Destroys all render objects.
-     * @param mod_name - If provided, only the render objects created by this mod are destroyed.
+     * Destroys all render objects. Passing an empty string (`""`)
+     * @param mod_name - If provided, only the render objects created by this mod are destroyed. An empty string (`""`) refers to all objects not belonging to a mod, such as those created using console commands.
      */
     clear(this: void,
         mod_name?: string): void
@@ -13805,6 +13892,7 @@ interface LuaRendering {
      * @param table.target - Center of the animation.
      * @param table.target_offset - Only used if `target` is a LuaEntity.
      * @param table.time_to_live - In ticks. Defaults to living forever.
+     * @param table.use_target_orientation - Only used if `orientation_target` is a LuaEntity.
      * @param table.visible - If this is rendered to anyone at all. Defaults to true.
      * @param table.x_scale - Horizontal scale of the animation. Default is 1.
      * @param table.y_scale - Vertical scale of the animation. Default is 1.
@@ -13821,6 +13909,7 @@ interface LuaRendering {
             animation_offset?: number,
             orientation_target?: MapPosition | LuaEntity,
             orientation_target_offset?: Vector,
+            use_target_orientation?: boolean,
             oriented_offset?: Vector,
             target: MapPosition | LuaEntity,
             target_offset?: Vector,
@@ -13989,6 +14078,7 @@ interface LuaRendering {
      * @param table.target - Acts like an offset applied to all vertices that are not set to an entity.
      * @param table.target_offset - Only used if `target` is a LuaEntity.
      * @param table.time_to_live - In ticks. Defaults to living forever.
+     * @param table.use_target_orientation - Only used if `orientation_target` is a LuaEntity.
      * @param table.visible - If this is rendered to anyone at all. Defaults to true.
      */
     draw_polygon(this: void,
@@ -14000,6 +14090,7 @@ interface LuaRendering {
             orientation?: RealOrientation,
             orientation_target?: MapPosition | LuaEntity,
             orientation_target_offset?: Vector,
+            use_target_orientation?: boolean,
             surface: SurfaceIdentification,
             time_to_live?: number,
             forces?: ForceIdentification[],
@@ -14052,6 +14143,7 @@ interface LuaRendering {
      * @param table.target - Center of the sprite.
      * @param table.target_offset - Only used if `target` is a LuaEntity.
      * @param table.time_to_live - In ticks. Defaults to living forever.
+     * @param table.use_target_orientation - Only used if `orientation_target` is a LuaEntity.
      * @param table.visible - If this is rendered to anyone at all. Defaults to true.
      * @param table.x_scale - Horizontal scale of the sprite. Default is 1.
      * @param table.y_scale - Vertical scale of the sprite. Default is 1.
@@ -14078,6 +14170,7 @@ interface LuaRendering {
             render_layer?: RenderLayer,
             orientation_target?: MapPosition | LuaEntity,
             orientation_target_offset?: Vector,
+            use_target_orientation?: boolean,
             oriented_offset?: Vector,
             target: MapPosition | LuaEntity,
             target_offset?: Vector,
@@ -14142,7 +14235,7 @@ interface LuaRendering {
 
     /**
      * Gets an array of all valid object ids.
-     * @param mod_name - If provided, get only the render objects created by this mod.
+     * @param mod_name - If provided, get only the render objects created by this mod. An empty string (`""`) refers to all objects not belonging to a mod, such as those created using console commands.
      */
     get_all_ids(this: void,
         mod_name?: string): void
@@ -14465,6 +14558,12 @@ interface LuaRendering {
     get_use_rich_text(this: void,
         id: number): void
 
+    /**
+     * Get whether this uses the target orientation.
+     */
+    get_use_target_orientation(this: void,
+        id: number): void
+
     /**
      * Get the vertical alignment of the text with this id.
      * @remarks
@@ -14916,6 +15015,13 @@ interface LuaRendering {
         id: number,
         use_rich_text: boolean): void
 
+    /**
+     * Set whether this uses the target orientation.
+     */
+    set_use_target_orientation(this: void,
+        id: number,
+        use_target_orientation: boolean): void
+
     /**
      * Set the vertical alignment of the text with this id. Does nothing if this object is not a text.
      * @remarks
@@ -15060,9 +15166,14 @@ interface LuaRoboportControlBehavior extends LuaControlBehavior {
  */
 interface LuaSettings {
     /**
-     * Gets the current per-player settings for the given player, indexed by prototype name. Returns the same structure as {@link LuaPlayer::mod_settings | LuaPlayer::mod_settings}.
-     * @remarks
-     * This table will become invalid if its associated player does.
+     * Gets the current per-player settings for the given player, indexed by prototype name. Returns the same structure as {@link LuaPlayer::mod_settings | LuaPlayer::mod_settings}. This table becomes invalid if its associated player does.
+     * 
+     * Even though this attribute is marked as read-only, individual settings can be changed by overwriting their {@link ModSetting | ModSetting} table. Mods can only change their own settings. Using the in-game console, all player settings can be changed.
+     * @example
+     * ```
+     * -- Change the value of the "active_lifestyle" setting
+     * settings.get_player_settings(player_index)["active_lifestyle"] = {value = true}
+     * ```
      *
      */
     get_player_settings(this: void,
@@ -15071,7 +15182,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.
+     * Even though this attribute is marked as read-only, individual settings can be changed by overwriting their {@link ModSetting | ModSetting} table. Mods can only change their own settings. Using the in-game console, all player settings can be changed.
      */
     readonly global: {[key: string]: ModSetting}
 
@@ -15083,7 +15194,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.
+     * Even though this attribute is marked as read-only, individual settings can be changed by overwriting their {@link ModSetting | ModSetting} table. Mods can only change their own settings. Using the in-game console, all player settings can be changed.
      */
     readonly player: {[key: string]: ModSetting}
 
@@ -16004,6 +16115,14 @@ interface LuaSurface {
         use_map_generation_bounding_box: boolean,
         direction?: defines.direction): void
 
+    /**
+     * Find the logistic network with a cell closest to a given position.
+     * @param force - Force the logistic network should belong to.
+     */
+    find_closest_logistic_network_by_position(this: void,
+        position: MapPosition,
+        force: ForceIdentification): void
+
     /**
      * Find decoratives of a given name in a given area.
      * 
@@ -16107,7 +16226,7 @@ interface LuaSurface {
         }): void
 
     /**
-     * Find a specific entity at a specific position.
+     * Find an entity of the given type at the given position. This checks both the exact position and the bounding box of the entity.
      * @param entity - Entity to look for.
      * @param position - Coordinates to look at.
      * @example
@@ -16271,12 +16390,16 @@ interface LuaSurface {
      * @remarks
      * This won't find tiles in non-generated chunks.
      *
+     * @param area - The area to find connected tiles in. If provided the start position must be in this area.
+     * @param include_diagonal - Include tiles that are connected diagonally.
      * @param position - The tile position to start at.
      * @param tiles - The tiles to search for.
      */
     get_connected_tiles(this: void,
         position: TilePosition,
-        tiles: string[]): void
+        tiles: string[],
+        include_diagonal?: boolean,
+        area?: BoundingBox): void
 
     /**
      * Returns all the military targets (entities with force) on this chunk for the given force.
@@ -16478,7 +16601,7 @@ interface LuaSurface {
      * @param table.entity_to_ignore - Makes the pathfinder ignore collisions with this entity if it is given.
      * @param table.force - The force for which to generate the path, determining which gates can be opened for example.
      * @param table.goal - The position to find a path to.
-     * @param table.path_resolution_modifier - Defines how coarse the pathfinder's grid is. Smaller values mean a coarser grid (negative numbers allowed). Allowed values are from -8 to 8. Defaults to `0`.
+     * @param table.path_resolution_modifier - Defines how coarse the pathfinder's grid is, where smaller values mean a coarser grid. Defaults to `0`, which equals a resolution of `1x1` tiles, centered on tile centers. Values range from `-8` to `8` inclusive, where each integer increment doubles/halves the resolution. So, a resolution of `-8` equals a grid of `256x256` tiles, and a resolution of `8` equals `1/256` of a tile.
      * @param table.pathfind_flags - Flags that affect pathfinder behavior.
      * @param table.radius - How close the pathfinder needs to get to its `goal` (in tiles). Defaults to `1`.
      * @param table.start - The position from which to start pathfinding.
@@ -16645,12 +16768,12 @@ interface LuaSurface {
     generate_with_lab_tiles: boolean
 
     /**
-     * This surface's unique ID, and index in {@link LuaGameScript::surfaces | LuaGameScript::surfaces}. It is assigned when a surface is created, and remains so until it is {@link deleted | on_surface_deleted}. Indexes of deleted surfaces can be reused.
+     * This surface's index in {@link LuaGameScript::surfaces | LuaGameScript::surfaces} (unique ID). It is assigned when a surface is created, and remains so until it is {@link deleted | on_surface_deleted}. Indexes of deleted surfaces can be reused.
      */
     readonly index: number
 
     /**
-     * The generation settings for this surface. These can be modified to after surface generation, but note that this will not retroactively update the surface. To manually adjust it, {@link LuaSurface::regenerate_entity | LuaSurface::regenerate_entity}, {@link LuaSurface::regenerate_decorative | LuaSurface::regenerate_decorative} and {@link LuaSurface::delete_chunk | LuaSurface::delete_chunk} can be used.
+     * The generation settings for this surface. These can be modified after surface generation, but note that this will not retroactively update the surface. To manually regenerate it, {@link LuaSurface::regenerate_entity | LuaSurface::regenerate_entity}, {@link LuaSurface::regenerate_decorative | LuaSurface::regenerate_decorative}, and {@link LuaSurface::delete_chunk | LuaSurface::delete_chunk} can be used.
      */
     map_gen_settings: MapGenSettings
 
@@ -16719,7 +16842,7 @@ interface LuaSurface {
     wind_orientation_change: number
 
     /**
-     * Current wind speed.
+     * Current wind speed in tiles per tick.
      */
     wind_speed: number
 
@@ -16800,7 +16923,7 @@ interface LuaTechnology {
     readonly research_unit_count: number
 
     /**
-     * The count formula used for this infinite research. `nil` if this research isn't infinite.
+     * The count formula, if this research has any. See the {@link wiki | https://wiki.factorio.com/Prototype/Technology#Technology_data} for details.
      */
     readonly research_unit_count_formula?: string
 
@@ -16914,7 +17037,7 @@ interface LuaTechnologyPrototype {
     readonly research_unit_count: number
 
     /**
-     * The count formula used for this infinite research. `nil` if this research isn't infinite.
+     * The count formula, if this research has any. See the {@link wiki | https://wiki.factorio.com/Prototype/Technology#Technology_data} for details.
      */
     readonly research_unit_count_formula?: string
 
@@ -17085,9 +17208,9 @@ interface LuaTilePrototype {
     readonly emissions_per_second: number
 
     /**
-     * Items that when placed will produce this tile. It is a dictionary indexed by the item prototype name. `nil` (instead of an empty table) if no items can place this tile.
+     * Items that when placed will produce this tile, if any. Construction bots will choose the first item in the list to build this tile.
      */
-    readonly items_to_place_this: SimpleItemStack[]
+    readonly items_to_place_this?: ItemStackDefinition[]
 
     readonly layer: number
 
@@ -17978,6 +18101,11 @@ interface LuaGuiElementAddParams {
      */
     'enabled'?: boolean
 
+    /**
+     * How the element should interact with game controllers. Defaults to {@link defines.game_controller_interaction.normal | defines.game_controller_interaction.normal}.
+     */
+    'game_controller_interaction'?: defines.game_controller_interaction
+
     /**
      * Whether the child element is ignored by interaction. Defaults to `false`.
      */
@@ -17993,6 +18121,11 @@ interface LuaGuiElementAddParams {
      */
     'name'?: string
 
+    /**
+     * Whether this element will raise {@link on_gui_hover | on_gui_hover} and {@link on_gui_leave | on_gui_leave}. Defaults to `false`.
+     */
+    'raise_hover_events'?: boolean
+
     /**
      * The name of the style prototype to apply to the new element.
      */
@@ -18026,11 +18159,21 @@ interface LuaGuiElementAddParams {
  *
  */
 interface LuaGuiElementAddParamsButton extends LuaGuiElementAddParams {
+    /**
+     * Whether the button will automatically toggle when clicked. Defaults to `false`.
+     */
+    'auto_toggle'?: boolean
+
     /**
      * Which mouse buttons the button responds to. Defaults to `"left-and-right"`.
      */
     'mouse_button_filter'?: MouseButtonFlags
 
+    /**
+     * The initial toggled state of the button. Defaults to `false`.
+     */
+    'toggled'?: boolean
+
 }
 
 /**
@@ -18356,6 +18499,11 @@ interface LuaGuiElementAddParamsSprite extends LuaGuiElementAddParams {
  *
  */
 interface LuaGuiElementAddParamsSpriteButton extends LuaGuiElementAddParams {
+    /**
+     * Whether the button will automatically toggle when clicked. Defaults to `false`.
+     */
+    'auto_toggle'?: boolean
+
     /**
      * Path to the image to display on the button when it is clicked.
      */
@@ -18386,6 +18534,11 @@ interface LuaGuiElementAddParamsSpriteButton extends LuaGuiElementAddParams {
      */
     'sprite'?: SpritePath
 
+    /**
+     * The initial toggled state of the button. Defaults to `false`.
+     */
+    'toggled'?: boolean
+
 }
 
 /**
@@ -18583,7 +18736,7 @@ interface LuaSurfaceCreateEntityParams {
     'raise_built'?: boolean
 
     /**
-     * Source entity. Used for beams and highlight-boxes.
+     * Source entity. Used for beams, projectiles, and highlight-boxes.
      */
     'source'?: LuaEntity | MapPosition
 

package/dist/concepts.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.78
+// Factorio version 1.1.84
 // API version 3
 
 /**
@@ -309,19 +309,6 @@ interface BlueprintEntity {
     tags?: Tags
 }
 
-interface BlueprintItemIcon {
-    
-    /**
-     * Index of the icon in the blueprint icons slots. Has to be an integer in the range [1, 4].
-     */
-    index: number,
-    
-    /**
-     * Name of the item prototype whose icon should be used.
-     */
-    name: string
-}
-
 interface BlueprintSignalIcon {
     
     /**
@@ -336,7 +323,7 @@ interface BlueprintSignalIcon {
 }
 
 /**
- * Two positions, specifying the top-left and bottom-right corner of the box respectively. Like with {@link MapPosition | MapPosition}, the names of the members may be omitted. When read from the game, the third member `orientation` is present if it is non-zero, however it is ignored when provided to the game.
+ * Two positions, specifying the top-left and bottom-right corner of the box respectively. Like with {@link MapPosition | MapPosition}, the names of the members may be omitted. When read from the game, the third member `orientation` is present if it is non-zero.
  * @example
  * Explicit definition: 
  * ```
@@ -851,7 +838,7 @@ interface EnemyExpansionMapSettings {
     max_colliding_tiles_coefficient: number,
     
     /**
-     * The maximum time between expansions in ticks. The actual cooldown is adjusted to the current evolution levels. Defaults to `60*3,600=216,000` ticks.
+     * The maximum time between expansions in ticks. The actual cooldown is adjusted to the current evolution levels. Defaults to `60*3'600=216'000` ticks.
      */
     max_expansion_cooldown: number,
     
@@ -861,7 +848,7 @@ interface EnemyExpansionMapSettings {
     max_expansion_distance: number,
     
     /**
-     * The minimum time between expansions in ticks. The actual cooldown is adjusted to the current evolution levels. Defaults to `4*3,600=14,400` ticks.
+     * The minimum time between expansions in ticks. The actual cooldown is adjusted to the current evolution levels. Defaults to `4*3'600=14'400` ticks.
      */
     min_expansion_cooldown: number,
     
@@ -1343,7 +1330,7 @@ interface ItemStackLocation {
  * 
  * The template can contain placeholders such as `__1__` or `__2__`. These will be replaced by the respective parameter in the LocalisedString. The parameters themselves can be other localised strings, which will be processed recursively in the same fashion. Localised strings can not be recursed deeper than 20 levels and can not have more than 20 parameters.
  * 
- * As a special case, when the key is just the empty string, all the parameters will be concatenated (after processing, if any are localised strings). If there is only one parameter, it will be used as is.
+ * There are two special flags for the localised string, indicated by the key being a particular string. First, if the key is the empty string (`""`), then all parameters will be concatenated (after processing, if any are localised strings themselves). Second, if the key is a question mark (`"?"`), then the first valid parameter will be used. A parameter can be invalid if its name doesn't match any string template. If no parameters are valid, the last one is returned. This is useful to implement a fallback for missing locale templates.
  * 
  * Furthermore, when an API function expects a localised string, it will also accept a regular string (i.e. not a table) which will not be translated, as well as a number, boolean or `nil`, which will be converted to their textual representation.
  * @example
@@ -1371,6 +1358,13 @@ interface ItemStackLocation {
  * game.print({"", {"item-name.iron-plate"}, ": ", 60})
  * ```
  *
+ * @example
+ * As an example of a localised string with fallback, consider this: 
+ * ```
+ * {"?", {"", {"entity-description.furnace"}, "\n"}, {"item-description.furnace"}, "optional fallback"}
+ * ```
+ *  If `entity-description.furnace` exists, it is concatenated with `"\n"` and returned. Otherwise, if `item-description.furnace` exists, it is returned as-is. Otherwise, `"optional fallback"` is returned. If this value wasn't specified, the translation result would be `"Unknown key: 'item-description.furnace'"`.
+ *
  */
 type LocalisedString = string | number | boolean | object | null | Array<string | LocalisedString>
 
@@ -1828,11 +1822,6 @@ interface ModChangeData {
     old_version: string
 }
 
-/**
- * @remarks
- * Runtime settings can be changed through console commands and by the mod that owns the settings by writing a new table to the ModSetting.
- *
- */
 interface ModSetting {
     
     /**
@@ -2015,12 +2004,12 @@ interface PathFinderMapSettings {
     max_clients_to_accept_short_new_request: number,
     
     /**
-     * The maximum number of nodes that are expanded per tick. Defaults to `1,000`.
+     * The maximum number of nodes that are expanded per tick. Defaults to `1'000`.
      */
     max_steps_worked_per_tick: number,
     
     /**
-     * The maximum amount of work each pathfinding job is allowed to do per tick. Defaults to `8,000`.
+     * The maximum amount of work each pathfinding job is allowed to do per tick. Defaults to `8'000`.
      */
     max_work_done_per_tick: number,
     
@@ -2734,7 +2723,7 @@ interface UnitGroupMapSettings {
     max_gathering_unit_groups: number,
     
     /**
-     * The maximum amount of time in ticks a group will spend gathering before setting off. The actual time is a random time between the minimum and maximum times. Defaults to `10*3,600=36,000` ticks.
+     * The maximum amount of time in ticks a group will spend gathering before setting off. The actual time is a random time between the minimum and maximum times. Defaults to `10*3'600=36'000` ticks.
      */
     max_group_gathering_time: number,
     
@@ -2769,7 +2758,7 @@ interface UnitGroupMapSettings {
     max_unit_group_size: number,
     
     /**
-     * After gathering has finished, the group is allowed to wait this long in ticks for delayed members. New members are not accepted anymore however. Defaults to `2*3,600=7,200` ticks.
+     * After gathering has finished, the group is allowed to wait this long in ticks for delayed members. New members are not accepted anymore however. Defaults to `2*3'600=7'200` ticks.
      */
     max_wait_time_for_late_members: number,
     
@@ -2779,7 +2768,7 @@ interface UnitGroupMapSettings {
     member_disown_distance: number,
     
     /**
-     * The minimum amount of time in ticks a group will spend gathering before setting off. The actual time is a random time between the minimum and maximum times. Defaults to `3,600` ticks.
+     * The minimum amount of time in ticks a group will spend gathering before setting off. The actual time is a random time between the minimum and maximum times. Defaults to `3'600` ticks.
      */
     min_group_gathering_time: number,
     
@@ -2885,7 +2874,7 @@ interface WireConnectionDefinition {
     target_wire_id?: defines.wire_connection_id,
     
     /**
-     * Wire color, either {@link defines.wire_type.red | defines.wire_type.red} or {@link defines.wire_type.green | defines.wire_type.green}.
+     * The type of wire used.
      */
     wire: defines.wire_type
 }

package/dist/defines.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.78
+// Factorio version 1.1.84
 // API version 3
 
 declare namespace defines {
@@ -515,9 +515,12 @@ declare namespace defines {
         on_console_chat,
         on_console_command,
         on_cutscene_cancelled,
+        on_cutscene_finished,
+        on_cutscene_started,
         on_cutscene_waypoint_reached,
         on_difficulty_settings_changed,
         on_entity_cloned,
+        on_entity_color_changed,
         on_entity_damaged,
         on_entity_destroyed,
         on_entity_died,
@@ -539,6 +542,8 @@ declare namespace defines {
         on_gui_closed,
         on_gui_confirmed,
         on_gui_elem_changed,
+        on_gui_hover,
+        on_gui_leave,
         on_gui_location_changed,
         on_gui_opened,
         on_gui_selected_tab_changed,
@@ -585,6 +590,7 @@ declare namespace defines {
         on_player_fast_transferred,
         on_player_flushed_fluid,
         on_player_gun_inventory_changed,
+        on_player_input_method_changed,
         on_player_joined_game,
         on_player_kicked,
         on_player_left_game,
@@ -685,6 +691,20 @@ declare namespace defines {
         ten_minutes,
         two_hundred_fifty_hours,
     }
+    enum game_controller_interaction {
+        /**
+         * Game controller will always hover this element regardless of type or state.
+         */
+        always,
+        /**
+         * Hover according to the element type and implementation.
+         */
+        never,
+        /**
+         * Never hover this element with a game controller.
+         */
+        normal,
+    }
     enum group_state {
         attacking_distraction,
         attacking_target,
@@ -794,6 +814,8 @@ declare namespace defines {
         gui_click,
         gui_confirmed,
         gui_elem_changed,
+        gui_hover,
+        gui_leave,
         gui_location_changed,
         gui_selected_tab_changed,
         gui_selection_state_changed,

package/dist/events.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.78
+// Factorio version 1.1.84
 // API version 3
 
 /**
@@ -25,6 +25,10 @@ interface event  {
  * Called when a {@link CustomInput | https://wiki.factorio.com/Prototype/CustomInput} is activated.
  */
 interface CustomInputEvent extends event  {
+    /**
+     * The mouse cursor display location when the custom input was activated.
+     */
+    cursor_display_location: GuiLocation
     /**
      * The mouse cursor position when the custom input was activated.
      */
@@ -274,6 +278,24 @@ interface on_cutscene_cancelled extends event  {
      */
     player_index: number
 }
+/**
+ * Called when a cutscene finishes naturally (was not cancelled).
+ */
+interface on_cutscene_finished extends event  {
+    /**
+     * The player the cutscene was shown to.
+     */
+    player_index: number
+}
+/**
+ * Called when a cutscene starts.
+ */
+interface on_cutscene_started extends event  {
+    /**
+     * The player the cutscene is being shown to.
+     */
+    player_index: number
+}
 /**
  * Called when a cutscene is playing, each time it reaches a waypoint in that cutscene.
  * 
@@ -309,6 +331,15 @@ interface on_entity_cloned extends event  {
     destination: LuaEntity
     source: LuaEntity
 }
+/**
+ * Called after an entity has been recolored either by the player or through script.
+ */
+interface on_entity_color_changed extends event  {
+    /**
+     * The entity that was recolored.
+     */
+    entity: LuaEntity
+}
 /**
  * Called when an entity is damaged. Can be filtered using {@link LuaEntityDamagedEventFilter | LuaEntityDamagedEventFilter}.
  * @remarks
@@ -585,6 +616,10 @@ interface on_gui_click extends event  {
      * If control was pressed.
      */
     control: boolean
+    /**
+     * The display location of the player's cursor.
+     */
+    cursor_display_location: GuiLocation
     /**
      * The clicked element.
      */
@@ -686,6 +721,32 @@ interface on_gui_elem_changed extends event  {
      */
     player_index: number
 }
+/**
+ * Called when {@link LuaGuiElement | LuaGuiElement} is hovered by the mouse.
+ */
+interface on_gui_hover extends event  {
+    /**
+     * The element that is being hovered over.
+     */
+    element: LuaGuiElement
+    /**
+     * The player whose cursor is hovering.
+     */
+    player_index: number
+}
+/**
+ * Called when the player's cursor leaves a {@link LuaGuiElement | LuaGuiElement} that was previously hovered.
+ */
+interface on_gui_leave extends event  {
+    /**
+     * The element that was being hovered.
+     */
+    element: LuaGuiElement
+    /**
+     * The player whose cursor was hovering.
+     */
+    player_index: number
+}
 /**
  * Called when {@link LuaGuiElement | LuaGuiElement} element location is changed (related to frames in `player.gui.screen`).
  */
@@ -1210,7 +1271,7 @@ interface on_player_created extends event  {
     player_index: number
 }
 /**
- * Called after a players cursorstack changed in some way.
+ * Called after a player's {@link cursor stack | LuaControl::cursor_stack} changed in some way.
  */
 interface on_player_cursor_stack_changed extends event  {
     player_index: number
@@ -1357,6 +1418,18 @@ interface on_player_flushed_fluid extends event  {
 interface on_player_gun_inventory_changed extends event  {
     player_index: number
 }
+/**
+ * Called when a player's input method changes.
+ * @remarks
+ * See {@link LuaPlayer::input_method | LuaPlayer::input_method}.
+ *
+ */
+interface on_player_input_method_changed extends event  {
+    /**
+     * The player whose input method changed.
+     */
+    player_index: number
+}
 /**
  * Called after a player joins the game. This is not called when loading a save file in singleplayer, as the player doesn't actually leave the game, and the save is just on pause until they rejoin.
  */

package/dist/global.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.78
+// Factorio version 1.1.84
 // API version 3
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "factorio-types",
-  "version": "0.0.34",
+  "version": "0.0.36",
   "description": "Typescript declarations for the factorio mod API",
   "main": "index.d.ts",
   "repository": "https://github.com/sguest/factorio-types.git",