@vscxml/mcp 0.1.0

package/dist/bridges/editor-bridge.js

@@ -0,0 +1,285 @@
+import WebSocket from 'ws';
+/**
+ * WebSocket bridge to the VSCXML-Editor API.
+ * The editor's Electron main process runs a lightweight WS server on port 48623
+ * that relays commands to/from the React renderer via IPC.
+ */
+export class EditorBridge {
+    ws = null;
+    url;
+    connected = false;
+    requestId = 0;
+    pendingRequests = new Map();
+    // Broadcast event buffers (selection/document changes from editor)
+    lastSelection = null;
+    lastDocumentChange = null;
+    constructor(url) {
+        this.url = url || `ws://localhost:${48623}`;
+    }
+    setUrl(url) {
+        this.url = url;
+    }
+    isConnected() {
+        return this.connected;
+    }
+    /** Connect to the editor WebSocket API */
+    async connect() {
+        if (this.connected)
+            return;
+        return new Promise((resolve, reject) => {
+            try {
+                this.ws = new WebSocket(this.url);
+                const timeout = setTimeout(() => {
+                    reject(new Error(`Connection timeout to editor at ${this.url}`));
+                    this.ws?.close();
+                }, 3000);
+                this.ws.on('open', () => {
+                    clearTimeout(timeout);
+                    this.connected = true;
+                    resolve();
+                });
+                this.ws.on('message', (data) => {
+                    this.handleMessage(data.toString());
+                });
+                this.ws.on('close', () => {
+                    this.connected = false;
+                    this.ws = null;
+                    for (const [, req] of this.pendingRequests) {
+                        clearTimeout(req.timer);
+                        req.reject(new Error('Connection closed'));
+                    }
+                    this.pendingRequests.clear();
+                });
+                this.ws.on('error', (err) => {
+                    clearTimeout(timeout);
+                    if (!this.connected) {
+                        reject(err);
+                    }
+                });
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+    /** Disconnect */
+    disconnect() {
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.connected = false;
+    }
+    /** Check if editor is reachable */
+    async isAvailable() {
+        if (this.connected)
+            return true;
+        try {
+            await this.connect();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Push SCXML content to the editor */
+    async pushScxml(scxml) {
+        const resp = await this.sendRequest('push_scxml', { scxml });
+        return { success: resp.type !== 'error' };
+    }
+    /** Get current SCXML from the editor */
+    async getScxml() {
+        const resp = await this.sendRequest('get_scxml');
+        return {
+            scxml: resp.scxml || '',
+            modified: resp.modified || false,
+        };
+    }
+    /** Show a toast notification in the editor */
+    async showNotification(message, severity = 'info', duration = 5000) {
+        await this.sendRequest('notify', { message, severity, duration });
+    }
+    /** Highlight specific states in the editor */
+    async highlight(states, options) {
+        await this.sendRequest('highlight', {
+            states,
+            color: options?.color,
+            duration: options?.duration,
+            clear: options?.clear,
+        });
+    }
+    /** Add a note to the editor canvas */
+    async addNote(content, options) {
+        const resp = await this.sendRequest('add_note', {
+            content,
+            attachedTo: options?.attachedTo,
+            color: options?.color,
+            visibleWhen: options?.visibleWhen,
+        });
+        return { noteId: resp.noteId || '' };
+    }
+    /** Remove notes from the editor */
+    async removeNotes(noteIds) {
+        await this.sendRequest('remove_notes', { noteIds });
+    }
+    /** Navigate the editor canvas */
+    async navigate(options) {
+        await this.sendRequest('navigate', options);
+    }
+    /** Save content to a file path */
+    async saveFile(filePath, content) {
+        const resp = await this.sendRequest('save_file', { filePath, content });
+        return { success: resp.type !== 'error', filePath: resp.filePath || filePath };
+    }
+    /** Load a file from disk into the editor */
+    async loadFile(filePath) {
+        const resp = await this.sendRequest('load_file', { filePath });
+        return {
+            content: resp.content || '',
+            filePath: resp.filePath || filePath,
+        };
+    }
+    /** Get the current file path from the editor */
+    async getFilePath() {
+        const resp = await this.sendRequest('get_file_path');
+        return { filePath: resp.filePath || null };
+    }
+    /** Capture a screenshot of the editor window */
+    async screenshot() {
+        const resp = await this.sendRequest('screenshot', {}, 10000);
+        return {
+            data: resp.data || '',
+            format: resp.format || 'png',
+            width: resp.width || 0,
+            height: resp.height || 0,
+        };
+    }
+    /** Connect the editor's simulator panel to the simulator backend */
+    async connectSimulator(port) {
+        const resp = await this.sendRequest('connect_simulator', { port: port || 48621 });
+        return { success: resp.type !== 'error' };
+    }
+    /** Get the current selection in the editor */
+    async getSelection() {
+        const resp = await this.sendRequest('get_selection');
+        return {
+            highlightedStates: resp.highlightedStates || [],
+            cursorPosition: resp.cursorPosition,
+        };
+    }
+    /** Get the editor viewport state */
+    async getViewport() {
+        const resp = await this.sendRequest('get_viewport');
+        return {
+            transform: resp.transform || { x: 0, y: 0, scale: 1 },
+            viewportWidth: resp.viewportWidth || 0,
+            viewportHeight: resp.viewportHeight || 0,
+            visibleArea: resp.visibleArea || { left: 0, top: 0, right: 0, bottom: 0 },
+        };
+    }
+    /** Export the full diagram as SVG text */
+    async exportSvg() {
+        const resp = await this.sendRequest('export_svg', {}, 15000);
+        return { svg: resp.svg || '' };
+    }
+    /** Export the full diagram as PNG (base64) */
+    async exportPng() {
+        const resp = await this.sendRequest('export_png', {}, 15000);
+        return {
+            data: resp.data || '',
+            width: resp.width || 0,
+            height: resp.height || 0,
+        };
+    }
+    /** Export interactive Player HTML */
+    async exportPlayerHtml(options) {
+        const resp = await this.sendRequest('export_player_html', {
+            exportMode: options?.exportMode,
+            selectedTraceIds: options?.selectedTraceIds,
+        }, 30000);
+        return { html: resp.html || '' };
+    }
+    /** Get editor status */
+    async getStatus() {
+        if (!this.connected) {
+            return { connected: false, hasDocument: false, documentName: null };
+        }
+        try {
+            const resp = await this.sendRequest('status');
+            return {
+                connected: true,
+                hasDocument: resp.hasDocument || false,
+                documentName: resp.documentName || null,
+            };
+        }
+        catch {
+            return { connected: false, hasDocument: false, documentName: null };
+        }
+    }
+    handleMessage(data) {
+        let msg;
+        try {
+            msg = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        // Process request-response matches
+        const requestId = msg.requestId;
+        if (requestId && this.pendingRequests.has(requestId)) {
+            const pending = this.pendingRequests.get(requestId);
+            this.pendingRequests.delete(requestId);
+            clearTimeout(pending.timer);
+            if (msg.type === 'error') {
+                pending.reject(new Error(msg.message || 'Editor error'));
+            }
+            else {
+                pending.resolve(msg);
+            }
+            return;
+        }
+        // Buffer broadcast events (no requestId — editor push notifications)
+        const type = msg.type;
+        switch (type) {
+            case 'selection_changed':
+                this.lastSelection = {
+                    selectedStates: msg.selectedStates || [],
+                    selectedTransitions: msg.selectedTransitions || [],
+                    timestamp: msg.timestamp || Date.now(),
+                };
+                break;
+            case 'document_changed':
+                this.lastDocumentChange = {
+                    stateCount: msg.stateCount || 0,
+                    transitionCount: msg.transitionCount || 0,
+                    timestamp: msg.timestamp || Date.now(),
+                };
+                break;
+        }
+    }
+    /** Get the latest buffered selection event */
+    getLastSelection() {
+        return this.lastSelection;
+    }
+    /** Get the latest buffered document change event */
+    getLastDocumentChange() {
+        return this.lastDocumentChange;
+    }
+    sendRequest(action, params = {}, timeoutMs = 5000) {
+        return new Promise((resolve, reject) => {
+            if (!this.ws || !this.connected) {
+                reject(new Error('Not connected to editor'));
+                return;
+            }
+            const reqId = `req_${++this.requestId}`;
+            const message = JSON.stringify({ action, requestId: reqId, ...params });
+            const timer = setTimeout(() => {
+                this.pendingRequests.delete(reqId);
+                reject(new Error(`Editor request '${action}' timed out`));
+            }, timeoutMs);
+            this.pendingRequests.set(reqId, { resolve, reject, timer });
+            this.ws.send(message);
+        });
+    }
+}
+//# sourceMappingURL=editor-bridge.js.map

package/dist/bridges/editor-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-bridge.js","sourceRoot":"","sources":["../../src/bridges/editor-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACf,EAAE,GAAqB,IAAI,CAAC;IAC5B,GAAG,CAAS;IACZ,SAAS,GAAG,KAAK,CAAC;IAClB,SAAS,GAAG,CAAC,CAAC;IACd,eAAe,GAAG,IAAI,GAAG,EAO9B,CAAC;IAEJ,mEAAmE;IAC3D,aAAa,GAIV,IAAI,CAAC;IAER,kBAAkB,GAIf,IAAI,CAAC;IAEhB,YAAY,GAAY;QACtB,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI,kBAAkB,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAE3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC;gBACH,IAAI,CAAC,EAAE,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAElC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC9B,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;oBACjE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;gBACnB,CAAC,EAAE,IAAI,CAAC,CAAC;gBAET,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;oBACtB,YAAY,CAAC,OAAO,CAAC,CAAC;oBACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;oBACtB,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;gBAEH,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;oBAC7B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACtC,CAAC,CAAC,CAAC;gBAEH,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;oBACvB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;oBACvB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;oBACf,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;wBAC3C,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;wBACxB,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;oBAC7C,CAAC;oBACD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;gBAC/B,CAAC,CAAC,CAAC;gBAEH,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;oBAC1B,YAAY,CAAC,OAAO,CAAC,CAAC;oBACtB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;wBACpB,MAAM,CAAC,GAAG,CAAC,CAAC;oBACd,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB;IACjB,UAAU;QACR,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,WAAW;QACf,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QACjD,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAe,IAAI,EAAE;YACjC,QAAQ,EAAE,IAAI,CAAC,QAAmB,IAAI,KAAK;SAC5C,CAAC;IACJ,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,gBAAgB,CACpB,OAAe,EACf,WAAqD,MAAM,EAC3D,QAAQ,GAAG,IAAI;QAEf,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,SAAS,CACb,MAAgB,EAChB,OAAgE;QAEhE,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE;YAClC,MAAM;YACN,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,KAAK,EAAE,OAAO,EAAE,KAAK;SACtB,CAAC,CAAC;IACL,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,OAAO,CACX,OAAe,EACf,OAIC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE;YAC9C,OAAO;YACP,UAAU,EAAE,OAAO,EAAE,UAAU;YAC/B,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,WAAW,EAAE,OAAO,EAAE,WAAW;SAClC,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAgB,IAAI,EAAE,EAAE,CAAC;IACjD,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,WAAW,CAAC,OAAkB;QAClC,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,QAAQ,CAAC,OAKd;QACC,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,OAAe;QAC9C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACxE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAkB,IAAI,QAAQ,EAAE,CAAC;IAC3F,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/D,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAiB,IAAI,EAAE;YACrC,QAAQ,EAAE,IAAI,CAAC,QAAkB,IAAI,QAAQ;SAC9C,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;QACrD,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAkB,IAAI,IAAI,EAAE,CAAC;IACvD,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAc,IAAI,EAAE;YAC/B,MAAM,EAAE,IAAI,CAAC,MAAgB,IAAI,KAAK;YACtC,KAAK,EAAE,IAAI,CAAC,KAAe,IAAI,CAAC;YAChC,MAAM,EAAE,IAAI,CAAC,MAAgB,IAAI,CAAC;SACnC,CAAC;IACJ,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,gBAAgB,CAAC,IAAa;QAClC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QAClF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,YAAY;QAIhB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;QACrD,OAAO;YACL,iBAAiB,EAAE,IAAI,CAAC,iBAA6B,IAAI,EAAE;YAC3D,cAAc,EAAE,IAAI,CAAC,cAAyD;SAC/E,CAAC;IACJ,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,WAAW;QAMf,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QACpD,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAoD,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;YAChG,aAAa,EAAE,IAAI,CAAC,aAAuB,IAAI,CAAC;YAChD,cAAc,EAAE,IAAI,CAAC,cAAwB,IAAI,CAAC;YAClD,WAAW,EAAE,IAAI,CAAC,WAA2E,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;SAC1I,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7D,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAa,IAAI,EAAE,EAAE,CAAC;IAC3C,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAc,IAAI,EAAE;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAe,IAAI,CAAC;YAChC,MAAM,EAAE,IAAI,CAAC,MAAgB,IAAI,CAAC;SACnC,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,gBAAgB,CAAC,OAGtB;QACC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,oBAAoB,EAAE;YACxD,UAAU,EAAE,OAAO,EAAE,UAAU;YAC/B,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;SAC5C,EAAE,KAAK,CAAC,CAAC;QACV,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAc,IAAI,EAAE,EAAE,CAAC;IAC7C,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,SAAS;QAKb,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QACtE,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC9C,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAsB,IAAI,KAAK;gBACjD,YAAY,EAAE,IAAI,CAAC,YAAsB,IAAI,IAAI;aAClD,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QACtE,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,IAAY;QAChC,IAAI,GAA4B,CAAC;QACjC,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,mCAAmC;QACnC,MAAM,SAAS,GAAG,GAAG,CAAC,SAAmB,CAAC;QAC1C,IAAI,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACrD,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;YACrD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACvC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAE5B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACzB,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAE,GAAG,CAAC,OAAkB,IAAI,cAAc,CAAC,CAAC,CAAC;YACvE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACvB,CAAC;YACD,OAAO;QACT,CAAC;QAED,qEAAqE;QACrE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAc,CAAC;QAChC,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,mBAAmB;gBACtB,IAAI,CAAC,aAAa,GAAG;oBACnB,cAAc,EAAE,GAAG,CAAC,cAA0B,IAAI,EAAE;oBACpD,mBAAmB,EAAE,GAAG,CAAC,mBAA+B,IAAI,EAAE;oBAC9D,SAAS,EAAE,GAAG,CAAC,SAAmB,IAAI,IAAI,CAAC,GAAG,EAAE;iBACjD,CAAC;gBACF,MAAM;YACR,KAAK,kBAAkB;gBACrB,IAAI,CAAC,kBAAkB,GAAG;oBACxB,UAAU,EAAE,GAAG,CAAC,UAAoB,IAAI,CAAC;oBACzC,eAAe,EAAE,GAAG,CAAC,eAAyB,IAAI,CAAC;oBACnD,SAAS,EAAE,GAAG,CAAC,SAAmB,IAAI,IAAI,CAAC,GAAG,EAAE;iBACjD,CAAC;gBACF,MAAM;QACV,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,oDAAoD;IACpD,qBAAqB;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAEO,WAAW,CACjB,MAAc,EACd,SAAkC,EAAE,EACpC,SAAS,GAAG,IAAI;QAEhB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;gBAC7C,OAAO;YACT,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;YAExE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACnC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,MAAM,aAAa,CAAC,CAAC,CAAC;YAC5D,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/bridges/generator-bridge.d.ts

@@ -0,0 +1,72 @@
+import type { ValidationResult, InspectResult, GenerateResult, GenerateOptions, TargetInfo } from '../types.js';
+/**
+ * HTTP bridge to the VSCXML-Generator-CLI REST API.
+ * Communicates with the generator server for validation, inspection,
+ * and code generation.
+ */
+export declare class GeneratorBridge {
+    private baseUrl;
+    constructor(baseUrl?: string);
+    /** Update the base URL (e.g., after auto-discovery) */
+    setBaseUrl(url: string): void;
+    /** Check if the generator server is reachable */
+    isAvailable(): Promise<boolean>;
+    /** GET /api/health */
+    health(): Promise<{
+        status: string;
+        version: string;
+    }>;
+    /** POST /api/validate */
+    validate(scxml: string): Promise<ValidationResult>;
+    /** POST /api/inspect */
+    inspect(scxml: string): Promise<InspectResult>;
+    /** POST /api/generate - returns generated files as text (extracts from ZIP) */
+    generate(scxml: string, target: string, options?: GenerateOptions): Promise<GenerateResult>;
+    /** POST /api/create - build SCXML from structured spec */
+    create(spec: {
+        name?: string;
+        datamodel?: string;
+        binding?: string;
+        states?: Array<{
+            id: string;
+            type?: string;
+            parent?: string | null;
+            initial?: string | null;
+            onEntry?: string | null;
+            onExit?: string | null;
+            data?: Array<{
+                id: string;
+                expr?: string;
+                type?: string;
+            }>;
+        }>;
+        transitions?: Array<{
+            source: string;
+            target?: string | null;
+            event?: string | null;
+            cond?: string | null;
+            type?: string | null;
+            actions?: string | null;
+        }>;
+        data?: Array<{
+            id: string;
+            expr?: string;
+            type?: string;
+        }>;
+    }): Promise<{
+        scxml: string;
+    }>;
+    /** Generate a full project (codeOnly=false) and return files */
+    generateProject(scxml: string, target: string, options?: GenerateOptions): Promise<GenerateResult>;
+    /** GET /api/targets */
+    listTargets(): Promise<TargetInfo[]>;
+    /** GET /api/schema/{target} */
+    getTargetSchema(target: string): Promise<Record<string, unknown>>;
+    private fetch;
+    /**
+     * Extract files from a ZIP buffer.
+     * Reads the central directory (handles data descriptors where local header
+     * has 0-size fields). Uses Node zlib for deflate decompression.
+     */
+    private extractZip;
+}

package/dist/bridges/generator-bridge.js

@@ -0,0 +1,190 @@
+import { inflateRawSync } from 'zlib';
+/**
+ * HTTP bridge to the VSCXML-Generator-CLI REST API.
+ * Communicates with the generator server for validation, inspection,
+ * and code generation.
+ */
+export class GeneratorBridge {
+    baseUrl;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl || `http://localhost:${48620}`;
+    }
+    /** Update the base URL (e.g., after auto-discovery) */
+    setBaseUrl(url) {
+        this.baseUrl = url;
+    }
+    /** Check if the generator server is reachable */
+    async isAvailable() {
+        try {
+            const res = await fetch(`${this.baseUrl}/api/health`, {
+                signal: AbortSignal.timeout(3000),
+            });
+            return res.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** GET /api/health */
+    async health() {
+        const res = await this.fetch('/api/health');
+        return res.json();
+    }
+    /** POST /api/validate */
+    async validate(scxml) {
+        const res = await this.fetch('/api/validate', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ scxml }),
+        });
+        return res.json();
+    }
+    /** POST /api/inspect */
+    async inspect(scxml) {
+        const res = await this.fetch('/api/inspect', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ scxml }),
+        });
+        return res.json();
+    }
+    /** POST /api/generate - returns generated files as text (extracts from ZIP) */
+    async generate(scxml, target, options) {
+        const config = { scxml, target };
+        if (options) {
+            config.options = options;
+        }
+        const res = await this.fetch('/api/generate', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(config),
+        });
+        // Response is a ZIP file — extract file contents
+        const zipBuffer = await res.arrayBuffer();
+        const files = await this.extractZip(new Uint8Array(zipBuffer));
+        return { files, target, config };
+    }
+    /** POST /api/create - build SCXML from structured spec */
+    async create(spec) {
+        const res = await this.fetch('/api/create', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(spec),
+        });
+        return res.json();
+    }
+    /** Generate a full project (codeOnly=false) and return files */
+    async generateProject(scxml, target, options) {
+        return this.generate(scxml, target, { ...options, codeOnly: false });
+    }
+    /** GET /api/targets */
+    async listTargets() {
+        const res = await this.fetch('/api/targets');
+        const data = await res.json();
+        return data.targets;
+    }
+    /** GET /api/schema/{target} */
+    async getTargetSchema(target) {
+        const res = await this.fetch(`/api/schema/${encodeURIComponent(target)}`);
+        return res.json();
+    }
+    async fetch(path, init) {
+        const url = `${this.baseUrl}${path}`;
+        const res = await fetch(url, {
+            ...init,
+            signal: init?.signal || AbortSignal.timeout(30000),
+        });
+        if (!res.ok) {
+            let errorMsg;
+            try {
+                const errorJson = await res.json();
+                errorMsg = errorJson.error || res.statusText;
+            }
+            catch {
+                errorMsg = res.statusText;
+            }
+            throw new Error(`Generator API error (${res.status}): ${errorMsg}`);
+        }
+        return res;
+    }
+    /**
+     * Extract files from a ZIP buffer.
+     * Reads the central directory (handles data descriptors where local header
+     * has 0-size fields). Uses Node zlib for deflate decompression.
+     */
+    async extractZip(data) {
+        const files = [];
+        const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+        // Find End of Central Directory record (scan backwards)
+        let eocdOffset = -1;
+        for (let i = data.length - 22; i >= 0; i--) {
+            if (view.getUint32(i, true) === 0x06054b50) {
+                eocdOffset = i;
+                break;
+            }
+        }
+        if (eocdOffset === -1)
+            return files;
+        const cdOffset = view.getUint32(eocdOffset + 16, true);
+        const cdEntries = view.getUint16(eocdOffset + 10, true);
+        // Walk central directory entries
+        let cdPos = cdOffset;
+        for (let i = 0; i < cdEntries; i++) {
+            if (view.getUint32(cdPos, true) !== 0x02014b50)
+                break;
+            const compression = view.getUint16(cdPos + 10, true);
+            const compSize = view.getUint32(cdPos + 20, true);
+            const uncompSize = view.getUint32(cdPos + 24, true);
+            const nameLen = view.getUint16(cdPos + 28, true);
+            const extraLen = view.getUint16(cdPos + 30, true);
+            const commentLen = view.getUint16(cdPos + 32, true);
+            const localHeaderOffset = view.getUint32(cdPos + 42, true);
+            const fileName = new TextDecoder().decode(data.slice(cdPos + 46, cdPos + 46 + nameLen));
+            // Find data start in local header
+            const localNameLen = view.getUint16(localHeaderOffset + 26, true);
+            const localExtraLen = view.getUint16(localHeaderOffset + 28, true);
+            const dataStart = localHeaderOffset + 30 + localNameLen + localExtraLen;
+            if (uncompSize > 0 && !fileName.endsWith('/')) {
+                let content = null;
+                if (compression === 0) {
+                    content = new TextDecoder().decode(data.slice(dataStart, dataStart + uncompSize));
+                }
+                else if (compression === 8) {
+                    try {
+                        const compressed = data.slice(dataStart, dataStart + compSize);
+                        const decompressed = inflateRawSync(Buffer.from(compressed));
+                        content = new TextDecoder().decode(decompressed);
+                    }
+                    catch {
+                        // Skip entries that fail to decompress
+                    }
+                }
+                if (content !== null) {
+                    const ext = fileName.split('.').pop() || '';
+                    files.push({ path: fileName, content, language: extToLanguage(ext) });
+                }
+            }
+            cdPos += 46 + nameLen + extraLen + commentLen;
+        }
+        return files;
+    }
+}
+function extToLanguage(ext) {
+    const map = {
+        java: 'java',
+        js: 'javascript',
+        mjs: 'javascript',
+        cs: 'csharp',
+        c: 'c',
+        h: 'c',
+        py: 'python',
+        go: 'go',
+        st: 'structured-text',
+        json: 'json',
+        xml: 'xml',
+        gradle: 'groovy',
+        kts: 'kotlin',
+    };
+    return map[ext] || ext;
+}
+//# sourceMappingURL=generator-bridge.js.map

