chartmind 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Timo Martin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights  
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell      
+copies of the Software, and to permit persons to whom the Software is         
+furnished to do so, subject to the following conditions:                       
+
+The above copyright notice and this permission notice shall be included in     
+all copies or substantial portions of the Software.                            
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR     
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,       
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE    
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER         
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,  
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN      
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,140 @@
+# 🧠 chartmind
+
+[![Code Style: Google][gts-badge-image]][gts-github-url]
+
+**chartmind** is a minimalist workflow engine that loads flowcharts from [draw.io (diagrams.net)][drawio-url] and executes the underlying classes sequentially.
+
+---
+
+## Features
+- Custom draw.io symbol library tailored for use with chartmind
+- Interpret flowcharts as executable workflows
+- Support for decisions, loops, custom and predefined actions
+- Built-in validator for flowchart development
+
+---
+
+## Getting Started
+
+### Installation
+```bash
+npm install --save chartmind
+```
+
+---
+
+### Import the Provided Symbol Library
+
+Download the [symbol library][symbol-library] provided in the project and import it into draw.io.
+
+File 🠊 Open Library... 🠊 Select the downloaded `flow-chart.xml` file
+
+---
+
+### Draw Your Flowchart
+
+Start by creating your flowchart diagram.
+
+**⚠️ Make sure to use only the symbols from the provided symbol library (including the connection symbol), as they already contain the necessary properties to be executable.**
+
+The image below shows a minimalist example:
+
+![Minimalist flowchart][docs-flow-chart]
+
+Once your diagram is complete, right-click on the process symbol `Increment counter` and choose `Edit Data...`.
+Add a key for your class in the executable field — this will be used to register your class later in the registry.
+Here’s how the configuration window looks:
+
+![Process symbol configuration window][docs-process-symbol-settings]
+
+Also, give your flowchart a name so you can reference it later for execution.
+Right-click the toolbar at the bottom of draw.io and select `Rename...`.
+This is what the rename dialog looks like:
+
+![Rename flowchart dialog][docs-rename-flowchart]
+
+Save the diagram somewhere in your project, for example under a folder called `charts`.
+
+**⚠️ Make sure to save the file with the `.drawio` extension.** 
+
+---
+
+### Run the Flowchart
+
+Now, implement your classes and register them in the registry. Then you can start the flowchart by its name. The following example demonstrates how:
+
+📄**increment-counter-task.ts**
+```ts
+import { ChartContext, Executable } from 'chartmind';
+
+export class IncrementCounter implements Executable {
+  async execute(chartContext: ChartContext): Promise<void> {
+    const counter = chartContext.getVariable('counter') as number;
+    chartContext.setVariable('counter', counter + 1);
+  }
+}
+```
+
+📄**main.ts**
+```ts
+import { ChartManager, ExecutableRegistry } from 'chartmind';
+import { IncrementCounter } from './increment-counter';
+
+const chartManager = new ChartManager()
+    .loadCharts('./charts')
+    .validateCharts(); // Optional chart validation
+
+ExecutableRegistry.instance
+    .addExecutable('increment-counter', IncrementCounter);
+
+start();
+
+async function start() {
+  try {
+      const chartName = 'Test Chart';
+      const chartContext = new Map<string, unknown>([
+          ['counter', 1]
+      ]);
+
+      await chartManager.startProcess(chartName, chartContext);
+
+      console.log(chartContext.get('counter')); // Output: 2
+  } catch(error: unknown) {
+      console.log(error);
+  }
+}
+```
+
+> 🧪 **Tip:** You can validate your charts before runtime to catch misconfigured symbols early.
+
+
+---
+
+## Symbol Properties
+
+The following table describes the available symbol properties, on which symbols these can be used, valid values, and descriptions:
+
+Name     | Symbol(s)                | Possible Values         | Description           | Required 
+---------|------------------------|-------------------------|-----------------------|:----------:
+type     | Start, End, Connection, Decision, Process, Predefined process | start, end, connection, decision, process, predefined  | Defines how the symbol will be interpreted by the engine. | Always
+condition | Connection | e.g. counter % 2 === 0 or text === 'foo' | Controls the flow from a decision symbol. Every connection must have a condition except the one marked as default. | All outgoing connections from a decision symbol must have a condition, except the one marked as default.
+default | Connection | 1 | Marks a connection as the default path. If all other conditions evaluate to false, this path is taken. Only one default should exist. | At least one outgoing connection from a decision symbol must be marked as the default.
+executable | Process | e.g. increment-counter | Key for the class registered in the registry. | Always
+name | Predefined process | e.g. Test Chart | Name of the flowchart to execute (as defined in draw.io).	 | Always
+
+All of these properties are pre-configured in the provided symbol library.
+Only the `type` field is already filled — the rest must be completed manually for each symbol.
+
+## License
+
+This project is licensed under the [MIT License][license].
+
+
+[license]: LICENSE
+[symbol-library]: flow-chart.xml
+[drawio-url]: https://draw.io
+[docs-flow-chart]: docs/images/flow-chart.png
+[docs-process-symbol-settings]: docs/images/process-symbol-settings.png
+[docs-rename-flowchart]: docs/images/rename-flow-chart.png
+[gts-badge-image]: https://img.shields.io/badge/code%20style-google-blueviolet.svg
+[gts-github-url]: https://github.com/google/gts

