typed-factorio 1.12.0 → 1.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typed-factorio",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "description": "Featureful typescript definitions for the the Factorio modding lua api.",
   "keywords": [
     "factorio",
@@ -29,33 +29,34 @@
     "next-factorio-version": "yarn run download-latest-runtime-api && yarn run clean && yarn run check && yarn run new-version-changelog && npm version minor"
   },
   "peerDependencies": {
-    "lua-types": "^2.13.0",
+    "lua-types": "^2.13.1",
     "typescript-to-lua": "^1.6.1"
   },
   "devDependencies": {
-    "@types/jest": "^29.2.2",
-    "@types/node": "^18.11.9",
-    "@types/prettier": "^2.7.1",
-    "@typescript-eslint/eslint-plugin": "^5.42.0",
-    "@typescript-eslint/parser": "^5.42.0",
-    "chalk": "^5.1.2",
-    "eslint": "~8.26.0",
-    "eslint-config-prettier": "^8.5.0",
+    "@types/jest": "^29.4.0",
+    "@types/node": "^18.14.6",
+    "@types/prettier": "^2.7.2",
+    "@typescript-eslint/eslint-plugin": "^5.54.0",
+    "@typescript-eslint/parser": "^5.54.0",
+    "array.prototype.flatmap": "^1.3.1",
+    "chalk": "^5.2.0",
+    "eslint": "~8.35.0",
+    "eslint-config-prettier": "^8.6.0",
     "eslint-config-standard": "^17.0.0",
-    "eslint-import-resolver-typescript": "^3.5.2",
-    "eslint-plugin-import": "^2.26.0",
-    "eslint-plugin-n": "^15.4.0",
+    "eslint-import-resolver-typescript": "^3.5.3",
+    "eslint-plugin-import": "^2.27.5",
+    "eslint-plugin-n": "^15.6.1",
     "eslint-plugin-node": "^11.1.0",
     "eslint-plugin-prettier": "^4.2.1",
     "eslint-plugin-promise": "^6.1.1",
-    "jest": "^29.2.2",
-    "lua-types": "^2.13.0",
-    "prettier": "^2.7.1",
+    "jest": "^29.4.3",
+    "lua-types": "^2.13.1",
+    "prettier": "^2.8.4",
     "rimraf": "^3.0.2",
-    "ts-jest": "^29.0.3",
+    "ts-jest": "^29.0.5",
     "ts-node": "^10.9.1",
-    "typescript": "~4.8.4",
-    "typescript-to-lua": "^1.10.1"
+    "typescript": "~4.9.5",
+    "typescript-to-lua": "^1.13.2"
   },
   "packageManager": "yarn@3.2.3"
 }

package/runtime/generated/classes.d.ts

@@ -239,7 +239,7 @@ interface LuaBootstrap {
    */
   register_metatable(name: string, metatable: table): void
   /**
-   * Register a function to be run when mod configuration changes. This is called when the major game version or any mod version changed, when any mod was added or removed, when a startup setting has changed, or when any prototypes have been added or removed. It allows the mod to make any changes it deems appropriate to both the data structures in its {@linkplain https://lua-api.factorio.com/latest/Global.html global} table or to the game state through {@link LuaGameScript}.
+   * Register a function to be run when mod configuration changes. This is called when the game version or any mod version changed, when any mod was added or removed, when a startup setting has changed, when any prototypes have been added or removed, or when a migration was applied. It allows the mod to make any changes it deems appropriate to both the data structures in its {@linkplain https://lua-api.factorio.com/latest/Global.html global} table or to the game state through {@link LuaGameScript}.
    * @param handler The handler for this event. Passing `nil` will unregister it.
    * @remarks For more context, refer to the {@linkplain https://lua-api.factorio.com/latest/Data-Lifecycle.html Data Lifecycle} page.
    * @see {@link https://lua-api.factorio.com/latest/LuaBootstrap.html#LuaBootstrap.on_configuration_changed Online documentation}
@@ -335,6 +335,11 @@ interface LuaBootstrap {
    * @see {@link https://lua-api.factorio.com/latest/LuaBootstrap.html#LuaBootstrap.get_event_filter Online documentation}
    */
   get_event_filter<E extends EventId<any, table>>(event: E): E["_filter"][] | nil
+  /**
+   * Gets the prototype history for the given type and name.
+   * @see {@link https://lua-api.factorio.com/latest/LuaBootstrap.html#LuaBootstrap.get_prototype_history Online documentation}
+   */
+  get_prototype_history(type: string, name: string): PrototypeHistory
   /**
    * Raise an event. Only events generated with {@link LuaBootstrap#generate_event_name LuaBootstrap::generate_event_name} and the following can be raised:
    *
@@ -413,6 +418,10 @@ interface LuaBootstrap {
      * Whether the transfer was from player to entity. If `false`, the transfer was from entity to player.
      */
     readonly from_player: boolean
+    /**
+     * Whether the transfer was a split action (half stack).
+     */
+    readonly is_split: boolean
   }): void
   /**
    * **Raised events:**
@@ -485,6 +494,25 @@ interface LuaBootstrap {
      */
     readonly tags?: Tags
   }): void
