typed-factorio 0.5.0 → 0.7.0

package/generated/concepts.d.ts

@@ -512,8 +512,310 @@ interface MapViewSettings {
 }
 
 /**
- * Various game-related settings. See `data/base/prototypes/map-settings.lua` for a description of all attributes.
- * Updating any of the attributes will immediately take effect in the game engine.
+ * These values are for the time frame of one second (60 ticks).
+ *
+ * {@link https://lua-api.factorio.com/next/Concepts.html#PollutionMapSettings View documentation}
+ */
+interface PollutionMapSettings {
+  /** Whether pollution is enabled at all. */
+  readonly enabled: boolean
+  /** The amount that is diffused to a neighboring chunk (possibly repeated for other directions as well). Defaults to `0.02`. */
+  readonly diffusion_ratio: double
+  /** The amount of PUs that need to be in a chunk for it to start diffusing. Defaults to `15`. */
+  readonly min_to_diffuse: double
+  /** The amount of pollution eaten by a chunk's tiles as a percentage of 1. Defaults to `1`. */
+  readonly aeging: double
+  /** Any amount of pollution larger than this value is visualized as this value instead. Defaults to `150`. */
+  readonly expected_max_per_chunk: double
+  /**
+   * Any amount of pollution smaller than this value (but bigger than zero) is visualized as this value instead.
+   * Defaults to `50`.
+   */
+  readonly min_to_show_per_chunk: double
+  /** Defaults to `60`. */
+  readonly min_pollution_to_damage_trees: double
+  /** Defaults to `150`. */
+  readonly pollution_with_max_forest_damage: double
+  /** Defaults to `50`. */
+  readonly pollution_per_tree_damage: double
+  /** Defaults to `10`. */
+  readonly pollution_restored_per_tree_damage: double
+  /** Defaults to `20`. */
+  readonly max_pollution_to_restore_trees: double
+  /** Defaults to `1`. */
+  readonly enemy_attack_pollution_consumption_modifier: double
+}
+
+/**
+ * These values represent a percentual increase in evolution. This means a value of `0.1` would increase evolution by 10%.
+ *
+ * {@link https://lua-api.factorio.com/next/Concepts.html#EnemyEvolutionMapSettings View documentation}
+ */
+interface EnemyEvolutionMapSettings {
+  /** Whether enemy evolution is enabled at all. */
+  readonly enabled: boolean
+  /** The amount evolution naturally progresses by every second. Defaults to `0.000004`. */
+  readonly time_factor: double
+  /** The amount evolution progresses for every destroyed spawner. Defaults to `0.002`. */
+  readonly destroy_factor: double
+  /** The amount evolution progresses for every unit of pollution. Defaults to `0.0000009`. */
+  readonly pollution_factor: double
+}
+
+/**
+ * Candidate chunks are given scores to determine which one of them should be expanded into. This score takes into
+ * account various settings noted below. The iteration is over a square region centered around the chunk for which the
+ * calculation is done, and includes the central chunk as well. Distances are calculated as
+ * {@link https://en.wikipedia.org/wiki/Taxicab_geometry Manhattan distance}.
+ *
+ * The pseudocode algorithm to determine a chunk's score is as follows:
+ *
+ * ```lua
+ * player = 0
+ * for neighbour in all chunks within enemy_building_influence_radius from chunk:
+ *   player += number of player buildings on neighbour
+ *           * building_coefficient
+ *           * neighbouring_chunk_coefficient^distance(chunk, neighbour)
+ *
+ * base = 0
+ * for neighbour in all chunk within friendly_base_influence_radius from chunk:
+ *   base += num of enemy bases on neighbour
+ *           * other_base_coefficient
+ *           * neighbouring_base_chunk_coefficient^distance(chunk, neighbour)
+ *
+ * score(chunk) = 1 / (1 + player + base)
+ * ```
+ *
+ * {@link https://lua-api.factorio.com/next/Concepts.html#EnemyExpansionMapSettings View documentation}
+ */
+interface EnemyExpansionMapSettings {
+  /** Whether enemy expansion is enabled at all. */
+  readonly enabled: boolean
+  /**
+   * Distance in chunks from the furthest base around to prevent expansions from reaching too far into the player's
+   * territory. Defaults to `7`.
+   */
+  readonly max_expansion_distance: uint
+  /** Defaults to `2`. */
+  readonly friendly_base_influence_radius: uint
+  /** Defaults to `2`. */
+  readonly enemy_building_influence_radius: uint
+  /** Defaults to `0.1`. */
+  readonly building_coefficient: double
+  /** Defaults to `2.0`. */
+  readonly other_base_coefficient: double
+  /** Defaults to `0.5`. */
+  readonly neighbouring_chunk_coefficient: double
+  /** Defaults to `0.4`. */
+  readonly neighbouring_base_chunk_coefficient: double
+  /**
+   * A chunk has to have at most this high of a percentage of unbuildable tiles for it to be considered a candidate to
+   * avoid chunks full of water as candidates. Defaults to `0.9`, or 90%.
+   */
+  readonly max_colliding_tiles_coefficient: double
+  /**
+   * The minimum size of a biter group that goes to build a new base. This is multiplied by the evolution factor.
+   * Defaults to `5`.
+   */
+  readonly settler_group_min_size: uint
+  /**
+   * The maximum size of a biter group that goes to build a new base. This is multiplied by the evolution factor.
+   * Defaults to `20`.
+   */
+  readonly settler_group_max_size: uint
+  /**
+   * The minimum time between expansions in ticks. The actual cooldown is adjusted to the current evolution levels.
+   * Defaults to `4*3,600=14,400` ticks.
+   */
+  readonly min_expansion_cooldown: uint
+  /**
+   * The maximum time between expansions in ticks. The actual cooldown is adjusted to the current evolution levels.
+   * Defaults to `60*3,600=216,000` ticks.
+   */
+  readonly max_expansion_cooldown: uint
+}
+
+interface UnitGroupMapSettings {
+  /**
+   * The minimum amount of time in ticks a group will spend gathering before setting off. The actual time is a random
+   * time between the minimum and maximum times. Defaults to `3,600` ticks.
+   */
+  readonly min_group_gathering_time: uint
+  /**
+   * The maximum amount of time in ticks a group will spend gathering before setting off. The actual time is a random
+   * time between the minimum and maximum times. Defaults to `10*3,600=36,000` ticks.
+   */
+  readonly max_group_gathering_time: uint
+  /**
+   * After gathering has finished, the group is allowed to wait this long in ticks for delayed members. New members
+   * are not accepted anymore however. Defaults to `2*3,600=7,200` ticks.
+   */
+  readonly max_wait_time_for_late_members: uint
+  /** The minimum group radius in tiles. The actual radius is adjusted based on the number of members. Defaults to `5.0`. */
+  readonly min_group_radius: double
+  /** The maximum group radius in tiles. The actual radius is adjusted based on the number of members. Defaults to `30.0`. */
+  readonly max_group_radius: double
+  /**
+   * The maximum speed a percentage of its regular speed that a group member can speed up to when catching up with the
+   * group. Defaults to `1.4`, or 140%.
+   */
+  readonly max_member_speedup_when_behind: double
+  /**
+   * The minimum speed a percentage of its regular speed that a group member can slow down to when ahead of the group.
+   * Defaults to `0.6`, or 60%.
+   */
+  readonly max_member_slowdown_when_ahead: double
+  /**
+   * The minimum speed as a percentage of its maximum speed that a group will slow down to so members that fell behind
+   * can catch up. Defaults to `0.3`, or 30%.
+   */
+  readonly max_group_slowdown_factor: double
+  /**
+   * When a member of a group falls back more than this factor times the group radius, the group will slow down to its
+   * `max_group_slowdown_factor` speed to let them catch up. Defaults to `3`.
+   */
+  readonly max_group_member_fallback_factor: double
+  /**
+   * When a member of a group falls back more than this factor times the group radius, it will be dropped from the
+   * group. Defaults to `10`.
+   */
+  readonly member_disown_distance: double
+  readonly tick_tolerance_when_member_arrives: uint
+  /** The maximum number of automatically created unit groups gathering for attack at any time. Defaults to `30`. */
+  readonly max_gathering_unit_groups: uint
+  /**
+   * The maximum number of members for an attack unit group. This only affects automatically created unit groups,
+   * manual groups created through the API are unaffected. Defaults to `200`.
+   */
+  readonly max_unit_group_size: uint
+}
+
+interface SteeringMapSetting {
+  /** Does not include the radius of the unit. */
+  readonly radius: double
+  readonly separation_factor: double
+  readonly separation_force: double
+  /** Used to make steering look better for aesthetic purposes. */
+  readonly force_unit_fuzzy_goto_behavior: boolean
+}
+
+interface SteeringMapSettings {
+  readonly default: SteeringMapSetting
+  readonly moving: SteeringMapSetting
+}
+
+interface PathFinderMapSettings {
+  /** Determines whether forwards (`>1`), backwards (`<-1`), or symmetrical (`1`) search is preferred. Defaults to `5`. */
+  readonly fwd2bwd_ratio: uint
+  /**
+   * When looking at which node to check next, their heuristic value is multiplied by this ratio. The higher it is,
+   * the more the search is directed straight at the goal. Defaults to `2`.
+   */
+  readonly goal_pressure_ratio: double
+  /** The maximum number of nodes that are expanded per tick. Defaults to `1,000`. */
+  readonly max_steps_worked_per_tick: double
+  /** The maximum amount of work each pathfinding job is allowed to do per tick. Defaults to `8,000`. */
+  readonly max_work_done_per_tick: uint
+  /** Whether to cache paths at all. Defaults to `true`. */
+  readonly use_path_cache: boolean
+  /** Number of elements in the short cache. Defaults to `5`. */
+  readonly short_cache_size: uint
+  /** Number of elements in the long cache. Defaults to `25`. */
+  readonly long_cache_size: uint
+  /** The minimal distance to the goal in tiles required to be searched in the short path cache. Defaults to `10`. */
+  readonly short_cache_min_cacheable_distance: double
+  /** The minimal number of nodes required to be searched in the short path cache. Defaults to `50`. */
+  readonly short_cache_min_algo_steps_to_cache: uint
+  /** The minimal distance to the goal in tiles required to be searched in the long path cache. Defaults to `30`. */
+  readonly long_cache_min_cacheable_distance: double
+  /**
+   * When looking for a connection to a cached path, search at most for this number of steps times the original
+   * estimate. Defaults to `100`.
+   */
+  readonly cache_max_connect_to_cache_steps_multiplier: uint
+  /**
+   * When looking for a path from cache, make sure it doesn't start too far from the requested start in relative
+   * terms. Defaults to `0.2`.
+   */
+  readonly cache_accept_path_start_distance_ratio: double
+  /**
+   * When looking for a path from cache, make sure it doesn't end too far from the requested end in relative terms.
+   * This is typically more lenient than the start ratio since the end target could be moving. Defaults to `0.15`.
+   */
+  readonly cache_accept_path_end_distance_ratio: double
+  /** Same principle as `cache_accept_path_start_distance_ratio`, but used for negative cache queries. Defaults to `0.3`. */
+  readonly negative_cache_accept_path_start_distance_ratio: double
+  /** Same principle as `cache_accept_path_end_distance_ratio`, but used for negative cache queries. Defaults to `0.3`. */
+  readonly negative_cache_accept_path_end_distance_ratio: double
+  /** When assigning a rating to the best path, this multiplier times start distances is considered. Defaults to `10`. */
+  readonly cache_path_start_distance_rating_multiplier: double
+  /**
+   * When assigning a rating to the best path, this multiplier times end distances is considered. This value is
+   * typically higher than the start multiplier as this results in better end path quality. Defaults to `20`.
+   */
+  readonly cache_path_end_distance_rating_multiplier: double
+  /**
+   * A penalty that is applied for another unit that is on the way to the goal. This is mainly relevant for situations
+   * where a group of units has arrived at the target they are supposed to attack, making units further back circle
+   * around to reach the target. Defaults to `30`.
+   */
+  readonly stale_enemy_with_same_destination_collision_penalty: double
+  /** The distance in tiles after which other moving units are not considered for pathfinding. Defaults to `5`. */
+  readonly ignore_moving_enemy_collision_distance: double
+  /**
+   * A penalty that is applied for another unit that is too close and either not moving or has a different goal.
+   * Defaults to `30`.
+   */
+  readonly enemy_with_different_destination_collision_penalty: double
+  /** The general collision penalty with other units. Defaults to `10`. */
+  readonly general_entity_collision_penalty: double
+  /** The collision penalty for positions that require the destruction of an entity to get to. Defaults to `3`. */
+  readonly general_entity_subsequent_collision_penalty: double
+  /**
+   * The collision penalty for collisions in the extended bounding box but outside the entity's actual bounding box.
+   * Defaults to `3`.
+   */
+  readonly extended_collision_penalty: double
+  /** The amount of path finder requests accepted per tick regardless of the requested path's length. Defaults to `10`. */
+  readonly max_clients_to_accept_any_new_request: uint
+  /**
+   * When the `max_clients_to_accept_any_new_request` amount is exhausted, only path finder requests with a short
+   * estimate will be accepted until this amount (per tick) is reached. Defaults to `100`.
+   */
+  readonly max_clients_to_accept_short_new_request: uint
+  /** The maximum direct distance in tiles before a request is no longer considered short. Defaults to `100`. */
+  readonly direct_distance_to_consider_short_request: uint
+  /** The maximum amount of nodes a short request will traverse before being rescheduled as a long request. Defaults to `1000`. */
+  readonly short_request_max_steps: uint
+  /**
+   * The amount of steps that are allocated to short requests each tick, as a percentage of all available steps.
+   * Defaults to `0.5`, or 50%.
+   */
+  readonly short_request_ratio: double
+  /** The minimum amount of steps that are guaranteed to be performed for every request. Defaults to `2000`. */
+  readonly min_steps_to_check_path_find_termination: uint
+  /**
+   * If the actual amount of steps is higher than the initial estimate by this factor, pathfinding is terminated.
+   * Defaults to `2000.0`.
+   */
+  readonly start_to_goal_cost_multiplier_to_terminate_path_find: double
+  /**
+   * The thresholds of waiting clients after each of which the per-tick work limit will be increased by the
+   * corresponding value in `overload_multipliers`. This is to avoid clients having to wait too long. Must have the
+   * same number of elements as `overload_multipliers`. Defaults to `{0, 100, 500}`.
+   */
+  readonly overload_levels: uint[]
+  /**
+   * The multipliers to the amount of per-tick work applied after the corresponding thresholds in `overload_levels`
+   * have been reached. Must have the same number of elements as `overload_multipliers`. Defaults to `{2, 3, 4}`.
+   */
+  readonly overload_multipliers: double[]
+  /** The delay in ticks between decrementing the score of all paths in the negative cache by one. Defaults to `20`. */
+  readonly negative_path_cache_delay_interval: uint
+}
+
+/**
+ * Various game-related settings. Updating any of the attributes will immediately take effect in the game engine.
  *
  * {@link https://lua-api.factorio.com/next/Concepts.html#MapSettings View documentation}
  *
@@ -525,227 +827,21 @@ interface MapViewSettings {
  *   ```
  */
 interface MapSettings {
-  readonly pollution: {
-    enabled: boolean
-    /**
-     * These are values for 60 ticks (1 simulated second)
-     *
-     * (possibly repeated for other directions as well)
-     */
-    diffusion_ratio: number
-    /** This much PUs must be on the chunk to start diffusing */
-    min_to_diffuse: number
-    /** Constant modifier a percentage of 1 - the pollution eaten by a chunks tiles */
-    ageing: number
-    /** Anything bigger than this is visualised as this value */
-    expected_max_per_chunk: number
-    /** Anything lower than this (but > 0) is visualised as this value */
-    min_to_show_per_chunk: number
-    min_pollution_to_damage_trees: number
-    pollution_with_max_forest_damage: number
-    pollution_per_tree_damage: number
-    pollution_restored_per_tree_damage: number
-    max_pollution_to_restore_trees: number
-    enemy_attack_pollution_consumption_modifier: number
-  }
-  readonly enemy_evolution: {
-    enabled: boolean
-    /** Percentual increase in the evolve factor for every second (60 ticks) */
-    time_factor: number
-    /** Percentual increase in the evolve factor for every destroyed spawner */
-    destroy_factor: number
-    /** Percentual increase in the evolve factor for 1 pollution unit */
-    pollution_factor: number
-  }
-  readonly enemy_expansion: {
-    enabled: boolean
-    /**
-     * Distance in chunks from the furthest base around.
-     *
-     * Player's territory
-     */
-    max_expansion_distance: number
-    friendly_base_influence_radius: number
-    enemy_building_influence_radius: number
-    /**
-     * A candidate chunk's score is given as follows:
-     *
-     * And includes the central chunk as well. distance is the Manhattan distance, and ^ signifies exponentiation.
-     */
-    building_coefficient: number
-    other_base_coefficient: number
-    neighbouring_chunk_coefficient: number
-    neighbouring_base_chunk_coefficient: number
-    /**
-     * A chunk has to have at most this much percent unbuildable tiles for it to be considered a candidate.
-     *
-     * This is to avoid chunks full of water to be marked as candidates.
-     */
-    max_colliding_tiles_coefficient: number
-    /**
-     * Size of the group that goes to build new base (in game this is multiplied by the
-     *
-     * Evolution factor).
-     */
-    settler_group_min_size: number
-    settler_group_max_size: number
-    /**
-     * Ticks to expand to a single
-     *
-     * Where lerp is the linear interpolation function, and e is the current evolution factor.
-     */
-    min_expansion_cooldown: number
-    max_expansion_cooldown: number
-  }
-  readonly unit_group: {
-    /** Pollution triggered group waiting time is a random time between min and max gathering time */
-    min_group_gathering_time: number
-    max_group_gathering_time: number
-    /**
-     * After the gathering is finished the group can still wait for late members,
-     *
-     * But it doesn't accept new ones anymore
-     */
-    max_wait_time_for_late_members: number
-    /** Limits for group radius (calculated by number of numbers) */
-    max_group_radius: number
-    min_group_radius: number
-    /** When a member falls behind the group he can speedup up till this much of his regular speed */
-    max_member_speedup_when_behind: number
-    /** When a member gets ahead of its group, it will slow down to at most this factor of its speed */
-    max_member_slowdown_when_ahead: number
-    /** When members of a group are behind, the entire group will slow down to at most this factor of its max speed */
-    max_group_slowdown_factor: number
-    /** If a member falls behind more than this times the group radius, the group will slow down to max_group_slowdown_factor */
-    max_group_member_fallback_factor: number
-    /** If a member falls behind more than this time the group radius, it will be removed from the group. */
-    member_disown_distance: number
-    tick_tolerance_when_member_arrives: number
-    /** Maximum number of automatically created unit groups gathering for attack at any time. */
-    max_gathering_unit_groups: number
-    /**
-     * Maximum size of an attack unit group. This only affects automatically-created unit groups;
-     *
-     * Manual groups created through the API are unaffected.
-     */
-    max_unit_group_size: number
-  }
-  readonly steering: {
-    readonly default: {
-      /** Not including the radius of the unit */
-      radius: number
-      separation_force: number
-      separation_factor: number
-      force_unit_fuzzy_goto_behavior: boolean
-    }
-    readonly moving: {
-      radius: number
-      separation_force: number
-      separation_factor: number
-      /** Used only for special "to look good" purposes (like in trailer) */
-      force_unit_fuzzy_goto_behavior: boolean
-    }
-  }
-  readonly path_finder: {
-    /** Defines whether we prefer forward (>1) or backward (<1) or symmetrical (1) search */
-    fwd2bwd_ratio: number
-    /**
-     * When comparing nodes in open which one to check next
-     *
-     * The higher the number the more is the search directed directly towards the goal
-     */
-    goal_pressure_ratio: number
-    /** How many nodes can be expanded at most per tick. */
-    max_steps_worked_per_tick: number
-    /** How much work each pathfinding job is allowed to do per tick. */
-    max_work_done_per_tick: number
-    /** Path cache settings */
-    use_path_cache: boolean
-    /** Number of elements in the cache */
-    short_cache_size: number
-    long_cache_size: number
-    /** Minimal distance to goal for path to be searched in short path cache */
-    short_cache_min_cacheable_distance: number
-    /** Minimal number of algorithm steps for path to be inserted into the short path cache */
-    short_cache_min_algo_steps_to_cache: number
-    /** Minimal distance to goal for path to be searched in long path cache */
-    long_cache_min_cacheable_distance: number
-    /** When searching for connection to path cache path, search at most for this number of steps times the initial estimate */
-    cache_max_connect_to_cache_steps_multiplier: number
-    /** When looking for path from cache make sure it doesn't start too far from requested start in relative distance terms */
-    cache_accept_path_start_distance_ratio: number
-    /**
-     * When looking for path from cache make sure it doesn't end too far from requested end this is typically higher
-     * than accept value for the start because the end target can be moving
-     */
-    cache_accept_path_end_distance_ratio: number
-    /** Same as cache_accept_path_start_distance_ratio, but used for negative cache queries */
-    negative_cache_accept_path_start_distance_ratio: number
-    /** Same as cache_accept_path_end_distance_ratio, but used for negative cache queries */
-    negative_cache_accept_path_end_distance_ratio: number
-    /** When assigning rating to the best path this * start distances is considered */
-    cache_path_start_distance_rating_multiplier: number
-    /**
-     * When assigning rating to the best path this * end distances is considered
-     *
-     * This is typically higher than value for the start to achieve better path end quality
-     */
-    cache_path_end_distance_rating_multiplier: number
-    /**
-     * Somewhere along the path is stuck enemy we need to avoid
-     *
-     * Then units further in the back will use this and run around the target
-     */
-    stale_enemy_with_same_destination_collision_penalty: number
-    /** If there is a moving unit further than this we don't really care */
-    ignore_moving_enemy_collision_distance: number
-    /** Enemy is not moving/or is too close and has different destination */
-    enemy_with_different_destination_collision_penalty: number
-    /** Simplification for now - collision with everything else is this */
-    general_entity_collision_penalty: number
-    /** Collision penalty for successors of positions that require destroy to reach */
-    general_entity_subsequent_collision_penalty: number
-    /** Collision penalty for collisions in the extended bounding box but outside the entity's actual bounding box */
-    extended_collision_penalty: number
-    /** Until this amount any client will be served by the path finder (no estimate on the path length) */
-    max_clients_to_accept_any_new_request: number
-    /** From max_clients_to_accept_any_new_request till this one only those that have a short estimate will be served */
-    max_clients_to_accept_short_new_request: number
-    /** This is the "threshold" to decide what is short and what is not */
-    direct_distance_to_consider_short_request: number
-    /** If a short request takes more than this many steps, it will be rescheduled as a long request */
-    short_request_max_steps: number
-    /** How many steps will be allocated to short requests each tick, as a ratio of all available steps per tick */
-    short_request_ratio: number
-    /** Absolute minimum of steps that will be performed for every path find request no matter what */
-    min_steps_to_check_path_find_termination: number
-    /** If the amount of steps is higher than this times estimate of start to goal then path finding is terminated */
-    start_to_goal_cost_multiplier_to_terminate_path_find: number
-    /**
-     * When the number of waiting clients exceeds certain values, the per-tick work limit will be increased by the
-     *
-     * Overload_levels and overload_multipliers must be the same length.
-     */
-    overload_levels: number[]
-    /**
-     * When the number of waiting clients exceeds certain values, the per-tick work limit will be increased by the
-     *
-     * Overload_levels and overload_multipliers must be the same length.
-     */
-    overload_multipliers: number[]
-    /** The score of all paths in the negative cache is decreased by one every this many ticks. */
-    negative_path_cache_delay_interval: number
-  }
+  readonly pollution: PollutionMapSettings
+  readonly enemy_evolution: EnemyEvolutionMapSettings
+  readonly enemy_expansion: EnemyExpansionMapSettings
+  readonly unit_group: UnitGroupMapSettings
+  readonly steering: SteeringMapSettings
+  readonly path_finder: PathFinderMapSettings
   /**
-   * If a behavior fails this many times, the enemy (or enemy group)
-   *
-   * This solves biters stuck within their own base.
+   * If a behavior fails this many times, the enemy (or enemy group) is destroyed. This solves biters getting stuck
+   * within their own base.
    */
-  max_failed_behavior_count: number
+  readonly max_failed_behavior_count: uint
 }
 
 /**
- * Technology and recipe difficulty settings.
+ * Technology and recipe difficulty settings. Updating any of the attributes will immediately take effect in the game engine.
  *
  * {@link https://lua-api.factorio.com/next/Concepts.html#DifficultySettings View documentation}
  */
