@real-router/fsm 0.2.4 → 0.3.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/types.ts","../../src/fsm.ts"],"mappings":";UAAiB,SAAA;EAKf,OAAA,EAAS,OAAA;EACT,OAAA,EAAS,QAAA;EACT,WAAA,EAAa,MAAA,CAAO,OAAA,EAAS,OAAA,CAAQ,MAAA,CAAO,OAAA,EAAS,OAAA;AAAA;AAAA,UAGtC,cAAA,qEAGK,OAAA,CAAQ,MAAA,CAAO,OAAA;EAEnC,IAAA,EAAM,OAAA;EACN,EAAA,EAAI,OAAA;EACJ,KAAA,EAAO,OAAA;EACP,OAAA,EAAS,WAAA,CAAY,OAAA;AAAA;;;AAlBvB;;;;;;;;;;AAAA,cCYa,GAAA,+EAIS,OAAA,CAAQ,MAAA,CAAO,OAAA,cAAqB,MAAA;EAAA;cAe5C,MAAA,EAAQ,SAAA,CAAU,OAAA,EAAS,OAAA,EAAS,QAAA;EAOhD,IAAA,CAAK,KAAA,EAAO,OAAA,EAAS,OAAA,GAAU,WAAA,CAAY,OAAA,IAAW,OAAA;EAsCtD,OAAA,CAAQ,KAAA,EAAO,OAAA;EDzEf;;;;ECiFA,UAAA,CAAW,KAAA,EAAO,OAAA;EAKlB,QAAA,CAAA,GAAY,OAAA;EAIZ,UAAA,CAAA,GAAc,QAAA;EAId,EAAA,WAAa,OAAA,CAAA,CACX,IAAA,EAAM,OAAA,EACN,KAAA,EAAO,CAAA,EACP,MAAA,EAAQ,CAAA,eAAgB,WAAA,IACnB,OAAA,EAAS,WAAA,CAAY,CAAA;EAyB5B,YAAA,CACE,QAAA,GAAW,IAAA,EAAM,cAAA,CAAe,OAAA,EAAS,OAAA,EAAS,WAAA;AAAA"}

