@whatever-engine/api 0.2.0 → 0.2.2

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`
 
@@ -69,7 +73,7 @@ Built-in component types: `core:transform`, `core:sprite_renderer`. `getComponen
 
 Methods (all setters chainable, return `this`):
 
-- `getX/Y/Z()`, `setX/Y/Z(v)` — individual position components
+- `getX/Y/Z()`, `setX/Y/Z(v)`, `addX/Y/Z(v)` — individual position components
 - `getPosition()` → `[x, y, z]`, `setPosition(x, y, z)` — full position
 - `getScaleX/Y/Z()`, `setScaleX/Y/Z(v)` — individual scale components
 - `getScale()` → `[x, y, z]`, `setScale(x, y, z)`, `setScaleUniform(s)` — full scale

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: {
@@ -353,6 +368,10 @@ export type ArgSpec = {
 	type: ArgType;
 	required?: boolean;
 	description?: string;
+	/** Called to provide autocomplete suggestions for this argument.
+	 *  Receives the current raw text the user has typed (empty string if nothing yet).
+	 *  Return a list of candidate strings. */
+	suggest?: (current: string) => string[] | Promise<string[]>;
 };
 /** A command or subcommand specification. */
 export type CommandSpec = {

package/dist/index.js

@@ -28,14 +28,21 @@ var _EVENT_SUBSCRIBE = {
 // src/components/console.ts
 var _cmdHandlers = new Map;
 var _cmdArgSpecs = new Map;
+var _argSuggesters = new Map;
 function _specToInternal(spec, pathPrefix) {
   const path = pathPrefix ? `${pathPrefix}.${spec.name}` : spec.name;
-  const mappedArgs = (spec.args ?? []).map((a) => ({
-    name: a.name,
-    type: a.type,
-    required: a.required ?? false,
-    description: a.description ?? ""
-  }));
+  const mappedArgs = (spec.args ?? []).map((a, i) => {
+    if (a.suggest) {
+      _argSuggesters.set(`${path}:${i}`, a.suggest);
+    }
+    return {
+      name: a.name,
+      type: a.type,
+      required: a.required ?? false,
+      description: a.description ?? "",
+      has_suggest: !!a.suggest
+    };
+  });
   if (spec.handler) {
     _cmdHandlers.set(path, spec.handler);
     _cmdArgSpecs.set(path, mappedArgs);
@@ -71,6 +78,19 @@ async function _handleCommandInvoke(msg) {
     _send({ type: "CommandResponse", request_id: msg.request_id, output: [], error: message });
   }
 }
+async function _handleArgSuggestRequest(msg) {
+  const key = `${msg.command_path.join(".")}:${msg.arg_index}`;
+  const suggester = _argSuggesters.get(key);
+  let suggestions = [];
+  if (suggester) {
+    try {
+      suggestions = await suggester(msg.current);
+    } catch {
+      suggestions = [];
+    }
+  }
+  _send({ type: "ArgSuggestResponse", request_id: msg.request_id, suggestions });
+}
 var Console = {
   register(spec) {
     if (!/^[a-z_]+$/.test(spec.name)) {
@@ -94,6 +114,10 @@ function _dispatch(msg) {
     _handleCommandInvoke(msg);
     return;
   }
+  if (msg.type === "ArgSuggestRequest") {
+    _handleArgSuggestRequest(msg);
+    return;
+  }
   if (msg.type === "Tick") {
     const handlers = _handlers.get("tick");
     const promises = [];
@@ -221,12 +245,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.2",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {