typed-factorio 1.13.0 → 1.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typed-factorio",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "Featureful typescript definitions for the the Factorio modding lua api.",
   "keywords": [
     "factorio",
@@ -33,30 +33,30 @@
     "typescript-to-lua": "^1.6.1"
   },
   "devDependencies": {
-    "@types/jest": "^29.2.5",
-    "@types/node": "^18.11.18",
+    "@types/jest": "^29.4.0",
+    "@types/node": "^18.14.6",
     "@types/prettier": "^2.7.2",
-    "@typescript-eslint/eslint-plugin": "^5.48.1",
-    "@typescript-eslint/parser": "^5.48.1",
+    "@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.31.0",
+    "eslint": "~8.35.0",
     "eslint-config-prettier": "^8.6.0",
     "eslint-config-standard": "^17.0.0",
     "eslint-import-resolver-typescript": "^3.5.3",
-    "eslint-plugin-import": "^2.27.0",
+    "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.3.1",
+    "jest": "^29.4.3",
     "lua-types": "^2.13.1",
-    "prettier": "^2.8.2",
+    "prettier": "^2.8.4",
     "rimraf": "^3.0.2",
-    "ts-jest": "^29.0.4",
+    "ts-jest": "^29.0.5",
     "ts-node": "^10.9.1",
-    "typescript": "~4.9.4",
-    "typescript-to-lua": "^1.11.1"
+    "typescript": "~4.9.5",
+    "typescript-to-lua": "^1.13.2"
   },
   "packageManager": "yarn@3.2.3"
 }

package/runtime/generated/classes.d.ts

@@ -494,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.
@@ -785,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
  */
@@ -979,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.
@@ -1048,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
@@ -1272,7 +1298,7 @@ interface LuaControl {
    * 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: uint
+  readonly force_index: ForceIndex
   /**
    * The currently selected entity. Assigning an entity will select it if is selectable, otherwise the selection is cleared.
    *
@@ -7190,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
@@ -8391,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
@@ -10692,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}
@@ -11588,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}.
    *
@@ -16942,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}
@@ -17720,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 {
@@ -18906,7 +18962,7 @@ 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. 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.
@@ -19121,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
@@ -19457,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
  */
@@ -19966,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
@@ -20077,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
     /**
@@ -20100,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.
@@ -20850,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.
    *
@@ -22692,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.
      */

package/runtime/generated/concepts.d.ts

@@ -3093,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.
@@ -4260,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
 }
 
 /**
@@ -5194,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"
@@ -5204,6 +5205,7 @@ interface BaseTechnologyPrototypeFilter {
     | "has-effects"
     | "has-prerequisites"
     | "research-unit-ingredient"
+    | "unlocks-recipe"
     | "level"
     | "max-level"
     | "time"
@@ -5228,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}.
  */
@@ -5305,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}
@@ -5312,6 +5326,7 @@ interface OtherTechnologyPrototypeFilter extends BaseTechnologyPrototypeFilter {
  */
 type TechnologyPrototypeFilter =
   | ResearchUnitIngredientTechnologyPrototypeFilter
+  | UnlocksRecipeTechnologyPrototypeFilter
   | LevelTechnologyPrototypeFilter
   | MaxLevelTechnologyPrototypeFilter
   | TimeTechnologyPrototypeFilter
@@ -5323,6 +5338,7 @@ type TechnologyPrototypeFilter =
  */
 type TechnologyPrototypeFilterWrite =
   | ResearchUnitIngredientTechnologyPrototypeFilter
+  | UnlocksRecipeTechnologyPrototypeFilter
   | LevelTechnologyPrototypeFilterWrite
   | MaxLevelTechnologyPrototypeFilterWrite
   | TimeTechnologyPrototypeFilterWrite
@@ -7314,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}
      */

package/runtime/generated/events.d.ts

@@ -3802,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 {
@@ -4215,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}.
  *