typed-factorio 1.2.0 → 1.3.2

package/generated/concepts.d.ts

@@ -226,10 +226,11 @@ interface OldTileAndPosition {
 type Tags = Record<string, AnyBasic | undefined>
 
 /**
+ * **Note**
  *
+ * The vectors for all 5 position attributes are a table with `x` and `y` keys instead of an array.
  *
  * {@link https://lua-api.factorio.com/latest/Concepts.html#SmokeSource View documentation}
- * @remarks The vectors for all 5 position attributes are a table with `x` and `y` keys instead of an array.
  */
 interface SmokeSource {
   readonly name: string
@@ -385,6 +386,10 @@ interface CraftingQueueItem {
    * The amount of items being crafted.
    */
   readonly count: uint
+  /**
+   * The item is a prerequisite for another item in the queue.
+   */
+  readonly prerequisite: boolean
 }
 
 interface Alert {
@@ -468,10 +473,11 @@ interface DecorativeResult {
 }
 
 /**
+ * **Note**
  *
+ * Either `icon`, `text`, or both must be provided.
  *
  * {@link https://lua-api.factorio.com/latest/Concepts.html#ChartTagSpec View documentation}
- * @remarks Either `icon`, `text`, or both must be provided.
  */
 interface ChartTagSpec {
   readonly position: MapPosition
@@ -651,7 +657,7 @@ interface EnemyEvolutionMapSettings {
 }
 
 /**
- * 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}.
+ * 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 {@linkplain https://en.wikipedia.org/wiki/Taxicab_geometry Manhattan distance}.
  *
  * The pseudocode algorithm to determine a chunk's score is as follows:
  *
@@ -1503,7 +1509,7 @@ interface AutoplaceSpecification {
 }
 
 /**
- * A fragment of a functional program used to generate coherent noise, probably for purposes related to terrain generation. These can only be meaningfully written/modified during the data load phase. More detailed information is found on the {@link https://wiki.factorio.com/Types/NoiseExpression wiki}.
+ * A fragment of a functional program used to generate coherent noise, probably for purposes related to terrain generation. These can only be meaningfully written/modified during the data load phase. More detailed information is found on the {@linkplain https://wiki.factorio.com/Types/NoiseExpression wiki}.
  *
  * {@link https://lua-api.factorio.com/latest/Concepts.html#NoiseExpression View documentation}
  */
@@ -1589,8 +1595,11 @@ interface Resistance {
  * - `"high"`, `"big"`, `"good"` - equivalent to `sqrt(2)`
  * - `"very-high"`, `"very-big"`, `"very-good"` - equivalent to `2`
  *
+ * **Note**
+ *
+ * The map generation algorithm officially supports the range of values the in-game map generation screen shows (specifically `0` and values from `1/6` to `6`). Values outside this range are not guaranteed to work as expected.
+ *
  * {@link https://lua-api.factorio.com/latest/Concepts.html#MapGenSize View documentation}
- * @remarks The map generation algorithm officially supports the range of values the in-game map generation screen shows (specifically `0` and values from `1/6` to `6`). Values outside this range are not guaranteed to work as expected.
  */
 type MapGenSize =
   | number
@@ -1976,10 +1985,11 @@ interface ConstantCombinatorParameters {
 }
 
 /**
+ * **Note**
  *
+ * While the API accepts both versions for `"less/greater than or equal to"` and `"not equal"`, it'll always return `"≥"`, `"≤"` or `"≠"` respectively when reading them back.
  *
  * {@link https://lua-api.factorio.com/latest/Concepts.html#ComparatorString View documentation}
- * @remarks While the API accepts both versions for `"less/greater than or equal to"` and `"not equal"`, it'll always return `"≥"`, `"≤"` or `"≠"` respectively when reading them back.
  */
 type ComparatorString
 /**
@@ -2719,7 +2729,7 @@ type SpriteType =
   | "utility"
 
 /**
- * It is specified by {@link string}. It can be either the name of a {@link https://wiki.factorio.com/Prototype/Sprite sprite prototype} defined in the data stage or a path in form "type/name".
+ * It is specified by {@link string}. It can be either the name of a {@linkplain https://wiki.factorio.com/Prototype/Sprite sprite prototype} defined in the data stage or a path in form "type/name".
  *
  * The validity of a SpritePath can be verified at runtime using {@link LuaGameScript#is_valid_sprite_path LuaGameScript::is_valid_sprite_path}.
  *
@@ -2742,33 +2752,33 @@ type SpriteType =
 type SpritePath = string | `${SpriteType}/${string}`
 
 /**
- * A sound defined by a {@link string}. It can be either the name of a {@link https://wiki.factorio.com/Prototype/Sound sound prototype} defined in the data stage or a path in the form `"type/name"`. The latter option can be sorted into three categories.
+ * A sound defined by a {@link string}. It can be either the name of a {@linkplain https://wiki.factorio.com/Prototype/Sound sound prototype} defined in the data stage or a path in the form `"type/name"`. The latter option can be sorted into three categories.
  *
  * The validity of a SoundPath can be verified at runtime using {@link LuaGameScript#is_valid_sound_path LuaGameScript::is_valid_sound_path}.
  *
  * The utility and ambient types each contain general use sound prototypes defined by the game itself.
- * - `"utility"` - Uses the {@link https://wiki.factorio.com/Prototype/UtilitySounds UtilitySounds} prototype. Example: `"utility/wire_connect_pole"`
- * - `"ambient"` - Uses {@link https://wiki.factorio.com/Prototype/AmbientSound AmbientSound} prototypes. Example: `"ambient/resource-deficiency"`
+ * - `"utility"` - Uses the {@linkplain https://wiki.factorio.com/Prototype/UtilitySounds UtilitySounds} prototype. Example: `"utility/wire_connect_pole"`
+ * - `"ambient"` - Uses {@linkplain https://wiki.factorio.com/Prototype/AmbientSound AmbientSound} prototypes. Example: `"ambient/resource-deficiency"`
  *
  * The following types can be combined with any tile name as long as its prototype defines the
  *
  *     corresponding sound.
- * - `"tile-walking"` - Uses {@link https://wiki.factorio.com/Prototype/Tile#walking_sound Tile::walking_sound}. Example: `"tile-walking/concrete"`
- * - `"tile-mined"` - Uses {@link https://wiki.factorio.com/Prototype/Tile#mined_sound Tile::mined_sound}
- * - `"tile-build-small"` - Uses {@link https://wiki.factorio.com/Prototype/Tile#build_sound Tile::build_sound}. Example: `"tile-build-small/concrete"`
- * - `"tile-build-medium"` - Uses {@link https://wiki.factorio.com/Prototype/Tile#build_sound Tile::build_sound}
- * - `"tile-build-large"` - Uses {@link https://wiki.factorio.com/Prototype/Tile#build_sound Tile::build_sound}
+ * - `"tile-walking"` - Uses {@linkplain https://wiki.factorio.com/Prototype/Tile#walking_sound Tile::walking_sound}. Example: `"tile-walking/concrete"`
+ * - `"tile-mined"` - Uses {@linkplain https://wiki.factorio.com/Prototype/Tile#mined_sound Tile::mined_sound}
+ * - `"tile-build-small"` - Uses {@linkplain https://wiki.factorio.com/Prototype/Tile#build_sound Tile::build_sound}. Example: `"tile-build-small/concrete"`
+ * - `"tile-build-medium"` - Uses {@linkplain https://wiki.factorio.com/Prototype/Tile#build_sound Tile::build_sound}
+ * - `"tile-build-large"` - Uses {@linkplain https://wiki.factorio.com/Prototype/Tile#build_sound Tile::build_sound}
  *
  * The following types can be combined with any entity name as long as its prototype defines the
  *
  *     corresponding sound.
- * - `"entity-build"` - Uses {@link https://wiki.factorio.com/Prototype/Entity#build_sound Entity::build_sound}. Example: `"entity-build/wooden-chest"`
- * - `"entity-mined"` - Uses {@link https://wiki.factorio.com/Prototype/Entity#mined_sound Entity::mined_sound}
- * - `"entity-mining"` - Uses {@link https://wiki.factorio.com/Prototype/Entity#mining_sound Entity::mining_sound}
- * - `"entity-vehicle_impact"` - Uses {@link https://wiki.factorio.com/Prototype/Entity#vehicle_impact_sound Entity::vehicle_impact_sound}
- * - `"entity-rotated"` - Uses {@link https://wiki.factorio.com/Prototype/Entity#rotated_sound Entity::rotated_sound}
- * - `"entity-open"` - Uses {@link https://wiki.factorio.com/Prototype/Entity#open_sound Entity::open_sound}
- * - `"entity-close"` - Uses {@link https://wiki.factorio.com/Prototype/Entity#close_sound Entity::close_sound}
+ * - `"entity-build"` - Uses {@linkplain https://wiki.factorio.com/Prototype/Entity#build_sound Entity::build_sound}. Example: `"entity-build/wooden-chest"`
+ * - `"entity-mined"` - Uses {@linkplain https://wiki.factorio.com/Prototype/Entity#mined_sound Entity::mined_sound}
+ * - `"entity-mining"` - Uses {@linkplain https://wiki.factorio.com/Prototype/Entity#mining_sound Entity::mining_sound}
+ * - `"entity-vehicle_impact"` - Uses {@linkplain https://wiki.factorio.com/Prototype/Entity#vehicle_impact_sound Entity::vehicle_impact_sound}
+ * - `"entity-rotated"` - Uses {@linkplain https://wiki.factorio.com/Prototype/Entity#rotated_sound Entity::rotated_sound}
+ * - `"entity-open"` - Uses {@linkplain https://wiki.factorio.com/Prototype/Entity#open_sound Entity::open_sound}
+ * - `"entity-close"` - Uses {@linkplain https://wiki.factorio.com/Prototype/Entity#close_sound Entity::close_sound}
  *
  * {@link https://lua-api.factorio.com/latest/Concepts.html#SoundPath View documentation}
  */
@@ -2804,8 +2814,11 @@ interface ModuleEffects {
 /**
  * This is a set of flags given as a dictionary[{@link string} &rarr; {@link boolean}]. When a flag is set, it is present in the dictionary with the value `true`. Unset flags aren't present in the dictionary at all. So, the boolean value is meaningless and exists just for easy table lookup if a flag is set.
  *
+ * **Note**
+ *
+ * By default, none of these flags are set.
+ *
  * {@link https://lua-api.factorio.com/latest/Concepts.html#EntityPrototypeFlags View documentation}
- * @remarks By default, none of these flags are set.
  */
 interface EntityPrototypeFlags {
   /**
@@ -2910,8 +2923,11 @@ interface EntityPrototypeFlags {
 /**
  * This is a set of flags given as dictionary[{@link string} &rarr; {@link boolean}]. When a flag is set, it is present in the dictionary with the value `true`. Unset flags aren't present in the dictionary at all. So, the boolean value is meaningless and exists just for easy table lookup if a flag is set.
  *
+ * **Note**
+ *
+ * By default, none of these flags are set.
+ *
  * {@link https://lua-api.factorio.com/latest/Concepts.html#ItemPrototypeFlags View documentation}
- * @remarks By default, none of these flags are set.
  */
 interface ItemPrototypeFlags {
   /**
@@ -3305,10 +3321,11 @@ interface LogisticFilter {
 }
 
 /**
+ * **Note**
  *
+ * Runtime settings can be changed through console commands and by the mod that owns the settings by writing a new table to the ModSetting.
  *
  * {@link https://lua-api.factorio.com/latest/Concepts.html#ModSetting View documentation}
- * @remarks Runtime settings can be changed through console commands and by the mod that owns the settings by writing a new table to the ModSetting.
  */
 interface ModSetting {
   /**
@@ -3383,7 +3400,7 @@ type Alignment =
   | "bottom-right"
 
 /**
- * Information about the event that has been raised. The table can also contain other fields depending on the type of event. See {@link https://lua-api.factorio.com/latest/events.html the list of Factorio events} for more information on these.
+ * Information about the event that has been raised. The table can also contain other fields depending on the type of event. See {@linkplain https://lua-api.factorio.com/latest/events.html the list of Factorio events} for more information on these.
  *
  * {@link https://lua-api.factorio.com/latest/Concepts.html#EventData View documentation}
  */
@@ -3738,8 +3755,11 @@ type SoundType = "game-effect" | "gui-effect" | "ambient" | "environment" | "wal
  * - {@link EquipmentPrototypeFilter} for type `"equipment"`
  * - {@link TechnologyPrototypeFilter} for type `"technology"`
  *
+ * **Note**
+ *
+ * Filters are always used as an array of filters of a specific type. Every filter can only be used with its corresponding event, and different types of event filters can not be mixed.
+ *
  * {@link https://lua-api.factorio.com/latest/Concepts.html#PrototypeFilter View documentation}
- * @remarks Filters are always used as an array of filters of a specific type. Every filter can only be used with its corresponding event, and different types of event filters can not be mixed.
  */
 type PrototypeFilter =
   | ItemPrototypeFilter
@@ -4169,9 +4189,9 @@ interface CollisionMaskDecorativePrototypeFilter extends BaseDecorativePrototype
   readonly filter: "collision-mask"
   readonly mask: CollisionMask | CollisionMaskWithFlags
   /**
-   * How to filter: `"collides"` or `"layers-equals"`
+   * How to filter: `"collides"`, `"layers-equals"`, `"contains-any"` or `"contains-all"`
    */
-  readonly mask_mode: "collides" | "layers-equals"
+  readonly mask_mode: "collides" | "layers-equals" | "contains-any" | "contains-all"
 }
 
 interface DecalDecorativePrototypeFilter extends BaseDecorativePrototypeFilter {
@@ -4405,9 +4425,9 @@ interface CollisionMaskTilePrototypeFilter extends BaseTilePrototypeFilter {
   readonly filter: "collision-mask"
   readonly mask: CollisionMask | CollisionMaskWithFlags
   /**
-   * How to filter: `"collides"` or `"layers-equals"`
+   * How to filter: `"collides"`, `"layers-equals"`, `"contains-any"` or `"contains-all"`
    */
-  readonly mask_mode: "collides" | "layers-equals"
+  readonly mask_mode: "collides" | "layers-equals" | "contains-any" | "contains-all"
 }
 
 interface WalkingSpeedModifierTilePrototypeFilter extends BaseTilePrototypeFilter {
@@ -4781,9 +4801,9 @@ interface CollisionMaskEntityPrototypeFilter extends BaseEntityPrototypeFilter {
   readonly filter: "collision-mask"
   readonly mask: CollisionMask | CollisionMaskWithFlags
   /**
-   * How to filter: `"collides"` or `"layers-equals"`
+   * How to filter: `"collides"`, `"layers-equals"`, `"contains-any"` or `"contains-all"`
    */
-  readonly mask_mode: "collides" | "layers-equals"
+  readonly mask_mode: "collides" | "layers-equals" | "contains-any" | "contains-all"
 }
 
 /**

package/generated/defines.d.ts

@@ -643,7 +643,7 @@ declare namespace defines {
     cant_divide_segments,
   }
   /**
-   * See the {@link https://lua-api.factorio.com/latest/events.html events page} for more info on what events contain and when they get raised.
+   * See the {@linkplain https://lua-api.factorio.com/latest/events.html events page} for more info on what events contain and when they get raised.
    *
    * {@link https://lua-api.factorio.com/latest/defines.html#defines.events View documentation}
    */
@@ -1396,7 +1396,7 @@ declare namespace defines {
     const on_player_reverse_selected_area: EventId<OnPlayerReverseSelectedAreaEvent>
   }
   /**
-   * See the {@link https://lua-api.factorio.com/latest/events.html events page} for more info on what events contain and when they get raised.
+   * See the {@linkplain https://lua-api.factorio.com/latest/events.html events page} for more info on what events contain and when they get raised.
    *
    * {@link https://lua-api.factorio.com/latest/defines.html#defines.events View documentation}
    */

package/generated/events.d.ts

@@ -3,7 +3,7 @@
 /** @noSelfInFile */
 
 /**
- * Called when a {@link https://wiki.factorio.com/Prototype/CustomInput CustomInput} is activated.
+ * Called when a {@linkplain https://wiki.factorio.com/Prototype/CustomInput CustomInput} is activated.
  *
  * {@link https://lua-api.factorio.com/latest/events.html#CustomInputEvent View documentation}
  */
@@ -88,8 +88,11 @@ interface OnAreaClonedEvent extends EventData {
 /**
  * Called when a biter migration builds a base.
  *
+ * **Note**
+ *
+ * This will be called multiple times for each migration, once for every biter that is sacrificed to build part of the new base.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_biter_base_built View documentation}
- * @remarks This will be called multiple times for each migration, once for every biter that is sacrificed to build part of the new base.
  */
 interface OnBiterBaseBuiltEvent extends EventData {
   /**
@@ -223,8 +226,11 @@ interface OnCancelledUpgradeEvent extends EventData {
 /**
  * Called when a character corpse expires due to timeout or all of the items being removed from it.
  *
+ * **Note**
+ *
+ * this is not called if the corpse is mined. See {@link defines.events.on_pre_player_mined_item} to detect that.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_character_corpse_expired View documentation}
- * @remarks this is not called if the corpse is mined. See {@link defines.events.on_pre_player_mined_item} to detect that.
  */
 interface OnCharacterCorpseExpiredEvent extends EventData {
   /**
@@ -397,8 +403,11 @@ interface OnCombatRobotExpiredEvent extends EventData {
 /**
  * Called when a message is sent to the in-game console, either by a player or through the server interface.
  *
+ * **Note**
+ *
+ * This event only fires for plain messages, not for any commands (including `/shout` or `/whisper`).
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_console_chat View documentation}
- * @remarks This event only fires for plain messages, not for any commands (including `/shout` or `/whisper`).
  */
 interface OnConsoleChatEvent extends EventData {
   /**
@@ -472,8 +481,11 @@ interface OnCutsceneCancelledEvent extends EventData {
  *
  * This refers to an index in the table previously passed to set_controller which started the cutscene.
  *
+ * **Note**
+ *
+ * Due to implementation omission, waypoint_index is 0-based.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_cutscene_waypoint_reached View documentation}
- * @remarks Due to implementation omission, waypoint_index is 0-based.
  */
 interface OnCutsceneWaypointReachedEvent extends EventData {
   /**
@@ -497,8 +509,11 @@ interface OnCutsceneWaypointReachedEvent extends EventData {
 /**
  * Called when the map difficulty settings are changed.
  *
+ * **Note**
+ *
+ * It's not guaranteed that both settings are changed - just that at least one has been changed.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_difficulty_settings_changed View documentation}
- * @remarks It's not guaranteed that both settings are changed - just that at least one has been changed.
  */
 interface OnDifficultySettingsChangedEvent extends EventData {
   readonly old_recipe_difficulty: uint
@@ -534,8 +549,11 @@ interface OnEntityClonedEvent extends EventData {
 /**
  * Called when an entity is damaged. Can be filtered using {@link LuaEntityDamagedEventFilter}.
  *
+ * **Note**
+ *
+ * This is not called when an entities health is set directly by another mod.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_entity_damaged View documentation}
- * @remarks This is not called when an entities health is set directly by another mod.
  */
 interface OnEntityDamagedEvent extends EventData {
   readonly entity: LuaEntity
@@ -573,8 +591,11 @@ interface OnEntityDamagedEvent extends EventData {
 /**
  * Called after an entity is destroyed that has been registered with {@link LuaBootstrap#register_on_entity_destroyed LuaBootstrap::register_on_entity_destroyed}.
  *
+ * **Note**
+ *
+ * Depending on when a given entity is destroyed, this event will be fired at the end of the current tick or at the end of the next tick.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_entity_destroyed View documentation}
- * @remarks Depending on when a given entity is destroyed, this event will be fired at the end of the current tick or at the end of the next tick.
  */
 interface OnEntityDestroyedEvent extends EventData {
   /**
@@ -634,8 +655,11 @@ interface OnEntityDiedEvent extends EventData {
 /**
  * Called when one of an entity's personal logistic slots changes.
  *
+ * **Note**
+ *
+ * "Personal logistic slot" refers to a character or vehicle's personal request / auto-trash slots, not the request slots on logistic chests.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_entity_logistic_slot_changed View documentation}
- * @remarks "Personal logistic slot" refers to a character or vehicle's personal request / auto-trash slots, not the request slots on logistic chests.
  */
 interface OnEntityLogisticSlotChangedEvent extends EventData {
   /**
@@ -809,8 +833,11 @@ interface OnForceCeaseFireChangedEvent extends EventData {
 /**
  * Called when a new force is created using `game.create_force()`
  *
+ * **Note**
+ *
+ * This is not called when the default forces (`'player'`, `'enemy'`, `'neutral'`) are created as they will always exist.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_force_created View documentation}
- * @remarks This is not called when the default forces (`'player'`, `'enemy'`, `'neutral'`) are created as they will always exist.
  */
 interface OnForceCreatedEvent extends EventData {
   /**
@@ -875,8 +902,11 @@ interface OnForceResetEvent extends EventData {
 /**
  * Called after two forces have been merged using `game.merge_forces()`.
  *
+ * **Note**
+ *
+ * The source force is invalidated before this event is called and the name can be re-used in this event if desired.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_forces_merged View documentation}
- * @remarks The source force is invalidated before this event is called and the name can be re-used in this event if desired.
  */
 interface OnForcesMergedEvent extends EventData {
   /**
@@ -928,8 +958,11 @@ interface OnForcesMergingEvent extends EventData {
 /**
  * Called when a game is created from a scenario. This is fired for every mod, even when the scenario's save data already includes it. In those cases however, {@link LuaBootstrap#on_init LuaBootstrap::on_init} is not fired.
  *
+ * **Note**
+ *
+ * This event is not fired when the scenario is loaded via the map editor.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_game_created_from_scenario View documentation}
- * @remarks This event is not fired when the scenario is loaded via the map editor.
  */
 interface OnGameCreatedFromScenarioEvent extends EventData {
   /**
@@ -1011,8 +1044,11 @@ interface OnGuiClickEvent extends EventData {
  *
  * This can only be raised when the GUI's player controller is still valid. If a GUI is thus closed due to the player disconnecting, dying, or becoming a spectator in other ways, it won't cause this event to be raised.
  *
+ * **Note**
+ *
+ * It's not advised to open any other GUI during this event because if this is run as a request to open a different GUI the game will force close the new opened GUI without notice to ensure the original requested GUI is opened.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_gui_closed View documentation}
- * @remarks It's not advised to open any other GUI during this event because if this is run as a request to open a different GUI the game will force close the new opened GUI without notice to ensure the original requested GUI is opened.
  */
 interface OnGuiClosedEvent extends EventData {
   /**
@@ -1811,8 +1847,11 @@ interface OnPlayerChangedPositionEvent extends EventData {
 /**
  * Called after a player changes surfaces.
  *
+ * **Note**
+ *
+ * In the instance a player is moved off a surface due to it being deleted this is not called.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_player_changed_surface View documentation}
- * @remarks In the instance a player is moved off a surface due to it being deleted this is not called.
  */
 interface OnPlayerChangedSurfaceEvent extends EventData {
   /**
@@ -2335,8 +2374,11 @@ interface OnPlayerMainInventoryChangedEvent extends EventData {
 /**
  * Called after the results of an entity being mined are collected just before the entity is destroyed. After this event any items in the buffer will be transferred into the player as if they came from mining the entity. Can be filtered using {@link LuaPlayerMinedEntityEventFilter}.
  *
+ * **Note**
+ *
+ * The buffer inventory is special in that it's only valid during this event and has a dynamic size expanding as more items are transferred into it.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_player_mined_entity View documentation}
- * @remarks The buffer inventory is special in that it's only valid during this event and has a dynamic size expanding as more items are transferred into it.
  */
 interface OnPlayerMinedEntityEvent extends EventData {
   /**
@@ -3565,8 +3607,11 @@ interface OnRobotMinedEvent extends EventData {
 /**
  * Called after the results of an entity being mined are collected just before the entity is destroyed. After this event any items in the buffer will be transferred into the robot as if they came from mining the entity. Can be filtered using {@link LuaRobotMinedEntityEventFilter}.
  *
+ * **Note**
+ *
+ * The buffer inventory is special in that it's only valid during this event and has a dynamic size expanding as more items are transferred into it.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_robot_mined_entity View documentation}
- * @remarks The buffer inventory is special in that it's only valid during this event and has a dynamic size expanding as more items are transferred into it.
  */
 interface OnRobotMinedEntityEvent extends EventData {
   /**
@@ -3932,8 +3977,11 @@ interface OnSurfaceClearedEvent extends EventData {
 /**
  * Called when a surface is created.
  *
+ * **Note**
+ *
+ * This is not called when the default surface is created as it will always exist.
+ *
  * {@link https://lua-api.factorio.com/latest/events.html#on_surface_created View documentation}
- * @remarks This is not called when the default surface is created as it will always exist.
  */
 interface OnSurfaceCreatedEvent extends EventData {
   readonly surface_index: SurfaceIndex

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typed-factorio",
-  "version": "1.2.0",
+  "version": "1.3.2",
   "description": "Featureful typescript definitions for the the Factorio modding lua api.",
   "keywords": [
     "factorio",
@@ -22,7 +22,8 @@
     "lint": "eslint .",
     "check": "yarn run lint && yarn run test",
     "prepublishOnly": "yarn run check",
-    "download-latest-runtime-api": "ts-node ./scripts/downloadLatest.ts"
+    "download-latest-runtime-api": "ts-node ./scripts/downloadLatest.ts",
+    "next-version": "yarn run download-latest-runtime-api && yarn run clean && yarn test && yarn version --minor"
   },
   "peerDependencies": {
     "lua-types": "^2.11.0",