@whatever-engine/api 0.2.0 → 0.2.1

package/README.md

@@ -25,10 +25,14 @@ No install step needed — Bun resolves the package automatically for any script
 - `Engine.on(event, handler)` — subscribe to an engine event (`init`, `exit`, `tick`, `mod_message`)
 - `Engine.log(level, message)` — log through the engine logger (`"info"`, `"warn"`, `"error"`)
 - `Engine.setTickRate(ticks_per_second)` — override the game tick rate at runtime
+- `Engine.setFpsCap(fps | null)` — set FPS cap; `null` = uncapped
+- `Engine.setVsync(enabled)` — enable or disable vertical sync
 
 ### `Window`
 
 - `Window.setTitle(title)` — change the window title
+- `Window.setSize(width, height)` — request a new inner size in physical pixels (no-op in fullscreen modes)
+- `Window.setMode(mode)` — set display mode: `"windowed"`, `"borderless"`, or `"fullscreen"`
 
 ### `File`
 

package/dist/index.d.ts

@@ -80,11 +80,26 @@ export declare const Engine: {
 	log(level: "info" | "warn" | "error", message: string): void;
 	/** Override the game tick rate. Takes effect immediately. */
 	setTickRate(ticks_per_second: number): void;
+	/** Set the FPS cap. Pass `null` to remove the cap (uncapped). */
+	setFpsCap(fps: number | null): void;
+	/** Enable or disable vertical sync. Takes effect immediately. */
+	setVsync(enabled: boolean): void;
 };
+export type WindowMode = "windowed" | "borderless" | "fullscreen";
 /** Window management. */
 export declare const Window: {
 	/** Set the title of the active window. */
 	setTitle(title: string): void;
+	/** Request a new inner window size in physical pixels. Has no effect in fullscreen modes. */
+	setSize(width: number, height: number): void;
+	/**
+	 * Set the window display mode.
+	 * - `"windowed"` — normal window
+	 * - `"borderless"` — borderless fullscreen (windowed fullscreen)
+	 * - `"fullscreen"` — exclusive fullscreen using the monitor's preferred video mode;
+	 *   falls back to borderless if no exclusive mode is available
+	 */
+	setMode(mode: WindowMode): void;
 };
 /** Sandboxed per-mod file I/O. Paths must not contain `..`. */
 declare const File$1: {

package/dist/index.js

@@ -221,12 +221,24 @@ var Engine = {
   },
   setTickRate(ticks_per_second) {
     _send({ type: "SetTickRate", ticks_per_second });
+  },
+  setFpsCap(fps) {
+    _send({ type: "SetFpsCap", fps });
+  },
+  setVsync(enabled) {
+    _send({ type: "SetVsync", enabled });
   }
 };
 // src/components/window.ts
 var Window = {
   setTitle(title) {
     _send({ type: "SetWindowTitle", title });
+  },
+  setSize(width, height) {
+    _send({ type: "SetWindowSize", width, height });
+  },
+  setMode(mode) {
+    _send({ type: "SetWindowMode", mode });
   }
 };
 // src/components/file.ts

package/package.json

@@ -3,7 +3,7 @@
   "author": "Mester",
   "license": "Apache-2.0",
   "description": "TypeScript scripting API for Whatever Engine mods",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {