typed-factorio 4.0.1 → 4.6.0

package/runtime/generated/events.d.ts

@@ -13,7 +13,7 @@ declare module "factorio:runtime" {
    * script.on_event("my-potato-control", function(event)
    *   game.print("Keyboard shortcut pressed on tick: " ..tostring(event.tick))
    * end)
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#CustomInputEvent Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#CustomInputEvent Online documentation}
    */
   interface CustomInputEvent extends EventData {
     /**
@@ -57,9 +57,55 @@ declare module "factorio:runtime" {
      */
     readonly tick: MapTick
   }
+  /**
+   * Called when a recipe with {@link import("factorio:prototype").RecipePrototype#raise_on_crafted RecipePrototype::raise_on_crafted} is crafted.
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#RecipeCraftedEvent Online documentation}
+   */
+  interface RecipeCraftedEvent extends EventData {
+    /**
+     * Entity that crafted recipe.
+     */
+    readonly entity: LuaEntity
+    /**
+     * Name of recipe that was crafted.
+     */
+    readonly recipe: string
+    /**
+     * Quality of the recipe crafted.
+     */
+    readonly recipe_quality: string
+    /**
+     * Quality effect used when giving products. Not provided if value is 0. May be different than value obtained from {@link LuaEntity#effects LuaEntity::effects} when quality modules were changed between craft starting and products being given.
+     */
+    readonly quality_effect?: EffectValue
+    /**
+     * Random value in range [0, 1) that was used when selecting product quality. Only provided when quality_effect is provided.
+     */
+    readonly quality_seed?: double
+    /**
+     * Quality of products given. May be different than recipe quality if quality modules are present. Always provided even if quality_effect is zero because {@link LuaEntity#result_quality LuaEntity::result_quality} may have been used. Only used by products without quality control.
+     */
+    readonly product_quality: string
+    /**
+     * If crafted as part of bonus products.
+     */
+    readonly bonus: boolean
+    /**
+     * Random value in range {@link import("factorio:prototype").ProductPrototypeBase#shared_probability 0, 1) used as part of shared roll when giving products. Related to [ProductPrototypeBase::shared_probability}.
+     */
+    readonly shared_roll: double
+    /**
+     * Identifier of the event.
+     */
+    readonly name: defines.events
+    /**
+     * Tick the event was generated.
+     */
+    readonly tick: MapTick
+  }
   /**
    * Called when an achievement is gained.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_achievement_gained Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_achievement_gained Online documentation}
    */
   interface OnAchievementGainedEvent extends EventData {
     /**
@@ -78,7 +124,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a unit/group completes a command.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_ai_command_completed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_ai_command_completed Online documentation}
    */
   interface OnAiCommandCompletedEvent extends EventData {
     /**
@@ -101,7 +147,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when an area of the map is cloned.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_area_cloned Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_area_cloned Online documentation}
    */
   interface OnAreaClonedEvent extends EventData {
     readonly source_surface: LuaSurface
@@ -127,7 +173,7 @@ declare module "factorio:runtime" {
    * Called when a biter migration builds a base.
    *
    * This will be called multiple times for each migration, once for every biter that is sacrificed to build part of the new base.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_biter_base_built Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_biter_base_built Online documentation}
    */
   interface OnBiterBaseBuiltEvent extends EventData {
     /**
@@ -149,7 +195,7 @@ declare module "factorio:runtime" {
    * The entity's settings, rotation, mirroring, wire connections, etc. may have been updated. This event is raised even if no settings actually changed.
    *
    * Note this event is not raised when an entity is upgraded or marked for upgrade, when a new entity is created, or when an entity ghost is instantly revived. {@link OnBuiltEntityEvent on_built_entity} is raised instead in those cases.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_blueprint_settings_pasted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_blueprint_settings_pasted Online documentation}
    */
   interface OnBlueprintSettingsPastedEvent extends EventData {
     /**
@@ -183,7 +229,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a set of positions on the map is cloned.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_brush_cloned Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_brush_cloned Online documentation}
    */
   interface OnBrushClonedEvent extends EventData {
     readonly source_offset: TilePosition
@@ -208,7 +254,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a {@link defines.command.build_base} command reaches its destination, and before building starts.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_build_base_arrived Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_build_base_arrived Online documentation}
    */
   interface OnBuildBaseArrivedEvent extends EventData {
     /**
@@ -232,7 +278,7 @@ declare module "factorio:runtime" {
    * Called when player builds something.
    *
    * Event filter: [LuaPlayerBuiltEntityEventFilter](LuaPlayerBuiltEntityEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_built_entity Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_built_entity Online documentation}
    */
   interface OnBuiltEntityEvent extends EventData {
     /**
@@ -264,7 +310,7 @@ declare module "factorio:runtime" {
    * Called when the deconstruction of an entity is canceled.
    *
    * Event filter: [LuaEntityDeconstructionCancelledEventFilter](LuaEntityDeconstructionCancelledEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_cancelled_deconstruction Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_cancelled_deconstruction Online documentation}
    */
   interface OnCancelledDeconstructionEvent extends EventData {
     readonly entity: LuaEntity
@@ -282,7 +328,7 @@ declare module "factorio:runtime" {
    * Called when the upgrade of an entity is canceled.
    *
    * Event filter: [LuaUpgradeCancelledEventFilter](LuaUpgradeCancelledEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_cancelled_upgrade Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_cancelled_upgrade Online documentation}
    */
   interface OnCancelledUpgradeEvent extends EventData {
     readonly entity: LuaEntity
@@ -300,7 +346,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a cargo pod has delivered its cargo.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_cargo_pod_delivered_cargo Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_cargo_pod_delivered_cargo Online documentation}
    */
   interface OnCargoPodDeliveredCargoEvent extends EventData {
     readonly cargo_pod: LuaEntity
@@ -319,7 +365,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a cargo pod departs a surface.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_cargo_pod_finished_ascending Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_cargo_pod_finished_ascending Online documentation}
    */
   interface OnCargoPodFinishedAscendingEvent extends EventData {
     readonly cargo_pod: LuaEntity
@@ -342,7 +388,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a cargo pods lands on a surface, either at a station or on the ground.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_cargo_pod_finished_descending Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_cargo_pod_finished_descending Online documentation}
    */
   interface OnCargoPodFinishedDescendingEvent extends EventData {
     readonly cargo_pod: LuaEntity
@@ -365,7 +411,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a cargo pod departs from a space platform hub or by another method not attached to a rocket.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_cargo_pod_started_ascending Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_cargo_pod_started_ascending Online documentation}
    */
   interface OnCargoPodStartedAscendingEvent extends EventData {
     readonly cargo_pod: LuaEntity
@@ -386,7 +432,7 @@ declare module "factorio:runtime" {
    * Called when a character corpse expires due to timeout or all of the items being removed from it.
    *
    * this is not called if the corpse is mined. See {@link defines.events.on_pre_player_mined_item} to detect that.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_character_corpse_expired Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_character_corpse_expired Online documentation}
    */
   interface OnCharacterCorpseExpiredEvent extends EventData {
     /**
@@ -404,7 +450,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a chart tag is created.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_chart_tag_added Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_chart_tag_added Online documentation}
    */
   interface OnChartTagAddedEvent extends EventData {
     readonly tag: LuaCustomChartTag
@@ -421,7 +467,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a chart tag is modified by a player or by script.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_chart_tag_modified Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_chart_tag_modified Online documentation}
    */
   interface OnChartTagModifiedEvent extends EventData {
     readonly tag: LuaCustomChartTag
@@ -443,7 +489,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called just before a chart tag is deleted.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_chart_tag_removed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_chart_tag_removed Online documentation}
    */
   interface OnChartTagRemovedEvent extends EventData {
     readonly tag: LuaCustomChartTag
@@ -460,7 +506,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a chunk is charted or re-charted.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_chunk_charted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_chunk_charted Online documentation}
    */
   interface OnChunkChartedEvent extends EventData {
     readonly surface_index: SurfaceIndex
@@ -481,7 +527,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when one or more chunks are deleted using {@link LuaSurface#delete_chunk LuaSurface::delete_chunk}.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_chunk_deleted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_chunk_deleted Online documentation}
    */
   interface OnChunkDeletedEvent extends EventData {
     readonly surface_index: SurfaceIndex
@@ -500,7 +546,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a chunk is generated.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_chunk_generated Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_chunk_generated Online documentation}
    */
   interface OnChunkGeneratedEvent extends EventData {
     /**
@@ -526,7 +572,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a combat robot expires through a lack of energy, or timeout.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_combat_robot_expired Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_combat_robot_expired Online documentation}
    */
   interface OnCombatRobotExpiredEvent extends EventData {
     readonly robot: LuaEntity
@@ -547,7 +593,7 @@ declare module "factorio:runtime" {
    * Called when a message is sent to the in-game console, either by a player or through the server interface.
    *
    * This event only fires for plain messages, not for any commands (including `/shout` or `/whisper`).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_console_chat Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_console_chat Online documentation}
    */
   interface OnConsoleChatEvent extends EventData {
     /**
@@ -569,7 +615,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when someone enters a command-like message regardless of it being a valid command.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_console_command Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_console_command Online documentation}
    */
   interface OnConsoleCommandEvent extends EventData {
     /**
@@ -595,7 +641,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a cutscene is cancelled by the player or by script.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_cutscene_cancelled Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_cutscene_cancelled Online documentation}
    */
   interface OnCutsceneCancelledEvent extends EventData {
     /**
@@ -613,7 +659,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a cutscene finishes naturally (was not cancelled).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_cutscene_finished Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_cutscene_finished Online documentation}
    */
   interface OnCutsceneFinishedEvent extends EventData {
     /**
@@ -631,7 +677,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a cutscene starts.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_cutscene_started Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_cutscene_started Online documentation}
    */
   interface OnCutsceneStartedEvent extends EventData {
     /**
@@ -651,7 +697,7 @@ declare module "factorio:runtime" {
    * Called when a cutscene is playing, each time it reaches a waypoint in that cutscene.
    *
    * This refers to an index in the table previously passed to set_controller which started the cutscene.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_cutscene_waypoint_reached Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_cutscene_waypoint_reached Online documentation}
    */
   interface OnCutsceneWaypointReachedEvent extends EventData {
     /**
@@ -675,7 +721,7 @@ declare module "factorio:runtime" {
    * Called when an entity is cloned. The filter applies to the source entity.
    *
    * Event filter: [LuaEntityClonedEventFilter](LuaEntityClonedEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_entity_cloned Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_entity_cloned Online documentation}
    */
   interface OnEntityClonedEvent extends EventData {
     readonly source: LuaEntity
@@ -693,7 +739,7 @@ declare module "factorio:runtime" {
    * Called after an entity has been recolored either by the player or through script.
    *
    * Automatic recoloring due to {@link LuaPlayer#color LuaPlayer::color} will not raise events, as that is a separate mechanism.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_entity_color_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_entity_color_changed Online documentation}
    */
   interface OnEntityColorChangedEvent extends EventData {
     /**
@@ -713,7 +759,7 @@ declare module "factorio:runtime" {
    * Called when an entity is damaged. This is not called when an entities health is set directly by another mod.
    *
    * Event filter: [LuaEntityDamagedEventFilter](LuaEntityDamagedEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_entity_damaged Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_entity_damaged Online documentation}
    */
   interface OnEntityDamagedEvent extends EventData {
     readonly entity: LuaEntity
@@ -755,7 +801,7 @@ declare module "factorio:runtime" {
    * Called when an entity dies.
    *
    * Event filter: [LuaEntityDiedEventFilter](LuaEntityDiedEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_entity_died Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_entity_died Online documentation}
    */
   interface OnEntityDiedEvent extends EventData {
     /**
@@ -789,7 +835,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when one of an entity's logistic slots changes.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_entity_logistic_slot_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_entity_logistic_slot_changed Online documentation}
    */
   interface OnEntityLogisticSlotChangedEvent extends EventData {
     /**
@@ -819,7 +865,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after an entity has been renamed either by the player or through script.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_entity_renamed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_entity_renamed Online documentation}
    */
   interface OnEntityRenamedEvent extends EventData {
     /**
@@ -840,7 +886,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after entity copy-paste is done.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_entity_settings_pasted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_entity_settings_pasted Online documentation}
    */
   interface OnEntitySettingsPastedEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -863,7 +909,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when an entity is spawned by a EnemySpawner
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_entity_spawned Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_entity_spawned Online documentation}
    */
   interface OnEntitySpawnedEvent extends EventData {
     readonly spawner: LuaEntity
@@ -879,7 +925,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after equipment is inserted into an equipment grid.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_equipment_inserted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_equipment_inserted Online documentation}
    */
   interface OnEquipmentInsertedEvent extends EventData {
     /**
@@ -901,7 +947,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after equipment is removed from an equipment grid.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_equipment_removed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_equipment_removed Online documentation}
    */
   interface OnEquipmentRemovedEvent extends EventData {
     /**
@@ -931,7 +977,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when the a forces cease fire values change.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_force_cease_fire_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_force_cease_fire_changed Online documentation}
    */
   interface OnForceCeaseFireChangedEvent extends EventData {
     /**
@@ -959,7 +1005,7 @@ declare module "factorio:runtime" {
    * Called when a new force is created using `game.create_force()`
    *
    * This is not called when the default forces (`'player'`, `'enemy'`, `'neutral'`) are created as they will always exist.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_force_created Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_force_created Online documentation}
    */
   interface OnForceCreatedEvent extends EventData {
     /**
@@ -977,7 +1023,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when the a forces friends change.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_force_friends_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_force_friends_changed Online documentation}
    */
   interface OnForceFriendsChangedEvent extends EventData {
     /**
@@ -1003,7 +1049,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when {@link LuaForce#reset LuaForce::reset} is finished.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_force_reset Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_force_reset Online documentation}
    */
   interface OnForceResetEvent extends EventData {
     readonly force: LuaForce
@@ -1020,7 +1066,7 @@ declare module "factorio:runtime" {
    * Called after two forces have been merged using `game.merge_forces()`.
    *
    * The source force is invalidated before this event is called and the name can be re-used in this event if desired.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_forces_merged Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_forces_merged Online documentation}
    */
   interface OnForcesMergedEvent extends EventData {
     /**
@@ -1046,7 +1092,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when two forces are about to be merged using `game.merge_forces()`.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_forces_merging Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_forces_merging Online documentation}
    */
   interface OnForcesMergingEvent extends EventData {
     /**
@@ -1070,7 +1116,7 @@ declare module "factorio:runtime" {
    * Called when a game is created from a scenario. This is fired for every mod, even when the scenario's save data already includes it. In those cases however, {@link LuaBootstrap#on_init LuaBootstrap::on_init} is not fired.
    *
    * This event is not fired when the scenario is loaded via the map editor.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_game_created_from_scenario Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_game_created_from_scenario Online documentation}
    */
   interface OnGameCreatedFromScenarioEvent extends EventData {
     /**
@@ -1084,7 +1130,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when {@link LuaGuiElement} checked state is changed (related to checkboxes and radio buttons).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_checked_state_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_checked_state_changed Online documentation}
    */
   interface OnGuiCheckedStateChangedEvent extends EventData {
     /**
@@ -1106,7 +1152,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when {@link LuaGuiElement} is clicked.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_click Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_click Online documentation}
    */
   interface OnGuiClickEvent extends EventData {
     /**
@@ -1152,7 +1198,7 @@ declare module "factorio:runtime" {
    * This can only be raised when the GUI's player controller is still valid. If a GUI is thus closed due to the player disconnecting, dying, or becoming a spectator in other ways, it won't cause this event to be raised.
    *
    * It's not advised to open any other GUI during this event because if this is run as a request to open a different GUI the game will force close the new opened GUI without notice to ensure the original requested GUI is opened.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_closed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_closed Online documentation}
    */
   interface OnGuiClosedEvent extends EventData {
     /**
@@ -1206,7 +1252,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a {@link LuaGuiElement} is confirmed, for example by pressing Enter in a textfield.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_confirmed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_confirmed Online documentation}
    */
   interface OnGuiConfirmedEvent extends EventData {
     /**
@@ -1240,7 +1286,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when {@link LuaGuiElement} element value is changed (related to choose element buttons).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_elem_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_elem_changed Online documentation}
    */
   interface OnGuiElemChangedEvent extends EventData {
     /**
@@ -1264,7 +1310,7 @@ declare module "factorio:runtime" {
    * Called when {@link LuaGuiElement} is hovered by the mouse.
    *
    * Only fired for events whose {@link LuaGuiElement#raise_hover_events LuaGuiElement::raise_hover_events} is `true`.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_hover Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_hover Online documentation}
    */
   interface OnGuiHoverEvent extends EventData {
     /**
@@ -1286,7 +1332,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player interacts with a custom inventory GUI.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_inventory_action Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_inventory_action Online documentation}
    */
   interface OnGuiInventoryActionEvent extends EventData {
     /**
@@ -1346,7 +1392,7 @@ declare module "factorio:runtime" {
    * Called when the player's cursor leaves a {@link LuaGuiElement} that was previously hovered.
    *
    * Only fired for events whose {@link LuaGuiElement#raise_hover_events LuaGuiElement::raise_hover_events} is `true`.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_leave Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_leave Online documentation}
    */
   interface OnGuiLeaveEvent extends EventData {
     /**
@@ -1368,7 +1414,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when {@link LuaGuiElement} element location is changed (related to frames in `player.gui.screen`).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_location_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_location_changed Online documentation}
    */
   interface OnGuiLocationChangedEvent extends EventData {
     /**
@@ -1390,7 +1436,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when the player opens a GUI.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_opened Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_opened Online documentation}
    */
   interface OnGuiOpenedEvent extends EventData {
     /**
@@ -1444,7 +1490,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when {@link LuaGuiElement} selected tab is changed (related to tabbed-panes).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_selected_tab_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_selected_tab_changed Online documentation}
    */
   interface OnGuiSelectedTabChangedEvent extends EventData {
     /**
@@ -1466,7 +1512,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when {@link LuaGuiElement} selection state is changed (related to drop-downs and listboxes).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_selection_state_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_selection_state_changed Online documentation}
    */
   interface OnGuiSelectionStateChangedEvent extends EventData {
     /**
@@ -1488,7 +1534,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when {@link LuaGuiElement} switch state is changed (related to switches).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_switch_state_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_switch_state_changed Online documentation}
    */
   interface OnGuiSwitchStateChangedEvent extends EventData {
     /**
@@ -1510,7 +1556,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when {@link LuaGuiElement} text is changed by the player.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_text_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_text_changed Online documentation}
    */
   interface OnGuiTextChangedEvent extends EventData {
     /**
@@ -1536,7 +1582,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when {@link LuaGuiElement} slider value is changed (related to the slider element).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_gui_value_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_gui_value_changed Online documentation}
    */
   interface OnGuiValueChangedEvent extends EventData {
     /**
@@ -1558,7 +1604,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a land mine is armed.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_land_mine_armed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_land_mine_armed Online documentation}
    */
   interface OnLandMineArmedEvent extends EventData {
     readonly mine: LuaEntity
@@ -1573,7 +1619,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a custom {@link import("factorio:prototype").ShortcutPrototype Lua shortcut} is pressed.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_lua_shortcut Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_lua_shortcut Online documentation}
    */
   interface OnLuaShortcutEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -1594,7 +1640,7 @@ declare module "factorio:runtime" {
    * Called when an entity is marked for deconstruction with the Deconstruction planner or via script.
    *
    * Event filter: [LuaEntityMarkedForDeconstructionEventFilter](LuaEntityMarkedForDeconstructionEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_marked_for_deconstruction Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_marked_for_deconstruction Online documentation}
    */
   interface OnMarkedForDeconstructionEvent extends EventData {
     readonly entity: LuaEntity
@@ -1612,7 +1658,7 @@ declare module "factorio:runtime" {
    * Called when an entity is marked for upgrade with the upgrade planner or via script.
    *
    * Event filter: [LuaEntityMarkedForUpgradeEventFilter](LuaEntityMarkedForUpgradeEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_marked_for_upgrade Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_marked_for_upgrade Online documentation}
    */
   interface OnMarkedForUpgradeEvent extends EventData {
     readonly player_index?: PlayerIndex
@@ -1641,7 +1687,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player purchases some offer from a `market` entity.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_market_item_purchased Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_market_item_purchased Online documentation}
    */
   interface OnMarketItemPurchasedEvent extends EventData {
     /**
@@ -1671,7 +1717,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when the player uses the 'Open item GUI' control on an item defined with the 'mod-openable' flag
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_mod_item_opened Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_mod_item_opened Online documentation}
    */
   interface OnModItemOpenedEvent extends EventData {
     /**
@@ -1697,7 +1743,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when {@link LuaGameScript#is_multiplayer LuaGameScript::is_multiplayer} changes to true. May also be raised when it was already true but a game was loaded from a save file and with hosting.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_multiplayer_init Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_multiplayer_init Online documentation}
    */
   interface OnMultiplayerInitEvent extends EventData {
     /**
@@ -1709,11 +1755,26 @@ declare module "factorio:runtime" {
      */
     readonly tick: MapTick
   }
+  /**
+   * Called when value of {@link LuaSurface#daytime LuaSurface::daytime} wraps around to be in `[0, 1)` range.
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_next_day_started Online documentation}
+   */
+  interface OnNextDayStartedEvent extends EventData {
+    readonly surface: LuaSurface
+    /**
+     * Identifier of the event.
+     */
+    readonly name: typeof defines.events.on_next_day_started
+    /**
+     * Tick the event was generated.
+     */
+    readonly tick: MapTick
+  }
   /**
    * Called after an object is destroyed which was registered with {@link LuaBootstrap#register_on_object_destroyed LuaBootstrap::register_on_object_destroyed} previously.
    *
    * Depending on when a given object is destroyed, this event will be fired at the end of the current tick or at the end of the next tick. The event's timing is independent of the in-world object being destroyed.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_object_destroyed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_object_destroyed Online documentation}
    */
   interface OnObjectDestroyedEvent extends EventData {
     /**
@@ -1739,7 +1800,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called directly after a permission group is added.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_permission_group_added Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_permission_group_added Online documentation}
    */
   interface OnPermissionGroupAddedEvent extends EventData {
     /**
@@ -1761,7 +1822,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called directly after a permission group is deleted.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_permission_group_deleted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_permission_group_deleted Online documentation}
    */
   interface OnPermissionGroupDeletedEvent extends EventData {
     /**
@@ -1787,7 +1848,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called directly after a permission group is edited in some way.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_permission_group_edited Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_permission_group_edited Online documentation}
    */
   interface OnPermissionGroupEditedEvent extends EventData {
     /**
@@ -1802,13 +1863,7 @@ declare module "factorio:runtime" {
      * The edit type.
      */
     readonly type:
-      | "add-permission"
-      | "remove-permission"
-      | "enable-all"
-      | "disable-all"
-      | "add-player"
-      | "remove-player"
-      | "rename"
+      "add-permission" | "remove-permission" | "enable-all" | "disable-all" | "add-player" | "remove-player" | "rename"
     /**
      * The action when the `type` is `"add-permission"` or `"remove-permission"`.
      */
@@ -1836,7 +1891,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called directly after a permission string is imported.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_permission_string_imported Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_permission_string_imported Online documentation}
    */
   interface OnPermissionStringImportedEvent extends EventData {
     /**
@@ -1854,7 +1909,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player picks up an item.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_picked_up_item Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_picked_up_item Online documentation}
    */
   interface OnPickedUpItemEvent extends EventData {
     readonly item_stack: ItemWithQualityCount
@@ -1870,7 +1925,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player alt-reverse-selects an area with a selection-tool item.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_alt_reverse_selected_area Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_alt_reverse_selected_area Online documentation}
    */
   interface OnPlayerAltReverseSelectedAreaEvent extends EventData {
     /**
@@ -1908,7 +1963,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player alt-selects an area with a selection-tool item.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_alt_selected_area Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_alt_selected_area Online documentation}
    */
   interface OnPlayerAltSelectedAreaEvent extends EventData {
     /**
@@ -1950,7 +2005,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a players ammo inventory changed in some way.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_ammo_inventory_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_ammo_inventory_changed Online documentation}
    */
   interface OnPlayerAmmoInventoryChangedEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -1965,7 +2020,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a players armor inventory changed in some way.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_armor_inventory_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_armor_inventory_changed Online documentation}
    */
   interface OnPlayerArmorInventoryChangedEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -1980,7 +2035,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player is banned.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_banned Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_banned Online documentation}
    */
   interface OnPlayerBannedEvent extends EventData {
     /**
@@ -2010,7 +2065,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player builds tiles.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_built_tile Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_built_tile Online documentation}
    */
   interface OnPlayerBuiltTileEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2049,7 +2104,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player cancels crafting.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_cancelled_crafting Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_cancelled_crafting Online documentation}
    */
   interface OnPlayerCancelledCraftingEvent extends EventData {
     /**
@@ -2079,7 +2134,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player changes forces.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_changed_force Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_changed_force Online documentation}
    */
   interface OnPlayerChangedForceEvent extends EventData {
     /**
@@ -2101,7 +2156,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when the tile position a player is located at changes.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_changed_position Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_changed_position Online documentation}
    */
   interface OnPlayerChangedPositionEvent extends EventData {
     /**
@@ -2119,7 +2174,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player changes surfaces.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_changed_surface Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_changed_surface Online documentation}
    */
   interface OnPlayerChangedSurfaceEvent extends EventData {
     /**
@@ -2141,7 +2196,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when cheat mode is disabled on a player.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_cheat_mode_disabled Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_cheat_mode_disabled Online documentation}
    */
   interface OnPlayerCheatModeDisabledEvent extends EventData {
     /**
@@ -2159,7 +2214,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when cheat mode is enabled on a player.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_cheat_mode_enabled Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_cheat_mode_enabled Online documentation}
    */
   interface OnPlayerCheatModeEnabledEvent extends EventData {
     /**
@@ -2177,7 +2232,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player clicks a gps tag
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_clicked_gps_tag Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_clicked_gps_tag Online documentation}
    */
   interface OnPlayerClickedGpsTagEvent extends EventData {
     /**
@@ -2203,7 +2258,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player's color changes.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_color_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_color_changed Online documentation}
    */
   interface OnPlayerColorChangedEvent extends EventData {
     /**
@@ -2233,7 +2288,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player clicks the "confirm" button in the configure Blueprint GUI.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_configured_blueprint Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_configured_blueprint Online documentation}
    */
   interface OnPlayerConfiguredBlueprintEvent extends EventData {
     /**
@@ -2251,7 +2306,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player changes controller types.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_controller_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_controller_changed Online documentation}
    */
   interface OnPlayerControllerChangedEvent extends EventData {
     /**
@@ -2273,7 +2328,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when the player finishes crafting an item. This event fires just before the results are inserted into the player's inventory, not when the crafting is queued (see {@link OnPrePlayerCraftedItemEvent on_pre_player_crafted_item}).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_crafted_item Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_crafted_item Online documentation}
    */
   interface OnPlayerCraftedItemEvent extends EventData {
     /**
@@ -2299,7 +2354,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after the player was created.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_created Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_created Online documentation}
    */
   interface OnPlayerCreatedEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2316,7 +2371,7 @@ declare module "factorio:runtime" {
    * Called after a player's {@link LuaControl#cursor_stack cursor stack} changed in some way.
    *
    * This is fired in the same tick that the change happens, but not instantly.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_cursor_stack_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_cursor_stack_changed Online documentation}
    */
   interface OnPlayerCursorStackChangedEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2331,7 +2386,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player selects an area with a deconstruction planner.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_deconstructed_area Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_deconstructed_area Online documentation}
    */
   interface OnPlayerDeconstructedAreaEvent extends EventData {
     /**
@@ -2366,6 +2421,7 @@ declare module "factorio:runtime" {
      * If normal selection or alt selection was used.
      */
     readonly alt: boolean
+    readonly selection_mode: defines.selection_mode
     /**
      * Identifier of the event.
      */
@@ -2377,7 +2433,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player is demoted.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_demoted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_demoted Online documentation}
    */
   interface OnPlayerDemotedEvent extends EventData {
     /**
@@ -2395,7 +2451,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player dies.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_died Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_died Online documentation}
    */
   interface OnPlayerDiedEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2411,7 +2467,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when the display density scale changes for a given player. The display density scale is the scale value automatically applied based on the player's display DPI. This is only relevant on platforms that support high-density displays.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_display_density_scale_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_display_density_scale_changed Online documentation}
    */
   interface OnPlayerDisplayDensityScaleChangedEvent extends EventData {
     /**
@@ -2433,7 +2489,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when the display resolution changes for a given player.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_display_resolution_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_display_resolution_changed Online documentation}
    */
   interface OnPlayerDisplayResolutionChangedEvent extends EventData {
     /**
@@ -2455,7 +2511,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when the display scale changes for a given player.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_display_scale_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_display_scale_changed Online documentation}
    */
   interface OnPlayerDisplayScaleChangedEvent extends EventData {
     /**
@@ -2479,7 +2535,7 @@ declare module "factorio:runtime" {
    * Called when the player's driving state has changed, meaning a player has either entered or left a vehicle.
    *
    * This event is not raised when the player is ejected from a vehicle due to it being destroyed.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_driving_changed_state Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_driving_changed_state Online documentation}
    */
   interface OnPlayerDrivingChangedStateEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2498,7 +2554,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player drops an item on the ground.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_dropped_item Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_dropped_item Online documentation}
    */
   interface OnPlayerDroppedItemEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2517,7 +2573,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player drops a single item into an entity.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_dropped_item_into_entity Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_dropped_item_into_entity Online documentation}
    */
   interface OnPlayerDroppedItemIntoEntityEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2536,7 +2592,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player fast-transfers something to or from an entity.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_fast_transferred Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_fast_transferred Online documentation}
    */
   interface OnPlayerFastTransferredEvent extends EventData {
     /**
@@ -2568,7 +2624,7 @@ declare module "factorio:runtime" {
    * Called when the player flips an entity. This event is only fired when the entity actually changes its orientation or mirroring, so it won't be triggered when pressing the flip keys on an entity that can't be flipped.
    *
    * This event reflects a change in the {@link LuaEntity#mirroring LuaEntity::mirroring} property.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_flipped_entity Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_flipped_entity Online documentation}
    */
   interface OnPlayerFlippedEntityEvent extends EventData {
     /**
@@ -2591,7 +2647,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after player flushed fluid
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_flushed_fluid Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_flushed_fluid Online documentation}
    */
   interface OnPlayerFlushedFluidEvent extends EventData {
     /**
@@ -2625,7 +2681,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a players gun inventory changed in some way.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_gun_inventory_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_gun_inventory_changed Online documentation}
    */
   interface OnPlayerGunInventoryChangedEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2640,7 +2696,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player's input method changes. See {@link LuaPlayer#input_method LuaPlayer::input_method}.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_input_method_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_input_method_changed Online documentation}
    */
   interface OnPlayerInputMethodChangedEvent extends EventData {
     /**
@@ -2658,7 +2714,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player joins the game. This is not called when loading a save file in singleplayer, as the player doesn't actually leave the game, and the save is just on pause until they rejoin.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_joined_game Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_joined_game Online documentation}
    */
   interface OnPlayerJoinedGameEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2673,7 +2729,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player is kicked.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_kicked Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_kicked Online documentation}
    */
   interface OnPlayerKickedEvent extends EventData {
     /**
@@ -2699,7 +2755,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player leaves the game. This is not called when closing a save file in singleplayer, as the player doesn't actually leave the game, and the save is just on pause until they rejoin.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_left_game Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_left_game Online documentation}
    */
   interface OnPlayerLeftGameEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2715,7 +2771,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player's active locale changes. See {@link LuaPlayer#locale LuaPlayer::locale}.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_locale_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_locale_changed Online documentation}
    */
   interface OnPlayerLocaleChangedEvent extends EventData {
     /**
@@ -2737,7 +2793,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a players main inventory changed in some way.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_main_inventory_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_main_inventory_changed Online documentation}
    */
   interface OnPlayerMainInventoryChangedEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2758,7 +2814,7 @@ declare module "factorio:runtime" {
    * The buffer inventory is special in that it's only valid during this event and has a dynamic size expanding as more items are transferred into it.
    *
    * Event filter: [LuaPlayerMinedEntityEventFilter](LuaPlayerMinedEntityEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_mined_entity Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_mined_entity Online documentation}
    */
   interface OnPlayerMinedEntityEvent extends EventData {
     /**
@@ -2784,7 +2840,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when the player mines something.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_mined_item Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_mined_item Online documentation}
    */
   interface OnPlayerMinedItemEvent extends EventData {
     /**
@@ -2803,7 +2859,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player mines tiles.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_mined_tile Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_mined_tile Online documentation}
    */
   interface OnPlayerMinedTileEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2826,7 +2882,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player's current music track (ambient sound) changes. This includes when the music track finishes playing.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_music_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_music_changed Online documentation}
    */
   interface OnPlayerMusicChangedEvent extends EventData {
     /**
@@ -2844,7 +2900,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player is muted.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_muted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_muted Online documentation}
    */
   interface OnPlayerMutedEvent extends EventData {
     /**
@@ -2862,7 +2918,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player invokes the "smart pipette" over an entity.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_pipette Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_pipette Online documentation}
    */
   interface OnPlayerPipetteEvent extends EventData {
     /**
@@ -2892,7 +2948,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after the player puts equipment in an equipment grid
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_placed_equipment Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_placed_equipment Online documentation}
    */
   interface OnPlayerPlacedEquipmentEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2915,7 +2971,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player is promoted.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_promoted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_promoted Online documentation}
    */
   interface OnPlayerPromotedEvent extends EventData {
     /**
@@ -2933,7 +2989,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player is removed (deleted) from the game. This is markedly different from a player temporarily {@link OnPlayerLeftGameEvent leaving} the game, and instead behaves like the player never existed in the save file.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_removed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_removed Online documentation}
    */
   interface OnPlayerRemovedEvent extends EventData {
     /**
@@ -2951,7 +3007,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after the player removes equipment from an equipment grid
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_removed_equipment Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_removed_equipment Online documentation}
    */
   interface OnPlayerRemovedEquipmentEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -2984,7 +3040,7 @@ declare module "factorio:runtime" {
    * Called when a player repairs an entity.
    *
    * Event filter: [LuaPlayerRepairedEntityEventFilter](LuaPlayerRepairedEntityEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_repaired_entity Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_repaired_entity Online documentation}
    */
   interface OnPlayerRepairedEntityEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -3000,7 +3056,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player respawns.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_respawned Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_respawned Online documentation}
    */
   interface OnPlayerRespawnedEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -3019,7 +3075,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player reverse-selects an area with a selection-tool item.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_reverse_selected_area Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_reverse_selected_area Online documentation}
    */
   interface OnPlayerReverseSelectedAreaEvent extends EventData {
     /**
@@ -3059,7 +3115,7 @@ declare module "factorio:runtime" {
    * Called when the player rotates an entity. This event is only fired when the entity actually changes its orientation -- pressing the rotate key on an entity that can't be rotated won't fire this event.
    *
    * Entities being flipped will not fire this event, even if the flip involves rotating. See {@link OnPlayerFlippedEntityEvent on_player_flipped_entity}.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_rotated_entity Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_rotated_entity Online documentation}
    */
   interface OnPlayerRotatedEntityEvent extends EventData {
     /**
@@ -3083,7 +3139,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a player selects an area with a selection-tool item.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_selected_area Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_selected_area Online documentation}
    */
   interface OnPlayerSelectedAreaEvent extends EventData {
     /**
@@ -3125,7 +3181,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player sets a quickbar slot to anything (new value, or set to empty).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_set_quick_bar_slot Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_set_quick_bar_slot Online documentation}
    */
   interface OnPlayerSetQuickBarSlotEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -3140,7 +3196,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player selects an area with a blueprint.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_setup_blueprint Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_setup_blueprint Online documentation}
    */
   interface OnPlayerSetupBlueprintEvent extends EventData {
     /**
@@ -3188,9 +3244,51 @@ declare module "factorio:runtime" {
      */
     readonly tick: MapTick
   }
+  /**
+   * Called after a player super-forced-selects an area with a selection-tool item.
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_super_forced_selected_area Online documentation}
+   */
+  interface OnPlayerSuperForcedSelectedAreaEvent extends EventData {
+    /**
+     * The player doing the selection.
+     */
+    readonly player_index: PlayerIndex
+    /**
+     * The surface selected.
+     */
+    readonly surface: LuaSurface
+    /**
+     * The area selected.
+     */
+    readonly area: BoundingBox
+    /**
+     * The item used to select the area.
+     */
+    readonly item: string
+    /**
+     * The item quality used to select the area.
+     */
+    readonly quality: string
+    /**
+     * The entities selected.
+     */
+    readonly entities: LuaEntity[]
+    /**
+     * The tiles selected.
+     */
+    readonly tiles: LuaTile[]
+    /**
+     * Identifier of the event.
+     */
+    readonly name: typeof defines.events.on_player_super_forced_selected_area
+    /**
+     * Tick the event was generated.
+     */
+    readonly tick: MapTick
+  }
   /**
    * Called when a player toggles alt mode, also known as "show entity info".
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_toggled_alt_mode Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_toggled_alt_mode Online documentation}
    */
   interface OnPlayerToggledAltModeEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -3209,7 +3307,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player toggles the map editor on or off.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_toggled_map_editor Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_toggled_map_editor Online documentation}
    */
   interface OnPlayerToggledMapEditorEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -3224,7 +3322,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a players trash inventory changed in some way.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_trash_inventory_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_trash_inventory_changed Online documentation}
    */
   interface OnPlayerTrashInventoryChangedEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -3239,7 +3337,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player is un-banned.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_unbanned Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_unbanned Online documentation}
    */
   interface OnPlayerUnbannedEvent extends EventData {
     /**
@@ -3269,7 +3367,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player is unmuted.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_unmuted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_unmuted Online documentation}
    */
   interface OnPlayerUnmutedEvent extends EventData {
     /**
@@ -3287,7 +3385,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player uses a capsule that results in some game action.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_used_capsule Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_used_capsule Online documentation}
    */
   interface OnPlayerUsedCapsuleEvent extends EventData {
     /**
@@ -3317,7 +3415,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player uses spidertron remote to send all selected units to a given position
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_player_used_spidertron_remote Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_player_used_spidertron_remote Online documentation}
    */
   interface OnPlayerUsedSpidertronRemoteEvent extends EventData {
     /**
@@ -3341,7 +3439,7 @@ declare module "factorio:runtime" {
    * Called after an entity dies.
    *
    * Event filter: [LuaPostEntityDiedEventFilter](LuaPostEntityDiedEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_post_entity_died Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_post_entity_died Online documentation}
    */
   interface OnPostEntityDiedEvent extends EventData {
     /**
@@ -3393,7 +3491,7 @@ declare module "factorio:runtime" {
    * Called after a segmented unit dies.
    *
    * Event filter: [LuaPostSegmentedUnitDiedEventFilter](LuaPostSegmentedUnitDiedEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_post_segmented_unit_died Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_post_segmented_unit_died Online documentation}
    */
   interface OnPostSegmentedUnitDiedEvent extends EventData {
     /**
@@ -3435,7 +3533,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when players uses an item to build something. Called before {@link OnBuiltEntityEvent on_built_entity}.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_build Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_build Online documentation}
    */
   interface OnPreBuildEvent extends EventData {
     /**
@@ -3481,7 +3579,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called before one or more chunks are deleted using {@link LuaSurface#delete_chunk LuaSurface::delete_chunk}.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_chunk_deleted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_chunk_deleted Online documentation}
    */
   interface OnPreChunkDeletedEvent extends EventData {
     readonly surface_index: SurfaceIndex
@@ -3500,7 +3598,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called before entity copy-paste is done.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_entity_settings_pasted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_entity_settings_pasted Online documentation}
    */
   interface OnPreEntitySettingsPastedEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -3527,7 +3625,7 @@ declare module "factorio:runtime" {
    * Also called for item request proxies before they are destroyed as a result of being marked for deconstruction.
    *
    * Event filter: [LuaPreGhostDeconstructedEventFilter](LuaPreGhostDeconstructedEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_ghost_deconstructed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_ghost_deconstructed Online documentation}
    */
   interface OnPreGhostDeconstructedEvent extends EventData {
     /**
@@ -3548,7 +3646,7 @@ declare module "factorio:runtime" {
    * Called before a ghost entity is upgraded.
    *
    * Event filter: [LuaPreGhostUpgradedEventFilter](LuaPreGhostUpgradedEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_ghost_upgraded Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_ghost_upgraded Online documentation}
    */
   interface OnPreGhostUpgradedEvent extends EventData {
     /**
@@ -3569,7 +3667,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called directly before a permission group is deleted.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_permission_group_deleted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_permission_group_deleted Online documentation}
    */
   interface OnPrePermissionGroupDeletedEvent extends EventData {
     /**
@@ -3591,7 +3689,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called directly before a permission string is imported.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_permission_string_imported Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_permission_string_imported Online documentation}
    */
   interface OnPrePermissionStringImportedEvent extends EventData {
     /**
@@ -3609,7 +3707,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a player queues something to be crafted.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_player_crafted_item Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_player_crafted_item Online documentation}
    */
   interface OnPrePlayerCraftedItemEvent extends EventData {
     /**
@@ -3639,7 +3737,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called before a players dies.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_player_died Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_player_died Online documentation}
    */
   interface OnPrePlayerDiedEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -3655,7 +3753,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called before a player leaves the game.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_player_left_game Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_player_left_game Online documentation}
    */
   interface OnPrePlayerLeftGameEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -3673,7 +3771,7 @@ declare module "factorio:runtime" {
    * Called when the player completes a mining action, but before the entity is potentially removed from the map. This is called even if the entity does not end up being removed.
    *
    * Event filter: [LuaPrePlayerMinedEntityEventFilter](LuaPrePlayerMinedEntityEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_player_mined_item Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_player_mined_item Online documentation}
    */
   interface OnPrePlayerMinedItemEvent extends EventData {
     /**
@@ -3692,7 +3790,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called before a player is removed (deleted) from the game. This is markedly different from a player temporarily {@link OnPlayerLeftGameEvent leaving} the game, and instead behaves like the player never existed in the save file.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_player_removed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_player_removed Online documentation}
    */
   interface OnPrePlayerRemovedEvent extends EventData {
     /**
@@ -3710,7 +3808,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called before a player toggles the map editor on or off.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_player_toggled_map_editor Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_player_toggled_map_editor Online documentation}
    */
   interface OnPrePlayerToggledMapEditorEvent extends EventData {
     readonly player_index: PlayerIndex
@@ -3725,7 +3823,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called directly before a robot explodes cliffs.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_robot_exploded_cliff Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_robot_exploded_cliff Online documentation}
    */
   interface OnPreRobotExplodedCliffEvent extends EventData {
     readonly robot: LuaEntity
@@ -3749,7 +3847,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called just before the scenario finishes.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_scenario_finished Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_scenario_finished Online documentation}
    */
   interface OnPreScenarioFinishedEvent extends EventData {
     /**
@@ -3767,7 +3865,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called just before a script inventory is resized.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_script_inventory_resized Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_script_inventory_resized Online documentation}
    */
   interface OnPreScriptInventoryResizedEvent extends EventData {
     /**
@@ -3798,7 +3896,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called just before a surface is cleared (all entities removed and all chunks deleted).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_surface_cleared Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_surface_cleared Online documentation}
    */
   interface OnPreSurfaceClearedEvent extends EventData {
     readonly surface_index: SurfaceIndex
@@ -3813,7 +3911,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called just before a surface is deleted.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_pre_surface_deleted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_pre_surface_deleted Online documentation}
    */
   interface OnPreSurfaceDeletedEvent extends EventData {
     readonly surface_index: SurfaceIndex
@@ -3828,7 +3926,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when the player triggers "redo".
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_redo_applied Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_redo_applied Online documentation}
    */
   interface OnRedoAppliedEvent extends EventData {
     /**
@@ -3850,7 +3948,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when research is cancelled.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_research_cancelled Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_research_cancelled Online documentation}
    */
   interface OnResearchCancelledEvent extends EventData {
     /**
@@ -3876,7 +3974,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a research finishes.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_research_finished Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_research_finished Online documentation}
    */
   interface OnResearchFinishedEvent extends EventData {
     /**
@@ -3898,7 +3996,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when research is moved forwards or backwards in the research queue.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_research_moved Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_research_moved Online documentation}
    */
   interface OnResearchMovedEvent extends EventData {
     /**
@@ -3920,7 +4018,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when research is queued.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_research_queued Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_research_queued Online documentation}
    */
   interface OnResearchQueuedEvent extends EventData {
     /**
@@ -3946,7 +4044,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a research is reversed (unresearched).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_research_reversed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_research_reversed Online documentation}
    */
   interface OnResearchReversedEvent extends EventData {
     /**
@@ -3968,7 +4066,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a technology research starts.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_research_started Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_research_started Online documentation}
    */
   interface OnResearchStartedEvent extends EventData {
     /**
@@ -3987,7 +4085,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a resource entity reaches 0 or its minimum yield for infinite resources.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_resource_depleted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_resource_depleted Online documentation}
    */
   interface OnResourceDepletedEvent extends EventData {
     readonly entity: LuaEntity
@@ -4004,7 +4102,7 @@ declare module "factorio:runtime" {
    * Called when a construction robot builds an entity.
    *
    * Event filter: [LuaRobotBuiltEntityEventFilter](LuaRobotBuiltEntityEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_robot_built_entity Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_robot_built_entity Online documentation}
    */
   interface OnRobotBuiltEntityEvent extends EventData {
     /**
@@ -4034,7 +4132,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a robot builds tiles.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_robot_built_tile Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_robot_built_tile Online documentation}
    */
   interface OnRobotBuiltTileEvent extends EventData {
     /**
@@ -4076,7 +4174,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called directly after a robot explodes cliffs.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_robot_exploded_cliff Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_robot_exploded_cliff Online documentation}
    */
   interface OnRobotExplodedCliffEvent extends EventData {
     readonly robot: LuaEntity
@@ -4099,7 +4197,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a robot mines an entity.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_robot_mined Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_robot_mined Online documentation}
    */
   interface OnRobotMinedEvent extends EventData {
     /**
@@ -4127,7 +4225,7 @@ declare module "factorio:runtime" {
    * The buffer inventory is special in that it's only valid during this event and has a dynamic size expanding as more items are transferred into it.
    *
    * Event filter: [LuaRobotMinedEntityEventFilter](LuaRobotMinedEntityEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_robot_mined_entity Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_robot_mined_entity Online documentation}
    */
   interface OnRobotMinedEntityEvent extends EventData {
     /**
@@ -4153,7 +4251,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a robot mines tiles.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_robot_mined_tile Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_robot_mined_tile Online documentation}
    */
   interface OnRobotMinedTileEvent extends EventData {
     /**
@@ -4181,7 +4279,7 @@ declare module "factorio:runtime" {
    * Called before a robot mines an entity.
    *
    * Event filter: [LuaPreRobotMinedEntityEventFilter](LuaPreRobotMinedEntityEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_robot_pre_mined Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_robot_pre_mined Online documentation}
    */
   interface OnRobotPreMinedEvent extends EventData {
     /**
@@ -4203,7 +4301,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a rocket silo is ordered to be launched.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_rocket_launch_ordered Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_rocket_launch_ordered Online documentation}
    */
   interface OnRocketLaunchOrderedEvent extends EventData {
     readonly rocket: LuaEntity
@@ -4223,7 +4321,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a rocket finishes ascending. (Triggers listening for finished rocket launch past 2.0 have been moved to 'on_cargo_pod_finished_ascending' as rocket and cargo pod are two separate entities)
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_rocket_launched Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_rocket_launched Online documentation}
    */
   interface OnRocketLaunchedEvent extends EventData {
     readonly rocket: LuaEntity
@@ -4239,7 +4337,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a runtime mod setting is changed by a player.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_runtime_mod_setting_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_runtime_mod_setting_changed Online documentation}
    */
   interface OnRuntimeModSettingChangedEvent extends EventData {
     /**
@@ -4262,7 +4360,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called just after a script inventory is resized.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_script_inventory_resized Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_script_inventory_resized Online documentation}
    */
   interface OnScriptInventoryResizedEvent extends EventData {
     /**
@@ -4297,7 +4395,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a {@link LuaSurface#request_path LuaSurface::request_path} call completes.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_script_path_request_finished Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_script_path_request_finished Online documentation}
    */
   interface OnScriptPathRequestFinishedEvent extends EventData {
     /**
@@ -4323,7 +4421,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a script trigger effect is triggered.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_script_trigger_effect Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_script_trigger_effect Online documentation}
    */
   interface OnScriptTriggerEffectEvent extends EventData {
     /**
@@ -4356,7 +4454,7 @@ declare module "factorio:runtime" {
    * Called when an entity of type `radar` finishes scanning a sector.
    *
    * Event filter: [LuaSectorScannedEventFilter](LuaSectorScannedEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_sector_scanned Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_sector_scanned Online documentation}
    */
   interface OnSectorScannedEvent extends EventData {
     /**
@@ -4382,7 +4480,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when an individual segment of a SegmentedUnit is created.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_segment_entity_created Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_segment_entity_created Online documentation}
    */
   interface OnSegmentEntityCreatedEvent extends EventData {
     readonly entity: LuaEntity
@@ -4399,7 +4497,7 @@ declare module "factorio:runtime" {
    * Called when a segmented unit is created for any reason.
    *
    * Event filter: [LuaSegmentedUnitCreatedEventFilter](LuaSegmentedUnitCreatedEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_segmented_unit_created Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_segmented_unit_created Online documentation}
    */
   interface OnSegmentedUnitCreatedEvent extends EventData {
     /**
@@ -4427,7 +4525,7 @@ declare module "factorio:runtime" {
    * Called when a segmented unit is damaged. This is not called when a segmented unit's health is set directly by another mod.
    *
    * Event filter: [LuaSegmentedUnitDamagedEventFilter](LuaSegmentedUnitDamagedEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_segmented_unit_damaged Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_segmented_unit_damaged Online documentation}
    */
   interface OnSegmentedUnitDamagedEvent extends EventData {
     readonly segmented_unit: LuaSegmentedUnit
@@ -4469,7 +4567,7 @@ declare module "factorio:runtime" {
    * Called when a segmented unit dies.
    *
    * Event filter: [LuaSegmentedUnitDiedEventFilter](LuaSegmentedUnitDiedEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_segmented_unit_died Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_segmented_unit_died Online documentation}
    */
   interface OnSegmentedUnitDiedEvent extends EventData {
     /**
@@ -4499,7 +4597,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after the selected entity changes for a given player.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_selected_entity_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_selected_entity_changed Online documentation}
    */
   interface OnSelectedEntityChangedEvent extends EventData {
     /**
@@ -4521,7 +4619,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when {@link LuaGameScript#is_multiplayer LuaGameScript::is_multiplayer} changes to false. May also be raised when it was already false but a game was loaded from a save file without hosting.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_singleplayer_init Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_singleplayer_init Online documentation}
    */
   interface OnSingleplayerInitEvent extends EventData {
     /**
@@ -4537,7 +4635,7 @@ declare module "factorio:runtime" {
    * Called when a space platform builds an entity.
    *
    * Event filter: [LuaPlatformBuiltEntityEventFilter](LuaPlatformBuiltEntityEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_space_platform_built_entity Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_space_platform_built_entity Online documentation}
    */
   interface OnSpacePlatformBuiltEntityEvent extends EventData {
     /**
@@ -4567,7 +4665,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a space platform builds tiles.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_space_platform_built_tile Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_space_platform_built_tile Online documentation}
    */
   interface OnSpacePlatformBuiltTileEvent extends EventData {
     /**
@@ -4609,7 +4707,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a space platform changes state
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_space_platform_changed_state Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_space_platform_changed_state Online documentation}
    */
   interface OnSpacePlatformChangedStateEvent extends EventData {
     readonly platform: LuaSpacePlatform
@@ -4631,7 +4729,7 @@ declare module "factorio:runtime" {
    * The buffer inventory is special in that it's only valid during this event and has a dynamic size expanding as more items are transferred into it.
    *
    * Event filter: [LuaPlatformMinedEntityEventFilter](LuaPlatformMinedEntityEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_space_platform_mined_entity Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_space_platform_mined_entity Online documentation}
    */
   interface OnSpacePlatformMinedEntityEvent extends EventData {
     /**
@@ -4657,7 +4755,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a platform mines an entity.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_space_platform_mined_item Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_space_platform_mined_item Online documentation}
    */
   interface OnSpacePlatformMinedItemEvent extends EventData {
     /**
@@ -4679,7 +4777,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a platform mines tiles.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_space_platform_mined_tile Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_space_platform_mined_tile Online documentation}
    */
   interface OnSpacePlatformMinedTileEvent extends EventData {
     /**
@@ -4707,7 +4805,7 @@ declare module "factorio:runtime" {
    * Called before a platform mines an entity.
    *
    * Event filter: [LuaPrePlatformMinedEntityEventFilter](LuaPrePlatformMinedEntityEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_space_platform_pre_mined Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_space_platform_pre_mined Online documentation}
    */
   interface OnSpacePlatformPreMinedEvent extends EventData {
     /**
@@ -4729,7 +4827,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a spider finishes moving to its autopilot position.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_spider_command_completed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_spider_command_completed Online documentation}
    */
   interface OnSpiderCommandCompletedEvent extends EventData {
     /**
@@ -4747,7 +4845,7 @@ declare module "factorio:runtime" {
   }
   /**
    * 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/2.1.7/events.html#on_string_translated Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_string_translated Online documentation}
    */
   interface OnStringTranslatedEvent extends EventData {
     /**
@@ -4781,7 +4879,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called just after a surface is cleared (all entities removed and all chunks deleted).
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_surface_cleared Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_surface_cleared Online documentation}
    */
   interface OnSurfaceClearedEvent extends EventData {
     readonly surface_index: SurfaceIndex
@@ -4798,7 +4896,7 @@ declare module "factorio:runtime" {
    * Called when a surface is created.
    *
    * This is not called when the default surface is created as it will always exist.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_surface_created Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_surface_created Online documentation}
    */
   interface OnSurfaceCreatedEvent extends EventData {
     readonly surface_index: SurfaceIndex
@@ -4813,7 +4911,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a surface is deleted.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_surface_deleted Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_surface_deleted Online documentation}
    */
   interface OnSurfaceDeletedEvent extends EventData {
     readonly surface_index: SurfaceIndex
@@ -4828,7 +4926,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called after a surface is imported via the map editor.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_surface_imported Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_surface_imported Online documentation}
    */
   interface OnSurfaceImportedEvent extends EventData {
     readonly surface_index: SurfaceIndex
@@ -4847,7 +4945,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a surface is renamed.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_surface_renamed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_surface_renamed Online documentation}
    */
   interface OnSurfaceRenamedEvent extends EventData {
     readonly surface_index: SurfaceIndex
@@ -4864,7 +4962,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when {@link LuaForce#reset_technology_effects LuaForce::reset_technology_effects} is finished.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_technology_effects_reset Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_technology_effects_reset Online documentation}
    */
   interface OnTechnologyEffectsResetEvent extends EventData {
     readonly force: LuaForce
@@ -4879,7 +4977,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a territory is created for any reason.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_territory_created Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_territory_created Online documentation}
    */
   interface OnTerritoryCreatedEvent extends EventData {
     /**
@@ -4901,7 +4999,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a territory is destroyed from a surface.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_territory_destroyed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_territory_destroyed Online documentation}
    */
   interface OnTerritoryDestroyedEvent extends EventData {
     /**
@@ -4919,7 +5017,7 @@ declare module "factorio:runtime" {
   }
   /**
    * It is fired once every tick. Since this event is fired every tick, its handler shouldn't include performance heavy code.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_tick Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_tick Online documentation}
    */
   interface OnTickEvent extends EventData {
     /**
@@ -4937,7 +5035,7 @@ declare module "factorio:runtime" {
    * After this event any items in the buffer will be transferred into the tower as if they came from mining the entity.
    *
    * The buffer inventory is special in that it's only valid during this event and has a dynamic size expanding as more items are transferred into it.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_tower_mined_plant Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_tower_mined_plant Online documentation}
    */
   interface OnTowerMinedPlantEvent extends EventData {
     /**
@@ -4963,7 +5061,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called before an agricultural tower plants a seed.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_tower_planted_seed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_tower_planted_seed Online documentation}
    */
   interface OnTowerPlantedSeedEvent extends EventData {
     /**
@@ -4989,7 +5087,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called before an agricultural tower mines a plant.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_tower_pre_mined_plant Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_tower_pre_mined_plant Online documentation}
    */
   interface OnTowerPreMinedPlantEvent extends EventData {
     /**
@@ -5011,7 +5109,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a train changes state (started to stopped and vice versa)
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_train_changed_state Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_train_changed_state Online documentation}
    */
   interface OnTrainChangedStateEvent extends EventData {
     readonly train: LuaTrain
@@ -5027,7 +5125,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a new train is created either through disconnecting/connecting an existing one or building a new one.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_train_created Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_train_created Online documentation}
    */
   interface OnTrainCreatedEvent extends EventData {
     readonly train: LuaTrain
@@ -5050,7 +5148,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a trains schedule is changed either by the player or through script.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_train_schedule_changed Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_train_schedule_changed Online documentation}
    */
   interface OnTrainScheduleChangedEvent extends EventData {
     readonly train: LuaTrain
@@ -5069,7 +5167,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when an entity with a trigger prototype (such as capsules) create an entity AND that trigger prototype defined `trigger_created_entity=true`.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_trigger_created_entity Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_trigger_created_entity Online documentation}
    */
   interface OnTriggerCreatedEntityEvent extends EventData {
     readonly entity: LuaEntity
@@ -5085,7 +5183,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when an entity with a trigger prototype (such as capsules) fire an artillery projectile AND that trigger prototype defined `trigger_fired_artillery=true`.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_trigger_fired_artillery Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_trigger_fired_artillery Online documentation}
    */
   interface OnTriggerFiredArtilleryEvent extends EventData {
     readonly entity: LuaEntity
@@ -5101,7 +5199,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when new packets are processed by {@link LuaHelpers#recv_udp LuaHelpers::recv_udp}.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_udp_packet_received Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_udp_packet_received Online documentation}
    */
   interface OnUdpPacketReceivedEvent extends EventData {
     /**
@@ -5127,7 +5225,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when the player triggers "undo".
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_undo_applied Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_undo_applied Online documentation}
    */
   interface OnUndoAppliedEvent extends EventData {
     /**
@@ -5149,7 +5247,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a unit is added to a unit group.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_unit_added_to_group Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_unit_added_to_group Online documentation}
    */
   interface OnUnitAddedToGroupEvent extends EventData {
     readonly unit: LuaEntity
@@ -5165,7 +5263,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a new unit group is created, before any members are added to it.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_unit_group_created Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_unit_group_created Online documentation}
    */
   interface OnUnitGroupCreatedEvent extends EventData {
     readonly group: LuaCommandable
@@ -5180,7 +5278,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a unit group finishes gathering and starts executing its command.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_unit_group_finished_gathering Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_unit_group_finished_gathering Online documentation}
    */
   interface OnUnitGroupFinishedGatheringEvent extends EventData {
     readonly group: LuaCommandable
@@ -5195,7 +5293,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a unit is removed from a unit group.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_unit_removed_from_group Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_unit_removed_from_group Online documentation}
    */
   interface OnUnitRemovedFromGroupEvent extends EventData {
     readonly unit: LuaEntity
@@ -5211,7 +5309,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Called when a worker (construction or logistic) robot expires through a lack of energy.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#on_worker_robot_expired Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#on_worker_robot_expired Online documentation}
    */
   interface OnWorkerRobotExpiredEvent extends EventData {
     readonly robot: LuaEntity
@@ -5228,7 +5326,7 @@ declare module "factorio:runtime" {
    * A static event mods can use to tell other mods they built 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_built LuaBootstrap::raise_script_built}, or when `raise_built` is passed to {@link LuaSurface#create_entity LuaSurface::create_entity}.
    *
    * Event filter: [LuaScriptRaisedBuiltEventFilter](LuaScriptRaisedBuiltEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#script_raised_built Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#script_raised_built Online documentation}
    */
   interface ScriptRaisedBuiltEvent extends EventData {
     /**
@@ -5248,7 +5346,7 @@ declare module "factorio:runtime" {
    * A static event mods can use to tell other mods they destroyed 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_destroy LuaBootstrap::raise_script_destroy}, or when `raise_destroy` is passed to {@link LuaEntity#destroy LuaEntity::destroy}.
    *
    * Event filter: [LuaScriptRaisedDestroyEventFilter](LuaScriptRaisedDestroyEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#script_raised_destroy Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#script_raised_destroy Online documentation}
    */
   interface ScriptRaisedDestroyEvent extends EventData {
     /**
@@ -5268,7 +5366,7 @@ declare module "factorio:runtime" {
    * A static event that mods can use to tell other mods they destroyed a segmented unit 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_destroy_segmented_unit LuaBootstrap::raise_script_destroy_segmented_unit}, or when `raise_destroy` is passed to {@link LuaSegmentedUnit#destroy LuaSegmentedUnit::destroy}.
    *
    * Event filter: [LuaScriptRaisedDestroySegmentedUnitEventFilter](LuaScriptRaisedDestroySegmentedUnitEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#script_raised_destroy_segmented_unit Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#script_raised_destroy_segmented_unit Online documentation}
    */
   interface ScriptRaisedDestroySegmentedUnitEvent extends EventData {
     /**
@@ -5288,7 +5386,7 @@ declare module "factorio:runtime" {
    * A static event mods can use to tell other mods they revived 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_revive LuaBootstrap::raise_script_revive}, or when `raise_revive` is passed to {@link LuaEntity#revive LuaEntity::revive}.
    *
    * Event filter: [LuaScriptRaisedReviveEventFilter](LuaScriptRaisedReviveEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#script_raised_revive Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#script_raised_revive Online documentation}
    */
   interface ScriptRaisedReviveEvent extends EventData {
     /**
@@ -5310,7 +5408,7 @@ declare module "factorio:runtime" {
   }
   /**
    * A static event mods can use to tell other mods they changed tiles on a surface 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_set_tiles LuaBootstrap::raise_script_set_tiles}, or when `raise_event` is passed to {@link LuaSurface#set_tiles LuaSurface::set_tiles}.
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#script_raised_set_tiles Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#script_raised_set_tiles Online documentation}
    */
   interface ScriptRaisedSetTilesEvent extends EventData {
     /**
@@ -5334,7 +5432,7 @@ declare module "factorio:runtime" {
    * 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}.
    *
    * Event filter: [LuaScriptRaisedTeleportedEventFilter](LuaScriptRaisedTeleportedEventFilter]
-   * @see {@link https://lua-api.factorio.com/2.1.7/events.html#script_raised_teleported Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.1.21/events.html#script_raised_teleported Online documentation}
    */
   interface ScriptRaisedTeleportedEvent extends EventData {
     /**