@screeps-arena-community/types 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-02-04
+
+### Added
+
+- Initial release of @screeps-arena-community/types
+- Core game API types (game/\*)
+  - Constants, prototypes, utils, path-finder, visual
+  - All game objects: Creep, Structure, Tower, Spawn, etc.
+- Season 1 arena types
+  - Construct and Control mode
+  - Portal Exploration mode
+- Season 2 arena types
+  - Capture the Flag mode
+  - Power Split mode
+- Comprehensive TypeScript type definitions
+- Package exports for tree-shaking support
+- Full documentation and usage examples
+
+[1.0.0]: https://github.com/screeps-arena-community/types/releases/tag/v1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Screeps Arena Types Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,168 @@
+# @screeps-arena-community/types
+
+Typescript types for the game [Screeps Arena](https://store.steampowered.com/app/1137320/Screeps_Arena) based on the official [Screeps Arena Docs](https://arena.screeps.com/docs).
+
+[![npm version](https://img.shields.io/npm/v/@screeps-arena-community/types.svg)](https://www.npmjs.com/package/@screeps-arena-community/types)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+```bash
+npm install --save-dev @screeps-arena-community/types
+```
+
+## Quick Start
+
+Add the package to your `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "types": ["@screeps-arena-community/types"],
+    "moduleResolution": "node",
+    "module": "ESNext",
+    "target": "ES2020"
+  }
+}
+```
+
+For custom path mappings (optional):
+
+```json
+{
+  "compilerOptions": {
+    "types": ["@screeps-arena-community/types"],
+    "paths": {
+      "game/*": ["node_modules/@screeps-arena-community/types/src/game/*"],
+      "arena/*": ["node_modules/@screeps-arena-community/types/src/arena/*"]
+    }
+  }
+}
+```
+
+## Usage
+
+### Core Game API
+
+The core game API is available for all arena modes:
+
+```typescript
+import { Creep, Structure } from 'game/prototypes'
+import { getObjectsByPrototype, getRange } from 'game/utils'
+import { searchPath } from 'game/path-finder'
+import { ATTACK, MOVE, HEAL } from 'game/constants'
+
+export function loop() {
+  const myCreeps = getObjectsByPrototype(Creep).filter((c) => c.my)
+  // Your game logic here...
+}
+```
+
+### Season-Specific Types
+
+Import types specific to your arena mode:
+
+#### Season 1: Construct and Control
+
+```typescript
+import {
+  StructureGoal,
+  AreaEffect,
+} from 'arena/season_1/construct_and_control/basic'
+import { EFFECT_DAMAGE } from 'arena/season_1/construct_and_control/basic/constants'
+```
+
+#### Season 1: Portal Exploration
+
+```typescript
+import { Portal } from 'arena/season_1/portal_exploration/basic'
+
+export function loop() {
+  const portals = getObjectsByPrototype(Portal)
+  // Navigate through portals...
+}
+```
+
+#### Season 2: Capture the Flag
+
+```typescript
+import { BodyPart } from 'arena/season_2/capture_the_flag/basic'
+
+export function loop() {
+  const droppedParts = getObjectsByPrototype(BodyPart)
+  // Collect body parts...
+}
+```
+
+#### Season 2: Power Split
+
+```typescript
+import { BonusFlag } from 'arena/season_2/power_split/basic'
+import { EFF_CONSTRUCT_BOOST } from 'arena/season_2/power_split/basic/constants'
+
+export function loop() {
+  const flags = getObjectsByPrototype(BonusFlag)
+  // Capture bonus flags...
+}
+```
+
+## Available Arena Modes
+
+| Season   | Mode                  | Import Path                            |
+| -------- | --------------------- | -------------------------------------- |
+| Season 1 | Construct and Control | `arena/season_1/construct_and_control` |
+| Season 1 | Portal Exploration    | `arena/season_1/portal_exploration`    |
+| Season 2 | Capture the Flag      | `arena/season_2/capture_the_flag`      |
+| Season 2 | Power Split           | `arena/season_2/power_split`           |
+
+## Package Structure
+
+```
+@screeps-arena/types/
+├── src/
+│   ├── index.d.ts              # Main entry (core game types)
+│   ├── game/                   # Core game API
+│   │   ├── constants.d.ts
+│   │   ├── prototypes/         # Game objects (Creep, Structure, etc.)
+│   │   ├── utils.d.ts
+│   │   ├── path-finder.d.ts
+│   │   └── visual.d.ts
+│   └── arena/                  # Arena-specific types
+│       ├── season_1/
+│       │   ├── construct_and_control/
+│       │   └── portal_exploration/
+│       └── season_2/
+│           ├── capture_the_flag/
+│           └── power_split/
+```
+
+## Version Compatibility
+
+| Package Version | Game Version | Notes                                      |
+| --------------- | ------------ | ------------------------------------------ |
+| 1.0.0           | Season 1 & 2 | Initial release with all major arena modes |
+
+## Documentation
+
+- [Screeps Arena Documentation](https://docs.screeps.com/arena/)
+- [Screeps Arena on Steam](https://store.steampowered.com/app/1137320/Screeps_Arena/)
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Links
+
+- [NPM Package](https://www.npmjs.com/package/@screeps-arena-community/types)
+- [GitHub Repository](https://github.com/screeps-arena-community/types)
+- [Issue Tracker](https://github.com/screeps-arena-community/types/issues)

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@screeps-arena-community/types",
+  "version": "1.0.0",
+  "description": "TypeScript type definitions for Screeps Arena",
+  "main": "src/index.d.ts",
+  "types": "src/index.d.ts",
+  "exports": {
+    ".": "./src/index.d.ts",
+    "./game": "./src/game/index.d.ts",
+    "./game/*": "./src/game/*.d.ts",
+    "./arena/season_1/construct_and_control": "./src/arena/season_1/construct_and_control/index.d.ts",
+    "./arena/season_1/construct_and_control/*": "./src/arena/season_1/construct_and_control/*.d.ts",
+    "./arena/season_1/portal_exploration": "./src/arena/season_1/portal_exploration/index.d.ts",
+    "./arena/season_1/portal_exploration/*": "./src/arena/season_1/portal_exploration/*.d.ts",
+    "./arena/season_2/capture_the_flag": "./src/arena/season_2/capture_the_flag/index.d.ts",
+    "./arena/season_2/capture_the_flag/*": "./src/arena/season_2/capture_the_flag/*.d.ts",
+    "./arena/season_2/power_split": "./src/arena/season_2/power_split/index.d.ts",
+    "./arena/season_2/power_split/*": "./src/arena/season_2/power_split/*.d.ts"
+  },
+  "files": [
+    "src/**/*.d.ts",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "test": "tsc --project tsconfig.test.json",
+    "prepublishOnly": "npm test"
+  },
+  "keywords": [
+    "screeps",
+    "screeps-arena",
+    "screeps-arena-community",
+    "screeps-arena-types",
+    "screeps-arena-community-types",
+    "screeps-arena-definitions"
+  ],
+  "author": "Kreash <kreash.dev@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/screeps-arena-community/types.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "bugs": {
+    "url": "https://github.com/screeps-arena-community/types/issues"
+  },
+  "homepage": "https://github.com/screeps-arena-community/types#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "devDependencies": {
+    "prettier": "3.8.1",
+    "typescript": "^5.0.0"
+  }
+}

package/src/arena/season_1/construct_and_control/basic/basic.d.ts

@@ -0,0 +1,4 @@
+declare module 'arena/season_1/construct_and_control/basic' {
+  export * from 'arena/season_1/construct_and_control/basic/prototypes'
+  export * from 'arena/season_1/construct_and_control/basic/constants'
+}

package/src/arena/season_1/construct_and_control/basic/constants.d.ts

@@ -0,0 +1,4 @@
+declare module 'arena/season_1/construct_and_control/basic/constants' {
+  export const EFFECT_SLOWDOWN = 'slowdown'
+  export const EFFECT_CONSTRUCTION_BOOST = 'eff_construction_boost'
+}

package/src/arena/season_1/construct_and_control/basic/prototypes/area-effect.d.ts

@@ -0,0 +1,12 @@
+declare module 'arena/season_1/construct_and_control/basic/prototypes' {
+  import { GameObject } from 'game/prototypes'
+  import { EFFECT_SLOWDOWN } from 'arena/season_1/construct_and_control/basic/constants'
+
+  type AreaEffectType = typeof EFFECT_SLOWDOWN
+
+  /** An object that applies an effect of the specified type to all creeps at the same tile */
+  export class AreaEffect extends GameObject {
+    /** The effect type */
+    readonly effect: AreaEffectType
+  }
+}

package/src/arena/season_1/construct_and_control/basic/prototypes/construction-boost.d.ts

@@ -0,0 +1,9 @@
+declare module 'arena/season_1/construct_and_control/basic/prototypes' {
+  import { GameObject } from 'game/prototypes'
+
+  /** An object that provides a construction boost effect to the creep that steps onto this object for 200 ticks */
+  export class ConstructionBoost extends GameObject {
+    /** The number of ticks until this object disappears */
+    ticksToDecay: number
+  }
+}

package/src/arena/season_1/construct_and_control/basic/prototypes/structure-goal.d.ts

@@ -0,0 +1,6 @@
+declare module 'arena/season_1/construct_and_control/basic/prototypes' {
+  import { GameObject } from 'game/prototypes'
+
+  /* A structure that needs to be built to win the match. */
+  export class StructureGoal extends GameObject {}
+}

package/src/arena/season_1/construct_and_control/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Screeps Arena - Season 1: Construct and Control
+ * @packageDocumentation
+ * @module arena/season_1/construct_and_control
+ * @see https://docs.screeps.com/arena/
+ */
+
+export * from 'arena/season_1/construct_and_control/basic'

package/src/arena/season_1/portal_exploration/basic/basic.d.ts

@@ -0,0 +1,4 @@
+declare module 'arena/season_1/portal_exploration/basic' {
+  export * from 'arena/season_alpha/portal_exploration/basic/prototypes'
+  export * from 'arena/season_alpha/portal_exploration/basic/constants'
+}

package/src/arena/season_1/portal_exploration/basic/prototypes/portal.d.ts

@@ -0,0 +1,9 @@
+declare module 'arena/season_1/portal_exploration/basic/prototypes' {
+  import { GameObject } from 'game/prototypes'
+
+  /** A portal is a special type of game object that allows creeps to teleport */
+  export class Portal extends GameObject {
+    /** The destination coordinates of the portal */
+    readonly destination: { x: number; y: number }
+  }
+}

package/src/arena/season_1/portal_exploration/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Screeps Arena - Season 1: Portal Exploration
+ * @packageDocumentation
+ * @module arena/season_1/portal_exploration
+ * @see https://docs.screeps.com/arena/
+ */
+
+export * from 'arena/season_1/portal_exploration/basic'

package/src/arena/season_2/capture_the_flag/basic/prototypes/body-part.d.ts

@@ -0,0 +1,12 @@
+declare module 'arena/season_2/capture_the_flag/basic/prototypes' {
+  import { BodyPartType, GameObject } from 'game/prototypes'
+
+  /** A separate part of creep body */
+  export class BodyPart extends GameObject {
+    /** The type of the body part */
+    readonly type: BodyPartType
+
+    /** The number of ticks until this object disappears */
+    readonly ticksToDecay: number
+  }
+}

package/src/arena/season_2/capture_the_flag/basic.d.ts

@@ -0,0 +1,4 @@
+declare module 'arena/season_2/capture_the_flag/basic' {
+  export * from 'arena/season_2/capture_the_flag/basic/prototypes'
+  export * from 'arena/season_2/capture_the_flag/basic/constants'
+}

package/src/arena/season_2/capture_the_flag/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Screeps Arena - Season 2: Capture the Flag
+ * @packageDocumentation
+ * @module arena/season_2/capture_the_flag
+ * @see https://docs.screeps.com/arena/
+ */
+
+export * from 'arena/season_2/capture_the_flag/basic'

package/src/arena/season_2/power_split/basic/basic.d.ts

@@ -0,0 +1,4 @@
+declare module 'arena/season_2/power_split/basic' {
+  export * from 'arena/season_2/power_split/basic/prototypes'
+  export * from 'arena/season_2/power_split/basic/constants'
+}

package/src/arena/season_2/power_split/basic/prototypes/bonus-flag.d.ts

@@ -0,0 +1,10 @@
+declare module 'arena/season_2/power_split/basic/prototypes' {
+  import { Flag } from 'game/prototypes'
+  import { BodyPartType } from 'game/prototypes/creep'
+
+  /** An object that applies an effect of the specified type to all creeps belonging to the player who captured it.  */
+  export class BonusFlag extends Flag {
+    /** The affected bodypart type */
+    readonly bonusType: BodyPartType
+  }
+}

package/src/arena/season_2/power_split/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Screeps Arena - Season 2: Power Split
+ * @packageDocumentation
+ * @module arena/season_2/power_split
+ * @see https://docs.screeps.com/arena/
+ */
+
+export * from 'arena/season_2/power_split/basic'

package/src/game/constants.d.ts

@@ -0,0 +1,112 @@
+declare module 'game/constants' {
+  export const OK = 0
+  export const ERR_NOT_OWNER = -1
+  export const ERR_NO_PATH = -2
+  export const ERR_NAME_EXISTS = -3
+  export const ERR_BUSY = -4
+  export const ERR_NOT_FOUND = -5
+  export const ERR_NOT_ENOUGH_ENERGY = -6
+  export const ERR_NOT_ENOUGH_RESOURCES = -6
+  export const ERR_INVALID_TARGET = -7
+  export const ERR_FULL = -8
+  export const ERR_NOT_IN_RANGE = -9
+  export const ERR_INVALID_ARGS = -10
+  export const ERR_TIRED = -11
+  export const ERR_NO_BODYPART = -12
+  export const ERR_NOT_ENOUGH_EXTENSIONS = -6
+
+  export const MOVE = 'move'
+  export const RANGED_ATTACK = 'ranged_attack'
+  export const HEAL = 'heal'
+  export const ATTACK = 'attack'
+  export const CARRY = 'carry'
+  export const TOUGH = 'tough'
+  export const WORK = 'work'
+
+  export const TOP = 1
+  export const TOP_RIGHT = 2
+  export const RIGHT = 3
+  export const BOTTOM_RIGHT = 4
+  export const BOTTOM = 5
+  export const BOTTOM_LEFT = 6
+  export const LEFT = 7
+  export const TOP_LEFT = 8
+
+  export const TERRAIN_PLAIN = 0
+  export const TERRAIN_WALL = 1
+  export const TERRAIN_SWAMP = 2
+
+  export const BODYPART_HITS = 100
+
+  export const RANGED_ATTACK_POWER = 10
+  export const RANGED_ATTACK_DISTANCE_RATE
+  export const ATTACK_POWER = 30
+  export const HEAL_POWER = 12
+  export const RANGED_HEAL_POWER = 4
+  export const CARRY_CAPACITY = 50
+  export const REPAIR_POWER = 100
+  export const DISMANTLE_POWER = 50
+  export const REPAIR_COST = 0.01
+  export const DISMANTLE_COST = 0.005
+  export const HARVEST_POWER = 2
+  export const BUILD_POWER = 5
+
+  export const OBSTACLE_OBJECT_TYPES
+
+  export const TOWER_ENERGY_COST = 10
+  export const TOWER_RANGE = 20
+  export const TOWER_HITS = 3000
+  export const TOWER_CAPACITY = 10
+  export const TOWER_POWER_ATTACK = 1000
+  export const TOWER_POWER_HEAL = 600
+  export const TOWER_POWER_REPAIR = 200
+  export const TOWER_OPTIMAL_RANGE = 1
+  export const TOWER_FALLOFF_RANGE = 20
+  export const TOWER_FALLOFF = 1
+  export const TOWER_COOLDOWN = 10
+
+  export const BODYPART_COST
+
+  export const MAX_CREEP_SIZE = 50
+  export const CREEP_SPAWN_TIME = 3
+
+  export const RESOURCE_ENERGY = 'energy'
+  export const RESOURCES_ALL
+
+  export const SOURCE_ENERGY_REGEN = 10
+
+  export const RESOURCE_DECAY = 1000
+
+  export const MAX_CONSTRUCTION_SITES = 10
+
+  export const CONSTRUCTION_COST
+  export const STRUCTURE_PROTOTYPES
+
+  export const CONSTRUCTION_COST_ROAD_SWAMP_RATIO = 5
+  export const CONSTRUCTION_COST_ROAD_WALL_RATIO = 150
+
+  export const CONTAINER_HITS = 300
+  export const CONTAINER_CAPACITY = 2000
+
+  export const WALL_HITS = 10000
+  export const WALL_HITS_MAX = 10000
+
+  export const RAMPART_HITS = 10000
+  export const RAMPART_HITS_MAX = 10000
+
+  export const ROAD_HITS = 500
+  export const ROAD_WEAROUT = 1
+
+  export const EXTENSION_HITS = 100
+  export const EXTENSION_ENERGY_CAPACITY = 100
+
+  export const SPAWN_ENERGY_CAPACITY = 1000
+  export const SPAWN_HITS = 3000
+
+  export const EFF_CONSTRUCTION_BOOST = 'eff_construction_boost'
+  export const EFF_HEAL_BOOST = 'eff_heal_boost'
+  export const EFF_RANGED_ATTACK_BOOST = 'eff_ranged_attack_boost'
+  export const EFF_ATTACK_BOOST = 'eff_attack_boost'
+  export const EFF_WORK_BOOST = 'eff_work_boost'
+  export const EFF_MOVE_BOOST = 'eff_move_boost'
+}

package/src/game/index.d.ts

@@ -0,0 +1,12 @@
+declare module 'game' {
+  export * from 'game/constants'
+  export * as constants from 'game/constants'
+  export * from 'game/prototypes'
+  export * as prototypes from 'game/prototypes'
+  export * from 'game/path-finder'
+  export * as pathFinder from 'game/path-finder'
+  export * from 'game/utils'
+  export * as utils from 'game/utils'
+  export * from 'game/visual'
+  export * as visual from 'game/visual'
+}

package/src/game/path-finder.d.ts

@@ -0,0 +1,98 @@
+declare module 'game/path-finder' {
+  import { Position } from 'game/prototypes'
+
+  export type SearchPathOptions = {
+    /** Custom navigation cost data */
+    costMatrix?: CostMatrix
+
+    /** Cost for walking on plain positions. The default is 2 */
+    plainCost?: number
+
+    /** Cost for walking on swamp positions. The default is 10 */
+    swampCost?: number
+
+    /**
+     * Instead of searching for a path to the goals this will search for a path away from the goals.
+     * The cheapest path that is out of range of every goal will be returned.
+     * The default is false
+     */
+    flee?: boolean
+
+    /** The maximum allowed pathfinding operations. The default value is 50000 */
+    maxOps?: number
+
+    /** The maximum allowed cost of the path returned. The default is Infinity */
+    maxCost?: number
+
+    /** Weight from 1 to 9 to apply to the heuristic in the A* formula F = G + weight * H. The default value is 1.2 */
+    heuristicWeight?: number
+  }
+
+  export type SearchPathResult = {
+    /** The path found as an array of objects containing x and y properties */
+    path: Position[]
+
+    /** Total number of operations performed before this path was calculated */
+    ops: number
+
+    /** The total cost of the path as derived from plainCost, swampCost, and given CostMatrix instance */
+    cost: number
+
+    /** If the pathfinder fails to find a complete path, this will be true */
+    incomplete: boolean
+  }
+
+  /**
+   * Container for custom navigation cost data.
+   * If a non-0 value is found in the CostMatrix then that value will be used instead of the default terrain cost.
+   */
+  export class CostMatrix {
+    /**
+     * Creates a new {@link CostMatrix} containing 0's for all positions.
+     */
+    constructor()
+
+    /**
+     * Get the cost of a position in this {@link CostMatrix}.
+     * @param x The X position in the game
+     * @param y The Y position in the game
+     * @returns the cost at the specified position
+     */
+    get(x: number, y: number): number
+
+    /**
+     * Set the cost of a position in this {@link CostMatrix}.
+     * @param x The X position in the game
+     * @param y The Y position in the game
+     * @param cost Cost of this position.
+     */
+    set(x: number, y: number, cost: number): void
+
+    /**
+     * @returns a new {@link CostMatrix} instance.
+     */
+    clone(): CostMatrix
+  }
+
+  export type Goal = Position | { pos: Position; range: number }
+
+  /**
+   * Find an optimal path between origin and goal.
+   * @param origin The start position.
+   * @param goal A goal or an array of goals
+   * @param options An object containing additional pathfinding flags
+   * @param options.costMatrix Custom navigation cost data
+   * @param options.plainCost Cost for walking on plain positions. The default is 2
+   * @param options.swampCost Cost for walking on swamp positions. The default is 10
+   * @param options.flee Instead of searching for a path to the goals this will search for a path away from the goals. The default is false
+   * @param options.maxOps The maximum allowed pathfinding operations. The default value is 50000
+   * @param options.maxCost The maximum allowed cost of the path returned. The default is Infinity
+   * @param options.heuristicWeight Weight from 1 to 9 to apply to the heuristic in the A* formula F = G + weight * H. The default value is 1.2
+   * @returns a {@link SearchPathResult} object with the search result
+   */
+  export function searchPath(
+    origin: Position,
+    goal: Goal | Goal[],
+    options?: SearchPathOptions
+  ): SearchPathResult
+}

package/src/game/prototypes/construction-site.d.ts

@@ -0,0 +1,26 @@
+declare module 'game/prototypes/construction-site' {
+  import { Structure } from 'game/prototypes/structure'
+  import { GameObject } from 'game/prototypes/game-object'
+
+  /**
+   * A site of a structure which is currently under construction
+   */
+  export class ConstructionSite extends GameObject {
+    /** The current construction progress */
+    readonly progress?: number
+
+    /** The total construction progress needed for the structure to be built */
+    readonly progressTotal?: number
+
+    /** The structure that will be built (when the construction site is completed) */
+    readonly structure?: Structure
+
+    /** Whether it is your construction site */
+    readonly my?: boolean
+
+    /**
+     * Remove this construction site
+     */
+    remove(): void
+  }
+}