factorio-types 1.2.23 → 1.2.25

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.32
+// Factorio version 2.0.37
 // API version 6
 
 declare namespace runtime {
@@ -16,6 +16,10 @@ end)
 ```
  */
 interface CustomInputEvent {
+    /**
+     * Cursor direction.
+     */
+    cursor_direction?: defines.direction;
     /**
      * The mouse cursor display location when the custom input was activated.
      */
@@ -224,6 +228,24 @@ interface on_cancelled_upgrade {
      */
     tick: uint;
 }
+/**
+ * Called after a cargo pod has delivered its cargo.
+ */
+interface on_cargo_pod_delivered_cargo {
+    cargo_pod: LuaEntity;
+    /**
+     * Identifier of the event
+     */
+    name: defines.events;
+    /**
+     * The spawned container if any. Created when destination type is {@link surface | runtime:defines.cargo_destination.surface}.
+     */
+    spawned_container?: LuaEntity;
+    /**
+     * Tick the event was generated.
+     */
+    tick: uint;
+}
 /**
  * Called when a cargo pod departs a surface.
  */
@@ -238,7 +260,29 @@ interface on_cargo_pod_finished_ascending {
      */
     name: defines.events;
     /**
-     * The player that is riding the rocket, if any.
+     * The player that is riding the cargo pod, if any.
+     */
+    player_index?: uint;
+    /**
+     * Tick the event was generated.
+     */
+    tick: uint;
+}
+/**
+ * Called when a cargo pods lands on a surface, either at a station or on the ground.
+ */
+interface on_cargo_pod_finished_descending {
+    cargo_pod: LuaEntity;
+    /**
+     * True for pods spawned on a rocket.
+     */
+    launched_by_rocket: boolean;
+    /**
+     * Identifier of the event
+     */
+    name: defines.events;
+    /**
+     * The player that is riding the cargo pod, if any.
      */
     player_index?: uint;
     /**
@@ -1421,6 +1465,19 @@ interface on_mod_item_opened {
      */
     tick: uint;
 }
+/**
+ * Called when {@link LuaGameScript::is_multiplayer | runtime:LuaGameScript::is_multiplayer} changes to true. May also be raised when it was already true but a game was loaded from a save file and with hosting.
+ */
+interface on_multiplayer_init {
+    /**
+     * Identifier of the event
+     */
+    name: defines.events;
+    /**
+     * Tick the event was generated.
+     */
+    tick: uint;
+}
 /**
  * Called after an object is destroyed which was registered with {@link LuaBootstrap::register_on_object_destroyed | runtime:LuaBootstrap::register_on_object_destroyed} previously.
  *
@@ -2008,6 +2065,10 @@ interface on_player_deconstructed_area {
      * The item quality used to select the area.
      */
     quality: string;
+    /**
+     * The record that was used to select the area.
+     */
+    record?: LuaRecord;
     /**
      * The item stack used to select the area.
      */
@@ -2742,6 +2803,10 @@ interface on_player_setup_blueprint {
      * The item quality used to select the area.
      */
     quality: string;
+    /**
+     * The record that is being reassigned.
+     */
+    record?: LuaRecord;
     /**
      * The item stack used to select the area.
      */
@@ -3840,6 +3905,19 @@ interface on_selected_entity_changed {
      */
     tick: uint;
 }
+/**
+ * Called when {@link LuaGameScript::is_multiplayer | runtime:LuaGameScript::is_multiplayer} changes to false. May also be raised when it was already false but a game was loaded from a save file without hosting.
+ */
+interface on_singleplayer_init {
+    /**
+     * Identifier of the event
+     */
+    name: defines.events;
+    /**
+     * Tick the event was generated.
+     */
+    tick: uint;
+}
 /**
  * Called when a space platform builds 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.32
+// Factorio version 2.0.37
 // 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.32
+// Factorio version 2.0.37
 // API version 6
 
 declare namespace prototype {
@@ -57,7 +57,7 @@ declare namespace prototype {
       }
     },
     idle_sound = {filename = "__base__/sound/accumulator-idle.ogg", volume = 0.35},
-    max_sounds_per_type = 3,
+    max_sounds_per_prototype = 3,
     audible_distance_modifier = 0.5
   },
 
@@ -813,6 +813,12 @@ interface AssemblingMachinePrototype extends CraftingMachinePrototype {
         CircuitConnectorDefinition,
         CircuitConnectorDefinition
     ];
+    circuit_connector_flipped?: [
+        CircuitConnectorDefinition,
+        CircuitConnectorDefinition,
+        CircuitConnectorDefinition,
+        CircuitConnectorDefinition
+    ];
     /**
      * The maximum circuit wire distance for this entity.
      */
@@ -844,7 +850,8 @@ interface AssemblingMachinePrototype extends CraftingMachinePrototype {
      *
      * This only counts item ingredients, not fluid ingredients! This means if ingredient count is 2, and the recipe has 2 item ingredients and 1 fluid ingredient, it can still be crafted in the machine.
      */
-    ingredient_count?: uint8;
+    ingredient_count?: uint16;
+    max_item_product_count?: uint16;
 }
 interface AsteroidChunkPrototype extends Prototype {
     dying_trigger_effect?: TriggerEffect;
@@ -1023,7 +1030,7 @@ interface BeaconPrototype extends EntityWithOwnerPrototype {
     /**
      * The maximum distance that this beacon can supply its neighbors with its module's effects. Max distance is 64.
      */
-    supply_area_distance: double;
+    supply_area_distance: uint32;
 }
 /**
  * Used as a laser beam.
@@ -3209,7 +3216,7 @@ interface EntityPrototype extends Prototype {
     /**
      * May also be defined inside `graphics_set` instead of directly in the entity prototype. This is useful for entities that use a `graphics_set` property to define their graphics, because then all graphics can be defined in one place.
      *
-     * {@link Currently only renders | https://forums.factorio.com/100703} for {@link EntityWithHealthPrototype | prototype:EntityWithHealthPrototype}.
+     * {@link Currently only renders | https://forums.factorio.com/100703} for {@link EntityWithHealthPrototype | prototype:EntityWithHealthPrototype} and {@link CorpsePrototype | prototype:CorpsePrototype}.
      */
     water_reflection?: WaterReflectionDefinition;
     /**
@@ -3322,7 +3329,7 @@ interface EntityWithHealthPrototype extends EntityPrototype {
     {
       {
         type = "fire",
-          percent = 80
+        percent = 80
       },
       {
         type = "explosion",
@@ -3349,6 +3356,10 @@ interface EntityWithOwnerPrototype extends EntityWithHealthPrototype {
      * The default scale is based on the tile distance of the shorter dimension. Where size 3 results into scale 1. The default minimum is 0.5 and maximum 1.0.
      */
     quality_indicator_scale?: double;
+    /**
+     * The shift from the bottom left corner of the selection box.
+     */
+    quality_indicator_shift?: Vector;
 }
 /**
  * This prototype is used for receiving an achievement when the player equips armor.
@@ -3940,10 +3951,30 @@ interface FurnacePrototype extends CraftingMachinePrototype {
      * The locale key is also used with an `_until` suffix for items that cannot be processed until they recipe is unlocked by a technology.
      */
     cant_insert_at_source_message_key?: string;
+    circuit_connector?: [
+        CircuitConnectorDefinition,
+        CircuitConnectorDefinition,
+        CircuitConnectorDefinition,
+        CircuitConnectorDefinition
+    ];
+    circuit_connector_flipped?: [
+        CircuitConnectorDefinition,
+        CircuitConnectorDefinition,
+        CircuitConnectorDefinition,
+        CircuitConnectorDefinition
+    ];
+    /**
+     * The maximum circuit wire distance for this entity.
+     */
+    circuit_wire_max_distance?: double;
     /**
      * The locale key of the tooltip to be shown in the input slot instead of the automatically generated list of items that fit there
      */
     custom_input_slot_tooltip_key?: string;
+    default_recipe_finished_signal?: SignalIDConnector;
+    default_working_signal?: SignalIDConnector;
+    draw_circuit_wires?: bool;
+    draw_copper_wires?: bool;
     /**
      * The number of output slots.
      */
@@ -4171,6 +4202,10 @@ interface GroupAttackAchievementPrototype extends AchievementPrototype {
     ```
      */
     amount?: uint32;