package/dist/cjs/index.js

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class{#e;#t;#n=0;#r=null;#i;#a;#o=[];constructor(e){this.#e=e.initial,this.#i=e.context,this.#a=e.transitions,this.#t=e.transitions[e.initial]}send(e,t){let n=this.#t[e];if(n===void 0)return this.#e;let r=this.#e;if(this.#e=n,this.#t=this.#a[n],this.#r!==null){let n=this.#r.get(r)?.get(e);n!==void 0&&n(t)}if(this.#n>0){let i={from:r,to:n,event:e,payload:t};for(let e of this.#o)e!==null&&e(i)}return this.#e}canSend(e){return this.#t[e]!==void 0}forceState(e){this.#e=e,this.#t=this.#a[e]}getState(){return this.#e}getContext(){return this.#i}on(e,t,n){this.#r??=new Map;let r=this.#r.get(e);return r||(r=new Map,this.#r.set(e,r)),r.set(t,n),()=>{this.#r?.get(e)?.delete(t)}}onTransition(e){let t=this.#o.indexOf(null),n;t===-1?(n=this.#o.length,this.#o.push(e)):(this.#o[t]=e,n=t),this.#n++;let r=!0;return()=>{r&&(r=!1,this.#o[n]=null,this.#n--)}}};exports.FSM=e;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class{#e;#t;#n=0;#r=null;#i;#a;#o=[];constructor(e){this.#e=e.initial,this.#i=e.context,this.#a=e.transitions,this.#t=e.transitions[e.initial]}send(e,t){let n=this.#t[e];if(n===void 0)return this.#e;let r=this.#e;if(this.#e=n,this.#t=this.#a[n],this.#r!==null){let n=this.#r.get(r)?.get(e);n!==void 0&&n(t)}if(this.#n>0){let i={from:r,to:n,event:e,payload:t};for(let e of this.#o)e!==null&&e(i)}return this.#e}canSend(e){return this.#t[e]!==void 0}forceState(e){this.#e=e,this.#t=this.#a[e]}getState(){return this.#e}getContext(){return this.#i}on(e,t,n){this.#r??=new Map;let r=this.#r.get(e);r||(r=new Map,this.#r.set(e,r));let i=n;return r.set(t,i),()=>{let n=this.#r?.get(e);n?.get(t)===i&&n.delete(t)}}onTransition(e){let t=this.#o.indexOf(null),n;t===-1?(n=this.#o.length,this.#o.push(e)):(this.#o[t]=e,n=t),this.#n++;let r=!0;return()=>{r&&(r=!1,this.#o[n]=null,this.#n--)}}};exports.FSM=e;
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["#context","#transitions","#listeners","#state","#currentTransitions","#actions","#listenerCount"],"sources":["../../src/fsm.ts"],"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  #actions: Map<TStates, Map<TEvents, (payload: unknown) => void>> | null =\n    null;\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(event: TEvents, payload?: TPayloadMap[TEvents]): 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.#actions !== null) {\n      const action = this.#actions.get(from)?.get(event);\n\n      if (action !== undefined) {\n        action(payload);\n      }\n    }\n\n    if (this.#listenerCount > 0) {\n      const info: TransitionInfo<TStates, TEvents, TPayloadMap> = {\n        from,\n        to: nextState,\n        event,\n        payload: payload,\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  canSend(event: TEvents): boolean {\n    return this.#currentTransitions[event] !== undefined;\n  }\n\n  /**\n   * Directly sets FSM state without triggering actions or listeners.\n   * Use for hot-path optimizations where the caller handles side effects.\n   */\n  forceState(state: TStates): void {\n    this.#state = state;\n    this.#currentTransitions = this.#transitions[state];\n  }\n\n  getState(): TStates {\n    return this.#state;\n  }\n\n  getContext(): TContext {\n    return this.#context;\n  }\n\n  on<E extends TEvents>(\n    from: TStates,\n    event: E,\n    action: E extends keyof TPayloadMap\n      ? (payload: TPayloadMap[E]) => void\n      : () => void,\n  ): () => void {\n    this.#actions ??= new Map();\n\n    let stateActions = this.#actions.get(from);\n\n    if (!stateActions) {\n      stateActions = new Map();\n      this.#actions.set(from, stateActions);\n    }\n\n    stateActions.set(event, action as (payload: unknown) => void);\n\n    return () => {\n      this.#actions?.get(from)?.delete(event);\n    };\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"],"mappings":"mEAYA,IAAa,EAAb,KAKE,CACA,GACA,GACA,GAAiB,EACjB,GACE,KACF,GACA,GACA,GAIc,EAAE,CAEhB,YAAY,EAA+C,CACzD,MAAA,EAAc,EAAO,QACrB,MAAA,EAAgB,EAAO,QACvB,MAAA,EAAoB,EAAO,YAC3B,MAAA,EAA2B,EAAO,YAAY,EAAO,SAGvD,KAAK,EAAgB,EAAyC,CAC5D,IAAM,EAAY,MAAA,EAAyB,GAE3C,GAAI,IAAc,IAAA,GAChB,OAAO,MAAA,EAGT,IAAM,EAAO,MAAA,EAKb,GAHA,MAAA,EAAc,EACd,MAAA,EAA2B,MAAA,EAAkB,GAEzC,MAAA,IAAkB,KAAM,CAC1B,IAAM,EAAS,MAAA,EAAc,IAAI,EAAK,EAAE,IAAI,EAAM,CAE9C,IAAW,IAAA,IACb,EAAO,EAAQ,CAInB,GAAI,MAAA,EAAsB,EAAG,CAC3B,IAAM,EAAsD,CAC1D,OACA,GAAI,EACJ,QACS,UACV,CAED,IAAK,IAAM,KAAY,MAAA,EACjB,IAAa,MACf,EAAS,EAAK,CAKpB,OAAO,MAAA,EAGT,QAAQ,EAAyB,CAC/B,OAAO,MAAA,EAAyB,KAAW,IAAA,GAO7C,WAAW,EAAsB,CAC/B,MAAA,EAAc,EACd,MAAA,EAA2B,MAAA,EAAkB,GAG/C,UAAoB,CAClB,OAAO,MAAA,EAGT,YAAuB,CACrB,OAAO,MAAA,EAGT,GACE,EACA,EACA,EAGY,CACZ,MAAA,IAAkB,IAAI,IAEtB,IAAI,EAAe,MAAA,EAAc,IAAI,EAAK,CAS1C,OAPK,IACH,EAAe,IAAI,IACnB,MAAA,EAAc,IAAI,EAAM,EAAa,EAGvC,EAAa,IAAI,EAAO,EAAqC,KAEhD,CACX,MAAA,GAAe,IAAI,EAAK,EAAE,OAAO,EAAM,EAI3C,aACE,EACY,CACZ,IAAM,EAAY,MAAA,EAAgB,QAAQ,KAAK,CAC3C,EAEA,IAAc,IAChB,EAAQ,MAAA,EAAgB,OACxB,MAAA,EAAgB,KAAK,EAAS,GAE9B,MAAA,EAAgB,GAAa,EAC7B,EAAQ,GAGV,MAAA,IACA,IAAI,EAAa,GAEjB,UAAa,CACN,IAIL,EAAa,GACb,MAAA,EAAgB,GAAS,KACzB,MAAA"}
+{"version":3,"file":"index.js","names":["#context","#transitions","#listeners","#state","#currentTransitions","#actions","#listenerCount"],"sources":["../../src/fsm.ts"],"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  #actions: Map<TStates, Map<TEvents, (payload: unknown) => void>> | null =\n    null;\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(event: TEvents, payload?: TPayloadMap[TEvents]): 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.#actions !== null) {\n      const action = this.#actions.get(from)?.get(event);\n\n      if (action !== undefined) {\n        action(payload);\n      }\n    }\n\n    if (this.#listenerCount > 0) {\n      const info: TransitionInfo<TStates, TEvents, TPayloadMap> = {\n        from,\n        to: nextState,\n        event,\n        payload: payload,\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  canSend(event: TEvents): boolean {\n    return this.#currentTransitions[event] !== undefined;\n  }\n\n  /**\n   * Directly sets FSM state without triggering actions or listeners.\n   * Use for hot-path optimizations where the caller handles side effects.\n   */\n  forceState(state: TStates): void {\n    this.#state = state;\n    this.#currentTransitions = this.#transitions[state];\n  }\n\n  getState(): TStates {\n    return this.#state;\n  }\n\n  getContext(): TContext {\n    return this.#context;\n  }\n\n  on<E extends TEvents>(\n    from: TStates,\n    event: E,\n    action: E extends keyof TPayloadMap\n      ? (payload: TPayloadMap[E]) => void\n      : () => void,\n  ): () => void {\n    this.#actions ??= new Map();\n\n    let stateActions = this.#actions.get(from);\n\n    if (!stateActions) {\n      stateActions = new Map();\n      this.#actions.set(from, stateActions);\n    }\n\n    const capturedAction = action as (payload: unknown) => void;\n\n    stateActions.set(event, capturedAction);\n\n    return () => {\n      const stateMap = this.#actions?.get(from);\n\n      if (stateMap?.get(event) === capturedAction) {\n        stateMap.delete(event);\n      }\n    };\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"],"mappings":"mEAYA,IAAa,EAAb,KAKE,CACA,GACA,GACA,GAAiB,EACjB,GACE,KACF,GACA,GACA,GAIc,EAAE,CAEhB,YAAY,EAA+C,CACzD,MAAA,EAAc,EAAO,QACrB,MAAA,EAAgB,EAAO,QACvB,MAAA,EAAoB,EAAO,YAC3B,MAAA,EAA2B,EAAO,YAAY,EAAO,SAGvD,KAAK,EAAgB,EAAyC,CAC5D,IAAM,EAAY,MAAA,EAAyB,GAE3C,GAAI,IAAc,IAAA,GAChB,OAAO,MAAA,EAGT,IAAM,EAAO,MAAA,EAKb,GAHA,MAAA,EAAc,EACd,MAAA,EAA2B,MAAA,EAAkB,GAEzC,MAAA,IAAkB,KAAM,CAC1B,IAAM,EAAS,MAAA,EAAc,IAAI,EAAK,EAAE,IAAI,EAAM,CAE9C,IAAW,IAAA,IACb,EAAO,EAAQ,CAInB,GAAI,MAAA,EAAsB,EAAG,CAC3B,IAAM,EAAsD,CAC1D,OACA,GAAI,EACJ,QACS,UACV,CAED,IAAK,IAAM,KAAY,MAAA,EACjB,IAAa,MACf,EAAS,EAAK,CAKpB,OAAO,MAAA,EAGT,QAAQ,EAAyB,CAC/B,OAAO,MAAA,EAAyB,KAAW,IAAA,GAO7C,WAAW,EAAsB,CAC/B,MAAA,EAAc,EACd,MAAA,EAA2B,MAAA,EAAkB,GAG/C,UAAoB,CAClB,OAAO,MAAA,EAGT,YAAuB,CACrB,OAAO,MAAA,EAGT,GACE,EACA,EACA,EAGY,CACZ,MAAA,IAAkB,IAAI,IAEtB,IAAI,EAAe,MAAA,EAAc,IAAI,EAAK,CAErC,IACH,EAAe,IAAI,IACnB,MAAA,EAAc,IAAI,EAAM,EAAa,EAGvC,IAAM,EAAiB,EAIvB,OAFA,EAAa,IAAI,EAAO,EAAe,KAE1B,CACX,IAAM,EAAW,MAAA,GAAe,IAAI,EAAK,CAErC,GAAU,IAAI,EAAM,GAAK,GAC3B,EAAS,OAAO,EAAM,EAK5B,aACE,EACY,CACZ,IAAM,EAAY,MAAA,EAAgB,QAAQ,KAAK,CAC3C,EAEA,IAAc,IAChB,EAAQ,MAAA,EAAgB,OACxB,MAAA,EAAgB,KAAK,EAAS,GAE9B,MAAA,EAAgB,GAAa,EAC7B,EAAQ,GAGV,MAAA,IACA,IAAI,EAAa,GAEjB,UAAa,CACN,IAIL,EAAa,GACb,MAAA,EAAgB,GAAS,KACzB,MAAA"}