@@ -758,7 +854,7 @@ interface DifficultySettings {
    * Either `"after-victory"`, `"always"` or `"never"`. Changing this to `"always"` or `"after-victory"` does not
    * automatically unlock the research queue. See {@link LuaForce} for that.
    */
-  readonly research_queue_setting: "after-victory" | "always" | "never" | "always" | "after-victory"
+  readonly research_queue_setting: "after-victory" | "always" | "never"
 }
 
 /**
@@ -1503,7 +1599,7 @@ interface InfinityInventoryFilter {
   /** The count of the filter. */
   readonly count?: uint
   /** `"at-least"`, `"at-most"`, or `"exactly"`. Defaults to `"at-least"`. */
-  readonly mode?: "at-least" | "at-most" | "exactly" | "at-least"
+  readonly mode?: "at-least" | "at-most" | "exactly"
   /** The index of this filter in the filters list. */
   readonly index: uint
 }
@@ -1521,7 +1617,7 @@ interface InfinityPipeFilter {
   /** The temperature of the fluid. Defaults to the default/minimum temperature of the fluid. */
   readonly temperature?: double
   /** `"at-least"`, `"at-most"`, `"exactly"`, `"add"`, or `"remove"`. Defaults to `"at-least"`. */
-  readonly mode?: "at-least" | "at-most" | "exactly" | "add" | "remove" | "at-least"
+  readonly mode?: "at-least" | "at-most" | "exactly" | "add" | "remove"
 }
 
 interface FluidBoxFilter {
@@ -1553,7 +1649,7 @@ interface HeatSetting {
   /** The target temperature. Defaults to the minimum temperature of the heat buffer. */
   readonly temperature?: double
   /** `"at-least"`, `"at-most"`, `"exactly"`, `"add"`, or `"remove"`. Defaults to `"at-least"`. */
-  readonly mode?: "at-least" | "at-most" | "exactly" | "add" | "remove" | "at-least"
+  readonly mode?: "at-least" | "at-most" | "exactly" | "add" | "remove"
 }
 
 interface HeatConnection {
@@ -2639,7 +2735,7 @@ type Alignment =
  */
 interface EventData {
   /** The identifier of the event this handler was registered to. */
-  readonly name: defines.events
+  readonly name: EventId<EventData>
   /** The tick during which the event happened. */
   readonly tick: uint
   /** The name of the mod that raised the event if it was raised using {@link LuaBootstrap.raise_event LuaBootstrap::raise_event}. */
@@ -2935,7 +3031,7 @@ interface BaseItemPrototypeFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -3103,7 +3199,7 @@ interface BaseModSettingPrototypeFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -3156,7 +3252,7 @@ interface BaseTechnologyPrototypeFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -3211,7 +3307,7 @@ interface BaseDecorativePrototypeFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -3241,7 +3337,7 @@ interface BaseAchievementPrototypeFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -3282,7 +3378,7 @@ interface BaseFluidPrototypeFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -3372,7 +3468,7 @@ interface BaseEquipmentPrototypeFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -3414,7 +3510,7 @@ interface BaseTilePrototypeFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -3506,7 +3602,7 @@ interface BaseRecipePrototypeFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -3677,7 +3773,7 @@ interface BaseEntityPrototypeFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -3830,7 +3926,7 @@ interface BaseScriptRaisedReviveEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -3912,7 +4008,7 @@ interface BaseEntityDiedEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -3994,7 +4090,7 @@ interface BaseEntityMarkedForDeconstructionEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -4076,7 +4172,7 @@ interface BasePreGhostDeconstructedEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -4158,7 +4254,7 @@ interface BaseScriptRaisedDestroyEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -4240,7 +4336,7 @@ interface BaseUpgradeCancelledEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -4322,7 +4418,7 @@ interface BasePlayerRepairedEntityEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -4404,7 +4500,7 @@ interface BaseEntityMarkedForUpgradeEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -4467,7 +4563,7 @@ interface BasePostEntityDiedEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -4511,7 +4607,7 @@ interface BasePreRobotMinedEntityEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -4593,7 +4689,7 @@ interface BaseEntityClonedEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -4675,7 +4771,7 @@ interface BaseScriptRaisedBuiltEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -4757,7 +4853,7 @@ interface BaseRobotMinedEntityEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -4839,7 +4935,7 @@ interface BasePrePlayerMinedEntityEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -4923,7 +5019,7 @@ interface BaseRobotBuiltEntityEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -5012,7 +5108,7 @@ interface BaseEntityDeconstructionCancelledEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -5096,7 +5192,7 @@ interface BasePlayerBuiltEntityEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -5185,7 +5281,7 @@ interface BasePlayerMinedEntityEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -5272,7 +5368,7 @@ interface BaseEntityDamagedEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -5385,7 +5481,7 @@ interface BaseSectorScannedEventFilter {
    * How to combine this with the previous filter. Must be `"or"` or `"and"`. Defaults to `"or"`. When evaluating the
    * filters, `"and"` has higher precedence than `"or"`.
    */
-  readonly mode?: "or" | "and" | "or" | "and" | "or"
+  readonly mode?: "or" | "and"
   /** Inverts the condition. Default is `false`. */
   readonly invert?: boolean
 }
@@ -5499,5 +5595,41 @@ interface MapGenPreset {
   }
 }
 
-/** There are not yet full definitions for this type. See {@link https://lua-api.factorio.com/1.1.36/LuaControlBehavior.html}. */
-type BlueprintControlBehavior = unknown
+interface BlueprintControlBehavior {
+  readonly condition?: CircuitCondition
+  readonly circuit_condition?: CircuitCondition
+  readonly filters?: Signal[]
+  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_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
+}