+    /**
+     * The type of attack that triggers this achievement. "autonomous" attacks are triggered in response to pollution or a territory disturbance. "distraction" attacks are in response to taking damage or seeing a nearby enemy. "scripted" attacks are triggered from mods.
+     */
+    attack_type?: 'autonomous' | 'distraction' | 'scripted';
     /**
      * The achievement is only triggered if the attacking group of enemies contains at least one of the entities listed here.
      */
@@ -4594,6 +4629,8 @@ interface ItemPrototype extends Prototype {
     stack_size: ItemCountType;
     /**
      * The default weight is calculated automatically from recipes and falls back to {@link UtilityConstants::default_item_weight | prototype:UtilityConstants::default_item_weight}.
+     *
+     * More information on how item weight is determined can be found on its {@link auxiliary page | runtime:item-weight}.
      */
     weight?: Weight;
 }
@@ -5121,6 +5158,10 @@ interface Loader1x2Prototype extends LoaderPrototype {
  * Continuously loads and unloads machines, as an alternative to inserters.
  */
 interface LoaderPrototype extends TransportBeltConnectablePrototype {
+    /**
+     * Loader belt stack size can be adjusted at runtime. Requires {@link LoaderPrototype::max_belt_stack_size | prototype:LoaderPrototype::max_belt_stack_size} to be > 1.
+     */
+    adjustable_belt_stack_size?: boolean;
     /**
      * Whether this loader can load and unload stationary inventories such as containers and crafting machines.
      */
@@ -6594,14 +6635,16 @@ interface RecipePrototype extends Prototype {
      * Duplicate ingredients, e.g. two entries with the same name, are *not* allowed. In-game, the item ingredients are ordered by {@link ItemGroup::order_in_recipe | prototype:ItemGroup::order_in_recipe}.
      * @example ```
     -- Recipe with items
-    ingredients = {
+    ingredients =
+    {
       {type = "item", name = "iron-stick", amount = 2},
       {type = "item", name = "iron-plate", amount = 3}
     }
     ```
      * @example ```
     -- Recipe with fluids
-    ingredients = {
+    ingredients =
+    {
       {type="fluid", name="water", amount=50},
       {type="fluid", name="crude-oil", amount=100}
     }
@@ -6635,14 +6678,16 @@ interface RecipePrototype extends Prototype {
      *
      * Can be set to an empty table to create a recipe that produces nothing. Duplicate results, e.g. two entries with the same name, are allowed.
      * @example ```
-    results = {
+    results =
+    {
       {type="fluid", name="heavy-oil", amount=3},
       {type="fluid", name="light-oil", amount=3},
       {type="fluid", name="petroleum-gas", amount=4}
     }
     ```
      * @example ```
-    results = {
+    results =
+    {
       {type = "item", name = "iron-nuggets", amount = 9},
       {type = "item", name = "gold-nuggets", amount = 1}
     }
@@ -7262,7 +7307,6 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
      */
     rocket_rising_delay?: uint8;
     rocket_shadow_overlay_sprite?: Sprite;
-    rocket_supply_inventory_size?: ItemStackIndex;
     satellite_animation?: Animation;
     satellite_shadow_animation?: Animation;
     shadow_sprite?: Sprite;
@@ -9655,6 +9699,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;
     icon_shadow_color: Color;
     icon_shadow_inset: float;
     icon_shadow_radius: float;

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.32
+// Factorio version 2.0.37
 // API version 6
 
 declare namespace prototype {
@@ -405,7 +405,8 @@ frame_sequence = { 2, 2, 2, 2, 2, 4, 3, 4, 3 }
  * @example ```
 -- Complex example - animation contains different layers with different frame counts:
 local custom_frame_sequence = { 2, 2, 2, 2, 2, 4, 3, 4, 3 }
-layers = {
+layers =
+{
   {
     -- Animation with custom frame sequence
     frame_count = 4,
@@ -1622,6 +1623,10 @@ interface BaseAttackParameters {
      * Played once at the start of the attack if these are {@link ProjectileAttackParameters | prototype:ProjectileAttackParameters}.
      */
     sound?: LayeredSound;
+    /**
+     * Projectile will be creation position and orientation will be collinear with shooter and target (unless offset projectile center is specified). Used for railgun turrets to avoid unexpected friendly fire incidents.
+     */
+    true_collinear_ejection?: bool;
     /**
      * If this is <= 0, it is set to 1. Arc from 0 to 1, so for example 0.25 is 90°. Used by the {@link flamethrower turret | https://wiki.factorio.com/Flamethrower_turret} in the base game. Arcs greater than 0.5 but less than 1 will be clamped to 0.5 as targeting in arcs larger than half circle is {@link not implemented | https://forums.factorio.com/94654}.
      */
@@ -3341,6 +3346,7 @@ interface CreateTrivialSmokeEffectItem extends TriggerEffectItem {
     max_radius?: float;
     offset_deviation?: BoundingBox;
     offsets?: Vector[];
+    only_when_visible?: float;
     smoke_name: TrivialSmokeID;
     speed?: Vector;
     speed_from_center?: float;
@@ -5180,7 +5186,7 @@ interface HorizontalScrollBarStyleSpecification extends ScrollBarStyleSpecificat
  *
  * - When the final icon is displayed with a shadow (e.g. an item on the ground or on a belt when item shadows are turned on), each icon layer will {@link cast a shadow | https://forums.factorio.com/84888} and the shadow is cast on the layer below it.
  *
- * - The final icon will always be resized and centered in GUI so that all its layers fit the target slot, but won't be resized when displayed on machines in alt-mode. For example: recipe first icon layer is size 128, scale 1, the icon group will be displayed at resolution /4 to fit the 32px GUI boxes, but will be displayed 4 times as large on buildings.
+ * - The final icon will always be resized and centered in GUI so that all its layers (except the {@link `floating` | prototype:IconData::floating} ones) fit the target slot, but won't be resized when displayed on machines in alt-mode. For example: recipe first icon layer is size 128, scale 1, the icon group will be displayed at resolution /4 to fit the 32px GUI boxes, but will be displayed 4 times as large on buildings.
  *
  * - Shift values are based on {@link `expected_icon_size / 2` | prototype:IconData::scale}.
  *
@@ -5196,7 +5202,8 @@ interface HorizontalScrollBarStyleSpecification extends ScrollBarStyleSpecificat
 ```
  * @example ```
 -- Layered icon, with size defined per layer
-icons = {
+icons =
+{
   {
     icon = "__base__/graphics/icons/fluid/barreling/barrel-empty.png",
     icon_size = 32
@@ -5222,9 +5229,13 @@ icons = {
  */
 interface IconData {
     /**
-     * Outline is drawn using signed distance field generated on load.One icon image, will have only one SDF generated. But if the image is used in multiple icon with different scales, outline width won't match the desired width in all the scales but the largest one.
+     * Outline is drawn using signed distance field generated on load. One icon image, will have only one SDF generated. But if the image is used in multiple icon with different scales, outline width won't match the desired width in all the scales but the largest one.
      */
     draw_background?: bool;
+    /**
+     * When `true` the layer is not considered for calculating bounds of the icon, so it can go out of bounds of rectangle into which the icon is drawn in GUI.
+     */
+    floating?: bool;
     /**
      * Path to the icon file.
      */
@@ -5289,7 +5300,8 @@ interface IconSequencePositioning {
 }
 /**
  * @example ```
-data.raw["gui-style"]["default"]["stretchy-sprite"] = {
+data.raw["gui-style"]["default"]["stretchy-sprite"] =
+{
   type = "image_style",
   vertically_stretchable = "on",
   horizontally_stretchable = "on",
@@ -5925,10 +5937,6 @@ interface LowPowerTipTrigger extends CountBasedTipTrigger {
 interface MainSound {
     activity_to_speed_modifiers?: ActivityMatchingModifiers;
     activity_to_volume_modifiers?: ActivityMatchingModifiers;
-    /**
-     * Modifies how far a sound can be heard. Can only be 1 or lower, has to be a positive number.
-     */
-    audible_distance_modifier?: double;
     /**
      * Can't be used when `match_progress_to_activity` is `true`.
      */
@@ -5940,14 +5948,24 @@ interface MainSound {
     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.
+     */
     play_for_working_visualisations?: string[];
     /**
      * Modifies how often the sound is played.
+     *
+     * Silently clamped to the [0.0, 1.0] range.
      * @example ```
     probability = 1 / (3 * 60) -- average pause between the sound is 3 seconds
     ```
      */
     probability?: double;
+    /**
+     * Cannot be empty.
+     */
     sound?: Sound;
     /**
      * Only used if {@link WorkingSound::persistent | prototype:WorkingSound::persistent} is `true`.
@@ -6292,7 +6310,8 @@ interface MaximumFollowingRobotsCountModifier extends SimpleModifier {
 minable = { mining_time = 0.55, result = "wood", count = 4, mining_particle = "wooden-particle" }
 ```
  * @example ```
-minable = {
+minable =
+{
   mining_time = 1,
   results =
   {
@@ -7207,10 +7226,6 @@ type PlayFor = /**
  */
 'everything';
 interface PlaySoundTriggerEffectItem extends TriggerEffectItem {
-    /**
-     * Negative values are silently clamped to 0.
-     */
-    audible_distance_modifier?: float;
     /**
      * Negative values are silently clamped to 0.
      */
@@ -7222,10 +7237,6 @@ interface PlaySoundTriggerEffectItem extends TriggerEffectItem {
     play_on_target_position?: bool;
     sound: Sound;
     type: 'play-sound';
-    /**
-     * Negative values are silently clamped to 0.
-     */
-    volume_modifier?: float;
 }
 interface PlayerColorData {
     chat_color: Color;
@@ -7241,6 +7252,10 @@ interface PlumesSpecification {
     max_y_offset?: float;
     min_probability?: float;
     min_y_offset?: float;
+    /**
+     * If given, the plumes will only render if this area is on screen (relative to the thruster)
+     */
+    render_box?: BoundingBox;
     /**
      * Array may not be empty and may at most have 255 elements.
      *
@@ -7723,11 +7738,19 @@ interface ProgrammableSpeakerInstrument {
     notes: ProgrammableSpeakerNote[];
 }
 interface ProgrammableSpeakerNote {
+    /**
+     * Cannot contain aggregations.
+     *
+     * One of `sound` or `cyclic_sound` must be defined. Both cannot be defined together.
+     */
+    cyclic_sound?: CyclicSound;
     name: string;
     /**
      * Cannot contain aggregation.
+     *
+     * One of `sound` or `cyclic_sound` must be defined. Both cannot be defined together.
      */
-    sound: Sound;
+    sound?: Sound;
 }
 interface ProgressBarStyleSpecification extends BaseStyleSpecification {
     bar?: ElementImageSet;
@@ -7841,40 +7864,45 @@ interface PuddleTileEffectParameters {
  * @example ```
 load_animations =
 {
-west = {
-  [1] = {
-    standup_base = {
-      filename = "__base__/graphics/entity/pump/connector/V-R-135-load-standup-base.png",
-      width = 110,
-      height = 126,
-      scale = 0.5,
-      line_length = 1,
-      frame_count = 20,
-      shift = util.by_pixel(-23.5, -13.5)
+  west =
+  {
+    [1] =
+    {
+      standup_base =
+      {
+        filename = "__base__/graphics/entity/pump/connector/V-R-135-load-standup-base.png",
+        width = 110,
+        height = 126,
+        scale = 0.5,
+        line_length = 1,
+        frame_count = 20,
+        shift = util.by_pixel(-23.5, -13.5)
+      },
+      standup_shadow =
+      {
+        filename = "__base__/graphics/entity/pump/connector/V-R-1-load-standup-base-shadow.png",
+        width = 157,
+        height = 136,
+        scale = 0.5,
+        line_length = 1,
+        frame_count = 20,
+        shift = util.by_pixel(-8.75, 8.5)
+      },
     },
-    standup_shadow = {
-      filename = "__base__/graphics/entity/pump/connector/V-R-1-load-standup-base-shadow.png",
-      width = 157,
-      height = 136,
-      scale = 0.5,
-      line_length = 1,
-      frame_count = 20,
-      shift = util.by_pixel(-8.75, 8.5)
+    [2] =
+    {
+      standup_base = { ... },
+      standup_shadow = { ... },
+      connector_shadow = { ... },
     },
+    [3] = { ... },
+    [4] = { ... },
+    [5] = { ... },
+    [6] = { ... },
   },
-  [2] = {
-    standup_base = { ... },
-    standup_shadow = { ... },
-    connector_shadow = { ... },
-  },
-  [3] = { ... },
-  [4] = { ... },
-  [5] = { ... },
-  [6] = { ... },
-},
-north = { ... },
-east = { ... },
-south = { ... },
+  north = { ... },
+  east = { ... },
+  south = { ... },
 }
 ```
  */
@@ -9076,7 +9104,7 @@ type Sound = {
     aggregation?: AggregationSpecification;
     allow_random_repeat?: bool;
     /**
-     * Modifies how far a sound can be heard. Must be between `0` and `1` inclusive.
+     * Modifies how far a sound can be heard. Cannot be less than zero.
      */
     audible_distance_modifier?: double;
     category?: SoundType;
@@ -9145,9 +9173,13 @@ type Sound = {
     volume?: float;
 } | SoundDefinition[];
 interface SoundAccent {
-    audible_distance_modifier?: float;
     frame?: uint16;
-    play_for_working_visualisations?: string[];
+    /**
+     * Play the `sound` for a working visualisation of a given {@link WorkingVisualisation::name | prototype:WorkingVisualisation::name}.
+     *
+     * The name cannot be empty.
+     */
+    play_for_working_visualisation?: string;
     sound?: Sound;
 }
 type SoundDefinition = {
@@ -12532,18 +12564,16 @@ interface WorkerRobotStorageModifier extends SimpleModifier {
 -- refinery
 working_sound =
 {
-  sound = { filename = "__base__/sound/oil-refinery.ogg" },
-  idle_sound = { filename = "__base__/sound/idle1.ogg", volume = 0.6 },
-  apparent_volume = 2.5,
+  sound = {filename = "__base__/sound/oil-refinery.ogg"},
+  idle_sound = {filename = "__base__/sound/idle1.ogg", volume = 0.6},
 }
 ```
  * @example ```
 -- roboport
 working_sound =
 {
-  sound = { filename = "__base__/sound/roboport-working.ogg", volume = 0.6 },
-  max_sounds_per_type = 3,
-  audible_distance_modifier = 0.5,
+  sound = {filename = "__base__/sound/roboport-working.ogg", volume = 0.6, audible_distance_modifier = 0.5},
+  max_sounds_per_prototype = 3,
   probability = 1 / (5 * 60) -- average pause between the sound is 5 seconds
 }
 ```
@@ -12553,15 +12583,13 @@ type WorkingSound = {
      * Might not work with all entities that use working_sound.
      */
     activate_sound?: Sound;
-    apparent_volume?: float;
-    /**
-     * Modifies how far a sound can be heard. Can only be 1 or lower, has to be a positive number.
-     */
-    audible_distance_modifier?: double;
     /**
      * Might not work with all entities that use working_sound.
      */
     deactivate_sound?: Sound;
+    /**
+     * If `true`, `max_sounds_per_prototype` is ignored. 'extra sound' refers to `idle_sound`, `activate_sound` or `deactivate_sound`.
+     */
     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.
@@ -12571,7 +12599,17 @@ type WorkingSound = {
      * If this property is defined, all properties inherited from MainSound (and not overridden here) are ignored.
      */
     main_sounds?: MainSound | MainSound[];
-    max_sounds_per_type?: uint8;
+    /**
+     * Sets a maximum limit on how many entities of the same prototype will play their working sound.
+     *
+     * 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.
+     */
+    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.
+     */
     persistent?: bool;
     sound_accents?: SoundAccent | SoundAccent[];
     use_doppler_shift?: bool;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "factorio-types",
-  "version": "1.2.23",
+  "version": "1.2.25",
   "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.32",
+  "factorioVersion": "2.0.37",
   "dependencies": {
     "lua-types": "^2.13.1"
   },