@whatever-engine/api 0.2.1 → 0.2.2

package/README.md

@@ -73,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

@@ -368,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 = [];

package/package.json

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