package/build/src/engine/actions/base-action.d.ts

@@ -0,0 +1,13 @@
+import { ChartContext } from '../chart/context/chart-context';
+import { ActionContext } from '../../interfaces/action-context.interface';
+import { ChartManager } from '../chart/manager/chart-manager';
+import { SymbolChart } from '../../types/symbol-chart.type';
+import { Chart } from '../chart/chart';
+export declare abstract class BaseAction {
+    protected symbol: SymbolChart;
+    protected chart: Chart;
+    protected chartManager: ChartManager;
+    constructor(context: ActionContext);
+    abstract execute(chartContext: ChartContext): Promise<void>;
+    abstract getNext(chartContext: ChartContext): SymbolChart | undefined;
+}

package/build/src/engine/actions/base-action.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseAction = void 0;
+class BaseAction {
+    symbol;
+    chart;
+    chartManager;
+    constructor(context) {
+        this.symbol = context.symbol;
+        this.chart = context.chart;
+        this.chartManager = context.chartManager;
+    }
+}
+exports.BaseAction = BaseAction;
+//# sourceMappingURL=base-action.js.map

package/build/src/engine/actions/base-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-action.js","sourceRoot":"","sources":["../../../../src/engine/actions/base-action.ts"],"names":[],"mappings":";;;AAMA,MAAsB,UAAU;IACpB,MAAM,CAAc;IACpB,KAAK,CAAQ;IACb,YAAY,CAAe;IAErC,YAAY,OAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;CAKF;AAdD,gCAcC"}

package/build/src/engine/actions/decision-action.d.ts

@@ -0,0 +1,10 @@
+import { SymbolChart } from '../../types/symbol-chart.type';
+import { ChartContext } from '../chart/context/chart-context';
+import { BaseAction } from './base-action';
+export declare class DecisionAction extends BaseAction {
+    execute(): Promise<void>;
+    getNext(chartContext: ChartContext): SymbolChart | undefined;
+    private getEvaluatedConnection;
+    private evaluateCondition;
+    private getDefaultConnection;
+}