package/dist/esm/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/types.ts","../../src/fsm.ts"],"mappings":";UAAiB,SAAA;EAKf,OAAA,EAAS,OAAA;EACT,OAAA,EAAS,QAAA;EACT,WAAA,EAAa,MAAA,CAAO,OAAA,EAAS,OAAA,CAAQ,MAAA,CAAO,OAAA,EAAS,OAAA;AAAA;AAAA,UAGtC,cAAA,qEAGK,OAAA,CAAQ,MAAA,CAAO,OAAA;EAEnC,IAAA,EAAM,OAAA;EACN,EAAA,EAAI,OAAA;EACJ,KAAA,EAAO,OAAA;EACP,OAAA,EAAS,WAAA,CAAY,OAAA;AAAA;;;AAlBvB;;;;;;;;;;AAAA,cCYa,GAAA,+EAIS,OAAA,CAAQ,MAAA,CAAO,OAAA,cAAqB,MAAA;EAAA;cAe5C,MAAA,EAAQ,SAAA,CAAU,OAAA,EAAS,OAAA,EAAS,QAAA;EAOhD,IAAA,CAAK,KAAA,EAAO,OAAA,EAAS,OAAA,GAAU,WAAA,CAAY,OAAA,IAAW,OAAA;EAsCtD,OAAA,CAAQ,KAAA,EAAO,OAAA;EDzEf;;;;ECiFA,UAAA,CAAW,KAAA,EAAO,OAAA;EAKlB,QAAA,CAAA,GAAY,OAAA;EAIZ,UAAA,CAAA,GAAc,QAAA;EAId,EAAA,WAAa,OAAA,CAAA,CACX,IAAA,EAAM,OAAA,EACN,KAAA,EAAO,CAAA,EACP,MAAA,EAAQ,CAAA,eAAgB,WAAA,IACnB,OAAA,EAAS,WAAA,CAAY,CAAA;EAyB5B,YAAA,CACE,QAAA,GAAW,IAAA,EAAM,cAAA,CAAe,OAAA,EAAS,OAAA,EAAS,WAAA;AAAA"}

