@arcanejs/toolkit 3.1.1 → 4.1.0

package/dist/frontend/index.js

@@ -251,6 +251,10 @@ var Stage = ({ className, renderers }) => {
   );
   const socket = _react.useRef.call(void 0, null);
   const uuid = _react.useRef.call(void 0, null);
+  const calls = _react.useRef.call(void 0, {
+    nextId: 1,
+    calls: /* @__PURE__ */ new Map()
+  });
   const preparedRenderers = _react.useMemo.call(void 0, () => {
     const prepared = {};
     for (const renderer of renderers) {
@@ -268,10 +272,36 @@ var Stage = ({ className, renderers }) => {
     },
     [preparedRenderers]
   );
-  _react.useEffect.call(void 0, () => {
-    initializeWebsocket();
+  const handleMessage = _react.useCallback.call(void 0, (msg) => {
+    switch (msg.type) {
+      case "metadata":
+        uuid.current = msg.connectionUuid;
+        return;
+      case "tree-full":
+        setRoot(msg.root);
+        return;
+      case "tree-diff":
+        setRoot((prevRoot) => _diff.patchJson.call(void 0, prevRoot, msg.diff));
+        return;
+      case "call-response": {
+        const call2 = calls.current.calls.get(msg.requestId);
+        if (call2) {
+          calls.current.calls.delete(msg.requestId);
+          if (msg.success) {
+            call2.resolve(msg.returnValue);
+          } else {
+            call2.reject(msg.errorMessage);
+          }
+        } else {
+          console.warn(
+            `Received response for unknown call request ID ${msg.requestId}`
+          );
+        }
+        return;
+      }
+    }
   }, []);
-  const initializeWebsocket = async () => {
+  const initializeWebsocket = _react.useCallback.call(void 0, async () => {
     console.log("initializing websocket");
     const wsUrl = new URL(window.location.href);
     wsUrl.protocol = wsUrl.protocol === "https:" ? "wss:" : "ws:";
@@ -295,29 +325,42 @@ var Stage = ({ className, renderers }) => {
       };
     });
     return ws;
-  };
-  const sendMessage = async (msg) => {
+  }, []);
+  const sendMessage = _react.useCallback.call(void 0, async (msg) => {
     (await (socket.current || initializeWebsocket())).send(JSON.stringify(msg));
-  };
-  const handleMessage = (msg) => {
-    switch (msg.type) {
-      case "metadata":
-        uuid.current = msg.connectionUuid;
-        return;
-      case "tree-full":
-        setRoot(msg.root);
-        return;
-      case "tree-diff":
-        setRoot((prevRoot) => _diff.patchJson.call(void 0, prevRoot, msg.diff));
-        return;
-    }
-  };
+  }, []);
+  const call = _react.useCallback.call(void 0, 
+    async (msg) => {
+      const requestId = calls.current.nextId++;
+      const sendMsg = {
+        ...msg,
+        requestId
+      };
+      const promise = new Promise(
+        (resolve, reject) => {
+          calls.current.calls.set(requestId, {
+            resolve,
+            reject
+          });
+          (socket.current || initializeWebsocket()).then(
+            (s) => s.send(JSON.stringify(sendMsg))
+          );
+        }
+      );
+      return promise;
+    },
+    []
+  );
+  _react.useEffect.call(void 0, () => {
+    initializeWebsocket();
+  }, [initializeWebsocket]);
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
     _toolkitfrontend.StageContext.Provider,
     {
       value: {
         sendMessage,
         renderComponent,
+        call,
         get connectionUuid() {
           if (!uuid.current) {
             throw new Error("Unexpected missing UUID");

package/dist/frontend/index.mjs

@@ -251,6 +251,10 @@ var Stage = ({ className, renderers }) => {
   );
   const socket = useRef(null);
   const uuid = useRef(null);
+  const calls = useRef({
+    nextId: 1,
+    calls: /* @__PURE__ */ new Map()
+  });
   const preparedRenderers = useMemo(() => {
     const prepared = {};
     for (const renderer of renderers) {
@@ -268,10 +272,36 @@ var Stage = ({ className, renderers }) => {
     },
     [preparedRenderers]
   );
-  useEffect2(() => {
-    initializeWebsocket();
+  const handleMessage = useCallback((msg) => {
+    switch (msg.type) {
+      case "metadata":
+        uuid.current = msg.connectionUuid;
+        return;
+      case "tree-full":
+        setRoot(msg.root);
+        return;
+      case "tree-diff":
+        setRoot((prevRoot) => patchJson(prevRoot, msg.diff));
+        return;
+      case "call-response": {
+        const call2 = calls.current.calls.get(msg.requestId);
+        if (call2) {
+          calls.current.calls.delete(msg.requestId);
+          if (msg.success) {
+            call2.resolve(msg.returnValue);
+          } else {
+            call2.reject(msg.errorMessage);
+          }
+        } else {
+          console.warn(
+            `Received response for unknown call request ID ${msg.requestId}`
+          );
+        }
+        return;
+      }
+    }
   }, []);
-  const initializeWebsocket = async () => {
+  const initializeWebsocket = useCallback(async () => {
     console.log("initializing websocket");
     const wsUrl = new URL(window.location.href);
     wsUrl.protocol = wsUrl.protocol === "https:" ? "wss:" : "ws:";
@@ -295,29 +325,42 @@ var Stage = ({ className, renderers }) => {
       };
     });
     return ws;
-  };
-  const sendMessage = async (msg) => {
+  }, []);
+  const sendMessage = useCallback(async (msg) => {
     (await (socket.current || initializeWebsocket())).send(JSON.stringify(msg));
-  };
-  const handleMessage = (msg) => {
-    switch (msg.type) {
-      case "metadata":
-        uuid.current = msg.connectionUuid;
-        return;
-      case "tree-full":
-        setRoot(msg.root);
-        return;
-      case "tree-diff":
-        setRoot((prevRoot) => patchJson(prevRoot, msg.diff));
-        return;
-    }
-  };
+  }, []);
+  const call = useCallback(
+    async (msg) => {
+      const requestId = calls.current.nextId++;
+      const sendMsg = {
+        ...msg,
+        requestId
+      };
+      const promise = new Promise(
+        (resolve, reject) => {
+          calls.current.calls.set(requestId, {
+            resolve,
+            reject
+          });
+          (socket.current || initializeWebsocket()).then(
+            (s) => s.send(JSON.stringify(sendMsg))
+          );
+        }
+      );
+      return promise;
+    },
+    []
+  );
+  useEffect2(() => {
+    initializeWebsocket();
+  }, [initializeWebsocket]);
   return /* @__PURE__ */ jsx2(
     StageContext.Provider,
     {
       value: {
         sendMessage,
         renderComponent,
+        call,
         get connectionUuid() {
           if (!uuid.current) {
             throw new Error("Unexpected missing UUID");

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-export { A as AnyComponent, B as Button, G as Group, c as GroupHeader, T as Toolkit, a as ToolkitConnection, b as ToolkitOptions } from './toolkit-DB8G2TaA.mjs';
+export { A as AnyComponent, B as Button, G as Group, c as GroupHeader, T as Toolkit, a as ToolkitConnection, b as ToolkitOptions } from './toolkit-CQMnQMOF.mjs';
 export { Label } from './backend/components/label.mjs';
 export { Rect } from './backend/components/rect.mjs';
 export { SliderButton } from './backend/components/slider-button.mjs';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AnyComponent, B as Button, G as Group, c as GroupHeader, T as Toolkit, a as ToolkitConnection, b as ToolkitOptions } from './toolkit-2w2SWHlT.js';
+export { A as AnyComponent, B as Button, G as Group, c as GroupHeader, T as Toolkit, a as ToolkitConnection, b as ToolkitOptions } from './toolkit-C37sQAkD.js';
 export { Label } from './backend/components/label.js';
 export { Rect } from './backend/components/rect.js';
 export { SliderButton } from './backend/components/slider-button.js';

package/dist/index.js

@@ -1,38 +1,38 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2;
 
 
-var _chunkGMDJYFHDjs = require('./chunk-GMDJYFHD.js');
+var _chunkU6FSQBQ3js = require('./chunk-U6FSQBQ3.js');
 
 
-var _chunk4OZ22IQUjs = require('./chunk-4OZ22IQU.js');
+var _chunkHTCWMJUAjs = require('./chunk-HTCWMJUA.js');
 
 
-var _chunk6CWEURJPjs = require('./chunk-6CWEURJP.js');
+var _chunk6QWYIJLMjs = require('./chunk-6QWYIJLM.js');
 
 
 var _chunkEABM5X65js = require('./chunk-EABM5X65.js');
 
 
-var _chunkDG75CS7Fjs = require('./chunk-DG75CS7F.js');
+var _chunk4OCRZD4Fjs = require('./chunk-4OCRZD4F.js');
 
 
 
-var _chunkO5ZW6JYGjs = require('./chunk-O5ZW6JYG.js');
+var _chunk7JIC2XBCjs = require('./chunk-7JIC2XBC.js');
 
 
-var _chunkDRQVYGTIjs = require('./chunk-DRQVYGTI.js');
+var _chunk3GTEUTFTjs = require('./chunk-3GTEUTFT.js');
 
 
-var _chunk7OX2FB6Cjs = require('./chunk-7OX2FB6C.js');
+var _chunkQAH2OSHRjs = require('./chunk-QAH2OSHR.js');
 
 
-var _chunkCME7HZZKjs = require('./chunk-CME7HZZK.js');
+var _chunkNL3W4M7Jjs = require('./chunk-NL3W4M7J.js');
 
 
-var _chunkVEZGD2PGjs = require('./chunk-VEZGD2PG.js');
+var _chunk53EOA4UEjs = require('./chunk-53EOA4UE.js');
 
 
-var _chunkSGACFY53js = require('./chunk-SGACFY53.js');
+var _chunkWN3GXVUEjs = require('./chunk-WN3GXVUE.js');
 
 
 var _chunk3RG5ZIWIjs = require('./chunk-3RG5ZIWI.js');
@@ -189,8 +189,8 @@ var Toolkit = (_class2 = class {
   __init5() {this.connections = /* @__PURE__ */ new Map()}
   __init6() {this.rootGroup = null}
   /** @hidden */
-  __init7() {this.events = new (0, _chunkSGACFY53js.EventEmitter)()}
-  constructor(options = {}) {;_class2.prototype.__init4.call(this);_class2.prototype.__init5.call(this);_class2.prototype.__init6.call(this);_class2.prototype.__init7.call(this);_class2.prototype.__init8.call(this);_class2.prototype.__init9.call(this);_class2.prototype.__init10.call(this);_class2.prototype.__init11.call(this);_class2.prototype.__init12.call(this);_class2.prototype.__init13.call(this);_class2.prototype.__init14.call(this);_class2.prototype.__init15.call(this);_class2.prototype.__init16.call(this);_class2.prototype.__init17.call(this);
+  __init7() {this.events = new (0, _chunkWN3GXVUEjs.EventEmitter)()}
+  constructor(options = {}) {;_class2.prototype.__init4.call(this);_class2.prototype.__init5.call(this);_class2.prototype.__init6.call(this);_class2.prototype.__init7.call(this);_class2.prototype.__init8.call(this);_class2.prototype.__init9.call(this);_class2.prototype.__init10.call(this);_class2.prototype.__init11.call(this);_class2.prototype.__init12.call(this);_class2.prototype.__init13.call(this);_class2.prototype.__init14.call(this);_class2.prototype.__init15.call(this);_class2.prototype.__init16.call(this);_class2.prototype.__init17.call(this);_class2.prototype.__init18.call(this);
     this.options = {
       ...DEFAULT_LIGHT_DESK_OPTIONS,
       ...options
@@ -299,7 +299,37 @@ var Toolkit = (_class2 = class {
       this.events.emit("closed-connection", con.publicConnection);
     }
   }}
-  __init17() {this.onMessage = (connection, message) => {
+  __init17() {this.handleCall = async (connection, publicConnection, call) => {
+    try {
+      const rg = this.rootGroup;
+      if (rg) {
+        const returnValue = await new Promise(
+          (resolve2, reject) => rg.routeCall(this.componentIDMap, call, publicConnection, {
+            resolve: resolve2,
+            reject
+          })
+        );
+        connection.sendMessage({
+          type: "call-response",
+          namespace: call.namespace,
+          requestId: call.requestId,
+          success: true,
+          returnValue
+        });
+      } else {
+        throw new Error("No root group set");
+      }
+    } catch (err) {
+      connection.sendMessage({
+        type: "call-response",
+        namespace: call.namespace,
+        requestId: call.requestId,
+        success: false,
+        errorMessage: `${err}`
+      });
+    }
+  }}
+  __init18() {this.onMessage = (connection, message) => {
     const con = this.connections.get(connection);
     if (!con) {
       _optionalChain([this, 'access', _62 => _62.log, 'call', _63 => _63(), 'optionalAccess', _64 => _64.warn, 'call', _65 => _65(`got message from unknown connection`)]);
@@ -320,6 +350,9 @@ var Toolkit = (_class2 = class {
             publicConnection
           );
         break;
+      case "component-call":
+        this.handleCall(connection, publicConnection, message);
+        break;
     }
   }}
 }, _class2);
@@ -336,4 +369,4 @@ var Toolkit = (_class2 = class {
 
 
 
-exports.Button = _chunkDG75CS7Fjs.Button; exports.Group = _chunkO5ZW6JYGjs.Group; exports.GroupHeader = _chunkO5ZW6JYGjs.GroupHeader; exports.Label = _chunkDRQVYGTIjs.Label; exports.Rect = _chunk7OX2FB6Cjs.Rect; exports.SliderButton = _chunkCME7HZZKjs.SliderButton; exports.Switch = _chunkVEZGD2PGjs.Switch; exports.Tab = _chunkGMDJYFHDjs.Tab; exports.Tabs = _chunkGMDJYFHDjs.Tabs; exports.TextInput = _chunk4OZ22IQUjs.TextInput; exports.Timeline = _chunk6CWEURJPjs.Timeline; exports.Toolkit = Toolkit;
+exports.Button = _chunk4OCRZD4Fjs.Button; exports.Group = _chunk7JIC2XBCjs.Group; exports.GroupHeader = _chunk7JIC2XBCjs.GroupHeader; exports.Label = _chunk3GTEUTFTjs.Label; exports.Rect = _chunkQAH2OSHRjs.Rect; exports.SliderButton = _chunkNL3W4M7Jjs.SliderButton; exports.Switch = _chunk53EOA4UEjs.Switch; exports.Tab = _chunkU6FSQBQ3js.Tab; exports.Tabs = _chunkU6FSQBQ3js.Tabs; exports.TextInput = _chunkHTCWMJUAjs.TextInput; exports.Timeline = _chunk6QWYIJLMjs.Timeline; exports.Toolkit = Toolkit;

package/dist/index.mjs

@@ -1,38 +1,38 @@
 import {
   Tab,
   Tabs
-} from "./chunk-7TTY7CBH.mjs";
+} from "./chunk-KMEDXCBI.mjs";
 import {
   TextInput
-} from "./chunk-YBBUC3QC.mjs";
+} from "./chunk-WDB3IMOP.mjs";
 import {
   Timeline
-} from "./chunk-K37TZB75.mjs";
+} from "./chunk-3TXBS2UN.mjs";
 import {
   IDMap
 } from "./chunk-RGHJEMWG.mjs";
 import {
   Button
-} from "./chunk-W42AOMM6.mjs";
+} from "./chunk-LK6MGXYC.mjs";
 import {
   Group,
   GroupHeader
-} from "./chunk-5D7OSUZ6.mjs";
+} from "./chunk-E6FGU7DA.mjs";
 import {
   Label
-} from "./chunk-CUZSHFDP.mjs";
+} from "./chunk-UQWCTVMC.mjs";
 import {
   Rect
-} from "./chunk-N6IHYBZH.mjs";
+} from "./chunk-6ELB27LK.mjs";
 import {
   SliderButton
-} from "./chunk-JFZXSCGK.mjs";
+} from "./chunk-QB2WPBWV.mjs";
 import {
   Switch
-} from "./chunk-NEQRLPXK.mjs";
+} from "./chunk-PG5EAV5X.mjs";
 import {
   EventEmitter
-} from "./chunk-RYR5I5FT.mjs";
+} from "./chunk-GONHNB6V.mjs";
 import {
   __require
 } from "./chunk-Y6FXYEAI.mjs";
@@ -299,6 +299,36 @@ var Toolkit = class {
       this.events.emit("closed-connection", con.publicConnection);
     }
   };
+  handleCall = async (connection, publicConnection, call) => {
+    try {
+      const rg = this.rootGroup;
+      if (rg) {
+        const returnValue = await new Promise(
+          (resolve2, reject) => rg.routeCall(this.componentIDMap, call, publicConnection, {
+            resolve: resolve2,
+            reject
+          })
+        );
+        connection.sendMessage({
+          type: "call-response",
+          namespace: call.namespace,
+          requestId: call.requestId,
+          success: true,
+          returnValue
+        });
+      } else {
+        throw new Error("No root group set");
+      }
+    } catch (err) {
+      connection.sendMessage({
+        type: "call-response",
+        namespace: call.namespace,
+        requestId: call.requestId,
+        success: false,
+        errorMessage: `${err}`
+      });
+    }
+  };
   onMessage = (connection, message) => {
     const con = this.connections.get(connection);
     if (!con) {
@@ -320,6 +350,9 @@ var Toolkit = class {
             publicConnection
           );
         break;
+      case "component-call":
+        this.handleCall(connection, publicConnection, message);
+        break;
     }
   };
 };

package/dist/{toolkit-2w2SWHlT.d.ts → toolkit-C37sQAkD.d.ts}

@@ -4,7 +4,7 @@ import _ from 'lodash';
 import * as http from 'http';
 import { Application } from 'express';
 import { WebSocket } from 'ws';
-import { ClientMessage, ServerMessage, BaseComponentProto, AnyClientComponentMessage } from '@arcanejs/protocol';
+import { ClientMessage, ServerMessage, BaseComponentProto, AnyClientComponentMessage, AnyClientComponentCall, ReturnForPair } from '@arcanejs/protocol';
 import * as proto from '@arcanejs/protocol/core';
 import { GroupComponentStyle } from '@arcanejs/protocol/styles';
 import { I as IDMap } from './id-map-DxQ3_gyA.js';
@@ -88,7 +88,7 @@ type InitializationOptions =
     setup: (server: Server) => void;
 };
 
-declare abstract class Base<Namespace extends string, Proto extends BaseComponentProto<Namespace>, Props> {
+declare abstract class Base<Namespace extends string, Proto extends BaseComponentProto<Namespace, string>, Props, CallPairs = any, CallActions extends string & keyof CallPairs = any> {
     /** @hidden */
     private parent;
     /** @hidden */
@@ -117,16 +117,22 @@ declare abstract class Base<Namespace extends string, Proto extends BaseComponen
     abstract getProtoInfo(idMap: IDMap): Proto;
     /** @hidden */
     handleMessage(_message: AnyClientComponentMessage, _connection: ToolkitConnection): void;
+    /** @hidden */
+    handleCall(_call: AnyClientComponentCall, _connection: ToolkitConnection): Promise<ReturnForPair<CallPairs, CallActions>>;
     routeMessage(_idMap: IDMap, _message: AnyClientComponentMessage, _connection: ToolkitConnection): void;
+    routeCall(_idMap: IDMap, _call: AnyClientComponentCall, _connection: ToolkitConnection, _callbacks: {
+        resolve: (result: unknown) => void;
+        reject: (error: unknown) => void;
+    }): void;
 }
-type AnyComponent = Base<string, BaseComponentProto<string>, any>;
+type AnyComponent = Base<string, BaseComponentProto<string, string>, any>;
 /** @hidden */
 interface Parent {
     updateTree(): void;
     removeChild(component: AnyComponent): void;
     log(): Logger | null;
 }
-declare abstract class BaseParent<Namespace extends string, Proto extends BaseComponentProto<Namespace>, T> extends Base<Namespace, Proto, T> implements Parent {
+declare abstract class BaseParent<Namespace extends string, Proto extends BaseComponentProto<Namespace, string>, T, CallPairs = any, CallActions extends string & keyof CallPairs = any> extends Base<Namespace, Proto, T, CallPairs, CallActions> implements Parent {
     /** @hidden */
     private children;
     abstract validateChildren(children: AnyComponent[]): void;
@@ -145,6 +151,10 @@ declare abstract class BaseParent<Namespace extends string, Proto extends BaseCo
      * @hidden
      */
     routeMessage(idMap: IDMap, message: AnyClientComponentMessage, connection: ToolkitConnection): void;
+    routeCall(idMap: IDMap, call: AnyClientComponentCall, connection: ToolkitConnection, callbacks: {
+        resolve: (result: unknown) => void;
+        reject: (error: unknown) => void;
+    }): Promise<void>;
     insertBefore(child: AnyComponent, beforeChild: AnyComponent): void;
 }
 interface Listenable<Map extends Record<string, (...args: any[]) => void>> {
@@ -155,7 +165,12 @@ declare class EventEmitter<Map extends Record<string, (...args: any[]) => void>>
     private readonly listeners;
     addListener: <T extends keyof Map>(type: T, listener: Map[T]) => void;
     removeListener: <T extends keyof Map>(type: T, listener: Map[T]) => void;
-    emit: <T extends keyof Map>(type: T, ...args: Parameters<Map[T]>) => Promise<unknown>;
+    emit: <T extends keyof Map>(type: T, ...args: Parameters<Map[T]>) => Promise<ReturnType<Map[T]>[]>;
+    /**
+     * Like {@link emit},
+     * but ensures only a single listener exists and returns its result.
+     */
+    call: <T extends keyof Map>(type: T, ...args: Parameters<Map[T]>) => Promise<ReturnType<Map[T]>>;
     /**
      * Process prop changes to update listeners
      */
@@ -174,7 +189,7 @@ type InternalProps$1 = {
     onClick?: Events$2['click'] | null;
 };
 type Props$1 = Partial<InternalProps$1>;
-declare class Button extends Base<proto.CoreNamespace, proto.CoreComponent, InternalProps$1> implements Listenable<Events$2> {
+declare class Button extends Base<proto.CoreNamespace, proto.ButtonComponent, InternalProps$1, proto.CoreComponentCalls, 'press'> implements Listenable<Events$2> {
     /** @hidden */
     private readonly events;
     constructor(props?: Props$1);
@@ -186,7 +201,7 @@ declare class Button extends Base<proto.CoreNamespace, proto.CoreComponent, Inte
     /** @hidden */
     getProtoInfo: (idMap: IDMap) => proto.ButtonComponent;
     /** @hidden */
-    handleMessage: (message: AnyClientComponentMessage, connection: ToolkitConnection) => void;
+    handleCall: (call: AnyClientComponentCall, connection: ToolkitConnection) => Promise<true>;
 }
 
 type Label = (proto.GroupComponent['labels'] & Array<unknown>)[number];
@@ -263,6 +278,7 @@ declare class Toolkit implements Parent, Listenable<Events> {
     removeChild: (component: AnyComponent) => void;
     private onNewConnection;
     private onClosedConnection;
+    private handleCall;
     private onMessage;
 }
 

package/dist/{toolkit-DB8G2TaA.d.mts → toolkit-CQMnQMOF.d.mts}

@@ -4,7 +4,7 @@ import _ from 'lodash';
 import * as http from 'http';
 import { Application } from 'express';
 import { WebSocket } from 'ws';
-import { ClientMessage, ServerMessage, BaseComponentProto, AnyClientComponentMessage } from '@arcanejs/protocol';
+import { ClientMessage, ServerMessage, BaseComponentProto, AnyClientComponentMessage, AnyClientComponentCall, ReturnForPair } from '@arcanejs/protocol';
 import * as proto from '@arcanejs/protocol/core';
 import { GroupComponentStyle } from '@arcanejs/protocol/styles';
 import { I as IDMap } from './id-map-DxQ3_gyA.mjs';
@@ -88,7 +88,7 @@ type InitializationOptions =
     setup: (server: Server) => void;
 };
 
-declare abstract class Base<Namespace extends string, Proto extends BaseComponentProto<Namespace>, Props> {
+declare abstract class Base<Namespace extends string, Proto extends BaseComponentProto<Namespace, string>, Props, CallPairs = any, CallActions extends string & keyof CallPairs = any> {
     /** @hidden */
     private parent;
     /** @hidden */
@@ -117,16 +117,22 @@ declare abstract class Base<Namespace extends string, Proto extends BaseComponen
     abstract getProtoInfo(idMap: IDMap): Proto;
     /** @hidden */
     handleMessage(_message: AnyClientComponentMessage, _connection: ToolkitConnection): void;
+    /** @hidden */
+    handleCall(_call: AnyClientComponentCall, _connection: ToolkitConnection): Promise<ReturnForPair<CallPairs, CallActions>>;
     routeMessage(_idMap: IDMap, _message: AnyClientComponentMessage, _connection: ToolkitConnection): void;
+    routeCall(_idMap: IDMap, _call: AnyClientComponentCall, _connection: ToolkitConnection, _callbacks: {
+        resolve: (result: unknown) => void;
+        reject: (error: unknown) => void;
+    }): void;
 }
-type AnyComponent = Base<string, BaseComponentProto<string>, any>;
+type AnyComponent = Base<string, BaseComponentProto<string, string>, any>;
 /** @hidden */
 interface Parent {
     updateTree(): void;
     removeChild(component: AnyComponent): void;
     log(): Logger | null;
 }
-declare abstract class BaseParent<Namespace extends string, Proto extends BaseComponentProto<Namespace>, T> extends Base<Namespace, Proto, T> implements Parent {
+declare abstract class BaseParent<Namespace extends string, Proto extends BaseComponentProto<Namespace, string>, T, CallPairs = any, CallActions extends string & keyof CallPairs = any> extends Base<Namespace, Proto, T, CallPairs, CallActions> implements Parent {
     /** @hidden */
     private children;
     abstract validateChildren(children: AnyComponent[]): void;
@@ -145,6 +151,10 @@ declare abstract class BaseParent<Namespace extends string, Proto extends BaseCo
      * @hidden
      */
     routeMessage(idMap: IDMap, message: AnyClientComponentMessage, connection: ToolkitConnection): void;
+    routeCall(idMap: IDMap, call: AnyClientComponentCall, connection: ToolkitConnection, callbacks: {
+        resolve: (result: unknown) => void;
+        reject: (error: unknown) => void;
+    }): Promise<void>;
     insertBefore(child: AnyComponent, beforeChild: AnyComponent): void;
 }
 interface Listenable<Map extends Record<string, (...args: any[]) => void>> {
@@ -155,7 +165,12 @@ declare class EventEmitter<Map extends Record<string, (...args: any[]) => void>>
     private readonly listeners;
     addListener: <T extends keyof Map>(type: T, listener: Map[T]) => void;
     removeListener: <T extends keyof Map>(type: T, listener: Map[T]) => void;
-    emit: <T extends keyof Map>(type: T, ...args: Parameters<Map[T]>) => Promise<unknown>;
+    emit: <T extends keyof Map>(type: T, ...args: Parameters<Map[T]>) => Promise<ReturnType<Map[T]>[]>;
+    /**
+     * Like {@link emit},
+     * but ensures only a single listener exists and returns its result.
+     */
+    call: <T extends keyof Map>(type: T, ...args: Parameters<Map[T]>) => Promise<ReturnType<Map[T]>>;
     /**
      * Process prop changes to update listeners
      */
@@ -174,7 +189,7 @@ type InternalProps$1 = {
     onClick?: Events$2['click'] | null;
 };
 type Props$1 = Partial<InternalProps$1>;
-declare class Button extends Base<proto.CoreNamespace, proto.CoreComponent, InternalProps$1> implements Listenable<Events$2> {
+declare class Button extends Base<proto.CoreNamespace, proto.ButtonComponent, InternalProps$1, proto.CoreComponentCalls, 'press'> implements Listenable<Events$2> {
     /** @hidden */
     private readonly events;
     constructor(props?: Props$1);
@@ -186,7 +201,7 @@ declare class Button extends Base<proto.CoreNamespace, proto.CoreComponent, Inte
     /** @hidden */
     getProtoInfo: (idMap: IDMap) => proto.ButtonComponent;
     /** @hidden */
-    handleMessage: (message: AnyClientComponentMessage, connection: ToolkitConnection) => void;
+    handleCall: (call: AnyClientComponentCall, connection: ToolkitConnection) => Promise<true>;
 }
 
 type Label = (proto.GroupComponent['labels'] & Array<unknown>)[number];
@@ -263,6 +278,7 @@ declare class Toolkit implements Parent, Listenable<Events> {
     removeChild: (component: AnyComponent) => void;
     private onNewConnection;
     private onClosedConnection;
+    private handleCall;
     private onMessage;
 }