factorio-types 1.2.52 → 1.2.54

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.70
+// Factorio version 2.0.73
 // API version 6
 
 declare namespace runtime {
@@ -5120,7 +5120,7 @@ interface LuaControl {
      */
     can_reach_entity(this: void, entity: LuaEntity): boolean;
     /**
-     * Cancels crafting the given count of the given crafting queue index.
+     * Cancels the given amount of crafts at the given crafting queue position. If this causes any later crafts that depend on the cancelled one to have insufficient ingredients, those crafts will also be cancelled.
      * @param table.index The crafting queue index.
      * @param table.count The count to cancel crafting.
      */
@@ -6327,7 +6327,7 @@ interface LuaEntity extends LuaControl {
      * @param index Index of the transport line. Transport lines are 1-indexed.
      * @param position Linear position along the transport line. Clamped to the transport line range.
      */
-    get_line_item_position(this: void, index: uint32, position: float): MapPosition;
+    get_line_item_position(this: void, index: defines.transport_line, position: float): MapPosition;
     /**
      * Gets all the `LuaLogisticPoint`s that this entity owns. Optionally returns only the point specified by the index parameter.
      * @param index If provided, this method only returns the `LuaLogisticPoint` specified by this index, or `nil` if it doesn't exist.
@@ -6344,7 +6344,7 @@ interface LuaEntity extends LuaControl {
     /**
      * Get the maximum transport line index of a belt or belt connectable entity.
      */
-    get_max_transport_line_index(this: void): uint32;
+    get_max_transport_line_index(this: void): defines.transport_line;
     /**
      * Inventory for storing modules of this entity; `nil` if this entity has no module inventory.
      */
@@ -6481,7 +6481,7 @@ interface LuaEntity extends LuaControl {
      * Get a transport line of a belt or belt connectable entity.
      * @param index Index of the requested transport line. Transport lines are 1-indexed.
      */
-    get_transport_line(this: void, index: uint32): LuaTransportLine;
+    get_transport_line(this: void, index: defines.transport_line): LuaTransportLine;
     /**
      * Returns the new entity prototype and its quality.
      * @returns [0] - `nil` if this entity is not marked for upgrade.
@@ -6492,11 +6492,11 @@ interface LuaEntity extends LuaControl {
         LuaQualityPrototype | null
     ]>;
     /**
-     * Gets a single wire connector of this entity
+     * Gets a single wire connector of this entity, if any.
      * @param wire_connector_id Identifier of a specific connector to get
      * @param or_create If true and connector does not exist, it will be allocated if possible
      */
-    get_wire_connector(this: void, wire_connector_id: defines.wire_connector_id, or_create: boolean): LuaWireConnector;
+    get_wire_connector(this: void, wire_connector_id: defines.wire_connector_id, or_create: boolean): LuaWireConnector | null;
     /**
      * Gets all wire connectors of this entity
      * @param or_create If true, it will try to create all connectors possible
@@ -6848,10 +6848,10 @@ 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).
      *
-     * Writing to this is deprecated and affects only the {@link disabled_by_script | runtime:LuaEntity::disabled_by_script} state.
-     *
      * 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.
      *
+     * Writing to this is deprecated and affects only the {@link disabled_by_script | runtime:LuaEntity::disabled_by_script} state.
+     *
      * 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;
@@ -7100,16 +7100,22 @@ interface LuaEntity extends LuaControl {
     direction: defines.direction;
     /**
      * If the updatable entity is disabled by control behavior.
+     *
+     * Always returns `false` if this entity is not considered {@link updatable | runtime:LuaEntity::is_updatable}.
      */
     readonly disabled_by_control_behavior: boolean;
     /**
      * 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}.
+     *
+     * Always returns `false` if this entity is not considered {@link updatable | runtime:LuaEntity::is_updatable}.
      */
     readonly disabled_by_recipe: boolean;
     /**
      * If the updatable entity is disabled by script.
      *
      * Note: Some entities (Corpse, FireFlame, Roboport, RollingStock, dying entities) need to remain active and will ignore writes.
+     *
+     * If this entity is not considered {@link updatable | runtime:LuaEntity::is_updatable} then this always returns `false` and writes will be ignored.
      */
     disabled_by_script: boolean;
     display_panel_always_show: boolean;
@@ -7225,7 +7231,9 @@ interface LuaEntity extends LuaControl {
      */
     friction_modifier: float;
     /**
-     * If the freezable entity is currently frozen.
+     * Whether the freezable entity is currently frozen.
+     *
+     * Always returns `false` if this entity is not considered {@link freezable | runtime:LuaEntity::is_freezable}.
      */
     readonly frozen: boolean;
     readonly ghost_localised_description: LocalisedString;
@@ -7341,7 +7349,7 @@ interface LuaEntity extends LuaControl {
      */
     readonly is_entity_with_owner: boolean;
     /**
-     * If the entity is freezable.
+     * Whether the entity is freezable and considered a FreezableEntity.
      */
     readonly is_freezable: boolean;
     /**
@@ -7353,7 +7361,7 @@ interface LuaEntity extends LuaControl {
      */
     is_military_target: boolean;
     /**
-     * If the entity is updatable.
+     * Whether the entity is updatable and considered an UpdatableEntity.
      */
     readonly is_updatable: boolean;
     /**
@@ -7478,10 +7486,10 @@ interface LuaEntity extends LuaControl {
      *
      * - When called on a pipe-connectable entity, this is an array of entity arrays of all entities a given fluidbox is connected to.
      * - When called on an underground transport belt, this is the other end of the underground belt connection, or `nil` if none.
-     * - When called on a wall-connectable entity or reactor, this is a dictionary of all connections indexed by the connection direction "north", "south", "east", and "west".
+     * - When called on a wall-connectable entity, reactor or heat pipe, this is a dictionary of all connections indexed by the connection direction "north", "south", "east", and "west".
      * - When called on a cliff entity, this is a dictionary of all connections indexed by the connection direction "north", "south", "east", and "west".
      */
-    readonly neighbours?: Record<string, LuaEntity[]> | LuaEntity[][] | LuaEntity;
+    readonly neighbours?: Record<string, LuaEntity> | LuaEntity[][] | LuaEntity;
     /**
      * The class name of this object. Available even when `valid` is false. For LuaStruct objects it may also be suffixed with a dotted path to a member of the struct.
      */
@@ -7664,7 +7672,7 @@ interface LuaEntity extends LuaControl {
      */
     readonly rocket?: LuaEntity;
     /**
-     * Number of rocket parts in the silo.
+     * Number of rocket parts in this rocket silo.
      */
     rocket_parts: uint32;
     /**
@@ -7697,6 +7705,10 @@ interface LuaEntity extends LuaControl {
      * {@link LuaEntityPrototype::selection_box | runtime:LuaEntityPrototype::selection_box} around entity's given position and respecting the current entity orientation.
      */
     readonly selection_box: BoundingBox;
+    /**
+     * Whether this rocket silo is set to send items to orbit automatically. Only relevant if there is an item prototype with {@link launch products | runtime:LuaItemPrototype::rocket_launch_products} with automated {@link send_to_orbit_mode | runtime:LuaItemPrototype::send_to_orbit_mode}, such as the satellite in vanilla (without Space Age mod).
+     */
+    send_to_orbit_automatically: boolean;
     /**
      * The shooting target for this turret, if any. Can't be set to `nil` via script.
      */
@@ -9001,9 +9013,6 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
     readonly ticks_to_keep_aiming_direction?: uint32;
     readonly ticks_to_keep_gun?: uint32;
     readonly ticks_to_stay_in_combat?: uint32;
-    /**
-     * The tile buildability rules of this entity prototype.
-     */
     readonly tile_buildability_rules?: TileBuildabilityRule[];
     /**
      * Specifies the tiling size of the entity, is used to decide, if the center should be in the center of the tile (odd tile size dimension) or on the tile border (even tile size dimension)
@@ -13947,7 +13956,7 @@ interface LuaLogisticPoint {
     /**
      * The Logistic member index of this logistic point.
      */
-    readonly logistic_member_index: uint32;
+    readonly logistic_member_index: defines.logistic_member_index;
     readonly logistic_network: LuaLogisticNetwork;
     /**
      * The logistic mode.
@@ -19273,6 +19282,10 @@ interface BaseLuaSurfaceCreateEntityParams {
      * If provided, the entity will attempt to pull stored values from this item (for example; creating a spidertron from a previously named and mined spidertron)
      */
     'item'?: LuaItemStack;
+    /**
+     * Whether this entity is mirrored. Defaults to `false`.
+     */
+    'mirror'?: boolean;
     /**
      * If true, any characters that are in the way of the entity are teleported out of the way.
      */
@@ -19354,7 +19367,7 @@ interface LuaSurfaceCreateEntityParamsAmmoTurret extends BaseLuaSurfaceCreateEnt
      * Defaults to `false`.
      */
     'ignore-unprioritised'?: boolean;
-    'priority-list'?: SlotFilter;
+    'priority-list'?: SlotFilter[];
 }
 /**
  *
@@ -19595,7 +19608,7 @@ interface LuaSurfaceCreateEntityParamsElectricTurret extends BaseLuaSurfaceCreat
      * Defaults to `false`.
      */
     'ignore-unprioritised'?: boolean;
-    'priority-list'?: SlotFilter;
+    'priority-list'?: SlotFilter[];
 }
 /**
  *
@@ -19631,7 +19644,7 @@ interface LuaSurfaceCreateEntityParamsFluidTurret extends BaseLuaSurfaceCreateEn
      * Defaults to `false`.
      */
     'ignore-unprioritised'?: boolean;
-    'priority-list'?: SlotFilter;
+    'priority-list'?: SlotFilter[];
 }
 /**
  *
@@ -19783,6 +19796,7 @@ interface LuaSurfaceCreateEntityParamsLamp extends BaseLuaSurfaceCreateEntityPar
      * Defaults to white.
      */
     'color'?: Color;
+    'control_behavior'?: LampBlueprintControlBehavior;
 }
 /**
  *
@@ -19813,6 +19827,7 @@ interface LuaSurfaceCreateEntityParamsLinkedContainer extends BaseLuaSurfaceCrea
  */
 interface LuaSurfaceCreateEntityParamsLoader extends BaseLuaSurfaceCreateEntityParams {
     'belt_stack_size_override'?: uint8;
+    'control_behavior'?: LoaderBlueprintControlBehavior;
     'filter_mode'?: PrototypeFilterMode;
     'filters'?: SlotFilter[];
     /**
@@ -19826,6 +19841,7 @@ interface LuaSurfaceCreateEntityParamsLoader extends BaseLuaSurfaceCreateEntityP
  */
 interface LuaSurfaceCreateEntityParamsLoader1x1 extends BaseLuaSurfaceCreateEntityParams {
     'belt_stack_size_override'?: uint8;
+    'control_behavior'?: LoaderBlueprintControlBehavior;
     'filter_mode'?: PrototypeFilterMode;
     'filters'?: SlotFilter[];
     /**
@@ -20135,7 +20151,7 @@ interface LuaSurfaceCreateEntityParamsTurret extends BaseLuaSurfaceCreateEntityP
      * Defaults to `false`.
      */
     'ignore-unprioritised'?: boolean;
-    'priority-list'?: SlotFilter;
+    'priority-list'?: SlotFilter[];
 }
 /**
  *

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.70
+// Factorio version 2.0.73
 // API version 6
 
 declare namespace runtime {
@@ -545,7 +545,7 @@ interface BlueprintEntityAmmoTurret extends BaseBlueprintEntity {
      * Defaults to `false`.
      */
     'ignore-unprioritised'?: boolean;
-    'priority-list'?: SlotFilter;
+    'priority-list'?: SlotFilter[];
 }
 /**
  *
@@ -695,7 +695,7 @@ interface BlueprintEntityElectricTurret extends BaseBlueprintEntity {
      * Defaults to `false`.
      */
     'ignore-unprioritised'?: boolean;
-    'priority-list'?: SlotFilter;
+    'priority-list'?: SlotFilter[];
 }
 /**
  *
@@ -707,7 +707,7 @@ interface BlueprintEntityFluidTurret extends BaseBlueprintEntity {
      * Defaults to `false`.
      */
     'ignore-unprioritised'?: boolean;
-    'priority-list'?: SlotFilter;
+    'priority-list'?: SlotFilter[];
 }
 /**
  *
@@ -802,6 +802,7 @@ interface BlueprintEntityLamp extends BaseBlueprintEntity {
      */
     'always_on'?: boolean;
     'color'?: Color;
+    'control_behavior'?: LampBlueprintControlBehavior;
 }
 /**
  *
@@ -833,6 +834,7 @@ interface BlueprintEntityLinkedContainer extends BaseBlueprintEntity {
  */
 interface BlueprintEntityLoader extends BaseBlueprintEntity {
     'belt_stack_size_override'?: uint8;
+    'control_behavior'?: LoaderBlueprintControlBehavior;
     /**
      * Defaults to `"none"`.
      */
@@ -846,6 +848,7 @@ interface BlueprintEntityLoader extends BaseBlueprintEntity {
  */
 interface BlueprintEntityLoader1x1 extends BaseBlueprintEntity {
     'belt_stack_size_override'?: uint8;
+    'control_behavior'?: LoaderBlueprintControlBehavior;
     /**
      * Defaults to `"none"`.
      */
@@ -921,6 +924,10 @@ interface BlueprintEntityPump extends BaseBlueprintEntity {
  */
 interface BlueprintEntityRailChainSignal extends BaseBlueprintEntity {
     'control_behavior'?: RailSignalBaseBlueprintControlBehavior;
+    /**
+     * Defaults to `"ground"`.
+     */
+    'rail_layer'?: 'ground' | 'elevated';
 }
 /**
  *
@@ -928,6 +935,10 @@ interface BlueprintEntityRailChainSignal extends BaseBlueprintEntity {
  */
 interface BlueprintEntityRailSignal extends BaseBlueprintEntity {
     'control_behavior'?: RailSignalBaseBlueprintControlBehavior;
+    /**
+     * Defaults to `"ground"`.
+     */
+    'rail_layer'?: 'ground' | 'elevated';
 }
 /**
  *
@@ -1034,7 +1045,7 @@ interface BlueprintEntityTurret extends BaseBlueprintEntity {
      * Defaults to `false`.
      */
     'ignore-unprioritised'?: boolean;
-    'priority-list'?: SlotFilter;
+    'priority-list'?: SlotFilter[];
 }
 /**
  *
@@ -1152,12 +1163,18 @@ interface BlueprintLogisticSections {
     request_from_buffers?: boolean;
 }
 interface BlueprintMiningDrillFilter {
-    filters?: SlotFilter;
+    filters?: SlotFilter[];
     /**
      * Defaults to `"whitelist"`.
      */
     mode?: 'whitelist' | 'blacklist';
 }
+interface BlueprintQualityID {
+    /**
+     * The name of the quality prototype. Defaults to `"normal"`.
+     */
+    name?: string;
+}
 interface BlueprintSchedule {
     records?: BlueprintScheduleRecord[];
     group?: string;
@@ -4029,6 +4046,30 @@ string | /**
  * A table of item prototype and quality.
  */
 ItemIDAndQualityIDPair;
+interface LampBlueprintControlBehavior {
+    /**
+     * Defaults to `false`.
+     */
+    use_colors?: boolean;
+    red_signal?: SignalID;
+    green_signal?: SignalID;
+    blue_signal?: SignalID;
+    rgb_signal?: SignalID;
+    /**
+     * Defaults to `defines.control_behavior.lamp.color_mapping`.
+     */
+    color_mode?: defines.control_behavior.lamp.color_mode;
+    /**
+     * Defaults to `false`.
+     */
+    circuit_enabled?: boolean;
+    circuit_condition?: CircuitCondition;
+    /**
+     * Defaults to `false`.
+     */
+    connect_to_logistic_network?: boolean;
+    logistic_condition?: CircuitCondition;
+}
 /**
  * The internal name of a game control (key binding).
  */
@@ -4036,6 +4077,26 @@ type LinkedGameControl = 'move-up' | 'move-down' | 'move-left' | 'move-right' |
  * Indicates no linked game control.
  */
 '';
+interface LoaderBlueprintControlBehavior {
+    /**
+     * Defaults to `false`.
+     */
+    circuit_set_filters?: boolean;
+    /**
+     * Defaults to `false`.
+     */
+    circuit_read_transfers?: boolean;
+    /**
+     * Defaults to `false`.
+     */
+    circuit_enabled?: boolean;
+    circuit_condition?: CircuitCondition;
+    /**
+     * Defaults to `false`.
+     */
+    connect_to_logistic_network?: boolean;
+    logistic_condition?: CircuitCondition;
+}
 /**
  * Localised strings are a way to support translation of in-game text. It is an array where the first element is the key and the remaining elements are parameters that will be substituted for placeholders in the template designated by the key.
  *
@@ -6577,13 +6638,13 @@ interface MiningDrillBlueprintControlBehavior {
 }
 interface ModChangeData {
     /**
-     * Old version of the mod. May be `nil` if the mod wasn't previously present (i.e. it was just added).
+     * Old version of the mod. `nil` if the mod wasn't previously present (i.e. it was just added).
      */
-    old_version: string;
+    old_version?: string;
     /**
-     * New version of the mod. May be `nil` if the mod is no longer present (i.e. it was just removed).
+     * New version of the mod. `nil` if the mod is no longer present (i.e. it was just removed).
      */
-    new_version: string;
+    new_version?: string;
 }
 interface ModSetting {
     /**
@@ -8285,7 +8346,7 @@ interface SelectorCombinatorParametersCount extends BaseSelectorCombinatorParame
     /**
      * The signal to emit.
      */
-    'count_signal': SignalID;
+    'count_signal'?: SignalID;
 }
 /**
  *
@@ -8312,10 +8373,7 @@ interface SelectorCombinatorParametersQualityTransfer extends BaseSelectorCombin
     'operation'?: 'quality-transfer';
     'quality_destination_signal': SignalID;
     'quality_source_signal'?: SignalIDBase;
-    /**
-     * The name of the quality prototype. Defaults to `"normal"`.
-     */
-    'quality_source_static'?: string;
+    'quality_source_static'?: BlueprintQualityID;
     /**
      * Defaults to `false`.
      */
@@ -8602,6 +8660,11 @@ interface SpacePlatformHubBlueprintControlBehavior {
      */
     read_speed?: boolean;
     speed_signal?: SignalID;
+    /**
+     * Defaults to `false`.
+     */
+    read_damage_taken?: boolean;
+    damage_taken_signal?: SignalID;
 }
 interface SpacePlatformTileDefinition {
     tile: LuaTilePrototype;

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.70
+// Factorio version 2.0.73
 // 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.70
+// Factorio version 2.0.73
 // API version 6
 
 declare namespace defines {
@@ -1365,6 +1365,9 @@ enum logistic_group_type {
 enum logistic_member_index {
     car_provider = 10,
     car_requester = 9,
+    cargo_landing_pad_provider = 19,
+    cargo_landing_pad_requester = 18,
+    cargo_landing_pad_trash_provider = 20,
     character_provider = 5,
     character_requester = 3,
     character_storage = 4,

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.70
+// Factorio version 2.0.73
 // API version 6
 
 declare namespace runtime {

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.70
+// Factorio version 2.0.73
 // 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.70
+// Factorio version 2.0.73
 // API version 6
 
 declare namespace prototype {
@@ -3216,6 +3216,8 @@ interface EntityPrototype extends Prototype {
      * This allows you to replace an entity that's already placed, with a different one in your inventory. For example, replacing a burner inserter with a fast inserter. The replacement entity can be a different rotation to the replaced entity and you can replace an entity with the same type.
      *
      * This is simply a string, so any string can be used here. The entity that should be replaced simply has to use the same string here.
+     *
+     * Entities with the same fast replaceable group can be configured as upgrades for each other in the upgrade planner. Refer to the {@link upgrade planner prototype's page | prototype:UpgradeItemPrototype} the full requirements for entities to be shown in the upgrade planner.
      */
     fast_replaceable_group?: string;
     flags?: EntityPrototypeFlags;
@@ -3287,7 +3289,7 @@ interface EntityPrototype extends Prototype {
     mined_sound?: Sound;
     mining_sound?: Sound;
     /**
-     * Name of the entity that will be automatically selected as the upgrade of this entity when using the {@link upgrade planner | https://wiki.factorio.com/Upgrade_planner} without configuration.
+     * Name of the entity that will be automatically selected as the upgrade of this entity when using the {@link upgrade planner | prototype:UpgradeItemPrototype} without configuration.
      *
      * This entity may not have "not-upgradable" flag set and must be minable. This entity mining result must not contain item product with {@link hidden | prototype:ItemPrototype::hidden} set to `true`. Mining results with no item products are allowed. This entity may not be a {@link RollingStockPrototype | prototype:RollingStockPrototype}.
      *
@@ -6517,7 +6519,7 @@ interface QualityPrototype extends Prototype {
      */
     beacon_power_usage_multiplier?: float;
     /**
-     * Only affects beacons with {@link BeaconPrototype::quality_affects_supply_area | prototype:BeaconPrototype::quality_affects_supply_area} set.
+     * Only affects beacons with {@link BeaconPrototype::quality_affects_supply_area_distance | prototype:BeaconPrototype::quality_affects_supply_area_distance} set.
      *
      * Must be >= 0 and <= 64.
      */
@@ -6608,6 +6610,11 @@ interface QualityPrototype extends Prototype {
      * Must be >= 0.01.
      */
     logistic_cell_charging_energy_multiplier?: double;
+    /**
+     * Only affects roboports with {@link RoboportPrototype::charging_station_count_affected_by_quality | prototype:RoboportPrototype::charging_station_count_affected_by_quality} set.
+     *
+     * Only affects roboport equipment with {@link RoboportEquipmentPrototype::charging_station_count_affected_by_quality | prototype:RoboportEquipmentPrototype::charging_station_count_affected_by_quality} set.
+     */
     logistic_cell_charging_station_count_bonus?: uint32;
     /**
      * Only affects mining drills with {@link MiningDrillPrototype::quality_affects_mining_radius | prototype:MiningDrillPrototype::quality_affects_mining_radius} set.
@@ -10071,6 +10078,14 @@ interface UnitPrototype extends EntityWithOwnerPrototype {
 }
 /**
  * An {@link upgrade planner | https://wiki.factorio.com/Upgrade_planner}.
+ *
+ * For an entity to be allowed as an upgrade source, it must be minable, may not have "not-upgradable" flag set and may not be {@link hidden | prototype:PrototypeBase::hidden}. Additionally, the source entity's mining result must not be an item product that is {@link hidden | prototype:ItemPrototype::hidden}. Mining results with no item products are allowed.
+ *
+ * For an entity to be allowed as an upgrade target, it must have least 1 item that builds it that isn't hidden.
+ *
+ * For two entities to be upgrades of each other, the two entities must have the same {@link fast replaceable group | prototype:EntityPrototype::fast_replaceable_group}, the same {@link collision box | prototype:EntityPrototype::collision_box} and the same {@link collision mask | prototype:EntityPrototype::collision_mask}. Additionally, {@link underground belts | prototype:UndergroundBeltPrototype} cannot be upgraded to {@link transport belts | prototype:TransportBeltPrototype} and vice versa.
+ *
+ * For an entity to be automatically upgraded to another entity without configuring the upgrade planner, the {@link next upgrade | prototype:EntityPrototype::next_upgrade} of the upgrade source entity must be set.
  */
 interface UpgradeItemPrototype extends SelectionToolPrototype {
     /**

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.70
+// Factorio version 2.0.73
 // API version 6
 
 declare namespace prototype {
@@ -3736,58 +3736,6 @@ interface DirectTriggerItem extends TriggerItem {
     filter_enabled?: boolean;
     type: 'direct';
 }
-/**
- * Usually specified by using {@link defines.direction | runtime:defines.direction}.
- */
-type Direction = /**
- * North
- */
-0 | /**
- * NorthNorthEast
- */
-1 | /**
- * NorthEast
- */
-2 | /**
- * EastNorthEast
- */
-3 | /**
- * East
- */
-4 | /**
- * EastSouthEast
- */
-5 | /**
- * SouthEast
- */
-6 | /**
- * SouthSouthEast
- */
-7 | /**
- * South
- */
-8 | /**
- * SouthSouthWest
- */
-9 | /**
- * SouthWest
- */
-10 | /**
- * WestSouthWest
- */
-11 | /**
- * West
- */
-12 | /**
- * WestNorthWest
- */
-13 | /**
- * NorthWest
- */
-14 | /**
- * NorthNorthWest
- */
-15;
 interface DirectionShift {
     east?: Vector;
     north?: Vector;
@@ -5157,6 +5105,9 @@ interface GigaCargoHatchDefinition {
  * Note that when any technology prototype changes (regardless of which mod it belongs to), the game re-applies all researched technology effects, including `"give-item"` modifiers. This means that players will receive the item again, even if they already received it previously. This can be undesirable.
  */
 interface GiveItemModifier extends BaseModifier {
+    /**
+     * Must be >= `1`.
+     */
     count?: ItemCountType;
     item: ItemID;
     quality?: QualityID;
@@ -5269,7 +5220,7 @@ interface HeatConnection {
     /**
      * The "outward" direction of this heat connection. For a connection to succeed, the other heat connection must face the opposite direction (a south-facing connection needs a north-facing connection to succeed). A connection rotates with the entity.
      */
-    direction: Direction;
+    direction: defines.direction;
     /**
      * The location of the heat pipe connection, relative to the center of the entity in the north-facing direction.
      */
@@ -6374,7 +6325,7 @@ interface MapLocation {
     /**
      * Direction this connection point will be facing to.
      */
-    direction: Direction;
+    direction: defines.direction;
     /**
      * Position relative to entity's position where the connection point will be located at.
      */
@@ -7220,7 +7171,7 @@ interface PipeConnectionDefinition {
      *
      * Only loaded, and mandatory if `connection_type` is `"normal"` or `"underground"`.
      */
-    direction?: Direction;
+    direction?: defines.direction;
     /**
      * Array of the {@link WorkingVisualisation::name | prototype:WorkingVisualisation::name} of working visualisations to enable when this pipe connection is present.
      *
@@ -8503,7 +8454,7 @@ interface RotatedAnimation extends AnimationParameters {
      *
      * The sequential animation instance is loaded equal to the entities direction within the `direction_count` setting.
      *
-     * Direction count to {@link Direction | prototype:Direction} (animation sequence number):
+     * Direction count to {@link defines.direction | runtime:defines.direction} (animation sequence number):
      *
      * - `1`: North (1)
      *
@@ -10758,6 +10709,11 @@ interface TileBuildSound {
     medium?: Sound;
     small?: Sound;
 }
+/**
+ * Defines restrictions on what tiles an entity can or must be built on.
+ *
+ * Note that once the entity has been placed, placing new tiles is not always restricted by these rules for performance reasons. In particular, for most entities these rules are only checked when placing tiles within the collision box of the entity. The exception to this are thrusters and asteroid collectors, for which the rules are always checked.
+ */
 interface TileBuildabilityRule {
     area: SimpleBoundingBox;
     colliding_tiles?: CollisionMaskConnector;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "factorio-types",
-  "version": "1.2.52",
+  "version": "1.2.54",
   "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.70",
+  "factorioVersion": "2.0.73",
   "dependencies": {
     "lua-types": "^2.13.1"
   },