package/build/src/engine/actions/decision-action.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecisionAction = void 0;
+const base_action_1 = require("./base-action");
+class DecisionAction extends base_action_1.BaseAction {
+    async execute() {
+        // console.log(`SymbolEnd ${this.symbol.label} executed.`);
+    }
+    getNext(chartContext) {
+        const connections = this.chart.getConnectionsBySourceId(this.symbol.id);
+        const evaluatedConnection = this.getEvaluatedConnection(connections, chartContext);
+        if (evaluatedConnection && evaluatedConnection.mxCell.target) {
+            return this.chart.getSymbolById(evaluatedConnection.mxCell.target);
+        }
+        const defaultConnection = this.getDefaultConnection(connections);
+        if (defaultConnection && defaultConnection.mxCell.target) {
+            return this.chart.getSymbolById(defaultConnection.mxCell.target);
+        }
+        return undefined;
+    }
+    getEvaluatedConnection(connections, chartContext) {
+        return connections.find(connection => connection.default !== '1' &&
+            this.evaluateCondition(connection.condition, chartContext));
+    }
+    evaluateCondition(condition, chartContext) {
+        chartContext.context.forEach((value, key) => (condition = condition.replaceAll(key.toString(), String(value))));
+        return eval(condition);
+    }
+    getDefaultConnection(connections) {
+        return connections.find(connections => connections.default === '1');
+    }
+}
+exports.DecisionAction = DecisionAction;
+//# sourceMappingURL=decision-action.js.map

package/build/src/engine/actions/decision-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-action.js","sourceRoot":"","sources":["../../../../src/engine/actions/decision-action.ts"],"names":[],"mappings":";;;AAGA,+CAAyC;AAEzC,MAAa,cAAe,SAAQ,wBAAU;IACrC,KAAK,CAAC,OAAO;QAClB,2DAA2D;IAC7D,CAAC;IAEM,OAAO,CAAC,YAA0B;QACvC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAExE,MAAM,mBAAmB,GAAG,IAAI,CAAC,sBAAsB,CACrD,WAAW,EACX,YAAY,CACb,CAAC;QACF,IAAI,mBAAmB,IAAI,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE;YAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;SACpE;QAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACjE,IAAI,iBAAiB,IAAI,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE;YACxD,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;SAClE;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,sBAAsB,CAC5B,WAA+B,EAC/B,YAA0B;QAE1B,OAAO,WAAW,CAAC,IAAI,CACrB,UAAU,CAAC,EAAE,CACX,UAAU,CAAC,OAAO,KAAK,GAAG;YAC1B,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,SAAS,EAAE,YAAY,CAAC,CAC7D,CAAC;IACJ,CAAC;IAEO,iBAAiB,CACvB,SAAiB,EACjB,YAA0B;QAE1B,YAAY,CAAC,OAAO,CAAC,OAAO,CAC1B,CAAC,KAAc,EAAE,GAAW,EAAE,EAAE,CAC9B,CAAC,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CACpE,CAAC;QAEF,OAAO,IAAI,CAAC,SAAS,CAAY,CAAC;IACpC,CAAC;IAEO,oBAAoB,CAC1B,WAA+B;QAE/B,OAAO,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,OAAO,KAAK,GAAG,CAAC,CAAC;IACtE,CAAC;CACF;AApDD,wCAoDC"}

package/build/src/engine/actions/end-action.d.ts

@@ -0,0 +1,6 @@
+import { SymbolChart } from '../../types/symbol-chart.type';
+import { BaseAction } from './base-action';
+export declare class EndAction extends BaseAction {
+    execute(): Promise<void>;
+    getNext(): SymbolChart | undefined;
+}

package/build/src/engine/actions/end-action.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EndAction = void 0;
+const base_action_1 = require("./base-action");
+class EndAction extends base_action_1.BaseAction {
+    async execute() {
+        // console.log(`SymbolEnd ${this.symbol.label} executed.`);
+    }
+    getNext() {
+        return undefined;
+    }
+}
+exports.EndAction = EndAction;
+//# sourceMappingURL=end-action.js.map

package/build/src/engine/actions/end-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"end-action.js","sourceRoot":"","sources":["../../../../src/engine/actions/end-action.ts"],"names":[],"mappings":";;;AACA,+CAAyC;AAEzC,MAAa,SAAU,SAAQ,wBAAU;IAChC,KAAK,CAAC,OAAO;QAClB,2DAA2D;IAC7D,CAAC;IAEM,OAAO;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AARD,8BAQC"}

package/build/src/engine/actions/predefined-process-action.d.ts

