factorio-types 1.2.50 → 1.2.52

package/dist/classes.d.ts

@@ -2,7 +2,7 @@
 // Factorio API reference https://lua-api.factorio.com/latest/index.html
 // Generated from JSON source https://lua-api.factorio.com/latest/runtime-api.json
 // Definition source https://github.com/sguest/factorio-types
-// Factorio version 2.0.67
+// Factorio version 2.0.70
 // API version 6
 
 declare namespace runtime {
@@ -2157,6 +2157,24 @@ interface LuaBootstrap {
     script.on_event(defines.events.on_built_entity,
     function(event) game.print("Gotta go fast!") end,
     {{filter = "name", name = "fast-inserter"}})
+    ```
+     */
+    on_event(this: void, event: defines.events.on_player_dropped_item_into_entity, handler: ((this: void, arg0: runtime.on_player_dropped_item_into_entity) => any) | nil, filters?: EventFilter): void;
+    /**
+     * Register a handler to run on the specified event(s). Each mod can only register once for every event, as any additional registration will overwrite the previous one. This holds true even if different filters are used for subsequent registrations.
+     * @param event The event(s) or custom-input to invoke the handler on.
+     * @param handler The handler for this event. Passing `nil` will unregister it.
+     * @param filters The filters for this event. Can only be used when registering for individual events.
+     * @example ```
+    -- Register for the on_tick event to print the current tick to console each tick
+    script.on_event(defines.events.on_tick,
+    function(event) game.print(event.tick) end)
+    ```
+     * @example ```
+    -- Register for the on_built_entity event, limiting it to only be received when a `"fast-inserter"` is built
+    script.on_event(defines.events.on_built_entity,
+    function(event) game.print("Gotta go fast!") end,
+    {{filter = "name", name = "fast-inserter"}})
     ```
      */
     on_event(this: void, event: defines.events.on_player_fast_transferred, handler: ((this: void, arg0: runtime.on_player_fast_transferred) => any) | nil, filters?: EventFilter): void;
@@ -5924,7 +5942,7 @@ interface LuaDisplayPanelControlBehavior extends LuaControlBehavior {
      * @param index Message index. Use `-1` to append new element.
      * @param message The message definition for the specified index. Specify `nil` to remove the message.
      */
-    set_message(this: void, index: uint32, message: DisplayPanelMessageDefinition): void;
+    set_message(this: void, index: int32, message: DisplayPanelMessageDefinition | nil): void;
     /**
      * The full list of configured messages.
      */
@@ -6830,11 +6848,11 @@ interface LuaEntity extends LuaControl {
     /**
      * Deactivating an entity will stop all its operations (car will stop moving, inserters will stop working, fish will stop moving etc).
      *
-     * Entities that are not active naturally can't be set to be active (setting it to be active will do nothing)
+     * Writing to this is deprecated and affects only the {@link disabled_by_script | runtime:LuaEntity::disabled_by_script} state.
      *
-     * Ghosts, simple smoke, and corpses can't be modified at this time.
+     * Reading from this returns `false` if the entity is deactivated in at least one of the following ways: {@link by script | runtime:LuaEntity::disabled_by_script}, {@link by circuit network | runtime:LuaEntity::disabled_by_control_behavior}, {@link by recipe | runtime:LuaEntity::disabled_by_recipe}, {@link by freezing | runtime:LuaEntity::frozen}, or by deconstruction.
      *
-     * It is even possible to set the character to not be active, so he can't move and perform most of the tasks.
+     * Entities that are not active naturally can't be set to be active (setting it to be active will do nothing). Some entities (Corpse, FireFlame, Roboport, RollingStock, dying entities) need to remain active and will ignore writes.
      */
     active: boolean;
     /**
@@ -7085,7 +7103,7 @@ interface LuaEntity extends LuaControl {
      */
     readonly disabled_by_control_behavior: boolean;
     /**
-     * If the updatable entity is disabled by recipe.
+     * If the assembling machine is disabled by recipe, e.g. due to {@link AssemblingMachinePrototype::disabled_when_recipe_not_researched | prototype:AssemblingMachinePrototype::disabled_when_recipe_not_researched}.
      */
     readonly disabled_by_recipe: boolean;
     /**
@@ -7129,7 +7147,7 @@ interface LuaEntity extends LuaControl {
      */
     readonly effective_speed?: float;
     /**
-     * Multiplies the acceleration the vehicle can create for one unit of energy. Defaults to `1`.
+     * Multiplies the acceleration the car can create for one unit of energy. Defaults to `1`.
      */
     effectivity_modifier: float;
     /**
@@ -7420,6 +7438,10 @@ interface LuaEntity extends LuaControl {
      * Script controlled flag that allows entity to be mined.
      */
     minable_flag: boolean;
+    /**
+     * Area in which this mining drill looks for resources to mine.
+     */
+    readonly mining_area: BoundingBox;
     /**
      * The filter mode for this mining drill. `nil` if this mining drill doesn't have filters.
      */
@@ -7433,7 +7455,9 @@ interface LuaEntity extends LuaControl {
      */
     readonly mining_target?: LuaEntity;
     /**
-     * If the entity is currently mirrored. This state is referred to as `flipped` elsewhere, such as on the {@link on_player_flipped_entity | runtime:on_player_flipped_entity} event.
+     * Whether the entity is currently mirrored. This state is referred to as `flipped` elsewhere, such as on the {@link on_player_flipped_entity | runtime:on_player_flipped_entity} event.
+     *
+     * If an entity is mirrored, it is flipped over the axis that is pointing in the entity's direction. For example if a mirrored entity is facing north, everything that was defined to be facing east in the prototype now faces west.
      */
     mirroring: boolean;
     /**
@@ -8187,6 +8211,7 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
      */
     readonly color?: Color;
     readonly combat_robot_friction?: double;
+    readonly connection_category: string[];
     readonly connection_distance?: double;
     /**
      * The construction radius for this roboport prototype.
@@ -9983,7 +10008,7 @@ interface LuaForce {
      * Returns `nil` if the chunk has not been charted for this force.
      * @returns The raw pixel data.
      */
-    get_chunk_chart(this: void, surface: SurfaceIdentification, position: ChunkPosition): string | null;
+    get_chunk_chart(this: void, surface: SurfaceIdentification, chunk_position: ChunkPosition): string | null;
     /**
      * The entity build statistics for this force (built and mined) for the given surface.
      */
@@ -10068,18 +10093,18 @@ interface LuaForce {
     get_turret_attack_modifier(this: void, turret: EntityID): double;
     /**
      * Has a chunk been charted?
-     * @param position Position of the chunk.
+     * @param chunk_position Position of the chunk.
      */
-    is_chunk_charted(this: void, surface: SurfaceIdentification, position: ChunkPosition): boolean;
+    is_chunk_charted(this: void, surface: SurfaceIdentification, chunk_position: ChunkPosition): boolean;
     /**
      * Has a chunk been requested for charting?
-     * @param position Position of the chunk.
+     * @param chunk_position Position of the chunk.
      */
-    is_chunk_requested_for_charting(this: void, surface: SurfaceIdentification, position: ChunkPosition): boolean;
+    is_chunk_requested_for_charting(this: void, surface: SurfaceIdentification, chunk_position: ChunkPosition): boolean;
     /**
      * Is the given chunk currently charted and visible (not covered by fog of war) on the map.
      */
-    is_chunk_visible(this: void, surface: SurfaceIdentification, position: ChunkPosition): boolean;
+    is_chunk_visible(this: void, surface: SurfaceIdentification, chunk_position: ChunkPosition): boolean;
     /**
      * Is this force an enemy? This differs from `get_cease_fire` in that it is always false for neutral force. This is equivalent to checking the `enemy` ForceCondition.
      */
@@ -10167,6 +10192,10 @@ interface LuaForce {
      * Reapplies all possible research effects, including unlocked recipes. Any custom changes are lost. Preserves research state of technologies.
      */
     reset_technology_effects(this: void): void;
+    /**
+     * Trigger the "scripted" {@link research trigger | runtime:ResearchTrigger} of a technology, researching it. Does nothing if the technology does not have a "scripted" research trigger.
+     */
+    script_trigger_research(this: void, technology: TechnologyID): void;
     /**
      * @param ammo Ammo category
      */
@@ -10228,10 +10257,10 @@ interface LuaForce {
      */
     set_turret_attack_modifier(this: void, turret: EntityID, modifier: double): void;
     /**
-     * @param position The chunk position to unchart.
+     * @param chunk_position The chunk position to unchart.
      * @param surface Surface to unchart on.
      */
-    unchart_chunk(this: void, position: ChunkPosition, surface: SurfaceIdentification): void;
+    unchart_chunk(this: void, chunk_position: ChunkPosition, surface: SurfaceIdentification): void;
     /**
      * Unlocks the quality to be accessible to this force.
      * @param quality Name of the quality.
@@ -12951,10 +12980,26 @@ interface LuaItemCommon {
      * Durability of the contained item. Automatically capped at the item's maximum durability.
      */
     durability: double;
+    /**
+     * If this is an item with entity data, get the stored auto target with gunner state.
+     */
+    entity_auto_target_with_gunner: boolean;
+    /**
+     * If this is an item with entity data, get the stored auto target without gunner state.
+     */
+    entity_auto_target_without_gunner: boolean;
     /**
      * If this is an item with entity data, get the stored entity color.
      */
     entity_color?: Color;
+    /**
+     * If this is an item with entity data, get the stored driver is gunner state.
+     */
+    entity_driver_is_gunner: boolean;
+    /**
+     * If this is an item with entity data, get the stored enable logistics while moving state.
+     */
+    entity_enable_logistics_while_moving: boolean;
     /**
      * The number of entity filters this deconstruction item supports.
      */
@@ -12975,6 +13020,10 @@ interface LuaItemCommon {
      * If this is an item with entity data, get the stored logistic filters.
      */
     entity_logistic_sections: LogisticSections;
+    /**
+     * If this is an item with entity data, get the stored vehicle logistics enabled state.
+     */
+    entity_logistics_enabled: boolean;
     /**
      * If this is an item with entity data, get the stored request from buffer state.
      */
@@ -16160,7 +16209,7 @@ interface LuaRecord {
      */
     get_blueprint_entity_count(this: void): uint32;
     /**
-     * Gets the given tag on the given blueprint entity index in this blueprint blueprint.
+     * Gets the given tag on the given blueprint entity index in this blueprint.
      * @param index The entity index.
      * @param tag The tag to get.
      */
@@ -16204,7 +16253,7 @@ interface LuaRecord {
      */
     set_blueprint_entities(this: void, entities: BlueprintEntity[]): void;
     /**
-     * Sets the given tag on the given blueprint entity index in this blueprint blueprint.
+     * Sets the given tag on the given blueprint entity index in this blueprint.
      * @param index The entity index.
      * @param tag The tag to set.
      * @param value The tag value to set or `nil` to clear the tag.
@@ -16245,7 +16294,7 @@ interface LuaRecord {
      */
     blueprint_absolute_snapping: boolean;
     /**
-     * The description for this blueprint or blueprint book
+     * The description for this blueprint or blueprint book.
      */
     blueprint_description: string;
     /**
@@ -16903,6 +16952,7 @@ interface LuaRendering {
      * @param table.players The players that this object is rendered to. Passing `nil` or an empty table will render it to all players.
      * @param table.visible If this is rendered to anyone at all. Defaults to true.
      * @param table.only_in_alt_mode If this should only be rendered in alt mode. Defaults to false.
+     * @param table.render_mode Mode which this object should render in. Defaults to "game".
      * @example ```
     -- This will draw an iron plate icon at the character's feet. The sprite will move together with the character.
     rendering.draw_sprite{sprite = "item.iron-plate", target = game.player.character, surface = game.player.surface}
@@ -16910,7 +16960,6 @@ interface LuaRendering {
      * @example ```
     -- This will draw an iron plate icon at the character's head. The sprite will move together with the character.
     rendering.draw_sprite{sprite = "item.iron-plate", target = {entity = game.player.character, offset = {0, -2}}, surface = game.player.surface}
-    $field(render_mode, ScriptRenderMode, $optional) Mode which this object should render in. Defaults to "game".
     ```
      */
     draw_sprite(this: void, table: {
@@ -16931,6 +16980,7 @@ interface LuaRendering {
         players?: PlayerIdentification[];
         visible?: boolean;
         only_in_alt_mode?: boolean;
+        render_mode?: ScriptRenderMode;
     }): LuaRenderObject;
     /**
      * Create a text.
@@ -18227,9 +18277,9 @@ interface LuaSurface {
      * Removes the chunk from the territory it is associated with (if any) and allows the map generator to potentially generate a new territory for the chunk in the future. To prevent the game from generating a new territory for the chunk, use {@link LuaSurface::set_chunk_territory | runtime:LuaSurface::set_chunk_territory} to set the chunk's territory to `nil`.
      *
      * Territories that do not contain at least one generated chunk as a result of calling this method will be automatically deleted.
-     * @param positions The chunk positions. The chunks at these positions does not need to exist.
+     * @param chunk_positions The chunk positions. The chunks at these positions does not need to exist.
      */
-    clear_territory_for_chunks(this: void, positions: ChunkPosition[]): void;
+    clear_territory_for_chunks(this: void, chunk_positions: ChunkPosition[]): void;
     /**
      * Clones the given area.
      *
@@ -18458,9 +18508,9 @@ interface LuaSurface {
      */
     decorative_prototype_collides(this: void, prototype: DecorativeID, position: MapPosition): boolean;
     /**
-     * @param position The chunk position to delete
+     * @param chunk_position The chunk position to delete
      */
-    delete_chunk(this: void, position: ChunkPosition): void;
+    delete_chunk(this: void, chunk_position: ChunkPosition): void;
     /**
      * Removes all decoratives from the given area. If no area and no position are given, then the entire surface is searched.
      * @param table.exclude_soft Soft decoratives can be drawn over rails.
@@ -18679,6 +18729,8 @@ interface LuaSurface {
     force_generate_chunk_requests(this: void): void;
     /**
      * Get an iterator going over every chunk on this surface.
+     *
+     * Chunks may or may not be generated; use {@link LuaSurface::is_chunk_generated | runtime:LuaSurface::is_chunk_generated} to check a chunk's state before accessing it.
      */
     get_chunks(this: void): LuaChunkIterator;
     /**
@@ -18708,10 +18760,10 @@ interface LuaSurface {
     get_double_hidden_tile(this: void, position: TilePosition): string;
     /**
      * Returns all the military targets (entities with force) on this chunk for the given force.
-     * @param position The chunk's position.
+     * @param chunk_position The chunk's position.
      * @param force Entities of this force will be returned.
      */
-    get_entities_with_force(this: void, position: ChunkPosition, force: ForceID): LuaEntity[];
+    get_entities_with_force(this: void, chunk_position: ChunkPosition, force: ForceID): LuaEntity[];
     /**
      * The hidden tile name.
      * @param position The tile position.
@@ -18778,9 +18830,9 @@ interface LuaSurface {
     get_territories(this: void): LuaTerritory[];
     /**
      * Get the territory that the given chunk is assigned to. If the chunk is not part of any territory or the territory for the chunk has not yet been generated, then this returns `nil`.
-     * @param position The chunk's position. The chunk at this position does not need to exist.
+     * @param chunk_position The chunk's position. The chunk at this position does not need to exist.
      */
-    get_territory_for_chunk(this: void, position: ChunkPosition): LuaTerritory | null;
+    get_territory_for_chunk(this: void, chunk_position: ChunkPosition): LuaTerritory | null;
     /**
      * Get the tile at a given position. An alternative call signature for this method is passing it a single {@link TilePosition | runtime:TilePosition}.
      *
@@ -18793,9 +18845,9 @@ interface LuaSurface {
     get_total_pollution(this: void): double;
     /**
      * Is a given chunk generated?
-     * @param position The chunk's position.
+     * @param chunk_position The chunk's position.
      */
-    is_chunk_generated(this: void, position: ChunkPosition): boolean;
+    is_chunk_generated(this: void, chunk_position: ChunkPosition): boolean;
     /**
      * Play a sound for every player on this surface.
      *
@@ -18882,10 +18934,10 @@ interface LuaSurface {
     request_to_generate_chunks(this: void, position: MapPosition, radius?: uint32): void;
     /**
      * Set generated status of a chunk. Useful when copying chunks.
-     * @param position The chunk's position.
+     * @param chunk_position The chunk's position.
      * @param status The chunk's new status.
      */
-    set_chunk_generated_status(this: void, position: ChunkPosition, status: defines.chunk_generated_status): void;
+    set_chunk_generated_status(this: void, chunk_position: ChunkPosition, status: defines.chunk_generated_status): void;
     /**
      * Sets the cover tile for the given force and tile on this surface.
      */
@@ -18939,10 +18991,10 @@ interface LuaSurface {
      * It's recommended that territory chunks are connected to each other, but this is not required.
      *
      * Territories that do not contain at least one generated chunk as a result of calling this method will be automatically deleted.
-     * @param positions The chunk positions. The chunks at these positions do not need to exist in order to be assigned to a territory.
+     * @param chunk_positions The chunk positions. The chunks at these positions do not need to exist in order to be assigned to a territory.
      * @param territory The territory to associate the chunks with. If not `nil`, the territory must belong to this same surface or else an error will be produced. If `nil`, then the chunks get removed from the territory it is currently associated with and will prevent the map generator from automatically re-generate a new territory for the chunk in the future.
      */
-    set_territory_for_chunks(this: void, positions: ChunkPosition[], territory?: LuaTerritory): void;
+    set_territory_for_chunks(this: void, chunk_positions: ChunkPosition[], territory?: LuaTerritory): void;
     /**
      * Set tiles at specified locations. Can automatically correct the edges around modified tiles.
      *

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 2.0.67
+// Factorio version 2.0.70
 // API version 6
 
 declare namespace runtime {
@@ -119,7 +119,7 @@ type Alignment = 'top-left' | 'middle-left' | /**
 'left' | 'bottom-left' | 'top-center' | 'middle-center' | /**
  * The same as `"middle-center"`
  */
-'center' | 'bottom-center' | 'top-right' | /**
+'center' | 'bottom-center' | 'top-right' | 'middle-right' | /**
  * The same as `"middle-right"`
  */
 'right' | 'bottom-right';
@@ -4118,7 +4118,7 @@ interface LogisticSection {
     /**
      * Defaults to true.
      */
-    active?: float;
+    active?: boolean;
 }
 interface LogisticSections {
     sections?: LogisticSection[];
@@ -7862,9 +7862,9 @@ interface ResearchIngredient {
     amount: uint16;
 }
 interface BaseResearchTrigger {
-    type: 'craft-item' | 'mine-entity' | 'craft-fluid' | 'send-item-to-orbit' | 'capture-spawner' | 'build-entity' | 'create-space-platform';
+    type: 'craft-item' | 'mine-entity' | 'craft-fluid' | 'send-item-to-orbit' | 'capture-spawner' | 'build-entity' | 'create-space-platform' | 'scripted';
 }
-type ResearchTrigger = BaseResearchTrigger | ResearchTriggerBuildEntity | ResearchTriggerCaptureSpawner | ResearchTriggerCraftFluid | ResearchTriggerCraftItem | ResearchTriggerMineEntity | ResearchTriggerSendItemToOrbit;
+type ResearchTrigger = BaseResearchTrigger | ResearchTriggerBuildEntity | ResearchTriggerCaptureSpawner | ResearchTriggerCraftFluid | ResearchTriggerCraftItem | ResearchTriggerMineEntity | ResearchTriggerScripted | ResearchTriggerSendItemToOrbit;
 /**
  *
  * Applies to variant case `build-entity`
@@ -7907,6 +7907,14 @@ interface ResearchTriggerMineEntity extends BaseResearchTrigger {
     'type': 'mine-entity';
     'entity': string;
 }
+/**
+ *
+ * Applies to variant case `scripted`
+ */
+interface ResearchTriggerScripted extends BaseResearchTrigger {
+    'type': 'scripted';
+    'trigger_description': LocalisedString;
+}
 /**
  *
  * Applies to variant case `send-item-to-orbit`

package/dist/datacollection.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/prototype-api.json
 // Definition source https://github.com/sguest/factorio-types
-// Factorio version 2.0.67
+// Factorio version 2.0.70
 // API version 6
 
 declare namespace prototype {

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 2.0.67
+// Factorio version 2.0.70
 // API version 6
 
 declare namespace defines {
@@ -787,126 +787,127 @@ enum events {
     on_player_display_scale_changed = 94,
     on_player_driving_changed_state = 95,
     on_player_dropped_item = 96,
-    on_player_fast_transferred = 97,
-    on_player_flipped_entity = 98,
-    on_player_flushed_fluid = 99,
-    on_player_gun_inventory_changed = 100,
-    on_player_input_method_changed = 101,
-    on_player_joined_game = 102,
-    on_player_kicked = 103,
-    on_player_left_game = 104,
-    on_player_locale_changed = 105,
-    on_player_main_inventory_changed = 106,
-    on_player_mined_entity = 107,
-    on_player_mined_item = 108,
-    on_player_mined_tile = 109,
-    on_player_muted = 110,
-    on_player_pipette = 111,
-    on_player_placed_equipment = 112,
-    on_player_promoted = 113,
-    on_player_removed = 114,
-    on_player_removed_equipment = 115,
-    on_player_repaired_entity = 116,
-    on_player_respawned = 117,
-    on_player_reverse_selected_area = 118,
-    on_player_rotated_entity = 119,
-    on_player_selected_area = 120,
-    on_player_set_quick_bar_slot = 121,
-    on_player_setup_blueprint = 122,
-    on_player_toggled_alt_mode = 123,
-    on_player_toggled_map_editor = 124,
-    on_player_trash_inventory_changed = 125,
-    on_player_unbanned = 126,
-    on_player_unmuted = 127,
-    on_player_used_capsule = 128,
-    on_player_used_spidertron_remote = 129,
-    on_post_entity_died = 130,
-    on_post_segmented_unit_died = 131,
-    on_pre_build = 132,
-    on_pre_chunk_deleted = 133,
-    on_pre_entity_settings_pasted = 134,
-    on_pre_ghost_deconstructed = 135,
-    on_pre_ghost_upgraded = 136,
-    on_pre_permission_group_deleted = 137,
-    on_pre_permission_string_imported = 138,
-    on_pre_player_crafted_item = 139,
-    on_pre_player_died = 140,
-    on_pre_player_left_game = 141,
-    on_pre_player_mined_item = 142,
-    on_pre_player_removed = 143,
-    on_pre_player_toggled_map_editor = 144,
-    on_pre_robot_exploded_cliff = 145,
-    on_pre_scenario_finished = 146,
-    on_pre_script_inventory_resized = 147,
-    on_pre_surface_cleared = 148,
-    on_pre_surface_deleted = 149,
-    on_redo_applied = 150,
-    on_research_cancelled = 151,
-    on_research_finished = 152,
-    on_research_moved = 153,
-    on_research_queued = 154,
-    on_research_reversed = 155,
-    on_research_started = 156,
-    on_resource_depleted = 157,
-    on_robot_built_entity = 158,
-    on_robot_built_tile = 159,
-    on_robot_exploded_cliff = 160,
-    on_robot_mined = 161,
-    on_robot_mined_entity = 162,
-    on_robot_mined_tile = 163,
-    on_robot_pre_mined = 164,
-    on_rocket_launch_ordered = 165,
-    on_rocket_launched = 166,
-    on_runtime_mod_setting_changed = 167,
-    on_script_inventory_resized = 168,
-    on_script_path_request_finished = 169,
-    on_script_trigger_effect = 170,
-    on_sector_scanned = 171,
-    on_segment_entity_created = 172,
-    on_segmented_unit_created = 173,
-    on_segmented_unit_damaged = 174,
-    on_segmented_unit_died = 175,
-    on_selected_entity_changed = 176,
-    on_singleplayer_init = 177,
-    on_space_platform_built_entity = 178,
-    on_space_platform_built_tile = 179,
-    on_space_platform_changed_state = 180,
-    on_space_platform_mined_entity = 181,
-    on_space_platform_mined_item = 182,
-    on_space_platform_mined_tile = 183,
-    on_space_platform_pre_mined = 184,
-    on_spider_command_completed = 185,
-    on_string_translated = 186,
-    on_surface_cleared = 187,
-    on_surface_created = 188,
-    on_surface_deleted = 189,
-    on_surface_imported = 190,
-    on_surface_renamed = 191,
-    on_technology_effects_reset = 192,
-    on_territory_created = 193,
-    on_territory_destroyed = 194,
-    on_tick = 195,
-    on_tower_mined_plant = 196,
-    on_tower_planted_seed = 197,
-    on_tower_pre_mined_plant = 198,
-    on_train_changed_state = 199,
-    on_train_created = 200,
-    on_train_schedule_changed = 201,
-    on_trigger_created_entity = 202,
-    on_trigger_fired_artillery = 203,
-    on_udp_packet_received = 204,
-    on_undo_applied = 205,
-    on_unit_added_to_group = 206,
-    on_unit_group_created = 207,
-    on_unit_group_finished_gathering = 208,
-    on_unit_removed_from_group = 209,
-    on_worker_robot_expired = 210,
-    script_raised_built = 211,
-    script_raised_destroy = 212,
-    script_raised_destroy_segmented_unit = 213,
-    script_raised_revive = 214,
-    script_raised_set_tiles = 215,
-    script_raised_teleported = 216
+    on_player_dropped_item_into_entity = 97,
+    on_player_fast_transferred = 98,
+    on_player_flipped_entity = 99,
+    on_player_flushed_fluid = 100,
+    on_player_gun_inventory_changed = 101,
+    on_player_input_method_changed = 102,
+    on_player_joined_game = 103,
+    on_player_kicked = 104,
+    on_player_left_game = 105,
+    on_player_locale_changed = 106,
+    on_player_main_inventory_changed = 107,
+    on_player_mined_entity = 108,
+    on_player_mined_item = 109,
+    on_player_mined_tile = 110,
+    on_player_muted = 111,
+    on_player_pipette = 112,
+    on_player_placed_equipment = 113,
+    on_player_promoted = 114,
+    on_player_removed = 115,
+    on_player_removed_equipment = 116,
+    on_player_repaired_entity = 117,
+    on_player_respawned = 118,
+    on_player_reverse_selected_area = 119,
+    on_player_rotated_entity = 120,
+    on_player_selected_area = 121,
+    on_player_set_quick_bar_slot = 122,
+    on_player_setup_blueprint = 123,
+    on_player_toggled_alt_mode = 124,
+    on_player_toggled_map_editor = 125,
+    on_player_trash_inventory_changed = 126,
+    on_player_unbanned = 127,
+    on_player_unmuted = 128,
+    on_player_used_capsule = 129,
+    on_player_used_spidertron_remote = 130,
+    on_post_entity_died = 131,
+    on_post_segmented_unit_died = 132,
+    on_pre_build = 133,
+    on_pre_chunk_deleted = 134,
+    on_pre_entity_settings_pasted = 135,
+    on_pre_ghost_deconstructed = 136,
+    on_pre_ghost_upgraded = 137,
+    on_pre_permission_group_deleted = 138,
+    on_pre_permission_string_imported = 139,
+    on_pre_player_crafted_item = 140,
+    on_pre_player_died = 141,
+    on_pre_player_left_game = 142,
+    on_pre_player_mined_item = 143,
+    on_pre_player_removed = 144,
+    on_pre_player_toggled_map_editor = 145,
+    on_pre_robot_exploded_cliff = 146,
+    on_pre_scenario_finished = 147,
+    on_pre_script_inventory_resized = 148,
+    on_pre_surface_cleared = 149,
+    on_pre_surface_deleted = 150,
+    on_redo_applied = 151,
+    on_research_cancelled = 152,
+    on_research_finished = 153,
+    on_research_moved = 154,
+    on_research_queued = 155,
+    on_research_reversed = 156,
+    on_research_started = 157,
+    on_resource_depleted = 158,
+    on_robot_built_entity = 159,
+    on_robot_built_tile = 160,
+    on_robot_exploded_cliff = 161,
+    on_robot_mined = 162,
+    on_robot_mined_entity = 163,
+    on_robot_mined_tile = 164,
+    on_robot_pre_mined = 165,
+    on_rocket_launch_ordered = 166,
+    on_rocket_launched = 167,
+    on_runtime_mod_setting_changed = 168,
+    on_script_inventory_resized = 169,
+    on_script_path_request_finished = 170,
+    on_script_trigger_effect = 171,
+    on_sector_scanned = 172,
+    on_segment_entity_created = 173,
+    on_segmented_unit_created = 174,
+    on_segmented_unit_damaged = 175,
+    on_segmented_unit_died = 176,
+    on_selected_entity_changed = 177,
+    on_singleplayer_init = 178,
+    on_space_platform_built_entity = 179,
+    on_space_platform_built_tile = 180,
+    on_space_platform_changed_state = 181,
+    on_space_platform_mined_entity = 182,
+    on_space_platform_mined_item = 183,
+    on_space_platform_mined_tile = 184,
+    on_space_platform_pre_mined = 185,
+    on_spider_command_completed = 186,
+    on_string_translated = 187,
+    on_surface_cleared = 188,
+    on_surface_created = 189,
+    on_surface_deleted = 190,
+    on_surface_imported = 191,
+    on_surface_renamed = 192,
+    on_technology_effects_reset = 193,
+    on_territory_created = 194,
+    on_territory_destroyed = 195,
+    on_tick = 196,
+    on_tower_mined_plant = 197,
+    on_tower_planted_seed = 198,
+    on_tower_pre_mined_plant = 199,
+    on_train_changed_state = 200,
+    on_train_created = 201,
+    on_train_schedule_changed = 202,
+    on_trigger_created_entity = 203,
+    on_trigger_fired_artillery = 204,
+    on_udp_packet_received = 205,
+    on_undo_applied = 206,
+    on_unit_added_to_group = 207,
+    on_unit_group_created = 208,
+    on_unit_group_finished_gathering = 209,
+    on_unit_removed_from_group = 210,
+    on_worker_robot_expired = 211,
+    script_raised_built = 212,
+    script_raised_destroy = 213,
+    script_raised_destroy_segmented_unit = 214,
+    script_raised_revive = 215,
+    script_raised_set_tiles = 216,
+    script_raised_teleported = 217
 }
 enum flow_precision_index {
     fifty_hours = 5,

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 2.0.67
+// Factorio version 2.0.70
 // API version 6
 
 declare namespace runtime {
@@ -2269,6 +2269,24 @@ interface on_player_dropped_item {
      */
     tick: uint32;
 }
+/**
+ * Called when a player drops a single item into an entity.
+ */
+interface on_player_dropped_item_into_entity {
+    /**
+     * The entity the item was dropped into.
+     */
+    entity: LuaEntity;
+    /**
+     * Identifier of the event
+     */
+    name: defines.events;
+    player_index: uint32;
+    /**
+     * Tick the event was generated.
+     */
+    tick: uint32;
+}
 /**
  * Called when a player fast-transfers something to or from an entity.
  */

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 2.0.67
+// Factorio version 2.0.70
 // API version 6
 
 /**

package/dist/prototypes.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/prototype-api.json
 // Definition source https://github.com/sguest/factorio-types
-// Factorio version 2.0.67
+// Factorio version 2.0.70
 // API version 6
 
 declare namespace prototype {
@@ -691,12 +691,17 @@ interface ArtilleryFlarePrototype extends EntityPrototype {
     render_layer_when_on_ground?: RenderLayer;
     /**
      * The entity with the higher number is selectable before the entity with the lower number.
+     *
+     * The value `0` will be treated the same as `nil`.
      */
     selection_priority?: uint8;
     /**
      * Shadow variation variation count and individual frame count must be equal to picture variation count.
      */
     shadows?: AnimationVariations;
+    /**
+     * Only artillery turrets/wagons whose ammo's {@link ammo_category | prototype:AmmoItemPrototype::ammo_category} matches this category will shoot at this flare. Defaults to all ammo categories being able to shoot at this flare.
+     */
     shot_category?: AmmoCategoryID;
     /**
      * How many artillery shots should be fired at the position of this flare.
@@ -859,7 +864,7 @@ interface AssemblingMachinePrototype extends CraftingMachinePrototype {
     default_recipe_finished_signal?: SignalIDConnector;
     default_working_signal?: SignalIDConnector;
     /**
-     * Defaults to true if fixed_recipe is not given.
+     * Defaults to true if `fixed_recipe` is not given.
      */
     disabled_when_recipe_not_researched?: boolean;
     draw_circuit_wires?: boolean;
@@ -1401,6 +1406,9 @@ interface CargoLandingPadPrototype extends EntityWithOwnerPrototype {
     draw_copper_wires?: boolean;
     graphics_set?: CargoBayConnectableGraphicsSet;
     inventory_size: ItemStackIndex;
+    /**
+     * In chunks. The radius of how many chunks this cargo landing pad charts around itself.
+     */
     radar_range?: uint32;
     radar_visualisation_color?: Color;
     /**
@@ -1930,6 +1938,7 @@ interface CorpsePrototype extends EntityPrototype {
     ground_patch_fade_out_start?: float;
     ground_patch_higher?: AnimationVariations;
     ground_patch_render_layer?: RenderLayer;
+    protected_from_tile_building?: boolean;
     remove_on_entity_placement?: boolean;
     remove_on_tile_placement?: boolean;
     /**
@@ -2682,7 +2691,7 @@ interface DeliverImpactCombination {
      * Name of the deliver impact combination.
      */
     name: string;
-    trigger_effect_item: TriggerEffectItem;
+    trigger_effect_item: TriggerEffect;
     type: 'deliver-impact-combination';
 }
 /**
@@ -2706,7 +2715,7 @@ interface DestroyCliffAchievementPrototype extends AchievementPrototype {
     limited_to_one_game?: boolean;
 }
 /**
- * A display panel prototype to provide a prototype for display panels.
+ * Entity that display a signal icon and some text, either configured directly in the entity or through the circuit network.
  */
 interface DisplayPanelPrototype extends EntityWithOwnerPrototype {
     /**
@@ -2726,7 +2735,7 @@ interface DisplayPanelPrototype extends EntityWithOwnerPrototype {
     draw_circuit_wires?: boolean;
     draw_copper_wires?: boolean;
     /**
-     * The maximum width of the text on the display panel.
+     * The maximum display width of the text on the display panel. If the text exceeds this width it will be wrapped so that it continues on the next line.
      */
     max_text_width?: uint32;
     /**
@@ -3331,6 +3340,8 @@ interface EntityPrototype extends Prototype {
     selection_box?: BoundingBox;
     /**
      * The entity with the higher number is selectable before the entity with the lower number.
+     *
+     * The value `0` will be treated the same as `nil`.
      */
     selection_priority?: uint8;
     /**
@@ -3983,6 +3994,10 @@ interface FluidTurretPrototype extends TurretPrototype {
  */
 interface FluidWagonPrototype extends RollingStockPrototype {
     capacity: FluidAmount;
+    /**
+     * Pumps are only allowed to connect to this fluid wagon if the pump's {@link fluid box connection | prototype:PipeConnectionDefinition} and this fluid wagon share a connection category. Pump may have different connection categories on the input and output side, connection categories will be taken from the connection that is facing towards fluid wagon.
+     */
+    connection_category?: string | string[];
     quality_affects_capacity?: boolean;
     /**
      * Must be 1, 2 or 3.
@@ -5736,7 +5751,11 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
      */
     resource_drain_rate_percent?: uint8;
     /**
-     * The distance from the centre of the mining drill to search for resources in.
+     * Offset of the `resource_searching_radius` from the entity center when the mining drill is facing north.
+     */
+    resource_searching_offset?: Vector;
+    /**
+     * The distance from the center of the mining drill to search for resources in.
      *
      * This is 2.49 for electric mining drills (a 5x5 area) and 0.99 for burner mining drills (a 2x2 area). The drill searches resource outside its natural boundary box, which is 0.01 (the middle of the entity); making it 2.5 and 1.0 gives it another block radius.
      */
@@ -6760,7 +6779,7 @@ interface RailRampPrototype extends RailPrototype {
      */
     collision_box?: BoundingBox;
     /**
-     * Defaults to the mask from {@link UtilityConstants::default_collision_masks | prototype:UtilityConstants::default_collision_masks} when indexed by `"allow_on_deep_oil_ocean"`.
+     * Defaults to the mask from {@link UtilityConstants::default_collision_masks | prototype:UtilityConstants::default_collision_masks} when indexed by `"rail-ramp/allow_on_deep_oil_ocean"`.
      */
     collision_mask_allow_on_deep_oil_ocean?: CollisionMaskConnector;
     /**
@@ -6831,7 +6850,7 @@ interface RailSupportPrototype extends EntityWithOwnerPrototype {
      */
     build_grid_size?: 2;
     /**
-     * Defaults to the mask from {@link UtilityConstants::default_collision_masks | prototype:UtilityConstants::default_collision_masks} when indexed by `"allow_on_deep_oil_ocean"`.
+     * Defaults to the mask from {@link UtilityConstants::default_collision_masks | prototype:UtilityConstants::default_collision_masks} when indexed by `"rail-support/allow_on_deep_oil_ocean"`.
      */
     collision_mask_allow_on_deep_oil_ocean?: CollisionMaskConnector;
     /**
@@ -7553,7 +7572,7 @@ interface RoboportPrototype extends EntityWithOwnerPrototype {
     max_logistic_slots?: LogisticFilterIndex;
     open_door_trigger_effect?: TriggerEffect;
     /**
-     * Defaults to the max of logistic range or construction range rounded up to chunks.
+     * In chunks. The radius of how many chunks this roboport charts around itself. Defaults to the max of logistic range or construction range rounded up to chunks.
      */
     radar_range?: uint32;
     radar_visualisation_color?: Color;
@@ -8702,6 +8721,9 @@ interface SpiderUnitPrototype extends EntityWithOwnerPrototype {
     height: float;
     max_pursue_distance?: double;
     min_pursue_time?: uint32;
+    /**
+     * In chunks. The radius of how many chunks this spider unit charts around itself.
+     */
     radar_range?: uint32;
     spawning_time_modifier?: double;
     spider_engine: SpiderEngineSpecification;
@@ -9192,6 +9214,10 @@ interface SurfacePrototype extends Prototype {
      * Only loaded if `icons` is not defined.
      */
     icon_size?: SpriteSizeType;
+    /**
+     * Can't be an empty array.
+     */
+    icons?: IconData[];
     surface_properties?: LuaTable<SurfacePropertyID, double>;
 }
 /**
@@ -10019,6 +10045,9 @@ interface UnitPrototype extends EntityWithOwnerPrototype {
      * Movement speed of the unit in the world, in tiles per tick. Must be equal to or greater than 0.
      */
     movement_speed: float;
+    /**
+     * In chunks. The radius of how many chunks this unit charts around itself.
+     */
     radar_range?: uint32;
     render_layer?: RenderLayer;
     rotation_speed?: float;
@@ -10323,6 +10352,10 @@ interface UtilityConstants extends PrototypeBase {
     max_fluid_flow: FluidAmount;
     max_logistic_filter_count: LogisticFilterIndex;
     max_terrain_building_size: uint8;
+    /**
+     * Cap for how many steps of quality the output of something (miner/crafter) may be higher than the input (resource/ingredients). Must be >= 1.
+     */
+    maximum_quality_jump: uint8;
     maximum_recipe_overload_multiplier: uint32;
     medium_area_size: float;
     medium_blueprint_area_size: float;
@@ -10347,6 +10380,7 @@ interface UtilityConstants extends PrototypeBase {
      */
     player_colors: PlayerColorData[];
     probability_product_count_tint: Color;
+    quality_selector_dropdown_threshold: uint8;
     rail_planner_count_button_color: Color;
     rail_segment_colors: Color[];
     recipe_step_limit: uint32;
@@ -11142,6 +11176,9 @@ interface VehiclePrototype extends EntityWithOwnerPrototype {
      * Must be positive. There is no functional difference between the two ways to set braking power/force.
      */
     braking_power: Energy | double;
+    /**
+     * In chunks. The radius of the radar range of the vehicle, so how many chunks it charts around itself.
+     */
     chunk_exploration_radius?: uint32;
     crash_trigger?: TriggerEffect;
     /**

package/dist/types.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/prototype-api.json
 // Definition source https://github.com/sguest/factorio-types
-// Factorio version 2.0.67
+// Factorio version 2.0.70
 // API version 6
 
 declare namespace prototype {
@@ -188,7 +188,7 @@ type Alignment = 'top-left' | 'middle-left' | /**
 'left' | 'bottom-left' | 'top-center' | 'middle-center' | /**
  * The same as `"middle-center"`
  */
-'center' | 'bottom-center' | 'top-right' | /**
+'center' | 'bottom-center' | 'top-right' | 'middle-right' | /**
  * The same as `"middle-right"`
  */
 'right' | 'bottom-right';
@@ -2323,6 +2323,14 @@ interface CargoStationParameters {
      */
     giga_hatch_definitions?: GigaCargoHatchDefinition[];
     hatch_definitions?: CargoHatchDefinition[];
+    /**
+     * If set to false, this station will not accept incoming cargo units even if it has hatches that can. (can occur through linked cargo bays)
+     */
+    is_input_station?: boolean;
+    /**
+     * If set to false, this station will not dispatch cargo units even if it has hatches that can. (can occur through linked cargo bays)
+     */
+    is_output_station?: boolean;
     /**
      * Packed cargo units will wait for the full order to be completed. This is useful to save rockets in rocket silos when items trickle in slowly. The platform hub has immediate access to items so false is better to allow partial fulfillments.
      */
@@ -6899,6 +6907,9 @@ interface NoiseFunction {
      */
     parameters: string[];
 }
+/**
+ * Modifier that does nothing. Can be used to show custom scripted effects in the technology GUI.
+ */
 interface NothingModifier extends BaseModifier {
     effect_description?: LocalisedString;
     type: 'nothing';
@@ -7189,9 +7200,9 @@ type PersistentWorldAmbientSoundsDefinitionCrossfade = Fade & {
 };
 interface PipeConnectionDefinition {
     /**
-     * Connection category bitmask makes it possible to define different categories of pipe connections that are not able to connect with each other. For example if a mod should have a "steam pipes" and "cryogenic pipes" category and they should not connect with each other.
+     * Fluidboxes' pipe connections are only allowed to connect with each other if they share a connection category. For example a mod could have a "steam pipes" and "cryogenic pipes" category that should not connect with each other.
      *
-     * In case of a normal connection, a bitmask may contain multiple bits set. This allows to create a mod where pipes of different categories would not connect to each other while still making it possible for crafting machines and other entities to connect to any of the specified pipes.
+     * In case of a normal connection, a pipe connection can be in multiple connection categories. This allows to create a mod where pipes of different categories would not connect to each other while still making it possible for crafting machines and other entities to connect to any of the specified pipes.
      *
      * By default, all pipe connections have the `"default"` category. So a pipe that should connect to a new category and standard pipes can have the `connection_category = {"my-new-pipe", "default"}`.
      *
@@ -8710,6 +8721,29 @@ interface ScriptTriggerEffectItem extends TriggerEffectItem {
     effect_id: string;
     type: 'script';
 }
+/**
+ * Triggered only by calling {@link LuaForce::script_trigger_research | runtime:LuaForce::script_trigger_research}. Can be used to show custom scripted triggers in the technology GUI.
+ */
+interface ScriptedTechnologyTrigger {
+    /**
+     * Path to the icon file.
+     *
+     * Only loaded if `icons` is not defined.
+     */
+    icon?: FileName;
+    /**
+     * The size of the square icon, in pixels. E.g. `32` for a 32px by 32px icon. Must be larger than `0`.
+     *
+     * Only loaded if `icons` is not defined.
+     */
+    icon_size?: SpriteSizeType;
+    /**
+     * Can't be an empty array.
+     */
+    icons?: IconData[];
+    trigger_description?: LocalisedString;
+    type: 'scripted';
+}
 interface ScrollBarStyleSpecification extends BaseStyleSpecification {
     background_graphical_set?: ElementImageSet;
     thumb_button_style?: ButtonStyleSpecification;
@@ -10586,7 +10620,10 @@ CaptureSpawnerTechnologyTrigger | /**
 BuildEntityTechnologyTrigger | /**
  * Loaded when the `type` is `"create-space-platform"`.
  */
-CreateSpacePlatformTechnologyTrigger;
+CreateSpacePlatformTechnologyTrigger | /**
+ * Loaded when the `type` is `"scripted"`.
+ */
+ScriptedTechnologyTrigger;
 /**
  * Either `count` or `count_formula` must be defined, never both.
  * @example ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "factorio-types",
-  "version": "1.2.50",
+  "version": "1.2.52",
   "description": "Typescript declarations for the Factorio mod API",
   "main": "index.d.ts",
   "repository": "https://github.com/sguest/factorio-types.git",
@@ -23,7 +23,7 @@
     "src/**/*.d.ts",
     "dist/**/*.d.ts"
   ],
-  "factorioVersion": "2.0.67",
+  "factorioVersion": "2.0.70",
   "dependencies": {
     "lua-types": "^2.13.1"
   },