package/dist/bridges/generator-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-bridge.js","sourceRoot":"","sources":["../../src/bridges/generator-bridge.ts"],"names":[],"mappings":"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"}

package/dist/bridges/simulator-bridge.d.ts

@@ -0,0 +1,89 @@
+import type { TraceEntry, TraceInfo, TracePlaybackStatus, SimulationState } from '../types.js';
+/**
+ * WebSocket bridge to the VSCXML-Simulator.
+ * Uses response-type matching (the server does not echo commandId).
+ * Buffers broadcast events (state_update, transition_fired, etc.) into a trace.
+ */
+export declare class SimulatorBridge {
+    private ws;
+    private url;
+    private pendingResolve;
+    private traceBuffer;
+    private sessionId;
+    private connected;
+    private reconnectTimer;
+    private activeStates;
+    private variables;
+    private enabledEvents;
+    private finished;
+    private mode;
+    constructor(url?: string);
+    setUrl(url: string): void;
+    isConnected(): boolean;
+    getSessionId(): string | null;
+    /** Connect to the simulator WebSocket */
+    connect(): Promise<void>;
+    disconnect(): void;
+    isAvailable(): Promise<boolean>;
+    /** Load SCXML and return session info */
+    loadScxml(scxml: string): Promise<SimulationState>;
+    /** Start the state machine */
+    start(): Promise<SimulationState>;
+    /** Send an event and return trace + state */
+    sendEvent(eventName: string, eventData?: unknown): Promise<{
+        trace: TraceEntry[];
+        state: SimulationState;
+    }>;
+    /** Get current state without sending an event */
+    getState(): Promise<SimulationState & {
+        history: TraceEntry[];
+    }>;
+    /** Reset the simulation */
+    reset(): Promise<SimulationState>;
+    /** Get current SCXML content */
+    getScxml(): Promise<string>;
+    /** List embedded traces in the current SCXML document */
+    listTraces(): Promise<TraceInfo[]>;
+    /** Save/embed a trace into the SCXML document */
+    saveTrace(name: string, options?: {
+        description?: string;
+        content?: string;
+    }): Promise<{
+        entryCount: number;
+        scxml: string;
+    }>;
+    /** Delete an embedded trace by name */
+    deleteTrace(name: string): Promise<{
+        scxml: string;
+    }>;
+    /** Load an embedded trace by name (returns parsed entries) */
+    loadTrace(name: string): Promise<{
+        entries: Record<string, unknown>[];
+        entryCount: number;
+        description?: string;
+    }>;
+    /** Start playing an embedded trace by name */
+    playTrace(name: string, speed?: number): Promise<{
+        entryCount: number;
+    }>;
+    /** Step forward/backward in trace playback */
+    stepTrace(delta: number): Promise<{
+        index: number;
+        total: number;
+        entry?: Record<string, unknown>;
+    }>;
+    /** Pause trace playback */
+    pauseTrace(): Promise<{
+        index: number;
+        total: number;
+    }>;
+    /** Get trace playback status */
+    getTraceStatus(): Promise<TracePlaybackStatus>;
+    /** Set a variable value during simulation */
+    setVariable(name: string, value: unknown): Promise<void>;
+    private getCurrentState;
+    private drainTrace;
+    private waitForSettle;
+    private handleMessage;
+    private sendCommand;
+}