@vsirotin/ts-stop 1.11.0 → 1.12.1

package/README.md

@@ -6,3 +6,14 @@ For an introduction to the concept, read the [StOP Tutorial](https://github.com/
 
 For usage and API documentation, see the Angular 17 demo in [ts/ts-example](https://github.com/vsirotin/StOP/blob/main/ts/ts-example).
 
+## License
+
+This project is dual-licensed:
+
+- **[Apache 2.0](./LICENSE)** - Free for open-source, academic, and small commercial use
+- **[Commercial License](./LICENSE-COMMERCIAL.md)** - For organizations with 10+ employees or projects with $10,000+ annual revenue
+
+**Quick Summary:**
+- ✅ Free for individuals and small teams (< 10 employees)
+- ✅ Free for non-commercial and low-revenue projects (< $10K/year)
+- 📧 Commercial licensing available - contact the author

package/lib/esm/sfsm/FaMerger.js

@@ -0,0 +1,24 @@
+import { reduceFA } from './FaReducer';
+/**
+ * Merges multiple FA definitions into one compact multi-FA object.
+ *
+ * Each input is reduced first (same semantics as reduceFA). If an input is
+ * already compact, reduceFA returns it unchanged.
+ *
+ * On duplicate FA keys, the later input overwrites the previous one and a
+ * warning entry is emitted.
+ */
+export function mergeFAs(definitions) {
+    const merged = {};
+    const warnings = [];
+    for (let fileIndex = 0; fileIndex < definitions.length; fileIndex++) {
+        const reduced = reduceFA(definitions[fileIndex]);
+        for (const [faName, transitions] of Object.entries(reduced)) {
+            if (Object.prototype.hasOwnProperty.call(merged, faName)) {
+                warnings.push(`Duplicate FA key '${faName}' encountered at input #${fileIndex + 1}. Last definition wins.`);
+            }
+            merged[faName] = transitions;
+        }
+    }
+    return { merged, warnings };
+}

package/lib/esm/sfsm/index.js

@@ -2,5 +2,6 @@ export { ExternalWorldHub } from './ExternalWorldHub';
 export { FaResolver } from './FaResolver';
 export { Sfsm } from './Sfsm';
 export { reduceFA } from './FaReducer';
+export { mergeFAs } from './FaMerger';
 export { updateCompactFA, updateFullFA } from './FaUpdater';
 export { loadFAFromFile, loadFAFromURL } from './FaLoader';

package/lib/sfsm/FaMerger.d.ts

@@ -0,0 +1,16 @@
+import { FaDefinition } from './types';
+export interface MergeFaResult {
+    merged: FaDefinition;
+    warnings: string[];
+}
+/**
+ * Merges multiple FA definitions into one compact multi-FA object.
+ *
+ * Each input is reduced first (same semantics as reduceFA). If an input is
+ * already compact, reduceFA returns it unchanged.
+ *
+ * On duplicate FA keys, the later input overwrites the previous one and a
+ * warning entry is emitted.
+ */
+export declare function mergeFAs(definitions: FaDefinition[]): MergeFaResult;
+//# sourceMappingURL=FaMerger.d.ts.map

package/lib/sfsm/FaMerger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FaMerger.d.ts","sourceRoot":"","sources":["../../src/sfsm/FaMerger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,GAAG,aAAa,CAgBnE"}

package/lib/sfsm/FaMerger.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeFAs = mergeFAs;
+const FaReducer_1 = require("./FaReducer");
+/**
+ * Merges multiple FA definitions into one compact multi-FA object.
+ *
+ * Each input is reduced first (same semantics as reduceFA). If an input is
+ * already compact, reduceFA returns it unchanged.
+ *
+ * On duplicate FA keys, the later input overwrites the previous one and a
+ * warning entry is emitted.
+ */
+function mergeFAs(definitions) {
+    const merged = {};
+    const warnings = [];
+    for (let fileIndex = 0; fileIndex < definitions.length; fileIndex++) {
+        const reduced = (0, FaReducer_1.reduceFA)(definitions[fileIndex]);
+        for (const [faName, transitions] of Object.entries(reduced)) {
+            if (Object.prototype.hasOwnProperty.call(merged, faName)) {
+                warnings.push(`Duplicate FA key '${faName}' encountered at input #${fileIndex + 1}. Last definition wins.`);
+            }
+            merged[faName] = transitions;
+        }
+    }
+    return { merged, warnings };
+}
+//# sourceMappingURL=FaMerger.js.map

package/lib/sfsm/FaMerger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FaMerger.js","sourceRoot":"","sources":["../../src/sfsm/FaMerger.ts"],"names":[],"mappings":";;AAiBA,4BAgBC;AAhCD,2CAAuC;AAOvC;;;;;;;;GAQG;AACH,SAAgB,QAAQ,CAAC,WAA2B;IAChD,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;QAClE,MAAM,OAAO,GAAG,IAAA,oBAAQ,EAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;QAEjD,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1D,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;gBACvD,QAAQ,CAAC,IAAI,CAAC,qBAAqB,MAAM,2BAA2B,SAAS,GAAG,CAAC,yBAAyB,CAAC,CAAC;YAChH,CAAC;YACD,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC;QACjC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC"}

package/lib/sfsm/index.d.ts

@@ -4,6 +4,7 @@ export { FaDefinition, FaNode, FaUpdate, Transition, SfsmOptions, LogEntry, Miss
 export { FaResolver, ResolvedFa } from './FaResolver';
 export { Sfsm } from './Sfsm';
 export { reduceFA } from './FaReducer';
+export { mergeFAs, MergeFaResult } from './FaMerger';
 export { updateCompactFA, updateFullFA } from './FaUpdater';
 export { loadFAFromFile, loadFAFromURL } from './FaLoader';
 //# sourceMappingURL=index.d.ts.map

package/lib/sfsm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sfsm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AACxI,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sfsm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AACxI,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/lib/sfsm/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadFAFromURL = exports.loadFAFromFile = exports.updateFullFA = exports.updateCompactFA = exports.reduceFA = exports.Sfsm = exports.FaResolver = exports.ExternalWorldHub = void 0;
+exports.loadFAFromURL = exports.loadFAFromFile = exports.updateFullFA = exports.updateCompactFA = exports.mergeFAs = exports.reduceFA = exports.Sfsm = exports.FaResolver = exports.ExternalWorldHub = void 0;
 var ExternalWorldHub_1 = require("./ExternalWorldHub");
 Object.defineProperty(exports, "ExternalWorldHub", { enumerable: true, get: function () { return ExternalWorldHub_1.ExternalWorldHub; } });
 var FaResolver_1 = require("./FaResolver");
@@ -9,6 +9,8 @@ var Sfsm_1 = require("./Sfsm");
 Object.defineProperty(exports, "Sfsm", { enumerable: true, get: function () { return Sfsm_1.Sfsm; } });
 var FaReducer_1 = require("./FaReducer");
 Object.defineProperty(exports, "reduceFA", { enumerable: true, get: function () { return FaReducer_1.reduceFA; } });
+var FaMerger_1 = require("./FaMerger");
+Object.defineProperty(exports, "mergeFAs", { enumerable: true, get: function () { return FaMerger_1.mergeFAs; } });
 var FaUpdater_1 = require("./FaUpdater");
 Object.defineProperty(exports, "updateCompactFA", { enumerable: true, get: function () { return FaUpdater_1.updateCompactFA; } });
 Object.defineProperty(exports, "updateFullFA", { enumerable: true, get: function () { return FaUpdater_1.updateFullFA; } });

package/lib/sfsm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sfsm/index.ts"],"names":[],"mappings":";;;AACA,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAEzB,2CAAsD;AAA7C,wGAAA,UAAU,OAAA;AACnB,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AACb,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AACjB,yCAA4D;AAAnD,4GAAA,eAAe,OAAA;AAAE,yGAAA,YAAY,OAAA;AACtC,uCAA2D;AAAlD,0GAAA,cAAc,OAAA;AAAE,yGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sfsm/index.ts"],"names":[],"mappings":";;;AACA,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAEzB,2CAAsD;AAA7C,wGAAA,UAAU,OAAA;AACnB,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AACb,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AACjB,uCAAqD;AAA5C,oGAAA,QAAQ,OAAA;AACjB,yCAA4D;AAAnD,4GAAA,eAAe,OAAA;AAAE,yGAAA,YAAY,OAAA;AACtC,uCAA2D;AAAlD,0GAAA,cAAc,OAAA;AAAE,yGAAA,aAAa,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vsirotin/ts-stop",
-  "version": "1.11.0",
+  "version": "1.12.1",
   "description": "State Oriented Programming library for TypeScript",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -34,6 +34,7 @@
     "publish:local": "./scripts/publish-local.sh",
     "pack": "npm run build && npm pack",
     "reduce-fa": "node scripts/reduce-fa.js",
+    "merge-fas": "node scripts/merge-fas.js",
     "update-full-fa": "node scripts/update-fa.js --format=full",
     "update-compact-fa": "node scripts/update-fa.js --format=compact"
   },