@camcima/finita 1.0.0

package/dist/util/SetupHelper.js

@@ -0,0 +1,48 @@
+import { State } from "../State.js";
+import { Transition } from "../Transition.js";
+export class SetupHelper {
+    stateCollection;
+    constructor(stateCollection) {
+        this.stateCollection = stateCollection;
+    }
+    findOrCreateState(name) {
+        if (!this.stateCollection.hasState(name)) {
+            this.stateCollection.addState(new State(name));
+        }
+        return this.stateCollection.getState(name);
+    }
+    findTransition(sourceState, targetState, eventName = null, condition = null) {
+        const conditionName = condition ? condition.getName() : null;
+        for (const transition of sourceState.getTransitions()) {
+            const hasSameTargetState = transition.getTargetState() === targetState;
+            const hasSameCondition = transition.getConditionName() === conditionName;
+            const hasSameEvent = transition.getEventName() === eventName;
+            if (hasSameTargetState && hasSameCondition && hasSameEvent) {
+                return transition;
+            }
+        }
+        return null;
+    }
+    findOrCreateTransition(sourceStateName, targetStateName, eventName = null, condition = null) {
+        const sourceState = this.findOrCreateState(sourceStateName);
+        const targetState = this.findOrCreateState(targetStateName);
+        let transition = this.findTransition(sourceState, targetState, eventName, condition);
+        if (!transition) {
+            transition = new Transition(targetState, eventName, condition);
+            sourceState.addTransition(transition);
+        }
+        return transition;
+    }
+    findOrCreateEvent(sourceStateName, eventName) {
+        const sourceState = this.findOrCreateState(sourceStateName);
+        return sourceState.getEvent(eventName);
+    }
+    addCommand(sourceStateName, eventName, command) {
+        this.findOrCreateEvent(sourceStateName, eventName).attach(command);
+    }
+    addCommandAndSelfTransition(sourceStateName, eventName, command) {
+        this.addCommand(sourceStateName, eventName, command);
+        this.findOrCreateTransition(sourceStateName, sourceStateName, eventName);
+    }
+}
+//# sourceMappingURL=SetupHelper.js.map

package/dist/util/SetupHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SetupHelper.js","sourceRoot":"","sources":["../../src/util/SetupHelper.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,OAAO,WAAW;IACH,eAAe,CAAkB;IAEpD,YAAY,eAAgC;QAC1C,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED,iBAAiB,CAAC,IAAY;QAC5B,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAES,cAAc,CACtB,WAA2B,EAC3B,WAA2B,EAC3B,YAA2B,IAAI,EAC/B,YAAuC,IAAI;QAE3C,MAAM,aAAa,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,cAAc,EAAE,EAAE,CAAC;YACtD,MAAM,kBAAkB,GAAG,UAAU,CAAC,cAAc,EAAE,KAAK,WAAW,CAAC;YACvE,MAAM,gBAAgB,GAAG,UAAU,CAAC,gBAAgB,EAAE,KAAK,aAAa,CAAC;YACzE,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,EAAE,KAAK,SAAS,CAAC;YAC7D,IAAI,kBAAkB,IAAI,gBAAgB,IAAI,YAAY,EAAE,CAAC;gBAC3D,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sBAAsB,CACpB,eAAuB,EACvB,eAAuB,EACvB,YAA2B,IAAI,EAC/B,YAAuC,IAAI;QAE3C,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;QAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;QAC5D,IAAI,UAAU,GAAG,IAAI,CAAC,cAAc,CAClC,WAAW,EACX,WAAW,EACX,SAAS,EACT,SAAS,CACV,CAAC;QACF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,UAAU,GAAG,IAAI,UAAU,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YAC/D,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,iBAAiB,CACf,eAAuB,EACvB,SAAiB;QAEjB,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;QAC5D,OAAO,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,UAAU,CACR,eAAuB,EACvB,SAAiB,EACjB,OAAiB;QAEjB,IAAI,CAAC,iBAAiB,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;IAED,2BAA2B,CACzB,eAAuB,EACvB,SAAiB,EACjB,OAAiB;QAEjB,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACrD,IAAI,CAAC,sBAAsB,CAAC,eAAe,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/util/StateCollectionMerger.d.ts

@@ -0,0 +1,23 @@
+import type { StateCollectionInterface } from "../interfaces/StateCollectionInterface.js";
+import type { StateInterface } from "../interfaces/StateInterface.js";
+import type { TransitionInterface } from "../interfaces/TransitionInterface.js";
+import type { ConditionInterface } from "../interfaces/ConditionInterface.js";
+import { Transition } from "../Transition.js";
+import { StateCollection } from "../StateCollection.js";
+export declare class StateCollectionMerger {
+    private readonly targetCollection;
+    private stateNamePrefix;
+    constructor(targetCollection: StateCollection);
+    getStateNamePrefix(): string;
+    setStateNamePrefix(prefix: string): void;
+    getTargetCollection(): StateCollection;
+    protected createState(name: string): StateInterface;
+    protected findOrCreateState(name: string): StateInterface;
+    protected createCondition(sourceTransition: TransitionInterface): ConditionInterface | null;
+    protected createTransition(sourceTransition: TransitionInterface): Transition;
+    protected mergeMetadata(source: StateInterface, target: StateInterface): void;
+    protected mergeEvent(source: StateInterface, target: StateInterface, eventName: string): void;
+    protected mergeState(sourceState: StateInterface): void;
+    merge(source: StateCollectionInterface | StateInterface): void;
+}
+//# sourceMappingURL=StateCollectionMerger.d.ts.map

