typed-factorio 3.4.0 → 3.5.1

package/runtime/generated/concepts.d.ts

@@ -12,12 +12,12 @@ import type { VersionString } from "factorio:common"
 declare module "factorio:runtime" {
   /**
    * `math.huge` represents the maximum possible tick.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/MapTick.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/MapTick.html Online documentation}
    */
   export type MapTick = uint64
   /**
    * The percentual increase of the attribute. A value of `0.6` means a 60% increase.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ModuleEffectValue.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ModuleEffectValue.html Online documentation}
    */
   export type ModuleEffectValue = float
   /**
@@ -27,7 +27,7 @@ declare module "factorio:runtime" {
    *   speed=-0.15,
    *   productivity=0.06,
    *   pollution=0.075}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ModuleEffects.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ModuleEffects.html Online documentation}
    */
   export interface ModuleEffects {
     readonly consumption?: ModuleEffectValue
@@ -51,10 +51,9 @@ declare module "factorio:runtime" {
    * - `"<="`: "lesser than or equal to"
    * - `"≠"`: "not equal to"
    * - `"!="`: "not equal to"
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ComparatorString.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ComparatorString.html Online documentation}
    */
   export type ComparatorString = "=" | ">" | "<" | "≥" | ">=" | "≤" | "<=" | "≠" | "!="
-  /** @see ComparatorString */
   export type ComparatorStringRead = "=" | ">" | "<" | "≥" | "≤" | "≠"
   export type SpriteType =
     | "item"
@@ -83,19 +82,15 @@ declare module "factorio:runtime" {
    *
    * The validity of a SpritePath can be verified at runtime using {@link LuaHelpers#is_valid_sprite_path LuaHelpers::is_valid_sprite_path}.
    *
-   * {@link https://lua-api.factorio.com/2.0.17/concepts/SpritePath.html > The supported types are:}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SpritePath.html Online documentation}
+   * {@link https://lua-api.factorio.com/2.0.21/concepts/SpritePath.html > The supported types are:}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SpritePath.html Online documentation}
    */
-  export type SpritePath =
-    | (string & {
-        _?: never
-      })
-    | `${SpriteType}${"/" | "."}${string}`
+  export type SpritePath = (string & { _?: never }) | `${SpriteType}${"/" | "."}${string}`
   /**
    * @example
    * -- Most common collision mask of buildings:
    * collision_mask = {layers = {item = true, meltable = true, object = true, player = true, water_tile = true, is_object = true, is_lower_object = true}}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/CollisionMask.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/CollisionMask.html Online documentation}
    */
   export interface CollisionMask {
     /**
@@ -223,7 +218,7 @@ declare module "factorio:runtime" {
    * - `"check-box"`
    * - `"switch"`
    * - `"label"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SimulationWidgetType.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SimulationWidgetType.html Online documentation}
    */
   export type SimulationWidgetType =
     | "signal-id"
@@ -345,7 +340,7 @@ declare module "factorio:runtime" {
    * - `"any-goal-accessible"`: The method will return {@link TrainPathFinderOneGoalResult}.
    * - `"all-goals-accessible"`: The method will return {@link TrainPathAllGoalsResult}.
    * - `"all-goals-penalties"`: The method will return {@link TrainPathAllGoalsResult} with `penalties`.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TrainPathRequestType.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TrainPathRequestType.html Online documentation}
    */
   export type TrainPathRequestType = "path" | "any-goal-accessible" | "all-goals-accessible" | "all-goals-penalties"
   /**
@@ -354,7 +349,7 @@ declare module "factorio:runtime" {
    * - {@link RailEndGoal}
    * - {@link LuaRailEnd}
    * - {@link LuaEntity}: Only if it points at train-stop that is connected to a rail.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TrainPathFinderGoal.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TrainPathFinderGoal.html Online documentation}
    */
   export type TrainPathFinderGoal = TrainStopGoal | RailEndGoal | LuaRailEnd | LuaEntity
   export interface TrainStopGoal {
@@ -459,7 +454,7 @@ declare module "factorio:runtime" {
   }
   /**
    * A single pipe connection for a given fluidbox.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/PipeConnection.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/PipeConnection.html Online documentation}
    */
   export interface PipeConnection {
     readonly flow_direction: "input" | "output" | "input-output"
@@ -517,12 +512,12 @@ declare module "factorio:runtime" {
    * - {@link LuaPostEntityDiedEventFilter}
    * - {@link LuaEntityMarkedForDeconstructionEventFilter}
    * - {@link LuaPlayerMinedEntityEventFilter}
-   * - LuaEntityDamagedEventFilter
+   * - {@link LuaEntityDamagedEventFilter}
    * - {@link LuaScriptRaisedReviveEventFilter}
    * - {@link LuaEntityDiedEventFilter}
    * - {@link LuaPreRobotMinedEntityEventFilter}
    * @see EventFilterWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EventFilter.html Online documentation}
    */
   export type EventFilter =
     | LuaPrePlatformMinedEntityEventFilter[]
@@ -552,7 +547,7 @@ declare module "factorio:runtime" {
     | LuaPreRobotMinedEntityEventFilter[]
   /**
    * Write form of {@link EventFilter}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EventFilter.html Online documentation}
    */
   export type EventFilterWrite =
     | readonly LuaPrePlatformMinedEntityEventFilter[]
@@ -602,7 +597,7 @@ declare module "factorio:runtime" {
    * - {@link LuaCommandable}: Target type {@link defines.target_type.commandable commandable}; `useful_id` {@link LuaCommandable#unique_id LuaCommandable::unique_id}
    * - {@link LuaCustomChartTag}: Target type {@link defines.target_type.custom_chart_tag custom_chart_tag}; `useful_id` {@link LuaCustomChartTag#tag_number LuaCustomChartTag::tag_number}
    * - {@link LuaGuiElement}: Target type {@link defines.target_type.gui_element gui_element}; `useful_id` {@link LuaGuiElement#index LuaGuiElement::index}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/RegistrationTarget.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/RegistrationTarget.html Online documentation}
    */
   export type RegistrationTarget =
     | LuaEntity
@@ -803,7 +798,7 @@ declare module "factorio:runtime" {
    * - `"wire-removed"`: {@link WireRemovedUndoRedoAction}
    * - `"rotated-entity"`: {@link RotatedEntityUndoRedoAction}
    * - `"copy-entity-settings"`: {@link CopyEntitySettingsUndoRedoAction}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/UndoRedoAction.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/UndoRedoAction.html Online documentation}
    */
   export type UndoRedoAction =
     | BuiltEntityUndoRedoAction
@@ -835,7 +830,7 @@ declare module "factorio:runtime" {
    * - `"weapon"`
    * - `"explosion"`
    * - `"enemy"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SoundType.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SoundType.html Online documentation}
    */
   export type SoundType =
     | "game-effect"
@@ -918,7 +913,7 @@ declare module "factorio:runtime" {
    * - `"controllable-remove"`
    * - `"entity-ghost"`: Selects entities that are `entity-ghost`s.
    * - `"tile-ghost"`: Selects entities that are `tile-ghost`s.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SelectionModeFlags.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SelectionModeFlags.html Online documentation}
    */
   export interface SelectionModeFlags {
     /**
@@ -1037,7 +1032,7 @@ declare module "factorio:runtime" {
    * A set of flags. Active flags are in the dictionary as `true`, while inactive flags aren't present at all.
    *
    * By default, none of these flags are set.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ItemPrototypeFlags.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ItemPrototypeFlags.html Online documentation}
    */
   export type ItemPrototypeFlags = {
     readonly [T in ItemPrototypeFlag]?: true
@@ -1058,7 +1053,7 @@ declare module "factorio:runtime" {
    * - `"spawnable"`: Allows the item to be spawned by a quickbar shortcut or custom input.
    * - `"spoil-result"`
    * - `"ignore-spoil-time-modifier"`: Controls whether the spoil time ignores the spoil time modifier in the {@link DifficultySettings}.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ItemPrototypeFlag.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ItemPrototypeFlag.html Online documentation}
    */
   export type ItemPrototypeFlag =
     | "draw-logistic-overlay"
@@ -1078,7 +1073,7 @@ declare module "factorio:runtime" {
    * - `"none"`
    * - `"whitelist"`
    * - `"blacklist"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/PrototypeFilterMode.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/PrototypeFilterMode.html Online documentation}
    */
   export type PrototypeFilterMode = "none" | "whitelist" | "blacklist"
   export interface PipeConnectionDefinition {
@@ -1102,7 +1097,7 @@ declare module "factorio:runtime" {
    * The name of a {@link LuaCollisionLayerPrototype}.
    * @example
    * "is_lower_object"
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/CollisionLayerID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/CollisionLayerID.html Online documentation}
    */
   export type CollisionLayerID = string
   export interface ItemIDFilter {
@@ -1140,19 +1135,19 @@ declare module "factorio:runtime" {
    *
    * ## Union members
    * - {@link ModSettingPrototypeFilter}
-   * - TilePrototypeFilter
+   * - {@link TilePrototypeFilter}
    * - {@link DecorativePrototypeFilter}
-   * - RecipePrototypeFilter
+   * - {@link RecipePrototypeFilter}
    * - {@link AchievementPrototypeFilter}
-   * - TechnologyPrototypeFilter
+   * - {@link TechnologyPrototypeFilter}
    * - {@link AsteroidChunkPrototypeFilter}
-   * - ItemPrototypeFilter
+   * - {@link ItemPrototypeFilter}
    * - {@link EquipmentPrototypeFilter}
-   * - EntityPrototypeFilter
-   * - SpaceLocationPrototypeFilter
-   * - FluidPrototypeFilter
+   * - {@link EntityPrototypeFilter}
+   * - {@link SpaceLocationPrototypeFilter}
+   * - {@link FluidPrototypeFilter}
    * @see PrototypeFilterWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/PrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/PrototypeFilter.html Online documentation}
    */
   export type PrototypeFilter =
     | ModSettingPrototypeFilter[]
@@ -1169,7 +1164,7 @@ declare module "factorio:runtime" {
     | FluidPrototypeFilter[]
   /**
    * Write form of {@link PrototypeFilter}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/PrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/PrototypeFilter.html Online documentation}
    */
   export type PrototypeFilterWrite =
     | readonly ModSettingPrototypeFilter[]
@@ -1186,7 +1181,7 @@ declare module "factorio:runtime" {
     | readonly FluidPrototypeFilterWrite[]
   /**
    * @see DisplayPanelMessageDefinitionWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/DisplayPanelMessageDefinition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/DisplayPanelMessageDefinition.html Online documentation}
    */
   export interface DisplayPanelMessageDefinition {
     /**
@@ -1204,7 +1199,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link DisplayPanelMessageDefinition}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/DisplayPanelMessageDefinition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/DisplayPanelMessageDefinition.html Online documentation}
    */
   export interface DisplayPanelMessageDefinitionWrite {
     /**
@@ -1230,7 +1225,7 @@ declare module "factorio:runtime" {
    * - `"space-location"`
    * - `"asteroid-chunk"`
    * - `"quality"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SignalIDType.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SignalIDType.html Online documentation}
    */
   export type SignalIDType =
     | "item"
@@ -1431,7 +1426,7 @@ declare module "factorio:runtime" {
    * - `"play-next-track"`
    * - `"play-previous-track"`
    * - `"pause-resume-music"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LinkedGameControl.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LinkedGameControl.html Online documentation}
    */
   export type LinkedGameControl =
     | "move-up"
@@ -1682,7 +1677,7 @@ declare module "factorio:runtime" {
    * - `"create-ghost-on-entity-death"`
    * - `"belt-stack-size-bonus"`
    * - `"vehicle-logistics"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ModifierType.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ModifierType.html Online documentation}
    */
   export type ModifierType =
     | "inserter-stack-size-bonus"
@@ -1801,7 +1796,7 @@ declare module "factorio:runtime" {
    * - `"capture-spawner"`: {@link CaptureSpawnerResearchTrigger}
    * - `"build-entity"`: {@link BuildEntityResearchTrigger}
    * - `"send-item-to-orbit"`: {@link SendItemToOrbitResearchTrigger}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ResearchTrigger.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ResearchTrigger.html Online documentation}
    */
   export type ResearchTrigger =
     | CraftItemResearchTrigger
@@ -1815,7 +1810,7 @@ declare module "factorio:runtime" {
    * A set of flags. Active flags are in the dictionary as `true`, while inactive flags aren't present at all.
    *
    * By default, none of these flags are set.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EntityPrototypeFlags.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EntityPrototypeFlags.html Online documentation}
    */
   export type EntityPrototypeFlags = {
     readonly [T in EntityPrototypeFlag]?: true
@@ -1850,7 +1845,7 @@ declare module "factorio:runtime" {
    * - `"building-direction-16-way"`
    * - `"snap-to-rail-support-spot"`
    * - `"not-in-made-in"`: Prevents the entity from being shown in the "made in" list in recipe tooltips.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EntityPrototypeFlag.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EntityPrototypeFlag.html Online documentation}
    */
   export type EntityPrototypeFlag =
     | "not-rotatable"
@@ -1920,7 +1915,7 @@ declare module "factorio:runtime" {
    * - `"local"`: The sound can be heard within the audible range around the speaker.
    * - `"surface"`: The sound can be heard anywhere on the speaker's surface.
    * - `"global"`: The sound can be heard everywhere.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ProgrammableSpeakerPlaybackMode.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ProgrammableSpeakerPlaybackMode.html Online documentation}
    */
   export type ProgrammableSpeakerPlaybackMode = "local" | "surface" | "global"
   /**
@@ -1945,7 +1940,7 @@ declare module "factorio:runtime" {
    * - `"none-to-south"`
    * - `"south-to-none"`
    * - `"none-to-north"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/CliffOrientation.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/CliffOrientation.html Online documentation}
    */
   export type CliffOrientation =
     | "west-to-east"
@@ -1971,7 +1966,7 @@ declare module "factorio:runtime" {
   /**
    * Defines an item type that a blueprint entity will request.
    * @see BlueprintInsertPlanWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/BlueprintInsertPlan.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintInsertPlan.html Online documentation}
    */
   export interface BlueprintInsertPlan {
     /**
@@ -1985,7 +1980,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link BlueprintInsertPlan}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/BlueprintInsertPlan.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintInsertPlan.html Online documentation}
    */
   export interface BlueprintInsertPlanWrite {
     /**
@@ -2013,7 +2008,7 @@ declare module "factorio:runtime" {
   }
   /**
    * A single offer on a market entity.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Offer.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Offer.html Online documentation}
    */
   export interface Offer {
     /**
@@ -2028,7 +2023,7 @@ declare module "factorio:runtime" {
   /**
    * An item filter may be specified in two ways, either as a string which is an item prototype name or as a table.
    * @see ItemFilterWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ItemFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ItemFilter.html Online documentation}
    */
   export type ItemFilter =
     | {
@@ -2048,7 +2043,7 @@ declare module "factorio:runtime" {
     | string
   /**
    * Write form of {@link ItemFilter}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ItemFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ItemFilter.html Online documentation}
    */
   export type ItemFilterWrite =
     | {
@@ -2068,7 +2063,7 @@ declare module "factorio:runtime" {
     | string
   /**
    * @see ScheduleRecordWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ScheduleRecord.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ScheduleRecord.html Online documentation}
    */
   export interface ScheduleRecord {
     /**
@@ -2091,7 +2086,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link ScheduleRecord}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ScheduleRecord.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ScheduleRecord.html Online documentation}
    */
   export interface ScheduleRecordWrite {
     /**
@@ -2177,7 +2172,7 @@ declare module "factorio:runtime" {
    * - `"position"`: {@link PositionGuiArrowSpecification}
    * - `"crafting_queue"`: {@link CraftingQueueGuiArrowSpecification}
    * - `"item_stack"`: {@link ItemStackGuiArrowSpecification}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GuiArrowSpecification.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GuiArrowSpecification.html Online documentation}
    */
   export type GuiArrowSpecification =
     | EntityGuiArrowSpecification
@@ -2190,7 +2185,7 @@ declare module "factorio:runtime" {
    *
    * If this is specified as a three-element array then the array items are x, y and z, in that order.
    * @see Vector3DArray
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Vector3D.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Vector3D.html Online documentation}
    */
   export interface Vector3D {
     readonly x: float
@@ -2200,12 +2195,12 @@ declare module "factorio:runtime" {
   /**
    * Array form of {@link Vector3D}.
    * @see Vector3D
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Vector3D.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Vector3D.html Online documentation}
    */
   export type Vector3DArray = readonly [float, float, float]
   /**
    * @see TrainScheduleWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TrainSchedule.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TrainSchedule.html Online documentation}
    */
   export interface TrainSchedule {
     /**
@@ -2216,7 +2211,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link TrainSchedule}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TrainSchedule.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TrainSchedule.html Online documentation}
    */
   export interface TrainScheduleWrite {
     /**
@@ -2227,7 +2222,7 @@ declare module "factorio:runtime" {
   }
   /**
    * @see PlatformScheduleWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/PlatformSchedule.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/PlatformSchedule.html Online documentation}
    */
   export interface PlatformSchedule {
     /**
@@ -2238,7 +2233,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link PlatformSchedule}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/PlatformSchedule.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/PlatformSchedule.html Online documentation}
    */
   export interface PlatformScheduleWrite {
     /**
@@ -2255,7 +2250,7 @@ declare module "factorio:runtime" {
   }
   /**
    * A recipe prototype with optional quality specification.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/RecipeIDAndQualityIDPair.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/RecipeIDAndQualityIDPair.html Online documentation}
    */
   export interface RecipeIDAndQualityIDPair {
     /**
@@ -2304,7 +2299,7 @@ declare module "factorio:runtime" {
    * - `string`: Name of the force, same as {@link LuaForce#name LuaForce::name}.
    * - {@link uint8}: Index of the force, same as {@link LuaForce#index LuaForce::index}.
    * - {@link LuaForce}: A reference to {@link LuaForce} may be passed directly.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ForceID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ForceID.html Online documentation}
    */
   export type ForceID = string | uint8 | LuaForce
   /**
@@ -2314,7 +2309,7 @@ declare module "factorio:runtime" {
    * - `string`: The fluid name.
    * - {@link LuaFluidPrototype}: The fluid prototype.
    * - {@link Fluid}: The fluid.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/FluidID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/FluidID.html Online documentation}
    */
   export type FluidID = string | LuaFluidPrototype | Fluid
   /**
@@ -2325,12 +2320,12 @@ declare module "factorio:runtime" {
    * - {@link LuaEntityPrototype}: The entity prototype. Normal quality will be used.
    * - `string`: The prototype name. Normal quality will be used.
    * - {@link EntityIDAndQualityIDPair}: A table of entity prototype and quality.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EntityWithQualityID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EntityWithQualityID.html Online documentation}
    */
   export type EntityWithQualityID = LuaEntity | LuaEntityPrototype | string | EntityIDAndQualityIDPair
   /**
    * An entity prototype with optional quality specification.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EntityIDAndQualityIDPair.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EntityIDAndQualityIDPair.html Online documentation}
    */
   export interface EntityIDAndQualityIDPair {
     /**
@@ -2349,14 +2344,14 @@ declare module "factorio:runtime" {
    * - {@link LuaItemStack}: The item stack. Both prototype and quality of the item stack will be used.
    * - {@link LuaItemPrototype}: The item prototype. Normal quality will be used.
    * - `string`: The prototype name. Normal quality will be used.
-   * - ItemIDAndQualityIDPairWrite: A table of entity prototype and quality.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ItemWithQualityID.html Online documentation}
+   * - `ItemIDAndQualityIDPairWrite`: A table of entity prototype and quality.
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ItemWithQualityID.html Online documentation}
    */
   export type ItemWithQualityID = LuaItemStack | LuaItemPrototype | string | ItemIDAndQualityIDPairWrite
   /**
    * An item prototype with optional quality specification.
    * @see ItemIDAndQualityIDPairWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ItemIDAndQualityIDPair.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ItemIDAndQualityIDPair.html Online documentation}
    */
   export interface ItemIDAndQualityIDPair {
     /**
@@ -2370,7 +2365,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link ItemIDAndQualityIDPair}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ItemIDAndQualityIDPair.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ItemIDAndQualityIDPair.html Online documentation}
    */
   export interface ItemIDAndQualityIDPairWrite {
     /**
@@ -2390,7 +2385,7 @@ declare module "factorio:runtime" {
    * - {@link LuaItemStack}: Non empty item stack.
    * - {@link LuaItem}: The item.
    * - `string`: The prototype name.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ItemID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ItemID.html Online documentation}
    */
   export type ItemID = LuaItemPrototype | LuaItemStack | LuaItem | string
   /**
@@ -2400,7 +2395,7 @@ declare module "factorio:runtime" {
    * - {@link LuaEntityPrototype}: The entity prototype.
    * - {@link LuaEntity}: The entity.
    * - `string`: The prototype name.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EntityID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EntityID.html Online documentation}
    */
   export type EntityID = LuaEntityPrototype | LuaEntity | string
   /**
@@ -2410,7 +2405,7 @@ declare module "factorio:runtime" {
    * - {@link LuaTechnologyPrototype}: The technology prototype.
    * - {@link LuaTechnology}: Instance of the technology.
    * - `string`: The prototype name.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TechnologyID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TechnologyID.html Online documentation}
    */
   export type TechnologyID = LuaTechnologyPrototype | LuaTechnology | string
   /**
@@ -2419,7 +2414,7 @@ declare module "factorio:runtime" {
    * ## Union members
    * - {@link LuaParticlePrototype}: The particle prototype.
    * - `string`: The prototype name.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ParticleID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ParticleID.html Online documentation}
    */
   export type ParticleID = LuaParticlePrototype | string
   /**
@@ -2428,7 +2423,7 @@ declare module "factorio:runtime" {
    * ## Union members
    * - {@link LuaDamagePrototype}: The damage type prototype.
    * - `string`: The prototype name.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/DamageTypeID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/DamageTypeID.html Online documentation}
    */
   export type DamageTypeID = LuaDamagePrototype | string
   /**
@@ -2437,7 +2432,7 @@ declare module "factorio:runtime" {
    * ## Union members
    * - {@link LuaTrivialSmokePrototype}: The trivial smoke prototype.
    * - `string`: The prototype name.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TrivialSmokeID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TrivialSmokeID.html Online documentation}
    */
   export type TrivialSmokeID = LuaTrivialSmokePrototype | string
   /**
@@ -2449,7 +2444,7 @@ declare module "factorio:runtime" {
    * - `"left"`
    * - `"right"`
    * - `"center"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TextAlign.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TextAlign.html Online documentation}
    */
   export type TextAlign = "left" | "right" | "center"
   /**
@@ -2462,7 +2457,7 @@ declare module "factorio:runtime" {
    * - `"middle"`
    * - `"baseline"`
    * - `"bottom"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/VerticalTextAlign.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/VerticalTextAlign.html Online documentation}
    */
   export type VerticalTextAlign = "top" | "middle" | "baseline" | "bottom"
   /**
@@ -2471,7 +2466,7 @@ declare module "factorio:runtime" {
    * ## Union members
    * - {@link LuaQualityPrototype}: The quality prototype.
    * - `string`: The prototype name.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/QualityID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/QualityID.html Online documentation}
    */
   export type QualityID = LuaQualityPrototype | string
   /**
@@ -2481,7 +2476,7 @@ declare module "factorio:runtime" {
    * - {@link LuaRecipePrototype}: By recipe prototype.
    * - {@link LuaRecipe}: By instance of recipe.
    * - `string`: By name of the recipe prototype.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/RecipeID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/RecipeID.html Online documentation}
    */
   export type RecipeID = LuaRecipePrototype | LuaRecipe | string
   /**
@@ -2491,7 +2486,7 @@ declare module "factorio:runtime" {
    * - {@link LuaTilePrototype}: By tile prototype.
    * - {@link LuaTile}: By instance of tile.
    * - `string`: By name of the tile prototype.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TileID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TileID.html Online documentation}
    */
   export type TileID = LuaTilePrototype | LuaTile | string
   export interface Fluid {
@@ -2515,7 +2510,7 @@ declare module "factorio:runtime" {
    * - {@link LuaEquipmentPrototype}: The equipment prototype.
    * - {@link LuaEquipment}: The equipment.
    * - `string`: The prototype name.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EquipmentID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EquipmentID.html Online documentation}
    */
   export type EquipmentID = LuaEquipmentPrototype | LuaEquipment | string
   /**
@@ -2526,12 +2521,12 @@ declare module "factorio:runtime" {
    * - {@link LuaEquipment}: The equipment. Both prototype and quality of the provided equipment will be used.
    * - `string`: The prototype name. Normal quality will be used.
    * - {@link EquipmentIDAndQualityIDPair}: A table of equipment prototype and quality.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EquipmentWithQualityID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EquipmentWithQualityID.html Online documentation}
    */
   export type EquipmentWithQualityID = LuaEquipmentPrototype | LuaEquipment | string | EquipmentIDAndQualityIDPair
   /**
    * An equipment prototype with optional quality specification.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EquipmentIDAndQualityIDPair.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EquipmentIDAndQualityIDPair.html Online documentation}
    */
   export interface EquipmentIDAndQualityIDPair {
     /**
@@ -2552,48 +2547,45 @@ declare module "factorio:runtime" {
    * @example
    * -- Shorthand
    * {{-2, -3}, {5, 8}}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/BoundingBox.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BoundingBox.html Online documentation}
    */
   export interface BoundingBox {
     readonly left_top: MapPosition
     readonly right_bottom: MapPosition
     readonly orientation?: RealOrientation
   }
-  /**
-   * Write form of {@link BoundingBox}, as a table, where positions are allowed to take an array form.
-   */
-  export interface BoundingBoxWrite {
-    readonly left_top: MapPosition | MapPositionArray
-    readonly right_bottom: MapPosition | MapPositionArray
-    readonly orientation?: RealOrientation
-  }
   /**
    * Array form of {@link BoundingBox}.
    * @see BoundingBox
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/BoundingBox.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BoundingBox.html Online documentation}
    */
   export type BoundingBoxArray = readonly [MapPosition | MapPositionArray, MapPosition | MapPositionArray]
+  export interface BoundingBoxWrite {
+    readonly left_top: (MapPosition | MapPositionArray) | MapPositionArray
+    readonly right_bottom: (MapPosition | MapPositionArray) | MapPositionArray
+    readonly orientation?: RealOrientation
+  }
   /**
    * Space platform may be specified in one of one ways.
    *
    * ## Union members
    * - {@link LuaSpacePlatform}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SpacePlatformIdentification.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SpacePlatformIdentification.html Online documentation}
    */
   export type SpacePlatformIdentification = LuaSpacePlatform
   /**
    * Set of forces. Can be specified in one of two ways.
    *
    * ## Union members
-   * - LuaForce[]: Array of many forces.
-   * - LuaForce: A single force.
+   * - {@link LuaForce}[]: Array of many forces.
+   * - {@link LuaForce}: A single force.
    * @see ForceSetWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ForceSet.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ForceSet.html Online documentation}
    */
   export type ForceSet = LuaForce[] | LuaForce
   /**
    * Write form of {@link ForceSet}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ForceSet.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ForceSet.html Online documentation}
    */
   export type ForceSetWrite = readonly ForceID[] | ForceID
   /**
@@ -2602,7 +2594,7 @@ declare module "factorio:runtime" {
    * ## Union members
    * - {@link LuaDecorativePrototype}: The decorative prototype.
    * - `string`: The prototype name.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/DecorativeID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/DecorativeID.html Online documentation}
    */
   export type DecorativeID = LuaDecorativePrototype | string
   /**
@@ -2611,7 +2603,7 @@ declare module "factorio:runtime" {
    * ## Union members
    * - {@link LuaAsteroidChunkPrototype}: The asteroid chunk prototype.
    * - `string`: The prototype name.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/AsteroidChunkID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/AsteroidChunkID.html Online documentation}
    */
   export type AsteroidChunkID = LuaAsteroidChunkPrototype | string
   /**
@@ -2620,13 +2612,13 @@ declare module "factorio:runtime" {
    * ## Union members
    * - {@link LuaSpaceLocationPrototype}: The space location prototype.
    * - `string`: The prototype name.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SpaceLocationID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SpaceLocationID.html Online documentation}
    */
   export type SpaceLocationID = LuaSpaceLocationPrototype | string
   /**
    * A signal filter may be specified in two ways, either as a string which is a virtual signal name or item prototype name or as a table.
    * @see SignalFilterWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SignalFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SignalFilter.html Online documentation}
    */
   export type SignalFilter =
     | {
@@ -2650,7 +2642,7 @@ declare module "factorio:runtime" {
     | string
   /**
    * Write form of {@link SignalFilter}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SignalFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SignalFilter.html Online documentation}
    */
   export type SignalFilterWrite =
     | {
@@ -2674,7 +2666,7 @@ declare module "factorio:runtime" {
     | string
   /**
    * @see LogisticFilterWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LogisticFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LogisticFilter.html Online documentation}
    */
   export interface LogisticFilter {
     /**
@@ -2700,7 +2692,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link LogisticFilter}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LogisticFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LogisticFilter.html Online documentation}
    */
   export interface LogisticFilterWrite {
     /**
@@ -2756,23 +2748,23 @@ declare module "factorio:runtime" {
    * ## Union members
    * - {@link LuaSurfacePropertyPrototype}: The surface property prototype.
    * - `string`: The prototype name.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SurfacePropertyID.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SurfacePropertyID.html Online documentation}
    */
   export type SurfacePropertyID = LuaSurfacePropertyPrototype | string
   /**
    * When writing it is possible to give LuaEntity or MapPosition directly. However, reading always returns the full ScriptRenderTargetTable.
    * @see ScriptRenderTargetWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ScriptRenderTarget.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ScriptRenderTarget.html Online documentation}
    */
   export type ScriptRenderTarget = LuaEntity | MapPosition | ScriptRenderTargetTable
   /**
    * Write form of {@link ScriptRenderTarget}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ScriptRenderTarget.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ScriptRenderTarget.html Online documentation}
    */
   export type ScriptRenderTargetWrite = LuaEntity | (MapPosition | MapPositionArray) | ScriptRenderTargetTableWrite
   /**
    * @see ScriptRenderTargetTableWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ScriptRenderTargetTable.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ScriptRenderTargetTable.html Online documentation}
    */
   export interface ScriptRenderTargetTable {
     readonly entity?: LuaEntity
@@ -2787,7 +2779,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link ScriptRenderTargetTable}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ScriptRenderTargetTable.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ScriptRenderTargetTable.html Online documentation}
    */
   export interface ScriptRenderTargetTableWrite {
     readonly entity?: LuaEntity
@@ -2802,7 +2794,7 @@ declare module "factorio:runtime" {
   }
   /**
    * An item filter may be specified in two ways, either as a string which is a quality prototype name or as a table.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/QualityCondition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/QualityCondition.html Online documentation}
    */
   export type QualityCondition =
     | {
@@ -2821,291 +2813,986 @@ declare module "factorio:runtime" {
    * - `"center-to-center"`
    * - `"bounding-box-to-bounding-box"`
    * - `"center-to-bounding-box"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/RangeMode.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/RangeMode.html Online documentation}
    */
   export type RangeMode = "center-to-center" | "bounding-box-to-bounding-box" | "center-to-bounding-box"
   /**
    * The representation of an entity inside of a blueprint. It has at least these fields, but can contain additional ones depending on the kind of entity.
    * @see BlueprintEntityWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/BlueprintEntity.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintEntity.html Online documentation}
    */
   export interface BlueprintEntity {
     /**
-     * The entity's unique identifier in the blueprint.
+     * The entity's unique identifier in the blueprint.
+     */
+    readonly entity_number: uint
+    /**
+     * The prototype name of the entity.
+     */
+    readonly name: string
+    /**
+     * The position of the entity.
+     */
+    readonly position: MapPosition
+    /**
+     * The direction the entity is facing. Only present for entities that can face in different directions and when the entity is not facing north.
+     */
+    readonly direction?: defines.direction
+    /**
+     * Whether this entity is mirrored.
+     */
+    readonly mirror?: boolean
+    /**
+     * The prototype name of the entity's quality.
+     */
+    readonly quality?: string
+    /**
+     * The control behavior of the entity, if it has one. The format of the control behavior depends on the entity's type. Only relevant for entities that support control behaviors.
+     */
+    readonly control_behavior?: BlueprintControlBehavior
+    /**
+     * The items that the entity will request when revived, if any.
+     */
+    readonly items?: BlueprintInsertPlan[]
+    /**
+     * The entity tags of the entity, if there are any.
+     */
+    readonly tags?: Tags
+    /**
+     * The schedule of the entity, if it has one. Only relevant for locomotives.
+     */
+    readonly schedule?: BlueprintSchedule
+    /**
+     * Wires connected to this entity in the blueprint.
+     */
+    readonly wires?: BlueprintWire[]
+    /**
+     * Used by assembling machines. Name of the recipe prototype
+     */
+    readonly recipe?: string
+    /**
+     * Used by assembling machines; quality of the recipe.
+     */
+    readonly recipe_quality?: LuaQualityPrototype
+    /**
+     * Used by containers (chests). The index of the first inaccessible item slot due to limiting with the red "bar". 0-based.
+     */
+    readonly bar?: uint16
+    /**
+     * Cargo wagon or filtered container inventory configuration, for item filters and bar.
+     */
+    readonly inventory?: BlueprintInventory
+    /**
+     * Used by Infinity containers and infinity pipes.
+     */
+    readonly infinity_settings?: InfinityContainerFilter | InfinityPipeFilter
+    /**
+     * Used by heat interfaces.
+     */
+    readonly mode?: "at-least" | "at-most" | "exactly" | "add" | "remove"
+    /**
+     * Used by heat interfaces.
+     */
+    readonly temperature?: uint
+    /**
+     * Type of the underground belt or loader. Either "input" or "output".
+     */
+    readonly type?: "input" | "output"
+    /**
+     * Input priority of the splitter. Either "right" or "left", "none" is omitted.
+     */
+    readonly input_priority?: "right" | "left"
+    /**
+     * Output priority of the splitter. Either "right" or "left", "none" is omitted.
+     */
+    readonly output_priority?: "right" | "left"
+    /**
+     * Filter of the splitter.
+     */
+    readonly filter?: BlueprintLogisticFilter
+    /**
+     * Filters of the filter inserter or loader.
+     */
+    readonly filters?: BlueprintLogisticFilter[]
+    /**
+     * Filter mode of the filter inserter.
+     */
+    readonly filter_mode?: "whitelist" | "blacklist"
+    /**
+     * The stack size the inserter is set to.
+     */
+    readonly override_stack_size?: uint8
+    /**
+     * The drop position the inserter is set to.
+     */
+    readonly drop_position?: MapPosition
+    /**
+     * The pickup position the inserter is set to.
+     */
+    readonly pickup_position?: MapPosition
+    /**
+     * Spoiled priority of an inserter. "spoiled-first" or "fresh-first", "none" is omitted.
+     */
+    readonly spoil_priority?: "spoiled-first" | "fresh-first"
+    /**
+     * Used by all entities with logistics sections, except for combinators.
+     */
+    readonly request_filters?: BlueprintRequestFilters
+    /**
+     * Used by programmable speakers.
+     */
+    readonly parameters?: ProgrammableSpeakerParameters
+    /**
+     * Used by programmable speakers.
+     */
+    readonly alert_parameters?: ProgrammableSpeakerAlertParameters
+    /**
+     * Used by rocket silos. I have no idea what this is.
+     */
+    readonly transitional_request_index?: uint
+    /**
+     * Used by {@link https://wiki.factorio.com/Prototype/SimpleEntityWithForce Prototype/SimpleEntityWithForce} or {@link https://wiki.factorio.com/Prototype/SimpleEntityWithOwner Prototype/SimpleEntityWithOwner}.
+     */
+    readonly variation?: uint8
+    /**
+     * Color of the entity. Used by SimpleEntityWithForce, SimpleEntityWithOwner, train stations, locomotives, and vehicles.
+     */
+    readonly color?: Color
+    /**
+     * The name of the train station.
+     */
+    readonly station?: string
+    /**
+     * The train limit of a train stop.
+     */
+    readonly manual_trains_limit?: uint
+    /**
+     * The priority of the train station.
+     */
+    readonly priority?: uint8
+    /**
+     * Orientation of the cargo wagon or locomotive, value from 0 to 1
+     */
+    readonly orientation?: RealOrientation
+    /**
+     * If this locomotive copies its color from the train stop. Default true.
+     */
+    readonly copy_color_from_train_stop?: boolean
+    /**
+     * Used by spidertons.
+     */
+    readonly vehicle_automatic_targeting_parameters?: VehicleAutomaticTargetingParameters
+    /**
+     * Used by vehicles.
+     */
+    readonly driver_is_main_gunner?: boolean
+    /**
+     * Used by vehicles.
+     */
+    readonly selected_gun_index?: uint
+    /**
+     * Used to vehicles and rolling stock.
+     */
+    readonly enable_logistics_while_moving?: boolean
+    /**
+     * Equipment grid. Note that [items] requests also needs to be set for bots to insert into the grid.
+     */
+    readonly grid?: BlueprintEquipment[]
+    readonly artillery_auto_targeting?: boolean
+    /**
+     * Combinator description.
+     */
+    readonly player_description?: string
+    /**
+     * Used by display panels.
+     */
+    readonly always_show?: boolean
+    /**
+     * Used by display panels.
+     */
+    readonly show_in_chart?: boolean
+    /**
+     * Display panel icon.
+     */
+    readonly icon?: SignalID
+    /**
+     * Display panel text.
+     */
+    readonly text?: string
+    /**
+     * Turret configuration.
+     */
+    readonly "ignore-unprioritised"?: boolean
+    /**
+     * Turret configuration.
+     */
+    readonly "priority-list"?: {
+      readonly index: uint
+      readonly entity_id: LuaEntityPrototype
+    }[]
+  }
+  /**
+   * Write form of {@link BlueprintEntity}, where some properties allow additional values as input compared to the read form.
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintEntity.html Online documentation}
+   */
+  export interface BlueprintEntityWrite {
+    /**
+     * The entity's unique identifier in the blueprint.
+     */
+    readonly entity_number: uint
+    /**
+     * The prototype name of the entity.
+     */
+    readonly name: string
+    /**
+     * The position of the entity.
+     */
+    readonly position: MapPosition | MapPositionArray
+    /**
+     * The direction the entity is facing. Only present for entities that can face in different directions and when the entity is not facing north.
+     */
+    readonly direction?: defines.direction
+    /**
+     * Whether this entity is mirrored.
+     */
+    readonly mirror?: boolean
+    /**
+     * The prototype name of the entity's quality.
+     */
+    readonly quality?: string
+    /**
+     * The control behavior of the entity, if it has one. The format of the control behavior depends on the entity's type. Only relevant for entities that support control behaviors.
+     */
+    readonly control_behavior?: BlueprintControlBehaviorWrite
+    /**
+     * The items that the entity will request when revived, if any.
+     */
+    readonly items?: readonly BlueprintInsertPlanWrite[]
+    /**
+     * The entity tags of the entity, if there are any.
+     */
+    readonly tags?: Tags
+    /**
+     * The schedule of the entity, if it has one. Only relevant for locomotives.
+     */
+    readonly schedule?: BlueprintScheduleWrite
+    /**
+     * Wires connected to this entity in the blueprint.
+     */
+    readonly wires?: BlueprintWire[]
+    /**
+     * Used by assembling machines. Name of the recipe prototype
+     */
+    readonly recipe?: string
+    /**
+     * Used by assembling machines; quality of the recipe.
+     */
+    readonly recipe_quality?: QualityID
+    /**
+     * Used by containers (chests). The index of the first inaccessible item slot due to limiting with the red "bar". 0-based.
+     */
+    readonly bar?: uint16
+    /**
+     * Cargo wagon or filtered container inventory configuration, for item filters and bar.
+     */
+    readonly inventory?: BlueprintInventoryWrite
+    /**
+     * Used by Infinity containers and infinity pipes.
+     */
+    readonly infinity_settings?: InfinityContainerFilter | InfinityPipeFilter
+    /**
+     * Used by heat interfaces.
+     */
+    readonly mode?: "at-least" | "at-most" | "exactly" | "add" | "remove"
+    /**
+     * Used by heat interfaces.
+     */
+    readonly temperature?: uint
+    /**
+     * Type of the underground belt or loader. Either "input" or "output".
+     */
+    readonly type?: "input" | "output"
+    /**
+     * Input priority of the splitter. Either "right" or "left", "none" is omitted.
+     */
+    readonly input_priority?: "right" | "left"
+    /**
+     * Output priority of the splitter. Either "right" or "left", "none" is omitted.
+     */
+    readonly output_priority?: "right" | "left"
+    /**
+     * Filter of the splitter.
+     */
+    readonly filter?: BlueprintLogisticFilterWrite
+    /**
+     * Filters of the filter inserter or loader.
+     */
+    readonly filters?: readonly BlueprintLogisticFilterWrite[]
+    /**
+     * Filter mode of the filter inserter.
+     */
+    readonly filter_mode?: "whitelist" | "blacklist"
+    /**
+     * The stack size the inserter is set to.
+     */
+    readonly override_stack_size?: uint8
+    /**
+     * The drop position the inserter is set to.
+     */
+    readonly drop_position?: MapPosition | MapPositionArray
+    /**
+     * The pickup position the inserter is set to.
+     */
+    readonly pickup_position?: MapPosition | MapPositionArray
+    /**
+     * Spoiled priority of an inserter. "spoiled-first" or "fresh-first", "none" is omitted.
+     */
+    readonly spoil_priority?: "spoiled-first" | "fresh-first"
+    /**
+     * Used by all entities with logistics sections, except for combinators.
+     */
+    readonly request_filters?: BlueprintRequestFilters
+    /**
+     * Used by programmable speakers.
+     */
+    readonly parameters?: ProgrammableSpeakerParameters
+    /**
+     * Used by programmable speakers.
+     */
+    readonly alert_parameters?: ProgrammableSpeakerAlertParameters
+    /**
+     * Used by rocket silos. I have no idea what this is.
+     */
+    readonly transitional_request_index?: uint
+    /**
+     * Used by {@link https://wiki.factorio.com/Prototype/SimpleEntityWithForce Prototype/SimpleEntityWithForce} or {@link https://wiki.factorio.com/Prototype/SimpleEntityWithOwner Prototype/SimpleEntityWithOwner}.
+     */
+    readonly variation?: uint8
+    /**
+     * Color of the entity. Used by SimpleEntityWithForce, SimpleEntityWithOwner, train stations, locomotives, and vehicles.
+     */
+    readonly color?: Color | ColorArray
+    /**
+     * The name of the train station.
+     */
+    readonly station?: string
+    /**
+     * The train limit of a train stop.
+     */
+    readonly manual_trains_limit?: uint
+    /**
+     * The priority of the train station.
+     */
+    readonly priority?: uint8
+    /**
+     * Orientation of the cargo wagon or locomotive, value from 0 to 1
+     */
+    readonly orientation?: RealOrientation
+    /**
+     * If this locomotive copies its color from the train stop. Default true.
+     */
+    readonly copy_color_from_train_stop?: boolean
+    /**
+     * Used by spidertons.
+     */
+    readonly vehicle_automatic_targeting_parameters?: VehicleAutomaticTargetingParameters
+    /**
+     * Used by vehicles.
+     */
+    readonly driver_is_main_gunner?: boolean
+    /**
+     * Used by vehicles.
+     */
+    readonly selected_gun_index?: uint
+    /**
+     * Used to vehicles and rolling stock.
+     */
+    readonly enable_logistics_while_moving?: boolean
+    /**
+     * Equipment grid. Note that [items] requests also needs to be set for bots to insert into the grid.
+     */
+    readonly grid?: readonly BlueprintEquipmentWrite[]
+    readonly artillery_auto_targeting?: boolean
+    /**
+     * Combinator description.
+     */
+    readonly player_description?: string
+    /**
+     * Used by display panels.
+     */
+    readonly always_show?: boolean
+    /**
+     * Used by display panels.
+     */
+    readonly show_in_chart?: boolean
+    /**
+     * Display panel icon.
+     */
+    readonly icon?: SignalID
+    /**
+     * Display panel text.
+     */
+    readonly text?: string
+    /**
+     * Turret configuration.
+     */
+    readonly "ignore-unprioritised"?: boolean
+    /**
+     * Turret configuration.
+     */
+    readonly "priority-list"?: readonly {
+      readonly index: uint
+      readonly entity_id: EntityID
+    }[]
+  }
+  export interface BlueprintRequestFilters {
+    /**
+     * False if disabled in a vehicle.
+     */
+    readonly enabled?: boolean
+    readonly request_from_buffers?: boolean
+  }
+  /**
+   * @see BlueprintEquipmentWrite
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintEquipment.html Online documentation}
+   */
+  export interface BlueprintEquipment {
+    readonly equipment: ItemIDAndQualityIDPair
+    readonly position: EquipmentPosition
+  }
+  /**
+   * Write form of {@link BlueprintEquipment}, where some properties allow additional values as input compared to the read form.
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintEquipment.html Online documentation}
+   */
+  export interface BlueprintEquipmentWrite {
+    readonly equipment: ItemIDAndQualityIDPairWrite
+    readonly position: EquipmentPosition | EquipmentPositionArray
+  }
+  /**
+   * @see BlueprintInventoryWrite
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintInventory.html Online documentation}
+   */
+  export interface BlueprintInventory {
+    readonly filters?: BlueprintLogisticFilter[]
+    /**
+     * The index of the first inaccessible item slot due to limiting with the red "bar". 0-based.
+     */
+    readonly bar?: uint16
+  }
+  /**
+   * Write form of {@link BlueprintInventory}, where some properties allow additional values as input compared to the read form.
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintInventory.html Online documentation}
+   */
+  export interface BlueprintInventoryWrite {
+    readonly filters?: readonly BlueprintLogisticFilterWrite[]
+    /**
+     * The index of the first inaccessible item slot due to limiting with the red "bar". 0-based.
+     */
+    readonly bar?: uint16
+  }
+  export interface InfinityContainerFilter {
+    /**
+     * Whether the "remove unfiltered items" checkbox is checked.
+     */
+    readonly remove_unfiltered_items: boolean
+    /**
+     * Filters of the infinity container.
+     */
+    readonly filters?: InfinityInventoryFilter[]
+  }
+  /**
+   * @see BlueprintControlBehaviorWrite
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintControlBehavior.html Online documentation}
+   */
+  export interface BlueprintControlBehavior {
+    /**
+     * If this entity is enabled/disabled by the circuit network.
+     *
+     * Does **not** apply to logistic containers, see instead {@link circuit_condition_enabled }.
+     *
+     * Corresponds to {@link LuaGenericOnOffControlBehavior.circuit_enable_disable }
+     */
+    readonly circuit_enabled?: boolean
+    /**
+     * Applies to any entity that can be enabled/disabled by the circuit network.
+     */
+    readonly circuit_condition?: CircuitCondition
+    /**
+     * Corresponds to {@link LuaGenericOnOffControlBehavior.connect_to_logistic_network }.
+     */
+    readonly connect_to_logistic_network?: boolean
+    /**
+     * Corresponds to {@link LuaGenericOnOffControlBehavior.logistic_condition }.
+     */
+    readonly logistic_condition?: CircuitCondition
+    /**
+     * If this entity with inventory reads its contents to the circuit network. Default true.
+     *
+     * Does not apply to asteroid collectors, see {@link circuit_read_contents }.
+     */
+    readonly read_contents?: boolean
+    /**
+     * If an **asteroid collector** reads its contents to the circuit network. Default false.
+     */
+    readonly circuit_read_contents?: boolean
+    /**
+     * On a turret, if the ammo is read by the circuit network. Default true.
+     */
+    readonly read_ammo?: boolean
+    /**
+     * Used by turrets.
+     */
+    readonly set_priority_list?: boolean
+    /**
+     * Used by turrets.
+     */
+    readonly set_ignore_unlisted_targets?: boolean
+    /**
+     * Used by turrets.
+     */
+    readonly ignore_unlisted_targets_condition?: CircuitCondition
+    readonly circuit_mode_of_operation?:
+      | defines.control_behavior.logistic_container.exclusive_mode
+      | defines.control_behavior.cargo_landing_pad.exclusive_mode
+    /**
+     * If this **logistics container** is enabled/disabled by the circuit network.
+     *
+     * For other machines, see {@link circuit_enabled }.
+     */
+    readonly circuit_condition_enabled?: boolean
+    /**
+     * Accumulator or gate output signal.
+     */
+    readonly output_signal?: SignalID
+    /**
+     * If the accumulator sends its charge to the circuit network. Default true.
+     */
+    readonly read_charge?: boolean
+    /**
+     * Used by walls connected to gates.
+     */
+    readonly circuit_open_gate?: boolean
+    /**
+     * Used by walls connected to gates. The signal is defined by {@link output_signal }.
+     */
+    readonly circuit_read_sensor?: boolean
+    /**
+     * If this inserter or belt is read by the circuit network.
+     */
+    readonly circuit_read_hand_contents?: boolean
+    /**
+     * For reading contents of an inserter.
+     */
+    readonly circuit_hand_read_mode?: defines.control_behavior.inserter.hand_read_mode
+    /**
+     * For reading contents of a belt.
+     */
+    readonly circuit_contents_read_mode?: defines.control_behavior.transport_belt.content_read_mode
+    /**
+     * If this inserter, loader, or asteroid collector has its filters set by the circuit network.
+     */
+    readonly circuit_set_filters?: boolean
+    /**
+     * If this pump should set its only filter from the circuit network
+     */
+    readonly set_filter?: boolean
+    /**
+     * If this loader pulses its transfers to the circuit network.
+     */
+    readonly circuit_read_transfers?: boolean
+    /**
+     * If this inserter has its stack size set by the circuit network.
+     */
+    readonly circuit_set_stack_size?: boolean
+    readonly stack_control_input_signal?: SignalID
+    /**
+     * Used by assembling machines.
+     */
+    readonly set_recipe?: boolean
+    readonly read_ingredients?: boolean
+    readonly read_recipe_finished?: boolean
+    readonly read_recipe_finished_signal?: SignalID
+    readonly read_working?: boolean
+    readonly read_working_signal?: SignalID
+    /**
+     * If this mining drill reads its resources to the circuit network.
+     */
+    readonly circuit_read_resources?: boolean
+    readonly circuit_resource_read_mode?: defines.control_behavior.mining_drill.resource_read_mode
+    /**
+     * Used by constant combinators.
+     */
+    readonly is_on?: boolean
+    /**
+     * Used by constant combinators.
+     */
+    readonly sections?: LogisticSections
+    readonly arithmetic_conditions?: ArithmeticCombinatorParameters
+    readonly decider_conditions?: DeciderCombinatorParameters
+    /**
+     * Used by selector combinators.
+     */
+    readonly index_signal?: SignalID
+    /**
+     * Used by selector combinators.
+     */
+    readonly index_constant?: uint
+    /**
+     * Used by selector combinators.
+     */
+    readonly count_signal?: SignalID
+    /**
+     * Used by selector combinators. When not specified, defaults to "select".
+     */
+    readonly operation?: "select" | "count" | "random"
+    /**
+     * Used by selector combinators.
+     */
+    readonly select_max?: boolean
+    /**
+     * Applies to train stop. Default true.
+     */
+    readonly send_to_train?: boolean
+    readonly read_from_train?: boolean
+    readonly set_trains_limit?: boolean
+    readonly trains_limit_signal?: SignalID
+    readonly read_stopped_train?: boolean
+    readonly train_stopped_signal?: SignalID
+    readonly read_trains_count?: boolean
+    readonly trains_count_signal?: SignalID
+    readonly set_priority?: boolean
+    readonly priority_signal?: SignalID
+    /**
+     * Used by lamps.
+     */
+    readonly use_colors?: boolean
+    readonly color_mode?: defines.control_behavior.lamp.color_mode
+    /**
+     * Used by **lamps**. For rail signals, see {@link red_output_signal }.
+     */
+    readonly red_signal?: SignalID
+    /**
+     * Used by **lamps**. For rail signals, see {@link green_output_signal }.
+     */
+    readonly green_signal?: SignalID
+    /**
+     * Used by **lamps**. For rail signals, see {@link orange_output_signal }.
+     */
+    readonly blue_signal?: SignalID
+    /**
+     * Used by lamps.
+     */
+    readonly rgb_signal?: SignalID
+    /**
+     * Used by roboports.
+     */
+    readonly read_items_mode?:
+      | defines.control_behavior.roboport.read_items_mode
+      | defines.control_behavior.rocket_silo.read_mode
+    readonly read_robot_stats?: boolean
+    readonly available_logistic_output_signal?: SignalID
+    readonly total_logistic_output_signal?: SignalID
+    readonly available_construction_output_signal?: SignalID
+    readonly total_construction_output_signal?: SignalID
+    readonly roboport_count_output_signal?: SignalID
+    /**
+     * Used by train signals.
+     */
+    readonly circuit_close_signal?: boolean
+    /**
+     * Used by train signals.
+     */
+    readonly circuit_read_signal?: boolean
+    /**
+     * Used by **train signals**. For lamps, seed {@link red_signal }.
+     */
+    readonly red_output_signal?: SignalID
+    /**
+     * used by train signals.
+     */
+    readonly orange_output_signal?: SignalID
+    /**
+     * Used by **train signals**. For lamps, seed {@link green_signal }.
+     */
+    readonly green_output_signal?: SignalID
+    /**
+     * Used by **train signals**. For lamps, seed {@link blue_signal }.
+     */
+    readonly blue_output_signal?: SignalID
+    /**
+     * Used by programmable speakers.
+     */
+    readonly circuit_parameters?: ProgrammableSpeakerCircuitParameters
+    /**
+     * Display panel configuration.
+     */
+    readonly parameters?: DisplayPanelMessageDefinition
+    /**
+     * If this reads the fuel contents of this reactor.
+     */
+    readonly read_burner_fuel?: boolean
+    /**
+     * If this reads the temperature of this reactor.
+     */
+    readonly read_temperature?: boolean
+    readonly temperature_signal?: SignalID
+    /**
+     * Used by space platform hub.
+     */
+    readonly send_to_platform?: boolean
+    readonly read_moving_from?: boolean
+    readonly read_moving_to?: boolean
+    readonly read_speed?: boolean
+    readonly speed_signal?: SignalID
+    readonly read_damage_taken?: boolean
+    readonly damage_taken_signal?: SignalID
+  }
+  /**
+   * Write form of {@link BlueprintControlBehavior}, where some properties allow additional values as input compared to the read form.
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintControlBehavior.html Online documentation}
+   */
+  export interface BlueprintControlBehaviorWrite {
+    /**
+     * If this entity is enabled/disabled by the circuit network.
+     *
+     * Does **not** apply to logistic containers, see instead {@link circuit_condition_enabled }.
+     *
+     * Corresponds to {@link LuaGenericOnOffControlBehavior.circuit_enable_disable }
+     */
+    readonly circuit_enabled?: boolean
+    /**
+     * Applies to any entity that can be enabled/disabled by the circuit network.
+     */
+    readonly circuit_condition?: CircuitConditionWrite
+    /**
+     * Corresponds to {@link LuaGenericOnOffControlBehavior.connect_to_logistic_network }.
+     */
+    readonly connect_to_logistic_network?: boolean
+    /**
+     * Corresponds to {@link LuaGenericOnOffControlBehavior.logistic_condition }.
+     */
+    readonly logistic_condition?: CircuitConditionWrite
+    /**
+     * If this entity with inventory reads its contents to the circuit network. Default true.
+     *
+     * Does not apply to asteroid collectors, see {@link circuit_read_contents }.
+     */
+    readonly read_contents?: boolean
+    /**
+     * If an **asteroid collector** reads its contents to the circuit network. Default false.
+     */
+    readonly circuit_read_contents?: boolean
+    /**
+     * On a turret, if the ammo is read by the circuit network. Default true.
+     */
+    readonly read_ammo?: boolean
+    /**
+     * Used by turrets.
+     */
+    readonly set_priority_list?: boolean
+    /**
+     * Used by turrets.
+     */
+    readonly set_ignore_unlisted_targets?: boolean
+    /**
+     * Used by turrets.
+     */
+    readonly ignore_unlisted_targets_condition?: CircuitConditionWrite
+    readonly circuit_mode_of_operation?:
+      | defines.control_behavior.logistic_container.exclusive_mode
+      | defines.control_behavior.cargo_landing_pad.exclusive_mode
+    /**
+     * If this **logistics container** is enabled/disabled by the circuit network.
+     *
+     * For other machines, see {@link circuit_enabled }.
+     */
+    readonly circuit_condition_enabled?: boolean
+    /**
+     * Accumulator or gate output signal.
+     */
+    readonly output_signal?: SignalID
+    /**
+     * If the accumulator sends its charge to the circuit network. Default true.
+     */
+    readonly read_charge?: boolean
+    /**
+     * Used by walls connected to gates.
+     */
+    readonly circuit_open_gate?: boolean
+    /**
+     * Used by walls connected to gates. The signal is defined by {@link output_signal }.
+     */
+    readonly circuit_read_sensor?: boolean
+    /**
+     * If this inserter or belt is read by the circuit network.
+     */
+    readonly circuit_read_hand_contents?: boolean
+    /**
+     * For reading contents of an inserter.
+     */
+    readonly circuit_hand_read_mode?: defines.control_behavior.inserter.hand_read_mode
+    /**
+     * For reading contents of a belt.
+     */
+    readonly circuit_contents_read_mode?: defines.control_behavior.transport_belt.content_read_mode
+    /**
+     * If this inserter, loader, or asteroid collector has its filters set by the circuit network.
+     */
+    readonly circuit_set_filters?: boolean
+    /**
+     * If this pump should set its only filter from the circuit network
+     */
+    readonly set_filter?: boolean
+    /**
+     * If this loader pulses its transfers to the circuit network.
+     */
+    readonly circuit_read_transfers?: boolean
+    /**
+     * If this inserter has its stack size set by the circuit network.
+     */
+    readonly circuit_set_stack_size?: boolean
+    readonly stack_control_input_signal?: SignalID
+    /**
+     * Used by assembling machines.
+     */
+    readonly set_recipe?: boolean
+    readonly read_ingredients?: boolean
+    readonly read_recipe_finished?: boolean
+    readonly read_recipe_finished_signal?: SignalID
+    readonly read_working?: boolean
+    readonly read_working_signal?: SignalID
+    /**
+     * If this mining drill reads its resources to the circuit network.
+     */
+    readonly circuit_read_resources?: boolean
+    readonly circuit_resource_read_mode?: defines.control_behavior.mining_drill.resource_read_mode
+    /**
+     * Used by constant combinators.
+     */
+    readonly is_on?: boolean
+    /**
+     * Used by constant combinators.
      */
-    readonly entity_number: uint
+    readonly sections?: LogisticSectionsWrite
+    readonly arithmetic_conditions?: ArithmeticCombinatorParameters
+    readonly decider_conditions?: DeciderCombinatorParameters
     /**
-     * The prototype name of the entity.
+     * Used by selector combinators.
      */
-    readonly name: string
+    readonly index_signal?: SignalID
     /**
-     * The position of the entity.
+     * Used by selector combinators.
      */
-    readonly position: MapPosition
+    readonly index_constant?: uint
     /**
-     * The direction the entity is facing. Only present for entities that can face in different directions and when the entity is not facing north.
+     * Used by selector combinators.
      */
-    readonly direction?: defines.direction
+    readonly count_signal?: SignalID
     /**
-     * Whether this entity is mirrored.
+     * Used by selector combinators. When not specified, defaults to "select".
      */
-    readonly mirror?: boolean
+    readonly operation?: "select" | "count" | "random"
     /**
-     * The prototype name of the entity's quality.
+     * Used by selector combinators.
      */
-    readonly quality?: string
+    readonly select_max?: boolean
     /**
-     * The control behavior of the entity, if it has one. The format of the control behavior depends on the entity's type. Only relevant for entities that support control behaviors.
+     * Applies to train stop. Default true.
      */
-    readonly control_behavior?: BlueprintControlBehavior
+    readonly send_to_train?: boolean
+    readonly read_from_train?: boolean
+    readonly set_trains_limit?: boolean
+    readonly trains_limit_signal?: SignalID
+    readonly read_stopped_train?: boolean
+    readonly train_stopped_signal?: SignalID
+    readonly read_trains_count?: boolean
+    readonly trains_count_signal?: SignalID
+    readonly set_priority?: boolean
+    readonly priority_signal?: SignalID
     /**
-     * The items that the entity will request when revived, if any.
+     * Used by lamps.
      */
-    readonly items?: BlueprintInsertPlan[]
+    readonly use_colors?: boolean
+    readonly color_mode?: defines.control_behavior.lamp.color_mode
     /**
-     * The entity tags of the entity, if there are any.
+     * Used by **lamps**. For rail signals, see {@link red_output_signal }.
      */
-    readonly tags?: Tags
+    readonly red_signal?: SignalID
     /**
-     * The schedule of the entity, if it has one. Only relevant for locomotives.
+     * Used by **lamps**. For rail signals, see {@link green_output_signal }.
      */
-    readonly schedule?: BlueprintSchedule
+    readonly green_signal?: SignalID
     /**
-     * Wires connected to this entity in the blueprint.
+     * Used by **lamps**. For rail signals, see {@link orange_output_signal }.
      */
-    readonly wires?: BlueprintWire[]
-    /** Orientation of the cargo wagon or locomotive, value 0 to 1 */
-    readonly orientation?: RealOrientation
-    /** Copper wire connections, array of entity_numbers */
-    readonly neighbours?: uint[]
-    /** Name of the recipe prototype this assembling machine is set to. */
-    readonly recipe?: string
-    /** Used by {@link https://wiki.factorio.com/Prototype/Container Prototype/Container}. The index of the first inaccessible item slot due to limiting with the red "bar". 0-based. */
-    readonly bar?: uint16
-    /** Cargo wagon inventory configuration */
-    readonly inventory?: BlueprintInventory
-    /** Used by {@link https://wiki.factorio.com/Prototype/InfinityContainer Prototype/InfinityContainer}. */
-    readonly infinity_settings?: BlueprintInfinitySettings | InfinityPipeFilter
-    /** Type of the underground belt or loader. Either "input" or "output". */
-    readonly type?: "input" | "output"
-    /** Input priority of the splitter. Either "right" or "left", "none" is omitted. */
-    readonly input_priority?: "right" | "left"
-    /** Output priority of the splitter. Either "right" or "left", "none" is omitted. */
-    readonly output_priority?: "right" | "left"
-    /** Filter of the splitter. Name of the item prototype the filter is set to. */
-    readonly filter?: string
-    /** Filters of the filter inserter or loader. Array of {@link InventoryFilter} objects. */
-    readonly filters?: InventoryFilter[]
-    /** Filter mode of the filter inserter. Either "whitelist" or "blacklist". */
-    readonly filter_mode?: "whitelist" | "blacklist"
-    /** The stack size the inserter is set to. */
-    readonly override_stack_size?: uint8
-    /** The drop position the inserter is set to. */
-    readonly drop_position?: MapPosition
-    /** The pickup position the inserter is set to. */
-    readonly pickup_position?: MapPosition
-    /** Used by {@link https://wiki.factorio.com/Prototype/LogisticContainer Prototype/LogisticContainer}. */
-    readonly request_filters?: LogisticFilter[]
-    /** Whether this requester chest can request from buffer chests. */
-    readonly request_from_buffers?: boolean
-    /** Used by {@link https://wiki.factorio.com/Programmable_speaker Programmable speaker}. */
-    readonly parameters?: ProgrammableSpeakerParameters
-    /** Used by {@link https://wiki.factorio.com/Programmable_speaker Programmable speaker}. */
-    readonly alert_parameters?: ProgrammableSpeakerAlertParameters
-    /** Used by the rocket silo, whether auto launch is enabled. */
-    readonly auto_launch?: boolean
-    /** Used by {@link https://wiki.factorio.com/Prototype/SimpleEntityWithForce Prototype/SimpleEntityWithForce} or {@link https://wiki.factorio.com/Prototype/SimpleEntityWithOwner Prototype/SimpleEntityWithOwner}. */
-    readonly variation?: uint8
-    /** Color of the {@link https://wiki.factorio.com/Prototype/SimpleEntityWithForce Prototype/SimpleEntityWithForce}, {@link https://wiki.factorio.com/Prototype/SimpleEntityWithOwner Prototype/SimpleEntityWithOwner}, or train station. */
-    readonly color?: Color
-    /** The name of the train station. */
-    readonly station?: string
-  }
-  /**
-   * Information about a single connection between two connection points.
-   *
-   * {@link https://wiki.factorio.com/Blueprint_string_format#Connection_data_object View Documentation}
-   */
-  export interface BlueprintConnectionData {
-    /** ID of the entity this connection is connected with. */
-    entity_id: uint
-    /** The circuit connector id of the entity this connection is connected to. */
-    circuit_id?: defines.wire_connector_id
-  }
-  /**
-   * The actual point where a wire is connected to. Contains information about where it is connected to.
-   *
-   * {@link https://wiki.factorio.com/Blueprint_string_format#Connection_point_object View Documentation}
-   */
-  export interface BlueprintConnectionPoint {
+    readonly blue_signal?: SignalID
     /**
-     * An array of {@link BlueprintConnectionData Connection data object} containing all the connections from this point
-     * created by red wire.
+     * Used by lamps.
      */
-    red?: BlueprintConnectionData[]
+    readonly rgb_signal?: SignalID
     /**
-     * An array of {@link BlueprintConnectionData Connection data object} containing all the connections from this point
-     * created by green wire.
+     * Used by roboports.
      */
-    green?: BlueprintConnectionData[]
-  }
-  /**
-   * Object containing information about the connections to other entities formed by red or green wires.
-   *
-   * {@link https://wiki.factorio.com/Blueprint_string_format#Connection_object View Documentation}
-   */
-  export interface BlueprintCircuitConnection {
-    /** First connection point. The default for everything that doesn't have multiple connection points. */
-    "1"?: BlueprintConnectionPoint
-    /** Second connection point. For example, the "output" part of an arithmetic combinator. */
-    "2"?: BlueprintConnectionPoint
-  }
-  export interface BlueprintInventory {
-    readonly filters?: InventoryFilter[]
-    /** The index of the first inaccessible item slot due to limiting with the red "bar". 0-based. */
-    readonly bar?: uint16
-  }
-  export interface BlueprintInfinitySettings {
-    /** Whether the "remove unfiltered items" checkbox is checked. */
-    readonly remove_unfiltered_items: boolean
-    /** Filters of the infinity container. */
-    readonly filters?: InfinityInventoryFilter[]
-  }
-  /**
-   * WARNING: this type has not yet been updated for factorio 2.0.
-   */
-  export interface BlueprintControlBehavior {
-    readonly condition?: CircuitCondition
-    readonly circuit_condition?: CircuitCondition
-    readonly is_on?: boolean
-    readonly arithmetic_conditions?: ArithmeticCombinatorParameters
-    readonly decider_conditions?: DeciderCombinatorParameters
-    readonly circuit_enable_disable?: boolean
-    readonly circuit_read_resources?: boolean
-    readonly circuit_resource_read_mode?: defines.control_behavior.mining_drill.resource_read_mode
-    readonly read_stopped_train?: boolean
-    readonly train_stopped_signal?: SignalID
-    readonly read_from_train?: boolean
-    readonly send_to_train?: boolean
-    readonly circuit_mode_of_operation?: number
-    readonly circuit_read_hand_contents?: boolean
-    readonly circuit_hand_read_mode?: defines.control_behavior.inserter.hand_read_mode
-    readonly circuit_set_stack_size?: boolean
-    readonly stack_control_input_signal?: SignalID
-    readonly use_colors?: boolean
+    readonly read_items_mode?:
+      | defines.control_behavior.roboport.read_items_mode
+      | defines.control_behavior.rocket_silo.read_mode
     readonly read_robot_stats?: boolean
-    readonly read_logistics?: boolean
-    readonly available_logistic_output_signal?: boolean
-    readonly total_logistic_output_signal?: boolean
-    readonly available_construction_output_signal?: boolean
-    readonly total_construction_output_signal?: boolean
-    readonly circuit_contents_read_mode?: defines.control_behavior.transport_belt.content_read_mode
-    readonly output_signal?: SignalID
-    readonly circuit_close_signal?: boolean
-    readonly circuit_read_signal?: boolean
-    readonly red_output_signal?: SignalID
-    readonly orange_output_signal?: SignalID
-    readonly green_output_signal?: SignalID
-    readonly blue_output_signal?: SignalID
-    readonly circuit_open_gate?: boolean
-    readonly circuit_read_sensor?: boolean
-    readonly circuit_parameters?: ProgrammableSpeakerCircuitParameters
-  }
-  /**
-   * Write form of {@link BlueprintEntity}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/BlueprintEntity.html Online documentation}
-   */
-  export interface BlueprintEntityWrite {
+    readonly available_logistic_output_signal?: SignalID
+    readonly total_logistic_output_signal?: SignalID
+    readonly available_construction_output_signal?: SignalID
+    readonly total_construction_output_signal?: SignalID
+    readonly roboport_count_output_signal?: SignalID
     /**
-     * The entity's unique identifier in the blueprint.
+     * Used by train signals.
      */
-    readonly entity_number: uint
+    readonly circuit_close_signal?: boolean
     /**
-     * The prototype name of the entity.
+     * Used by train signals.
      */
-    readonly name: string
+    readonly circuit_read_signal?: boolean
     /**
-     * The position of the entity.
+     * Used by **train signals**. For lamps, seed {@link red_signal }.
      */
-    readonly position: MapPosition | MapPositionArray
+    readonly red_output_signal?: SignalID
     /**
-     * The direction the entity is facing. Only present for entities that can face in different directions and when the entity is not facing north.
+     * used by train signals.
      */
-    readonly direction?: defines.direction
+    readonly orange_output_signal?: SignalID
     /**
-     * Whether this entity is mirrored.
+     * Used by **train signals**. For lamps, seed {@link green_signal }.
      */
-    readonly mirror?: boolean
+    readonly green_output_signal?: SignalID
     /**
-     * The prototype name of the entity's quality.
+     * Used by **train signals**. For lamps, seed {@link blue_signal }.
      */
-    readonly quality?: string
+    readonly blue_output_signal?: SignalID
     /**
-     * The control behavior of the entity, if it has one. The format of the control behavior depends on the entity's type. Only relevant for entities that support control behaviors.
+     * Used by programmable speakers.
      */
-    readonly control_behavior?: BlueprintControlBehavior
+    readonly circuit_parameters?: ProgrammableSpeakerCircuitParameters
     /**
-     * The items that the entity will request when revived, if any.
+     * Display panel configuration.
      */
-    readonly items?: readonly BlueprintInsertPlanWrite[]
+    readonly parameters?: DisplayPanelMessageDefinitionWrite
     /**
-     * The entity tags of the entity, if there are any.
+     * If this reads the fuel contents of this reactor.
      */
-    readonly tags?: Tags
+    readonly read_burner_fuel?: boolean
     /**
-     * The schedule of the entity, if it has one. Only relevant for locomotives.
+     * If this reads the temperature of this reactor.
      */
-    readonly schedule?: BlueprintScheduleWrite
+    readonly read_temperature?: boolean
+    readonly temperature_signal?: SignalID
     /**
-     * Wires connected to this entity in the blueprint.
+     * Used by space platform hub.
      */
-    readonly wires?: BlueprintWire[]
-    /** Orientation of the cargo wagon or locomotive, value 0 to 1 */
-    readonly orientation?: RealOrientation
-    /** Copper wire connections, array of entity_numbers */
-    readonly neighbours?: uint[]
-    /** Name of the recipe prototype this assembling machine is set to. */
-    readonly recipe?: string
-    /** Used by {@link https://wiki.factorio.com/Prototype/Container Prototype/Container}. The index of the first inaccessible item slot due to limiting with the red "bar". 0-based. */
-    readonly bar?: uint16
-    /** Cargo wagon inventory configuration */
-    readonly inventory?: BlueprintInventory
-    /** Used by {@link https://wiki.factorio.com/Prototype/InfinityContainer Prototype/InfinityContainer}. */
-    readonly infinity_settings?: BlueprintInfinitySettings | InfinityPipeFilter
-    /** Type of the underground belt or loader. Either "input" or "output". */
-    readonly type?: "input" | "output"
-    /** Input priority of the splitter. Either "right" or "left", "none" is omitted. */
-    readonly input_priority?: "right" | "left"
-    /** Output priority of the splitter. Either "right" or "left", "none" is omitted. */
-    readonly output_priority?: "right" | "left"
-    /** Filter of the splitter. Name of the item prototype the filter is set to. */
-    readonly filter?: string
-    /** Filters of the filter inserter or loader. Array of {@link InventoryFilter} objects. */
-    readonly filters?: InventoryFilter[]
-    /** Filter mode of the filter inserter. Either "whitelist" or "blacklist". */
-    readonly filter_mode?: "whitelist" | "blacklist"
-    /** The stack size the inserter is set to. */
-    readonly override_stack_size?: uint8
-    /** The drop position the inserter is set to. */
-    readonly drop_position?: MapPosition
-    /** The pickup position the inserter is set to. */
-    readonly pickup_position?: MapPosition
-    /** Used by {@link https://wiki.factorio.com/Prototype/LogisticContainer Prototype/LogisticContainer}. */
-    readonly request_filters?: LogisticFilter[]
-    /** Whether this requester chest can request from buffer chests. */
-    readonly request_from_buffers?: boolean
-    /** Used by {@link https://wiki.factorio.com/Programmable_speaker Programmable speaker}. */
-    readonly parameters?: ProgrammableSpeakerParameters
-    /** Used by {@link https://wiki.factorio.com/Programmable_speaker Programmable speaker}. */
-    readonly alert_parameters?: ProgrammableSpeakerAlertParameters
-    /** Used by the rocket silo, whether auto launch is enabled. */
-    readonly auto_launch?: boolean
-    /** Used by {@link https://wiki.factorio.com/Prototype/SimpleEntityWithForce Prototype/SimpleEntityWithForce} or {@link https://wiki.factorio.com/Prototype/SimpleEntityWithOwner Prototype/SimpleEntityWithOwner}. */
-    readonly variation?: uint8
-    /** Color of the {@link https://wiki.factorio.com/Prototype/SimpleEntityWithForce Prototype/SimpleEntityWithForce}, {@link https://wiki.factorio.com/Prototype/SimpleEntityWithOwner Prototype/SimpleEntityWithOwner}, or train station. */
-    readonly color?: Color
-    /** The name of the train station. */
-    readonly station?: string
+    readonly send_to_platform?: boolean
+    readonly read_moving_from?: boolean
+    readonly read_moving_to?: boolean
+    readonly read_speed?: boolean
+    readonly speed_signal?: SignalID
+    readonly read_damage_taken?: boolean
+    readonly damage_taken_signal?: SignalID
   }
   /**
    * A string that represents a math expression. The expression parser recognizes four basic token types (with their regex):
@@ -3137,7 +3824,7 @@ declare module "factorio:runtime" {
    * "2500 * (L - 3)"
    * @example
    * "(4e5 * (abs(speed) + 10.5)) / weight"
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/MathExpression.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/MathExpression.html Online documentation}
    */
   export type MathExpression = string
   /**
@@ -3159,7 +3846,7 @@ declare module "factorio:runtime" {
    * -- What a custom recipe would look like that had a probability of 0.5 to return a
    * -- minimum amount of 1 and a maximum amount of 5
    * {{type="item", name="custom-item", probability=0.5, amount_min=1, amount_max=5}}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Product.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Product.html Online documentation}
    */
   export type Product = ItemProduct | FluidProduct | ResearchProgressProduct
   /**
@@ -3170,7 +3857,7 @@ declare module "factorio:runtime" {
    * -- What a custom recipe would look like that had a probability of 0.5 to return a
    * -- minimum amount of 1 and a maximum amount of 5
    * {{type="item", name="custom-item", probability=0.5, amount_min=1, amount_max=5}}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ItemProduct.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ItemProduct.html Online documentation}
    */
   export interface ItemProduct {
     readonly type: "item"
@@ -3214,7 +3901,7 @@ declare module "factorio:runtime" {
    * {{type="fluid", name="heavy-oil", amount=1},
    *   {type="fluid", name="light-oil", amount=4.5},
    *   {type="fluid", name="petroleum-gas", amount=5.5}}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/FluidProduct.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/FluidProduct.html Online documentation}
    */
   export interface FluidProduct {
     readonly type: "fluid"
@@ -3260,6 +3947,28 @@ declare module "factorio:runtime" {
     readonly research_item: string
     readonly amount: double
   }
+  /**
+   * @see LogisticSectionsWrite
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LogisticSections.html Online documentation}
+   */
+  export interface LogisticSections {
+    readonly sections?: LogisticSection[]
+    /**
+     * Defaults to false.
+     */
+    readonly trash_not_requested?: boolean
+  }
+  /**
+   * Write form of {@link LogisticSections}, where some properties allow additional values as input compared to the read form.
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LogisticSections.html Online documentation}
+   */
+  export interface LogisticSectionsWrite {
+    readonly sections?: readonly LogisticSectionWrite[]
+    /**
+     * Defaults to false.
+     */
+    readonly trash_not_requested?: boolean
+  }
   export interface CompiledLogisticFilter {
     readonly index: LogisticFilterIndex
     /**
@@ -3285,9 +3994,103 @@ declare module "factorio:runtime" {
      */
     readonly minimum_delivery_count?: ItemCountType
   }
+  /**
+   * @see LogisticSectionWrite
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LogisticSection.html Online documentation}
+   */
+  export interface LogisticSection {
+    readonly index: uint8
+    readonly filters?: BlueprintLogisticFilter[]
+    readonly group?: string
+    /**
+     * Defaults to 1.
+     */
+    readonly multiplier?: float
+    /**
+     * Defaults to true.
+     */
+    readonly active?: float
+  }
+  /**
+   * Write form of {@link LogisticSection}, where some properties allow additional values as input compared to the read form.
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LogisticSection.html Online documentation}
+   */
+  export interface LogisticSectionWrite {
+    readonly index: uint8
+    readonly filters?: readonly BlueprintLogisticFilterWrite[]
+    readonly group?: string
+    /**
+     * Defaults to 1.
+     */
+    readonly multiplier?: float
+    /**
+     * Defaults to true.
+     */
+    readonly active?: float
+  }
+  /**
+   * @see BlueprintLogisticFilterWrite
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintLogisticFilter.html Online documentation}
+   */
+  export interface BlueprintLogisticFilter {
+    readonly index: LogisticFilterIndex
+    /**
+     * The type of the logistic filter.
+     */
+    readonly type?: SignalIDType
+    /**
+     * Name of the logistic filter.
+     */
+    readonly name?: string
+    /**
+     * The prototype name of the quality. `nil` for any quality.
+     */
+    readonly quality?: string
+    /**
+     * The comparator for quality. `nil` if any quality.
+     */
+    readonly comparator?: ComparatorStringRead
+    readonly count: int
+    readonly max_count?: ItemCountType
+    /**
+     * Defaults to 0.
+     */
+    readonly minimum_delivery_count?: ItemCountType
+    readonly import_from?: string
+  }
+  /**
+   * Write form of {@link BlueprintLogisticFilter}, where some properties allow additional values as input compared to the read form.
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintLogisticFilter.html Online documentation}
+   */
+  export interface BlueprintLogisticFilterWrite {
+    readonly index: LogisticFilterIndex
+    /**
+     * The type of the logistic filter.
+     */
+    readonly type?: SignalIDType
+    /**
+     * Name of the logistic filter.
+     */
+    readonly name?: string
+    /**
+     * The prototype name of the quality. `nil` for any quality.
+     */
+    readonly quality?: string
+    /**
+     * The comparator for quality. `nil` if any quality.
+     */
+    readonly comparator?: ComparatorString
+    readonly count: int
+    readonly max_count?: ItemCountType
+    /**
+     * Defaults to 0.
+     */
+    readonly minimum_delivery_count?: ItemCountType
+    readonly import_from?: string
+  }
   /**
    * Specifies how probability and richness are calculated when placing something on the map.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/AutoplaceSpecification.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/AutoplaceSpecification.html Online documentation}
    */
   export interface AutoplaceSpecification {
     /**
@@ -3304,7 +4107,7 @@ declare module "factorio:runtime" {
   }
   /**
    * @see CliffPlacementSettingsWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/CliffPlacementSettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/CliffPlacementSettings.html Online documentation}
    */
   export interface CliffPlacementSettings {
     /**
@@ -3334,7 +4137,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link CliffPlacementSettings}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/CliffPlacementSettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/CliffPlacementSettings.html Online documentation}
    */
   export interface CliffPlacementSettingsWrite {
     /**
@@ -3364,7 +4167,7 @@ declare module "factorio:runtime" {
   }
   /**
    * @see AutoplaceSettingsWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/AutoplaceSettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/AutoplaceSettings.html Online documentation}
    */
   export interface AutoplaceSettings {
     /**
@@ -3378,7 +4181,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link AutoplaceSettings}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/AutoplaceSettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/AutoplaceSettings.html Online documentation}
    */
   export interface AutoplaceSettingsWrite {
     /**
@@ -3413,7 +4216,7 @@ declare module "factorio:runtime" {
    * surface.map_gen_settings = mgs
    * -- This does not require a NamedNoiseExpression to be defined, since literal numbers (and strings naming literal
    * -- numbers, e.g. `"123"`) are understood to stand for constant value expressions.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/MapGenSettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/MapGenSettings.html Online documentation}
    */
   export interface MapGenSettings {
     /**
@@ -3468,7 +4271,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link MapGenSettings}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/MapGenSettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/MapGenSettings.html Online documentation}
    */
   export interface MapGenSettingsWrite {
     /**
@@ -3527,7 +4330,7 @@ declare module "factorio:runtime" {
   }
   /**
    * These values are for the time frame of one second (60 ticks).
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/PollutionMapSettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/PollutionMapSettings.html Online documentation}
    */
   export interface PollutionMapSettings {
     /**
@@ -3581,7 +4384,7 @@ declare module "factorio:runtime" {
   }
   /**
    * These values represent a percentual increase in evolution. This means a value of `0.1` would increase evolution by 10%.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EnemyEvolutionMapSettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EnemyEvolutionMapSettings.html Online documentation}
    */
   export interface EnemyEvolutionMapSettings {
     /**
@@ -3619,7 +4422,7 @@ declare module "factorio:runtime" {
    *     * neighbouring_base_chunk_coefficient^distance(chunk, neighbour)
    * score(chunk) = 1 / (1 + player + base)
    * ```
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EnemyExpansionMapSettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EnemyExpansionMapSettings.html Online documentation}
    */
   export interface EnemyExpansionMapSettings {
     /**
@@ -3878,17 +4681,17 @@ declare module "factorio:runtime" {
   }
   /**
    * Technology difficulty settings. Updating any of the attributes will immediately take effect in the game engine.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/DifficultySettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/DifficultySettings.html Online documentation}
    */
   export interface DifficultySettings {
     /**
      * A value in range [0.001, 1000].
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/DifficultySettings.technology_price_multiplier.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/DifficultySettings.technology_price_multiplier.html Online documentation}
      */
     technology_price_multiplier: double
     /**
      * A value in range [0.01, 100].
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/DifficultySettings.spoil_time_modifier.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/DifficultySettings.spoil_time_modifier.html Online documentation}
      */
     spoil_time_modifier: double
   }
@@ -3904,7 +4707,7 @@ declare module "factorio:runtime" {
   }
   /**
    * A standard table containing all {@link MapSettings} attributes plus an additional table that contains all {@link DifficultySettings} properties.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/MapAndDifficultySettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/MapAndDifficultySettings.html Online documentation}
    */
   export interface MapAndDifficultySettings {
     readonly pollution: PollutionMapSettings
@@ -3925,7 +4728,7 @@ declare module "factorio:runtime" {
    * @example
    * -- Increase the number of short paths the pathfinder can cache.
    * game.map_settings.path_finder.short_cache_size = 15
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/MapSettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/MapSettings.html Online documentation}
    */
   export interface MapSettings {
     pollution: PollutionMapSettings
@@ -3937,13 +4740,13 @@ declare module "factorio:runtime" {
     asteroids: AsteroidMapSettings
     /**
      * If a behavior fails this many times, the enemy (or enemy group) is destroyed. This solves biters getting stuck within their own base.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/MapSettings.max_failed_behavior_count.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/MapSettings.max_failed_behavior_count.html Online documentation}
      */
     max_failed_behavior_count: uint
   }
   /**
    * @see BlueprintScheduleRecordWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/BlueprintScheduleRecord.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintScheduleRecord.html Online documentation}
    */
   export interface BlueprintScheduleRecord {
     /**
@@ -3960,7 +4763,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link BlueprintScheduleRecord}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/BlueprintScheduleRecord.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintScheduleRecord.html Online documentation}
    */
   export interface BlueprintScheduleRecordWrite {
     /**
@@ -3977,7 +4780,7 @@ declare module "factorio:runtime" {
   }
   /**
    * @see BlueprintScheduleInterruptWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/BlueprintScheduleInterrupt.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintScheduleInterrupt.html Online documentation}
    */
   export interface BlueprintScheduleInterrupt {
     readonly name?: string
@@ -3987,7 +4790,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link BlueprintScheduleInterrupt}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/BlueprintScheduleInterrupt.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintScheduleInterrupt.html Online documentation}
    */
   export interface BlueprintScheduleInterruptWrite {
     readonly name?: string
@@ -3997,7 +4800,7 @@ declare module "factorio:runtime" {
   }
   /**
    * @see BlueprintScheduleWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/BlueprintSchedule.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintSchedule.html Online documentation}
    */
   export interface BlueprintSchedule {
     readonly records?: BlueprintScheduleRecord[]
@@ -4006,7 +4809,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link BlueprintSchedule}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/BlueprintSchedule.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintSchedule.html Online documentation}
    */
   export interface BlueprintScheduleWrite {
     readonly records?: readonly BlueprintScheduleRecordWrite[]
@@ -4015,7 +4818,7 @@ declare module "factorio:runtime" {
   }
   /**
    * @see WaitConditionWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/WaitCondition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/WaitCondition.html Online documentation}
    */
   export interface WaitCondition {
     readonly type: WaitConditionType
@@ -4046,7 +4849,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link WaitCondition}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/WaitCondition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/WaitCondition.html Online documentation}
    */
   export interface WaitConditionWrite {
     readonly type: WaitConditionType
@@ -4105,7 +4908,7 @@ declare module "factorio:runtime" {
    * - `"at_station"`
    * - `"not_at_station"`
    * - `"damage_taken"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/WaitConditionType.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/WaitConditionType.html Online documentation}
    */
   export type WaitConditionType =
     | "time"
@@ -4147,7 +4950,7 @@ declare module "factorio:runtime" {
    * - `"blueprint-snap-rectangle"`: Green by default.
    * - `"spidertron-remote-selected"`
    * - `"spidertron-remote-to-be-selected"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/CursorBoxRenderType.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/CursorBoxRenderType.html Online documentation}
    */
   export type CursorBoxRenderType =
     | "entity"
@@ -4163,7 +4966,7 @@ declare module "factorio:runtime" {
     | "spidertron-remote-to-be-selected"
   /**
    * What is shown in the map view. If a field is not given, that setting will not be changed.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/MapViewSettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/MapViewSettings.html Online documentation}
    */
   export interface MapViewSettings {
     readonly "show-logistic-network"?: boolean
@@ -4256,7 +5059,7 @@ declare module "factorio:runtime" {
    * - `"collision-selection-box"`: 189
    * - `"arrow"`: 190
    * - `"cursor"`: 226
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/RenderLayer.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/RenderLayer.html Online documentation}
    */
   export type RenderLayer =
     | `${bigint}`
@@ -4352,7 +5155,7 @@ declare module "factorio:runtime" {
    * - `"entity-with-quality"`
    * - `"recipe-with-quality"`
    * - `"equipment-with-quality"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ElemType.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ElemType.html Online documentation}
    */
   export type ElemType =
     | "achievement"
@@ -4379,7 +5182,7 @@ declare module "factorio:runtime" {
    * - `"left"`
    * - `"right"`
    * - `"none"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SwitchState.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SwitchState.html Online documentation}
    */
   export type SwitchState = "left" | "right" | "none"
   export interface ElemID {
@@ -4419,7 +5222,7 @@ declare module "factorio:runtime" {
    * - `"destroy-decoratives"`
    * - `"camera-effect"`
    * - `"activate-impact"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TriggerEffectItemType.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TriggerEffectItemType.html Online documentation}
    */
   export type TriggerEffectItemType =
     | "damage"
@@ -4455,7 +5258,7 @@ declare module "factorio:runtime" {
   }
   /**
    * A set of trigger target masks.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TriggerTargetMask.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TriggerTargetMask.html Online documentation}
    */
   export type TriggerTargetMask = Record<string, true>
   export interface TriggerItem {
@@ -4522,7 +5325,7 @@ declare module "factorio:runtime" {
    * -- If 'entity-description.furnace' exists, it is concatenated with "\n" and returned. Otherwise, if 'item-description.furnace'
    * --  exists, it is returned as-is. Otherwise, "optional fallback" is returned. If this value wasn't specified, the
    * --  translation result would be "Unknown key: 'item-description.furnace'".
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LocalisedString.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LocalisedString.html Online documentation}
    */
   export type LocalisedString = string | number | boolean | LuaObject | nil | [string, ...LocalisedString[]]
   export interface DisplayResolution {
@@ -4533,7 +5336,7 @@ declare module "factorio:runtime" {
    * The smooth orientation. It is a {@link float} in the range `[0, 1)` that covers a full circle, starting at the top and going clockwise. This means a value of `0` indicates "north", a value of `0.5` indicates "south".
    *
    * For example then, a value of `0.625` would indicate "south-west", and a value of `0.875` would indicate "north-west".
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/RealOrientation.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/RealOrientation.html Online documentation}
    */
   export type RealOrientation = float
   /**
@@ -4548,7 +5351,7 @@ declare module "factorio:runtime" {
    * @example
    * -- Shorthand
    * {1.625, 2.375}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/MapPosition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/MapPosition.html Online documentation}
    */
   export interface MapPosition {
     readonly x: double
@@ -4557,13 +5360,13 @@ declare module "factorio:runtime" {
   /**
    * Array form of {@link MapPosition}.
    * @see MapPosition
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/MapPosition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/MapPosition.html Online documentation}
    */
   export type MapPositionArray = readonly [double, double]
   /**
    * Coordinates of a chunk in a {@link LuaSurface} where each integer `x`/`y` represents a different chunk. This uses the same format as {@link MapPosition}, meaning it can be specified either with or without explicit keys. A {@link MapPosition} can be translated to a ChunkPosition by dividing the `x`/`y` values by 32.
    * @see ChunkPositionArray
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ChunkPosition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ChunkPosition.html Online documentation}
    */
   export interface ChunkPosition {
     readonly x: int
@@ -4572,13 +5375,13 @@ declare module "factorio:runtime" {
   /**
    * Array form of {@link ChunkPosition}.
    * @see ChunkPosition
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ChunkPosition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ChunkPosition.html Online documentation}
    */
   export type ChunkPositionArray = readonly [int, int]
   /**
    * Coordinates of a tile on a {@link LuaSurface} where each integer `x`/`y` represents a different tile. This uses the same format as {@link MapPosition}, except it rounds any non-integer `x`/`y` down to whole numbers. It can be specified either with or without explicit keys.
    * @see TilePositionArray
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TilePosition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TilePosition.html Online documentation}
    */
   export interface TilePosition {
     readonly x: int
@@ -4587,7 +5390,7 @@ declare module "factorio:runtime" {
   /**
    * Array form of {@link TilePosition}.
    * @see TilePosition
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TilePosition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TilePosition.html Online documentation}
    */
   export type TilePositionArray = readonly [int, int]
   /**
@@ -4600,7 +5403,7 @@ declare module "factorio:runtime" {
    * @example
    * -- Shorthand
    * {1, 2}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EquipmentPosition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EquipmentPosition.html Online documentation}
    */
   export interface EquipmentPosition {
     readonly x: int
@@ -4609,13 +5412,13 @@ declare module "factorio:runtime" {
   /**
    * Array form of {@link EquipmentPosition}.
    * @see EquipmentPosition
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EquipmentPosition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EquipmentPosition.html Online documentation}
    */
   export type EquipmentPositionArray = readonly [int, int]
   /**
    * Screen coordinates of a GUI element in a {@link LuaGui}. This uses the same format as {@link TilePosition}, meaning it can be specified either with or without explicit keys.
    * @see GuiLocationArray
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GuiLocation.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GuiLocation.html Online documentation}
    */
   export interface GuiLocation {
     readonly x: int
@@ -4624,12 +5427,12 @@ declare module "factorio:runtime" {
   /**
    * Array form of {@link GuiLocation}.
    * @see GuiLocation
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GuiLocation.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GuiLocation.html Online documentation}
    */
   export type GuiLocationArray = readonly [int, int]
   /**
    * A {@link ChunkPosition} with an added bounding box for the area of the chunk.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ChunkPositionAndArea.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ChunkPositionAndArea.html Online documentation}
    */
   export interface ChunkPositionAndArea {
     readonly x: int
@@ -4638,7 +5441,7 @@ declare module "factorio:runtime" {
   }
   /**
    * A table used to define a manual shape for a piece of equipment.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EquipmentPoint.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EquipmentPoint.html Online documentation}
    */
   export interface EquipmentPoint {
     readonly x: uint
@@ -4674,7 +5477,7 @@ declare module "factorio:runtime" {
    * Note that the API returns tags as a simple table, meaning any modifications to it will not propagate back to the game. Thus, to modify a set of tags, the whole table needs to be written back to the respective property.
    * @example
    * {a = 1, b = true, c = "three", d = {e = "f"}}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Tags.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Tags.html Online documentation}
    */
   export type Tags = Record<string, AnyBasic>
   export interface SurfaceCondition {
@@ -4708,13 +5511,13 @@ declare module "factorio:runtime" {
    * A vector is a two-element array or dictionary containing the `x` and `y` components. The game will always provide the array format. Positive x goes east, positive y goes south.
    * @example
    * right = {1.0, 0.0}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Vector.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Vector.html Online documentation}
    */
   export type Vector = MapPositionArray
   /**
    * An area defined using the map editor.
    * @see ScriptAreaWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ScriptArea.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ScriptArea.html Online documentation}
    */
   export interface ScriptArea {
     readonly area: BoundingBox
@@ -4724,7 +5527,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link ScriptArea}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ScriptArea.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ScriptArea.html Online documentation}
    */
   export interface ScriptAreaWrite {
     readonly area: BoundingBoxWrite | BoundingBoxArray
@@ -4735,7 +5538,7 @@ declare module "factorio:runtime" {
   /**
    * A position defined using the map editor.
    * @see ScriptPositionWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ScriptPosition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ScriptPosition.html Online documentation}
    */
   export interface ScriptPosition {
     readonly position: MapPosition
@@ -4745,7 +5548,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link ScriptPosition}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ScriptPosition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ScriptPosition.html Online documentation}
    */
   export interface ScriptPositionWrite {
     readonly position: MapPosition | MapPositionArray
@@ -4763,7 +5566,7 @@ declare module "factorio:runtime" {
    * red2 = {r = 0.5, a = 0.5}                -- Same color as red1
    * black = {}                               -- All channels omitted: black
    * red1_short = {0.5, 0, 0, 0.5}            -- Same color as red1 in short-hand notation
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Color.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Color.html Online documentation}
    */
   export interface Color {
     readonly r?: float
@@ -4774,13 +5577,13 @@ declare module "factorio:runtime" {
   /**
    * Array form of {@link Color}.
    * @see Color
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Color.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Color.html Online documentation}
    */
   export type ColorArray = readonly [r: double, g: double, b: double, a?: double]
   /**
    * Same as {@link Color}, but red, green, blue and alpha values can be any floating point number, without any special handling of the range [1, 255].
    * @see ColorModifierArray
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ColorModifier.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ColorModifier.html Online documentation}
    */
   export interface ColorModifier {
     readonly r?: float
@@ -4791,7 +5594,7 @@ declare module "factorio:runtime" {
   /**
    * Array form of {@link ColorModifier}.
    * @see ColorModifier
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ColorModifier.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ColorModifier.html Online documentation}
    */
   export type ColorModifierArray = readonly [r: double, g: double, b: double, a?: double]
   export interface CraftingQueueItem {
@@ -4934,7 +5737,7 @@ declare module "factorio:runtime" {
   }
   /**
    * @see AsteroidChunkWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/AsteroidChunk.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/AsteroidChunk.html Online documentation}
    */
   export interface AsteroidChunk {
     /**
@@ -4946,7 +5749,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link AsteroidChunk}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/AsteroidChunk.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/AsteroidChunk.html Online documentation}
    */
   export interface AsteroidChunkWrite {
     /**
@@ -4968,7 +5771,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Either `icon`, `text`, or both must be provided.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ChartTagSpec.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ChartTagSpec.html Online documentation}
    */
   export interface ChartTagSpec {
     readonly position: MapPosition | MapPositionArray
@@ -4978,88 +5781,88 @@ declare module "factorio:runtime" {
   }
   /**
    * Parameters that affect the look and control of the game. Updating any of the member attributes here will immediately take effect in the game engine.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.html Online documentation}
    */
   export interface GameViewSettings {
     /**
      * Show the controller GUI elements. This includes the toolbar, the selected tool slot, the armour slot, and the gun and ammunition slots.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_controller_gui.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_controller_gui.html Online documentation}
      */
     show_controller_gui: boolean
     /**
      * Show the chart in the upper right-hand corner of the screen.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_minimap.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_minimap.html Online documentation}
      */
     show_minimap: boolean
     /**
      * Show research progress and name in the upper right-hand corner of the screen.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_research_info.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_research_info.html Online documentation}
      */
     show_research_info: boolean
     /**
      * Show overlay icons on entities. Also known as "alt-mode".
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_entity_info.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_entity_info.html Online documentation}
      */
     show_entity_info: boolean
     /**
      * Show the flashing alert icons next to the player's toolbar.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_alert_gui.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_alert_gui.html Online documentation}
      */
     show_alert_gui: boolean
     /**
      * When `true` (the default), mousing over an entity will select it. Otherwise, moving the mouse won't update entity selection.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.update_entity_selection.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.update_entity_selection.html Online documentation}
      */
     update_entity_selection: boolean
     /**
      * When `true` (`false` is default), the rails will always show the rail block visualisation.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_rail_block_visualisation.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_rail_block_visualisation.html Online documentation}
      */
     show_rail_block_visualisation: boolean
     /**
      * Shows or hides the buttons row.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_side_menu.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_side_menu.html Online documentation}
      */
     show_side_menu: boolean
     /**
      * Shows or hides the view options when map is opened.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_map_view_options.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_map_view_options.html Online documentation}
      */
     show_map_view_options: boolean
     /**
      * Shows or hides the tooltip that is displayed when selecting an entity.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_entity_tooltip.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_entity_tooltip.html Online documentation}
      */
     show_entity_tooltip: boolean
     /**
      * Shows or hides quickbar of shortcuts.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_quickbar.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_quickbar.html Online documentation}
      */
     show_quickbar: boolean
     /**
      * Shows or hides the shortcut bar.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_shortcut_bar.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_shortcut_bar.html Online documentation}
      */
     show_shortcut_bar: boolean
     /**
      * Shows or hides the crafting queue.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_crafting_queue.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_crafting_queue.html Online documentation}
      */
     show_crafting_queue: boolean
     /**
      * Shows or hides the tool window with the weapons and armor.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_tool_bar.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_tool_bar.html Online documentation}
      */
     show_tool_bar: boolean
     /**
      * hows or hides the mouse and keyboard/controller button hints in the bottom left corner if they are enabled in the interface settings.
-     * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GameViewSettings.show_hotkey_suggestions.html Online documentation}
+     * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GameViewSettings.show_hotkey_suggestions.html Online documentation}
      */
     show_hotkey_suggestions: boolean
   }
   /**
    * The data that can be extracted from a map exchange string, as a plain table.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/MapExchangeStringData.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/MapExchangeStringData.html Online documentation}
    */
   export interface MapExchangeStringData {
     readonly map_settings: MapAndDifficultySettings
@@ -5092,12 +5895,12 @@ declare module "factorio:runtime" {
    * - `target_entity_number`
    *
    * - `target_wire_connector_id`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/BlueprintWire.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/BlueprintWire.html Online documentation}
    */
   export type BlueprintWire = readonly [uint, defines.wire_connector_id, uint, defines.wire_connector_id]
   /**
    * @see TileWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Tile.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Tile.html Online documentation}
    */
   export interface Tile {
     /**
@@ -5111,7 +5914,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link Tile}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Tile.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Tile.html Online documentation}
    */
   export interface TileWrite {
     /**
@@ -5166,7 +5969,7 @@ declare module "factorio:runtime" {
    *
    * Other attributes may be specified depending on `type`:
    * - `"fluid"`: {@link FluidIngredient}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Ingredient.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Ingredient.html Online documentation}
    */
   export type Ingredient = FluidIngredient | OtherIngredient
   export interface Loot {
@@ -5332,7 +6135,7 @@ declare module "factorio:runtime" {
    * - `"unlock-recipe"`: {@link UnlockRecipeTechnologyModifier}
    * - `"nothing"`: {@link NothingTechnologyModifier}
    * - Other types: {@link OtherTechnologyModifier}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TechnologyModifier.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TechnologyModifier.html Online documentation}
    */
   export type TechnologyModifier =
     | GunSpeedTechnologyModifier
@@ -5344,7 +6147,7 @@ declare module "factorio:runtime" {
     | OtherTechnologyModifier
   /**
    * A fragment of a functional program used to generate coherent noise, probably for purposes related to terrain generation. These can only be meaningfully written/modified during the data load phase. More detailed information is found on the {@link import("factorio:prototype").NamedNoiseExpression prototype docs}.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/NoiseExpression.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/NoiseExpression.html Online documentation}
    */
   export interface NoiseExpression {
     /**
@@ -5397,7 +6200,7 @@ declare module "factorio:runtime" {
    * - `"very-high"`: equivalent to `2`.
    * - `"very-big"`: equivalent to `2`.
    * - `"very-good"`: equivalent to `2`.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/MapGenSize.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/MapGenSize.html Online documentation}
    */
   export type MapGenSize =
     | float
@@ -5419,7 +6222,7 @@ declare module "factorio:runtime" {
     | "very-good"
   /**
    * @see AutoplaceControlWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/AutoplaceControl.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/AutoplaceControl.html Online documentation}
    */
   export interface AutoplaceControl {
     /**
@@ -5437,7 +6240,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link AutoplaceControl}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/AutoplaceControl.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/AutoplaceControl.html Online documentation}
    */
   export interface AutoplaceControlWrite {
     /**
@@ -5456,10 +6259,10 @@ declare module "factorio:runtime" {
   /**
    * All other MapGenSettings feed into named noise expressions, and therefore placement can be overridden by including the name of a property in this dictionary. The probability and richness functions for placing specific tiles, entities, and decoratives can be overridden by including an entry named `{tile|entity|decorative}:(prototype name):{probability|richness}`.
    *
-   * {@link https://lua-api.factorio.com/2.0.17/concepts/PropertyExpressionNames.html > Values either name a NamedNoiseExpression or can be literal numbers, stored as strings (e.g. `5`). All other controls can be overridden by a property expression names. Notable properties:}
+   * {@link https://lua-api.factorio.com/2.0.21/concepts/PropertyExpressionNames.html > Values either name a NamedNoiseExpression or can be literal numbers, stored as strings (e.g. `5`). All other controls can be overridden by a property expression names. Notable properties:}
    *
-   * {@link https://lua-api.factorio.com/2.0.17/concepts/PropertyExpressionNames.html > Climate controls ('Moisture' and 'Terrain type' at the bottom of the Terrain tab in the map generator GUI) don't have their own dedicated structures in MapGenSettings. Instead, their values are stored as property expression overrides with long names:}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/PropertyExpressionNames.html Online documentation}
+   * {@link https://lua-api.factorio.com/2.0.21/concepts/PropertyExpressionNames.html > Climate controls ('Moisture' and 'Terrain type' at the bottom of the Terrain tab in the map generator GUI) don't have their own dedicated structures in MapGenSettings. Instead, their values are stored as property expression overrides with long names:}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/PropertyExpressionNames.html Online documentation}
    */
   export type PropertyExpressionNames = Record<string, string>
   export interface AdvancedMapGenSettings {
@@ -5492,7 +6295,7 @@ declare module "factorio:runtime" {
   }
   /**
    * An actual signal transmitted by the network.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Signal.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Signal.html Online documentation}
    */
   export interface Signal {
     /**
@@ -5506,7 +6309,7 @@ declare module "factorio:runtime" {
   }
   /**
    * @see UpgradeMapperSourceWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/UpgradeMapperSource.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/UpgradeMapperSource.html Online documentation}
    */
   export interface UpgradeMapperSource {
     readonly type: "item" | "entity"
@@ -5525,7 +6328,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link UpgradeMapperSource}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/UpgradeMapperSource.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/UpgradeMapperSource.html Online documentation}
    */
   export interface UpgradeMapperSourceWrite {
     readonly type: "item" | "entity"
@@ -5562,7 +6365,7 @@ declare module "factorio:runtime" {
   }
   /**
    * A single filter used by an infinity-filters instance.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/InfinityInventoryFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/InfinityInventoryFilter.html Online documentation}
    */
   export interface InfinityInventoryFilter {
     /**
@@ -5584,7 +6387,7 @@ declare module "factorio:runtime" {
   }
   /**
    * A single filter used by an infinity-pipe type entity.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/InfinityPipeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/InfinityPipeFilter.html Online documentation}
    */
   export interface InfinityPipeFilter {
     /**
@@ -5638,7 +6441,7 @@ declare module "factorio:runtime" {
   }
   /**
    * The settings used by a heat-interface type entity.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/HeatSetting.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/HeatSetting.html Online documentation}
    */
   export interface HeatSetting {
     /**
@@ -5720,7 +6523,7 @@ declare module "factorio:runtime" {
   }
   /**
    * @see CircuitConditionWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/CircuitCondition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/CircuitCondition.html Online documentation}
    */
   export interface CircuitCondition {
     /**
@@ -5742,7 +6545,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link CircuitCondition}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/CircuitCondition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/CircuitCondition.html Online documentation}
    */
   export interface CircuitConditionWrite {
     /**
@@ -5764,7 +6567,7 @@ declare module "factorio:runtime" {
   }
   /**
    * @see CircuitConditionDefinitionWrite
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/CircuitConditionDefinition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/CircuitConditionDefinition.html Online documentation}
    */
   export interface CircuitConditionDefinition {
     /**
@@ -5778,7 +6581,7 @@ declare module "factorio:runtime" {
   }
   /**
    * Write form of {@link CircuitConditionDefinition}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/CircuitConditionDefinition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/CircuitConditionDefinition.html Online documentation}
    */
   export interface CircuitConditionDefinitionWrite {
     /**
@@ -6067,7 +6870,7 @@ declare module "factorio:runtime" {
    * - {@link defines.command.stop}: {@link StopCommand}
    * - {@link defines.command.flee}: {@link FleeCommand}
    * - {@link defines.command.build_base}: {@link BuildBaseCommand}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Command.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Command.html Online documentation}
    */
   export type Command =
     | AttackCommand
@@ -6081,7 +6884,7 @@ declare module "factorio:runtime" {
     | BuildBaseCommand
   /**
    * Write form of {@link Command}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Command.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Command.html Online documentation}
    */
   export type CommandWrite =
     | AttackCommand
@@ -6166,7 +6969,7 @@ declare module "factorio:runtime" {
    * These are both full stacks of iron plates (for iron-plate, a full stack is 100 plates)
    * "iron-plate"
    * {name="iron-plate", count=100}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SimpleItemStack.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SimpleItemStack.html Online documentation}
    */
   export type SimpleItemStack = string | ItemStackDefinition
   /**
@@ -6176,7 +6979,7 @@ declare module "factorio:runtime" {
    * - SurfaceIndex: It will be the index of the surface. `nauvis` has index `1`, the first surface-created surface will have index `2` and so on.
    * - `string`: It will be the surface name. E.g. `"nauvis"`.
    * - {@link LuaSurface}: A reference to {@link LuaSurface} may be passed directly.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SurfaceIdentification.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SurfaceIdentification.html Online documentation}
    */
   export type SurfaceIdentification = SurfaceIndex | string | LuaSurface
   /**
@@ -6186,7 +6989,7 @@ declare module "factorio:runtime" {
    * - PlayerIndex: The player index.
    * - `string`: The player name.
    * - {@link LuaPlayer}: A reference to {@link LuaPlayer} may be passed directly.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/PlayerIdentification.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/PlayerIdentification.html Online documentation}
    */
   export type PlayerIdentification = PlayerIndex | string | LuaPlayer
   /**
@@ -6195,7 +6998,7 @@ declare module "factorio:runtime" {
    * ## Union members
    * - {@link SimpleItemStack}
    * - {@link LuaItemStack}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ItemStackIdentification.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ItemStackIdentification.html Online documentation}
    */
   export type ItemStackIdentification = SimpleItemStack | LuaItemStack
   /**
@@ -6205,7 +7008,7 @@ declare module "factorio:runtime" {
    * - `"entity"`: Fires at an entity.
    * - `"position"`: Fires directly at a position.
    * - `"direction"`: Fires in a direction.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TargetType.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TargetType.html Online documentation}
    */
   export type TargetType = "entity" | "position" | "direction"
   export interface BeamTarget {
@@ -6242,14 +7045,10 @@ declare module "factorio:runtime" {
    *
    * The validity of a SoundPath can be verified at runtime using {@link LuaHelpers#is_valid_sound_path LuaHelpers::is_valid_sound_path}.
    *
-   * {@link https://lua-api.factorio.com/2.0.17/concepts/SoundPath.html > The utility and ambient types each contain general use sound prototypes defined by the game itself.}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SoundPath.html Online documentation}
+   * {@link https://lua-api.factorio.com/2.0.21/concepts/SoundPath.html > The utility and ambient types each contain general use sound prototypes defined by the game itself.}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SoundPath.html Online documentation}
    */
-  export type SoundPath =
-    | (string & {
-        _?: never
-      })
-    | `${SoundCategory}/${string}`
+  export type SoundPath = (string & { _?: never }) | `${SoundCategory}/${string}`
   export interface CircularParticleCreationSpecification {
     /**
      * Name of the {@link LuaEntityPrototype}.
@@ -6379,7 +7178,7 @@ declare module "factorio:runtime" {
    * Other attributes may be specified depending on `type`:
    * - `"projectile"`: {@link ProjectileAttackParameters}
    * - `"stream"`: {@link StreamAttackParameters}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/AttackParameters.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/AttackParameters.html Online documentation}
    */
   export type AttackParameters = ProjectileAttackParameters | StreamAttackParameters | OtherAttackParameters
   export interface GunShift4Way {
@@ -6445,7 +7244,7 @@ declare module "factorio:runtime" {
    * - `"use-on-self"`: {@link UseOnSelfCapsuleAction}
    * - `"artillery-remote"`: {@link ArtilleryRemoteCapsuleAction}
    * - `"destroy-cliffs"`: {@link DestroyCliffsCapsuleAction}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/CapsuleAction.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/CapsuleAction.html Online documentation}
    */
   export type CapsuleAction =
     | ThrowCapsuleAction
@@ -6485,12 +7284,12 @@ declare module "factorio:runtime" {
   }
   /**
    * Any basic type (string, number, boolean) or table.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/AnyBasic.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/AnyBasic.html Online documentation}
    */
   export type AnyBasic = string | boolean | number | table
   /**
    * Any basic type (string, number, boolean), table, or LuaObject.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Any.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Any.html Online documentation}
    */
   export type Any = string | boolean | number | table | LuaObject
   export interface ProgrammableSpeakerParameters {
@@ -6528,7 +7327,7 @@ declare module "factorio:runtime" {
    * - `"top-right"`
    * - `"right"`: The same as `"middle-right"`
    * - `"bottom-right"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/Alignment.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/Alignment.html Online documentation}
    */
   export type Alignment =
     | "top-left"
@@ -6542,9 +7341,27 @@ declare module "factorio:runtime" {
     | "top-right"
     | "right"
     | "bottom-right"
+  export type RaiseableEvents =
+    | typeof defines.events.on_console_chat
+    | typeof defines.events.on_player_crafted_item
+    | typeof defines.events.on_player_fast_transferred
+    | typeof defines.events.on_biter_base_built
+    | typeof defines.events.on_market_item_purchased
+    | typeof defines.events.script_raised_built
+    | typeof defines.events.script_raised_destroy
+    | typeof defines.events.script_raised_revive
+    | typeof defines.events.script_raised_teleported
+    | typeof defines.events.script_raised_set_tiles
+  export type EventId<T extends object, F = unknown> = uint & {
+    readonly _eventData: T
+    readonly _filter: F
+  }
+  export type CustomEventId<T extends table> = EventId<T> & {
+    _customEventIdBrand: any
+  }
   /**
-   * Information about the event that has been raised. The table can also contain other fields depending on the type of event. See {@linkplain https://lua-api.factorio.com/2.0.17/events.html the list of Factorio events} for more information on these.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EventData.html Online documentation}
+   * Information about the event that has been raised. The table can also contain other fields depending on the type of event. See {@linkplain https://lua-api.factorio.com/2.0.21/events.html the list of Factorio events} for more information on these.
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EventData.html Online documentation}
    */
   export interface EventData {
     /**
@@ -6649,7 +7466,7 @@ declare module "factorio:runtime" {
    * - `"button-7"`
    * - `"button-8"`
    * - `"button-9"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/MouseButtonFlags.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/MouseButtonFlags.html Online documentation}
    */
   export interface MouseButtonFlags {
     readonly left?: true
@@ -6662,7 +7479,6 @@ declare module "factorio:runtime" {
     readonly "button-8"?: true
     readonly "button-9"?: true
   }
-  /** @see MouseButtonFlags */
   export type MouseButtonFlagsWrite = MouseButtonFlags | ReadonlyArray<keyof MouseButtonFlags | "left-and-right">
   /**
    * ## Union members
@@ -6673,7 +7489,7 @@ declare module "factorio:runtime" {
    * - `"not-friend"`: Forces which are not friends pass.
    * - `"same"`: The same force pass.
    * - `"not-same"`: The non-same forces pass.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ForceCondition.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ForceCondition.html Online documentation}
    */
   export type ForceCondition = "all" | "enemy" | "ally" | "friend" | "not-friend" | "same" | "not-same"
   export interface ItemStackLocation {
@@ -6711,7 +7527,7 @@ declare module "factorio:runtime" {
    * - `"tabbed-pane"`: A collection of `tab`s and their contents. Relevant event: {@link OnGuiSelectedTabChangedEvent on_gui_selected_tab_changed}
    * - `"tab"`: A tab for use in a `tabbed-pane`.
    * - `"switch"`: A switch with three possible states. Can have labels attached to either side. Relevant event: {@link OnGuiSwitchStateChangedEvent on_gui_switch_state_changed}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GuiElementType.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GuiElementType.html Online documentation}
    */
   export type GuiElementType =
     | "button"
@@ -6751,7 +7567,7 @@ declare module "factorio:runtime" {
    * - `"position"`
    * - `"crafting_queue"`
    * - `"item_stack"`: Will point to a given item stack in an inventory.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GuiArrowType.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GuiArrowType.html Online documentation}
    */
   export type GuiArrowType =
     | "nowhere"
@@ -6768,7 +7584,7 @@ declare module "factorio:runtime" {
    * ## Union members
    * - `"horizontal"`
    * - `"vertical"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/GuiDirection.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/GuiDirection.html Online documentation}
    */
   export type GuiDirection = "horizontal" | "vertical"
   /**
@@ -6780,7 +7596,7 @@ declare module "factorio:runtime" {
    * - `"always"`
    * - `"auto"`
    * - `"auto-and-reserve-space"`
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ScrollPolicy.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ScrollPolicy.html Online documentation}
    */
   export type ScrollPolicy = "never" | "dont-show-but-allow-scrolling" | "always" | "auto" | "auto-and-reserve-space"
   export interface RailLocation {
@@ -6797,71 +7613,71 @@ declare module "factorio:runtime" {
   }
   /**
    * A floating-point number. This is a single-precision floating point number. Whilst Lua only uses double-precision numbers, when a function takes a float, the game engine will immediately convert the double-precision number to single-precision.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/float.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/float.html Online documentation}
    */
   export type float = number
   /**
    * A double-precision floating-point number. This is the same data type as all Lua numbers use.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/double.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/double.html Online documentation}
    */
   export type double = number
   /**
    * 32-bit signed integer. Possible values are `-2 147 483 648` to `2 147 483 647`.
    *
    * Since Lua 5.2 only uses doubles, any API that asks for `int` will floor the given double.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/int.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/int.html Online documentation}
    */
   export type int = number
   /**
    * 8-bit signed integer. Possible values are `-128` to `127`.
    *
    * Since Lua 5.2 only uses doubles, any API that asks for `int8` will floor the given double.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/int8.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/int8.html Online documentation}
    */
   export type int8 = number
   /**
    * 32-bit unsigned integer. Possible values are `0` to `4 294 967 295`.
    *
    * Since Lua 5.2 only uses doubles, any API that asks for `uint` will floor the given double.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/uint.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/uint.html Online documentation}
    */
   export type uint = number
   /**
    * 8-bit unsigned integer. Possible values are `0` to `255`.
    *
    * Since Lua 5.2 only uses doubles, any API that asks for `uint8` will floor the given double.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/uint8.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/uint8.html Online documentation}
    */
   export type uint8 = number
   /**
    * 16-bit unsigned integer. Possible values are `0` to `65 535`.
    *
    * Since Lua 5.2 only uses doubles, any API that asks for `uint16` will floor the given double.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/uint16.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/uint16.html Online documentation}
    */
   export type uint16 = number
   /**
    * 64-bit unsigned integer. Possible values are `0` to `18 446 744 073 709 551 615`.
    *
    * Since Lua 5.2 only uses doubles, any API that asks for `uint64` will floor the given double.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/uint64.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/uint64.html Online documentation}
    */
   export type uint64 = number
   /**
    * Nil is the type of the value `nil`, whose main property is to be different from any other value. It usually represents the absence of a useful value.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/nil.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/nil.html Online documentation}
    */
   export type nil = undefined
   /**
    * Tables are enclosed in curly brackets, like this `{}`.
    *
    * Throughout the API docs, the terms "array" and "dictionary" are used. These are fundamentally just {@linkplain http://www.lua.org/pil/2.5.html Lua tables}, but have a limitation on which kind of table keys can be used. An array is a table that uses continuous integer keys starting at `1`, while a dictionary can use numeric or string keys in any order or combination.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/table.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/table.html Online documentation}
    */
   export type table = object
   /**
-   * Any LuaObject listed on the {@linkplain https://lua-api.factorio.com/2.0.17/classes.html Classes} page.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaObject.html Online documentation}
+   * Any LuaObject listed on the {@linkplain https://lua-api.factorio.com/2.0.21/classes.html Classes} page.
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaObject.html Online documentation}
    */
   export interface LuaObject {
     readonly object_name: string
@@ -6920,7 +7736,7 @@ declare module "factorio:runtime" {
    * - `"type"`: {@link TypeModSettingPrototypeFilter}
    * - `"mod"`: {@link ModModSettingPrototypeFilter}
    * - `"setting-type"`: {@link SettingTypeModSettingPrototypeFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ModSettingPrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ModSettingPrototypeFilter.html Online documentation}
    */
   export type ModSettingPrototypeFilter =
     | TypeModSettingPrototypeFilter
@@ -7065,7 +7881,7 @@ declare module "factorio:runtime" {
    * - `"vehicle-friction-modifier"`: {@link VehicleFrictionModifierTilePrototypeFilter}
    * - `"decorative-removal-probability"`: {@link DecorativeRemovalProbabilityTilePrototypeFilter}
    * - `"absorptions-per-second"`: {@link AbsorptionsPerSecondTilePrototypeFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TilePrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TilePrototypeFilter.html Online documentation}
    */
   export type TilePrototypeFilter =
     | CollisionMaskTilePrototypeFilter
@@ -7076,7 +7892,7 @@ declare module "factorio:runtime" {
     | OtherTilePrototypeFilter
   /**
    * Write form of {@link TilePrototypeFilter}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TilePrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TilePrototypeFilter.html Online documentation}
    */
   export type TilePrototypeFilterWrite =
     | CollisionMaskTilePrototypeFilter
@@ -7127,7 +7943,7 @@ declare module "factorio:runtime" {
    *
    * Other attributes may be specified depending on `filter`:
    * - `"collision-mask"`: {@link CollisionMaskDecorativePrototypeFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/DecorativePrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/DecorativePrototypeFilter.html Online documentation}
    */
   export type DecorativePrototypeFilter = CollisionMaskDecorativePrototypeFilter | OtherDecorativePrototypeFilter
   /**
@@ -7381,7 +8197,7 @@ declare module "factorio:runtime" {
    * - `"emissions-multiplier"`: {@link EmissionsMultiplierRecipePrototypeFilter}
    * - `"request-paste-multiplier"`: {@link RequestPasteMultiplierRecipePrototypeFilter}
    * - `"overload-multiplier"`: {@link OverloadMultiplierRecipePrototypeFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/RecipePrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/RecipePrototypeFilter.html Online documentation}
    */
   export type RecipePrototypeFilter =
     | HasIngredientItemRecipePrototypeFilter
@@ -7397,7 +8213,7 @@ declare module "factorio:runtime" {
     | OtherRecipePrototypeFilter
   /**
    * Write form of {@link RecipePrototypeFilter}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/RecipePrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/RecipePrototypeFilter.html Online documentation}
    */
   export type RecipePrototypeFilterWrite =
     | HasIngredientItemRecipePrototypeFilterWrite
@@ -7449,7 +8265,7 @@ declare module "factorio:runtime" {
    *
    * Other attributes may be specified depending on `filter`:
    * - `"type"`: {@link TypeAchievementPrototypeFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/AchievementPrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/AchievementPrototypeFilter.html Online documentation}
    */
   export type AchievementPrototypeFilter = TypeAchievementPrototypeFilter | OtherAchievementPrototypeFilter
   /**
@@ -7572,7 +8388,7 @@ declare module "factorio:runtime" {
    * - `"level"`: {@link LevelTechnologyPrototypeFilter}
    * - `"max-level"`: {@link MaxLevelTechnologyPrototypeFilter}
    * - `"time"`: {@link TimeTechnologyPrototypeFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TechnologyPrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TechnologyPrototypeFilter.html Online documentation}
    */
   export type TechnologyPrototypeFilter =
     | ResearchUnitIngredientTechnologyPrototypeFilter
@@ -7583,7 +8399,7 @@ declare module "factorio:runtime" {
     | OtherTechnologyPrototypeFilter
   /**
    * Write form of {@link TechnologyPrototypeFilter}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/TechnologyPrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/TechnologyPrototypeFilter.html Online documentation}
    */
   export type TechnologyPrototypeFilterWrite =
     | ResearchUnitIngredientTechnologyPrototypeFilter
@@ -7900,7 +8716,7 @@ declare module "factorio:runtime" {
    * - `"fuel-acceleration-multiplier"`: {@link FuelAccelerationMultiplierItemPrototypeFilter}
    * - `"fuel-top-speed-multiplier"`: {@link FuelTopSpeedMultiplierItemPrototypeFilter}
    * - `"fuel-emissions-multiplier"`: {@link FuelEmissionsMultiplierItemPrototypeFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ItemPrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ItemPrototypeFilter.html Online documentation}
    */
   export type ItemPrototypeFilter =
     | PlaceResultItemPrototypeFilter
@@ -7920,7 +8736,7 @@ declare module "factorio:runtime" {
     | OtherItemPrototypeFilter
   /**
    * Write form of {@link ItemPrototypeFilter}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/ItemPrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/ItemPrototypeFilter.html Online documentation}
    */
   export type ItemPrototypeFilterWrite =
     | PlaceResultItemPrototypeFilterWrite
@@ -7976,7 +8792,7 @@ declare module "factorio:runtime" {
    *
    * Other attributes may be specified depending on `filter`:
    * - `"type"`: {@link TypeEquipmentPrototypeFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EquipmentPrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EquipmentPrototypeFilter.html Online documentation}
    */
   export type EquipmentPrototypeFilter = TypeEquipmentPrototypeFilter | OtherEquipmentPrototypeFilter
   /**
@@ -8207,7 +9023,7 @@ declare module "factorio:runtime" {
    * - `"selection-priority"`: {@link SelectionPriorityEntityPrototypeFilter}
    * - `"emissions-per-second"`: {@link EmissionsPerSecondEntityPrototypeFilter}
    * - `"crafting-category"`: {@link CraftingCategoryEntityPrototypeFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EntityPrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EntityPrototypeFilter.html Online documentation}
    */
   export type EntityPrototypeFilter =
     | NameEntityPrototypeFilter
@@ -8221,7 +9037,7 @@ declare module "factorio:runtime" {
     | OtherEntityPrototypeFilter
   /**
    * Write form of {@link EntityPrototypeFilter}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/EntityPrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/EntityPrototypeFilter.html Online documentation}
    */
   export type EntityPrototypeFilterWrite =
     | NameEntityPrototypeFilter
@@ -8291,7 +9107,7 @@ declare module "factorio:runtime" {
    * Other attributes may be specified depending on `filter`:
    * - `"type"`: {@link TypeSpaceLocationPrototypeFilter}
    * - `"solar-power-in-space"`: {@link SolarPowerInSpaceSpaceLocationPrototypeFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SpaceLocationPrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SpaceLocationPrototypeFilter.html Online documentation}
    */
   export type SpaceLocationPrototypeFilter =
     | TypeSpaceLocationPrototypeFilter
@@ -8299,7 +9115,7 @@ declare module "factorio:runtime" {
     | OtherSpaceLocationPrototypeFilter
   /**
    * Write form of {@link SpaceLocationPrototypeFilter}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/SpaceLocationPrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/SpaceLocationPrototypeFilter.html Online documentation}
    */
   export type SpaceLocationPrototypeFilterWrite =
     | TypeSpaceLocationPrototypeFilter
@@ -8487,7 +9303,7 @@ declare module "factorio:runtime" {
    * - `"fuel-value"`: {@link FuelValueFluidPrototypeFilter}
    * - `"emissions-multiplier"`: {@link EmissionsMultiplierFluidPrototypeFilter}
    * - `"gas-temperature"`: {@link GasTemperatureFluidPrototypeFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/FluidPrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/FluidPrototypeFilter.html Online documentation}
    */
   export type FluidPrototypeFilter =
     | NameFluidPrototypeFilter
@@ -8501,7 +9317,7 @@ declare module "factorio:runtime" {
     | OtherFluidPrototypeFilter
   /**
    * Write form of {@link FluidPrototypeFilter}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/FluidPrototypeFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/FluidPrototypeFilter.html Online documentation}
    */
   export type FluidPrototypeFilterWrite =
     | NameFluidPrototypeFilter
@@ -8610,7 +9426,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NamePrePlatformMinedEntityEventFilter}
    * - `"ghost_type"`: {@link GhostTypePrePlatformMinedEntityEventFilter}
    * - `"ghost_name"`: {@link GhostNamePrePlatformMinedEntityEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaPrePlatformMinedEntityEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaPrePlatformMinedEntityEventFilter.html Online documentation}
    */
   export type LuaPrePlatformMinedEntityEventFilter =
     | TypePrePlatformMinedEntityEventFilter
@@ -8715,7 +9531,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NameRobotMinedEntityEventFilter}
    * - `"ghost_type"`: {@link GhostTypeRobotMinedEntityEventFilter}
    * - `"ghost_name"`: {@link GhostNameRobotMinedEntityEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaRobotMinedEntityEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaRobotMinedEntityEventFilter.html Online documentation}
    */
   export type LuaRobotMinedEntityEventFilter =
     | TypeRobotMinedEntityEventFilter
@@ -8820,7 +9636,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NameEntityMarkedForUpgradeEventFilter}
    * - `"ghost_type"`: {@link GhostTypeEntityMarkedForUpgradeEventFilter}
    * - `"ghost_name"`: {@link GhostNameEntityMarkedForUpgradeEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaEntityMarkedForUpgradeEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaEntityMarkedForUpgradeEventFilter.html Online documentation}
    */
   export type LuaEntityMarkedForUpgradeEventFilter =
     | TypeEntityMarkedForUpgradeEventFilter
@@ -8925,7 +9741,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NamePreGhostUpgradedEventFilter}
    * - `"ghost_type"`: {@link GhostTypePreGhostUpgradedEventFilter}
    * - `"ghost_name"`: {@link GhostNamePreGhostUpgradedEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaPreGhostUpgradedEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaPreGhostUpgradedEventFilter.html Online documentation}
    */
   export type LuaPreGhostUpgradedEventFilter =
     | TypePreGhostUpgradedEventFilter
@@ -9030,7 +9846,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NamePlatformMinedEntityEventFilter}
    * - `"ghost_type"`: {@link GhostTypePlatformMinedEntityEventFilter}
    * - `"ghost_name"`: {@link GhostNamePlatformMinedEntityEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaPlatformMinedEntityEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaPlatformMinedEntityEventFilter.html Online documentation}
    */
   export type LuaPlatformMinedEntityEventFilter =
     | TypePlatformMinedEntityEventFilter
@@ -9135,7 +9951,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NameScriptRaisedDestroyEventFilter}
    * - `"ghost_type"`: {@link GhostTypeScriptRaisedDestroyEventFilter}
    * - `"ghost_name"`: {@link GhostNameScriptRaisedDestroyEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaScriptRaisedDestroyEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaScriptRaisedDestroyEventFilter.html Online documentation}
    */
   export type LuaScriptRaisedDestroyEventFilter =
     | TypeScriptRaisedDestroyEventFilter
@@ -9252,7 +10068,7 @@ declare module "factorio:runtime" {
    * - `"ghost_type"`: {@link GhostTypePlayerBuiltEntityEventFilter}
    * - `"ghost_name"`: {@link GhostNamePlayerBuiltEntityEventFilter}
    * - `"force"`: {@link ForcePlayerBuiltEntityEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaPlayerBuiltEntityEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaPlayerBuiltEntityEventFilter.html Online documentation}
    */
   export type LuaPlayerBuiltEntityEventFilter =
     | TypePlayerBuiltEntityEventFilter
@@ -9370,7 +10186,7 @@ declare module "factorio:runtime" {
    * - `"ghost_type"`: {@link GhostTypePlatformBuiltEntityEventFilter}
    * - `"ghost_name"`: {@link GhostNamePlatformBuiltEntityEventFilter}
    * - `"force"`: {@link ForcePlatformBuiltEntityEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaPlatformBuiltEntityEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaPlatformBuiltEntityEventFilter.html Online documentation}
    */
   export type LuaPlatformBuiltEntityEventFilter =
     | TypePlatformBuiltEntityEventFilter
@@ -9476,7 +10292,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NamePreGhostDeconstructedEventFilter}
    * - `"ghost_type"`: {@link GhostTypePreGhostDeconstructedEventFilter}
    * - `"ghost_name"`: {@link GhostNamePreGhostDeconstructedEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaPreGhostDeconstructedEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaPreGhostDeconstructedEventFilter.html Online documentation}
    */
   export type LuaPreGhostDeconstructedEventFilter =
     | TypePreGhostDeconstructedEventFilter
@@ -9581,7 +10397,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NameEntityClonedEventFilter}
    * - `"ghost_type"`: {@link GhostTypeEntityClonedEventFilter}
    * - `"ghost_name"`: {@link GhostNameEntityClonedEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaEntityClonedEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaEntityClonedEventFilter.html Online documentation}
    */
   export type LuaEntityClonedEventFilter =
     | TypeEntityClonedEventFilter
@@ -9686,7 +10502,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NameScriptRaisedTeleportedEventFilter}
    * - `"ghost_type"`: {@link GhostTypeScriptRaisedTeleportedEventFilter}
    * - `"ghost_name"`: {@link GhostNameScriptRaisedTeleportedEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaScriptRaisedTeleportedEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaScriptRaisedTeleportedEventFilter.html Online documentation}
    */
   export type LuaScriptRaisedTeleportedEventFilter =
     | TypeScriptRaisedTeleportedEventFilter
@@ -9793,7 +10609,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NameEntityDeconstructionCancelledEventFilter}
    * - `"ghost_type"`: {@link GhostTypeEntityDeconstructionCancelledEventFilter}
    * - `"ghost_name"`: {@link GhostNameEntityDeconstructionCancelledEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaEntityDeconstructionCancelledEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaEntityDeconstructionCancelledEventFilter.html Online documentation}
    */
   export type LuaEntityDeconstructionCancelledEventFilter =
     | TypeEntityDeconstructionCancelledEventFilter
@@ -9910,7 +10726,7 @@ declare module "factorio:runtime" {
    * - `"ghost_type"`: {@link GhostTypeRobotBuiltEntityEventFilter}
    * - `"ghost_name"`: {@link GhostNameRobotBuiltEntityEventFilter}
    * - `"force"`: {@link ForceRobotBuiltEntityEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaRobotBuiltEntityEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaRobotBuiltEntityEventFilter.html Online documentation}
    */
   export type LuaRobotBuiltEntityEventFilter =
     | TypeRobotBuiltEntityEventFilter
@@ -10016,7 +10832,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NameScriptRaisedBuiltEventFilter}
    * - `"ghost_type"`: {@link GhostTypeScriptRaisedBuiltEventFilter}
    * - `"ghost_name"`: {@link GhostNameScriptRaisedBuiltEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaScriptRaisedBuiltEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaScriptRaisedBuiltEventFilter.html Online documentation}
    */
   export type LuaScriptRaisedBuiltEventFilter =
     | TypeScriptRaisedBuiltEventFilter
@@ -10121,7 +10937,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NamePrePlayerMinedEntityEventFilter}
    * - `"ghost_type"`: {@link GhostTypePrePlayerMinedEntityEventFilter}
    * - `"ghost_name"`: {@link GhostNamePrePlayerMinedEntityEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaPrePlayerMinedEntityEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaPrePlayerMinedEntityEventFilter.html Online documentation}
    */
   export type LuaPrePlayerMinedEntityEventFilter =
     | TypePrePlayerMinedEntityEventFilter
@@ -10226,7 +11042,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NamePlayerRepairedEntityEventFilter}
    * - `"ghost_type"`: {@link GhostTypePlayerRepairedEntityEventFilter}
    * - `"ghost_name"`: {@link GhostNamePlayerRepairedEntityEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaPlayerRepairedEntityEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaPlayerRepairedEntityEventFilter.html Online documentation}
    */
   export type LuaPlayerRepairedEntityEventFilter =
     | TypePlayerRepairedEntityEventFilter
@@ -10331,7 +11147,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NameUpgradeCancelledEventFilter}
    * - `"ghost_type"`: {@link GhostTypeUpgradeCancelledEventFilter}
    * - `"ghost_name"`: {@link GhostNameUpgradeCancelledEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaUpgradeCancelledEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaUpgradeCancelledEventFilter.html Online documentation}
    */
   export type LuaUpgradeCancelledEventFilter =
     | TypeUpgradeCancelledEventFilter
@@ -10436,7 +11252,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NameSectorScannedEventFilter}
    * - `"ghost_type"`: {@link GhostTypeSectorScannedEventFilter}
    * - `"ghost_name"`: {@link GhostNameSectorScannedEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaSectorScannedEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaSectorScannedEventFilter.html Online documentation}
    */
   export type LuaSectorScannedEventFilter =
     | TypeSectorScannedEventFilter
@@ -10482,7 +11298,7 @@ declare module "factorio:runtime" {
    *
    * Other attributes may be specified depending on `filter`:
    * - `"type"`: {@link TypePostEntityDiedEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaPostEntityDiedEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaPostEntityDiedEventFilter.html Online documentation}
    */
   export type LuaPostEntityDiedEventFilter = TypePostEntityDiedEventFilter | OtherPostEntityDiedEventFilter
   /**
@@ -10584,7 +11400,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NameEntityMarkedForDeconstructionEventFilter}
    * - `"ghost_type"`: {@link GhostTypeEntityMarkedForDeconstructionEventFilter}
    * - `"ghost_name"`: {@link GhostNameEntityMarkedForDeconstructionEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaEntityMarkedForDeconstructionEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaEntityMarkedForDeconstructionEventFilter.html Online documentation}
    */
   export type LuaEntityMarkedForDeconstructionEventFilter =
     | TypeEntityMarkedForDeconstructionEventFilter
@@ -10689,7 +11505,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NamePlayerMinedEntityEventFilter}
    * - `"ghost_type"`: {@link GhostTypePlayerMinedEntityEventFilter}
    * - `"ghost_name"`: {@link GhostNamePlayerMinedEntityEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaPlayerMinedEntityEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaPlayerMinedEntityEventFilter.html Online documentation}
    */
   export type LuaPlayerMinedEntityEventFilter =
     | TypePlayerMinedEntityEventFilter
@@ -10869,7 +11685,7 @@ declare module "factorio:runtime" {
    * - `"final-damage-amount"`: {@link FinalDamageAmountEntityDamagedEventFilter}
    * - `"damage-type"`: {@link DamageTypeEntityDamagedEventFilter}
    * - `"final-health"`: {@link FinalHealthEntityDamagedEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaEntityDamagedEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaEntityDamagedEventFilter.html Online documentation}
    */
   export type LuaEntityDamagedEventFilter =
     | TypeEntityDamagedEventFilter
@@ -10883,7 +11699,7 @@ declare module "factorio:runtime" {
     | OtherEntityDamagedEventFilter
   /**
    * Write form of {@link LuaEntityDamagedEventFilter}, where some properties allow additional values as input compared to the read form.
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaEntityDamagedEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaEntityDamagedEventFilter.html Online documentation}
    */
   export type LuaEntityDamagedEventFilterWrite =
     | TypeEntityDamagedEventFilter
@@ -10992,7 +11808,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NameScriptRaisedReviveEventFilter}
    * - `"ghost_type"`: {@link GhostTypeScriptRaisedReviveEventFilter}
    * - `"ghost_name"`: {@link GhostNameScriptRaisedReviveEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaScriptRaisedReviveEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaScriptRaisedReviveEventFilter.html Online documentation}
    */
   export type LuaScriptRaisedReviveEventFilter =
     | TypeScriptRaisedReviveEventFilter
@@ -11097,7 +11913,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NameEntityDiedEventFilter}
    * - `"ghost_type"`: {@link GhostTypeEntityDiedEventFilter}
    * - `"ghost_name"`: {@link GhostNameEntityDiedEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaEntityDiedEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaEntityDiedEventFilter.html Online documentation}
    */
   export type LuaEntityDiedEventFilter =
     | TypeEntityDiedEventFilter
@@ -11202,7 +12018,7 @@ declare module "factorio:runtime" {
    * - `"name"`: {@link NamePreRobotMinedEntityEventFilter}
    * - `"ghost_type"`: {@link GhostTypePreRobotMinedEntityEventFilter}
    * - `"ghost_name"`: {@link GhostNamePreRobotMinedEntityEventFilter}
-   * @see {@link https://lua-api.factorio.com/2.0.17/concepts/LuaPreRobotMinedEntityEventFilter.html Online documentation}
+   * @see {@link https://lua-api.factorio.com/2.0.21/concepts/LuaPreRobotMinedEntityEventFilter.html Online documentation}
    */
   export type LuaPreRobotMinedEntityEventFilter =
     | TypePreRobotMinedEntityEventFilter
@@ -11210,24 +12026,6 @@ declare module "factorio:runtime" {
     | GhostTypePreRobotMinedEntityEventFilter
     | GhostNamePreRobotMinedEntityEventFilter
     | OtherPreRobotMinedEntityEventFilter
-  export type StyleValuesArray =
-    | readonly [topBottom: int, leftRight: int]
-    | readonly [top: int, right: int, bottom: int, left: int]
-  export type SizeArray = readonly [width: int, height: int]
-  export type RaiseableEvents =
-    | typeof defines.events.on_console_chat
-    | typeof defines.events.on_player_crafted_item
-    | typeof defines.events.on_player_fast_transferred
-    | typeof defines.events.on_biter_base_built
-    | typeof defines.events.on_market_item_purchased
-    | typeof defines.events.script_raised_built
-    | typeof defines.events.script_raised_destroy
-    | typeof defines.events.script_raised_revive
-    | typeof defines.events.script_raised_teleported
-    | typeof defines.events.script_raised_set_tiles
-  /** An event id. */
-  export type EventId<T extends object, F = unknown> = uint & {
-    readonly _eventData: T
-    readonly _filter: F
-  }
+  export type StyleValuesArray = [topBottom: int, leftRight: int] | [top: int, right: int, bottom: int, left: int]
+  export type SizeArray = [width: int, height: int]
 }