package/dist/esm/index.mjs

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

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["#context","#transitions","#listeners","#state","#currentTransitions","#actions","#listenerCount"],"sources":["../../src/fsm.ts"],"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  #actions: Map<TStates, Map<TEvents, (payload: unknown) => void>> | null =\n    null;\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(event: TEvents, payload?: TPayloadMap[TEvents]): 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.#actions !== null) {\n      const action = this.#actions.get(from)?.get(event);\n\n      if (action !== undefined) {\n        action(payload);\n      }\n    }\n\n    if (this.#listenerCount > 0) {\n      const info: TransitionInfo<TStates, TEvents, TPayloadMap> = {\n        from,\n        to: nextState,\n        event,\n        payload: payload,\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  canSend(event: TEvents): boolean {\n    return this.#currentTransitions[event] !== undefined;\n  }\n\n  /**\n   * Directly sets FSM state without triggering actions or listeners.\n   * Use for hot-path optimizations where the caller handles side effects.\n   */\n  forceState(state: TStates): void {\n    this.#state = state;\n    this.#currentTransitions = this.#transitions[state];\n  }\n\n  getState(): TStates {\n    return this.#state;\n  }\n\n  getContext(): TContext {\n    return this.#context;\n  }\n\n  on<E extends TEvents>(\n    from: TStates,\n    event: E,\n    action: E extends keyof TPayloadMap\n      ? (payload: TPayloadMap[E]) => void\n      : () => void,\n  ): () => void {\n    this.#actions ??= new Map();\n\n    let stateActions = this.#actions.get(from);\n\n    if (!stateActions) {\n      stateActions = new Map();\n      this.#actions.set(from, stateActions);\n    }\n\n    stateActions.set(event, action as (payload: unknown) => void);\n\n    return () => {\n      this.#actions?.get(from)?.delete(event);\n    };\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"],"mappings":"AAYA,IAAa,EAAb,KAKE,CACA,GACA,GACA,GAAiB,EACjB,GACE,KACF,GACA,GACA,GAIc,EAAE,CAEhB,YAAY,EAA+C,CACzD,MAAA,EAAc,EAAO,QACrB,MAAA,EAAgB,EAAO,QACvB,MAAA,EAAoB,EAAO,YAC3B,MAAA,EAA2B,EAAO,YAAY,EAAO,SAGvD,KAAK,EAAgB,EAAyC,CAC5D,IAAM,EAAY,MAAA,EAAyB,GAE3C,GAAI,IAAc,IAAA,GAChB,OAAO,MAAA,EAGT,IAAM,EAAO,MAAA,EAKb,GAHA,MAAA,EAAc,EACd,MAAA,EAA2B,MAAA,EAAkB,GAEzC,MAAA,IAAkB,KAAM,CAC1B,IAAM,EAAS,MAAA,EAAc,IAAI,EAAK,EAAE,IAAI,EAAM,CAE9C,IAAW,IAAA,IACb,EAAO,EAAQ,CAInB,GAAI,MAAA,EAAsB,EAAG,CAC3B,IAAM,EAAsD,CAC1D,OACA,GAAI,EACJ,QACS,UACV,CAED,IAAK,IAAM,KAAY,MAAA,EACjB,IAAa,MACf,EAAS,EAAK,CAKpB,OAAO,MAAA,EAGT,QAAQ,EAAyB,CAC/B,OAAO,MAAA,EAAyB,KAAW,IAAA,GAO7C,WAAW,EAAsB,CAC/B,MAAA,EAAc,EACd,MAAA,EAA2B,MAAA,EAAkB,GAG/C,UAAoB,CAClB,OAAO,MAAA,EAGT,YAAuB,CACrB,OAAO,MAAA,EAGT,GACE,EACA,EACA,EAGY,CACZ,MAAA,IAAkB,IAAI,IAEtB,IAAI,EAAe,MAAA,EAAc,IAAI,EAAK,CAS1C,OAPK,IACH,EAAe,IAAI,IACnB,MAAA,EAAc,IAAI,EAAM,EAAa,EAGvC,EAAa,IAAI,EAAO,EAAqC,KAEhD,CACX,MAAA,GAAe,IAAI,EAAK,EAAE,OAAO,EAAM,EAI3C,aACE,EACY,CACZ,IAAM,EAAY,MAAA,EAAgB,QAAQ,KAAK,CAC3C,EAEA,IAAc,IAChB,EAAQ,MAAA,EAAgB,OACxB,MAAA,EAAgB,KAAK,EAAS,GAE9B,MAAA,EAAgB,GAAa,EAC7B,EAAQ,GAGV,MAAA,IACA,IAAI,EAAa,GAEjB,UAAa,CACN,IAIL,EAAa,GACb,MAAA,EAAgB,GAAS,KACzB,MAAA"}
+{"version":3,"file":"index.mjs","names":["#context","#transitions","#listeners","#state","#currentTransitions","#actions","#listenerCount"],"sources":["../../src/fsm.ts"],"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  #actions: Map<TStates, Map<TEvents, (payload: unknown) => void>> | null =\n    null;\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(event: TEvents, payload?: TPayloadMap[TEvents]): 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.#actions !== null) {\n      const action = this.#actions.get(from)?.get(event);\n\n      if (action !== undefined) {\n        action(payload);\n      }\n    }\n\n    if (this.#listenerCount > 0) {\n      const info: TransitionInfo<TStates, TEvents, TPayloadMap> = {\n        from,\n        to: nextState,\n        event,\n        payload: payload,\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  canSend(event: TEvents): boolean {\n    return this.#currentTransitions[event] !== undefined;\n  }\n\n  /**\n   * Directly sets FSM state without triggering actions or listeners.\n   * Use for hot-path optimizations where the caller handles side effects.\n   */\n  forceState(state: TStates): void {\n    this.#state = state;\n    this.#currentTransitions = this.#transitions[state];\n  }\n\n  getState(): TStates {\n    return this.#state;\n  }\n\n  getContext(): TContext {\n    return this.#context;\n  }\n\n  on<E extends TEvents>(\n    from: TStates,\n    event: E,\n    action: E extends keyof TPayloadMap\n      ? (payload: TPayloadMap[E]) => void\n      : () => void,\n  ): () => void {\n    this.#actions ??= new Map();\n\n    let stateActions = this.#actions.get(from);\n\n    if (!stateActions) {\n      stateActions = new Map();\n      this.#actions.set(from, stateActions);\n    }\n\n    const capturedAction = action as (payload: unknown) => void;\n\n    stateActions.set(event, capturedAction);\n\n    return () => {\n      const stateMap = this.#actions?.get(from);\n\n      if (stateMap?.get(event) === capturedAction) {\n        stateMap.delete(event);\n      }\n    };\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"],"mappings":"AAYA,IAAa,EAAb,KAKE,CACA,GACA,GACA,GAAiB,EACjB,GACE,KACF,GACA,GACA,GAIc,EAAE,CAEhB,YAAY,EAA+C,CACzD,MAAA,EAAc,EAAO,QACrB,MAAA,EAAgB,EAAO,QACvB,MAAA,EAAoB,EAAO,YAC3B,MAAA,EAA2B,EAAO,YAAY,EAAO,SAGvD,KAAK,EAAgB,EAAyC,CAC5D,IAAM,EAAY,MAAA,EAAyB,GAE3C,GAAI,IAAc,IAAA,GAChB,OAAO,MAAA,EAGT,IAAM,EAAO,MAAA,EAKb,GAHA,MAAA,EAAc,EACd,MAAA,EAA2B,MAAA,EAAkB,GAEzC,MAAA,IAAkB,KAAM,CAC1B,IAAM,EAAS,MAAA,EAAc,IAAI,EAAK,EAAE,IAAI,EAAM,CAE9C,IAAW,IAAA,IACb,EAAO,EAAQ,CAInB,GAAI,MAAA,EAAsB,EAAG,CAC3B,IAAM,EAAsD,CAC1D,OACA,GAAI,EACJ,QACS,UACV,CAED,IAAK,IAAM,KAAY,MAAA,EACjB,IAAa,MACf,EAAS,EAAK,CAKpB,OAAO,MAAA,EAGT,QAAQ,EAAyB,CAC/B,OAAO,MAAA,EAAyB,KAAW,IAAA,GAO7C,WAAW,EAAsB,CAC/B,MAAA,EAAc,EACd,MAAA,EAA2B,MAAA,EAAkB,GAG/C,UAAoB,CAClB,OAAO,MAAA,EAGT,YAAuB,CACrB,OAAO,MAAA,EAGT,GACE,EACA,EACA,EAGY,CACZ,MAAA,IAAkB,IAAI,IAEtB,IAAI,EAAe,MAAA,EAAc,IAAI,EAAK,CAErC,IACH,EAAe,IAAI,IACnB,MAAA,EAAc,IAAI,EAAM,EAAa,EAGvC,IAAM,EAAiB,EAIvB,OAFA,EAAa,IAAI,EAAO,EAAe,KAE1B,CACX,IAAM,EAAW,MAAA,GAAe,IAAI,EAAK,CAErC,GAAU,IAAI,EAAM,GAAK,GAC3B,EAAS,OAAO,EAAM,EAK5B,aACE,EACY,CACZ,IAAM,EAAY,MAAA,EAAgB,QAAQ,KAAK,CAC3C,EAEA,IAAc,IAChB,EAAQ,MAAA,EAAgB,OACxB,MAAA,EAAgB,KAAK,EAAS,GAE9B,MAAA,EAAgB,GAAa,EAC7B,EAAQ,GAGV,MAAA,IACA,IAAI,EAAa,GAEjB,UAAa,CACN,IAIL,EAAa,GACb,MAAA,EAAgB,GAAS,KACzB,MAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/fsm",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "type": "commonjs",
   "description": "Universal synchronous FSM engine for Real-Router",
   "main": "./dist/cjs/index.js",

package/src/fsm.ts

@@ -111,10 +111,16 @@ export class FSM<
       this.#actions.set(from, stateActions);
     }
 
-    stateActions.set(event, action as (payload: unknown) => void);
+    const capturedAction = action as (payload: unknown) => void;
+
+    stateActions.set(event, capturedAction);
 
     return () => {
-      this.#actions?.get(from)?.delete(event);
+      const stateMap = this.#actions?.get(from);
+
+      if (stateMap?.get(event) === capturedAction) {
+        stateMap.delete(event);
+      }
     };
   }