factorio-types 0.0.32 → 0.0.34

package/dist/classes.d.ts

@@ -2,7 +2,7 @@
 // Factorio API reference https://lua-api.factorio.com/latest/index.html
 // Generated from JSON source https://lua-api.factorio.com/latest/runtime-api.json
 // Definition source https://github.com/sguest/factorio-types
-// Factorio version 1.1.74
+// Factorio version 1.1.78
 // API version 3
 
 /**
@@ -249,7 +249,14 @@ interface LuaBootstrap {
     get_event_order(this: void): void
 
     /**
-     * Register a function to be run when mod configuration changes. This is called when the major game version or any mod version changed, when any mod was added or removed, when a startup setting has changed, or when any prototypes have been added or removed. It allows the mod to make any changes it deems appropriate to both the data structures in its {@link global | global} table or to the game state through {@link LuaGameScript | LuaGameScript}.
+     * Gets the prototype history for the given type and name.
+     */
+    get_prototype_history(this: void,
+        type: string,
+        name: string): void
+
+    /**
+     * Register a function to be run when mod configuration changes. This is called when the game version or any mod version changed, when any mod was added or removed, when a startup setting has changed, when any prototypes have been added or removed, or when a migration was applied. It allows the mod to make any changes it deems appropriate to both the data structures in its {@link global | global} table or to the game state through {@link LuaGameScript | LuaGameScript}.
      * @remarks
      * For more context, refer to the {@link Data Lifecycle | data-lifecycle} page.
      *
@@ -303,9 +310,11 @@ interface LuaBootstrap {
         handler: (this: void) => any | null): void
 
     /**
-     * Register a function to be run on save load. This is only called for mods that have been part of the save previously, or for players connecting to a running multiplayer session. It gives the mod the opportunity to do some very specific actions, should it need to. Doing anything other than these three will lead to desyncs, which breaks multiplayer and replay functionality. Access to {@link LuaGameScript | LuaGameScript} is not available. The {@link global | global} table can be accessed and is safe to read from, but not write to, as doing so will lead to an error.
+     * 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 rectify potential differences in local state introduced by the save/load cycle. Doing anything other than the following three will lead to desyncs, breaking multiplayer and replay functionality. Access to {@link LuaGameScript | LuaGameScript} is not available. The {@link global | global} table can be accessed and is safe to read from, but not write to, as doing so will lead to an error.
      * 
-     * The only legitimate uses of this event are the following:
+     * The only legitimate uses of this event are these:
      * - Re-setup {@link metatables | https://www.lua.org/pil/13.html} as they are not persisted through the save/load cycle.
      * - Re-setup conditional event handlers, meaning subscribing to an event only when some condition is met to save processing time.
      * - Create local references to data stored in the {@link global | global} table.
@@ -401,13 +410,15 @@ interface LuaBootstrap {
     /**
      * @param table.entity - The entity transferred from or to.
      * @param table.from_player - Whether the transfer was from player to entity. If `false`, the transfer was from entity to player.
+     * @param table.is_split - Whether the transfer was a split action (half stack).
      * @param table.player_index - The player transferred from or to.
      */
     raise_player_fast_transferred(this: void,
         table: {
             player_index: number,
             entity: LuaEntity,
-            from_player: boolean
+            from_player: boolean,
+            is_split: boolean
         }): void
 
     /**
@@ -446,6 +457,18 @@ interface LuaBootstrap {
             tiles: Tile[]
         }): void
 
+    /**
+     * @param table.entity - The entity that was teleported.
+     * @param table.old_position - The entity's position before the teleportation.
+     * @param table.old_surface_index - The entity's surface before the teleportation.
+     */
+    raise_script_teleported(this: void,
+        table: {
+            entity: LuaEntity,
+            old_surface_index: number,
+            old_position: MapPosition
+        }): void
+
     /**
      * Register a metatable to have linkage recorded and restored when saving/loading. The metatable itself will not be saved. Instead, only the linkage to a registered metatable is saved, and the metatable registered under that name will be used when loading the table.
      * @remarks
@@ -792,7 +815,7 @@ interface LuaCombinatorControlBehavior extends LuaControlBehavior {
 }
 
 /**
- * Allows for the registration of custom console commands. Similarly to {@link event subscriptions | LuaBootstrap::on_event}, these don't persist through a save-and-load cycle.
+ * Allows for the registration of custom console commands through the global object named `commands`. Similarly to {@link event subscriptions | LuaBootstrap::on_event}, these don't persist through a save-and-load cycle.
  */
 interface LuaCommandProcessor {
     /**
@@ -1034,6 +1057,11 @@ interface LuaControl {
      */
     get_main_inventory(this: void): void
 
+    /**
+     * The maximum inventory index this entity may use.
+     */
+    get_max_inventory_index(this: void): void
+
     /**
      * Gets the parameters of a personal logistic request and auto-trash slot.
      * @param slot_index - The slot to get.
@@ -1144,13 +1172,16 @@ interface LuaControl {
      * @remarks
      * Some entities may not be teleported. For instance, transport belts won't allow teleportation and this method will always return `false` when used on any such entity.
      * You can also pass 1 or 2 numbers as the parameters and they will be used as relative teleport coordinates `'teleport(0, 1)'` to move the entity 1 tile positive y. `'teleport(4)'` to move the entity 4 tiles to the positive x.
+     * `script_raised_teleported` will not be raised if teleporting a player with no character.
      *
      * @param position - Where to teleport to.
+     * @param raise_teleported - If true, [defines.events.script_raised_teleported](defines.events.script_raised_teleported) will be fired on successful entity teleportation.
      * @param surface - Surface to teleport to. If not given, will teleport to the entity's current surface. Only players, cars, and spidertrons can be teleported cross-surface.
      */
     teleport(this: void,
         position: MapPosition,
-        surface?: SurfaceIdentification): void
+        surface?: SurfaceIdentification,
+        raise_teleported?: boolean): void
 
     /**
      * Select an entity, as if by hovering the mouse above it.
@@ -1340,6 +1371,11 @@ interface LuaControl {
      */
     force: ForceIdentification
 