@@ -0,0 +1,7 @@
+import { SymbolChart } from '../../types/symbol-chart.type';
+import { ChartContext } from '../chart/context/chart-context';
+import { BaseAction } from './base-action';
+export declare class PredefinedProcessAction extends BaseAction {
+    execute(chartContext: ChartContext): Promise<void>;
+    getNext(): SymbolChart | undefined;
+}

package/build/src/engine/actions/predefined-process-action.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PredefinedProcessAction = void 0;
+const base_action_1 = require("./base-action");
+class PredefinedProcessAction extends base_action_1.BaseAction {
+    async execute(chartContext) {
+        const predefinedProcess = this.symbol;
+        const name = predefinedProcess.name;
+        return this.chartManager.startProcess(name, chartContext.context);
+        // console.log(`SymbolPredefinedProcess ${this.symbol.label} executed.`);
+    }
+    getNext() {
+        const connection = this.chart.getConnectionBySourceId(this.symbol.id);
+        if (!connection || !connection.mxCell.target) {
+            return undefined;
+        }
+        return this.chart.getSymbolById(connection.mxCell.target);
+    }
+}
+exports.PredefinedProcessAction = PredefinedProcessAction;
+//# sourceMappingURL=predefined-process-action.js.map

package/build/src/engine/actions/predefined-process-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predefined-process-action.js","sourceRoot":"","sources":["../../../../src/engine/actions/predefined-process-action.ts"],"names":[],"mappings":";;;AAGA,+CAAyC;AAEzC,MAAa,uBAAwB,SAAQ,wBAAU;IAC9C,KAAK,CAAC,OAAO,CAAC,YAA0B;QAC7C,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAiC,CAAC;QACjE,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;QAEpC,OAAO,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QAElE,yEAAyE;IAC3E,CAAC;IAEM,OAAO;QACZ,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEtE,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE;YAC5C,OAAO,SAAS,CAAC;SAClB;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;CACF;AAnBD,0DAmBC"}

package/build/src/engine/actions/process-action.d.ts

@@ -0,0 +1,7 @@
+import { ChartContext } from '../chart/context/chart-context';
+import { BaseAction } from './base-action';
+import { SymbolChart } from '../../types/symbol-chart.type';
+export declare class ProcessAction extends BaseAction {
+    execute(chartContext: ChartContext): Promise<void>;
+    getNext(): SymbolChart | undefined;
+}

package/build/src/engine/actions/process-action.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessAction = void 0;
+const base_action_1 = require("./base-action");
+const executable_registry_1 = require("../registry/executable-registry");
+class ProcessAction extends base_action_1.BaseAction {
+    async execute(chartContext) {
+        const processSymbol = this.symbol;
+        const executableName = processSymbol.executable;
+        const Executable = executable_registry_1.ExecutableRegistry.instance.getExecutableByName(executableName);
+        if (Executable) {
+            const instance = new Executable();
+            return instance.execute(chartContext);
+        }
+        // console.log(`SymbolProcess ${this.symbol.label} executed.`);
+    }
+    getNext() {
+        const connection = this.chart.getConnectionBySourceId(this.symbol.id);
+        if (!connection || !connection.mxCell.target) {
+            return undefined;
+        }
+        return this.chart.getSymbolById(connection.mxCell.target);
+    }
+}
+exports.ProcessAction = ProcessAction;
+//# sourceMappingURL=process-action.js.map

package/build/src/engine/actions/process-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-action.js","sourceRoot":"","sources":["../../../../src/engine/actions/process-action.ts"],"names":[],"mappings":";;;AACA,+CAAyC;AAEzC,yEAAmE;AAGnE,MAAa,aAAc,SAAQ,wBAAU;IACpC,KAAK,CAAC,OAAO,CAAC,YAA0B;QAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,MAAuB,CAAC;QACnD,MAAM,cAAc,GAAG,aAAa,CAAC,UAAU,CAAC;QAChD,MAAM,UAAU,GACd,wCAAkB,CAAC,QAAQ,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;QAElE,IAAI,UAAU,EAAE;YACd,MAAM,QAAQ,GAAG,IAAI,UAAU,EAAE,CAAC;YAClC,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;SACvC;QAED,+DAA+D;IACjE,CAAC;IAEM,OAAO;QACZ,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEtE,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE;YAC5C,OAAO,SAAS,CAAC;SAClB;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;CACF;AAxBD,sCAwBC"}