+  /**
+   * **Raised events:**
+   * - {@link ScriptRaisedTeleportedEvent script_raised_teleported} _instantly_ Raised with the provided arguments.
+   * @see {@link https://lua-api.factorio.com/latest/LuaBootstrap.html#LuaBootstrap.raise_script_teleported Online documentation}
+   */
+  raise_script_teleported(params: {
+    /**
+     * The entity that was teleported.
+     */
+    readonly entity: LuaEntity
+    /**
+     * The entity's surface before the teleportation.
+     */
+    readonly old_surface_index: uint8
+    /**
+     * The entity's position before the teleportation.
+     */
+    readonly old_position: MapPosition | MapPositionArray
+  }): void
   /**
    * **Raised events:**
    * - {@link ScriptRaisedSetTilesEvent script_raised_set_tiles} _instantly_ Raised with the provided arguments.
@@ -776,7 +804,7 @@ interface LuaCombinatorControlBehavior extends LuaControlBehavior {
 }
 
 /**
- * Allows for the registration of custom console commands. Similarly to {@link LuaBootstrap#on_event event subscriptions}, these don't persist through a save-and-load cycle.
+ * Allows for the registration of custom console commands through the global object named `commands`. Similarly to {@link LuaBootstrap#on_event event subscriptions}, these don't persist through a save-and-load cycle.
  * @see {@link https://lua-api.factorio.com/latest/LuaCommandProcessor.html Online documentation}
  * @noSelf
  */
