typed-factorio 0.19.1 → 1.0.0-RC

package/generated/classes.d.ts

@@ -300,7 +300,7 @@ interface LuaBootstrap {
    * @returns The registration number. It is used to identify the entity in the {@link OnEntityDestroyedEvent on_entity_destroyed} event.
    * @remarks Depending on when a given entity is destroyed, {@link OnEntityDestroyedEvent on_entity_destroyed} will either be fired at the end of the current tick or at the end of the next tick.
    */
-  register_on_entity_destroyed(entity: LuaEntity): uint64
+  register_on_entity_destroyed(entity: LuaEntity): RegistrationNumber
   /**
    * Generate a new, unique event ID that can be used to raise custom events with {@link LuaBootstrap#raise_event LuaBootstrap::raise_event}.
    *
@@ -392,7 +392,7 @@ interface LuaBootstrap {
     /**
      * The player doing the chatting.
      */
-    readonly player_index: uint
+    readonly player_index: PlayerIndex
     /**
      * The chat message to send.
      */
@@ -413,7 +413,7 @@ interface LuaBootstrap {
     /**
      * The player doing the crafting.
      */
-    readonly player_index: uint
+    readonly player_index: PlayerIndex
     /**
      * The recipe used to craft this item.
      */
@@ -430,7 +430,7 @@ interface LuaBootstrap {
     /**
      * The player transferred from or to.
      */
-    readonly player_index: uint
+    readonly player_index: PlayerIndex
     /**
      * The entity transferred from or to.
      */
@@ -464,7 +464,7 @@ interface LuaBootstrap {
     /**
      * The player who did the purchasing.
      */
-    readonly player_index: uint
+    readonly player_index: PlayerIndex
     /**
      * The market entity.
      */
@@ -532,7 +532,7 @@ interface LuaBootstrap {
     /**
      * The surface whose tiles have been changed.
      */
-    readonly surface_index: uint
+    readonly surface_index: SurfaceIndex
     /**
      * The tiles that have been changed.
      */
@@ -1171,7 +1171,7 @@ interface LuaControl {
    *
    * {@link https://lua-api.factorio.com/latest/LuaControl.html#LuaControl.is_flashlight_enabled View documentation}
    */
-  is_flashlight_enabled(): void
+  is_flashlight_enabled(): boolean
   /**
    * Gets the count of the given recipe that can be crafted.
    *
@@ -1895,25 +1895,25 @@ interface LuaCustomInputPrototype {
    */
   readonly action: string
   /**
-   * If this custom input is enabled. Disabled custom inputs exist but are not used by the game.
+   * Whether this custom input is enabled. Disabled custom inputs exist but are not used by the game.
    *
    * {@link https://lua-api.factorio.com/latest/LuaCustomInputPrototype.html#LuaCustomInputPrototype.enabled View documentation}
    */
   readonly enabled: boolean
   /**
-   * If this custom input is enabled while using the spectator controller.
+   * Whether this custom input is enabled while using the spectator controller.
    *
    * {@link https://lua-api.factorio.com/latest/LuaCustomInputPrototype.html#LuaCustomInputPrototype.enabled_while_spectating View documentation}
    */
   readonly enabled_while_spectating: boolean
   /**
-   * If this custom input is enabled while using the cutscene controller.
+   * Whether this custom input is enabled while using the cutscene controller.
    *
    * {@link https://lua-api.factorio.com/latest/LuaCustomInputPrototype.html#LuaCustomInputPrototype.enabled_while_in_cutscene View documentation}
    */
   readonly enabled_while_in_cutscene: boolean
   /**
-   * If this custom input will include the selected prototype (if any) when triggered.
+   * Whether this custom input will include the selected prototype (if any) when triggered.
    *
    * {@link https://lua-api.factorio.com/latest/LuaCustomInputPrototype.html#LuaCustomInputPrototype.include_selected_prototype View documentation}
    */
@@ -1938,7 +1938,7 @@ interface LuaCustomInputPrototype {
   help(): string
 }
 
-type CustomTableIndex<K extends string | number, V>
+type CustomTableIndexer<K extends string | number, V>
 /**
  * Access an element of this custom table.
  *
@@ -1999,8 +1999,13 @@ interface LuaCustomTableMembers {
  * ```
  */
 type LuaCustomTable<K extends string | number, V> = LuaCustomTableMembers &
-  CustomTableIndex<K, V> &
-  LuaPairsIterable<[number] extends [K] ? number : K, V>
+  CustomTableIndexer<K, V> &
+  LuaPairsIterable<
+    // this convoluted expression gives a number type if K includes a number, even if it includes a string, and K otherwise.
+    // it also preserves number branding
+    [number] extends [K extends number & IndexBrand<infer A> ? number : K] ? (K extends string ? never : K) : K,
+    V
+  >
 
 /**
  * Prototype of a damage.
@@ -2467,13 +2472,13 @@ interface LuaEntity extends LuaControl {
    */
   clear_request_slot(slot: uint): void
   /**
-   * Returns whether a craft is currently in process. It does not indicate whether progress is currently being made, but whether any crafting action has made progress in this machine.
+   * Returns whether a craft is currently in process. It does not indicate whether progress is currently being made, but whether a crafting process has been started in this machine.
    *
    * _Can only be used if this is CraftingMachine_
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.is_crafting View documentation}
    */
-  is_crafting(): void
+  is_crafting(): boolean
   /**
    * _Can only be used if this is Gate_
    *
@@ -3793,7 +3798,7 @@ interface LuaEntity extends LuaControl {
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.unit_number View documentation}
    */
-  readonly unit_number: uint | undefined
+  readonly unit_number: UnitNumber | undefined
   /**
    * The {@link LuaEntity#unit_number unit_number} of the entity contained in this ghost. It is the same as the unit number of the {@link https://wiki.factorio.com/Prototype/EntityWithOwner EntityWithOwner} that was destroyed to create this ghost. If it was created by other means, or if the inner entity doesn not support unit numbers, this property is `nil`.
    *
@@ -3801,7 +3806,7 @@ interface LuaEntity extends LuaControl {
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.ghost_unit_number View documentation}
    */
-  readonly ghost_unit_number: uint | undefined
+  readonly ghost_unit_number: UnitNumber | undefined
   /**
    * The mining progress for this mining drill or `nil` if this isn't a mining drill. Is a number in range [0, mining_target.prototype.mineable_properties.mining_time]
    *
@@ -4454,6 +4459,14 @@ interface LuaEntity extends LuaControl {
    * @remarks Can also be used on entity ghost if it contains linked-belt<br>May return entity ghost which contains linked belt to which connection is made
    */
   readonly linked_belt_neighbour: LuaEntity | undefined
+  /**
+   * The current radar scan progress, as a number in range [0, 1].
+   *
+   * _Can only be used if this is Radar_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.radar_scan_progress View documentation}
+   */
+  readonly radar_scan_progress: float
   /**
    * Is this object valid? This Lua object holds a reference to an object within the game engine. It is possible that the game-engine object is removed whilst a mod still holds the corresponding Lua object. If that happens, the object becomes invalid, i.e. this attribute will be `false`. Mods are advised to check for object validity if any change to the game state might have occurred between the creation of the Lua object and its access.
    */
@@ -5355,7 +5368,7 @@ interface BaseEntity extends LuaControl {
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.unit_number View documentation}
    */
-  readonly unit_number: uint | undefined
+  readonly unit_number: UnitNumber | undefined
   /**
    * The mining progress for this mining drill or `nil` if this isn't a mining drill. Is a number in range [0, mining_target.prototype.mineable_properties.mining_time]
    *
@@ -5772,7 +5785,7 @@ interface EntityGhostEntity extends BaseEntity {
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.ghost_unit_number View documentation}
    */
-  readonly ghost_unit_number: uint | undefined
+  readonly ghost_unit_number: UnitNumber | undefined
 }
 
 /**
@@ -5831,13 +5844,13 @@ interface MarketEntity extends BaseEntity {
  */
 interface CraftingMachineEntity extends BaseEntity {
   /**
-   * Returns whether a craft is currently in process. It does not indicate whether progress is currently being made, but whether any crafting action has made progress in this machine.
+   * Returns whether a craft is currently in process. It does not indicate whether progress is currently being made, but whether a crafting process has been started in this machine.
    *
    * _Can only be used if this is CraftingMachine_
    *
    * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.is_crafting View documentation}
    */
-  is_crafting(): void
+  is_crafting(): boolean
   /**
    * Current recipe being assembled by this machine or `nil` if no recipe is set.
    *
@@ -6999,6 +7012,17 @@ interface SmokeWithTriggerEntity extends BaseEntity {
   time_to_next_effect: uint
 }
 
+interface RadarEntity extends BaseEntity {
+  /**
+   * The current radar scan progress, as a number in range [0, 1].
+   *
+   * _Can only be used if this is Radar_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntity.html#LuaEntity.radar_scan_progress View documentation}
+   */
+  readonly radar_scan_progress: float
+}
+
 /**
  * Prototype of an entity.
  *
@@ -7631,6 +7655,12 @@ interface LuaEntityPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.void_energy_source_prototype View documentation}
    */
   readonly void_energy_source_prototype: LuaVoidEnergySourcePrototype | undefined
+  /**
+   * The heat buffer prototype this entity uses or `nil`.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.heat_buffer_prototype View documentation}
+   */
+  readonly heat_buffer_prototype: LuaHeatBufferPrototype | undefined
   /**
    * The log2 of grid size of the building
    *
@@ -7649,6 +7679,30 @@ interface LuaEntityPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.maximum_temperature View documentation}
    */
   readonly maximum_temperature: double | undefined
+  /**
+   * If this generator prototype burns fluid.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.burns_fluid View documentation}
+   */
+  readonly burns_fluid: boolean
+  /**
+   * If this generator prototype scales fluid usage.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.scale_fluid_usage View documentation}
+   */
+  readonly scale_fluid_usage: boolean
+  /**
+   * If this generator prototype destroys non fuel fluids.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.destroy_non_fuel_fluid View documentation}
+   */
+  readonly destroy_non_fuel_fluid: boolean
+  /**
+   * The default maximum power output of this generator prototype or `nil`.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.max_power_output View documentation}
+   */
+  readonly max_power_output: double | undefined
   /**
    * The target temperature of this boiler prototype or `nil`.
    *
@@ -8230,6 +8284,31 @@ interface LuaEntityPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.allow_run_time_change_of_is_military_target View documentation}
    */
   readonly allow_run_time_change_of_is_military_target: boolean
+  /**
+   * The logistic parameters for this roboport. or `nil`.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.logistic_parameters View documentation}
+   * @remarks Both the `charging_station_shift` and `stationing_offset` vectors are tables with `x` and `y` keys instead of an array.
+   */
+  readonly logistic_parameters:
+    | {
+        readonly spawn_and_station_height: float
+        readonly spawn_and_station_shadow_height_offset: float
+        readonly charge_approach_distance: float
+        readonly logistic_radius: float
+        readonly construction_radius: float
+        readonly charging_station_count: uint
+        readonly charging_distance: float
+        readonly charging_station_shift: Vector
+        readonly charging_energy: double
+        readonly charging_threshold_distance: float
+        readonly robot_vertical_acceleration: float
+        readonly stationing_offset: Vector
+        readonly robot_limit: uint
+        readonly logistics_connection_distance: float
+        readonly robots_shrink_when_entering_and_exiting: boolean
+      }
+    | undefined
   /**
    * Gets the current movement speed of this character, including effects from exoskeletons, tiles, stickers and shooting.
    *
@@ -8965,6 +9044,12 @@ interface BaseEntityPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.void_energy_source_prototype View documentation}
    */
   readonly void_energy_source_prototype: LuaVoidEnergySourcePrototype | undefined
+  /**
+   * The heat buffer prototype this entity uses or `nil`.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.heat_buffer_prototype View documentation}
+   */
+  readonly heat_buffer_prototype: LuaHeatBufferPrototype | undefined
   /**
    * The log2 of grid size of the building
    *
@@ -8983,6 +9068,30 @@ interface BaseEntityPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.maximum_temperature View documentation}
    */
   readonly maximum_temperature: double | undefined
+  /**
+   * If this generator prototype burns fluid.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.burns_fluid View documentation}
+   */
+  readonly burns_fluid: boolean
+  /**
+   * If this generator prototype scales fluid usage.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.scale_fluid_usage View documentation}
+   */
+  readonly scale_fluid_usage: boolean
+  /**
+   * If this generator prototype destroys non fuel fluids.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.destroy_non_fuel_fluid View documentation}
+   */
+  readonly destroy_non_fuel_fluid: boolean
+  /**
+   * The default maximum power output of this generator prototype or `nil`.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.max_power_output View documentation}
+   */
+  readonly max_power_output: double | undefined
   /**
    * The target temperature of this boiler prototype or `nil`.
    *
@@ -9486,6 +9595,31 @@ interface BaseEntityPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.is_entity_with_owner View documentation}
    */
   readonly is_entity_with_owner: boolean
+  /**
+   * The logistic parameters for this roboport. or `nil`.
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaEntityPrototype.html#LuaEntityPrototype.logistic_parameters View documentation}
+   * @remarks Both the `charging_station_shift` and `stationing_offset` vectors are tables with `x` and `y` keys instead of an array.
+   */
+  readonly logistic_parameters:
+    | {
+        readonly spawn_and_station_height: float
+        readonly spawn_and_station_shadow_height_offset: float
+        readonly charge_approach_distance: float
+        readonly logistic_radius: float
+        readonly construction_radius: float
+        readonly charging_station_count: uint
+        readonly charging_distance: float
+        readonly charging_station_shift: Vector
+        readonly charging_energy: double
+        readonly charging_threshold_distance: float
+        readonly robot_vertical_acceleration: float
+        readonly stationing_offset: Vector
+        readonly robot_limit: uint
+        readonly logistics_connection_distance: float
+        readonly robots_shrink_when_entering_and_exiting: boolean
+      }
+    | undefined
   /**
    * Is this object valid? This Lua object holds a reference to an object within the game engine. It is possible that the game-engine object is removed whilst a mod still holds the corresponding Lua object. If that happens, the object becomes invalid, i.e. this attribute will be `false`. Mods are advised to check for object validity if any change to the game state might have occurred between the creation of the Lua object and its access.
    */
@@ -11530,7 +11664,7 @@ interface LuaGameScript {
    */
   regenerate_entity(entities: string | readonly string[]): void
   /**
-   * Take a screenshot and save it to a file. The filename should include a file extension indicating the desired image format. Supports `.png`, `.jpg` / `.jpeg`, `.tga` and `.bmp`.
+   * Take a screenshot of the game and save it to the `script-output` folder, located in the game's {@link https://wiki.factorio.com/User_data_directory user data directory}. The name of the image file can be specified via the `path` parameter.
    *
    * {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.take_screenshot View documentation}
    * @remarks If Factorio is running headless, this function will do nothing.
@@ -11561,7 +11695,7 @@ interface LuaGameScript {
      */
     readonly zoom?: double
     /**
-     * The sub-path in `"script-output"` to save the screenshot to. Defaults to `"screenshot.png"`.
+     * The name of the image file. It should include a file extension indicating the desired format. Supports `.png`, `.jpg` /`.jpeg`, `.tga` and `.bmp`. Providing a directory path (ex. `"save/here/screenshot.png"`) will create the necessary folder structure in `script-output`. Defaults to `"screenshot.png"`.
      */
     readonly path?: string
     /**
@@ -11608,7 +11742,7 @@ interface LuaGameScript {
    */
   set_wait_for_screenshots_to_finish(): void
   /**
-   * Take a screenshot of the technology screen and save it to a file. The filename should include a file extension indicating the desired image format. Supports `.png`, `.jpg` / `.jpeg`, `.tga` and `.bmp`.
+   * Take a screenshot of the technology screen and save it to the `script-output` folder, located in the game's {@link https://wiki.factorio.com/User_data_directory user data directory}. The name of the image file can be specified via the `path` parameter.
    *
    * {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.take_technology_screenshot View documentation}
    */
@@ -11618,7 +11752,7 @@ interface LuaGameScript {
      */
     readonly force?: ForceIdentification
     /**
-     * The sub-path in `"script-output"` to save the screenshot to. Defaults to `"technology-screenshot.png"`.
+     * The name of the image file. It should include a file extension indicating the desired format. Supports `.png`, `.jpg` /`.jpeg`, `.tga` and `.bmp`. Providing a directory path (ex. `"save/here/screenshot.png"`) will create the necessary folder structure in `script-output`. Defaults to `"technology-screenshot.png"`.
      */
     readonly path?: string
     /**
@@ -11653,20 +11787,20 @@ interface LuaGameScript {
    */
   json_to_table(json: string): AnyBasic | undefined
   /**
-   * Write a string to a file.
+   * Write a file to the `script-output` folder, located in the game's {@link https://wiki.factorio.com/User_data_directory user data directory}. The name and file extension of the file can be specified via the `filename` parameter.
    *
    * {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.write_file View documentation}
-   * @param filename Path to the file to write to.
-   * @param data File content
-   * @param append When `true`, this will append to the end of the file. Defaults to `false`, which will overwrite any pre-existing file with the new data.
-   * @param for_player If given, the file will only be written for this player_index. 0 means only the server if one exists.
+   * @param filename The name of the file. Providing a directory path (ex. `"save/here/example.txt"`) will create the necessary folder structure in `script-output`.
+   * @param data The content to write to the file.
+   * @param append If `true`, `data` will be appended to the end of the file. Defaults to `false`, which will overwrite any pre-existing file with the new `data`.
+   * @param for_player If given, the file will only be written for this `player_index`. Providing `0` will only write to the server's output if present.
    */
   write_file(filename: string, data: LocalisedString, append?: boolean, for_player?: uint): void
   /**
-   * Remove file or directory. Given path is taken relative to the script output directory. Can be used to remove files created by {@link LuaGameScript#write_file LuaGameScript::write_file}.
+   * Remove a file or directory in the `script-output` folder, located in the game's {@link https://wiki.factorio.com/User_data_directory user data directory}. Can be used to remove files created by {@link LuaGameScript#write_file LuaGameScript::write_file}.
    *
    * {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.remove_path View documentation}
-   * @param path Path to remove, relative to the script output directory
+   * @param path The path to the file or directory to remove, relative to `script-output`.
    */
   remove_path(path: string): void
   /**
@@ -11954,7 +12088,7 @@ interface LuaGameScript {
    * @param player The player index or name.
    * @remarks This is a shortcut for game.players[...]
    */
-  get_player(player: uint | string): LuaPlayer | undefined
+  get_player(index: PlayerIndex | string): LuaPlayer | undefined
   /**
    * Gets the given surface or returns `nil` if no surface is found.
    *
@@ -11962,7 +12096,7 @@ interface LuaGameScript {
    * @param surface The surface index or name.
    * @remarks This is a shortcut for game.surfaces[...]
    */
-  get_surface(surface: uint | string): LuaSurface | undefined
+  get_surface(index: SurfaceIndex | string): LuaSurface | undefined
   /**
    * Creates a {@link LuaProfiler}, which is used for measuring script performance.
    *
@@ -12155,7 +12289,7 @@ interface LuaGameScript {
    *
    * {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.players View documentation}
    */
-  readonly players: LuaCustomTable<uint | string, LuaPlayer>
+  readonly players: LuaCustomTable<PlayerIndex | string, LuaPlayer>
   /**
    * The currently active set of map settings. Even though this property is marked as read-only, the members of the dictionary that is returned can be modified mid-game.
    *
@@ -12422,7 +12556,7 @@ interface LuaGameScript {
    *
    * {@link https://lua-api.factorio.com/latest/LuaGameScript.html#LuaGameScript.surfaces View documentation}
    */
-  readonly surfaces: LuaCustomTable<uint | string, LuaSurface>
+  readonly surfaces: LuaCustomTable<SurfaceIndex | string, LuaSurface>
   /**
    * The active mods versions. The keys are mod names, the values are the versions.
    *
@@ -12966,7 +13100,7 @@ interface CameraGuiSpec extends BaseGuiSpec {
   /**
    * The surface that the camera will render. Defaults to the player's current surface.
    */
-  readonly surface_index?: uint
+  readonly surface_index?: SurfaceIndex
   /**
    * The initial camera zoom. Defaults to `0.75`.
    */
@@ -13136,7 +13270,7 @@ interface MinimapGuiSpec extends BaseGuiSpec {
   /**
    * The surface the camera will render. Defaults to the player's current surface.
    */
-  readonly surface_index?: uint
+  readonly surface_index?: SurfaceIndex
   /**
    * The player index the map should use. Defaults to the current player.
    */
@@ -13218,7 +13352,7 @@ type GuiSpec =
   | TabbedPaneGuiSpec
   | LabelGuiSpec
 
-interface GuiElementIndex {
+interface GuiElementIndexer {
   /**
    * The indexing operator. Gets children by name.
    *
@@ -13312,7 +13446,7 @@ interface BaseGuiElement {
    *
    * {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.index View documentation}
    */
-  readonly index: uint
+  readonly index: GuiElementIndex
   /**
    * The GUI this element is a child of.
    *
@@ -13367,7 +13501,7 @@ interface BaseGuiElement {
    *
    * {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.player_index View documentation}
    */
-  readonly player_index: uint
+  readonly player_index: PlayerIndex
   tooltip: LocalisedString
   /**
    * The type of this GUI element.
@@ -13497,7 +13631,7 @@ interface ChooseElemButtonGuiElementMembers extends BaseGuiElement {
   locked: boolean
 }
 
-type ChooseElemButtonGuiElement = ChooseElemButtonGuiElementMembers & GuiElementIndex
+type ChooseElemButtonGuiElement = ChooseElemButtonGuiElementMembers & GuiElementIndexer
 
 /**
  * @noSelf
@@ -13559,7 +13693,7 @@ interface DropDownGuiElementMembers extends BaseGuiElement {
   selected_index: uint
 }
 
-type DropDownGuiElement = DropDownGuiElementMembers & GuiElementIndex
+type DropDownGuiElement = DropDownGuiElementMembers & GuiElementIndexer
 
 interface EmptyWidgetGuiElementMembers extends BaseGuiElement {
   /**
@@ -13587,7 +13721,7 @@ interface EmptyWidgetGuiElementMembers extends BaseGuiElement {
   drag_target: LuaGuiElement | undefined
 }
 
-type EmptyWidgetGuiElement = EmptyWidgetGuiElementMembers & GuiElementIndex
+type EmptyWidgetGuiElement = EmptyWidgetGuiElementMembers & GuiElementIndexer
 
 interface EntityPreviewGuiElementMembers extends BaseGuiElement {
   /**
@@ -13604,7 +13738,7 @@ interface EntityPreviewGuiElementMembers extends BaseGuiElement {
   entity: LuaEntity | undefined
 }
 
-type EntityPreviewGuiElement = EntityPreviewGuiElementMembers & GuiElementIndex
+type EntityPreviewGuiElement = EntityPreviewGuiElementMembers & GuiElementIndexer
 
 /**
  * @noSelf
@@ -13676,7 +13810,7 @@ interface ListBoxGuiElementMembers extends BaseGuiElement {
   selected_index: uint
 }
 
-type ListBoxGuiElement = ListBoxGuiElementMembers & GuiElementIndex
+type ListBoxGuiElement = ListBoxGuiElementMembers & GuiElementIndexer
 
 /**
  * @noSelf
@@ -13748,7 +13882,7 @@ interface ScrollPaneGuiElementMembers extends BaseGuiElement {
   vertical_scroll_policy: "auto" | "never" | "always" | "auto-and-reserve-space" | "dont-show-but-allow-scrolling"
 }
 
-type ScrollPaneGuiElement = ScrollPaneGuiElementMembers & GuiElementIndex
+type ScrollPaneGuiElement = ScrollPaneGuiElementMembers & GuiElementIndexer
 
 interface SpriteButtonGuiElementMembers extends BaseGuiElement {
   /**
@@ -13798,7 +13932,7 @@ interface SpriteButtonGuiElementMembers extends BaseGuiElement {
   set mouse_button_filter(value: MouseButtonFlags)
 }
 
-type SpriteButtonGuiElement = SpriteButtonGuiElementMembers & GuiElementIndex
+type SpriteButtonGuiElement = SpriteButtonGuiElementMembers & GuiElementIndexer
 
 /**
  * @noSelf
@@ -13846,7 +13980,7 @@ interface TabbedPaneGuiElementMembers extends BaseGuiElement {
   readonly tabs: TabAndContent[]
 }
 
-type TabbedPaneGuiElement = TabbedPaneGuiElementMembers & GuiElementIndex
+type TabbedPaneGuiElement = TabbedPaneGuiElementMembers & GuiElementIndexer
 
 /**
  * @noSelf
@@ -13960,7 +14094,7 @@ interface TextBoxGuiElementMembers extends BaseGuiElement {
   clear_and_focus_on_right_click: boolean
 }
 
-type TextBoxGuiElement = TextBoxGuiElementMembers & GuiElementIndex
+type TextBoxGuiElement = TextBoxGuiElementMembers & GuiElementIndexer
 
 interface ButtonGuiElementMembers extends BaseGuiElement {
   /**
@@ -13978,7 +14112,7 @@ interface ButtonGuiElementMembers extends BaseGuiElement {
   set mouse_button_filter(value: MouseButtonFlags)
 }
 
-type ButtonGuiElement = ButtonGuiElementMembers & GuiElementIndex
+type ButtonGuiElement = ButtonGuiElementMembers & GuiElementIndexer
 
 interface CameraGuiElementMembers extends BaseGuiElement {
   /**
@@ -13999,9 +14133,9 @@ interface CameraGuiElementMembers extends BaseGuiElement {
    *
    * {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.surface_index View documentation}
    */
-  surface_index: uint
+  surface_index: SurfaceIndex
   /**
-   * The zoom this camera or minimap is using.
+   * The zoom this camera or minimap is using. This value must be positive.
    *
    * {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.zoom View documentation}
    */
@@ -14014,7 +14148,7 @@ interface CameraGuiElementMembers extends BaseGuiElement {
   entity: LuaEntity | undefined
 }
 
-type CameraGuiElement = CameraGuiElementMembers & GuiElementIndex
+type CameraGuiElement = CameraGuiElementMembers & GuiElementIndexer
 
 interface CheckboxGuiElementMembers extends BaseGuiElement {
   /**
@@ -14033,7 +14167,7 @@ interface CheckboxGuiElementMembers extends BaseGuiElement {
   state: boolean
 }
 
-type CheckboxGuiElement = CheckboxGuiElementMembers & GuiElementIndex
+type CheckboxGuiElement = CheckboxGuiElementMembers & GuiElementIndexer
 
 interface FlowGuiElementMembers extends BaseGuiElement {
   /**
@@ -14069,7 +14203,7 @@ interface FlowGuiElementMembers extends BaseGuiElement {
   drag_target: LuaGuiElement | undefined
 }
 
-type FlowGuiElement = FlowGuiElementMembers & GuiElementIndex
+type FlowGuiElement = FlowGuiElementMembers & GuiElementIndexer
 
 /**
  * @noSelf
@@ -14127,7 +14261,7 @@ interface FrameGuiElementMembers extends BaseGuiElement {
   drag_target: LuaGuiElement | undefined
 }
 
-type FrameGuiElement = FrameGuiElementMembers & GuiElementIndex
+type FrameGuiElement = FrameGuiElementMembers & GuiElementIndexer
 
 interface LabelGuiElementMembers extends BaseGuiElement {
   /**
@@ -14155,7 +14289,7 @@ interface LabelGuiElementMembers extends BaseGuiElement {
   drag_target: LuaGuiElement | undefined
 }
 
-type LabelGuiElement = LabelGuiElementMembers & GuiElementIndex
+type LabelGuiElement = LabelGuiElementMembers & GuiElementIndexer
 
 interface LineGuiElementMembers extends BaseGuiElement {
   /**
@@ -14174,7 +14308,7 @@ interface LineGuiElementMembers extends BaseGuiElement {
   readonly direction: "horizontal" | "vertical"
 }
 
-type LineGuiElement = LineGuiElementMembers & GuiElementIndex
+type LineGuiElement = LineGuiElementMembers & GuiElementIndexer
 
 interface MinimapGuiElementMembers extends BaseGuiElement {
   /**
@@ -14195,9 +14329,9 @@ interface MinimapGuiElementMembers extends BaseGuiElement {
    *
    * {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.surface_index View documentation}
    */
-  surface_index: uint
+  surface_index: SurfaceIndex
   /**
-   * The zoom this camera or minimap is using.
+   * The zoom this camera or minimap is using. This value must be positive.
    *
    * {@link https://lua-api.factorio.com/latest/LuaGuiElement.html#LuaGuiElement.zoom View documentation}
    */
@@ -14224,7 +14358,7 @@ interface MinimapGuiElementMembers extends BaseGuiElement {
   entity: LuaEntity | undefined
 }
 
-type MinimapGuiElement = MinimapGuiElementMembers & GuiElementIndex
+type MinimapGuiElement = MinimapGuiElementMembers & GuiElementIndexer
 
 interface ProgressBarGuiElementMembers extends BaseGuiElement {
   /**
@@ -14243,7 +14377,7 @@ interface ProgressBarGuiElementMembers extends BaseGuiElement {
   value: double
 }
 
-type ProgressBarGuiElement = ProgressBarGuiElementMembers & GuiElementIndex
+type ProgressBarGuiElement = ProgressBarGuiElementMembers & GuiElementIndexer
 
 interface RadioButtonGuiElementMembers extends BaseGuiElement {
   /**
@@ -14262,7 +14396,7 @@ interface RadioButtonGuiElementMembers extends BaseGuiElement {
   state: boolean
 }
 
-type RadioButtonGuiElement = RadioButtonGuiElementMembers & GuiElementIndex
+type RadioButtonGuiElement = RadioButtonGuiElementMembers & GuiElementIndexer
 
 /**
  * @noSelf
@@ -14340,7 +14474,7 @@ interface SliderGuiElementMembers extends BaseGuiElement {
   slider_value: double
 }
 
-type SliderGuiElement = SliderGuiElementMembers & GuiElementIndex
+type SliderGuiElement = SliderGuiElementMembers & GuiElementIndexer
 
 interface SpriteGuiElementMembers extends BaseGuiElement {
   /**
@@ -14363,7 +14497,7 @@ interface SpriteGuiElementMembers extends BaseGuiElement {
   resize_to_sprite: boolean
 }
 
-type SpriteGuiElement = SpriteGuiElementMembers & GuiElementIndex
+type SpriteGuiElement = SpriteGuiElementMembers & GuiElementIndexer
 
 interface SwitchGuiElementMembers extends BaseGuiElement {
   /**
@@ -14424,7 +14558,7 @@ interface SwitchGuiElementMembers extends BaseGuiElement {
   right_label_tooltip: LocalisedString
 }
 
-type SwitchGuiElement = SwitchGuiElementMembers & GuiElementIndex
+type SwitchGuiElement = SwitchGuiElementMembers & GuiElementIndexer
 
 interface TabGuiElementMembers extends BaseGuiElement {
   /**
@@ -14443,7 +14577,7 @@ interface TabGuiElementMembers extends BaseGuiElement {
   badge_text: LocalisedString
 }
 
-type TabGuiElement = TabGuiElementMembers & GuiElementIndex
+type TabGuiElement = TabGuiElementMembers & GuiElementIndexer
 
 interface TableGuiElementMembers extends BaseGuiElement {
   /**
@@ -14511,7 +14645,7 @@ interface TableGuiElementMembers extends BaseGuiElement {
   drag_target: LuaGuiElement | undefined
 }
 
-type TableGuiElement = TableGuiElementMembers & GuiElementIndex
+type TableGuiElement = TableGuiElementMembers & GuiElementIndexer
 
 /**
  * @noSelf
@@ -14609,7 +14743,7 @@ interface TextFieldGuiElementMembers extends BaseGuiElement {
   clear_and_focus_on_right_click: boolean
 }
 
-type TextFieldGuiElement = TextFieldGuiElementMembers & GuiElementIndex
+type TextFieldGuiElement = TextFieldGuiElementMembers & GuiElementIndexer
 
 type GuiElementMembers =
   | ChooseElemButtonGuiElementMembers
@@ -14691,7 +14825,36 @@ type GuiElementMembers =
  * tabbed_pane.add_tab(tab2, label2)
  * ```
  */
-type LuaGuiElement = GuiElementMembers & GuiElementIndex
+type LuaGuiElement = GuiElementMembers & GuiElementIndexer
+
+/**
+ * Prototype of a heat buffer.
+ *
+ * {@link https://lua-api.factorio.com/latest/LuaHeatBufferPrototype.html View documentation}
+ * @noSelf
+ */
+interface LuaHeatBufferPrototype {
+  readonly max_temperature: double
+  readonly default_temperature: double
+  readonly specific_heat: double
+  readonly max_transfer: double
+  readonly min_temperature_gradient: double
+  readonly min_working_temperature: double
+  readonly minimum_glow_temperature: double
+  readonly connections: HeatConnection[]
+  /**
+   * Is this object valid? This Lua object holds a reference to an object within the game engine. It is possible that the game-engine object is removed whilst a mod still holds the corresponding Lua object. If that happens, the object becomes invalid, i.e. this attribute will be `false`. Mods are advised to check for object validity if any change to the game state might have occurred between the creation of the Lua object and its access.
+   */
+  readonly valid: boolean
+  /**
+   * The class name of this object. Available even when `valid` is false. For LuaStruct objects it may also be suffixed with a dotted path to a member of the struct.
+   */
+  readonly object_name: "LuaHeatBufferPrototype"
+  /**
+   * All methods and properties that this object supports.
+   */
+  help(): string
+}
 
 /**
  * Prototype of a heat energy source.
@@ -14711,6 +14874,7 @@ interface LuaHeatEnergySourcePrototype {
   readonly min_working_temperature: double
   readonly minimum_glow_temperature: double
   readonly connections: HeatConnection[]
+  readonly heat_buffer_prototype: LuaHeatBufferPrototype
   /**
    * Is this object valid? This Lua object holds a reference to an object within the game engine. It is possible that the game-engine object is removed whilst a mod still holds the corresponding Lua object. If that happens, the object becomes invalid, i.e. this attribute will be `false`. Mods are advised to check for object validity if any change to the game state might have occurred between the creation of the Lua object and its access.
    */
@@ -15376,6 +15540,14 @@ interface LuaItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_selection_border_color View documentation}
    */
   readonly alt_selection_border_color: ColorTable
+  /**
+   * The color used when doing reverse selection with this selection tool prototype.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_selection_border_color View documentation}
+   */
+  readonly reverse_selection_border_color: ColorTable
   /**
    * Flags that affect which entities will be selected.
    *
@@ -15392,6 +15564,14 @@ interface LuaItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_selection_mode_flags View documentation}
    */
   readonly alt_selection_mode_flags: SelectionModeFlags
+  /**
+   * Flags that affect which entities will be selected during reverse selection.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_selection_mode_flags View documentation}
+   */
+  readonly reverse_selection_mode_flags: SelectionModeFlags
   /**
    * _Can only be used if this is SelectionTool_
    *
@@ -15404,6 +15584,12 @@ interface LuaItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_selection_cursor_box_type View documentation}
    */
   readonly alt_selection_cursor_box_type: string
+  /**
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_selection_cursor_box_type View documentation}
+   */
+  readonly reverse_selection_cursor_box_type: string
   /**
    * If tiles area always included when doing selection with this selection tool prototype.
    *
@@ -15428,6 +15614,14 @@ interface LuaItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_entity_filter_mode View documentation}
    */
   readonly alt_entity_filter_mode: string
+  /**
+   * The reverse entity filter mode used by this selection tool.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_alt_entity_filter_mode View documentation}
+   */
+  readonly reverse_alt_entity_filter_mode: string
   /**
    * The tile filter mode used by this selection tool.
    *
@@ -15444,6 +15638,14 @@ interface LuaItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_tile_filter_mode View documentation}
    */
   readonly alt_tile_filter_mode: string
+  /**
+   * The reverse tile filter mode used by this selection tool.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_tile_filter_mode View documentation}
+   */
+  readonly reverse_tile_filter_mode: string
   /**
    * The entity filters used by this selection tool indexed by entity name.
    *
@@ -15460,6 +15662,14 @@ interface LuaItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_entity_filters View documentation}
    */
   readonly alt_entity_filters: Record<string, LuaEntityPrototype>
+  /**
+   * The reverse entity filters used by this selection tool indexed by entity name.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_entity_filters View documentation}
+   */
+  readonly reverse_entity_filters: Record<string, LuaEntityPrototype>
   /**
    * The entity type filters used by this selection tool indexed by entity type.
    *
@@ -15478,6 +15688,15 @@ interface LuaItemPrototype {
    * @remarks The boolean value is meaningless and is used to allow easy lookup if a type exists in the dictionary.
    */
   readonly alt_entity_type_filters: Record<string, boolean>
+  /**
+   * The reverse entity type filters used by this selection tool indexed by entity type.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_entity_type_filters View documentation}
+   * @remarks The boolean value is meaningless and is used to allow easy lookup if a type exists in the dictionary.
+   */
+  readonly reverse_entity_type_filters: Record<string, boolean>
   /**
    * The tile filters used by this selection tool indexed by tile name.
    *
@@ -15494,6 +15713,14 @@ interface LuaItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_tile_filters View documentation}
    */
   readonly alt_tile_filters: Record<string, LuaTilePrototype>
+  /**
+   * The reverse tile filters used by this selection tool indexed by tile name.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_tile_filters View documentation}
+   */
+  readonly reverse_tile_filters: Record<string, LuaTilePrototype>
   /**
    * The number of entity filters this deconstruction item has or `nil` if this isn't a deconstruction item prototype.
    *
@@ -15939,6 +16166,14 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_selection_border_color View documentation}
    */
   readonly alt_selection_border_color: ColorTable
+  /**
+   * The color used when doing reverse selection with this selection tool prototype.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_selection_border_color View documentation}
+   */
+  readonly reverse_selection_border_color: ColorTable
   /**
    * Flags that affect which entities will be selected.
    *
@@ -15955,6 +16190,14 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_selection_mode_flags View documentation}
    */
   readonly alt_selection_mode_flags: SelectionModeFlags
+  /**
+   * Flags that affect which entities will be selected during reverse selection.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_selection_mode_flags View documentation}
+   */
+  readonly reverse_selection_mode_flags: SelectionModeFlags
   /**
    * _Can only be used if this is SelectionTool_
    *
@@ -15967,6 +16210,12 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_selection_cursor_box_type View documentation}
    */
   readonly alt_selection_cursor_box_type: string
+  /**
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_selection_cursor_box_type View documentation}
+   */
+  readonly reverse_selection_cursor_box_type: string
   /**
    * If tiles area always included when doing selection with this selection tool prototype.
    *
@@ -15991,6 +16240,14 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_entity_filter_mode View documentation}
    */
   readonly alt_entity_filter_mode: string
+  /**
+   * The reverse entity filter mode used by this selection tool.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_alt_entity_filter_mode View documentation}
+   */
+  readonly reverse_alt_entity_filter_mode: string
   /**
    * The tile filter mode used by this selection tool.
    *
@@ -16007,6 +16264,14 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_tile_filter_mode View documentation}
    */
   readonly alt_tile_filter_mode: string
+  /**
+   * The reverse tile filter mode used by this selection tool.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_tile_filter_mode View documentation}
+   */
+  readonly reverse_tile_filter_mode: string
   /**
    * The entity filters used by this selection tool indexed by entity name.
    *
@@ -16023,6 +16288,14 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_entity_filters View documentation}
    */
   readonly alt_entity_filters: Record<string, LuaEntityPrototype>
+  /**
+   * The reverse entity filters used by this selection tool indexed by entity name.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_entity_filters View documentation}
+   */
+  readonly reverse_entity_filters: Record<string, LuaEntityPrototype>
   /**
    * The entity type filters used by this selection tool indexed by entity type.
    *
@@ -16041,6 +16314,15 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * @remarks The boolean value is meaningless and is used to allow easy lookup if a type exists in the dictionary.
    */
   readonly alt_entity_type_filters: Record<string, boolean>
+  /**
+   * The reverse entity type filters used by this selection tool indexed by entity type.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_entity_type_filters View documentation}
+   * @remarks The boolean value is meaningless and is used to allow easy lookup if a type exists in the dictionary.
+   */
+  readonly reverse_entity_type_filters: Record<string, boolean>
   /**
    * The tile filters used by this selection tool indexed by tile name.
    *
@@ -16057,6 +16339,14 @@ interface SelectionToolItemPrototype extends BaseItemPrototype {
    * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.alt_tile_filters View documentation}
    */
   readonly alt_tile_filters: Record<string, LuaTilePrototype>
+  /**
+   * The reverse tile filters used by this selection tool indexed by tile name.
+   *
+   * _Can only be used if this is SelectionTool_
+   *
+   * {@link https://lua-api.factorio.com/latest/LuaItemPrototype.html#LuaItemPrototype.reverse_tile_filters View documentation}
+   */
+  readonly reverse_tile_filters: Record<string, LuaTilePrototype>
 }
 
 interface DeconstructionItemPrototype extends BaseItemPrototype {
@@ -19309,7 +19599,7 @@ interface LuaPlayer extends LuaControl {
    *
    * {@link https://lua-api.factorio.com/latest/LuaPlayer.html#LuaPlayer.index View documentation}
    */
-  readonly index: uint
+  readonly index: PlayerIndex
   readonly gui: LuaGui
   /**
    * `true` if the player opened itself. I.e. if they opened the character or god-controller GUI.
@@ -22804,7 +23094,7 @@ interface ProgrammableSpeakerSurfaceCreateEntity extends BaseSurfaceCreateEntity
 
 interface CharacterCorpseSurfaceCreateEntity extends BaseSurfaceCreateEntity {
   readonly inventory_size?: uint
-  readonly player_index?: uint
+  readonly player_index?: PlayerIndex
 }
 
 interface HighlightBoxSurfaceCreateEntity extends BaseSurfaceCreateEntity {
@@ -23855,7 +24145,7 @@ interface LuaSurface {
    */
   clear(ignore_characters?: boolean): void
   /**
-   * Generates a path with the specified constraints (as an array of {@link PathfinderWaypoint PathfinderWaypoints}) using the unit pathfinding algorithm. This path can be used to emulate pathing behavior by script for non-unit entities. If you want to command actual units to move, use the {@link LuaEntity#set_command LuaEntity::set_command} functionality instead.
+   * Generates a path with the specified constraints (as an array of {@link PathfinderWaypoint PathfinderWaypoints}) using the unit pathfinding algorithm. This path can be used to emulate pathing behavior by script for non-unit entities, such as vehicles. If you want to command actual units (such as biters or spitters) to move, use {@link LuaEntity#set_command LuaEntity::set_command} instead.
    *
    * The resulting path is ultimately returned asynchronously via {@link OnScriptPathRequestFinishedEvent on_script_path_request_finished}.
    *
@@ -24071,7 +24361,7 @@ interface LuaSurface {
    *
    * {@link https://lua-api.factorio.com/latest/LuaSurface.html#LuaSurface.index View documentation}
    */
-  readonly index: uint
+  readonly index: SurfaceIndex
   /**
    * The generation settings for this surface. These can be modified to after surface generation, but note that this will not retroactively update the surface. To manually adjust it, {@link LuaSurface#regenerate_entity LuaSurface::regenerate_entity}, {@link LuaSurface#regenerate_decorative LuaSurface::regenerate_decorative} and {@link LuaSurface#delete_chunk LuaSurface::delete_chunk} can be used.
    *