package/build/src/engine/actions/start-action.d.ts

@@ -0,0 +1,6 @@
+import { SymbolChart } from '../../types/symbol-chart.type';
+import { BaseAction } from './base-action';
+export declare class StartAction extends BaseAction {
+    execute(): Promise<void>;
+    getNext(): SymbolChart | undefined;
+}

package/build/src/engine/actions/start-action.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StartAction = void 0;
+const base_action_1 = require("./base-action");
+class StartAction extends base_action_1.BaseAction {
+    async execute() {
+        // console.log(`SymbolStart ${this.symbol.label} executed.`);
+    }
+    getNext() {
+        const connection = this.chart.getConnectionBySourceId(this.symbol.id);
+        if (!connection || !connection.mxCell.target) {
+            return undefined;
+        }
+        return this.chart.getSymbolById(connection.mxCell.target);
+    }
+}
+exports.StartAction = StartAction;
+//# sourceMappingURL=start-action.js.map

package/build/src/engine/actions/start-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-action.js","sourceRoot":"","sources":["../../../../src/engine/actions/start-action.ts"],"names":[],"mappings":";;;AACA,+CAAyC;AAEzC,MAAa,WAAY,SAAQ,wBAAU;IAClC,KAAK,CAAC,OAAO;QAClB,6DAA6D;IAC/D,CAAC;IAEM,OAAO;QACZ,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEtE,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE;YAC5C,OAAO,SAAS,CAAC;SAClB;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;CACF;AAdD,kCAcC"}

package/build/src/engine/chart/chart.d.ts

@@ -0,0 +1,15 @@
+import { SymbolConnection } from '../../interfaces/symbol-connection.interface';
+import { SymbolStart } from '../../interfaces/symbol-start.interface';
+import { SymbolChart } from '../../types/symbol-chart.type';
+export declare class Chart {
+    private _name;
+    private _symbols;
+    constructor(name: string, symbols: SymbolChart[]);
+    get name(): string;
+    get symbols(): SymbolChart[];
+    getStartSymbol(): SymbolStart | undefined;
+    getSymbolById(id: string): SymbolChart | undefined;
+    getConnectionsBySourceId(id: string): SymbolConnection[];
+    getConnectionByTargetId(id: string): SymbolConnection | undefined;
+    getConnectionBySourceId(id: string): SymbolConnection | undefined;
+}

package/build/src/engine/chart/chart.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Chart = void 0;
+class Chart {
+    _name;
+    _symbols;
+    constructor(name, symbols) {
+        this._name = name;
+        this._symbols = symbols;
+    }
+    get name() {
+        return this._name;
+    }
+    get symbols() {
+        return this._symbols;
+    }
+    getStartSymbol() {
+        return this.symbols.find(symbol => symbol.type === 'start');
+    }
+    getSymbolById(id) {
+        return this.symbols.find(symbol => symbol.id === id);
+    }
+    getConnectionsBySourceId(id) {
+        return this.symbols
+            .filter(symbol => symbol.type === 'connection')
+            .map(symbol => symbol)
+            .filter(symbol => symbol.mxCell.source === id);
+    }
+    getConnectionByTargetId(id) {
+        return this.symbols
+            .filter(symbol => symbol.type === 'connection')
+            .map(symbol => symbol)
+            .find(symbol => symbol.mxCell.target === id);
+    }
+    getConnectionBySourceId(id) {
+        return this.symbols
+            .filter(symbol => symbol.type === 'connection')
+            .map(symbol => symbol)
+            .find(symbol => symbol.mxCell.source === id);
+    }
+}
+exports.Chart = Chart;
+//# sourceMappingURL=chart.js.map

