factorio-types 1.2.55 → 1.2.57

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.73
+// Factorio version 2.0.76
 // API version 6
 
 declare namespace runtime {
@@ -5362,7 +5362,7 @@ interface LuaControl {
     /**
      * The current crafting queue items.
      */
-    readonly crafting_queue: CraftingQueueItem[];
+    readonly crafting_queue?: CraftingQueueItem[];
     /**
      * The crafting queue progress in the range `[0-1]`. `0` when no recipe is being crafted.
      */
@@ -7640,10 +7640,13 @@ interface LuaEntity extends LuaControl {
     render_player_write?: PlayerIdentification;
     /**
      * The forces that this `simple-entity-with-owner` or `simple-entity-with-force` is visible to. `nil` or an empty array when this entity is rendered for all forces.
-     *
-     * Reading will always give an array of {@link LuaForce | runtime:LuaForce}
      */
-    render_to_forces?: ForceSet;
+    readonly render_to_forces?: LuaForce[];
+    /**
+     * The forces that this `simple-entity-with-owner` or `simple-entity-with-force` is visible to. `nil` or an empty array when this entity is rendered for all forces.
+     * @customName render_to_forces
+     */
+    render_to_forces_write?: ForceSet;
     /**
      * Whether this requester chest is set to also request from buffer chests.
      *
@@ -8128,7 +8131,7 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
     readonly attractor_hit_effect?: TriggerItem[];
     readonly auto_setup_collision_box: boolean;
     /**
-     * The amount of ammo that inserters automatically insert into this ammo-turret or artillery-turret.
+     * The amount of ammo that inserters automatically insert into this ammo turret, artillery turret or artillery wagon.
      */
     readonly automated_ammo_count?: uint32;
     /**
@@ -8525,6 +8528,10 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
      * The drop position for this inserter.
      */
     readonly inserter_drop_position?: Vector;
+    /**
+     * The max belt stack size for this inserter.
+     */
+    readonly inserter_max_belt_stack_size?: uint8;
     /**
      * The pickup position for this inserter.
      */
@@ -8890,6 +8897,7 @@ interface LuaEntityPrototype extends LuaPrototypeBase {
      * The revenge attack parameters for this entity, if any. These attack parameters are used in addition to {@link LuaEntityPrototype::attack_parameters | runtime:LuaEntityPrototype::attack_parameters} if the entity is attacking a target that has previously dealt damage to the entity.
      */
     readonly revenge_attack_parameters?: AttackParameters;
+    readonly reversing_power_modifier?: double;
     readonly rewire_neighbours_when_destroying: boolean;
     /**
      * The rising speed for this rocket silo rocket prototype.
@@ -16522,9 +16530,14 @@ interface LuaRenderObject {
      */
     font: string;
     /**
-     * Forces for which this object is rendered or `nil` if visible to all forces. Writing nil or empty array will make object to be visible to all forces.
+     * Forces for which this object is rendered or `nil` if visible to all forces. Writing `nil` or empty array will make this object visible to all forces.
+     */
+    readonly forces?: LuaForce[];
+    /**
+     * Forces for which this object is rendered or `nil` if visible to all forces. Writing `nil` or empty array will make this object visible to all forces.
+     * @customName forces
      */
-    forces?: LuaForce[] | ForceSet;
+    forces_write?: ForceSet;
     /**
      * Where this line is drawn from.
      */
@@ -16586,7 +16599,7 @@ interface LuaRenderObject {
      */
     oriented_offset: Vector;
     /**
-     * Players for which this object is visible or `nil` if visible to all players.
+     * Players for which this object is visible or `nil` if visible to all players. Writing `nil` or empty array will make this object visible to all players.
      */
     players?: LuaPlayer[] | PlayerIdentification[];
     /**
@@ -17988,6 +18001,9 @@ interface LuaStorageTankControlBehavior extends LuaControlBehavior {
 interface LuaStyle {
     badge_font: string;
     badge_horizontal_spacing: int32;
+    /**
+     * The thickness of the bar, not the horizontal width.
+     */
     bar_width: uint32;
     /**
      * Space between the table cell contents bottom and border.
@@ -18169,7 +18185,7 @@ interface LuaStyle {
     width: int32;
 }
 /**
- * A "domain" of the world. Surfaces can only be created and deleted through the API. Surfaces are uniquely identified by their name. Every game contains at least the surface "nauvis".
+ * A "domain" of the world, such as a planet or space platform. Surfaces are uniquely identified by their name. Every game contains at least the surface "nauvis".
  */
 interface LuaSurface {
     /**

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.73
+// Factorio version 2.0.76
 // API version 6
 
 declare namespace runtime {
@@ -580,6 +580,7 @@ interface BlueprintEntityArtilleryWagon extends BaseBlueprintEntity {
     'enable_logistics_while_moving': boolean;
     'grid'?: BlueprintEquipment[];
     'orientation': RealOrientation;
+    'stock_connections'?: BlueprintRollingStockConnection;
 }
 /**
  *
@@ -633,6 +634,7 @@ interface BlueprintEntityCargoWagon extends BaseBlueprintEntity {
     'grid'?: BlueprintEquipment[];
     'inventory': BlueprintInventoryWithFilters;
     'orientation': RealOrientation;
+    'stock_connections'?: BlueprintRollingStockConnection;
 }
 /**
  *
@@ -719,6 +721,7 @@ interface BlueprintEntityFluidWagon extends BaseBlueprintEntity {
     'enable_logistics_while_moving': boolean;
     'grid'?: BlueprintEquipment[];
     'orientation': RealOrientation;
+    'stock_connections'?: BlueprintRollingStockConnection;
 }
 /**
  *
@@ -747,6 +750,7 @@ interface BlueprintEntityInfinityCargoWagon extends BaseBlueprintEntity {
     'infinity_settings': BlueprintInfinityInventorySettings;
     'inventory': BlueprintInventoryWithFilters;
     'orientation': RealOrientation;
+    'stock_connections'?: BlueprintRollingStockConnection;
 }
 /**
  *
@@ -867,6 +871,7 @@ interface BlueprintEntityLocomotive extends BaseBlueprintEntity {
     'grid'?: BlueprintEquipment[];
     'orientation': RealOrientation;
     'schedule'?: BlueprintSchedule;
+    'stock_connections'?: BlueprintRollingStockConnection;
 }
 /**
  *
@@ -1175,6 +1180,20 @@ interface BlueprintQualityID {
      */
     name?: string;
 }
+interface BlueprintRollingStockConnection {
+    /**
+     * The entity_number of 'this' entity in the blueprint.
+     */
+    stock: uint32;
+    /**
+     * The entity_number of the front stock connection.
+     */
+    front?: uint32;
+    /**
+     * The entity_number of the back stock connection.
+     */
+    back?: uint32;
+}
 interface BlueprintSchedule {
     records?: BlueprintScheduleRecord[];
     group?: string;
@@ -4098,7 +4117,9 @@ interface LoaderBlueprintControlBehavior {
     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.
+ * Localised strings are a way to support translation of in-game text. They offer a language-independent code representation of the text that should be shown to players.
+ *
+ * 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.
  *
  * The key identifies the string template. For example, `"gui-alert-tooltip.attack"` (for the template `"__1__ objects are being damaged"`; see the file `data/core/locale/en.cfg`).
  *
@@ -7957,8 +7978,8 @@ interface ResearchTriggerCraftFluid extends BaseResearchTrigger {
  */
 interface ResearchTriggerCraftItem extends BaseResearchTrigger {
     'type': 'craft-item';
-    'item': string;
-    'item_quality'?: string;
+    'count': ItemCountType;
+    'item': ItemIDFilter;
 }
 /**
  *
@@ -7990,7 +8011,7 @@ interface Resistance {
      */
     decrease: float;
     /**
-     * Percentual damage decrease.
+     * Percentual damage decrease. Expected range is from 0 to 1, e.g. 0.5 is 50%.
      */
     percent: float;
 }

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.73
+// Factorio version 2.0.76
 // 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.73
+// Factorio version 2.0.76
 // 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.73
+// Factorio version 2.0.76
 // 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.73
+// Factorio version 2.0.76
 // 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.73
+// Factorio version 2.0.76
 // API version 6
 
 declare namespace prototype {
@@ -327,11 +327,14 @@ interface AmmoItemPrototype extends ItemPrototype {
  */
 interface AmmoTurretPrototype extends TurretPrototype {
     /**
-     * Shift of the "alt-mode icon" relative to the turret's position.
+     * The amount of ammo that inserters automatically insert into this turret.
      */
     automated_ammo_count: ItemCountType;
     energy_per_shot?: Energy;
     energy_source?: ElectricEnergySource;
+    /**
+     * Size of the ammo inventory.
+     */
     inventory_size: ItemStackIndex;
     prepare_with_no_ammo?: boolean;
 }
@@ -742,7 +745,7 @@ interface ArtilleryTurretPrototype extends EntityWithOwnerPrototype {
      */
     ammo_stack_limit: ItemCountType;
     /**
-     * Must be > 0.
+     * Must be > 0. The amount of ammo that inserters automatically insert into this artillery turret.
      */
     automated_ammo_count?: ItemCountType;
     base_picture?: Animation4Way;
@@ -802,7 +805,7 @@ interface ArtilleryWagonPrototype extends RollingStockPrototype {
      */
     ammo_stack_limit: ItemCountType;
     /**
-     * Must be > 0.
+     * Must be > 0. The amount of ammo that inserters automatically insert into this artillery wagon.
      */
     automated_ammo_count?: ItemCountType;
     /**
@@ -1513,7 +1516,7 @@ interface CharacterCorpsePrototype extends EntityPrototype {
      */
     armor_picture_mapping?: Record<ItemID, int32>;
     /**
-     * Mandatory if `pictures` is not defined.
+     * Only loaded, and mandatory if `pictures` is not defined.
      */
     picture?: Animation;
     /**
@@ -2955,7 +2958,7 @@ interface ElectricPolePrototype extends EntityWithOwnerPrototype {
      * Max value is 64.
      */
     supply_area_distance: double;
-    track_coverage_during_build_by_moving?: boolean;
+    track_coverage_during_drag_building?: boolean;
 }
 /**
  * A turret that uses electricity as ammunition.
@@ -3352,7 +3355,7 @@ interface EntityPrototype extends Prototype {
     shooting_cursor_size?: double;
     stateless_visualisation?: StatelessVisualisation | StatelessVisualisation[];
     /**
-     * Used to set the area of the entity that can have stickers on it, currently only used for units to specify the area where the green slow down stickers can appear.
+     * Used to specify the area where the {@link sticker | prototype:StickerPrototype} animation can appear for entities that can have stickers on them.
      * @example ```
     sticker_box = {{-0.5, -0.5}, {0.5, 0.5}}
     ```
@@ -7353,7 +7356,7 @@ interface ResourceEntityPrototype extends EntityPrototype {
      */
     infinite?: boolean;
     /**
-     * Every time an infinite-type resource "ticks" lower it's lowered by that amount.
+     * Every time an infinite-type resource is decreased by mining, its current resource amount is lowered by this number.
      */
     infinite_depletion_amount?: uint32;
     /**
@@ -9349,9 +9352,21 @@ interface TechnologyPrototype extends Prototype {
      */
     visible_when_disabled?: boolean;
 }
+/**
+ * A container that can automatically destroy itself when it is emptied or after it has existed for a certain time.
+ */
 interface TemporaryContainerPrototype extends ContainerPrototype {
+    /**
+     * If the container has existed for this long, {@link an alert | prototype:UtilitySprites::unclaimed_cargo_icon} is show on it. In ticks, 0 for no alert.
+     */
     alert_after_time?: uint32;
+    /**
+     * Whether the container is automatically destroyed when it is emptied.
+     */
     destroy_on_empty?: boolean;
+    /**
+     * Duration after which the container and its contents are automatically destroyed. In ticks, 0 for infinite.
+     */
     time_to_live?: uint32;
 }
 /**
@@ -9494,9 +9509,12 @@ interface TilePrototype extends Prototype {
     is_foundation?: boolean;
     landing_steps_sound?: Sound;
     /**
-     * Specifies transition drawing priority.
+     * Specifies transition drawing priority. This represents the positive offset from this tile's `layer_group`. Internally, the final layer is computed as `layer_group + layer` (a {@link uint16 | prototype:uint16}), wrapping back to `"zero"` after the `"top"` layer.
      */
     layer: uint8;
+    /**
+     * The base group of render layers this tile belongs to. It can be moved up inside this group using the `layer` property. See the {@link TileRenderLayer | prototype:TileRenderLayer} page to see the sizes of all layer groups.
+     */
     layer_group?: TileRenderLayer;
     /**
      * For surfaces that use {@link fog effect | prototype:SurfaceRenderParameters::fog} of type `gleba`, this property determines whether given tile should contribute to fog intensity on a chunk or not.
@@ -10535,6 +10553,7 @@ interface UtilitySounds extends PrototypeBase {
     game_lost: Sound;
     game_won: Sound;
     gui_click: Sound;
+    gui_switch: Sound;
     inventory_click: Sound;
     inventory_move: Sound;
     item_deleted: Sound;

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.73
+// Factorio version 2.0.76
 // API version 6
 
 declare namespace prototype {
@@ -65,6 +65,9 @@ interface ActivityBarStyleSpecification extends BaseStyleSpecification {
     bar?: ElementImageSet;
     bar_background?: ElementImageSet;
     bar_size_ratio?: float;
+    /**
+     * The thickness of the bar, not the horizontal size.
+     */
     bar_width?: uint32;
     color?: Color;
     speed?: float;
@@ -6011,7 +6014,7 @@ interface LoaderStructure {
  *
  * There are two special flags for the localised string, indicated by the key being a particular string. First, if the key is the empty string (`""`), then all parameters will be concatenated (after processing, if any are localised strings themselves). Second, if the key is a question mark (`"?"`), then the first valid parameter will be used. A parameter can be invalid if its name doesn't match any string template. If no parameters are valid, the last one is returned. This is useful to implement a fallback for missing locale templates.
  *
- * Furthermore, when an API function expects a localised string, it will also accept a regular string (i.e. not a table) which will not be translated, as well as a number or boolean, which will be converted to their textual representation.
+ * Furthermore, when an API function expects a localised string, it will also accept a regular string (i.e. not a table) which will not be translated. In the settings and prototype stages, this string cannot be longer than 200 characters.
  *
  * See {@link Tutorial:Localisation | https://wiki.factorio.com/Tutorial:Localisation} for more information.
  * @example ```
@@ -7899,6 +7902,9 @@ interface ProgrammableSpeakerNote {
 interface ProgressBarStyleSpecification extends BaseStyleSpecification {
     bar?: ElementImageSet;
     bar_background?: ElementImageSet;
+    /**
+     * The thickness of the bar, not the horizontal size.
+     */
     bar_width?: uint32;
     color?: Color;
     embed_text_in_bar?: boolean;
@@ -8413,7 +8419,7 @@ interface Resistance {
      */
     decrease?: float;
     /**
-     * The {@link percentage resistance | https://wiki.factorio.com/Damage#Percentage_resistance} to the given damage type. (Higher is better)
+     * The {@link percentage resistance | https://wiki.factorio.com/Damage#Percentage_resistance} to the given damage type. Expected range is from 0 to 100, e.g. 50 is 50%. (Higher is better.)
      */
     percent?: float;
     type: DamageTypeID;
@@ -9029,6 +9035,9 @@ interface SimulationDefinition {
      * If this is true, the map of the simulation is set to be a lab-tile checkerboard in the area of `{{-20, -15},{20, 15}}` when the scenario is first initialized (before init/init_file run).
      */
     checkboard?: boolean;
+    /**
+     * Only applied to the simulation if a test player is created through {@link LuaSimulation::create_test_player | runtime:LuaSimulation::create_test_player}.
+     */
     game_view_settings?: GameViewSettings;
     /**
      * If `save` is not given and this is true, a map gets generated by the game for use in the simulation.
@@ -10027,7 +10036,7 @@ interface SpriteSource {
     /**
      * Mandatory if `size` is not defined.
      *
-     * Height of the picture in pixels, from 0-4096.
+     * Height of the sprite in pixels, from 0-4096.
      */
     height?: SpriteSizeType;
     /**
@@ -10055,7 +10064,7 @@ interface SpriteSource {
     /**
      * Mandatory if `size` is not defined.
      *
-     * Width of the picture in pixels, from 0-4096.
+     * Width of the sprite in pixels, from 0-4096.
      */
     width?: SpriteSizeType;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "factorio-types",
-  "version": "1.2.55",
+  "version": "1.2.57",
   "description": "Typescript declarations for the Factorio mod API",
   "main": "index.d.ts",
   "repository": "https://github.com/sguest/factorio-types.git",
@@ -23,11 +23,11 @@
     "src/**/*.d.ts",
     "dist/**/*.d.ts"
   ],
-  "factorioVersion": "2.0.73",
+  "factorioVersion": "2.0.76",
   "dependencies": {
     "lua-types": "^2.13.1"
   },
   "peerDependencies": {
     "typescript-to-lua": "^1.26.0"
   }
-}
+}