typed-factorio 1.4.0 → 1.5.0

package/generated/events.d.ts

@@ -4,8 +4,7 @@
 
 /**
  * Called when a {@linkplain https://wiki.factorio.com/Prototype/CustomInput CustomInput} is activated.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#CustomInputEvent View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#CustomInputEvent Online documentation}
  */
 interface CustomInputEvent extends EventData {
   /**
@@ -19,7 +18,7 @@ interface CustomInputEvent extends EventData {
   /**
    * The mouse cursor position when the custom input was activated.
    */
-  readonly cursor_position: MapPositionTable
+  readonly cursor_position: MapPosition
   /**
    * Information about the prototype that is selected when the custom input is used. Needs to be enabled on the custom input's prototype. `nil` if none is selected.
    */
@@ -36,8 +35,7 @@ interface CustomInputEvent extends EventData {
 
 /**
  * Called when a unit/group completes a command.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_ai_command_completed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_ai_command_completed Online documentation}
  */
 interface OnAiCommandCompletedEvent extends EventData {
   /**
@@ -61,14 +59,13 @@ interface OnAiCommandCompletedEvent extends EventData {
 
 /**
  * Called when an area of the map is cloned.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_area_cloned View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_area_cloned Online documentation}
  */
 interface OnAreaClonedEvent extends EventData {
   readonly source_surface: LuaSurface
-  readonly source_area: BoundingBoxRead
+  readonly source_area: BoundingBox
   readonly destination_surface: LuaSurface
-  readonly destination_area: BoundingBoxRead
+  readonly destination_area: BoundingBox
   readonly destination_force?: LuaForce
   readonly clone_tiles: boolean
   readonly clone_entities: boolean
@@ -87,12 +84,8 @@ interface OnAreaClonedEvent extends EventData {
 
 /**
  * Called when a biter migration builds a base.
- *
- * **Note**
- *
- * This will be called multiple times for each migration, once for every biter that is sacrificed to build part of the new base.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_biter_base_built View documentation}
+ * @remarks 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/latest/events.html#on_biter_base_built Online documentation}
  */
 interface OnBiterBaseBuiltEvent extends EventData {
   /**
@@ -111,14 +104,13 @@ interface OnBiterBaseBuiltEvent extends EventData {
 
 /**
  * Called when a set of positions on the map is cloned.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_brush_cloned View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_brush_cloned Online documentation}
  */
 interface OnBrushClonedEvent extends EventData {
-  readonly source_offset: TilePositionTable
-  readonly destination_offset: TilePositionTable
+  readonly source_offset: TilePosition
+  readonly destination_offset: TilePosition
   readonly source_surface: LuaSurface
-  readonly source_positions: TilePositionTable[]
+  readonly source_positions: TilePosition[]
   readonly destination_surface: LuaSurface
   readonly destination_force?: LuaForce
   readonly clone_tiles: boolean
@@ -138,8 +130,7 @@ interface OnBrushClonedEvent extends EventData {
 
 /**
  * Called when a {@link defines.command.build_base} command reaches its destination, and before building starts.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_build_base_arrived View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_build_base_arrived Online documentation}
  */
 interface OnBuildBaseArrivedEvent extends EventData {
   /**
@@ -162,8 +153,7 @@ interface OnBuildBaseArrivedEvent extends EventData {
 
 /**
  * Called when player builds something. Can be filtered using {@link LuaPlayerBuiltEntityEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_built_entity View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_built_entity Online documentation}
  */
 interface OnBuiltEntityEvent extends EventData {
   readonly created_entity: LuaEntity
@@ -189,8 +179,7 @@ interface OnBuiltEntityEvent extends EventData {
 
 /**
  * Called when the deconstruction of an entity is canceled. Can be filtered using {@link LuaEntityDeconstructionCancelledEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_cancelled_deconstruction View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_cancelled_deconstruction Online documentation}
  */
 interface OnCancelledDeconstructionEvent extends EventData {
   readonly entity: LuaEntity
@@ -207,8 +196,7 @@ interface OnCancelledDeconstructionEvent extends EventData {
 
 /**
  * Called when the upgrade of an entity is canceled. Can be filtered using {@link LuaUpgradeCancelledEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_cancelled_upgrade View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_cancelled_upgrade Online documentation}
  */
 interface OnCancelledUpgradeEvent extends EventData {
   readonly entity: LuaEntity
@@ -225,12 +213,8 @@ interface OnCancelledUpgradeEvent extends EventData {
 
 /**
  * Called when a character corpse expires due to timeout or all of the items being removed from it.
- *
- * **Note**
- *
- * this is not called if the corpse is mined. See {@link defines.events.on_pre_player_mined_item} to detect that.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_character_corpse_expired View documentation}
+ * @remarks 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/latest/events.html#on_character_corpse_expired Online documentation}
  */
 interface OnCharacterCorpseExpiredEvent extends EventData {
   /**
@@ -249,8 +233,7 @@ interface OnCharacterCorpseExpiredEvent extends EventData {
 
 /**
  * Called when a chart tag is created.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_chart_tag_added View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_chart_tag_added Online documentation}
  */
 interface OnChartTagAddedEvent extends EventData {
   readonly tag: LuaCustomChartTag
@@ -268,8 +251,7 @@ interface OnChartTagAddedEvent extends EventData {
 
 /**
  * Called when a chart tag is modified by a player.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_chart_tag_modified View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_chart_tag_modified Online documentation}
  */
 interface OnChartTagModifiedEvent extends EventData {
   readonly tag: LuaCustomChartTag
@@ -290,8 +272,7 @@ interface OnChartTagModifiedEvent extends EventData {
 
 /**
  * Called just before a chart tag is deleted.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_chart_tag_removed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_chart_tag_removed Online documentation}
  */
 interface OnChartTagRemovedEvent extends EventData {
   readonly tag: LuaCustomChartTag
@@ -309,16 +290,15 @@ interface OnChartTagRemovedEvent extends EventData {
 
 /**
  * Called when a chunk is charted or re-charted.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_chunk_charted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_chunk_charted Online documentation}
  */
 interface OnChunkChartedEvent extends EventData {
   readonly surface_index: SurfaceIndex
-  readonly position: ChunkPositionTable
+  readonly position: ChunkPosition
   /**
    * Area of the chunk.
    */
-  readonly area: BoundingBoxRead
+  readonly area: BoundingBox
   readonly force: LuaForce
   /**
    * Identifier of the event
@@ -332,15 +312,14 @@ interface OnChunkChartedEvent extends EventData {
 
 /**
  * Called when one or more chunks are deleted using {@link LuaSurface#delete_chunk LuaSurface::delete_chunk}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_chunk_deleted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_chunk_deleted Online documentation}
  */
 interface OnChunkDeletedEvent extends EventData {
   readonly surface_index: SurfaceIndex
   /**
    * The chunks deleted.
    */
-  readonly positions: ChunkPositionTable[]
+  readonly positions: ChunkPosition[]
   /**
    * Identifier of the event
    */
@@ -353,18 +332,17 @@ interface OnChunkDeletedEvent extends EventData {
 
 /**
  * Called when a chunk is generated.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_chunk_generated View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_chunk_generated Online documentation}
  */
 interface OnChunkGeneratedEvent extends EventData {
   /**
    * Area of the chunk.
    */
-  readonly area: BoundingBoxRead
+  readonly area: BoundingBox
   /**
    * Position of the chunk.
    */
-  readonly position: ChunkPositionTable
+  readonly position: ChunkPosition
   /**
    * The surface the chunk is on.
    */
@@ -381,8 +359,7 @@ interface OnChunkGeneratedEvent extends EventData {
 
 /**
  * Called when a combat robot expires through a lack of energy, or timeout.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_combat_robot_expired View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_combat_robot_expired Online documentation}
  */
 interface OnCombatRobotExpiredEvent extends EventData {
   readonly robot: LuaEntity
@@ -402,12 +379,8 @@ interface OnCombatRobotExpiredEvent extends EventData {
 
 /**
  * Called when a message is sent to the in-game console, either by a player or through the server interface.
- *
- * **Note**
- *
- * This event only fires for plain messages, not for any commands (including `/shout` or `/whisper`).
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_console_chat View documentation}
+ * @remarks This event only fires for plain messages, not for any commands (including `/shout` or `/whisper`).
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_console_chat Online documentation}
  */
 interface OnConsoleChatEvent extends EventData {
   /**
@@ -430,8 +403,7 @@ interface OnConsoleChatEvent extends EventData {
 
 /**
  * Called when someone enters a command-like message regardless of it being a valid command.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_console_command View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_console_command Online documentation}
  */
 interface OnConsoleCommandEvent extends EventData {
   /**
@@ -458,8 +430,7 @@ interface OnConsoleCommandEvent extends EventData {
 
 /**
  * Called when a cutscene is cancelled by the player or by script.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_cutscene_cancelled View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_cutscene_cancelled Online documentation}
  */
 interface OnCutsceneCancelledEvent extends EventData {
   /**
@@ -480,12 +451,8 @@ interface OnCutsceneCancelledEvent extends EventData {
  * 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.
- *
- * **Note**
- *
- * Due to implementation omission, waypoint_index is 0-based.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_cutscene_waypoint_reached View documentation}
+ * @remarks Due to implementation omission, waypoint_index is 0-based.
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_cutscene_waypoint_reached Online documentation}
  */
 interface OnCutsceneWaypointReachedEvent extends EventData {
   /**
@@ -508,12 +475,8 @@ interface OnCutsceneWaypointReachedEvent extends EventData {
 
 /**
  * Called when the map difficulty settings are changed.
- *
- * **Note**
- *
- * It's not guaranteed that both settings are changed - just that at least one has been changed.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_difficulty_settings_changed View documentation}
+ * @remarks It's not guaranteed that both settings are changed - just that at least one has been changed.
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_difficulty_settings_changed Online documentation}
  */
 interface OnDifficultySettingsChangedEvent extends EventData {
   readonly old_recipe_difficulty: uint
@@ -530,8 +493,7 @@ interface OnDifficultySettingsChangedEvent extends EventData {
 
 /**
  * Called when an entity is cloned. Can be filtered for the source entity using {@link LuaEntityClonedEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_entity_cloned View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_entity_cloned Online documentation}
  */
 interface OnEntityClonedEvent extends EventData {
   readonly source: LuaEntity
@@ -548,12 +510,8 @@ interface OnEntityClonedEvent extends EventData {
 
 /**
  * Called when an entity is damaged. Can be filtered using {@link LuaEntityDamagedEventFilter}.
- *
- * **Note**
- *
- * This is not called when an entities health is set directly by another mod.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_entity_damaged View documentation}
+ * @remarks This is not called when an entities health is set directly by another mod.
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_entity_damaged Online documentation}
  */
 interface OnEntityDamagedEvent extends EventData {
   readonly entity: LuaEntity
@@ -590,12 +548,8 @@ interface OnEntityDamagedEvent extends EventData {
 
 /**
  * Called after an entity is destroyed that has been registered with {@link LuaBootstrap#register_on_entity_destroyed LuaBootstrap::register_on_entity_destroyed}.
- *
- * **Note**
- *
- * Depending on when a given entity is destroyed, this event will be fired at the end of the current tick or at the end of the next tick.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_entity_destroyed View documentation}
+ * @remarks Depending on when a given entity is destroyed, this event will be fired at the end of the current tick or at the end of the next tick.
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_entity_destroyed Online documentation}
  */
 interface OnEntityDestroyedEvent extends EventData {
   /**
@@ -618,8 +572,7 @@ interface OnEntityDestroyedEvent extends EventData {
 
 /**
  * Called when an entity dies. Can be filtered using {@link LuaEntityDiedEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_entity_died View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_entity_died Online documentation}
  */
 interface OnEntityDiedEvent extends EventData {
   /**
@@ -654,12 +607,8 @@ interface OnEntityDiedEvent extends EventData {
 
 /**
  * Called when one of an entity's personal logistic slots changes.
- *
- * **Note**
- *
- * "Personal logistic slot" refers to a character or vehicle's personal request / auto-trash slots, not the request slots on logistic chests.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_entity_logistic_slot_changed View documentation}
+ * @remarks "Personal logistic slot" refers to a character or vehicle's personal request / auto-trash slots, not the request slots on logistic chests.
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_entity_logistic_slot_changed Online documentation}
  */
 interface OnEntityLogisticSlotChangedEvent extends EventData {
   /**
@@ -686,8 +635,7 @@ interface OnEntityLogisticSlotChangedEvent extends EventData {
 
 /**
  * Called after an entity has been renamed either by the player or through script.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_entity_renamed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_entity_renamed Online documentation}
  */
 interface OnEntityRenamedEvent extends EventData {
   /**
@@ -709,8 +657,7 @@ interface OnEntityRenamedEvent extends EventData {
 
 /**
  * Called after entity copy-paste is done.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_entity_settings_pasted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_entity_settings_pasted Online documentation}
  */
 interface OnEntitySettingsPastedEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -734,8 +681,7 @@ interface OnEntitySettingsPastedEvent extends EventData {
 
 /**
  * Called when an entity is spawned by a EnemySpawner
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_entity_spawned View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_entity_spawned Online documentation}
  */
 interface OnEntitySpawnedEvent extends EventData {
   readonly spawner: LuaEntity
@@ -752,8 +698,7 @@ interface OnEntitySpawnedEvent extends EventData {
 
 /**
  * Called after equipment is inserted into an equipment grid.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_equipment_inserted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_equipment_inserted Online documentation}
  */
 interface OnEquipmentInsertedEvent extends EventData {
   /**
@@ -776,8 +721,7 @@ interface OnEquipmentInsertedEvent extends EventData {
 
 /**
  * Called after equipment is removed from an equipment grid.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_equipment_removed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_equipment_removed Online documentation}
  */
 interface OnEquipmentRemovedEvent extends EventData {
   /**
@@ -804,8 +748,7 @@ interface OnEquipmentRemovedEvent extends EventData {
 
 /**
  * Called when the a forces cease fire values change.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_force_cease_fire_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_force_cease_fire_changed Online documentation}
  */
 interface OnForceCeaseFireChangedEvent extends EventData {
   /**
@@ -832,12 +775,8 @@ interface OnForceCeaseFireChangedEvent extends EventData {
 
 /**
  * Called when a new force is created using `game.create_force()`
- *
- * **Note**
- *
- * This is not called when the default forces (`'player'`, `'enemy'`, `'neutral'`) are created as they will always exist.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_force_created View documentation}
+ * @remarks 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/latest/events.html#on_force_created Online documentation}
  */
 interface OnForceCreatedEvent extends EventData {
   /**
@@ -856,8 +795,7 @@ interface OnForceCreatedEvent extends EventData {
 
 /**
  * Called when the a forces friends change.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_force_friends_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_force_friends_changed Online documentation}
  */
 interface OnForceFriendsChangedEvent extends EventData {
   /**
@@ -884,8 +822,7 @@ interface OnForceFriendsChangedEvent extends EventData {
 
 /**
  * Called when {@link LuaForce#reset LuaForce::reset} is finished.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_force_reset View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_force_reset Online documentation}
  */
 interface OnForceResetEvent extends EventData {
   readonly force: LuaForce
@@ -901,12 +838,8 @@ interface OnForceResetEvent extends EventData {
 
 /**
  * Called after two forces have been merged using `game.merge_forces()`.
- *
- * **Note**
- *
- * The source force is invalidated before this event is called and the name can be re-used in this event if desired.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_forces_merged View documentation}
+ * @remarks 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/latest/events.html#on_forces_merged Online documentation}
  */
 interface OnForcesMergedEvent extends EventData {
   /**
@@ -933,8 +866,7 @@ interface OnForcesMergedEvent extends EventData {
 
 /**
  * Called when two forces are about to be merged using `game.merge_forces()`.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_forces_merging View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_forces_merging Online documentation}
  */
 interface OnForcesMergingEvent extends EventData {
   /**
@@ -957,12 +889,8 @@ interface OnForcesMergingEvent extends EventData {
 
 /**
  * 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.
- *
- * **Note**
- *
- * This event is not fired when the scenario is loaded via the map editor.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_game_created_from_scenario View documentation}
+ * @remarks This event is not fired when the scenario is loaded via the map editor.
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_game_created_from_scenario Online documentation}
  */
 interface OnGameCreatedFromScenarioEvent extends EventData {
   /**
@@ -977,8 +905,7 @@ interface OnGameCreatedFromScenarioEvent extends EventData {
 
 /**
  * Called when {@link LuaGuiElement} checked state is changed (related to checkboxes and radio buttons).
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_gui_checked_state_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_gui_checked_state_changed Online documentation}
  */
 interface OnGuiCheckedStateChangedEvent extends EventData {
   /**
@@ -1001,8 +928,7 @@ interface OnGuiCheckedStateChangedEvent extends EventData {
 
 /**
  * Called when {@link LuaGuiElement} is clicked.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_gui_click View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_gui_click Online documentation}
  */
 interface OnGuiClickEvent extends EventData {
   /**
@@ -1043,12 +969,8 @@ interface OnGuiClickEvent extends EventData {
  * Called when the player closes the GUI they have open.
  *
  * 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.
- *
- * **Note**
- *
- * 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.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_gui_closed View documentation}
+ * @remarks 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/latest/events.html#on_gui_closed Online documentation}
  */
 interface OnGuiClosedEvent extends EventData {
   /**
@@ -1086,7 +1008,11 @@ interface OnGuiClosedEvent extends EventData {
   /**
    * The tile position that was open
    */
-  readonly tile_position?: TilePositionTable
+  readonly tile_position?: TilePosition
+  /**
+   * The script inventory that was open
+   */
+  readonly inventory?: LuaInventory
   /**
    * Identifier of the event
    */
@@ -1099,8 +1025,7 @@ interface OnGuiClosedEvent extends EventData {
 
 /**
  * Called when a {@link LuaGuiElement} is confirmed, for example by pressing Enter in a textfield.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_gui_confirmed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_gui_confirmed Online documentation}
  */
 interface OnGuiConfirmedEvent extends EventData {
   /**
@@ -1135,8 +1060,7 @@ interface OnGuiConfirmedEvent extends EventData {
 
 /**
  * Called when {@link LuaGuiElement} element value is changed (related to choose element buttons).
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_gui_elem_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_gui_elem_changed Online documentation}
  */
 interface OnGuiElemChangedEvent extends EventData {
   /**
@@ -1159,8 +1083,7 @@ interface OnGuiElemChangedEvent extends EventData {
 
 /**
  * Called when {@link LuaGuiElement} element location is changed (related to frames in `player.gui.screen`).
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_gui_location_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_gui_location_changed Online documentation}
  */
 interface OnGuiLocationChangedEvent extends EventData {
   /**
@@ -1183,8 +1106,7 @@ interface OnGuiLocationChangedEvent extends EventData {
 
 /**
  * Called when the player opens a GUI.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_gui_opened View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_gui_opened Online documentation}
  */
 interface OnGuiOpenedEvent extends EventData {
   /**
@@ -1215,6 +1137,10 @@ interface OnGuiOpenedEvent extends EventData {
    * The custom GUI element that was opened
    */
   readonly element?: LuaGuiElement
+  /**
+   * The script inventory that was opened
+   */
+  readonly inventory?: LuaInventory
   /**
    * Identifier of the event
    */
@@ -1227,8 +1153,7 @@ interface OnGuiOpenedEvent extends EventData {
 
 /**
  * Called when {@link LuaGuiElement} selected tab is changed (related to tabbed-panes).
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_gui_selected_tab_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_gui_selected_tab_changed Online documentation}
  */
 interface OnGuiSelectedTabChangedEvent extends EventData {
   /**
@@ -1251,8 +1176,7 @@ interface OnGuiSelectedTabChangedEvent extends EventData {
 
 /**
  * Called when {@link LuaGuiElement} selection state is changed (related to drop-downs and listboxes).
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_gui_selection_state_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_gui_selection_state_changed Online documentation}
  */
 interface OnGuiSelectionStateChangedEvent extends EventData {
   /**
@@ -1275,8 +1199,7 @@ interface OnGuiSelectionStateChangedEvent extends EventData {
 
 /**
  * Called when {@link LuaGuiElement} switch state is changed (related to switches).
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_gui_switch_state_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_gui_switch_state_changed Online documentation}
  */
 interface OnGuiSwitchStateChangedEvent extends EventData {
   /**
@@ -1299,8 +1222,7 @@ interface OnGuiSwitchStateChangedEvent extends EventData {
 
 /**
  * Called when {@link LuaGuiElement} text is changed by the player.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_gui_text_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_gui_text_changed Online documentation}
  */
 interface OnGuiTextChangedEvent extends EventData {
   /**
@@ -1327,8 +1249,7 @@ interface OnGuiTextChangedEvent extends EventData {
 
 /**
  * Called when {@link LuaGuiElement} slider value is changed (related to the slider element).
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_gui_value_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_gui_value_changed Online documentation}
  */
 interface OnGuiValueChangedEvent extends EventData {
   /**
@@ -1351,8 +1272,7 @@ interface OnGuiValueChangedEvent extends EventData {
 
 /**
  * Called when a land mine is armed.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_land_mine_armed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_land_mine_armed Online documentation}
  */
 interface OnLandMineArmedEvent extends EventData {
   readonly mine: LuaEntity
@@ -1368,8 +1288,7 @@ interface OnLandMineArmedEvent extends EventData {
 
 /**
  * Called when a custom Lua shortcut is pressed.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_lua_shortcut View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_lua_shortcut Online documentation}
  */
 interface OnLuaShortcutEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -1389,8 +1308,7 @@ interface OnLuaShortcutEvent extends EventData {
 
 /**
  * Called when an entity is marked for deconstruction with the Deconstruction planner or via script. Can be filtered using {@link LuaEntityMarkedForDeconstructionEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_marked_for_deconstruction View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_marked_for_deconstruction Online documentation}
  */
 interface OnMarkedForDeconstructionEvent extends EventData {
   readonly entity: LuaEntity
@@ -1407,8 +1325,7 @@ interface OnMarkedForDeconstructionEvent extends EventData {
 
 /**
  * Called when an entity is marked for upgrade with the Upgrade planner or via script. Can be filtered using {@link LuaEntityMarkedForUpgradeEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_marked_for_upgrade View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_marked_for_upgrade Online documentation}
  */
 interface OnMarkedForUpgradeEvent extends EventData {
   readonly entity: LuaEntity
@@ -1430,8 +1347,7 @@ interface OnMarkedForUpgradeEvent extends EventData {
 
 /**
  * Called after a player purchases some offer from a `market` entity.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_market_item_purchased View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_market_item_purchased Online documentation}
  */
 interface OnMarketItemPurchasedEvent extends EventData {
   /**
@@ -1462,8 +1378,7 @@ interface OnMarketItemPurchasedEvent extends EventData {
 
 /**
  * Called when the player uses the 'Open item GUI' control on an item defined with the 'mod-openable' flag
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_mod_item_opened View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_mod_item_opened Online documentation}
  */
 interface OnModItemOpenedEvent extends EventData {
   /**
@@ -1486,8 +1401,7 @@ interface OnModItemOpenedEvent extends EventData {
 
 /**
  * Called directly after a permission group is added.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_permission_group_added View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_permission_group_added Online documentation}
  */
 interface OnPermissionGroupAddedEvent extends EventData {
   /**
@@ -1510,8 +1424,7 @@ interface OnPermissionGroupAddedEvent extends EventData {
 
 /**
  * Called directly after a permission group is deleted.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_permission_group_deleted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_permission_group_deleted Online documentation}
  */
 interface OnPermissionGroupDeletedEvent extends EventData {
   /**
@@ -1538,8 +1451,7 @@ interface OnPermissionGroupDeletedEvent extends EventData {
 
 /**
  * Called directly after a permission group is edited in some way.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_permission_group_edited View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_permission_group_edited Online documentation}
  */
 interface OnPermissionGroupEditedEvent extends EventData {
   /**
@@ -1589,8 +1501,7 @@ interface OnPermissionGroupEditedEvent extends EventData {
 
 /**
  * Called directly after a permission string is imported.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_permission_string_imported View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_permission_string_imported Online documentation}
  */
 interface OnPermissionStringImportedEvent extends EventData {
   /**
@@ -1609,8 +1520,7 @@ interface OnPermissionStringImportedEvent extends EventData {
 
 /**
  * Called when a player picks up an item.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_picked_up_item View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_picked_up_item Online documentation}
  */
 interface OnPickedUpItemEvent extends EventData {
   readonly item_stack: SimpleItemStack
@@ -1627,8 +1537,7 @@ interface OnPickedUpItemEvent extends EventData {
 
 /**
  * Called after a player alt-selects an area with a selection-tool item.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_alt_selected_area View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_alt_selected_area Online documentation}
  */
 interface OnPlayerAltSelectedAreaEvent extends EventData {
   /**
@@ -1642,7 +1551,7 @@ interface OnPlayerAltSelectedAreaEvent extends EventData {
   /**
    * The area selected.
    */
-  readonly area: BoundingBoxRead
+  readonly area: BoundingBox
   /**
    * The item used to select the area.
    */
@@ -1667,8 +1576,7 @@ interface OnPlayerAltSelectedAreaEvent extends EventData {
 
 /**
  * Called after a players ammo inventory changed in some way.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_ammo_inventory_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_ammo_inventory_changed Online documentation}
  */
 interface OnPlayerAmmoInventoryChangedEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -1684,8 +1592,7 @@ interface OnPlayerAmmoInventoryChangedEvent extends EventData {
 
 /**
  * Called after a players armor inventory changed in some way.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_armor_inventory_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_armor_inventory_changed Online documentation}
  */
 interface OnPlayerArmorInventoryChangedEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -1701,8 +1608,7 @@ interface OnPlayerArmorInventoryChangedEvent extends EventData {
 
 /**
  * Called when a player is banned.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_banned View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_banned Online documentation}
  */
 interface OnPlayerBannedEvent extends EventData {
   /**
@@ -1733,8 +1639,7 @@ interface OnPlayerBannedEvent extends EventData {
 
 /**
  * Called after a player builds tiles.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_built_tile View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_built_tile Online documentation}
  */
 interface OnPlayerBuiltTileEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -1770,8 +1675,7 @@ interface OnPlayerBuiltTileEvent extends EventData {
 
 /**
  * Called when a player cancels crafting.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_cancelled_crafting View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_cancelled_crafting Online documentation}
  */
 interface OnPlayerCancelledCraftingEvent extends EventData {
   /**
@@ -1802,8 +1706,7 @@ interface OnPlayerCancelledCraftingEvent extends EventData {
 
 /**
  * Called after a player changes forces.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_changed_force View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_changed_force Online documentation}
  */
 interface OnPlayerChangedForceEvent extends EventData {
   /**
@@ -1826,8 +1729,7 @@ interface OnPlayerChangedForceEvent extends EventData {
 
 /**
  * Called when the tile position a player is located at changes.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_changed_position View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_changed_position Online documentation}
  */
 interface OnPlayerChangedPositionEvent extends EventData {
   /**
@@ -1846,12 +1748,8 @@ interface OnPlayerChangedPositionEvent extends EventData {
 
 /**
  * Called after a player changes surfaces.
- *
- * **Note**
- *
- * In the instance a player is moved off a surface due to it being deleted this is not called.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_changed_surface View documentation}
+ * @remarks In the instance a player is moved off a surface due to it being deleted this is not called.
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_changed_surface Online documentation}
  */
 interface OnPlayerChangedSurfaceEvent extends EventData {
   /**
@@ -1874,8 +1772,7 @@ interface OnPlayerChangedSurfaceEvent extends EventData {
 
 /**
  * Called when cheat mode is disabled on a player.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_cheat_mode_disabled View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_cheat_mode_disabled Online documentation}
  */
 interface OnPlayerCheatModeDisabledEvent extends EventData {
   /**
@@ -1894,8 +1791,7 @@ interface OnPlayerCheatModeDisabledEvent extends EventData {
 
 /**
  * Called when cheat mode is enabled on a player.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_cheat_mode_enabled View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_cheat_mode_enabled Online documentation}
  */
 interface OnPlayerCheatModeEnabledEvent extends EventData {
   /**
@@ -1914,8 +1810,7 @@ interface OnPlayerCheatModeEnabledEvent extends EventData {
 
 /**
  * Called when a player clicks a gps tag
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_clicked_gps_tag View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_clicked_gps_tag Online documentation}
  */
 interface OnPlayerClickedGpsTagEvent extends EventData {
   /**
@@ -1925,7 +1820,7 @@ interface OnPlayerClickedGpsTagEvent extends EventData {
   /**
    * Map position contained in gps tag
    */
-  readonly position: MapPositionTable
+  readonly position: MapPosition
   /**
    * Surface name contained in gps tag, even when such surface does not exists
    */
@@ -1942,8 +1837,7 @@ interface OnPlayerClickedGpsTagEvent extends EventData {
 
 /**
  * Called when a player clicks the "confirm" button in the configure Blueprint GUI.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_configured_blueprint View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_configured_blueprint Online documentation}
  */
 interface OnPlayerConfiguredBlueprintEvent extends EventData {
   /**
@@ -1962,8 +1856,7 @@ interface OnPlayerConfiguredBlueprintEvent extends EventData {
 
 /**
  * Called when a player configures spidertron remote to be connected with a given spidertron
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_configured_spider_remote View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_configured_spider_remote Online documentation}
  */
 interface OnPlayerConfiguredSpiderRemoteEvent extends EventData {
   /**
@@ -1986,8 +1879,7 @@ interface OnPlayerConfiguredSpiderRemoteEvent extends EventData {
 
 /**
  * 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}).
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_crafted_item View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_crafted_item Online documentation}
  */
 interface OnPlayerCraftedItemEvent extends EventData {
   /**
@@ -2014,8 +1906,7 @@ interface OnPlayerCraftedItemEvent extends EventData {
 
 /**
  * Called after the player was created.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_created View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_created Online documentation}
  */
 interface OnPlayerCreatedEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2031,8 +1922,7 @@ interface OnPlayerCreatedEvent extends EventData {
 
 /**
  * Called after a players cursorstack changed in some way.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_cursor_stack_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_cursor_stack_changed Online documentation}
  */
 interface OnPlayerCursorStackChangedEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2048,8 +1938,7 @@ interface OnPlayerCursorStackChangedEvent extends EventData {
 
 /**
  * Called when a player selects an area with a deconstruction planner.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_deconstructed_area View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_deconstructed_area Online documentation}
  */
 interface OnPlayerDeconstructedAreaEvent extends EventData {
   /**
@@ -2063,7 +1952,7 @@ interface OnPlayerDeconstructedAreaEvent extends EventData {
   /**
    * The area selected.
    */
-  readonly area: BoundingBoxRead
+  readonly area: BoundingBox
   /**
    * The item used to select the area.
    */
@@ -2084,8 +1973,7 @@ interface OnPlayerDeconstructedAreaEvent extends EventData {
 
 /**
  * Called when a player is demoted.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_demoted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_demoted Online documentation}
  */
 interface OnPlayerDemotedEvent extends EventData {
   /**
@@ -2104,8 +1992,7 @@ interface OnPlayerDemotedEvent extends EventData {
 
 /**
  * Called after a player dies.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_died View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_died Online documentation}
  */
 interface OnPlayerDiedEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2122,8 +2009,7 @@ interface OnPlayerDiedEvent extends EventData {
 
 /**
  * Called when the display resolution changes for a given player.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_display_resolution_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_display_resolution_changed Online documentation}
  */
 interface OnPlayerDisplayResolutionChangedEvent extends EventData {
   /**
@@ -2146,8 +2032,7 @@ interface OnPlayerDisplayResolutionChangedEvent extends EventData {
 
 /**
  * Called when the display scale changes for a given player.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_display_scale_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_display_scale_changed Online documentation}
  */
 interface OnPlayerDisplayScaleChangedEvent extends EventData {
   /**
@@ -2170,8 +2055,7 @@ interface OnPlayerDisplayScaleChangedEvent extends EventData {
 
 /**
  * Called when the player's driving state has changed, this means a player has either entered or left a vehicle.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_driving_changed_state View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_driving_changed_state Online documentation}
  */
 interface OnPlayerDrivingChangedStateEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2191,8 +2075,7 @@ interface OnPlayerDrivingChangedStateEvent extends EventData {
 
 /**
  * Called when a player drops an item on the ground.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_dropped_item View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_dropped_item Online documentation}
  */
 interface OnPlayerDroppedItemEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2212,8 +2095,7 @@ interface OnPlayerDroppedItemEvent extends EventData {
 
 /**
  * Called when a player fast-transfers something to or from an entity.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_fast_transferred View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_fast_transferred Online documentation}
  */
 interface OnPlayerFastTransferredEvent extends EventData {
   /**
@@ -2240,8 +2122,7 @@ interface OnPlayerFastTransferredEvent extends EventData {
 
 /**
  * Called after player flushed fluid
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_flushed_fluid View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_flushed_fluid Online documentation}
  */
 interface OnPlayerFlushedFluidEvent extends EventData {
   /**
@@ -2276,8 +2157,7 @@ interface OnPlayerFlushedFluidEvent extends EventData {
 
 /**
  * Called after a players gun inventory changed in some way.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_gun_inventory_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_gun_inventory_changed Online documentation}
  */
 interface OnPlayerGunInventoryChangedEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2292,9 +2172,8 @@ interface OnPlayerGunInventoryChangedEvent extends EventData {
 }
 
 /**
- * Called after a player joins the game.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_joined_game View documentation}
+ * 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/latest/events.html#on_player_joined_game Online documentation}
  */
 interface OnPlayerJoinedGameEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2310,8 +2189,7 @@ interface OnPlayerJoinedGameEvent extends EventData {
 
 /**
  * Called when a player is kicked.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_kicked View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_kicked Online documentation}
  */
 interface OnPlayerKickedEvent extends EventData {
   /**
@@ -2337,9 +2215,8 @@ interface OnPlayerKickedEvent extends EventData {
 }
 
 /**
- * Called after a player leaves the game.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_left_game View documentation}
+ * 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/latest/events.html#on_player_left_game Online documentation}
  */
 interface OnPlayerLeftGameEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2356,8 +2233,7 @@ interface OnPlayerLeftGameEvent extends EventData {
 
 /**
  * Called after a players main inventory changed in some way.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_main_inventory_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_main_inventory_changed Online documentation}
  */
 interface OnPlayerMainInventoryChangedEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2373,12 +2249,8 @@ interface OnPlayerMainInventoryChangedEvent extends EventData {
 
 /**
  * Called after the results of an entity being mined are collected just before the entity is destroyed. After this event any items in the buffer will be transferred into the player as if they came from mining the entity. Can be filtered using {@link LuaPlayerMinedEntityEventFilter}.
- *
- * **Note**
- *
- * 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.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_mined_entity View documentation}
+ * @remarks 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/latest/events.html#on_player_mined_entity Online documentation}
  */
 interface OnPlayerMinedEntityEvent extends EventData {
   /**
@@ -2405,8 +2277,7 @@ interface OnPlayerMinedEntityEvent extends EventData {
 
 /**
  * Called when the player mines something.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_mined_item View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_mined_item Online documentation}
  */
 interface OnPlayerMinedItemEvent extends EventData {
   /**
@@ -2426,8 +2297,7 @@ interface OnPlayerMinedItemEvent extends EventData {
 
 /**
  * Called after a player mines tiles.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_mined_tile View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_mined_tile Online documentation}
  */
 interface OnPlayerMinedTileEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2451,8 +2321,7 @@ interface OnPlayerMinedTileEvent extends EventData {
 
 /**
  * Called when a player is muted.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_muted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_muted Online documentation}
  */
 interface OnPlayerMutedEvent extends EventData {
   /**
@@ -2471,8 +2340,7 @@ interface OnPlayerMutedEvent extends EventData {
 
 /**
  * Called when a player invokes the "smart pipette" over an entity.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_pipette View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_pipette Online documentation}
  */
 interface OnPlayerPipetteEvent extends EventData {
   /**
@@ -2499,8 +2367,7 @@ interface OnPlayerPipetteEvent extends EventData {
 
 /**
  * Called after the player puts equipment in an equipment grid
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_placed_equipment View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_placed_equipment Online documentation}
  */
 interface OnPlayerPlacedEquipmentEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2524,8 +2391,7 @@ interface OnPlayerPlacedEquipmentEvent extends EventData {
 
 /**
  * Called when a player is promoted.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_promoted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_promoted Online documentation}
  */
 interface OnPlayerPromotedEvent extends EventData {
   /**
@@ -2544,8 +2410,7 @@ interface OnPlayerPromotedEvent extends EventData {
 
 /**
  * Called when a player is removed (deleted) from the game. Not to be confused with the player logging of this is different in that the player is deleted as if he never existed in the save file.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_removed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_removed Online documentation}
  */
 interface OnPlayerRemovedEvent extends EventData {
   /**
@@ -2564,8 +2429,7 @@ interface OnPlayerRemovedEvent extends EventData {
 
 /**
  * Called after the player removes equipment from an equipment grid
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_removed_equipment View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_removed_equipment Online documentation}
  */
 interface OnPlayerRemovedEquipmentEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2593,8 +2457,7 @@ interface OnPlayerRemovedEquipmentEvent extends EventData {
 
 /**
  * Called when a player repairs an entity. Can be filtered using {@link LuaPlayerRepairedEntityEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_repaired_entity View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_repaired_entity Online documentation}
  */
 interface OnPlayerRepairedEntityEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2611,8 +2474,7 @@ interface OnPlayerRepairedEntityEvent extends EventData {
 
 /**
  * Called after a player respawns.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_respawned View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_respawned Online documentation}
  */
 interface OnPlayerRespawnedEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2632,8 +2494,7 @@ interface OnPlayerRespawnedEvent extends EventData {
 
 /**
  * Called after a player reverse-selects an area with a selection-tool item.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_reverse_selected_area View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_reverse_selected_area Online documentation}
  */
 interface OnPlayerReverseSelectedAreaEvent extends EventData {
   /**
@@ -2647,7 +2508,7 @@ interface OnPlayerReverseSelectedAreaEvent extends EventData {
   /**
    * The area selected.
    */
-  readonly area: BoundingBoxRead
+  readonly area: BoundingBox
   /**
    * The item used to select the area.
    */
@@ -2672,8 +2533,7 @@ interface OnPlayerReverseSelectedAreaEvent extends EventData {
 
 /**
  * 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.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_rotated_entity View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_rotated_entity Online documentation}
  */
 interface OnPlayerRotatedEntityEvent extends EventData {
   /**
@@ -2697,8 +2557,7 @@ interface OnPlayerRotatedEntityEvent extends EventData {
 
 /**
  * Called after a player selects an area with a selection-tool item.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_selected_area View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_selected_area Online documentation}
  */
 interface OnPlayerSelectedAreaEvent extends EventData {
   /**
@@ -2712,7 +2571,7 @@ interface OnPlayerSelectedAreaEvent extends EventData {
   /**
    * The area selected.
    */
-  readonly area: BoundingBoxRead
+  readonly area: BoundingBox
   /**
    * The item used to select the area.
    */
@@ -2737,8 +2596,7 @@ interface OnPlayerSelectedAreaEvent extends EventData {
 
 /**
  * Called when a player sets a quickbar slot to anything (new value, or set to empty).
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_set_quick_bar_slot View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_set_quick_bar_slot Online documentation}
  */
 interface OnPlayerSetQuickBarSlotEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2754,8 +2612,7 @@ interface OnPlayerSetQuickBarSlotEvent extends EventData {
 
 /**
  * Called when a player selects an area with a blueprint.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_setup_blueprint View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_setup_blueprint Online documentation}
  */
 interface OnPlayerSetupBlueprintEvent extends EventData {
   /**
@@ -2769,7 +2626,7 @@ interface OnPlayerSetupBlueprintEvent extends EventData {
   /**
    * The area selected.
    */
-  readonly area: BoundingBoxRead
+  readonly area: BoundingBox
   /**
    * The item used to select the area.
    */
@@ -2794,8 +2651,7 @@ interface OnPlayerSetupBlueprintEvent extends EventData {
 
 /**
  * Called when a player toggles alt mode, also known as "show entity info".
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_toggled_alt_mode View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_toggled_alt_mode Online documentation}
  */
 interface OnPlayerToggledAltModeEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2815,8 +2671,7 @@ interface OnPlayerToggledAltModeEvent extends EventData {
 
 /**
  * Called when a player toggles the map editor on or off.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_toggled_map_editor View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_toggled_map_editor Online documentation}
  */
 interface OnPlayerToggledMapEditorEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2832,8 +2687,7 @@ interface OnPlayerToggledMapEditorEvent extends EventData {
 
 /**
  * Called after a players trash inventory changed in some way.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_trash_inventory_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_trash_inventory_changed Online documentation}
  */
 interface OnPlayerTrashInventoryChangedEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -2849,8 +2703,7 @@ interface OnPlayerTrashInventoryChangedEvent extends EventData {
 
 /**
  * Called when a player is un-banned.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_unbanned View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_unbanned Online documentation}
  */
 interface OnPlayerUnbannedEvent extends EventData {
   /**
@@ -2881,8 +2734,7 @@ interface OnPlayerUnbannedEvent extends EventData {
 
 /**
  * Called when a player is unmuted.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_unmuted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_unmuted Online documentation}
  */
 interface OnPlayerUnmutedEvent extends EventData {
   /**
@@ -2901,8 +2753,7 @@ interface OnPlayerUnmutedEvent extends EventData {
 
 /**
  * Called when a player uses a capsule that results in some game action.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_used_capsule View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_used_capsule Online documentation}
  */
 interface OnPlayerUsedCapsuleEvent extends EventData {
   /**
@@ -2916,7 +2767,7 @@ interface OnPlayerUsedCapsuleEvent extends EventData {
   /**
    * The position the capsule was used.
    */
-  readonly position: MapPositionTable
+  readonly position: MapPosition
   /**
    * Identifier of the event
    */
@@ -2929,8 +2780,7 @@ interface OnPlayerUsedCapsuleEvent extends EventData {
 
 /**
  * Called when a player uses spidertron remote to send a spidertron to a given position
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_player_used_spider_remote View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_player_used_spider_remote Online documentation}
  */
 interface OnPlayerUsedSpiderRemoteEvent extends EventData {
   /**
@@ -2944,7 +2794,7 @@ interface OnPlayerUsedSpiderRemoteEvent extends EventData {
   /**
    * Goal position to which spidertron was sent to.
    */
-  readonly position: MapPositionTable
+  readonly position: MapPosition
   /**
    * If the use was successful. It may fail when spidertron has different driver or when player is on different surface.
    */
@@ -2961,8 +2811,7 @@ interface OnPlayerUsedSpiderRemoteEvent extends EventData {
 
 /**
  * Called after an entity dies. Can be filtered using {@link LuaPostEntityDiedEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_post_entity_died View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_post_entity_died Online documentation}
  */
 interface OnPostEntityDiedEvent extends EventData {
   /**
@@ -2976,7 +2825,7 @@ interface OnPostEntityDiedEvent extends EventData {
   /**
    * Position where the entity died.
    */
-  readonly position: MapPositionTable
+  readonly position: MapPosition
   /**
    * The entity prototype of the entity that died.
    */
@@ -3009,8 +2858,7 @@ interface OnPostEntityDiedEvent extends EventData {
 
 /**
  * Called when players uses an item to build something. Called before {@link OnBuiltEntityEvent on_built_entity}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_build View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_build Online documentation}
  */
 interface OnPreBuildEvent extends EventData {
   /**
@@ -3020,7 +2868,7 @@ interface OnPreBuildEvent extends EventData {
   /**
    * Where the item was placed.
    */
-  readonly position: MapPositionTable
+  readonly position: MapPosition
   /**
    * Item was placed using shift building.
    */
@@ -3053,15 +2901,14 @@ interface OnPreBuildEvent extends EventData {
 
 /**
  * Called before one or more chunks are deleted using {@link LuaSurface#delete_chunk LuaSurface::delete_chunk}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_chunk_deleted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_chunk_deleted Online documentation}
  */
 interface OnPreChunkDeletedEvent extends EventData {
   readonly surface_index: SurfaceIndex
   /**
    * The chunks to be deleted.
    */
-  readonly positions: ChunkPositionTable[]
+  readonly positions: ChunkPosition[]
   /**
    * Identifier of the event
    */
@@ -3074,8 +2921,7 @@ interface OnPreChunkDeletedEvent extends EventData {
 
 /**
  * Called before entity copy-paste is done.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_entity_settings_pasted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_entity_settings_pasted Online documentation}
  */
 interface OnPreEntitySettingsPastedEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -3099,8 +2945,7 @@ interface OnPreEntitySettingsPastedEvent extends EventData {
 
 /**
  * Called before a ghost entity is destroyed as a result of being marked for deconstruction. Can be filtered using {@link LuaPreGhostDeconstructedEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_ghost_deconstructed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_ghost_deconstructed Online documentation}
  */
 interface OnPreGhostDeconstructedEvent extends EventData {
   /**
@@ -3118,10 +2963,29 @@ interface OnPreGhostDeconstructedEvent extends EventData {
   readonly tick: uint
 }
 
+/**
+ * Called before a ghost entity is upgraded. Can be filtered using {@link LuaPreGhostUpgradedEventFilter}.
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_ghost_upgraded Online documentation}
+ */
+interface OnPreGhostUpgradedEvent extends EventData {
+  /**
+   * The player that did the upgrade if any.
+   */
+  readonly player_index?: PlayerIndex
+  readonly ghost: LuaEntity
+  /**
+   * Identifier of the event
+   */
+  readonly name: typeof defines.events.on_pre_ghost_upgraded
+  /**
+   * Tick the event was generated.
+   */
+  readonly tick: uint
+}
+
 /**
  * Called directly before a permission group is deleted.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_permission_group_deleted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_permission_group_deleted Online documentation}
  */
 interface OnPrePermissionGroupDeletedEvent extends EventData {
   /**
@@ -3144,8 +3008,7 @@ interface OnPrePermissionGroupDeletedEvent extends EventData {
 
 /**
  * Called directly before a permission string is imported.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_permission_string_imported View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_permission_string_imported Online documentation}
  */
 interface OnPrePermissionStringImportedEvent extends EventData {
   /**
@@ -3164,8 +3027,7 @@ interface OnPrePermissionStringImportedEvent extends EventData {
 
 /**
  * Called when a player queues something to be crafted.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_player_crafted_item View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_player_crafted_item Online documentation}
  */
 interface OnPrePlayerCraftedItemEvent extends EventData {
   /**
@@ -3196,8 +3058,7 @@ interface OnPrePlayerCraftedItemEvent extends EventData {
 
 /**
  * Called before a players dies.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_player_died View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_player_died Online documentation}
  */
 interface OnPrePlayerDiedEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -3214,8 +3075,7 @@ interface OnPrePlayerDiedEvent extends EventData {
 
 /**
  * Called before a player leaves the game.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_player_left_game View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_player_left_game Online documentation}
  */
 interface OnPrePlayerLeftGameEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -3232,8 +3092,7 @@ interface OnPrePlayerLeftGameEvent extends EventData {
 
 /**
  * Called when the player finishes mining an entity, before the entity is removed from map. Can be filtered using {@link LuaPrePlayerMinedEntityEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_player_mined_item View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_player_mined_item Online documentation}
  */
 interface OnPrePlayerMinedItemEvent extends EventData {
   /**
@@ -3253,8 +3112,7 @@ interface OnPrePlayerMinedItemEvent extends EventData {
 
 /**
  * Called before a player is removed (deleted) from the game. Not to be confused with the player logging of this is different in that the player is deleted as if he never existed in the save file.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_player_removed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_player_removed Online documentation}
  */
 interface OnPrePlayerRemovedEvent extends EventData {
   /**
@@ -3273,8 +3131,7 @@ interface OnPrePlayerRemovedEvent extends EventData {
 
 /**
  * Called before a player toggles the map editor on or off.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_player_toggled_map_editor View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_player_toggled_map_editor Online documentation}
  */
 interface OnPrePlayerToggledMapEditorEvent extends EventData {
   readonly player_index: PlayerIndex
@@ -3290,8 +3147,7 @@ interface OnPrePlayerToggledMapEditorEvent extends EventData {
 
 /**
  * Called directly before a robot explodes cliffs.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_robot_exploded_cliff View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_robot_exploded_cliff Online documentation}
  */
 interface OnPreRobotExplodedCliffEvent extends EventData {
   readonly robot: LuaEntity
@@ -3312,8 +3168,7 @@ interface OnPreRobotExplodedCliffEvent extends EventData {
 
 /**
  * Called just before a script inventory is resized.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_script_inventory_resized View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_script_inventory_resized Online documentation}
  */
 interface OnPreScriptInventoryResizedEvent extends EventData {
   /**
@@ -3345,8 +3200,7 @@ interface OnPreScriptInventoryResizedEvent extends EventData {
 
 /**
  * Called just before a surface is cleared (all entities removed and all chunks deleted).
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_surface_cleared View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_surface_cleared Online documentation}
  */
 interface OnPreSurfaceClearedEvent extends EventData {
   readonly surface_index: SurfaceIndex
@@ -3362,8 +3216,7 @@ interface OnPreSurfaceClearedEvent extends EventData {
 
 /**
  * Called just before a surface is deleted.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_pre_surface_deleted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_pre_surface_deleted Online documentation}
  */
 interface OnPreSurfaceDeletedEvent extends EventData {
   readonly surface_index: SurfaceIndex
@@ -3379,8 +3232,7 @@ interface OnPreSurfaceDeletedEvent extends EventData {
 
 /**
  * Called when research is cancelled.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_research_cancelled View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_research_cancelled Online documentation}
  */
 interface OnResearchCancelledEvent extends EventData {
   /**
@@ -3403,8 +3255,7 @@ interface OnResearchCancelledEvent extends EventData {
 
 /**
  * Called when a research finishes.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_research_finished View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_research_finished Online documentation}
  */
 interface OnResearchFinishedEvent extends EventData {
   /**
@@ -3427,8 +3278,7 @@ interface OnResearchFinishedEvent extends EventData {
 
 /**
  * Called when a research is reversed (unresearched).
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_research_reversed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_research_reversed Online documentation}
  */
 interface OnResearchReversedEvent extends EventData {
   /**
@@ -3451,8 +3301,7 @@ interface OnResearchReversedEvent extends EventData {
 
 /**
  * Called when a technology research starts.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_research_started View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_research_started Online documentation}
  */
 interface OnResearchStartedEvent extends EventData {
   /**
@@ -3472,8 +3321,7 @@ interface OnResearchStartedEvent extends EventData {
 
 /**
  * Called when a resource entity reaches 0 or its minimum yield for infinite resources.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_resource_depleted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_resource_depleted Online documentation}
  */
 interface OnResourceDepletedEvent extends EventData {
   readonly entity: LuaEntity
@@ -3489,8 +3337,7 @@ interface OnResourceDepletedEvent extends EventData {
 
 /**
  * Called when a construction robot builds an entity. Can be filtered using {@link LuaRobotBuiltEntityEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_robot_built_entity View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_robot_built_entity Online documentation}
  */
 interface OnRobotBuiltEntityEvent extends EventData {
   /**
@@ -3521,8 +3368,7 @@ interface OnRobotBuiltEntityEvent extends EventData {
 
 /**
  * Called after a robot builds tiles.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_robot_built_tile View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_robot_built_tile Online documentation}
  */
 interface OnRobotBuiltTileEvent extends EventData {
   /**
@@ -3561,8 +3407,7 @@ interface OnRobotBuiltTileEvent extends EventData {
 
 /**
  * Called directly after a robot explodes cliffs.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_robot_exploded_cliff View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_robot_exploded_cliff Online documentation}
  */
 interface OnRobotExplodedCliffEvent extends EventData {
   readonly robot: LuaEntity
@@ -3582,8 +3427,7 @@ interface OnRobotExplodedCliffEvent extends EventData {
 
 /**
  * Called when a robot mines an entity.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_robot_mined View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_robot_mined Online documentation}
  */
 interface OnRobotMinedEvent extends EventData {
   /**
@@ -3606,12 +3450,8 @@ interface OnRobotMinedEvent extends EventData {
 
 /**
  * Called after the results of an entity being mined are collected just before the entity is destroyed. After this event any items in the buffer will be transferred into the robot as if they came from mining the entity. Can be filtered using {@link LuaRobotMinedEntityEventFilter}.
- *
- * **Note**
- *
- * 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.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_robot_mined_entity View documentation}
+ * @remarks 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/latest/events.html#on_robot_mined_entity Online documentation}
  */
 interface OnRobotMinedEntityEvent extends EventData {
   /**
@@ -3638,8 +3478,7 @@ interface OnRobotMinedEntityEvent extends EventData {
 
 /**
  * Called after a robot mines tiles.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_robot_mined_tile View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_robot_mined_tile Online documentation}
  */
 interface OnRobotMinedTileEvent extends EventData {
   /**
@@ -3666,8 +3505,7 @@ interface OnRobotMinedTileEvent extends EventData {
 
 /**
  * Called before a robot mines an entity. Can be filtered using {@link LuaPreRobotMinedEntityEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_robot_pre_mined View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_robot_pre_mined Online documentation}
  */
 interface OnRobotPreMinedEvent extends EventData {
   /**
@@ -3690,8 +3528,7 @@ interface OnRobotPreMinedEvent extends EventData {
 
 /**
  * Called when a rocket silo is ordered to be launched.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_rocket_launch_ordered View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_rocket_launch_ordered Online documentation}
  */
 interface OnRocketLaunchOrderedEvent extends EventData {
   readonly rocket: LuaEntity
@@ -3712,8 +3549,7 @@ interface OnRocketLaunchOrderedEvent extends EventData {
 
 /**
  * Called when the rocket is launched.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_rocket_launched View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_rocket_launched Online documentation}
  */
 interface OnRocketLaunchedEvent extends EventData {
   readonly rocket: LuaEntity
@@ -3734,8 +3570,7 @@ interface OnRocketLaunchedEvent extends EventData {
 
 /**
  * Called when a runtime mod setting is changed by a player.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_runtime_mod_setting_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_runtime_mod_setting_changed Online documentation}
  */
 interface OnRuntimeModSettingChangedEvent extends EventData {
   /**
@@ -3762,8 +3597,7 @@ interface OnRuntimeModSettingChangedEvent extends EventData {
 
 /**
  * Called just after a script inventory is resized.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_script_inventory_resized View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_script_inventory_resized Online documentation}
  */
 interface OnScriptInventoryResizedEvent extends EventData {
   /**
@@ -3799,8 +3633,7 @@ interface OnScriptInventoryResizedEvent extends EventData {
 
 /**
  * Called when a {@link LuaSurface#request_path LuaSurface::request_path} call completes.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_script_path_request_finished View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_script_path_request_finished Online documentation}
  */
 interface OnScriptPathRequestFinishedEvent extends EventData {
   /**
@@ -3827,8 +3660,7 @@ interface OnScriptPathRequestFinishedEvent extends EventData {
 
 /**
  * Called when a script trigger effect is triggered.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_script_trigger_effect View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_script_trigger_effect Online documentation}
  */
 interface OnScriptTriggerEffectEvent extends EventData {
   /**
@@ -3839,9 +3671,9 @@ interface OnScriptTriggerEffectEvent extends EventData {
    * The surface the effect happened on.
    */
   readonly surface_index: SurfaceIndex
-  readonly source_position?: MapPositionTable
+  readonly source_position?: MapPosition
   readonly source_entity?: LuaEntity
-  readonly target_position?: MapPositionTable
+  readonly target_position?: MapPosition
   readonly target_entity?: LuaEntity
   /**
    * Identifier of the event
@@ -3855,8 +3687,7 @@ interface OnScriptTriggerEffectEvent extends EventData {
 
 /**
  * Called when an entity of type `radar` finishes scanning a sector. Can be filtered for the radar using {@link LuaSectorScannedEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_sector_scanned View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_sector_scanned Online documentation}
  */
 interface OnSectorScannedEvent extends EventData {
   /**
@@ -3866,11 +3697,11 @@ interface OnSectorScannedEvent extends EventData {
   /**
    * The chunk scanned.
    */
-  readonly chunk_position: ChunkPositionTable
+  readonly chunk_position: ChunkPosition
   /**
    * Area of the scanned chunk.
    */
-  readonly area: BoundingBoxRead
+  readonly area: BoundingBox
   /**
    * Identifier of the event
    */
@@ -3883,8 +3714,7 @@ interface OnSectorScannedEvent extends EventData {
 
 /**
  * Called after the selected entity changes for a given player.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_selected_entity_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_selected_entity_changed Online documentation}
  */
 interface OnSelectedEntityChangedEvent extends EventData {
   /**
@@ -3907,8 +3737,7 @@ interface OnSelectedEntityChangedEvent extends EventData {
 
 /**
  * Called when a spider finishes moving to its autopilot position.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_spider_command_completed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_spider_command_completed Online documentation}
  */
 interface OnSpiderCommandCompletedEvent extends EventData {
   /**
@@ -3927,8 +3756,7 @@ interface OnSpiderCommandCompletedEvent extends EventData {
 
 /**
  * Called when a translation request generated through {@link LuaPlayer#request_translation LuaPlayer::request_translation} is translated.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_string_translated View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_string_translated Online documentation}
  */
 interface OnStringTranslatedEvent extends EventData {
   /**
@@ -3959,8 +3787,7 @@ interface OnStringTranslatedEvent extends EventData {
 
 /**
  * Called just after a surface is cleared (all entities removed and all chunks deleted).
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_surface_cleared View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_surface_cleared Online documentation}
  */
 interface OnSurfaceClearedEvent extends EventData {
   readonly surface_index: SurfaceIndex
@@ -3976,12 +3803,8 @@ interface OnSurfaceClearedEvent extends EventData {
 
 /**
  * Called when a surface is created.
- *
- * **Note**
- *
- * This is not called when the default surface is created as it will always exist.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_surface_created View documentation}
+ * @remarks This is not called when the default surface is created as it will always exist.
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_surface_created Online documentation}
  */
 interface OnSurfaceCreatedEvent extends EventData {
   readonly surface_index: SurfaceIndex
@@ -3997,8 +3820,7 @@ interface OnSurfaceCreatedEvent extends EventData {
 
 /**
  * Called after a surface is deleted.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_surface_deleted View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_surface_deleted Online documentation}
  */
 interface OnSurfaceDeletedEvent extends EventData {
   readonly surface_index: SurfaceIndex
@@ -4014,8 +3836,7 @@ interface OnSurfaceDeletedEvent extends EventData {
 
 /**
  * Called after a surface is imported.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_surface_imported View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_surface_imported Online documentation}
  */
 interface OnSurfaceImportedEvent extends EventData {
   readonly surface_index: SurfaceIndex
@@ -4035,8 +3856,7 @@ interface OnSurfaceImportedEvent extends EventData {
 
 /**
  * Called when a surface is renamed.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_surface_renamed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_surface_renamed Online documentation}
  */
 interface OnSurfaceRenamedEvent extends EventData {
   readonly surface_index: SurfaceIndex
@@ -4054,8 +3874,7 @@ interface OnSurfaceRenamedEvent extends EventData {
 
 /**
  * Called when {@link LuaForce#reset_technology_effects LuaForce::reset_technology_effects} is finished.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_technology_effects_reset View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_technology_effects_reset Online documentation}
  */
 interface OnTechnologyEffectsResetEvent extends EventData {
   readonly force: LuaForce
@@ -4071,8 +3890,7 @@ interface OnTechnologyEffectsResetEvent extends EventData {
 
 /**
  * It is fired once every tick. Since this event is fired every tick, its handler shouldn't include performance heavy code.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_tick View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_tick Online documentation}
  */
 interface OnTickEvent extends EventData {
   /**
@@ -4087,8 +3905,7 @@ interface OnTickEvent extends EventData {
 
 /**
  * Called when a train changes state (started to stopped and vice versa)
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_train_changed_state View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_train_changed_state Online documentation}
  */
 interface OnTrainChangedStateEvent extends EventData {
   readonly train: LuaTrain
@@ -4105,8 +3922,7 @@ interface OnTrainChangedStateEvent extends EventData {
 
 /**
  * Called when a new train is created either through disconnecting/connecting an existing one or building a new one.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_train_created View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_train_created Online documentation}
  */
 interface OnTrainCreatedEvent extends EventData {
   readonly train: LuaTrain
@@ -4130,8 +3946,7 @@ interface OnTrainCreatedEvent extends EventData {
 
 /**
  * Called when a trains schedule is changed either by the player or through script.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_train_schedule_changed View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_train_schedule_changed Online documentation}
  */
 interface OnTrainScheduleChangedEvent extends EventData {
   readonly train: LuaTrain
@@ -4151,8 +3966,7 @@ interface OnTrainScheduleChangedEvent extends EventData {
 
 /**
  * Called when an entity with a trigger prototype (such as capsules) create an entity AND that trigger prototype defined `trigger_created_entity="true"`.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_trigger_created_entity View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_trigger_created_entity Online documentation}
  */
 interface OnTriggerCreatedEntityEvent extends EventData {
   readonly entity: LuaEntity
@@ -4169,8 +3983,7 @@ interface OnTriggerCreatedEntityEvent extends EventData {
 
 /**
  * Called when an entity with a trigger prototype (such as capsules) fire an artillery projectile AND that trigger prototype defined `trigger_fired_artillery="true"`.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_trigger_fired_artillery View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_trigger_fired_artillery Online documentation}
  */
 interface OnTriggerFiredArtilleryEvent extends EventData {
   readonly entity: LuaEntity
@@ -4187,8 +4000,7 @@ interface OnTriggerFiredArtilleryEvent extends EventData {
 
 /**
  * Called when a unit is added to a unit group.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_unit_added_to_group View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_unit_added_to_group Online documentation}
  */
 interface OnUnitAddedToGroupEvent extends EventData {
   readonly unit: LuaEntity
@@ -4205,8 +4017,7 @@ interface OnUnitAddedToGroupEvent extends EventData {
 
 /**
  * Called when a new unit group is created, before any members are added to it.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_unit_group_created View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_unit_group_created Online documentation}
  */
 interface OnUnitGroupCreatedEvent extends EventData {
   readonly group: LuaUnitGroup
@@ -4222,8 +4033,7 @@ interface OnUnitGroupCreatedEvent extends EventData {
 
 /**
  * Called when a unit group finishes gathering and starts executing its command.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_unit_group_finished_gathering View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_unit_group_finished_gathering Online documentation}
  */
 interface OnUnitGroupFinishedGatheringEvent extends EventData {
   readonly group: LuaUnitGroup
@@ -4239,8 +4049,7 @@ interface OnUnitGroupFinishedGatheringEvent extends EventData {
 
 /**
  * Called when a unit is removed from a unit group.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_unit_removed_from_group View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_unit_removed_from_group Online documentation}
  */
 interface OnUnitRemovedFromGroupEvent extends EventData {
   readonly unit: LuaEntity
@@ -4257,8 +4066,7 @@ interface OnUnitRemovedFromGroupEvent extends EventData {
 
 /**
  * Called when a worker (construction or logistic) robot expires through a lack of energy.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#on_worker_robot_expired View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#on_worker_robot_expired Online documentation}
  */
 interface OnWorkerRobotExpiredEvent extends EventData {
   readonly robot: LuaEntity
@@ -4274,8 +4082,7 @@ interface OnWorkerRobotExpiredEvent extends EventData {
 
 /**
  * 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}. Can be filtered using {@link LuaScriptRaisedBuiltEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#script_raised_built View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#script_raised_built Online documentation}
  */
 interface ScriptRaisedBuiltEvent extends EventData {
   /**
@@ -4294,8 +4101,7 @@ interface ScriptRaisedBuiltEvent extends EventData {
 
 /**
  * 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}. Can be filtered using {@link LuaScriptRaisedDestroyEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#script_raised_destroy View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#script_raised_destroy Online documentation}
  */
 interface ScriptRaisedDestroyEvent extends EventData {
   /**
@@ -4314,8 +4120,7 @@ interface ScriptRaisedDestroyEvent extends EventData {
 
 /**
  * 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}. Can be filtered using {@link LuaScriptRaisedReviveEventFilter}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#script_raised_revive View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#script_raised_revive Online documentation}
  */
 interface ScriptRaisedReviveEvent extends EventData {
   /**
@@ -4338,8 +4143,7 @@ interface ScriptRaisedReviveEvent extends EventData {
 
 /**
  * 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}.
- *
- * {@link https://lua-api.factorio.com/latest/events.html#script_raised_set_tiles View documentation}
+ * @see {@link https://lua-api.factorio.com/latest/events.html#script_raised_set_tiles Online documentation}
  */
 interface ScriptRaisedSetTilesEvent extends EventData {
   /**
@@ -4349,7 +4153,7 @@ interface ScriptRaisedSetTilesEvent extends EventData {
   /**
    * The tiles that were changed.
    */
-  readonly tiles: TileRead[]
+  readonly tiles: Tile[]
   /**
    * Identifier of the event
    */