package/build/src/engine/chart/chart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart.js","sourceRoot":"","sources":["../../../../src/engine/chart/chart.ts"],"names":[],"mappings":";;;AAIA,MAAa,KAAK;IACR,KAAK,CAAS;IACd,QAAQ,CAAgB;IAEhC,YAAY,IAAY,EAAE,OAAsB;QAC9C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAEM,cAAc;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAC9D,CAAC;IAEM,aAAa,CAAC,EAAU;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;IAEM,wBAAwB,CAAC,EAAU;QACxC,OAAO,IAAI,CAAC,OAAO;aAChB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC;aAC9C,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAA0B,CAAC;aACzC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IAEM,uBAAuB,CAAC,EAAU;QACvC,OAAO,IAAI,CAAC,OAAO;aAChB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC;aAC9C,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAA0B,CAAC;aACzC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAEM,uBAAuB,CAAC,EAAU;QACvC,OAAO,IAAI,CAAC,OAAO;aAChB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC;aAC9C,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAA0B,CAAC;aACzC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;CACF;AA7CD,sBA6CC"}

package/build/src/engine/chart/context/chart-context.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Represents a context for storing and retrieving chart-related variables.
+ *
+ * The `ChartContext` class encapsulates a map-based context that allows
+ * variables to be set and retrieved by name. This is useful for managing
+ * state or configuration relevant to chart components.
+ */
+export declare class ChartContext {
+    private _context;
+    constructor(context: Map<String, unknown>);
+    /**
+     * Gets the underlying context map containing all variables.
+     *
+     * @returns The map of variable names to their corresponding values.
+     */
+    get context(): Map<String, unknown>;
+    /**
+     * Sets a variable in the context.
+     *
+     * @param name - The name of the variable to set.
+     * @param value - The value to associate with the variable name.
+     */
+    setVariable(name: string, value: unknown): void;
+    /**
+     * Retrieves the value of a variable from the context.
+     *
+     * @param name - The name of the variable to retrieve.
+     * @returns The value associated with the variable name, or `undefined` if not found.
+     */
+    getVariable(name: string): unknown;
+}

package/build/src/engine/chart/context/chart-context.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChartContext = void 0;
+/**
+ * Represents a context for storing and retrieving chart-related variables.
+ *
+ * The `ChartContext` class encapsulates a map-based context that allows
+ * variables to be set and retrieved by name. This is useful for managing
+ * state or configuration relevant to chart components.
+ */
+class ChartContext {
+    _context;
+    constructor(context) {
+        this._context = context;
+    }
+    /**
+     * Gets the underlying context map containing all variables.
+     *
+     * @returns The map of variable names to their corresponding values.
+     */
+    get context() {
+        return this._context;
+    }
+    /**
+     * Sets a variable in the context.
+     *
+     * @param name - The name of the variable to set.
+     * @param value - The value to associate with the variable name.
+     */
+    setVariable(name, value) {
+        this._context.set(name, value);
+    }
+    /**
+     * Retrieves the value of a variable from the context.
+     *
+     * @param name - The name of the variable to retrieve.
+     * @returns The value associated with the variable name, or `undefined` if not found.
+     */
+    getVariable(name) {
+        return this._context.get(name);
+    }
+}
+exports.ChartContext = ChartContext;
+//# sourceMappingURL=chart-context.js.map

package/build/src/engine/chart/context/chart-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-context.js","sourceRoot":"","sources":["../../../../../src/engine/chart/context/chart-context.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,MAAa,YAAY;IACf,QAAQ,CAAuB;IAEvC,YAAY,OAA6B;QACvC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,IAAY,EAAE,KAAc;QAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF;AAnCD,oCAmCC"}

package/build/src/engine/chart/instance/chart-instance.d.ts

@@ -0,0 +1,12 @@
+import { ChartContext } from '../context/chart-context';
+import { ChartManager } from '../manager/chart-manager';
+import { Chart } from '../chart';
+export declare class ChartInstance {
+    private readonly actions;
+    private chartContext;
+    private chart;
+    private chartManager;
+    constructor(chartContext: ChartContext, chart: Chart, chartManager: ChartManager);
+    run(): Promise<void>;
+    private executeSymbol;
+}