@@ -970,6 +998,11 @@ interface LuaControl {
    * @see {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.get_inventory Online documentation}
    */
   get_inventory(inventory: defines.inventory): LuaInventory | nil
+  /**
+   * The maximum inventory index this entity may use.
+   * @see {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.get_max_inventory_index Online documentation}
+   */
+  get_max_inventory_index(): defines.inventory
   /**
    * Gets the main inventory for this character or player if this is a character or player.
    * @returns The inventory or `nil` if this entity is not a character or player.
@@ -1039,10 +1072,12 @@ interface LuaControl {
    *
    * **Raised events:**
    * - {@link OnPlayerChangedPositionEvent on_player_changed_position}? _instantly_ Raised if the teleported entity is a player character.
+   * - {@link ScriptRaisedTeleportedEvent script_raised_teleported}? _instantly_ Raised if the `raise_teleported` flag was set and the entity was successfully teleported.
    * @param position Where to teleport to.
    * @param surface Surface to teleport to. If not given, will teleport to the entity's current surface. Only players, cars, and spidertrons can be teleported cross-surface.
+   * @param raise_teleported If true, {@link defines.events.script_raised_teleported} will be fired on successful entity teleportation.
    * @returns `true` if the entity was successfully teleported.
-   * @remarks Some entities may not be teleported. For instance, transport belts won't allow teleportation and this method will always return `false` when used on any such entity.<br>You can also pass 1 or 2 numbers as the parameters and they will be used as relative teleport coordinates `'teleport(0, 1)'` to move the entity 1 tile positive y. `'teleport(4)'` to move the entity 4 tiles to the positive x.
+   * @remarks Some entities may not be teleported. For instance, transport belts won't allow teleportation and this method will always return `false` when used on any such entity.<br>You can also pass 1 or 2 numbers as the parameters and they will be used as relative teleport coordinates `'teleport(0, 1)'` to move the entity 1 tile positive y. `'teleport(4)'` to move the entity 4 tiles to the positive x.<br>`script_raised_teleported` will not be raised if teleporting a player with no character.
    * @see {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.teleport Online documentation}
    */
   teleport(position: MapPosition | MapPositionArray, surface?: SurfaceIdentification): boolean
@@ -1238,6 +1273,11 @@ interface LuaControl {
    * @see {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.surface Online documentation}
    */
   readonly surface: LuaSurface
+  /**
+   * Unique ID associated with the surface this entity is currently on.
+   * @see {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.surface_index Online documentation}
+   */
+  readonly surface_index: SurfaceIndex
   /**
    * The current position of the entity.
    * @see {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.position Online documentation}
@@ -1254,6 +1294,11 @@ interface LuaControl {
    */
   get force(): LuaForce
   set force(value: ForceIdentification)
+  /**
+   * Unique ID associated with the force of this entity.
+   * @see {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.force_index Online documentation}
+   */
+  readonly force_index: ForceIndex
   /**
    * The currently selected entity. Assigning an entity will select it if is selectable, otherwise the selection is cleared.
    *
@@ -2146,7 +2191,7 @@ interface LuaEntity extends LuaControl {
    * Sets the entity to be deconstructed by construction robots.
    *
    * **Raised events:**
-   * - {@link OnMarkedForDeconstructionEvent on_marked_for_deconstruction}? _instantly_ Raised if the entity way successfully marked for deconstruction.
+   * - {@link OnMarkedForDeconstructionEvent on_marked_for_deconstruction}? _instantly_ Raised if the entity was successfully marked for deconstruction.
    * @param force The force whose robots are supposed to do the deconstruction.
    * @param player The player to set the `last_user` to if any.
    * @returns if the entity was marked for deconstruction.
@@ -2172,7 +2217,7 @@ interface LuaEntity extends LuaControl {
    * Sets the entity to be upgraded by construction robots.
    *
    * **Raised events:**
-   * - {@link OnMarkedForUpgradeEvent on_marked_for_upgrade}? _instantly_ Raised if the entity way successfully marked for upgrade.
+   * - {@link OnMarkedForUpgradeEvent on_marked_for_upgrade}? _instantly_ Raised if the entity was successfully marked for upgrade.
    * @returns Whether the entity was marked for upgrade.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.order_upgrade Online documentation}
    */
@@ -3645,6 +3690,12 @@ interface LuaEntity extends LuaControl {
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.electric_network_statistics Online documentation}
    */
   readonly electric_network_statistics: LuaFlowStatistics
+  /**
+   * Returns the current target pickup count of the inserter.
+   * @remarks This considers the circuit network, manual override and the inserter stack size limit based on technology.
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.inserter_target_pickup_count Online documentation}
+   */
+  readonly inserter_target_pickup_count: uint
   /**
    * Sets the stack size limit on this inserter. If the stack size is > than the force stack size limit the value is ignored.
    * @remarks Set to 0 to reset.
@@ -4184,7 +4235,7 @@ interface BaseEntity extends LuaControl {
    * Sets the entity to be deconstructed by construction robots.
    *
    * **Raised events:**
-   * - {@link OnMarkedForDeconstructionEvent on_marked_for_deconstruction}? _instantly_ Raised if the entity way successfully marked for deconstruction.
+   * - {@link OnMarkedForDeconstructionEvent on_marked_for_deconstruction}? _instantly_ Raised if the entity was successfully marked for deconstruction.
    * @param force The force whose robots are supposed to do the deconstruction.
    * @param player The player to set the `last_user` to if any.
    * @returns if the entity was marked for deconstruction.
@@ -4210,7 +4261,7 @@ interface BaseEntity extends LuaControl {
    * Sets the entity to be upgraded by construction robots.
    *
    * **Raised events:**
-   * - {@link OnMarkedForUpgradeEvent on_marked_for_upgrade}? _instantly_ Raised if the entity way successfully marked for upgrade.
+   * - {@link OnMarkedForUpgradeEvent on_marked_for_upgrade}? _instantly_ Raised if the entity was successfully marked for upgrade.
    * @returns Whether the entity was marked for upgrade.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.order_upgrade Online documentation}
    */
@@ -4979,6 +5030,12 @@ interface BaseEntity extends LuaControl {
    * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.sticked_to Online documentation}
    */
   readonly sticked_to: LuaEntity
+  /**
+   * Returns the current target pickup count of the inserter.
+   * @remarks This considers the circuit network, manual override and the inserter stack size limit based on technology.
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.inserter_target_pickup_count Online documentation}
+   */
+  readonly inserter_target_pickup_count: uint
   /**
    * Sets the stack size limit on this inserter. If the stack size is > than the force stack size limit the value is ignored.
    * @remarks Set to 0 to reset.
@@ -7159,7 +7216,7 @@ interface LuaEntityPrototype {
   readonly fluid?: LuaFluidPrototype
   /**
    * The fluid capacity of this entity or 0 if this entity doesn't support fluids.
-   * @remarks Crafting machines will report 0 due to their fluid capacity being what ever a given recipe needs.
+   * @remarks Crafting machines will report 0 due to their fluid capacity being whatever a given recipe needs.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.fluid_capacity Online documentation}
    */
   readonly fluid_capacity: double
@@ -7686,6 +7743,11 @@ interface LuaEntityPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.alert_icon_shift Online documentation}
    */
   readonly alert_icon_shift: Vector
+  /**
+   * The alert icon scale of this entity prototype.
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.alert_icon_scale Online documentation}
+   */
+  readonly alert_icon_scale: float
   /**
    * The item prototype names that are the inputs of this lab prototype.
    *
@@ -8355,7 +8417,7 @@ interface BaseEntityPrototype {
   readonly building_grid_bit_shift: uint
   /**
    * The fluid capacity of this entity or 0 if this entity doesn't support fluids.
-   * @remarks Crafting machines will report 0 due to their fluid capacity being what ever a given recipe needs.
+   * @remarks Crafting machines will report 0 due to their fluid capacity being whatever a given recipe needs.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.fluid_capacity Online documentation}
    */
   readonly fluid_capacity: double
@@ -8458,6 +8520,11 @@ interface BaseEntityPrototype {
    * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.alert_icon_shift Online documentation}
    */
   readonly alert_icon_shift: Vector
+  /**
+   * The alert icon scale of this entity prototype.
+   * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.alert_icon_scale Online documentation}
+   */
+  readonly alert_icon_scale: float
   /**
    * Whether this entity prototype could possibly ever be rotated.
    * @see {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.supports_direction Online documentation}
@@ -10651,10 +10718,10 @@ interface LuaFlowStatistics {
  */
 interface LuaFluidBox extends Array<Fluid | nil> {
   /**
-   * The prototype of this fluidbox index.
+   * The prototype of this fluidbox index. If this is used on a fluidbox of a crafting machine which due to recipe was created by merging multiple prototypes, a table of prototypes that were merged will be returned instead
    * @see {@link https://lua-api.factorio.com/latest/LuaFluidBox.html#LuaFluidBox.get_prototype Online documentation}
    */
-  get_prototype(index: uint): LuaFluidBoxPrototype
+  get_prototype(index: uint): LuaFluidBoxPrototype | LuaFluidBoxPrototype[]
   /**
    * The capacity of the given fluidbox index.
    * @see {@link https://lua-api.factorio.com/latest/LuaFluidBox.html#LuaFluidBox.get_capacity Online documentation}
@@ -11547,7 +11614,7 @@ interface LuaForce {
    * Unique ID associated with this force.
    * @see {@link https://lua-api.factorio.com/latest/LuaForce.html#LuaForce.index Online documentation}
    */
-  readonly index: uint
+  readonly index: ForceIndex
   /**
    * The research queue of this force. The first technology in the array is the currently active one. Reading this attribute gives an array of {@link LuaTechnology}.
    *
@@ -12458,6 +12525,11 @@ interface LuaGameScript {
    * @see {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.map_gen_presets Online documentation}
    */
   readonly map_gen_presets: LuaCustomTable<string, MapGenPreset>
+  /**
+   * Whether a console command has been used.
+   * @see {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.console_command_used Online documentation}
+   */
+  readonly console_command_used: boolean
   /**
    * The styles that {@link LuaGuiElement} can use, indexed by `name`.
    * @see {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.styles Online documentation}
@@ -16896,6 +16968,21 @@ interface LuaItemStack {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemStack.html#LuaItemStack.connected_entity Online documentation}
    */
   connected_entity?: LuaEntity
+  /**
+   * If this is an item with entity data, get the stored entity label.
+   *
+   * _Can only be used if this is ItemWithEntityData_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemStack.html#LuaItemStack.entity_label Online documentation}
+   */
+  entity_label?: string
+  /**
+   * If this is an item with entity data, get the stored entity color.
+   *
+   * _Can only be used if this is ItemWithEntityData_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemStack.html#LuaItemStack.entity_color Online documentation}
+   */
+  get entity_color(): Color | nil
+  set entity_color(value: Color | ColorArray | nil)
   /**
    * If this is a blueprint item.
    * @see {@link https://lua-api.factorio.com/latest/LuaItemStack.html#LuaItemStack.is_blueprint Online documentation}
@@ -17674,6 +17761,21 @@ interface ItemWithEntityDataItemStack extends BaseItemStack {
    * @see {@link https://lua-api.factorio.com/latest/LuaItemStack.html#LuaItemStack.create_grid Online documentation}
    */
   create_grid(): LuaEquipmentGrid
+  /**
+   * If this is an item with entity data, get the stored entity label.
+   *
+   * _Can only be used if this is ItemWithEntityData_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemStack.html#LuaItemStack.entity_label Online documentation}
+   */
+  entity_label?: string
+  /**
+   * If this is an item with entity data, get the stored entity color.
+   *
+   * _Can only be used if this is ItemWithEntityData_
+   * @see {@link https://lua-api.factorio.com/latest/LuaItemStack.html#LuaItemStack.entity_color Online documentation}
+   */
+  get entity_color(): Color | nil
+  set entity_color(value: Color | ColorArray | nil)
 }
 
 interface ItemWithLabelItemStack extends BaseItemStack {
@@ -18835,10 +18937,6 @@ interface LuaPlayer extends LuaControl {
   }): boolean
   /**
    * Checks if this player can build what ever is in the cursor on the surface the player is on.
-   *
-   * **Raised events:**
-   * - {@link OnPreBuildEvent on_pre_build}? _instantly_ Raised if the cursor was successfully built.
-   * - {@link OnBuiltEntityEvent on_built_entity}? _instantly_ Raised if the cursor was successfully built.
    * @see {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.can_build_from_cursor Online documentation}
    */
   can_build_from_cursor(params: {
@@ -18864,8 +18962,11 @@ interface LuaPlayer extends LuaControl {
     readonly skip_fog_of_war?: boolean
   }): boolean
   /**
-   * Builds what ever is in the cursor on the surface the player is on.
-   * @remarks Anything built will fire normal player-built events.<br>The cursor stack will automatically be reduced as if the player built normally.
+   * Builds whatever is in the cursor on the surface the player is on. The cursor stack will automatically be reduced as if the player built normally.
+   *
+   * **Raised events:**
+   * - {@link OnPreBuildEvent on_pre_build}? _instantly_ Raised if the cursor was successfully built.
+   * - {@link OnBuiltEntityEvent on_built_entity}? _instantly_ Raised if the cursor was successfully built.
    * @see {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.build_from_cursor Online documentation}
    */
   build_from_cursor(params: {
@@ -19006,15 +19107,17 @@ interface LuaPlayer extends LuaControl {
    */
   exit_cutscene(): void
   /**
-   * Queues a request to open the map at the specified position. If the map is already opened, the request will simply set the position (and scale). Render mode change requests are processed before rendering of the next frame.
+   * Queues a request to open the map at the specified position. If the map is already opened, the request will simply set the position, scale, and entity to follow. Render mode change requests are processed before rendering of the next frame.
+   * @param entity The entity to follow. If not given the current entity being followed will be cleared.
    * @see {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.open_map Online documentation}
    */
-  open_map(position: MapPosition | MapPositionArray, scale?: double): void
+  open_map(position: MapPosition | MapPositionArray, scale?: double, entity?: LuaEntity): void
   /**
-   * Queues a request to zoom to world at the specified position. If the player is already zooming to world, the request will simply set the position (and scale). Render mode change requests are processed before rendering of the next frame.
+   * Queues a request to zoom to world at the specified position. If the player is already zooming to world, the request will simply set the position, scale, and entity to follow. Render mode change requests are processed before rendering of the next frame.
+   * @param entity The entity to follow. If not given the current entity being followed will be cleared.
    * @see {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.zoom_to_world Online documentation}
    */
-  zoom_to_world(position: MapPosition | MapPositionArray, scale?: double): void
+  zoom_to_world(position: MapPosition | MapPositionArray, scale?: double, entity?: LuaEntity): void
   /**
    * Queues request to switch to the normal game view from the map or zoom to world view. Render mode change requests are processed before rendering of the next frame.
    * @see {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.close_map Online documentation}
@@ -19074,22 +19177,22 @@ interface LuaPlayer extends LuaControl {
    */
   toggle_map_editor(): void
   /**
-   * Requests a translation for the given localised string. If the request is successful the {@link OnStringTranslatedEvent on_string_translated} event will be fired at a later time with the results.
+   * Requests a translation for the given localised string. If the request is successful, the {@link OnStringTranslatedEvent on_string_translated} event will be fired with the results.
    *
    * **Raised events:**
    * - {@link OnStringTranslatedEvent on_string_translated}? _future_tick_ Raised if the request was successfully sent.
-   * @returns The unique id for the requested translation.
-   * @remarks Does nothing if this player is not connected. (see {@link LuaPlayer#connected LuaPlayer::connected}).
+   * @returns The unique ID for the requested translation.
+   * @remarks Does nothing if this player is not connected (see {@link LuaPlayer#connected LuaPlayer::connected}).
    * @see {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.request_translation Online documentation}
    */
   request_translation(localised_string: LocalisedString): uint | nil
   /**
-   * Requests a translation for the given localised strings. If the request is successful the {@link OnStringTranslatedEvent on_string_translated} event will be fired at a later time with the results.
+   * Requests translation for the given set of localised strings. If the request is successful, a {@link OnStringTranslatedEvent on_string_translated} event will be fired for each string with the results.
    *
    * **Raised events:**
    * - {@link OnStringTranslatedEvent on_string_translated}? _future_tick_ Raised if the request was successfully sent.
-   * @returns The unique id for the requested translation.
-   * @remarks Does nothing if this player is not connected. (see {@link LuaPlayer#connected LuaPlayer::connected}).
+   * @returns The unique IDs for the requested translations.
+   * @remarks Does nothing if this player is not connected (see {@link LuaPlayer#connected LuaPlayer::connected}).
    * @see {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.request_translations Online documentation}
    */
   request_translations(localised_strings: readonly LocalisedString[]): uint[] | nil
@@ -19307,6 +19410,11 @@ interface LuaPlayer extends LuaControl {
    * @see {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.cursor_stack_temporary Online documentation}
    */
   cursor_stack_temporary: boolean
+  /**
+   * The wire drag target for this player, if any.
+   * @see {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.drag_target Online documentation}
+   */
+  readonly drag_target?: DragTarget
   /**
    * The player's zoom-level.
    * @see {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.zoom Online documentation}
@@ -19405,7 +19513,7 @@ interface LuaProgrammableSpeakerControlBehavior extends LuaControlBehavior {
 }
 
 /**
- * An interface to send messages to the calling RCON interface.
+ * An interface to send messages to the calling RCON interface through the global object named `rcon`.
  * @see {@link https://lua-api.factorio.com/latest/LuaRCON.html Online documentation}
  * @noSelf
  */
@@ -19476,6 +19584,11 @@ interface LuaRailPath {
    * @see {@link https://lua-api.factorio.com/latest/LuaRailPath.html#LuaRailPath.rails Online documentation}
    */
   readonly rails: LuaCustomTable<uint, LuaEntity>
+  /**
+   * If the path goes from the front of the train
+   * @see {@link https://lua-api.factorio.com/latest/LuaRailPath.html#LuaRailPath.is_front Online documentation}
+   */
+  readonly is_front: boolean
   /**
    * Is this object valid? This Lua object holds a reference to an object within the game engine. It is possible that the game-engine object is removed whilst a mod still holds the corresponding Lua object. If that happens, the object becomes invalid, i.e. this attribute will be `false`. Mods are advised to check for object validity if any change to the game state might have occurred between the creation of the Lua object and its access.
    */
@@ -19909,7 +20022,7 @@ interface LuaRemote {
 }
 
 /**
- * Allows rendering of geometric shapes, text and sprites in the game world. Each render object is identified by an id that is universally unique for the lifetime of a whole game.
+ * Allows rendering of geometric shapes, text and sprites in the game world through the global object named `rendering`. Each render object is identified by an id that is universally unique for the lifetime of a whole game.
  * @remarks If an entity target of an object is destroyed or changes surface, then the object is also destroyed.
  * @see {@link https://lua-api.factorio.com/latest/LuaRendering.html Online documentation}
  * @noSelf
@@ -20020,7 +20133,7 @@ interface LuaRendering {
      */
     readonly visible?: boolean
     /**
-     * If this should be drawn below sprites and entities.
+     * If this should be drawn below sprites and entities. Rich text does not support this option.
      */
     readonly draw_on_ground?: boolean
     /**
@@ -20043,6 +20156,10 @@ interface LuaRendering {
      * If this should only be rendered in alt mode. Defaults to false.
      */
     readonly only_in_alt_mode?: boolean
+    /**
+     * If rich text rendering is enabled. Defaults to false.
+     */
+    readonly use_rich_text?: boolean
   }): uint64
   /**
    * Create a circle.
@@ -20793,6 +20910,21 @@ interface LuaRendering {
    * @see {@link https://lua-api.factorio.com/latest/LuaRendering.html#LuaRendering.set_scale_with_zoom Online documentation}
    */
   set_scale_with_zoom(id: uint64, scale_with_zoom: boolean): void
+  /**
+   * Get if the text with this id parses rich text tags.
+   *
+   * _Can only be used if this is Text_
+   * @returns `nil` if the object is not a text.
+   * @see {@link https://lua-api.factorio.com/latest/LuaRendering.html#LuaRendering.get_use_rich_text Online documentation}
+   */
+  get_use_rich_text(id: uint64): boolean | nil
+  /**
+   * Set if the text with this id parses rich text tags.
+   *
+   * _Can only be used if this is Text_
+   * @see {@link https://lua-api.factorio.com/latest/LuaRendering.html#LuaRendering.set_use_rich_text Online documentation}
+   */
+  set_use_rich_text(id: uint64, use_rich_text: boolean): void
   /**
    * Get if the circle or rectangle with this id is filled.
    *
@@ -21269,7 +21401,7 @@ interface LuaShortcutPrototype {
    */
   readonly item_to_spawn?: LuaItemPrototype
   /**
-   * The technology to unlock when this shortcut is used, if any.
+   * The technology that needs to be researched once (in any save) for this shortcut to be unlocked (in all saves).
    * @see {@link https://lua-api.factorio.com/latest/LuaShortcutPrototype.html#LuaShortcutPrototype.technology_to_unlock Online documentation}
    */
   readonly technology_to_unlock?: LuaTechnologyPrototype
@@ -22635,6 +22767,7 @@ interface LuaSurface {
     readonly to_be_upgraded?: boolean
     readonly limit?: uint
     readonly is_military_target?: boolean
+    readonly has_item_inside?: LuaItemPrototype
     /**
      * Whether the filters should be inverted.
      */
@@ -23642,6 +23775,7 @@ interface LuaSurface {
    */
   get_total_pollution(): double
   /**
+   * Whether the given entity prototype collides at the given position and direction.
    * @param prototype The entity prototype to check
    * @param position The position to check
    * @param use_map_generation_bounding_box If the map generation bounding box should be used instead of the collision bounding box
@@ -23652,13 +23786,14 @@ interface LuaSurface {
     position: MapPosition | MapPositionArray,
     use_map_generation_bounding_box: boolean,
     direction?: defines.direction
-  ): void
+  ): boolean
   /**
+   * Whether the given decorative prototype collides at the given position and direction.
    * @param prototype The decorative prototype to check
    * @param position The position to check
    * @see {@link https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.decorative_prototype_collides Online documentation}
    */
-  decorative_prototype_collides(prototype: string, position: MapPosition | MapPositionArray): void
+  decorative_prototype_collides(prototype: string, position: MapPosition | MapPositionArray): boolean
   /**
    * @param property_names Names of properties (e.g. "elevation") to calculate
    * @param positions Positions for which to calculate property values
@@ -23684,6 +23819,9 @@ interface LuaSurface {
   build_checkerboard(area: BoundingBoxWrite | BoundingBoxArray): void
   /**
    * The name of this surface. Names are unique among surfaces.
+   *
+   * **Raised events:**
+   * - {@link OnSurfaceRenamedEvent on_surface_renamed} _instantly_
    * @remarks the default surface can't be renamed.
    * @see {@link https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.name Online documentation}
    */
@@ -23776,7 +23914,7 @@ interface LuaSurface {
    */
   solar_power_multiplier: double
   /**
-   * The minimal brightness during the night. Default is `0.15`. The value has an effect on the game simalution only, it doesn't have any effect on rendering.
+   * The minimal brightness during the night. Defaults to `0.15`. This has an effect on both rendering and game mechanics such as biter spawns and solar power.
    * @see {@link https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.min_brightness Online documentation}
    */
   min_brightness: double

package/runtime/generated/concepts.d.ts

@@ -242,6 +242,8 @@ interface OldTileAndPosition {
 
 /**
  * A dictionary of string to the four basic Lua types: `string`, `boolean`, `number`, `table`.
+ *
+ * Note that the API returns tags as a simple table, meaning any modifications to it will not propagate back to the game. Thus, to modify a set of tags, the whole table needs to be written back to the respective property.
  * @example
  *
  * ```
@@ -546,6 +548,17 @@ interface DecorativeResult {
   readonly amount: uint
 }
 
+interface PrototypeHistory {
+  /**
+   * The mod that created this prototype.
+   */
+  readonly created: string
+  /**
+   * The mods that changed this prototype in the order they changed it.
+   */
+  readonly changed: string[]
+}
+
 /**
  * @remarks Either `icon`, `text`, or both must be provided.
  * @see {@link https://lua-api.factorio.com/latest/Concepts.html#ChartTagSpec Online documentation}
@@ -2636,11 +2649,23 @@ interface WireConnectionDefinition {
   /**
    * Mandatory if the source entity has more than one wire connection using copper wire.
    */
-  readonly source_wire_id?: defines.circuit_connector_id
+  readonly source_wire_id?: defines.wire_connection_id
   /**
    * Mandatory if the target entity has more than one wire connection using copper wire.
    */
-  readonly target_wire_id?: defines.circuit_connector_id
+  readonly target_wire_id?: defines.wire_connection_id
+}
+
+interface DragTarget {
+  readonly target_entity: LuaEntity
+  /**
+   * If the wire being dragged is a circuit wire this is the connector id.
+   */
+  readonly target_circuit_id?: defines.circuit_connector_id
+  /**
+   * If the wire being dragged is copper wire this is the wire id.
+   */
+  readonly target_wire_id?: defines.wire_connection_id
 }
 
 interface InventoryFilter {
@@ -3068,14 +3093,15 @@ type SimpleItemStack = string | ItemStackDefinition
 type FluidIdentification = string | LuaFluidPrototype | Fluid
 
 /**
- * A force may be specified in one of two ways.
+ * A force may be specified in one of three ways.
  *
  * **Options:**
+ * - ForceIndex: The force index.
  * - `string`: The force name.
  * - {@link LuaForce}: A reference to {@link LuaForce} may be passed directly.
  * @see {@link https://lua-api.factorio.com/latest/Concepts.html#ForceIdentification Online documentation}
  */
-type ForceIdentification = string | LuaForce
+type ForceIdentification = ForceIndex | string | LuaForce
 
 /**
  * A technology may be specified in one of three ways.
@@ -4235,7 +4261,7 @@ interface ModSetting {
   /**
    * The value of the mod setting. The type depends on the kind of setting.
    */
-  readonly value: int | double | boolean | string
+  readonly value: int | double | boolean | string | Color
 }
 
 /**
@@ -5169,7 +5195,7 @@ type ModSettingPrototypeFilter =
  */
 interface BaseTechnologyPrototypeFilter {
   /**
-   * The condition to filter on. One of `"enabled"`, `"hidden"`, `"upgrade"`, `"visible-when-disabled"`, `"has-effects"`, `"has-prerequisites"`, `"research-unit-ingredient"`, `"level"`, `"max-level"`, `"time"`.
+   * The condition to filter on. One of `"enabled"`, `"hidden"`, `"upgrade"`, `"visible-when-disabled"`, `"has-effects"`, `"has-prerequisites"`, `"research-unit-ingredient"`, `"unlocks-recipe"`, `"level"`, `"max-level"`, `"time"`.
    */
   readonly filter:
     | "enabled"
@@ -5179,6 +5205,7 @@ interface BaseTechnologyPrototypeFilter {
     | "has-effects"
     | "has-prerequisites"
     | "research-unit-ingredient"
+    | "unlocks-recipe"
     | "level"
     | "max-level"
     | "time"
@@ -5203,6 +5230,17 @@ interface ResearchUnitIngredientTechnologyPrototypeFilter extends BaseTechnology
   readonly ingredient: string
 }
 
+/**
+ * `"unlocks-recipe"` variant of {@link TechnologyPrototypeFilter}.
+ */
+interface UnlocksRecipeTechnologyPrototypeFilter extends BaseTechnologyPrototypeFilter {
+  readonly filter: "unlocks-recipe"
+  /**
+   * The recipe to check.
+   */
+  readonly recipe: string
+}
+
 /**
  * `"level"` variant of {@link TechnologyPrototypeFilter}.
  */
@@ -5280,6 +5318,7 @@ interface OtherTechnologyPrototypeFilter extends BaseTechnologyPrototypeFilter {
  *
  * Other attributes may be specified depending on `filter`:
  * - `"research-unit-ingredient"`: {@link ResearchUnitIngredientTechnologyPrototypeFilter}
+ * - `"unlocks-recipe"`: {@link UnlocksRecipeTechnologyPrototypeFilter}
  * - `"level"`: {@link LevelTechnologyPrototypeFilter}
  * - `"max-level"`: {@link MaxLevelTechnologyPrototypeFilter}
  * - `"time"`: {@link TimeTechnologyPrototypeFilter}
@@ -5287,6 +5326,7 @@ interface OtherTechnologyPrototypeFilter extends BaseTechnologyPrototypeFilter {
  */
 type TechnologyPrototypeFilter =
   | ResearchUnitIngredientTechnologyPrototypeFilter
+  | UnlocksRecipeTechnologyPrototypeFilter
   | LevelTechnologyPrototypeFilter
   | MaxLevelTechnologyPrototypeFilter
   | TimeTechnologyPrototypeFilter
@@ -5298,6 +5338,7 @@ type TechnologyPrototypeFilter =
  */
 type TechnologyPrototypeFilterWrite =
   | ResearchUnitIngredientTechnologyPrototypeFilter
+  | UnlocksRecipeTechnologyPrototypeFilter
   | LevelTechnologyPrototypeFilterWrite
   | MaxLevelTechnologyPrototypeFilterWrite
   | TimeTechnologyPrototypeFilterWrite
@@ -7289,6 +7330,120 @@ type LuaPlayerRepairedEntityEventFilter =
   | GhostNamePlayerRepairedEntityEventFilter
   | OtherPlayerRepairedEntityEventFilter
 
+/**
+ * Common attributes to all variants of {@link LuaScriptRaisedTeleportedEventFilter}.
+ */
+interface BaseScriptRaisedTeleportedEventFilter {
+  /**
+   * The condition to filter on. One of `"ghost"`, `"rail"`, `"rail-signal"`, `"rolling-stock"`, `"robot-with-logistics-interface"`, `"vehicle"`, `"turret"`, `"crafting-machine"`, `"wall-connectable"`, `"transport-belt-connectable"`, `"circuit-network-connectable"`, `"type"`, `"name"`, `"ghost_type"`, `"ghost_name"`.
+   */
+  readonly filter:
+    | "ghost"
+    | "rail"
+    | "rail-signal"
+    | "rolling-stock"
+    | "robot-with-logistics-interface"
+    | "vehicle"
+    | "turret"
+    | "crafting-machine"
+    | "wall-connectable"
+    | "transport-belt-connectable"
+    | "circuit-network-connectable"
+    | "type"
+    | "name"
+    | "ghost_type"
+    | "ghost_name"
+  /**
+   * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the filters, `"and"` has higher precedence than `"or"`.
+   */
+  readonly mode?: "or" | "and"
+  /**
+   * Inverts the condition. Default is `false`.
+   */
+  readonly invert?: boolean
+}
+
+/**
+ * `"type"` variant of {@link LuaScriptRaisedTeleportedEventFilter}.
+ */
+interface TypeScriptRaisedTeleportedEventFilter extends BaseScriptRaisedTeleportedEventFilter {
+  readonly filter: "type"
+  /**
+   * The prototype type
+   */
+  readonly type: string
+}
+
+/**
+ * `"name"` variant of {@link LuaScriptRaisedTeleportedEventFilter}.
+ */
+interface NameScriptRaisedTeleportedEventFilter extends BaseScriptRaisedTeleportedEventFilter {
+  readonly filter: "name"
+  /**
+   * The prototype name
+   */
+  readonly name: string
+}
+
+/**
+ * `"ghost_type"` variant of {@link LuaScriptRaisedTeleportedEventFilter}.
+ */
+interface GhostTypeScriptRaisedTeleportedEventFilter extends BaseScriptRaisedTeleportedEventFilter {
+  readonly filter: "ghost_type"
+  /**
+   * The ghost prototype type
+   */
+  readonly type: string
+}
+
+/**
+ * `"ghost_name"` variant of {@link LuaScriptRaisedTeleportedEventFilter}.
+ */
+interface GhostNameScriptRaisedTeleportedEventFilter extends BaseScriptRaisedTeleportedEventFilter {
+  readonly filter: "ghost_name"
+  /**
+   * The ghost prototype name
+   */
+  readonly name: string
+}
+
+/**
+ * Variants of {@link LuaScriptRaisedTeleportedEventFilter} with no additional attributes.
+ */
+interface OtherScriptRaisedTeleportedEventFilter extends BaseScriptRaisedTeleportedEventFilter {
+  readonly filter:
+    | "ghost"
+    | "rail"
+    | "rail-signal"
+    | "rolling-stock"
+    | "robot-with-logistics-interface"
+    | "vehicle"
+    | "turret"
+    | "crafting-machine"
+    | "wall-connectable"
+    | "transport-belt-connectable"
+    | "circuit-network-connectable"
+}
+
+/**
+ * Depending on the value of `filter`, the table may take additional fields. `filter` may be one of the following:
+ *
+ * Base attributes: {@link BaseScriptRaisedTeleportedEventFilter}
+ *
+ * Other attributes may be specified depending on `filter`:
+ * - `"type"`: {@link TypeScriptRaisedTeleportedEventFilter}
+ * - `"name"`: {@link NameScriptRaisedTeleportedEventFilter}
+ * - `"ghost_type"`: {@link GhostTypeScriptRaisedTeleportedEventFilter}
+ * - `"ghost_name"`: {@link GhostNameScriptRaisedTeleportedEventFilter}
+ * @see {@link https://lua-api.factorio.com/latest/Concepts.html#LuaScriptRaisedTeleportedEventFilter Online documentation}
+ */
+type LuaScriptRaisedTeleportedEventFilter =
+  | TypeScriptRaisedTeleportedEventFilter
+  | NameScriptRaisedTeleportedEventFilter
+  | GhostTypeScriptRaisedTeleportedEventFilter
+  | GhostNameScriptRaisedTeleportedEventFilter
+  | OtherScriptRaisedTeleportedEventFilter
+
 /**
  * Common attributes to all variants of {@link LuaEntityMarkedForUpgradeEventFilter}.
  */

package/runtime/generated/defines.d.ts

@@ -939,6 +939,12 @@ declare namespace defines {
      * Event filter: {@link LuaScriptRaisedReviveEventFilter}
      */
     const script_raised_revive: EventId<ScriptRaisedReviveEvent, LuaScriptRaisedReviveEventFilter>
+    /**
+     * Event type: {@link ScriptRaisedTeleportedEvent}
+     *
+     * Event filter: {@link LuaScriptRaisedTeleportedEventFilter}
+     */
+    const script_raised_teleported: EventId<ScriptRaisedTeleportedEvent, LuaScriptRaisedTeleportedEventFilter>
     /**
      * Event type: {@link ScriptRaisedSetTilesEvent}
      */
@@ -1332,7 +1338,7 @@ declare namespace defines {
    * See the {@linkplain https://lua-api.factorio.com/latest/events.html events page} for more info on what events contain and when they get raised.
    * @see {@link https://lua-api.factorio.com/latest/defines.html#defines.events Online documentation}
    */
-  type events = typeof events[keyof typeof events]
+  type events = (typeof events)[keyof typeof events]
   enum flow_precision_index {
     five_seconds,
     one_minute,

package/runtime/generated/events.d.ts

@@ -2152,6 +2152,10 @@ interface OnPlayerFastTransferredEvent extends EventData {
    * Whether the transfer was from player to entity. If `false`, the transfer was from entity to player.
    */
   readonly from_player: boolean
+  /**
+   * Whether the transfer was a split action (half stack).
+   */
+  readonly is_split: boolean
   /**
    * Identifier of the event
    */
@@ -2920,15 +2924,15 @@ interface OnPreBuildEvent extends EventData {
    */
   readonly direction: defines.direction
   /**
-   * If building this blueprint was flipped horizontally.
+   * Whether the blueprint was flipped horizontally. `nil` if not built by a blueprint.
    */
-  readonly flip_horizontal: boolean
+  readonly flip_horizontal: boolean | nil
   /**
-   * If building this blueprint was flipped vertically.
+   * Whether the blueprint was flipped vertically. `nil` if not built by a blueprint.
    */
-  readonly flip_vertical: boolean
+  readonly flip_vertical: boolean | nil
   /**
-   * Item was placed while moving.
+   * Whether the item was placed while moving.
    */
   readonly created_by_moving: boolean
   /**
@@ -3798,7 +3802,7 @@ interface OnSpiderCommandCompletedEvent extends EventData {
 }
 
 /**
- * Called when a translation request generated through {@link LuaPlayer#request_translation LuaPlayer::request_translation} is translated.
+ * Called when a translation request generated through {@link LuaPlayer#request_translation LuaPlayer::request_translation} or {@link LuaPlayer#request_translations LuaPlayer::request_translations} has been completed.
  * @see {@link https://lua-api.factorio.com/latest/events.html#on_string_translated Online documentation}
  */
 interface OnStringTranslatedEvent extends EventData {
@@ -4211,6 +4215,33 @@ interface ScriptRaisedSetTilesEvent extends EventData {
   readonly tick: uint
 }
 
+/**
+ * A static event mods can use to tell other mods they teleported something by script. This event is only raised if a mod does so with {@link LuaBootstrap#raise_event LuaBootstrap::raise_event} or {@link LuaBootstrap#raise_script_teleported LuaBootstrap::raise_script_teleported}, or when `raise_teleported` is passed to {@link LuaControl#teleport LuaControl::teleport}. Can be filtered using {@link LuaScriptRaisedTeleportedEventFilter}.
+ * @see {@link https://lua-api.factorio.com/latest/events.html#script_raised_teleported Online documentation}
+ */
+interface ScriptRaisedTeleportedEvent extends EventData {
+  /**
+   * The entity that was teleported.
+   */
+  readonly entity: LuaEntity
+  /**
+   * The entity's surface before the teleportation.
+   */
+  readonly old_surface_index: uint8
+  /**
+   * The entity's position before the teleportation.
+   */
+  readonly old_position: MapPosition
+  /**
+   * Identifier of the event
+   */
+  readonly name: typeof defines.events.script_raised_teleported
+  /**
+   * Tick the event was generated.
+   */
+  readonly tick: uint
+}
+
 /** An event id. */
 type EventId<T extends table, F = unknown> = uint & {
   readonly _eventData: T

package/runtime/generated/index-types.d.ts

@@ -16,6 +16,13 @@ type PlayerIndex = uint & IndexBrand<"_playerIndexBrand">
  */
 type SurfaceIndex = uint & IndexBrand<"_surfaceIndexBrand">
 
+/**
+ * See {@link LuaForce#index LuaForce.index}.
+ *
+ * If using strict-index-types, and you need to use a plain number for this type, you can use a cast, e.g. `1 as ForceIndex`.
+ */
+type ForceIndex = uint & IndexBrand<"_forceIndexBrand">
+
 /**
  * See {@link LuaEntity#unit_number LuaEntity.unit_number}.
  *