@real-router/fsm 0.1.0

package/README.md

@@ -0,0 +1,159 @@
+# @real-router/fsm
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg)](https://www.typescriptlang.org/)
+
+Universal synchronous FSM engine for Real-Router. Zero dependencies, full TypeScript generics, O(1) transition lookup.
+
+## Installation
+
+```bash
+npm install @real-router/fsm
+# or
+pnpm add @real-router/fsm
+# or
+yarn add @real-router/fsm
+# or
+bun add @real-router/fsm
+```
+
+## Quick Start
+
+```typescript
+import { FSM } from "@real-router/fsm";
+
+const fsm = new FSM({
+  initial: "green",
+  context: { count: 0 },
+  transitions: {
+    green:  { TIMER: "yellow" },
+    yellow: { TIMER: "red" },
+    red:    { TIMER: "green", RESET: "green" },
+  },
+});
+
+fsm.send("TIMER");     // "yellow"
+fsm.send("TIMER");     // "red"
+fsm.send("RESET");     // "green"
+fsm.getState();         // "green"
+fsm.getContext();        // { count: 0 }
+```
+
+---
+
+## API
+
+### `new FSM(config: FSMConfig<TStates, TEvents, TContext>)`
+
+Creates a new FSM instance.\
+`config.initial: TStates` — initial state\
+`config.context: TContext` — shared context object\
+`config.transitions: Record<TStates, Partial<Record<TEvents, TStates>>>` — transition table
+
+### `fsm.send(event, payload?): TStates`
+
+Sends an event to trigger a transition. Returns the current state after processing.\
+If no transition exists for the event in the current state, returns the current state (no-op).\
+State is updated before listeners fire (reentrancy-safe).
+
+```typescript
+fsm.send("TIMER");  // transitions and returns new state
+fsm.send("RESET");  // no-op if no transition defined, returns current state
+```
+
+### `fsm.getState(): TStates`
+
+Returns the current state.
+
+### `fsm.getContext(): TContext`
+
+Returns the context object (same reference as provided in config).
+
+### `fsm.onTransition(listener): () => void`
+
+Subscribes a listener to state transitions. Returns an unsubscribe function.\
+Listener receives `TransitionInfo` with `from`, `to`, `event`, and `payload` fields.\
+Not called on no-op sends (when no transition exists).
+
+```typescript
+const unsub = fsm.onTransition((info) => {
+  console.log(`${info.from} -> ${info.to} via ${info.event}`);
+});
+
+fsm.send("TIMER");  // logs: "green -> yellow via TIMER"
+unsub();
+```
+
+---
+
+## Type-Safe Payloads
+
+Use `TPayloadMap` to require payloads for specific events:
+
+```typescript
+import type { FSMConfig } from "@real-router/fsm";
+
+type State = "idle" | "loading" | "done";
+type Event = "FETCH" | "RESOLVE";
+
+interface PayloadMap {
+  FETCH: { url: string };
+}
+
+const config: FSMConfig<State, Event, null> = {
+  initial: "idle",
+  context: null,
+  transitions: {
+    idle:    { FETCH: "loading" },
+    loading: { RESOLVE: "done" },
+    done:    {},
+  },
+};
+
+const fsm = new FSM<State, Event, null, PayloadMap>(config);
+
+fsm.send("FETCH", { url: "/api" });  // OK — payload required
+fsm.send("RESOLVE");                  // OK — no payload needed
+fsm.send("FETCH");                    // TypeScript error — missing payload
+```
+
+---
+
+## Types
+
+```typescript
+import type { FSMConfig, TransitionInfo } from "@real-router/fsm";
+
+interface FSMConfig<TStates, TEvents, TContext> {
+  initial: TStates;
+  context: TContext;
+  transitions: Record<TStates, Partial<Record<TEvents, TStates>>>;
+}
+
+interface TransitionInfo<TStates, TEvents, TPayloadMap> {
+  from: TStates;
+  to: TStates;
+  event: TEvents;
+  payload: TPayloadMap[TEvents] | undefined;
+}
+```
+
+---
+
+## Design
+
+- **Synchronous** — no async, no promises, no microtasks
+- **O(1) transitions** — cached current-state lookup, single property access per `send()`
+- **Zero-alloc hot path** — when no listeners are registered, `send()` allocates nothing
+- **Null-slot listener array** — `onTransition` reuses slots from unsubscribed listeners, preventing unbounded array growth
+- **Reentrancy-safe** — `send()` inside a listener sees the updated state; callers are responsible for preventing infinite recursion
+
+---
+
+## Related Packages
+
+- [@real-router/core](https://www.npmjs.com/package/@real-router/core) — Core router
+
+## License
+
+MIT © [Oleg Ivanov](https://github.com/greydragon888)

package/dist/cjs/index.d.ts

@@ -0,0 +1,32 @@
+interface FSMConfig<TStates extends string, TEvents extends string, TContext> {
+    initial: TStates;
+    context: TContext;
+    transitions: Record<TStates, Partial<Record<TEvents, TStates>>>;
+}
+interface TransitionInfo<TStates extends string, TEvents extends string, TPayloadMap extends Partial<Record<TEvents, unknown>>> {
+    from: TStates;
+    to: TStates;
+    event: TEvents;
+    payload: TPayloadMap[TEvents] | undefined;
+}
+
+/**
+ * Synchronous finite state machine engine.
+ *
+ * Reentrancy: `send()` inside `onTransition` listener is allowed but unbounded —
+ * callers are responsible for preventing infinite loops.
+ *
+ * Exceptions: if a listener throws, the exception propagates to the caller.
+ * State is already updated before listeners fire, so `getState()` reflects the
+ * new state even if the exception escapes `send()`.
+ */
+declare class FSM<TStates extends string, TEvents extends string, TContext, TPayloadMap extends Partial<Record<TEvents, unknown>> = Record<never, never>> {
+    #private;
+    constructor(config: FSMConfig<TStates, TEvents, TContext>);
+    send<E extends TEvents>(event: E, ...args: E extends keyof TPayloadMap ? [payload: TPayloadMap[E]] : [payload?: never]): TStates;
+    getState(): TStates;
+    getContext(): TContext;
+    onTransition(listener: (info: TransitionInfo<TStates, TEvents, TPayloadMap>) => void): () => void;
+}
+
+export { FSM, type FSMConfig, type TransitionInfo };

package/dist/cjs/index.js

@@ -0,0 +1 @@
+exports.FSM=class{#t;#s;#n=0;#i;#e;#r=[];constructor(t){this.#t=t.initial,this.#i=t.context,this.#e=t.transitions,this.#s=t.transitions[t.initial]}send(t,...s){const n=this.#s[t];if(void 0===n)return this.#t;const i=this.#t;if(this.#t=n,this.#s=this.#e[n],this.#n>0){const e={from:i,to:n,event:t,payload:s[0]};for(const t of this.#r)null!==t&&t(e)}return this.#t}getState(){return this.#t}getContext(){return this.#i}onTransition(t){const s=this.#r.indexOf(null);let n;-1===s?(n=this.#r.length,this.#r.push(t)):(this.#r[s]=t,n=s),this.#n++;let i=!0;return()=>{i&&(i=!1,this.#r[n]=null,this.#n--)}}};//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fsm.ts"],"names":[],"mappings":";AAYO,IAAM,MAAN,MAKL;AAAA,EACA,MAAA;AAAA,EACA,mBAAA;AAAA,EACA,cAAA,GAAiB,CAAA;AAAA,EACR,QAAA;AAAA,EACA,YAAA;AAAA,EACA,aAIK,EAAC;AAAA,EAEf,YAAY,MAAA,EAA+C;AACzD,IAAA,IAAA,CAAK,SAAS,MAAA,CAAO,OAAA;AACrB,IAAA,IAAA,CAAK,WAAW,MAAA,CAAO,OAAA;AACvB,IAAA,IAAA,CAAK,eAAe,MAAA,CAAO,WAAA;AAC3B,IAAA,IAAA,CAAK,mBAAA,GAAsB,MAAA,CAAO,WAAA,CAAY,MAAA,CAAO,OAAO,CAAA;AAAA,EAC9D;AAAA,EAEA,IAAA,CACE,UACG,IAAA,EAGM;AACT,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,mBAAA,CAAoB,KAAK,CAAA;AAEhD,IAAA,IAAI,cAAc,MAAA,EAAW;AAC3B,MAAA,OAAO,IAAA,CAAK,MAAA;AAAA,IACd;AAEA,IAAA,MAAM,OAAO,IAAA,CAAK,MAAA;AAElB,IAAA,IAAA,CAAK,MAAA,GAAS,SAAA;AACd,IAAA,IAAA,CAAK,mBAAA,GAAsB,IAAA,CAAK,YAAA,CAAa,SAAS,CAAA;AAEtD,IAAA,IAAI,IAAA,CAAK,iBAAiB,CAAA,EAAG;AAC3B,MAAA,MAAM,IAAA,GAAsD;AAAA,QAC1D,IAAA;AAAA,QACA,EAAA,EAAI,SAAA;AAAA,QACJ,KAAA;AAAA,QACA,OAAA,EAAS,KAAK,CAAC;AAAA,OACjB;AAEA,MAAA,KAAA,MAAW,QAAA,IAAY,KAAK,UAAA,EAAY;AACtC,QAAA,IAAI,aAAa,IAAA,EAAM;AACrB,UAAA,QAAA,CAAS,IAAI,CAAA;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAEA,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA,EAEA,QAAA,GAAoB;AAClB,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA,EAEA,UAAA,GAAuB;AACrB,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,EACd;AAAA,EAEA,aACE,QAAA,EACY;AACZ,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,UAAA,CAAW,OAAA,CAAQ,IAAI,CAAA;AAC9C,IAAA,IAAI,KAAA;AAEJ,IAAA,IAAI,cAAc,EAAA,EAAI;AACpB,MAAA,KAAA,GAAQ,KAAK,UAAA,CAAW,MAAA;AACxB,MAAA,IAAA,CAAK,UAAA,CAAW,KAAK,QAAQ,CAAA;AAAA,IAC/B,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,UAAA,CAAW,SAAS,CAAA,GAAI,QAAA;AAC7B,MAAA,KAAA,GAAQ,SAAA;AAAA,IACV;AAEA,IAAA,IAAA,CAAK,cAAA,EAAA;AACL,IAAA,IAAI,UAAA,GAAa,IAAA;AAEjB,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,CAAC,UAAA,EAAY;AACf,QAAA;AAAA,MACF;AAEA,MAAA,UAAA,GAAa,KAAA;AACb,MAAA,IAAA,CAAK,UAAA,CAAW,KAAK,CAAA,GAAI,IAAA;AACzB,MAAA,IAAA,CAAK,cAAA,EAAA;AAAA,IACP,CAAA;AAAA,EACF;AACF","file":"index.js","sourcesContent":["import type { FSMConfig, TransitionInfo, TransitionListener } from \"./types\";\n\n/**\n * Synchronous finite state machine engine.\n *\n * Reentrancy: `send()` inside `onTransition` listener is allowed but unbounded —\n * callers are responsible for preventing infinite loops.\n *\n * Exceptions: if a listener throws, the exception propagates to the caller.\n * State is already updated before listeners fire, so `getState()` reflects the\n * new state even if the exception escapes `send()`.\n */\nexport class FSM<\n  TStates extends string,\n  TEvents extends string,\n  TContext,\n  TPayloadMap extends Partial<Record<TEvents, unknown>> = Record<never, never>,\n> {\n  #state: TStates;\n  #currentTransitions: Partial<Record<TEvents, TStates>>;\n  #listenerCount = 0;\n  readonly #context: TContext;\n  readonly #transitions: Record<TStates, Partial<Record<TEvents, TStates>>>;\n  readonly #listeners: (TransitionListener<\n    TStates,\n    TEvents,\n    TPayloadMap\n  > | null)[] = [];\n\n  constructor(config: FSMConfig<TStates, TEvents, TContext>) {\n    this.#state = config.initial;\n    this.#context = config.context;\n    this.#transitions = config.transitions;\n    this.#currentTransitions = config.transitions[config.initial];\n  }\n\n  send<E extends TEvents>(\n    event: E,\n    ...args: E extends keyof TPayloadMap\n      ? [payload: TPayloadMap[E]]\n      : [payload?: never]\n  ): TStates {\n    const nextState = this.#currentTransitions[event];\n\n    if (nextState === undefined) {\n      return this.#state;\n    }\n\n    const from = this.#state;\n\n    this.#state = nextState;\n    this.#currentTransitions = this.#transitions[nextState];\n\n    if (this.#listenerCount > 0) {\n      const info: TransitionInfo<TStates, TEvents, TPayloadMap> = {\n        from,\n        to: nextState,\n        event,\n        payload: args[0] as TPayloadMap[TEvents] | undefined,\n      };\n\n      for (const listener of this.#listeners) {\n        if (listener !== null) {\n          listener(info);\n        }\n      }\n    }\n\n    return this.#state;\n  }\n\n  getState(): TStates {\n    return this.#state;\n  }\n\n  getContext(): TContext {\n    return this.#context;\n  }\n\n  onTransition(\n    listener: (info: TransitionInfo<TStates, TEvents, TPayloadMap>) => void,\n  ): () => void {\n    const nullIndex = this.#listeners.indexOf(null);\n    let index: number;\n\n    if (nullIndex === -1) {\n      index = this.#listeners.length;\n      this.#listeners.push(listener);\n    } else {\n      this.#listeners[nullIndex] = listener;\n      index = nullIndex;\n    }\n\n    this.#listenerCount++;\n    let subscribed = true;\n\n    return () => {\n      if (!subscribed) {\n        return;\n      }\n\n      subscribed = false;\n      this.#listeners[index] = null;\n      this.#listenerCount--;\n    };\n  }\n}\n"]}

package/dist/cjs/metafile-cjs.json

@@ -0,0 +1 @@
+{"inputs":{"../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js":{"bytes":569,"imports":[],"format":"esm"},"src/fsm.ts":{"bytes":2731,"imports":[{"path":"/Users/olegivanov/WebstormProjects/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":88,"imports":[{"path":"src/fsm.ts","kind":"import-statement","original":"./fsm"},{"path":"/Users/olegivanov/WebstormProjects/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"}},"outputs":{"dist/cjs/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":4022},"dist/cjs/index.js":{"imports":[],"exports":["FSM"],"entryPoint":"src/index.ts","inputs":{"src/fsm.ts":{"bytesInOutput":1500},"src/index.ts":{"bytesInOutput":0}},"bytes":1532}}}

package/dist/esm/index.d.mts

@@ -0,0 +1,32 @@
+interface FSMConfig<TStates extends string, TEvents extends string, TContext> {
+    initial: TStates;
+    context: TContext;
+    transitions: Record<TStates, Partial<Record<TEvents, TStates>>>;
+}
+interface TransitionInfo<TStates extends string, TEvents extends string, TPayloadMap extends Partial<Record<TEvents, unknown>>> {
+    from: TStates;
+    to: TStates;
+    event: TEvents;
+    payload: TPayloadMap[TEvents] | undefined;
+}
+
+/**
+ * Synchronous finite state machine engine.
+ *
+ * Reentrancy: `send()` inside `onTransition` listener is allowed but unbounded —
+ * callers are responsible for preventing infinite loops.
+ *
+ * Exceptions: if a listener throws, the exception propagates to the caller.
+ * State is already updated before listeners fire, so `getState()` reflects the
+ * new state even if the exception escapes `send()`.
+ */
+declare class FSM<TStates extends string, TEvents extends string, TContext, TPayloadMap extends Partial<Record<TEvents, unknown>> = Record<never, never>> {
+    #private;
+    constructor(config: FSMConfig<TStates, TEvents, TContext>);
+    send<E extends TEvents>(event: E, ...args: E extends keyof TPayloadMap ? [payload: TPayloadMap[E]] : [payload?: never]): TStates;
+    getState(): TStates;
+    getContext(): TContext;
+    onTransition(listener: (info: TransitionInfo<TStates, TEvents, TPayloadMap>) => void): () => void;
+}
+
+export { FSM, type FSMConfig, type TransitionInfo };

package/dist/esm/index.mjs

@@ -0,0 +1 @@
+var t=class{#t;#s;#n=0;#i;#e;#r=[];constructor(t){this.#t=t.initial,this.#i=t.context,this.#e=t.transitions,this.#s=t.transitions[t.initial]}send(t,...s){const n=this.#s[t];if(void 0===n)return this.#t;const i=this.#t;if(this.#t=n,this.#s=this.#e[n],this.#n>0){const e={from:i,to:n,event:t,payload:s[0]};for(const t of this.#r)null!==t&&t(e)}return this.#t}getState(){return this.#t}getContext(){return this.#i}onTransition(t){const s=this.#r.indexOf(null);let n;-1===s?(n=this.#r.length,this.#r.push(t)):(this.#r[s]=t,n=s),this.#n++;let i=!0;return()=>{i&&(i=!1,this.#r[n]=null,this.#n--)}}};export{t as FSM};//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/fsm.ts"],"names":[],"mappings":";AAYO,IAAM,MAAN,MAKL;AAAA,EACA,MAAA;AAAA,EACA,mBAAA;AAAA,EACA,cAAA,GAAiB,CAAA;AAAA,EACR,QAAA;AAAA,EACA,YAAA;AAAA,EACA,aAIK,EAAC;AAAA,EAEf,YAAY,MAAA,EAA+C;AACzD,IAAA,IAAA,CAAK,SAAS,MAAA,CAAO,OAAA;AACrB,IAAA,IAAA,CAAK,WAAW,MAAA,CAAO,OAAA;AACvB,IAAA,IAAA,CAAK,eAAe,MAAA,CAAO,WAAA;AAC3B,IAAA,IAAA,CAAK,mBAAA,GAAsB,MAAA,CAAO,WAAA,CAAY,MAAA,CAAO,OAAO,CAAA;AAAA,EAC9D;AAAA,EAEA,IAAA,CACE,UACG,IAAA,EAGM;AACT,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,mBAAA,CAAoB,KAAK,CAAA;AAEhD,IAAA,IAAI,cAAc,MAAA,EAAW;AAC3B,MAAA,OAAO,IAAA,CAAK,MAAA;AAAA,IACd;AAEA,IAAA,MAAM,OAAO,IAAA,CAAK,MAAA;AAElB,IAAA,IAAA,CAAK,MAAA,GAAS,SAAA;AACd,IAAA,IAAA,CAAK,mBAAA,GAAsB,IAAA,CAAK,YAAA,CAAa,SAAS,CAAA;AAEtD,IAAA,IAAI,IAAA,CAAK,iBAAiB,CAAA,EAAG;AAC3B,MAAA,MAAM,IAAA,GAAsD;AAAA,QAC1D,IAAA;AAAA,QACA,EAAA,EAAI,SAAA;AAAA,QACJ,KAAA;AAAA,QACA,OAAA,EAAS,KAAK,CAAC;AAAA,OACjB;AAEA,MAAA,KAAA,MAAW,QAAA,IAAY,KAAK,UAAA,EAAY;AACtC,QAAA,IAAI,aAAa,IAAA,EAAM;AACrB,UAAA,QAAA,CAAS,IAAI,CAAA;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAEA,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA,EAEA,QAAA,GAAoB;AAClB,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA,EAEA,UAAA,GAAuB;AACrB,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,EACd;AAAA,EAEA,aACE,QAAA,EACY;AACZ,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,UAAA,CAAW,OAAA,CAAQ,IAAI,CAAA;AAC9C,IAAA,IAAI,KAAA;AAEJ,IAAA,IAAI,cAAc,EAAA,EAAI;AACpB,MAAA,KAAA,GAAQ,KAAK,UAAA,CAAW,MAAA;AACxB,MAAA,IAAA,CAAK,UAAA,CAAW,KAAK,QAAQ,CAAA;AAAA,IAC/B,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,UAAA,CAAW,SAAS,CAAA,GAAI,QAAA;AAC7B,MAAA,KAAA,GAAQ,SAAA;AAAA,IACV;AAEA,IAAA,IAAA,CAAK,cAAA,EAAA;AACL,IAAA,IAAI,UAAA,GAAa,IAAA;AAEjB,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,CAAC,UAAA,EAAY;AACf,QAAA;AAAA,MACF;AAEA,MAAA,UAAA,GAAa,KAAA;AACb,MAAA,IAAA,CAAK,UAAA,CAAW,KAAK,CAAA,GAAI,IAAA;AACzB,MAAA,IAAA,CAAK,cAAA,EAAA;AAAA,IACP,CAAA;AAAA,EACF;AACF","file":"index.mjs","sourcesContent":["import type { FSMConfig, TransitionInfo, TransitionListener } from \"./types\";\n\n/**\n * Synchronous finite state machine engine.\n *\n * Reentrancy: `send()` inside `onTransition` listener is allowed but unbounded —\n * callers are responsible for preventing infinite loops.\n *\n * Exceptions: if a listener throws, the exception propagates to the caller.\n * State is already updated before listeners fire, so `getState()` reflects the\n * new state even if the exception escapes `send()`.\n */\nexport class FSM<\n  TStates extends string,\n  TEvents extends string,\n  TContext,\n  TPayloadMap extends Partial<Record<TEvents, unknown>> = Record<never, never>,\n> {\n  #state: TStates;\n  #currentTransitions: Partial<Record<TEvents, TStates>>;\n  #listenerCount = 0;\n  readonly #context: TContext;\n  readonly #transitions: Record<TStates, Partial<Record<TEvents, TStates>>>;\n  readonly #listeners: (TransitionListener<\n    TStates,\n    TEvents,\n    TPayloadMap\n  > | null)[] = [];\n\n  constructor(config: FSMConfig<TStates, TEvents, TContext>) {\n    this.#state = config.initial;\n    this.#context = config.context;\n    this.#transitions = config.transitions;\n    this.#currentTransitions = config.transitions[config.initial];\n  }\n\n  send<E extends TEvents>(\n    event: E,\n    ...args: E extends keyof TPayloadMap\n      ? [payload: TPayloadMap[E]]\n      : [payload?: never]\n  ): TStates {\n    const nextState = this.#currentTransitions[event];\n\n    if (nextState === undefined) {\n      return this.#state;\n    }\n\n    const from = this.#state;\n\n    this.#state = nextState;\n    this.#currentTransitions = this.#transitions[nextState];\n\n    if (this.#listenerCount > 0) {\n      const info: TransitionInfo<TStates, TEvents, TPayloadMap> = {\n        from,\n        to: nextState,\n        event,\n        payload: args[0] as TPayloadMap[TEvents] | undefined,\n      };\n\n      for (const listener of this.#listeners) {\n        if (listener !== null) {\n          listener(info);\n        }\n      }\n    }\n\n    return this.#state;\n  }\n\n  getState(): TStates {\n    return this.#state;\n  }\n\n  getContext(): TContext {\n    return this.#context;\n  }\n\n  onTransition(\n    listener: (info: TransitionInfo<TStates, TEvents, TPayloadMap>) => void,\n  ): () => void {\n    const nullIndex = this.#listeners.indexOf(null);\n    let index: number;\n\n    if (nullIndex === -1) {\n      index = this.#listeners.length;\n      this.#listeners.push(listener);\n    } else {\n      this.#listeners[nullIndex] = listener;\n      index = nullIndex;\n    }\n\n    this.#listenerCount++;\n    let subscribed = true;\n\n    return () => {\n      if (!subscribed) {\n        return;\n      }\n\n      subscribed = false;\n      this.#listeners[index] = null;\n      this.#listenerCount--;\n    };\n  }\n}\n"]}

package/dist/esm/metafile-esm.json

@@ -0,0 +1 @@
+{"inputs":{"src/fsm.ts":{"bytes":2731,"imports":[],"format":"esm"},"src/index.ts":{"bytes":88,"imports":[{"path":"src/fsm.ts","kind":"import-statement","original":"./fsm"}],"format":"esm"}},"outputs":{"dist/esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":4022},"dist/esm/index.mjs":{"imports":[],"exports":["FSM"],"entryPoint":"src/index.ts","inputs":{"src/fsm.ts":{"bytesInOutput":1500},"src/index.ts":{"bytesInOutput":0}},"bytes":1532}}}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@real-router/fsm",
+  "version": "0.1.0",
+  "type": "commonjs",
+  "description": "Universal synchronous FSM engine for Real-Router",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.mjs",
+  "types": "./dist/esm/index.d.mts",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/esm/index.d.mts",
+        "require": "./dist/cjs/index.d.ts"
+      },
+      "import": "./dist/esm/index.mjs",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/greydragon888/real-router.git"
+  },
+  "keywords": [
+    "real-router",
+    "fsm",
+    "finite-state-machine",
+    "state-machine"
+  ],
+  "author": {
+    "name": "Oleg Ivanov",
+    "email": "greydragon888@gmail.com",
+    "url": "https://github.com/greydragon888"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/greydragon888/real-router/issues"
+  },
+  "homepage": "https://github.com/greydragon888/real-router",
+  "scripts": {
+    "test": "vitest",
+    "build": "tsup",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint --cache --ext .ts src/ tests/ --fix --max-warnings 0",
+    "lint:package": "publint",
+    "lint:types": "attw --pack .",
+    "bench": "NODE_OPTIONS='--expose-gc --max-old-space-size=4096' npx tsx tests/benchmarks/index.ts"
+  },
+  "sideEffects": false,
+  "devDependencies": {
+    "mitata": "1.0.34"
+  }
+}