package/dist/util/StateCollectionMerger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateCollectionMerger.d.ts","sourceRoot":"","sources":["../../src/util/StateCollectionMerger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,eAAe,CAAM;gBAEjB,gBAAgB,EAAE,eAAe;IAI7C,kBAAkB,IAAI,MAAM;IAI5B,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIxC,mBAAmB,IAAI,eAAe;IAItC,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAInD,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAUzD,SAAS,CAAC,eAAe,CACvB,gBAAgB,EAAE,mBAAmB,GACpC,kBAAkB,GAAG,IAAI;IAI5B,SAAS,CAAC,gBAAgB,CACxB,gBAAgB,EAAE,mBAAmB,GACpC,UAAU;IAWb,SAAS,CAAC,aAAa,CACrB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,GACrB,IAAI;IAOP,SAAS,CAAC,UAAU,CAClB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,GAChB,IAAI;IAcP,SAAS,CAAC,UAAU,CAAC,WAAW,EAAE,cAAc,GAAG,IAAI;IAcvD,KAAK,CAAC,MAAM,EAAE,wBAAwB,GAAG,cAAc,GAAG,IAAI;CAU/D"}

package/dist/util/StateCollectionMerger.js

@@ -0,0 +1,83 @@
+import { State } from "../State.js";
+import { Transition } from "../Transition.js";
+export class StateCollectionMerger {
+    targetCollection;
+    stateNamePrefix = "";
+    constructor(targetCollection) {
+        this.targetCollection = targetCollection;
+    }
+    getStateNamePrefix() {
+        return this.stateNamePrefix;
+    }
+    setStateNamePrefix(prefix) {
+        this.stateNamePrefix = prefix;
+    }
+    getTargetCollection() {
+        return this.targetCollection;
+    }
+    createState(name) {
+        return new State(name);
+    }
+    findOrCreateState(name) {
+        const prefixedName = this.stateNamePrefix + name;
+        if (this.targetCollection.hasState(prefixedName)) {
+            return this.targetCollection.getState(prefixedName);
+        }
+        const state = this.createState(prefixedName);
+        this.targetCollection.addState(state);
+        return state;
+    }
+    createCondition(sourceTransition) {
+        return sourceTransition.getCondition();
+    }
+    createTransition(sourceTransition) {
+        const targetStateName = sourceTransition.getTargetState().getName();
+        const targetState = this.findOrCreateState(targetStateName);
+        this.mergeMetadata(sourceTransition.getTargetState(), targetState);
+        const eventName = sourceTransition.getEventName();
+        const condition = this.createCondition(sourceTransition);
+        const transition = new Transition(targetState, eventName, condition);
+        transition.setWeight(sourceTransition.getWeight());
+        return transition;
+    }
+    mergeMetadata(source, target) {
+        const metadata = source.getMetadata();
+        for (const [key, value] of Object.entries(metadata)) {
+            target.setMetadataValue(key, value);
+        }
+    }
+    mergeEvent(source, target, eventName) {
+        const sourceEvent = source.getEvent(eventName);
+        const targetEvent = target.getEvent(eventName);
+        const sourceMetadata = sourceEvent.getMetadata();
+        for (const [key, value] of Object.entries(sourceMetadata)) {
+            targetEvent.setMetadataValue(key, value);
+        }
+        for (const observer of sourceEvent.getObservers()) {
+            targetEvent.attach(observer);
+        }
+    }
+    mergeState(sourceState) {
+        const targetState = this.findOrCreateState(sourceState.getName());
+        this.mergeMetadata(sourceState, targetState);
+        for (const sourceTransition of sourceState.getTransitions()) {
+            const targetTransition = this.createTransition(sourceTransition);
+            targetState.addTransition(targetTransition);
+        }
+        for (const eventName of sourceState.getEventNames()) {
+            this.mergeEvent(sourceState, targetState, eventName);
+        }
+    }
+    merge(source) {
+        if ("getStates" in source && typeof source.getStates === "function") {
+            const collection = source;
+            for (const state of collection.getStates()) {
+                this.mergeState(state);
+            }
+        }
+        else {
+            this.mergeState(source);
+        }
+    }
+}
+//# sourceMappingURL=StateCollectionMerger.js.map

package/dist/util/StateCollectionMerger.js.map

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

package/dist/util/index.d.ts

@@ -0,0 +1,3 @@
+export { SetupHelper } from "./SetupHelper.js";
+export { StateCollectionMerger } from "./StateCollectionMerger.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/util/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/util/index.js

@@ -0,0 +1,3 @@
+export { SetupHelper } from "./SetupHelper.js";
+export { StateCollectionMerger } from "./StateCollectionMerger.js";
+//# sourceMappingURL=index.js.map

package/dist/util/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@camcima/finita",
+  "version": "1.0.0",
+  "description": "A full-featured finite state machine library for TypeScript",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage --reporter=default --reporter=junit --outputFile=test-report.junit.xml",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit && eslint src/ tests/",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "release": "release-it"
+  },
+  "keywords": [
+    "statemachine",
+    "state machine",
+    "fsm",
+    "status",
+    "process"
+  ],
+  "author": "camcima (https://github.com/camcima)",
+  "contributors": [
+    "metabor (https://github.com/metabor)"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/camcima/finita.git"
+  },
+  "homepage": "https://github.com/camcima/finita",
+  "bugs": {
+    "url": "https://github.com/camcima/finita/issues"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^10.1.0",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.8.1",
+    "release-it": "^19.2.4",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.57.2",
+    "vitest": "^3.0.0"
+  }
+}