@adcops/autocore-react 3.0.40 → 3.3.2

package/dist/hooks/useAutoCoreTag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAutoCoreTag.d.ts","sourceRoot":"","sources":["../../src/hooks/useAutoCoreTag.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEzF,wBAAgB,oBAAoB,CAAC,IAAI,SAAS,SAAS,SAAS,EAAE,EACpE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAC3D,IAAI,EAAE,IAAI;8BAYc,CAAC,2CAA4B,CAAC;;;;;;;+BAyB7B,CAAC,4CAA6B,SAAS,CAAC,EAAE;4BAOrD,CAAC;;kCAY6B,CAAC;;;iCAUlB,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,mBAAM,CAAC,KAAK,CAAC,SAAQ,GAAG,EAAE;;;;;;;uCAW7C,MAAM;;EAKlD"}

package/dist/hooks/useAutoCoreTag.js

@@ -0,0 +1 @@
+import{useCallback,useContext,useMemo}from"react";export function makeAutoCoreTagHooks(e,a){return{useAutoCoreTag:s=>{const{values:t,rawValues:u,isLoading:o,write:r,tap:n}=useContext(e),l=(e=>a.find(a=>a.fqdn===e))(s);if(!l)throw new Error(`useAutoCoreTag: unknown tagName '${String(s)}'`);const i=useCallback(e=>r(s,e),[r,s]),c=useCallback(()=>n?.(s),[n,s]);return{value:t[s],rawValue:u[s],write:i,tap:c,isLoading:o}},useAutoCoreTags:a=>{const{values:s,rawValues:t,isLoading:u,write:o}=useContext(e);return{values:useMemo(()=>Object.fromEntries(a.map(e=>[e,s[e]])),[s,a]),rawValues:useMemo(()=>Object.fromEntries(a.map(e=>[e,t[e]])),[t,a]),write:useCallback(async(e,a)=>{await o(e,a)},[o]),isLoading:u}},useAutoCoreSelect:(a,s=[])=>{const{values:t,isLoading:u}=useContext(e);return{selected:useMemo(()=>a(t),[t,...s]),isLoading:u}},useScales:()=>{const{scales:a,updateScale:s}=useContext(e),t=useCallback(e=>a[e],[a]);return{scales:a,updateScale:s,getScale:t}}}}

package/dist/hooks/useScaledValue.d.ts

@@ -62,3 +62,4 @@ type UseScaledValueReturn = [number, (newValue: number) => void];
  */
 export declare function useScaledValue(initialValue: number, scale: number, offset?: number): UseScaledValueReturn;
 export {};
+//# sourceMappingURL=useScaledValue.d.ts.map

package/dist/hooks/useScaledValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScaledValue.d.ts","sourceRoot":"","sources":["../../src/hooks/useScaledValue.tsx"],"names":[],"mappings":"AAaA;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAiB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAG,MAAyB,CAAC;AAGzD,KAAK,oBAAoB,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,oBAAoB,CAoB5G"}

package/dist/hooks/useScaledValue.js

@@ -1 +1 @@
-import{useCallback,useState,useEffect}from"react";export const kMillimeters2Inches=1/25.4;export const kNewtons2Pounds=1/4.4482216153;export function useScaledValue(e,t,s=0){const[u,c]=useState(e),[o,a]=useState((()=>e*t+s));useEffect((()=>{a(u*t+s)}),[u,t,s]);return[o,useCallback((e=>{c(e)}),[t,s])]}
+import{useCallback,useState,useEffect}from"react";export const kMillimeters2Inches=1/25.4;export const kNewtons2Pounds=1/4.4482216153;export function useScaledValue(e,t,s=0){const[u,c]=useState(e),[o,a]=useState(()=>e*t+s);useEffect(()=>{a(u*t+s)},[u,t,s]);return[o,useCallback(e=>{c(e)},[t,s])]}

package/dist/hub/CommandMessage.d.ts

