factorio-types 1.2.28 → 1.2.30

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.41
+// Factorio version 2.0.43
 // API version 6
 
 declare namespace runtime {
@@ -181,6 +181,7 @@ interface LuaAgriculturalTowerControlBehavior extends LuaGenericOnOffControlBeha
 interface LuaAirbornePollutantPrototype extends LuaPrototypeBase {
     readonly affects_evolution: boolean;
     readonly chart_color: Color;
+    readonly damages_trees: boolean;
     readonly localised_name_with_amount_key: string;
     /**
      * The class name of this object. Available even when `valid` is false. For LuaStruct objects it may also be suffixed with a dotted path to a member of the struct.
@@ -5240,7 +5241,7 @@ interface LuaControl {
      */
     readonly vehicle?: LuaEntity;
     /**
-     * Current walking state.
+     * Current walking state of the player, or the spider-vehicle the character is driving.
      * @example ```
     -- Make the player go north. Note that a one-shot action like this will only make the player walk for one tick.
     game.player.walking_state = {walking = true, direction = defines.direction.north}
@@ -6566,6 +6567,10 @@ interface LuaEntity extends LuaControl {
      * Use {@link force_finish_ascending | runtime:LuaEntity::force_finish_ascending} if you want it to only descend from orbit.
      */
     cargo_pod_destination: CargoDestination;
+    /**
+     * The origin of this cargo pod entity. (Must be a silo, hub or pad)
+     */
+    cargo_pod_origin?: LuaEntity;
     /**
      * The state of this cargo pod entity.
      */
@@ -6820,7 +6825,7 @@ interface LuaEntity extends LuaControl {
     /**
      * The {@link unit_number | runtime:LuaEntity::unit_number} of the entity contained in this ghost. It is the same as the unit number of the {@link EntityWithOwnerPrototype | prototype:EntityWithOwnerPrototype} that was destroyed to create this ghost. If it was created by other means, or if the inner entity does not support unit numbers, this property is `nil`.
      */
-    readonly ghost_unit_number?: uint;
+    readonly ghost_unit_number?: uint64;
     /**
      * Returns a {@link rich text | https://wiki.factorio.com/Rich_text} string containing this entity's position and surface name as a gps tag. {@link Printing | runtime:LuaGameScript::print} it will ping the location of the entity.
      * @example ```
@@ -7404,7 +7409,7 @@ interface LuaEntity extends LuaControl {
      *
      * Only entities inheriting from {@link EntityWithOwnerPrototype | prototype:EntityWithOwnerPrototype}, as well as {@link ItemRequestProxyPrototype | prototype:ItemRequestProxyPrototype} and {@link EntityGhostPrototype | prototype:EntityGhostPrototype} are assigned a unit number. Returns `nil` otherwise.
      */
-    readonly unit_number?: uint;
+    readonly unit_number?: uint64;
     /**
      * The units associated with this spawner entity.
      */
@@ -12260,7 +12265,7 @@ interface LuaItemCommon {
     /**
      * The unique identifier for this item, if any. Note that this ID stays the same no matter where the item is moved to.
      */
-    readonly item_number?: uint;
+    readonly item_number?: uint64;
     /**
      * The current label for this item, if any.
      */
@@ -13899,7 +13904,7 @@ interface LuaPlayer extends LuaControl {
     set_controller(this: void, table: {
         type: defines.controllers;
         character?: LuaEntity;
-        waypoints?: CutsceneWaypoint;
+        waypoints?: CutsceneWaypoint[];
         start_position?: MapPosition;
         start_zoom?: double;
         final_transition_time?: uint;
@@ -16854,7 +16859,7 @@ interface LuaSurface {
      * @param table.force The force that would place the entity. Defaults to the `"neutral"` force.
      */
     can_fast_replace(this: void, table: {
-        name: string;
+        name: EntityID;
         position: MapPosition;
         direction?: defines.direction;
         force?: ForceID;
@@ -16870,7 +16875,7 @@ interface LuaSurface {
      * @param table.inner_name The prototype name of the entity contained in the ghost. Only used if `name` is `entity-ghost`.
      */
     can_place_entity(this: void, table: {
-        name: string;
+        name: EntityID;
         position: MapPosition;
         direction?: defines.direction;
         force?: ForceID;
@@ -17492,7 +17497,7 @@ interface LuaSurface {
      */
     remove_script_position(this: void, id: uint): boolean;
     /**
-     * Generates a path with the specified constraints (as an array of {@link PathfinderWaypoints | runtime:PathfinderWaypoint}) using the unit pathfinding algorithm. This path can be used to emulate pathing behavior by script for non-unit entities, such as vehicles. If you want to command actual units (such as biters or spitters) to move, use {@link LuaEntity::set_command | runtime:LuaEntity::set_command} instead.
+     * Generates a path with the specified constraints (as an array of {@link PathfinderWaypoints | runtime:PathfinderWaypoint}) using the unit pathfinding algorithm. This path can be used to emulate pathing behavior by script for non-unit entities, such as vehicles. If you want to command actual units (such as biters or spitters) to move, use {@link LuaCommandable::set_command | runtime:LuaCommandable::set_command} via {@link LuaEntity::commandable | runtime:LuaEntity::commandable} instead.
      *
      * The resulting path is ultimately returned asynchronously via {@link on_script_path_request_finished | runtime:on_script_path_request_finished}.
      * @param table.bounding_box The dimensions of the object that's supposed to travel the path.

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.41
+// Factorio version 2.0.43
 // API version 6
 
 declare namespace runtime {
@@ -170,6 +170,9 @@ interface AsteroidChunkPrototypeFilter {
      */
     invert?: boolean;
 }
+/**
+ * Used by {@link MapSettings | runtime:MapSettings} and {@link MapAndDifficultySettings | runtime:MapAndDifficultySettings}.
+ */
 interface AsteroidMapSettings {
     spawning_rate: double;
     max_ray_portals_expanded_per_tick: uint;
@@ -1608,7 +1611,7 @@ type EntityPrototypeFlag = /**
  * Used to automatically detect the proper direction of the entity if possible. Used by the pump, train stop, and train signal by default.
  */
 'filter-directions' | /**
- * When set, entity will be possible to obtain by using {@link LuaGameScript::get_entity_by_unit_number | runtime:LuaGameScript::get_entity_by_unit_number}. It also changes input actions sent by a player to be selecting entity by unit number instead of a position which may help players in latency to select moving entities.
+ * When set, entity will be possible to obtain by using {@link LuaGameScript::get_entity_by_unit_number | runtime:LuaGameScript::get_entity_by_unit_number}.
  */
 'get-by-unit-number' | /**
  * Used to specify that the entity breathes air, and is thus affected by poison.
@@ -2664,7 +2667,7 @@ interface BaseItemPrototypeFilter {
     /**
      * The condition to filter on.
      */
-    filter: 'tool' | 'mergeable' | 'hidden' | 'hidden-in-factoriopedia' | 'is-parameter' | 'item-with-inventory' | 'selection-tool' | 'item-with-label' | 'has-rocket-launch-products' | 'fuel' | 'place-result' | 'burnt-result' | 'place-as-tile' | 'placed-as-equipment-result' | 'name' | 'type' | 'flag' | 'subgroup' | 'fuel-category' | 'stack-size' | 'fuel-value' | 'fuel-acceleration-multiplier' | 'fuel-top-speed-multiplier' | 'fuel-emissions-multiplier';
+    filter: 'tool' | 'mergeable' | 'hidden' | 'hidden-in-factoriopedia' | 'is-parameter' | 'item-with-inventory' | 'selection-tool' | 'item-with-label' | 'has-rocket-launch-products' | 'fuel' | 'place-result' | 'burnt-result' | 'place-as-tile' | 'placed-as-equipment-result' | 'plant-result' | 'spoil-result' | 'name' | 'type' | 'flag' | 'subgroup' | 'fuel-category' | 'stack-size' | 'fuel-value' | 'fuel-acceleration-multiplier' | 'fuel-top-speed-multiplier' | 'fuel-emissions-multiplier';
     /**
      * How to combine this with the previous filter. Defaults to `"or"`. When evaluating the filters, `"and"` has higher precedence than `"or"`.
      */
@@ -2674,7 +2677,7 @@ interface BaseItemPrototypeFilter {
      */
     invert?: boolean;
 }
-type ItemPrototypeFilter = BaseItemPrototypeFilter | ItemPrototypeFilterBurntResult | ItemPrototypeFilterFlag | ItemPrototypeFilterFuelAccelerationMultiplier | ItemPrototypeFilterFuelCategory | ItemPrototypeFilterFuelEmissionsMultiplier | ItemPrototypeFilterFuelTopSpeedMultiplier | ItemPrototypeFilterFuelValue | ItemPrototypeFilterName | ItemPrototypeFilterPlaceAsTile | ItemPrototypeFilterPlaceResult | ItemPrototypeFilterPlacedAsEquipmentResult | ItemPrototypeFilterStackSize | ItemPrototypeFilterSubgroup | ItemPrototypeFilterType;
+type ItemPrototypeFilter = BaseItemPrototypeFilter | ItemPrototypeFilterBurntResult | ItemPrototypeFilterFlag | ItemPrototypeFilterFuelAccelerationMultiplier | ItemPrototypeFilterFuelCategory | ItemPrototypeFilterFuelEmissionsMultiplier | ItemPrototypeFilterFuelTopSpeedMultiplier | ItemPrototypeFilterFuelValue | ItemPrototypeFilterName | ItemPrototypeFilterPlaceAsTile | ItemPrototypeFilterPlaceResult | ItemPrototypeFilterPlacedAsEquipmentResult | ItemPrototypeFilterPlantResult | ItemPrototypeFilterSpoilResult | ItemPrototypeFilterStackSize | ItemPrototypeFilterSubgroup | ItemPrototypeFilterType;
 /**
  *
  * Applies to variant case `burnt-result`
@@ -2832,6 +2835,34 @@ interface ItemPrototypeFilterPlacedAsEquipmentResult extends BaseItemPrototypeFi
      */
     'elem_filters'?: EquipmentPrototypeFilter[];
 }
+/**
+ *
+ * Applies to variant case `plant-result`
+ */
+interface ItemPrototypeFilterPlantResult extends BaseItemPrototypeFilter {
+    /**
+     * The condition to filter on.
+     */
+    'filter': 'plant-result';
+    /**
+     * Filters for the plant result.
+     */
+    'elem_filters'?: EntityPrototypeFilter[];
+}
+/**
+ *
+ * Applies to variant case `spoil-result`
+ */
+interface ItemPrototypeFilterSpoilResult extends BaseItemPrototypeFilter {
+    /**
+     * The condition to filter on.
+     */
+    'filter': 'spoil-result';
+    /**
+     * Filters for the spoil result.
+     */
+    'elem_filters'?: ItemPrototypeFilter[];
+}
 /**
  * Usage example:
  *

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.41
+// Factorio version 2.0.43
 // 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.41
+// Factorio version 2.0.43
 // API version 6
 
 declare namespace defines {

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.41
+// Factorio version 2.0.43
 // 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.41
+// Factorio version 2.0.43
 // 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.41
+// Factorio version 2.0.43
 // API version 6
 
 declare namespace prototype {
@@ -127,7 +127,7 @@ interface AchievementPrototype extends Prototype {
     steam_stats_name?: string;
 }
 interface AchievementPrototypeWithCondition extends AchievementPrototype {
-    objective_condition: 'game-finished' | 'rocket-launched';
+    objective_condition: 'game-finished' | 'rocket-launched' | 'late-research';
 }
 /**
  * Used by {@link discharge defense | https://wiki.factorio.com/Discharge_defense} and {@link personal laser defense | https://wiki.factorio.com/Personal_laser_defense}.
@@ -196,6 +196,10 @@ interface AirbornePollutantPrototype extends Prototype {
      */
     affects_water_tint: boolean;
     chart_color: Color;
+    /**
+     * If true, trees will occasionally take damage from this pollutant type. When they do, some amount of pollution is removed from the chunk equal to the map's `pollution_restored_per_tree_damage` setting.
+     */
+    damages_trees?: boolean;
     icon: Sprite;
     /**
      * The translated plural string key to use when displaying this pollution's name with an amount. See {@link Tutorial:Localisation | https://wiki.factorio.com/Tutorial:Localisation}.
@@ -2731,7 +2735,6 @@ interface EditorControllerPrototype {
     fill_built_entity_energy_buffers: boolean;
     generate_neighbor_chunks: boolean;
     gun_inventory_size: ItemStackIndex;
-    ignore_surface_conditions: boolean;
     ignore_tile_conditions: boolean;
     instant_blueprint_building: boolean;
     instant_deconstruction: boolean;
@@ -3482,6 +3485,18 @@ interface ExplosionPrototype extends EntityPrototype {
     animations: AnimationVariations;
     beam?: boolean;
     correct_rotation?: boolean;
+    /**
+     * Number of ticks to delay the explosion effects by.
+     */
+    delay?: MapTick;
+    /**
+     * The maximum number of ticks to randomly delay the explosion effects by. In addition to the number of ticks defined by `delay`, the explosion will be delayed by a random number of ticks between 0 and `delay_deviation` (inclusive).
+     */
+    delay_deviation?: MapTick;
+    /**
+     * The effect/trigger that happens when the explosion effect triggers after the initial delay as defined by `delay` and `delay_deviation`.
+     */
+    explosion_effect?: Trigger;
     fade_in_duration?: uint8;
     fade_out_duration?: uint8;
     height?: float;
@@ -4500,6 +4515,12 @@ interface ItemGroup extends Prototype {
  * Possible configuration for all items.
  */
 interface ItemPrototype extends Prototype {
+    /**
+     * Whether the item should be included in the self-recycling recipes automatically generated by the quality mod.
+     *
+     * This property is not read by the game engine itself, but the quality mod's data-updates.lua file. This means it is discarded by the game engine after loading finishes.
+     */
+    auto_recycle?: boolean;
     /**
      * The item that is the result when this item gets burned as fuel.
      */
@@ -4633,7 +4654,7 @@ interface ItemPrototype extends Prototype {
      */
     send_to_orbit_mode?: SendToOrbitMode;
     /**
-     * Used by Inserters with spoil priority. Item with higher spoil level is considered more spoiled than item with lower spoil level regardless of progress of spoiling
+     * Used by Inserters with spoil priority. Item with higher spoil level is considered more spoiled than item with lower spoil level regardless of progress of spoiling.
      */
     spoil_level?: uint8;
     spoil_result?: ItemID;
@@ -6611,6 +6632,12 @@ interface RecipePrototype extends Prototype {
      * Whether the products are always shown in the recipe tooltip.
      */
     always_show_products?: boolean;
+    /**
+     * Whether the recipe should be included in the recycling recipes automatically generated by the quality mod.
+     *
+     * This property is not read by the game engine itself, but the quality mod's recycling.lua file. This means it is discarded by the game engine after loading finishes.
+     */
+    auto_recycle?: boolean;
     /**
      * The {@link category | prototype:RecipeCategory} of this recipe. Controls which machines can craft this recipe.
      *
@@ -7091,7 +7118,7 @@ interface RoboportPrototype extends EntityWithOwnerPrototype {
     construction_radius: float;
     default_available_construction_output_signal?: SignalIDConnector;
     default_available_logistic_output_signal?: SignalIDConnector;
-    default_roboports_output_signal?: SignalIDConnector;
+    default_roboport_count_output_signal?: SignalIDConnector;
     default_total_construction_output_signal?: SignalIDConnector;
     default_total_logistic_output_signal?: SignalIDConnector;
     door_animation_down?: Animation;
@@ -7679,7 +7706,7 @@ interface ShortcutPrototype extends Prototype {
     /**
      * If this is `"lua"`, {@link on_lua_shortcut | runtime:on_lua_shortcut} is raised when the shortcut is clicked.
      */
-    action: 'toggle-alt-mode' | 'undo' | 'copy' | 'cut' | 'paste' | 'import-string' | 'toggle-personal-roboport' | 'toggle-equipment-movement-bonus' | 'spawn-item' | 'lua';
+    action: 'toggle-alt-mode' | 'undo' | 'redo' | 'paste' | 'import-string' | 'toggle-personal-roboport' | 'toggle-personal-logistic-requests' | 'toggle-equipment-movement-bonus' | 'spawn-item' | 'lua';
     /**
      * Name of a custom input or vanilla control. This is **only** used to show the keybind in the tooltip of the shortcut.
      */
@@ -8066,7 +8093,7 @@ interface SpaceLocationPrototype extends Prototype {
     /**
      * A value which modifies platform speed; is subtracted when traveling from this location and added when traveling to this location.
      */
-    gravity_pull: double;
+    gravity_pull?: double;
     /**
      * Path to the icon file.
      *
@@ -8803,6 +8830,10 @@ interface TechnologyPrototype extends Prototype {
      * Mandatory if `unit` is not defined.
      */
     research_trigger?: TechnologyTrigger;
+    /**
+     * Can be used to enable or disable showing levels info in technology slot.
+     */
+    show_levels_info?: boolean;
     /**
      * Determines the cost in items and time of the technology.
      *
@@ -9720,6 +9751,9 @@ interface UtilityConstants extends PrototypeBase {
     equipment_default_background_color: Color;
     equipment_default_grabbed_background_color: Color;
     explosions_in_simulation_volume_modifier: float;
+    factoriopedia_recycling_recipe_categories: RecipeCategoryID[];
+    feedback_screenshot_file_name: string;
+    feedback_screenshot_subfolder_name: string;
     filter_outline_color: Color;
     /**
      * Must be >= 1.
@@ -9735,7 +9769,7 @@ interface UtilityConstants extends PrototypeBase {
     gui_remark_color: Color;
     gui_search_match_background_color: Color;
     gui_search_match_foreground_color: Color;
-    huge_animation_sound_area: float;
+    huge_platform_animation_sound_area: float;
     icon_shadow_color: Color;
     icon_shadow_inset: float;
     icon_shadow_radius: float;
@@ -9843,7 +9877,7 @@ interface UtilityConstants extends PrototypeBase {
     /**
      * Variables: speed, thrust, weight, width, height
      */
-    space_platform_default_speed_formula: MathExpression;
+    space_platform_acceleration_expression: MathExpression;
     /**
      * Determines how fast space platforms will send items in trash slots to the surface. Each item type has its own cooldown.
      */
@@ -9852,6 +9886,10 @@ interface UtilityConstants extends PrototypeBase {
     space_platform_relative_speed_factor: double;
     space_platform_starfield_movement_vector: Vector;
     spawner_evolution_factor_health_modifier: float;
+    starmap_orbit_clicked_color: Color;
+    starmap_orbit_default_color: Color;
+    starmap_orbit_disabled_color: Color;
+    starmap_orbit_hovered_color: Color;
     /**
      * The number of ticks to show a segmented unit's health bar after fully regenerating.
      */

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.41
+// Factorio version 2.0.43
 // API version 6
 
 declare namespace prototype {
@@ -175,7 +175,7 @@ interface AgriculturalCraneSpeedGrappler {
 "pollution"
 ```
  * @example ```
-"pollen"
+"spores"
 ```
  */
 type AirbornePollutantID = string;
@@ -2487,7 +2487,7 @@ interface ChartUtilityConstants {
     elevated_rail_color: Color;
     enabled_switch_color: Color;
     entity_ghost_color: Color;
-    explosion_visualization_duration: uint32;
+    explosion_visualization_duration: MapTick;
     green_signal_color: Color;
     green_wire_color: Color;
     rail_color: Color;
@@ -3195,7 +3195,7 @@ interface CranePartDyingEffect {
     explosion?: ExplosionDefinition;
     explosion_linear_distance_step?: float;
     particle_effect_linear_distance_step?: float;
-    particle_effects?: CreateParticleTriggerEffectItem[];
+    particle_effects?: CreateParticleTriggerEffectItem | CreateParticleTriggerEffectItem[];
 }
 interface CraterPlacementDefinition {
     minimum_segments_to_place?: uint32;
@@ -3352,7 +3352,7 @@ interface CreateTrivialSmokeEffectItem extends TriggerEffectItem {
     max_radius?: float;
     offset_deviation?: BoundingBox;
     offsets?: Vector[];
-    only_when_visible?: float;
+    only_when_visible?: boolean;
     smoke_name: TrivialSmokeID;
     speed?: Vector;
     speed_from_center?: float;
@@ -3372,8 +3372,8 @@ interface CursorBoxSpecification {
     not_allowed: BoxSpecification[];
     pair: BoxSpecification[];
     regular: BoxSpecification[];
-    rts_selected: BoxSpecification[];
-    rts_to_be_selected: BoxSpecification[];
+    spidertron_remote_selected: BoxSpecification[];
+    spidertron_remote_to_be_selected: BoxSpecification[];
     train_visualization: BoxSpecification[];
 }
 /**
@@ -3424,6 +3424,20 @@ interface CyclicSound {
      */
     middle_sound?: Sound;
 }
+interface DamageEntityTriggerEffectItem extends TriggerEffectItem {
+    apply_damage_to_trees?: boolean;
+    damage: DamageParameters;
+    lower_damage_modifier?: float;
+    lower_distance_threshold?: uint16;
+    type: 'damage';
+    upper_damage_modifier?: float;
+    upper_distance_threshold?: uint16;
+    use_substitute?: boolean;
+    /**
+     * If `true`, no corpse for killed entities will be created.
+     */
+    vaporize?: boolean;
+}
 /**
  * Used to specify what type of damage and how much damage something deals.
  */
@@ -3437,21 +3451,7 @@ interface DamageParameters {
 interface DamageTileTriggerEffectItem extends TriggerEffectItem {
     damage: DamageParameters;
     radius?: float;
-    type: 'damage';
-}
-interface DamageTriggerEffectItem extends TriggerEffectItem {
-    apply_damage_to_trees?: boolean;
-    damage: DamageParameters;
-    lower_damage_modifier?: float;
-    lower_distance_threshold?: uint16;
-    type: 'damage';
-    upper_damage_modifier?: float;
-    upper_distance_threshold?: uint16;
-    use_substitute?: boolean;
-    /**
-     * If `true`, no corpse for killed entities will be created.
-     */
-    vaporize?: boolean;
+    type: 'damage-tile';
 }
 /**
  * @example ```
@@ -4287,7 +4287,7 @@ type EntityPrototypeFlags = (/**
  * Used to automatically detect the proper direction, if possible. Used by base with the pump, train stop, and train signal.
  */
 'filter-directions' | /**
- * When set, entity will be possible to obtain by using {@link LuaGameScript::get_entity_by_unit_number | runtime:LuaGameScript::get_entity_by_unit_number}. It also changes input actions sent by a player to be selecting entity by unit number instead of a position which may help players in latency to select moving entities.
+ * When set, entity will be possible to obtain by using {@link LuaGameScript::get_entity_by_unit_number | runtime:LuaGameScript::get_entity_by_unit_number}.
  */
 'get-by-unit-number' | /**
  * This is used to specify that the entity breathes air, and so is affected by poison (currently {@link poison capsules | https://wiki.factorio.com/Poison_capsule} are the only source).
@@ -4582,6 +4582,10 @@ interface FluidBox {
      * Must be greater than 0.
      */
     volume: FluidAmount;
+    /**
+     * A fraction of the volume that will be "reserved" and cannot be removed by flow operations. This does nothing if the fluidbox is part of a fluid segment.
+     */
+    volume_reservation_fraction?: float;
 }
 type FluidBoxLinkedConnectionID = uint32;
 interface FluidBoxSecondaryDrawOrders {
@@ -5951,19 +5955,26 @@ interface MainSound {
      * Can't be used when `match_progress_to_activity` is `true`.
      */
     fade_out_ticks?: uint32;
-    match_progress_to_activity?: boolean;
-    match_speed_to_activity?: boolean;
-    match_volume_to_activity?: boolean;
+    /**
+     * Unused when {@link WorkingSound::persistent | prototype:WorkingSound::persistent} is `true`.
+     */
+    match_progress_to_activity?: bool;
+    match_speed_to_activity?: bool;
+    match_volume_to_activity?: bool;
     /**
      * Array of {@link WorkingVisualisation::name | prototype:WorkingVisualisation::name}s, individual names cannot be empty.
      *
      * The `sound` is played when at least one of the specified working visualisations is drawn.
+     *
+     * Unused when {@link WorkingSound::persistent | prototype:WorkingSound::persistent} is `true`.
      */
     play_for_working_visualisations?: string[];
     /**
      * Modifies how often the sound is played.
      *
      * Silently clamped to the [0.0, 1.0] range.
+     *
+     * Unused when {@link WorkingSound::persistent | prototype:WorkingSound::persistent} is `true`.
      * @example ```
     probability = 1 / (3 * 60) -- average pause between the sound is 3 seconds
     ```
@@ -6196,7 +6207,7 @@ interface MapLocation {
     /**
      * Direction this connection point will be facing to.
      */
-    direction: MapPosition;
+    direction: Direction;
     /**
      * Position relative to entity's position where the connection point will be located at.
      */
@@ -7685,7 +7696,7 @@ interface ProcessionSet {
  * A wrapper for a collection of {@link ProcessionLayers | prototype:ProcessionLayer}.
  */
 interface ProcessionTimeline {
-    audio_events: ProcessionAudioEvent[];
+    audio_events?: ProcessionAudioEvent[];
     /**
      * During procession, the pod will at some point start being drawn above the rest of the game:
      *
@@ -8033,7 +8044,7 @@ interface RailPictureSet {
      *
      * Only loaded if `front_rail_endings` or `back_rail_endings` are not defined.
      */
-    rail_endings: Sprite16Way;
+    rail_endings?: Sprite16Way;
     render_layers: RailRenderLayers;
     secondary_render_layers?: RailRenderLayers;
     /**
@@ -11590,7 +11601,7 @@ interface TriggerDeliveryItem {
 type TriggerEffect = (/**
  * Loaded when the `type` is `"damage"`.
  */
-DamageTriggerEffectItem | /**
+DamageEntityTriggerEffectItem | /**
  * Loaded when the `type` is `"damage-tile"`.
  */
 DamageTileTriggerEffectItem | /**
@@ -11659,7 +11670,7 @@ CameraEffectTriggerEffectItem | /**
 ActivateImpactTriggerEffectItem) | (/**
  * Loaded when the `type` is `"damage"`.
  */
-DamageTriggerEffectItem | /**
+DamageEntityTriggerEffectItem | /**
  * Loaded when the `type` is `"damage-tile"`.
  */
 DamageTileTriggerEffectItem | /**
@@ -12591,18 +12602,26 @@ working_sound =
 type WorkingSound = {
     /**
      * Might not work with all entities that use working_sound.
+     *
+     * Unused when `persistent` is `true`.
      */
     activate_sound?: Sound;
     /**
      * Might not work with all entities that use working_sound.
+     *
+     * Unused when `persistent` is `true`.
      */
     deactivate_sound?: Sound;
     /**
-     * If `true`, `max_sounds_per_prototype` is ignored. 'extra sound' refers to `idle_sound`, `activate_sound` or `deactivate_sound`.
+     * If `true`, entities playing their extra sound don't count towards `max_sounds_per_prototype` limit. 'extra sound' refers to `idle_sound`, `activate_sound` or `deactivate_sound`.
+     *
+     * Unused when `persistent` is `true`.
      */
-    extra_sounds_ignore_limit?: boolean;
+    extra_sounds_ignore_limit?: bool;
     /**
      * The sound to be played when the entity is idle. Might not work with all entities that use working_sound.
+     *
+     * Unused when `persistent` is `true`.
      */
     idle_sound?: Sound;
     /**
@@ -12615,14 +12634,19 @@ type WorkingSound = {
      * Inactive entities without an `idle_sound` don't count towards this limit.
      *
      * Entities with their working sound fading out don't count towards this limit.
+     *
+     * Unused when `persistent` is `true`.
      */
     max_sounds_per_prototype?: uint8;
     /**
-     * When `true`, working sounds for all entities of the same prototype are combined into one and some (most) properties of this are ignored or unused.
+     * When `true`, working sounds for all entities of the same prototype are combined into one.
+     */
+    persistent?: bool;
+    /**
+     * Unused when `persistent` is `true`.
      */
-    persistent?: boolean;
     sound_accents?: SoundAccent | SoundAccent[];
-    use_doppler_shift?: boolean;
+    use_doppler_shift?: bool;
 } | Sound;
 /**
  * Used by crafting machines to display different graphics when the machine is running.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "factorio-types",
-  "version": "1.2.28",
+  "version": "1.2.30",
   "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.41",
+  "factorioVersion": "2.0.43",
   "dependencies": {
     "lua-types": "^2.13.1"
   },