+    /**
+     * Unique {@link index | LuaForce::index} associated with the force of this entity.
+     */
+    readonly force_index: number
+
     /**
      * Whether this character entity is in combat.
      */
@@ -1453,6 +1489,11 @@ interface LuaControl {
      */
     readonly surface: LuaSurface
 
+    /**
+     * Unique {@link index | LuaSurface::index} associated with the surface this entity is currently on.
+     */
+    readonly surface_index: number
+
     /**
      * The vehicle the player is currently sitting in.
      */
@@ -2112,6 +2153,19 @@ interface LuaEntity extends LuaControl {
     disconnect_rolling_stock(this: void,
         direction: defines.rail_direction): void
 
+    /**
+     * Returns a table with all entities affected by this beacon
+     * @remarks
+     * Applies to subclasses: Beacon
+     *
+     */
+    get_beacon_effect_receivers(this: void): void
+
+    /**
+     * Returns a table with all beacons affecting this effect receiver. Can only be used when the entity has an effect receiver (AssemblingMachine, Furnace, Lab, MiningDrills)
+     */
+    get_beacons(this: void): void
+
     /**
      * Get the source of this beam.
      * @remarks
@@ -3003,6 +3057,11 @@ interface LuaEntity extends LuaControl {
      */
     backer_name?: string
 
+    /**
+     * Number of beacons affecting this effect receiver. Can only be used when the entity has an effect receiver (AssemblingMachine, Furnace, Lab, MiningDrills)
+     */
+    readonly beacons_count?: number
+
     /**
      * 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.
      * @remarks
@@ -3323,7 +3382,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-vehicule.
+     * The label on this entity, if any. `nil` if this is not a spider-vehicle.
      */
     entity_label?: string
 
@@ -3497,6 +3556,14 @@ interface LuaEntity extends LuaControl {
      */
     inserter_stack_size_override: number
 
+    /**
+     * Returns the current target pickup count of the inserter.
+     * @remarks
+     * This considers the circuit network, manual override and the inserter stack size limit based on technology.
+     *
+     */
+    readonly inserter_target_pickup_count: number
+
     /**
      * (deprecated by 1.1.51) If this entity is a MilitaryTarget. Returns same value as LuaEntity::is_military_target
      */
@@ -4119,7 +4186,9 @@ interface LuaEntity extends LuaControl {
     readonly unit_group?: LuaUnitGroup
 
     /**
-     * A universally unique number identifying this entity for the lifetime of the save. Only entities inheriting from {@link EntityWithOwner | https://wiki.factorio.com/Prototype/EntityWithOwner}, as well as {@link ItemRequestProxy | https://wiki.factorio.com/Prototype/ItemRequestProxy} and {@link EntityGhost | https://wiki.factorio.com/Prototype/EntityGhost} are assigned a unit number. `nil` if this entity doesn't have a unit number.
+     * A unique number identifying this entity for the lifetime of the save. These are allocated sequentially, and not re-used (until overflow).
+     * 
+     * Only entities inheriting from {@link EntityWithOwner | https://wiki.factorio.com/Prototype/EntityWithOwner}, as well as {@link ItemRequestProxy | https://wiki.factorio.com/Prototype/ItemRequestProxy} and {@link EntityGhost | https://wiki.factorio.com/Prototype/EntityGhost} are assigned a unit number. Returns `nil` otherwise.
      */
     readonly unit_number?: number
 
@@ -4218,6 +4287,11 @@ interface LuaEntityPrototype {
      */
     readonly air_resistance?: number
 
+    /**
+     * The alert icon scale of this entity prototype.
+     */
+    readonly alert_icon_scale: number
+
     /**
      * The alert icon shift of this entity prototype.
      */
@@ -4803,7 +4877,7 @@ interface LuaEntityPrototype {
     /**
      * The fluid capacity of this entity or 0 if this entity doesn't support fluids.
      * @remarks
-     * Crafting machines will report 0 due to their fluid capacity being what ever a given recipe needs.
+     * Crafting machines will report 0 due to their fluid capacity being whatever a given recipe needs.
      *
      */
     readonly fluid_capacity: number
@@ -4910,7 +4984,7 @@ interface LuaEntityPrototype {
     readonly idle_energy_usage?: number
 
     /**
-     * A vector of the gun prototypes of this car, spider vehicule, or artillery wagon or turret.
+     * A vector of the gun prototypes of this car, spider vehicle, artillery wagon, or turret.
      * @remarks
      * Applies to subclasses: Car,SpiderVehicle,ArtilleryTurret,ArtilleryWagon
      *
@@ -5274,7 +5348,7 @@ interface LuaEntityPrototype {
     /**
      * The default maximum power output of this generator prototype.
      * @remarks
-     * Applies to subclasses: Generator
+     * Applies to subclasses: BurnerGenerator,Generator
      *
      */
     readonly max_power_output?: number
@@ -6564,7 +6638,7 @@ interface LuaFluidBox {
         index: number): void
 
     /**
-     * The prototype of this fluidbox index.
+     * The prototype of this fluidbox index. If this is used on a fluidbox of a crafting machine which due to recipe was created by merging multiple prototypes, a table of prototypes that were merged will be returned instead
      */
     get_prototype(this: void,
         index: number): void
@@ -7354,7 +7428,7 @@ interface LuaForce {
     ghost_time_to_live: number
 
     /**
-     * Unique ID associated with this force.
+     * 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.
      */
     readonly index: number
 
@@ -8260,6 +8334,11 @@ interface LuaGameScript {
      */
     readonly connected_players: LuaPlayer[]
 
+    /**
+     * Whether a console command has been used.
+     */
+    readonly console_command_used: boolean
+
     /**
      * A dictionary containing every LuaCustomInputPrototype indexed by `name`.
      */
@@ -11079,6 +11158,15 @@ interface LuaItemStack {
     transfer_stack(this: void,
         stack: ItemStackIdentification): void
 
+    /**
+     * Use the capsule item with the entity as the source, targeting the given position.
+     * @param entity - The entity to use the capsule item with.
+     * @param target_position - The position to use the capsule item with.
+     */
+    use_capsule(this: void,
+        entity: LuaEntity,
+        target_position: MapPosition): void
+
     /**
      * The active blueprint index for this blueprint book. `nil` if this blueprint book is empty.
      * @remarks
@@ -11177,6 +11265,14 @@ interface LuaItemStack {
      */
     durability?: number
 
+    /**
+     * If this is an item with entity data, get the stored entity color.
+     * @remarks
+     * Applies to subclasses: ItemWithEntityData
+     *
+     */
+    entity_color?: Color
+
     /**
      * The number of entity filters this deconstruction item supports.
      * @remarks
@@ -11198,6 +11294,14 @@ interface LuaItemStack {
      */
     entity_filters: string[]
 
+    /**
+     * If this is an item with entity data, get the stored entity label.
+     * @remarks
+     * Applies to subclasses: ItemWithEntityData
+     *
+     */
+    entity_label?: string
+
     /**
      * If this item extends the inventory it resides in (provides its contents for counts, crafting, insertion). Only callable on items with inventories.
      * @remarks
@@ -12336,11 +12440,7 @@ interface LuaPlayer extends LuaControl {
         character: LuaEntity): void
 
     /**
-     * Builds what ever is in the cursor on the surface the player is on.
-     * @remarks
-     * Anything built will fire normal player-built events.
-     * The cursor stack will automatically be reduced as if the player built normally.
-     *
+     * Builds whatever is in the cursor on the surface the player is on. The cursor stack will automatically be reduced as if the player built normally.
      * @param table.alt - If alt build should be used instead of normal build. Defaults to normal.
      * @param table.direction - Direction the entity would be placed
      * @param table.position - Where the entity would be placed
@@ -12618,11 +12718,13 @@ interface LuaPlayer extends LuaControl {
         alert_type: defines.alert_type): void
 
     /**
-     * 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.
+     * Queues a request to open the map at the specified position. If the map is already opened, the request will simply set the position, scale, and entity to follow. Render mode change requests are processed before rendering of the next frame.
+     * @param entity - The entity to follow. If not given the current entity being followed will be cleared.
      */
     open_map(this: void,
         position: MapPosition,
-        scale?: number): void
+        scale?: number,
+        entity?: LuaEntity): void
 
     /**
      * Invokes the "smart pipette" action on the player as if the user pressed it.
@@ -12687,18 +12789,18 @@ interface LuaPlayer extends LuaControl {
         }): void
 
     /**
-     * Requests a translation for the given localised string. If the request is successful the {@link on_string_translated | on_string_translated} event will be fired at a later time with the results.
+     * Requests a translation for the given localised string. If the request is successful, the {@link on_string_translated | on_string_translated} event will be fired with the results.
      * @remarks
-     * Does nothing if this player is not connected. (see {@link LuaPlayer::connected | LuaPlayer::connected}).
+     * Does nothing if this player is not connected (see {@link LuaPlayer::connected | LuaPlayer::connected}).
      *
      */
     request_translation(this: void,
         localised_string: LocalisedString): void
 
     /**
-     * Requests a translation for the given localised strings. If the request is successful the {@link on_string_translated | on_string_translated} event will be fired at a later time with the results.
+     * Requests translation for the given set of localised strings. If the request is successful, a {@link on_string_translated | on_string_translated} event will be fired for each string with the results.
      * @remarks
-     * Does nothing if this player is not connected. (see {@link LuaPlayer::connected | LuaPlayer::connected}).
+     * Does nothing if this player is not connected (see {@link LuaPlayer::connected | LuaPlayer::connected}).
      *
      */
     request_translations(this: void,
@@ -12825,11 +12927,13 @@ interface LuaPlayer extends LuaControl {
         position: MapPosition): void
 
     /**
-     * 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.
+     * 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, scale, and entity to follow. Render mode change requests are processed before rendering of the next frame.
+     * @param entity - The entity to follow. If not given the current entity being followed will be cleared.
      */
     zoom_to_world(this: void,
         position: MapPosition,
-        scale?: number): void
+        scale?: number,
+        entity?: LuaEntity): void
 
     /**
      * `true` if the player is an admin.
@@ -12902,6 +13006,11 @@ interface LuaPlayer extends LuaControl {
      */
     readonly display_scale: number
 
+    /**
+     * The wire drag target for this player, if any.
+     */
+    readonly drag_target?: DragTarget
+
     /**
      * The source entity used during entity settings copy-paste, if any.
      */
@@ -12920,7 +13029,7 @@ interface LuaPlayer extends LuaControl {
     hand_location?: ItemStackLocation
 
     /**
-     * This player's unique index in {@link LuaGameScript::players | LuaGameScript::players}. It is given to them when they are {@link created | on_player_created} and remains assigned to them until they are {@link removed | on_player_removed}.
+     * 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.
      */
     readonly index: number
 
@@ -13117,7 +13226,7 @@ interface LuaProgrammableSpeakerControlBehavior extends LuaControlBehavior {
 }
 
 /**
- * An interface to send messages to the calling RCON interface.
+ * An interface to send messages to the calling RCON interface through the global object named `rcon`.
  */
 interface LuaRCON {
     /**
@@ -13176,6 +13285,11 @@ interface LuaRailPath {
      */
     readonly current: number
 
+    /**
+     * If the path goes from the front of the train
+     */
+    readonly is_front: boolean
+
     /**
      * 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.
      */
@@ -13651,7 +13765,7 @@ interface LuaRemote {
 }
 
 /**
- * Allows rendering of geometric shapes, text and sprites in the game world. Each render object is identified by an id that is universally unique for the lifetime of a whole game.
+ * Allows rendering of geometric shapes, text and sprites in the game world through the global object named `rendering`. Each render object is identified by an id that is universally unique for the lifetime of a whole game.
  * @remarks
  * If an entity target of an object is destroyed or changes surface, then the object is also destroyed.
  *
@@ -13981,7 +14095,7 @@ interface LuaRendering {
      * Not all fonts support scaling.
      *
      * @param table.alignment - Defaults to "left". Other options are "right" and "center".
-     * @param table.draw_on_ground - If this should be drawn below sprites and entities.
+     * @param table.draw_on_ground - If this should be drawn below sprites and entities. Rich text does not support this option.
      * @param table.font - Name of font to use. Defaults to the same font as flying-text.
      * @param table.forces - The forces that this object is rendered to. Passing `nil` or an empty table will render it to all forces.
      * @param table.only_in_alt_mode - If this should only be rendered in alt mode. Defaults to false.
@@ -13991,6 +14105,7 @@ interface LuaRendering {
      * @param table.target_offset - Only used if `target` is a LuaEntity.
      * @param table.text - The text to display.
      * @param table.time_to_live - In ticks. Defaults to living forever.
+     * @param table.use_rich_text - If rich text rendering is enabled. Defaults to false.
      * @param table.vertical_alignment - Defaults to "top". Other options are "middle", "baseline" and "bottom".
      * @param table.visible - If this is rendered to anyone at all. Defaults to true.
      */
@@ -14012,7 +14127,8 @@ interface LuaRendering {
             alignment?: string,
             vertical_alignment?: string,
             scale_with_zoom?: boolean,
-            only_in_alt_mode?: boolean
+            only_in_alt_mode?: boolean,
+            use_rich_text?: boolean
         }): void
 
     /**
@@ -14340,6 +14456,15 @@ interface LuaRendering {
     get_type(this: void,
         id: number): void
 
+    /**
+     * Get if the text with this id parses rich text tags.
+     * @remarks
+     * Applies to subclasses: Text
+     *
+     */
+    get_use_rich_text(this: void,
+        id: number): void
+
     /**
      * Get the vertical alignment of the text with this id.
      * @remarks
@@ -14781,6 +14906,16 @@ interface LuaRendering {
         to: MapPosition | LuaEntity,
         to_offset?: Vector): void
 
+    /**
+     * Set if the text with this id parses rich text tags.
+     * @remarks
+     * Applies to subclasses: Text
+     *
+     */
+    set_use_rich_text(this: void,
+        id: number,
+        use_rich_text: boolean): void
+
     /**
      * Set the vertical alignment of the text with this id. Does nothing if this object is not a text.
      * @remarks
@@ -15000,7 +15135,7 @@ interface LuaShortcutPrototype {
     readonly order: string
 
     /**
-     * The technology to unlock when this shortcut is used, if any.
+     * The technology that needs to be researched once (in any save) for this shortcut to be unlocked (in all saves).
      */
     readonly technology_to_unlock?: LuaTechnologyPrototype
 
@@ -15809,6 +15944,7 @@ interface LuaSurface {
         }): void
 
     /**
+     * Whether the given decorative prototype collides at the given position and direction.
      * @param position - The position to check
      * @param prototype - The decorative prototype to check
      */
@@ -15857,6 +15993,7 @@ interface LuaSurface {
         area: ScriptPosition): void
 
     /**
+     * Whether the given entity prototype collides at the given position and direction.
      * @param position - The position to check
      * @param prototype - The entity prototype to check
      * @param use_map_generation_bounding_box - If the map generation bounding box should be used instead of the collision bounding box
@@ -15965,6 +16102,7 @@ interface LuaSurface {
             to_be_upgraded?: boolean,
             limit?: number,
             is_military_target?: boolean,
+            has_item_inside?: LuaItemPrototype,
             invert?: boolean
         }): void
 
@@ -16507,7 +16645,7 @@ interface LuaSurface {
     generate_with_lab_tiles: boolean
 
     /**
-     * Unique ID associated with this surface.
+     * 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.
      */
     readonly index: number
 
@@ -16517,7 +16655,7 @@ interface LuaSurface {
     map_gen_settings: MapGenSettings
 
     /**
-     * The minimal brightness during the night. Default is `0.15`. The value has an effect on the game simalution only, it doesn't have any effect on rendering.
+     * The minimal brightness during the night. Defaults to `0.15`. This has an effect on both rendering and game mechanics such as biter spawns and solar power.
      */
     min_brightness: number
 
@@ -18389,6 +18527,11 @@ interface LuaGuiElementAddParamsTextfield extends LuaGuiElementAddParams {
  *
  */
 interface LuaSurfaceCreateEntityParams {
+    /**
+     * If fast_replace is true simulate fast replace using this character.
+     */
+    'character'?: LuaEntity
+
     /**
      * If false, the building effect smoke will not be shown around the new entity.
      */

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.74
+// Factorio version 1.1.78
 // API version 3
 
 /**
@@ -762,6 +762,20 @@ interface DisplayResolution {
     width: number
 }
 
+interface DragTarget {
+    
+    /**
+     * If the wire being dragged is a circuit wire this is the connector id.
+     */
+    target_circuit_id?: defines.circuit_connector_id,
+    target_entity: LuaEntity,
+    
+    /**
+     * If the wire being dragged is copper wire this is the wire id.
+     */
+    target_wire_id?: defines.wire_connection_id
+}
+
 /**
  * These values represent a percentual increase in evolution. This means a value of `0.1` would increase evolution by 10%.
  */
@@ -1059,9 +1073,9 @@ type FluidPrototypeFilter = FluidPrototypeFilterDefaultTemperature | FluidProtot
 type ForceCondition = /* All forces pass. */ 'all' | /* Forces which will attack pass. */ 'enemy' | /* Forces which won't attack pass. */ 'ally' | /* Forces which are friends pass. */ 'friend' | /* Forces which are not friends pass. */ 'not-friend' | /* The same force pass. */ 'same' | /* The non-same forces pass. */ 'not-same'
 
 /**
- * A force may be specified in one of two ways.
+ * A force may be specified in one of three ways.
  */
-type ForceIdentification = /* The force name. */ string | /* A reference to {@link LuaForce | LuaForce} may be passed directly. */ LuaForce
+type ForceIdentification = /* The force index. */ number | /* The force name. */ string | /* A reference to {@link LuaForce | LuaForce} may be passed directly. */ LuaForce
 
 /**
  * Parameters that affect the look and control of the game. Updating any of the member attributes here will immediately take effect in the game engine.
@@ -1563,6 +1577,14 @@ type LuaScriptRaisedDestroyEventFilter = LuaScriptRaisedDestroyEventFilterGhostN
  */
 type LuaScriptRaisedReviveEventFilter = LuaScriptRaisedReviveEventFilterGhostName | LuaScriptRaisedReviveEventFilterGhostType | LuaScriptRaisedReviveEventFilterName | LuaScriptRaisedReviveEventFilterType | DefaultLuaScriptRaisedReviveEventFilter
 
+/**
+ * Depending on the value of `filter`, the table may take additional fields. `filter` may be one of the following:
+ * @remarks
+ * Other attributes may be specified depending on `filter`:
+ *
+ */
+type LuaScriptRaisedTeleportedEventFilter = LuaScriptRaisedTeleportedEventFilterGhostName | LuaScriptRaisedTeleportedEventFilterGhostType | LuaScriptRaisedTeleportedEventFilterName | LuaScriptRaisedTeleportedEventFilterType | DefaultLuaScriptRaisedTeleportedEventFilter
+
 /**
  * Depending on the value of `filter`, the table may take additional fields. `filter` may be one of the following:
  * @remarks
@@ -1816,7 +1838,7 @@ interface ModSetting {
     /**
      * The value of the mod setting. The type depends on the kind of setting.
      */
-    value: number | boolean | string
+    value: number | boolean | string | Color
 }
 
 /**
@@ -2259,6 +2281,19 @@ interface ProgrammableSpeakerParameters {
  */
 type PrototypeFilter = Array</* for type `"item"` */ ItemPrototypeFilter | /* for type `"tile"` */ TilePrototypeFilter | /* for type `"entity"` */ EntityPrototypeFilter | /* for type `"fluid"` */ FluidPrototypeFilter | /* for type `"recipe"` */ RecipePrototypeFilter | /* for type `"decorative"` */ DecorativePrototypeFilter | /* for type `"achievement"` */ AchievementPrototypeFilter | /* for type `"equipment"` */ EquipmentPrototypeFilter | /* for type `"technology"` */ TechnologyPrototypeFilter>
 
+interface PrototypeHistory {
+    
+    /**
+     * The mods that changed this prototype in the order they changed it.
+     */
+    changed: string[],
+    
+    /**
+     * The mod that created this prototype.
+     */
+    created: string
+}
+
 /**
  * The smooth orientation. It is a {@link float | float} in the range `[0, 1)` that covers a full circle, starting at the top and going clockwise. This means a value of `0` indicates "north", a value of `0.5` indicates "south".
  * 
@@ -2545,6 +2580,8 @@ interface TabAndContent {
 
 /**
  * A dictionary of string to the four basic Lua types: `string`, `boolean`, `number`, `table`.
+ * 
+ * Note that the API returns tags as a simple table, meaning any modifications to it will not propagate back to the game. Thus, to modify a set of tags, the whole table needs to be written back to the respective property.
  * @example
  * ```
  * {a = 1, b = true, c = "three", d = {e = "f"}}
@@ -2572,7 +2609,7 @@ type TechnologyModifier = TechnologyModifierOtherTypes | TechnologyModifierAmmoD
  * Other attributes may be specified depending on `filter`:
  *
  */
-type TechnologyPrototypeFilter = TechnologyPrototypeFilterLevel | TechnologyPrototypeFilterMaxLevel | TechnologyPrototypeFilterResearchUnitIngredient | TechnologyPrototypeFilterTime | DefaultTechnologyPrototypeFilter
+type TechnologyPrototypeFilter = TechnologyPrototypeFilterLevel | TechnologyPrototypeFilterMaxLevel | TechnologyPrototypeFilterResearchUnitIngredient | TechnologyPrototypeFilterTime | TechnologyPrototypeFilterUnlocksRecipe | DefaultTechnologyPrototypeFilter
 
 interface Tile {
     
@@ -2830,7 +2867,7 @@ interface WireConnectionDefinition {
     /**
      * Mandatory if the source entity has more than one wire connection using copper wire.
      */
-    source_wire_id?: defines.circuit_connector_id,
+    source_wire_id?: defines.wire_connection_id,
     
     /**
      * Mandatory if the target entity has more than one circuit connection using circuit wire.
@@ -2845,7 +2882,7 @@ interface WireConnectionDefinition {
     /**
      * Mandatory if the target entity has more than one wire connection using copper wire.
      */
-    target_wire_id?: defines.circuit_connector_id,
+    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}.
@@ -5350,6 +5387,79 @@ interface DefaultLuaScriptRaisedReviveEventFilter extends BaseLuaScriptRaisedRev
     filter: 'ghost' | 'rail' | 'rail-signal' | 'rolling-stock' | 'robot-with-logistics-interface' | 'vehicle' | 'turret' | 'crafting-machine' | 'wall-connectable' | 'transport-belt-connectable' | 'circuit-network-connectable'
 }
 
+interface BaseLuaScriptRaisedTeleportedEventFilter {
+    
+    /**
+     * Inverts the condition. Default is `false`.
+     */
+    invert?: boolean,
+    
+    /**
+     * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the filters, `"and"` has higher precedence than `"or"`.
+     */
+    mode?: string
+}
+
+interface LuaScriptRaisedTeleportedEventFilterGhostName extends BaseLuaScriptRaisedTeleportedEventFilter {
+    
+    /**
+     * The condition to filter on. One of `"ghost"`, `"rail"`, `"rail-signal"`, `"rolling-stock"`, `"robot-with-logistics-interface"`, `"vehicle"`, `"turret"`, `"crafting-machine"`, `"wall-connectable"`, `"transport-belt-connectable"`, `"circuit-network-connectable"`, `"type"`, `"name"`, `"ghost_type"`, `"ghost_name"`.
+     */
+    filter: 'ghost_name',
+    
+    /**
+     * The ghost prototype name
+     */
+    name: string
+}
+
+interface LuaScriptRaisedTeleportedEventFilterGhostType extends BaseLuaScriptRaisedTeleportedEventFilter {
+    
+    /**
+     * The condition to filter on. One of `"ghost"`, `"rail"`, `"rail-signal"`, `"rolling-stock"`, `"robot-with-logistics-interface"`, `"vehicle"`, `"turret"`, `"crafting-machine"`, `"wall-connectable"`, `"transport-belt-connectable"`, `"circuit-network-connectable"`, `"type"`, `"name"`, `"ghost_type"`, `"ghost_name"`.
+     */
+    filter: 'ghost_type',
+    
+    /**
+     * The ghost prototype type
+     */
+    type: string
+}
+
+interface LuaScriptRaisedTeleportedEventFilterName extends BaseLuaScriptRaisedTeleportedEventFilter {
+    
+    /**
+     * The condition to filter on. One of `"ghost"`, `"rail"`, `"rail-signal"`, `"rolling-stock"`, `"robot-with-logistics-interface"`, `"vehicle"`, `"turret"`, `"crafting-machine"`, `"wall-connectable"`, `"transport-belt-connectable"`, `"circuit-network-connectable"`, `"type"`, `"name"`, `"ghost_type"`, `"ghost_name"`.
+     */
+    filter: 'name',
+    
+    /**
+     * The prototype name
+     */
+    name: string
+}
+
+interface LuaScriptRaisedTeleportedEventFilterType extends BaseLuaScriptRaisedTeleportedEventFilter {
+    
+    /**
+     * The condition to filter on. One of `"ghost"`, `"rail"`, `"rail-signal"`, `"rolling-stock"`, `"robot-with-logistics-interface"`, `"vehicle"`, `"turret"`, `"crafting-machine"`, `"wall-connectable"`, `"transport-belt-connectable"`, `"circuit-network-connectable"`, `"type"`, `"name"`, `"ghost_type"`, `"ghost_name"`.
+     */
+    filter: 'type',
+    
+    /**
+     * The prototype type
+     */
+    type: string
+}
+
+interface DefaultLuaScriptRaisedTeleportedEventFilter extends BaseLuaScriptRaisedTeleportedEventFilter {
+    
+    /**
+     * The condition to filter on. One of `"ghost"`, `"rail"`, `"rail-signal"`, `"rolling-stock"`, `"robot-with-logistics-interface"`, `"vehicle"`, `"turret"`, `"crafting-machine"`, `"wall-connectable"`, `"transport-belt-connectable"`, `"circuit-network-connectable"`, `"type"`, `"name"`, `"ghost_type"`, `"ghost_name"`.
+     */
+    filter: 'ghost' | 'rail' | 'rail-signal' | 'rolling-stock' | 'robot-with-logistics-interface' | 'vehicle' | 'turret' | 'crafting-machine' | 'wall-connectable' | 'transport-belt-connectable' | 'circuit-network-connectable'
+}
+
 interface BaseLuaSectorScannedEventFilter {
     
     /**
@@ -5896,7 +6006,7 @@ interface BaseTechnologyPrototypeFilter {
 interface TechnologyPrototypeFilterLevel extends BaseTechnologyPrototypeFilter {
     
     /**
-     * The condition to filter on. One of `"enabled"`, `"hidden"`, `"upgrade"`, `"visible-when-disabled"`, `"has-effects"`, `"has-prerequisites"`, `"research-unit-ingredient"`, `"level"`, `"max-level"`, `"time"`.
+     * The condition to filter on. One of `"enabled"`, `"hidden"`, `"upgrade"`, `"visible-when-disabled"`, `"has-effects"`, `"has-prerequisites"`, `"research-unit-ingredient"`, `"unlocks-recipe"`, `"level"`, `"max-level"`, `"time"`.
      */
     filter: 'level',
     comparison: ComparatorString,
@@ -5910,7 +6020,7 @@ interface TechnologyPrototypeFilterLevel extends BaseTechnologyPrototypeFilter {
 interface TechnologyPrototypeFilterMaxLevel extends BaseTechnologyPrototypeFilter {
     
     /**
-     * The condition to filter on. One of `"enabled"`, `"hidden"`, `"upgrade"`, `"visible-when-disabled"`, `"has-effects"`, `"has-prerequisites"`, `"research-unit-ingredient"`, `"level"`, `"max-level"`, `"time"`.
+     * The condition to filter on. One of `"enabled"`, `"hidden"`, `"upgrade"`, `"visible-when-disabled"`, `"has-effects"`, `"has-prerequisites"`, `"research-unit-ingredient"`, `"unlocks-recipe"`, `"level"`, `"max-level"`, `"time"`.
      */
     filter: 'max-level',
     comparison: ComparatorString,
@@ -5924,7 +6034,7 @@ interface TechnologyPrototypeFilterMaxLevel extends BaseTechnologyPrototypeFilte
 interface TechnologyPrototypeFilterResearchUnitIngredient extends BaseTechnologyPrototypeFilter {
     
     /**
-     * The condition to filter on. One of `"enabled"`, `"hidden"`, `"upgrade"`, `"visible-when-disabled"`, `"has-effects"`, `"has-prerequisites"`, `"research-unit-ingredient"`, `"level"`, `"max-level"`, `"time"`.
+     * The condition to filter on. One of `"enabled"`, `"hidden"`, `"upgrade"`, `"visible-when-disabled"`, `"has-effects"`, `"has-prerequisites"`, `"research-unit-ingredient"`, `"unlocks-recipe"`, `"level"`, `"max-level"`, `"time"`.
      */
     filter: 'research-unit-ingredient',
     
@@ -5937,7 +6047,7 @@ interface TechnologyPrototypeFilterResearchUnitIngredient extends BaseTechnology
 interface TechnologyPrototypeFilterTime extends BaseTechnologyPrototypeFilter {
     
     /**
-     * The condition to filter on. One of `"enabled"`, `"hidden"`, `"upgrade"`, `"visible-when-disabled"`, `"has-effects"`, `"has-prerequisites"`, `"research-unit-ingredient"`, `"level"`, `"max-level"`, `"time"`.
+     * The condition to filter on. One of `"enabled"`, `"hidden"`, `"upgrade"`, `"visible-when-disabled"`, `"has-effects"`, `"has-prerequisites"`, `"research-unit-ingredient"`, `"unlocks-recipe"`, `"level"`, `"max-level"`, `"time"`.
      */
     filter: 'time',
     comparison: ComparatorString,
@@ -5948,10 +6058,23 @@ interface TechnologyPrototypeFilterTime extends BaseTechnologyPrototypeFilter {
     value: number
 }
 
+interface TechnologyPrototypeFilterUnlocksRecipe extends BaseTechnologyPrototypeFilter {
+    
+    /**
+     * The condition to filter on. One of `"enabled"`, `"hidden"`, `"upgrade"`, `"visible-when-disabled"`, `"has-effects"`, `"has-prerequisites"`, `"research-unit-ingredient"`, `"unlocks-recipe"`, `"level"`, `"max-level"`, `"time"`.
+     */
+    filter: 'unlocks-recipe',
+    
+    /**
+     * The recipe to check.
+     */
+    recipe: string
+}
+
 interface DefaultTechnologyPrototypeFilter extends BaseTechnologyPrototypeFilter {
     
     /**
-     * The condition to filter on. One of `"enabled"`, `"hidden"`, `"upgrade"`, `"visible-when-disabled"`, `"has-effects"`, `"has-prerequisites"`, `"research-unit-ingredient"`, `"level"`, `"max-level"`, `"time"`.
+     * The condition to filter on. One of `"enabled"`, `"hidden"`, `"upgrade"`, `"visible-when-disabled"`, `"has-effects"`, `"has-prerequisites"`, `"research-unit-ingredient"`, `"unlocks-recipe"`, `"level"`, `"max-level"`, `"time"`.
      */
     filter: 'enabled' | 'hidden' | 'upgrade' | 'visible-when-disabled' | 'has-effects' | 'has-prerequisites'
 }

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.74
+// Factorio version 1.1.78
 // API version 3
 
 declare namespace defines {
@@ -673,6 +673,7 @@ declare namespace defines {
         script_raised_destroy,
         script_raised_revive,
         script_raised_set_tiles,
+        script_raised_teleported,
     }
     enum flow_precision_index {
         fifty_hours,

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.74
+// Factorio version 1.1.78
 // API version 3
 
 /**
@@ -1317,6 +1317,10 @@ interface on_player_fast_transferred extends event  {
      * Whether the transfer was from player to entity. If `false`, the transfer was from entity to player.
      */
     from_player: boolean
+    /**
+     * Whether the transfer was a split action (half stack).
+     */
+    is_split: boolean
     /**
      * The player transferred from or to.
      */
@@ -1483,11 +1487,11 @@ interface on_player_promoted extends event  {
     player_index: number
 }
 /**
- * Called when a player is removed (deleted) from the game. Not to be confused with the player logging of this is different in that the player is deleted as if he never existed in the save file.
+ * Called when a player is removed (deleted) from the game. This is markedly different from a player temporarily {@link leaving | on_player_left_game} the game, and instead behaves like the player never existed in the save file.
  */
 interface on_player_removed extends event  {
     /**
-     * The player index that was removed
+     * The index of the removed player.
      */
     player_index: number
 }
@@ -1765,7 +1769,7 @@ interface on_post_entity_died extends event  {
  */
 interface on_pre_build extends event  {
     /**
-     * Item was placed while moving.
+     * Whether the item was placed while moving.
      */
     created_by_moving: boolean
     /**
@@ -1773,11 +1777,11 @@ interface on_pre_build extends event  {
      */
     direction: defines.direction
     /**
-     * If building this blueprint was flipped horizontally.
+     * Whether the blueprint was flipped horizontally. `nil` if not built by a blueprint.
      */
     flip_horizontal: boolean
     /**
-     * If building this blueprint was flipped vertically.
+     * Whether the blueprint was flipped vertically. `nil` if not built by a blueprint.
      */
     flip_vertical: boolean
     /**
@@ -1906,11 +1910,11 @@ interface on_pre_player_mined_item extends event  {
     player_index: number
 }
 /**
- * Called before a player is removed (deleted) from the game. Not to be confused with the player logging of this is different in that the player is deleted as if he never existed in the save file.
+ * Called before a player is removed (deleted) from the game. This is markedly different from a player temporarily {@link leaving | on_player_left_game} the game, and instead behaves like the player never existed in the save file.
  */
 interface on_pre_player_removed extends event  {
     /**
-     * The player index that will be removed
+     * The index of the removed player.
      */
     player_index: number
 }
@@ -2282,7 +2286,7 @@ interface on_spider_command_completed extends event  {
     vehicle: LuaEntity
 }
 /**
- * Called when a translation request generated through {@link LuaPlayer::request_translation | LuaPlayer::request_translation} is translated.
+ * Called when a translation request generated through {@link LuaPlayer::request_translation | LuaPlayer::request_translation} or {@link LuaPlayer::request_translations | LuaPlayer::request_translations} has been completed.
  */
 interface on_string_translated extends event  {
     /**
@@ -2328,7 +2332,7 @@ interface on_surface_deleted extends event  {
     surface_index: number
 }
 /**
- * Called after a surface is imported.
+ * Called after a surface is imported via the map editor.
  */
 interface on_surface_imported extends event  {
     /**
@@ -2477,3 +2481,20 @@ interface script_raised_set_tiles extends event  {
      */
     tiles: Tile[]
 }
+/**
+ * A static event mods can use to tell other mods they teleported something by script. This event is only raised if a mod does so with {@link LuaBootstrap::raise_event | LuaBootstrap::raise_event} or {@link LuaBootstrap::raise_script_teleported | LuaBootstrap::raise_script_teleported}, or when `raise_teleported` is passed to {@link LuaControl::teleport | LuaControl::teleport}. Can be filtered using {@link LuaScriptRaisedTeleportedEventFilter | LuaScriptRaisedTeleportedEventFilter}.
+ */
+interface script_raised_teleported extends event  {
+    /**
+     * The entity that was teleported.
+     */
+    entity: LuaEntity
+    /**
+     * The entity's position before the teleportation.
+     */
+    old_position: MapPosition
+    /**
+     * The entity's surface before the teleportation.
+     */
+    old_surface_index: number
+}

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.74
+// Factorio version 1.1.78
 // API version 3
 
 /**

package/package.json

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