we ball I guess

types/overworld/overworld.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) 2026 Dominic Masters
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+
+/** Map loading and world-position management. */
+interface OverworldNamespace {
+  /**
+   * Loads the map with the given handle, disposing any currently loaded map.
+   * @param handle Map handle string (max 31 chars).
+   */
+  loadMap(handle: string): void;
+
+  /**
+   * Returns `true` when a map is currently loaded.
+   */
+  isLoaded(): boolean;
+
+  /**
+   * Slides the loaded chunk window to the given tile-space position.
+   * @param x Tile X.
+   * @param y Tile Y.
+   * @param z Tile Z.
+   */
+  setPosition(x: number, y: number, z: number): void;
+
+  /**
+   * Advances the map one tick. Call once per frame.
+   */
+  update(): void;
+
+  /**
+   * Unloads the current map.
+   */
+  dispose(): void;
+}
+
+declare var Overworld: OverworldNamespace;