@@ -1,12 +1,22 @@
-export interface CommandMessageResult {
-    data: any;
-    success: boolean;
-    error_message: string;
+export declare enum MessageType {
+    NoOp = 0,
+    Response = 1,
+    Read = 2,
+    Write = 3,
+    Subscribe = 4,
+    Unsubscribe = 5,
+    Broadcast = 6,
+    Heartbeat = 7,
+    Control = 8,
+    Request = 10
 }
 export interface CommandMessage {
-    request_id: number;
-    domain: string;
-    fname: string;
-    args?: any;
-    result?: CommandMessageResult;
+    transaction_id: number;
+    timecode: number;
+    topic: string;
+    message_type: MessageType;
+    data?: any;
+    success: boolean;
+    error_message: string;
 }
+//# sourceMappingURL=CommandMessage.d.ts.map

package/dist/hub/CommandMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandMessage.d.ts","sourceRoot":"","sources":["../../src/hub/CommandMessage.ts"],"names":[],"mappings":"AAuBA,oBAAY,WAAW;IAEnB,IAAI,IAAI;IAGR,QAAQ,IAAI;IAGZ,IAAI,IAAI;IAGR,KAAK,IAAI;IAGT,SAAS,IAAI;IAGb,WAAW,IAAI;IAGf,SAAS,IAAI;IAGb,SAAS,IAAI;IAGb,OAAO,IAAI;IAGX,OAAO,KAAK;CACf;AAMD,MAAM,WAAW,cAAc;IAG3B,cAAc,EAAE,MAAM,CAAC;IAIvB,QAAQ,EAAE,MAAM,CAAC;IAKjB,KAAK,EAAE,MAAM,CAAC;IAGd,YAAY,EAAE,WAAW,CAAC;IAK1B,IAAI,CAAC,EAAE,GAAG,CAAC;IAIX,OAAO,EAAE,OAAO,CAAC;IAGjB,aAAa,EAAE,MAAM,CAAC;CAEzB"}

package/dist/hub/CommandMessage.js

@@ -1 +1 @@
-export{};
+export var MessageType;!function(e){e[e.NoOp=0]="NoOp",e[e.Response=1]="Response",e[e.Read=2]="Read",e[e.Write=3]="Write",e[e.Subscribe=4]="Subscribe",e[e.Unsubscribe=5]="Unsubscribe",e[e.Broadcast=6]="Broadcast",e[e.Heartbeat=7]="Heartbeat",e[e.Control=8]="Control",e[e.Request=10]="Request"}(MessageType||(MessageType={}));

package/dist/hub/DebugPanel.d.ts

@@ -0,0 +1,31 @@
+interface DebugLog {
+    time: string;
+    type: "info" | "warn" | "error" | "send" | "recv";
+    source: string;
+    message: string;
+}
+declare class DebugPanel {
+    private container;
+    private logContainer;
+    private statsContainer;
+    private logs;
+    private maxLogs;
+    private stats;
+    constructor();
+    private injectPanel;
+    private setupElements;
+    private updateStats;
+    log(type: DebugLog["type"], source: string, message: string): void;
+    private renderLogs;
+    hubCreated(): void;
+    connectCalled(socketState: string): void;
+    wsOpened(url: string): void;
+    wsClosed(code: number, reason: string): void;
+    wsError(error: string): void;
+    messageSent(type: string, command: string, requestId: number): void;
+    messageReceived(type: string, command: string, requestId?: number): void;
+    updateState(state: string): void;
+}
+export declare function getDebugPanel(): DebugPanel;
+export default getDebugPanel;
+//# sourceMappingURL=DebugPanel.d.ts.map

package/dist/hub/DebugPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugPanel.d.ts","sourceRoot":"","sources":["../../src/hub/DebugPanel.ts"],"names":[],"mappings":"AAWA,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,cAAM,UAAU;IACd,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,OAAO,CAAO;IAGtB,OAAO,CAAC,KAAK,CASX;;IAOF,OAAO,CAAC,WAAW;IA2FnB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,WAAW;IAsBnB,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAyBlE,OAAO,CAAC,UAAU;IAgBlB,UAAU,IAAI,IAAI;IAMlB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAOxC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAO3B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAO5C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAMnE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAMxE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAIjC;AAKD,wBAAgB,aAAa,IAAI,UAAU,CAO1C;AAKD,eAAe,aAAa,CAAC"}

package/dist/hub/DebugPanel.js

@@ -0,0 +1 @@
+class DebugPanel{constructor(){Object.defineProperty(this,"container",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"logContainer",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"statsContainer",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"logs",{enumerable:!0,configurable:!0,writable:!0,value:[]}),Object.defineProperty(this,"maxLogs",{enumerable:!0,configurable:!0,writable:!0,value:100}),Object.defineProperty(this,"stats",{enumerable:!0,configurable:!0,writable:!0,value:{hubInstancesCreated:0,connectCalls:0,wsOpened:0,wsClosed:0,wsErrors:0,messagesSent:0,messagesReceived:0,currentState:"unknown"}}),this.injectPanel(),this.log("info","DebugPanel","Debug panel initialized")}injectPanel(){const e=document.getElementById("autocore-debug-panel");e&&e.remove(),this.container=document.createElement("div"),this.container.id="autocore-debug-panel",this.container.innerHTML='\n      <style>\n        #autocore-debug-panel {\n          position: fixed;\n          bottom: 10px;\n          right: 10px;\n          width: 400px;\n          max-height: 300px;\n          background: rgba(0, 0, 0, 0.9);\n          color: #0f0;\n          font-family: monospace;\n          font-size: 11px;\n          border: 1px solid #0f0;\n          border-radius: 4px;\n          z-index: 99999;\n          overflow: hidden;\n        }\n        #autocore-debug-panel .header {\n          background: #0f0;\n          color: #000;\n          padding: 4px 8px;\n          font-weight: bold;\n          cursor: pointer;\n          display: flex;\n          justify-content: space-between;\n        }\n        #autocore-debug-panel .stats {\n          padding: 4px 8px;\n          border-bottom: 1px solid #0f0;\n          display: grid;\n          grid-template-columns: 1fr 1fr;\n          gap: 2px;\n        }\n        #autocore-debug-panel .stats span {\n          color: #fff;\n        }\n        #autocore-debug-panel .stats .value {\n          color: #ff0;\n        }\n        #autocore-debug-panel .logs {\n          max-height: 180px;\n          overflow-y: auto;\n          padding: 4px;\n        }\n        #autocore-debug-panel .log-entry {\n          margin: 1px 0;\n          white-space: nowrap;\n          overflow: hidden;\n          text-overflow: ellipsis;\n        }\n        #autocore-debug-panel .log-entry.info { color: #888; }\n        #autocore-debug-panel .log-entry.warn { color: #fa0; }\n        #autocore-debug-panel .log-entry.error { color: #f44; }\n        #autocore-debug-panel .log-entry.send { color: #4f4; }\n        #autocore-debug-panel .log-entry.recv { color: #44f; }\n        #autocore-debug-panel .state-connected { color: #4f4 !important; }\n        #autocore-debug-panel .state-disconnected { color: #f44 !important; }\n        #autocore-debug-panel .state-connecting { color: #fa0 !important; }\n      </style>\n      <div class="header">\n        <span>AutoCore Debug</span>\n        <span id="debug-toggle">[_]</span>\n      </div>\n      <div id="debug-content">\n        <div class="stats" id="debug-stats"></div>\n        <div class="logs" id="debug-logs"></div>\n      </div>\n    ',document.body?(document.body.appendChild(this.container),this.setupElements()):document.addEventListener("DOMContentLoaded",()=>{document.body.appendChild(this.container),this.setupElements()})}setupElements(){this.statsContainer=document.getElementById("debug-stats"),this.logContainer=document.getElementById("debug-logs");const e=document.getElementById("debug-toggle"),t=document.getElementById("debug-content");e?.addEventListener("click",()=>{t&&(t.style.display="none"===t.style.display?"block":"none",e.textContent="none"===t.style.display?"[+]":"[_]")}),this.updateStats()}updateStats(){if(!this.statsContainer)return;const e="OPEN"===this.stats.currentState?"state-connected":"CONNECTING"===this.stats.currentState?"state-connecting":"state-disconnected";this.statsContainer.innerHTML=`\n      <div><span>Hub Instances:</span> <span class="value">${this.stats.hubInstancesCreated}</span></div>\n      <div><span>connect() calls:</span> <span class="value">${this.stats.connectCalls}</span></div>\n      <div><span>WS Opened:</span> <span class="value">${this.stats.wsOpened}</span></div>\n      <div><span>WS Closed:</span> <span class="value">${this.stats.wsClosed}</span></div>\n      <div><span>WS Errors:</span> <span class="value">${this.stats.wsErrors}</span></div>\n      <div><span>Msgs Sent:</span> <span class="value">${this.stats.messagesSent}</span></div>\n      <div><span>Msgs Recv:</span> <span class="value">${this.stats.messagesReceived}</span></div>\n      <div><span>WS State:</span> <span class="value ${e}">${this.stats.currentState}</span></div>\n    `}log(e,t,n){const s=(new Date).toTimeString().slice(0,8),a={time:s,type:e,source:t,message:n};this.logs.push(a),this.logs.length>this.maxLogs&&this.logs.shift();this.renderLogs()}renderLogs(){this.logContainer&&(this.logContainer.innerHTML=this.logs.slice(-50).map(e=>`<div class="log-entry ${e.type}">[${e.time}] ${e.source}: ${e.message}</div>`).join(""),this.logContainer.scrollTop=this.logContainer.scrollHeight)}hubCreated(){this.stats.hubInstancesCreated++,this.log("warn","Hub",`NEW INSTANCE CREATED (total: ${this.stats.hubInstancesCreated})`),this.updateStats()}connectCalled(e){this.stats.connectCalls++,this.stats.currentState=e,this.log("info","Hub",`connect() called (socket state: ${e})`),this.updateStats()}wsOpened(e){this.stats.wsOpened++,this.stats.currentState="OPEN",this.log("info","WS",`OPENED: ${e}`),this.updateStats()}wsClosed(e,t){this.stats.wsClosed++,this.stats.currentState="CLOSED",this.log("warn","WS",`CLOSED: code=${e}, reason=${t}`),this.updateStats()}wsError(e){this.stats.wsErrors++,this.log("error","WS",`ERROR: ${e}`),this.updateStats()}messageSent(e,t,n){this.stats.messagesSent++,this.log("send","WS",`>>> ${e}/${t} (id=${n})`),this.updateStats()}messageReceived(e,t,n){this.stats.messagesReceived++,this.log("recv","WS",`<<< ${e}/${t} (id=${n??"none"})`),this.updateStats()}updateState(e){this.stats.currentState=e,this.updateStats()}}let debugPanel=null;export function getDebugPanel(){return debugPanel||(debugPanel=new DebugPanel,window.__AUTOCORE_DEBUG_PANEL__=debugPanel),debugPanel}getDebugPanel();export default getDebugPanel;

package/dist/hub/HubBase.d.ts

@@ -1,181 +1,136 @@
-import { EventEmitterContextType } from '../core/EventEmitterContext';
-import { CommandMessageResult } from "./CommandMessage";
+import type { EventEmitterContextType } from '../core/EventEmitterContext';
+import type { CommandMessage } from "./CommandMessage";
+import { MessageType } from "./CommandMessage";
 /**
- * Base class for the interface for the IPC to the backend,
- * which may be websockets, MQTT, the Tauri API,
- * or something else.
+ * @class HubBase
+ * @abstract
  *
- * The EventEmitterContext should generate the hub automatically.
+ * Abstract base class that defines the interface for communicating with the AutoCore backend.
+ * Implementations (like `HubWebSocket` or `HubTauri`) handle the specific transport mechanics.
  *
- * # Usage
- * The hub can be used to publish and subscribe to
- * topics in the front-end, regardless of being connected to any backend.
+ * ## Core Responsibilities
  *
- * ```
- * const {dispatch, subscribe, unsubscribe} = useContext(EventEmitterContext);
- * const [controlPower, setControlPower] = useState(false);
- * useEffect(() => {
- *      const unsubscribeControlPower = subscribe('value-simulator-bBit1', (value) => {
- *          setControlPower(value);
- *      });
- *
- *
- *      return () => {
- *           unsubscribe(unsubscribeControlPower);
- *      }
- * }, [] );
- *
- * const onPbPressed = () => {
- *      let count = 1;
- *      dispatch({
- *          topic: "my-awesome-topic",
- *          payload: count
- *      });
- * }
- *
- * ```
- * The hub should also be used for invoking events in the backend.
- * This example will call the function "update_count" in the backend, passing
- * the expected argument "count". Details of the interaction between the Hub and
- * the backend will be handled by the appropriate HubBase sub-class, and should
- * be transparent to the front end.
- *
- * ```
- * const {invoke} = useContext(EventEmitterContext);
- * const incrementCount = () => {
- *    count += 1;
- *    invoke('update_count', {"count": count});
- * };
- *
- * Subscribing to a topic is simple. The type of value received is specific
- * to the topic.
+ * 1. **Transport Abstraction**: Provides a unified API (`read`, `write`, `subscribe`) regardless of
+ *    underlying transport (WS, IPC, etc.).
+ * 2. **Topic Mapping**: Maintains a bidirectional mapping between local `tagName` (UI friendly)
+ *    and backend `FQDN` (Fully Qualified Domain Name).
+ *    - `tagName`: "motorsEnable"
+ *    - `FQDN`: "ADS.Main.bMotorsEnable"
+ * 3. **Event Dispatching**: Routes incoming messages from the backend to the `EventEmitterContext`.
  *
- * Example: Listen to an event 'xarm-position':
- * ```
- * const {subscribe, unsubscribe} = useContext(EventEmitterContext);
- * useEffect(() => {
- *         const unsubscripeMp = subscribe('xarm-position', (value) => {
- *            // The publisher sent a JSON object of 3D position values.
- *            setX(value.x);
- *            setY(value.y);
- *            setZ(value.z);
- *            setA(value.roll);
- *            setB(value.yaw);
- *            setC(value.pitch);
- *        });
- *
- *    return () => {
- *        unsubscribe(unsubscripeMp);
- *    }
+ * ## Usage
  *
- * }, [] );
+ * The `Hub` is typically accessed via the `EventEmitterContext`:
  *
+ * ```typescript
+ * const { hub } = useContext(EventEmitterContext);
+ * await hub.write("ADS.Main.nSpeed", 500);
  * ```
- *
  */
 export declare abstract class HubBase {
+    /** Maps local tag names to backend FQDNs. */
     protected localTopicToBackendTopicMap: Map<string, string>;
+    /** Maps backend FQDNs to local tag names. */
     protected backendTopicToLocalMap: Map<string, string>;
-    protected localFNameToBackendFNameMap: Map<string, string>;
-    protected backendFNameToLocalFNameMap: Map<string, string>;
+    /** Reference to the global event emitter for dispatching incoming messages. */
     protected context: EventEmitterContextType | null;
+    /** Connection state tracker. */
     protected isConnected_: boolean;
     /**
      * Constructor
      */
     constructor();
     /**
-     * Set the EventEmitterContext for this instance of the Hub. The EventEmitterContext
-     * should handle this as part of the initialization sequence. Because React can
-     * sometimes make (and destroy) multiple copies of the EventEmitterContext, it's important
-     * that the context be stored in the instance this way so that the HubBase can properly target
-     * right context.
+     * Links this Hub instance with the React application's Event Context.
      *
-     * If this context is not sent, no events will be emitted from the backend to the front end,
-     * and global events in the interface may not work.
+     * This connection allows the Hub to "push" messages into the React app by calling `context.dispatch()`.
+     * This is called automatically by `EventEmitterProvider` on initialization.
      *
+     * @param context The React context instance.
      */
     setContext(context: EventEmitterContextType | null): void;
     /**
-     * Invoke/send a message to the back end.
-     * This does NOT get published to the front end.
+     * Sends a raw command message to the backend.
+     *
+     * @param topic The resource identifier (FQDN).
+     * @param messageType The operation to perform (Read, Write, etc.).
+     * @param payload The data payload.
+     * @returns A Promise that resolves with the server's response.
      */
-    abstract invoke(domain: string, fname: string, payload?: object): Promise<CommandMessageResult>;
+    abstract invoke(topic: string, messageType: MessageType, payload?: object): Promise<CommandMessage>;
     /**
-     * Allos the derived class to set whether the hub is connected to its source.
-     * @param s boolean
+     * Request the current value of a resource.
+     *
+     * @param topic FQDN of the resource.
      */
-    protected setIsConnected: (s: boolean) => void;
+    read(topic: string, payload?: object): Promise<CommandMessage>;
     /**
-     * Returns true if the Hub is connected to its source.
+     * Write a new value to a resource.
+     *
+     * @param topic FQDN of the resource.
+     * @param value The value to write.
      */
-    isConnected: () => boolean;
+    write(topic: string, value: any): Promise<CommandMessage>;
     /**
-     * Convenience function to invoke a command with an optional topic and optional value.
-     * This will invoke the specified command in the backend. It does not broadcast the
-     * value within the local frontend.
-     * @param domain string The domain of the command that will be invoked.
-     * @param fname string Function name
-     * @param topic string Topic
-     * @param value any data payload
+     * Subscribe to updates for a specific resource.
+     *
+     * Registers a mapping so that when the server sends updates for `topic` (FQDN),
+     * the Hub will translate it to `tagName` before dispatching to the UI.
+     *
+     * @param tagName The local alias for this resource (e.g., "position").
+     * @param topic The backend FQDN (e.g., "ADS.Main.fPos").
+     * @param payload Optional subscription parameters (rate, deadband).
      */
-    invokeTopic(domain: string, fname: string, topic: string | null, value?: any): Promise<CommandMessageResult>;
+    subscribe(tagName: string, topic: string, payload?: object): Promise<CommandMessage>;
     /**
-     * Pubish a topic throughout the web app using the
-     * Global EventEmitterContext. This will broadcast within the local frontend.
-     * This does NOT get relayed to the backend.
+     * Unsubscribe from updates.
+     *
+     * Uses the `tagName` to look up the FQDN and send the unsubscribe command.
+     * Also removes the local mapping.
+     *
+     * @param tagName The local alias to unsubscribe.
      */
-    publish(topic: string, data: any | undefined): void;
+    unsubscribe(/* topic: string,*/ tagName: string, payload?: object): Promise<CommandMessage>;
     /**
-     * Map a local topic to a topic in the backend.
-     * @param localTopic string
-     * @param backendTopic string
+     * Send a generic request (custom command).
      */
-    mapTopic(localTopic: string, backendTopic: string): void;
+    request(topic: string, payload?: object): Promise<CommandMessage>;
     /**
-     * Unmap a local topic.
-     * @param localTopic string
+     * Update internal connection state.
      */
-    unmapTopic(localTopic: string): void;
+    protected setIsConnected: (s: boolean) => void;
     /**
-     * Map a local function name, as would be sent to the invoke method, to a
-     * function name in the backend.
-     * @param localFName string
-     * @param backendFName string
+     * Check if currently connected to backend.
      */
-    mapFName(localFName: string, backendFName: string): void;
+    isConnected: () => boolean;
     /**
-     * Unmap a local function name.
-     * @param localFName string
+     * Dispatches an event to the React application.
+     *
+     * 1. Translates the `topic` (potentially an FQDN) to a local `tagName` if a mapping exists.
+     * 2. Calls `context.dispatch()` to notify local subscribers.
+     *
+     * This is the bridge between the backend transport and the frontend UI components.
+     *
+     * @param topic The topic from the message (usually FQDN).
+     * @param data The data payload.
      */
-    unmapFName(localFName: string): void;
+    publish(topic: string, data: any | undefined): void;
     /**
-     * Convert a local topic to a backend topic. If a mapping isn't
-     * registered, the local topic is returned.
-     * @param localTopic local topic name
-     * @returns string
+     * Registers a mapping between a local name and a backend FQDN.
      */
-    toBackendTopic(localTopic: string): string;
+    mapTopic(localTopic: string, backendTopic: string): void;
     /**
-     * Convert a local function name to a backend function name. If a mapping isn't
-     * registered, the local FName is returned.
-     * @param localTopic local function name
-     * @returns string
+     * Removes a mapping.
      */
-    toBackendFName(localFName: string): string;
+    unmapTopic(localTopic: string): void;
     /**
-     * Convert a backend topic to a local topic. If a mapping isn't
-     * registered, the backend topic is returned.
-     * @param backendTopic backend topic name
-     * @returns string
+     * Translates Local Name -> Backend FQDN.
      */
-    toLocalTopic(backendTopic: string): string;
+    toBackendTopic(localTopic: string): string;
     /**
-     * Convert a backend function name to a local function name. If a mapping isn't
-     * registered, the backend function name is returned.
-     * @param backendTopic backend function name
-     * @returns string
+     * Translates Backend FQDN -> Local Name.
      */
-    toLocalFName(backendTopic: string): string;
+    toLocalTopic(backendTopic: string): string;
 }
 export default HubBase;
+//# sourceMappingURL=HubBase.d.ts.map

package/dist/hub/HubBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HubBase.d.ts","sourceRoot":"","sources":["../../src/hub/HubBase.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,8BAAsB,OAAO;IAEzB,6CAA6C;IAC7C,SAAS,CAAC,2BAA2B,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAA6B;IAEvF,6CAA6C;IAC7C,SAAS,CAAC,sBAAsB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAA6B;IAElF,+EAA+E;IAC/E,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAQ;IAEzD,gCAAgC;IAChC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAS;IAGxC;;OAEG;;IAKH;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAQlD;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMnG;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI9D;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC;IAIzD;;;;;;;;;OASG;IACH,SAAS,CAAC,OAAO,EAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAKrF;;;;;;;OAOG;IACH,WAAW,CAAE,mBAAmB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAM7F;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQjE;;OAEG;IACH,SAAS,CAAC,cAAc,GAAI,GAAG,OAAO,UAErC;IAED;;OAEG;IACH,WAAW,QAAO,OAAO,CAExB;IAMD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAcnD;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAKxD;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAWpC;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAK1C;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;CAI7C;AAGD,eAAe,OAAO,CAAC"}

package/dist/hub/HubBase.js

@@ -1 +1 @@
-export class HubBase{constructor(){Object.defineProperty(this,"localTopicToBackendTopicMap",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"backendTopicToLocalMap",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"localFNameToBackendFNameMap",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"backendFNameToLocalFNameMap",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"context",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"isConnected_",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"setIsConnected",{enumerable:!0,configurable:!0,writable:!0,value:e=>{this.isConnected_=e}}),Object.defineProperty(this,"isConnected",{enumerable:!0,configurable:!0,writable:!0,value:()=>this.isConnected_})}setContext(e){this.context=e}invokeTopic(e,a,o,c){const t={topic:o,data:c};return this.invoke(e,a,t)}publish(e,a){const o=this.toLocalTopic(e);this.context?.dispatch({topic:o,payload:a})}mapTopic(e,a){this.localTopicToBackendTopicMap.set(e,a),this.backendTopicToLocalMap.set(a,e)}unmapTopic(e){if(this.localTopicToBackendTopicMap.has(e)){const a=this.localTopicToBackendTopicMap.get(e);this.localTopicToBackendTopicMap.delete(e),null!=a&&this.backendTopicToLocalMap.has(a)&&this.backendTopicToLocalMap.delete(a)}}mapFName(e,a){this.localFNameToBackendFNameMap.set(e,a),this.backendFNameToLocalFNameMap.set(a,e)}unmapFName(e){if(this.localFNameToBackendFNameMap.has(e)){const a=this.localFNameToBackendFNameMap.get(e);this.localFNameToBackendFNameMap.delete(e),null!=a&&this.backendFNameToLocalFNameMap.has(a)&&this.backendFNameToLocalFNameMap.delete(a)}}toBackendTopic(e){if(this.localTopicToBackendTopicMap.has(e)){const a=this.localTopicToBackendTopicMap.get(e);return null!=a?a:e}return e}toBackendFName(e){if(this.localFNameToBackendFNameMap.has(e)){const a=this.localFNameToBackendFNameMap.get(e);return null!=a?a:e}return e}toLocalTopic(e){if(this.backendTopicToLocalMap.has(e)){const a=this.backendTopicToLocalMap.get(e);return null!=a?a:e}return e}toLocalFName(e){if(this.backendFNameToLocalFNameMap.has(e)){const a=this.backendFNameToLocalFNameMap.get(e);return null!=a?a:e}return e}}export default HubBase;
+import{MessageType}from"./CommandMessage";export class HubBase{constructor(){Object.defineProperty(this,"localTopicToBackendTopicMap",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"backendTopicToLocalMap",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"context",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"isConnected_",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"setIsConnected",{enumerable:!0,configurable:!0,writable:!0,value:e=>{this.isConnected_=e}}),Object.defineProperty(this,"isConnected",{enumerable:!0,configurable:!0,writable:!0,value:()=>this.isConnected_})}setContext(e){this.context=e}read(e,t){return this.invoke(e,MessageType.Read,t)}write(e,t){return this.invoke(e,MessageType.Write,{value:t})}subscribe(e,t,i){return this.mapTopic(e,t),this.invoke(t,MessageType.Subscribe,i)}unsubscribe(e,t){const i=this.toBackendTopic(e);return this.unmapTopic(e),this.invoke(i,MessageType.Unsubscribe,t)}request(e,t){return this.invoke(e,MessageType.Request,t)}publish(e,t){const i=this.toLocalTopic(e);this.context?.dispatch({topic:i,payload:t})}mapTopic(e,t){this.localTopicToBackendTopicMap.set(e,t),this.backendTopicToLocalMap.set(t,e)}unmapTopic(e){if(this.localTopicToBackendTopicMap.has(e)){const t=this.localTopicToBackendTopicMap.get(e);this.localTopicToBackendTopicMap.delete(e),null!=t&&this.backendTopicToLocalMap.has(t)&&this.backendTopicToLocalMap.delete(t)}}toBackendTopic(e){return this.localTopicToBackendTopicMap.get(e)??e}toLocalTopic(e){return this.backendTopicToLocalMap.get(e)??e}}export default HubBase;

package/dist/hub/HubSimulate.d.ts

@@ -1,21 +1,55 @@
 import { HubBase } from './HubBase';
-import { CommandMessageResult } from "./CommandMessage";
+import type { CommandMessage } from "./CommandMessage";
+import { MessageType } from "./CommandMessage";
 /**
- * Hub for simulating functionality when no backend is present.
+ * Hub for simulating backend functionality when no actual backend is present.
+ *
+ * Useful for development, testing, and demos without a running autocore-server.
+ * The simulator echoes back requests as successful responses after a configurable delay.
+ *
+ * ## Usage Examples
+ *
+ * ```typescript
+ * const { hub } = useContext(EventEmitterContext);
+ *
+ * // Read returns the topic as the "value"
+ * const result = await hub.read("ads.plc1.gio.bControlPowerOk");
+ * console.log(result.data); // { value: "ads.plc1.gio.bControlPowerOk" }
+ *
+ * // Write echoes back the written value
+ * await hub.write("ads.plc1.gio.nSetpoint", 100);
+ * ```
  */
 export declare class HubSimulate extends HubBase {
+    private responseDelay;
     /**
      * Constructor
+     * @param responseDelay Simulated response delay in milliseconds (default: 20ms)
      */
-    constructor();
+    constructor(responseDelay?: number);
     /**
-     * Invoke a method in the Socket.IO backend and wait for acknowledgment.
+     * Simulate sending a message to a backend.
      *
-     * @param fname method name
+     * For Read operations, returns the topic as the value.
+     * For Write operations, echoes back the payload.
+     * For all operations, returns a successful response after the configured delay.
+     *
+     * @param topic The FQDN of the resource
+     * @param messageType The action to perform
      * @param payload Optional data payload
-     * @param timeout Timeout in milliseconds after which the promise is rejected if no response is received.
-     * @returns A Promise that resolves to the response from the backend or rejects if a timeout occurs.
+     * @returns Promise<CommandMessage> A simulated successful response
+     */
+    invoke(topic: string, messageType: MessageType, payload?: object): Promise<CommandMessage>;
+    /**
+     * Simulate a broadcast from the "backend".
+     *
+     * This is useful for testing subscription handlers.
+     *
+     * @param topic The topic to broadcast on
+     * @param data The data to broadcast
+     * @param delay Optional delay before broadcasting (default: 0ms)
      */
-    invoke(domain: string, fname: string, payload?: object, timeout?: number): Promise<CommandMessageResult>;
+    simulateBroadcast(topic: string, data: any, delay?: number): void;
 }
 export default HubSimulate;
+//# sourceMappingURL=HubSimulate.d.ts.map

package/dist/hub/HubSimulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HubSimulate.d.ts","sourceRoot":"","sources":["../../src/hub/HubSimulate.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAY,SAAQ,OAAO;IAEpC,OAAO,CAAC,aAAa,CAAS;IAE9B;;;OAGG;gBACS,aAAa,GAAE,MAAW;IAMtC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAgD1F;;;;;;;;OAQG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI;CAKvE;AAED,eAAe,WAAW,CAAC"}

package/dist/hub/HubSimulate.js

@@ -1 +1 @@
-import{HubBase}from"./HubBase";export class HubSimulate extends HubBase{constructor(){super()}invoke(e,s,r,t=20){return new Promise(((e,s)=>{setTimeout((()=>{e({data:r,error_message:"",success:!0})}),t)}))}}export default HubSimulate;
+import{HubBase}from"./HubBase";import{MessageType}from"./CommandMessage";export class HubSimulate extends HubBase{constructor(e=20){super(),Object.defineProperty(this,"responseDelay",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),this.responseDelay=e,this.setIsConnected(!0)}invoke(e,s,a){return new Promise(t=>{setTimeout(()=>{let r;switch(s){case MessageType.Read:r={value:e,simulated:!0};break;case MessageType.Write:r={written:!0,...a};break;case MessageType.Subscribe:r={subscribed:!0,topic:e};break;case MessageType.Unsubscribe:r={unsubscribed:!0,topic:e};break;default:r=a??{}}const i={transaction_id:0,timecode:Date.now(),topic:e,message_type:MessageType.Response,data:r,success:!0,error_message:""};t(i)},this.responseDelay)})}simulateBroadcast(e,s,a=0){setTimeout(()=>{this.publish(e,s)},a)}}export default HubSimulate;

package/dist/hub/HubTauri.d.ts

@@ -1,75 +1,35 @@
 import { HubBase } from './HubBase';
-import { CommandMessageResult } from "./CommandMessage";
+import type { CommandMessage } from "./CommandMessage";
+import { MessageType } from "./CommandMessage";
 /**
  * Hub for integrating with the Tauri backend.
  *
- * The tauri backend is expected to broadcast messages on the event
+ * The Tauri backend is expected to broadcast messages on the event
  * name: 'autocore://broadcast_event'
  *
  * This hub will capture those messages and dispatch them globally to any
  * listeners in the web app.
  *
+ * ## Usage Examples
  *
- * Example: Listen to an event 'xarm-position':
- * ```
- * const {subscribe, unsubscribe} = useContext(EventEmitterContext);
- * useEffect(() => {
- *         const unsubscripeMp = subscribe('xarm-position', (value) => {
- *            // The rust backend sent a JSON object of 3D position values.
- *            setX(value.x);
- *            setY(value.y);
- *            setZ(value.z);
- *            setA(value.roll);
- *            setB(value.yaw);
- *            setC(value.pitch);
- *        });
- *
- *    return () => {
- *        unsubscribe(unsubscripeMp);
- *    }
+ * ```typescript
+ * const { hub } = useContext(EventEmitterContext);
  *
- * }, [] );
+ * // Read a value
+ * const result = await hub.read("ads.plc1.gio.bControlPowerOk");
  *
- * ```
+ * // Write a value
+ * await hub.write("ads.plc1.gio.nSetpoint", 100);
  *
- * The hub should also be used for invoking events in the Tauri backend.
- * This example will call the function "update_count" in the rust backend, passing
- * the expected argument "count".
- * ```
- * const {invoke} = useContext(EventEmitterContext);
- * const incrementCount = () => {
- *    count += 1;
- *    invoke('update_count', {"count": count});
- * };
+ * // Subscribe to changes
+ * await hub.subscribe("modbus.holding_registers.5");
  * ```
  *
- * Of course, like any class derived from HubBase, the hub can be used to publish and subscribe to
- * topics in the front-end, without need of interacting with the Tauri backed.
+ * The hub can also publish/subscribe to frontend-only events:
  *
+ * ```typescript
+ * hub.publish("ui/panel-opened", { panelId: "settings" });
  * ```
- * const {dispatch, subscribe, unsubscribe} = useContext(EventEmitterContext);
- * const [controlPower, setControlPower] = useState(false);
- * useEffect(() => {
- *      const unsubscribeControlPower = subscribe('value-simulator-bBit1', (value) => {
- *          setControlPower(value);
- *      });
- *
- *
- *      return () => {
- *           unsubscribe(unsubscribeControlPower);
- *      }
- * }, [] );
- *
- * const onPbPressed = () => {
- *      let count = 1;
- *      dispatch({
- *          topic: "my-awesome-topic",
- *          payload: count
- *      });
- * }
- *
- * ```
- *
  */
 export declare class HubTauri extends HubBase {
     /**
@@ -77,11 +37,16 @@ export declare class HubTauri extends HubBase {
      */
     constructor();
     /**
-     * Invoke a method in the rust backend.
+     * Send a message to the Tauri backend.
+     *
+     * The topic and messageType are passed to a generic Tauri command handler
+     * that routes the request appropriately.
      *
-     * @param fname method name
-     * @param payload Optional data payload
-     * @returns The return value of the backend method.
+     * @param topic The FQDN of the resource (e.g., "ads.plc1.gio.bControlPowerOk")
+     * @param messageType The action to perform (Read, Write, Subscribe, etc.)
+     * @param payload Optional data payload (e.g., value to write)
+     * @returns Promise<CommandMessage> The response from the backend
      */
-    invoke(domain: string, fname: string, payload?: object | undefined): Promise<CommandMessageResult>;
+    invoke(topic: string, messageType: MessageType, payload?: object): Promise<CommandMessage>;
 }
+//# sourceMappingURL=HubTauri.d.ts.map

package/dist/hub/HubTauri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HubTauri.d.ts","sourceRoot":"","sources":["../../src/hub/HubTauri.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,QAAS,SAAQ,OAAO;IAEjC;;OAEG;;IA6BH;;;;;;;;;;OAUG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CA8C7F"}

package/dist/hub/HubTauri.js

@@ -1 +1 @@
-import{HubBase}from"./HubBase";import{event,invoke}from"@tauri-apps/api";export class HubTauri extends HubBase{constructor(){super(),event.listen("autocore://broadcast_event",(o=>{let e=JSON.parse(o.payload);void 0!==e.topic&&null!==e.topic&&(void 0!==e.payload&&null!==e.payload?this.publish(e.topic,e.payload):this.publish(e.topic,void 0))}))}invoke(o,e,i){if(null!=i){return invoke(`${o}_${e}`,i)}return invoke(e)}}
+import{HubBase}from"./HubBase";import{invoke as tauriInvoke}from"@tauri-apps/api/core";import{listen}from"@tauri-apps/api/event";import{MessageType}from"./CommandMessage";export class HubTauri extends HubBase{constructor(){super(),this.setIsConnected(!0),listen("autocore://broadcast_event",e=>{let o=JSON.parse(e.payload);void 0!==o.topic&&null!==o.topic&&(void 0!==o.payload&&null!==o.payload?this.publish(o.topic,o.payload):this.publish(o.topic,void 0))})}invoke(e,o,s){const t={topic:e,message_type:o,...s??{}};return new Promise((o,s)=>{tauriInvoke("autocore_invoke",t).then(s=>{if(s&&"object"==typeof s&&"topic"in s)o(s);else{const t={transaction_id:0,timecode:Date.now(),topic:e,message_type:MessageType.Response,data:s,success:!0,error_message:""};o(t)}}).catch(o=>{const t={transaction_id:0,timecode:Date.now(),topic:e,message_type:MessageType.Response,data:null,success:!1,error_message:o?.toString()||"Unknown error"};s(t)})})}}