package/build/src/engine/chart/instance/chart-instance.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChartInstance = void 0;
+const decision_action_1 = require("../../actions/decision-action");
+const end_action_1 = require("../../actions/end-action");
+const process_action_1 = require("../../actions/process-action");
+const start_action_1 = require("../../actions/start-action");
+const predefined_process_action_1 = require("../../actions/predefined-process-action");
+class ChartInstance {
+    actions = new Map([
+        ['start', (context) => new start_action_1.StartAction(context)],
+        ['end', (context) => new end_action_1.EndAction(context)],
+        ['process', (context) => new process_action_1.ProcessAction(context)],
+        [
+            'predefined',
+            (context) => new predefined_process_action_1.PredefinedProcessAction(context),
+        ],
+        ['decision', (context) => new decision_action_1.DecisionAction(context)],
+    ]);
+    chartContext;
+    chart;
+    chartManager;
+    constructor(chartContext, chart, chartManager) {
+        this.chartContext = chartContext;
+        this.chart = chart;
+        this.chartManager = chartManager;
+    }
+    async run() {
+        let next = this.chart.getStartSymbol();
+        while (next) {
+            next = await this.executeSymbol(next);
+        }
+    }
+    async executeSymbol(next) {
+        const action = this.actions.get(next.type);
+        if (!action) {
+            throw new Error(`no action defined for symbol type ${next.type}`);
+        }
+        const actionInstance = action({
+            symbol: next,
+            chart: this.chart,
+            chartManager: this.chartManager,
+        });
+        await actionInstance.execute(this.chartContext);
+        return actionInstance.getNext(this.chartContext);
+    }
+}
+exports.ChartInstance = ChartInstance;
+//# sourceMappingURL=chart-instance.js.map

package/build/src/engine/chart/instance/chart-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-instance.js","sourceRoot":"","sources":["../../../../../src/engine/chart/instance/chart-instance.ts"],"names":[],"mappings":";;;AACA,mEAA6D;AAC7D,yDAAmD;AACnD,iEAA2D;AAC3D,6DAAuD;AAGvD,uFAAgF;AAMhF,MAAa,aAAa;IACP,OAAO,GAGpB,IAAI,GAAG,CAAqD;QAC9D,CAAC,OAAO,EAAE,CAAC,OAAsB,EAAE,EAAE,CAAC,IAAI,0BAAW,CAAC,OAAO,CAAC,CAAC;QAC/D,CAAC,KAAK,EAAE,CAAC,OAAsB,EAAE,EAAE,CAAC,IAAI,sBAAS,CAAC,OAAO,CAAC,CAAC;QAC3D,CAAC,SAAS,EAAE,CAAC,OAAsB,EAAE,EAAE,CAAC,IAAI,8BAAa,CAAC,OAAO,CAAC,CAAC;QACnE;YACE,YAAY;YACZ,CAAC,OAAsB,EAAE,EAAE,CAAC,IAAI,mDAAuB,CAAC,OAAO,CAAC;SACjE;QACD,CAAC,UAAU,EAAE,CAAC,OAAsB,EAAE,EAAE,CAAC,IAAI,gCAAc,CAAC,OAAO,CAAC,CAAC;KACtE,CAAC,CAAC;IAEK,YAAY,CAAe;IAC3B,KAAK,CAAQ;IACb,YAAY,CAAe;IAEnC,YACE,YAA0B,EAC1B,KAAY,EACZ,YAA0B;QAE1B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAEM,KAAK,CAAC,GAAG;QACd,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAEvC,OAAO,IAAI,EAAE;YACX,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;SACvC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,IAAiB;QAEjB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3C,IAAI,CAAC,MAAM,EAAE;YACX,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;SACnE;QAED,MAAM,cAAc,GAAG,MAAM,CAAC;YAC5B,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;QAEH,MAAM,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAChD,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;CACF;AAvDD,sCAuDC"}