@real-router/fsm 0.2.2 → 0.2.3

package/README.md

@@ -6,7 +6,7 @@
 
 ## Purpose
 
-Drives the router's lifecycle state machine (`STOPPED → STARTED → DISPOSED`). Synchronous, zero-dependency, O(1) transition lookup.
+Drives the router's lifecycle state machine (`IDLE → STARTING → READY → TRANSITION_STARTED → LEAVE_APPROVED → READY | DISPOSED`). Synchronous, zero-dependency, O(1) transition lookup.
 
 ## Consumer
 

package/dist/cjs/index.d.ts

@@ -1,15 +1,17 @@
+//#region src/types.d.ts
 interface FSMConfig<TStates extends string, TEvents extends string, TContext> {
-    initial: TStates;
-    context: TContext;
-    transitions: Record<TStates, Partial<Record<TEvents, TStates>>>;
+  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;
+  from: TStates;
+  to: TStates;
+  event: TEvents;
+  payload: TPayloadMap[TEvents] | undefined;
 }
-
+//#endregion
+//#region src/fsm.d.ts
 /**
  * Synchronous finite state machine engine.
  *
@@ -21,19 +23,20 @@ interface TransitionInfo<TStates extends string, TEvents extends string, TPayloa
  * 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(event: TEvents, payload?: TPayloadMap[TEvents]): TStates;
-    canSend(event: TEvents): boolean;
-    /**
-     * Directly sets FSM state without triggering actions or listeners.
-     * Use for hot-path optimizations where the caller handles side effects.
-     */
-    forceState(state: TStates): void;
-    getState(): TStates;
-    getContext(): TContext;
-    on<E extends TEvents>(from: TStates, event: E, action: E extends keyof TPayloadMap ? (payload: TPayloadMap[E]) => void : () => void): () => void;
-    onTransition(listener: (info: TransitionInfo<TStates, TEvents, TPayloadMap>) => void): () => void;
+  #private;
+  constructor(config: FSMConfig<TStates, TEvents, TContext>);
+  send(event: TEvents, payload?: TPayloadMap[TEvents]): TStates;
+  canSend(event: TEvents): boolean;
+  /**
+   * Directly sets FSM state without triggering actions or listeners.
+   * Use for hot-path optimizations where the caller handles side effects.
+   */
+  forceState(state: TStates): void;
+  getState(): TStates;
+  getContext(): TContext;
+  on<E extends TEvents>(from: TStates, event: E, action: E extends keyof TPayloadMap ? (payload: TPayloadMap[E]) => void : () => void): () => void;
+  onTransition(listener: (info: TransitionInfo<TStates, TEvents, TPayloadMap>) => void): () => void;
 }
-
+//#endregion
 export { FSM, type FSMConfig, type TransitionInfo };
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.js

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

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/fsm.ts"],"names":[],"mappings":"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","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  #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"]}
+{"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"}

package/dist/esm/index.d.mts

@@ -1,15 +1,17 @@
+//#region src/types.d.ts
 interface FSMConfig<TStates extends string, TEvents extends string, TContext> {
-    initial: TStates;
-    context: TContext;
-    transitions: Record<TStates, Partial<Record<TEvents, TStates>>>;
+  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;
+  from: TStates;
+  to: TStates;
+  event: TEvents;
+  payload: TPayloadMap[TEvents] | undefined;
 }
-
+//#endregion
+//#region src/fsm.d.ts
 /**
  * Synchronous finite state machine engine.
  *
@@ -21,19 +23,20 @@ interface TransitionInfo<TStates extends string, TEvents extends string, TPayloa
  * 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(event: TEvents, payload?: TPayloadMap[TEvents]): TStates;
-    canSend(event: TEvents): boolean;
-    /**
-     * Directly sets FSM state without triggering actions or listeners.
-     * Use for hot-path optimizations where the caller handles side effects.
-     */
-    forceState(state: TStates): void;
-    getState(): TStates;
-    getContext(): TContext;
-    on<E extends TEvents>(from: TStates, event: E, action: E extends keyof TPayloadMap ? (payload: TPayloadMap[E]) => void : () => void): () => void;
-    onTransition(listener: (info: TransitionInfo<TStates, TEvents, TPayloadMap>) => void): () => void;
+  #private;
+  constructor(config: FSMConfig<TStates, TEvents, TContext>);
+  send(event: TEvents, payload?: TPayloadMap[TEvents]): TStates;
+  canSend(event: TEvents): boolean;
+  /**
+   * Directly sets FSM state without triggering actions or listeners.
+   * Use for hot-path optimizations where the caller handles side effects.
+   */
+  forceState(state: TStates): void;
+  getState(): TStates;
+  getContext(): TContext;
+  on<E extends TEvents>(from: TStates, event: E, action: E extends keyof TPayloadMap ? (payload: TPayloadMap[E]) => void : () => void): () => void;
+  onTransition(listener: (info: TransitionInfo<TStates, TEvents, TPayloadMap>) => void): () => void;
 }
-
+//#endregion
 export { FSM, type FSMConfig, type TransitionInfo };
+//# sourceMappingURL=index.d.mts.map

package/dist/esm/index.mjs

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

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/fsm.ts"],"names":[],"mappings":"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","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  #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"]}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/fsm",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "type": "commonjs",
   "description": "Universal synchronous FSM engine for Real-Router",
   "main": "./dist/cjs/index.js",
@@ -18,8 +18,7 @@
     }
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "repository": {
     "type": "git",
@@ -45,11 +44,12 @@
   "scripts": {
     "test": "vitest",
     "test:properties": "vitest --config vitest.config.properties.mts --run",
-    "build": "tsup",
+    "build": "tsdown --config-loader unrun",
     "type-check": "tsc --noEmit",
     "lint": "eslint --cache --ext .ts src/ tests/ --fix --max-warnings 0",
-    "lint:package": "publint",
+    "lint:package": "bash ../../scripts/publint-filter.sh",
     "lint:types": "attw --pack .",
-    "bench": "NODE_OPTIONS='--expose-gc --max-old-space-size=4096' npx tsx tests/benchmarks/index.ts"
+    "bench": "NODE_OPTIONS='--expose-gc --max-old-space-size=4096' npx tsx tests/benchmarks/index.ts",
+    "build:dist-only": "tsdown --config-loader unrun"
   }
 }

package/dist/cjs/metafile-cjs.json

@@ -1 +0,0 @@
-{"inputs":{"../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js":{"bytes":569,"imports":[],"format":"esm"},"src/fsm.ts":{"bytes":3754,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/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":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"}},"outputs":{"dist/cjs/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":5670},"dist/cjs/index.js":{"imports":[],"exports":["FSM"],"entryPoint":"src/index.ts","inputs":{"src/fsm.ts":{"bytesInOutput":2378},"src/index.ts":{"bytesInOutput":0}},"bytes":2410}}}

package/dist/esm/metafile-esm.json

@@ -1 +0,0 @@
-{"inputs":{"src/fsm.ts":{"bytes":3754,"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":5670},"dist/esm/index.mjs":{"imports":[],"exports":["FSM"],"entryPoint":"src/index.ts","inputs":{"src/fsm.ts":{"bytesInOutput":2378},"src/index.ts":{"bytesInOutput":0}},"bytes":2410}}}

package/src/fsm.ts

@@ -1,148 +0,0 @@
-import type { FSMConfig, TransitionInfo, TransitionListener } from "./types";
-
-/**
- * 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()`.
- */
-export class FSM<
-  TStates extends string,
-  TEvents extends string,
-  TContext,
-  TPayloadMap extends Partial<Record<TEvents, unknown>> = Record<never, never>,
-> {
-  #state: TStates;
-  #currentTransitions: Partial<Record<TEvents, TStates>>;
-  #listenerCount = 0;
-  #actions: Map<TStates, Map<TEvents, (payload: unknown) => void>> | null =
-    null;
-  readonly #context: TContext;
-  readonly #transitions: Record<TStates, Partial<Record<TEvents, TStates>>>;
-  readonly #listeners: (TransitionListener<
-    TStates,
-    TEvents,
-    TPayloadMap
-  > | null)[] = [];
-
-  constructor(config: FSMConfig<TStates, TEvents, TContext>) {
-    this.#state = config.initial;
-    this.#context = config.context;
-    this.#transitions = config.transitions;
-    this.#currentTransitions = config.transitions[config.initial];
-  }
-
-  send(event: TEvents, payload?: TPayloadMap[TEvents]): TStates {
-    const nextState = this.#currentTransitions[event];
-
-    if (nextState === undefined) {
-      return this.#state;
-    }
-
-    const from = this.#state;
-
-    this.#state = nextState;
-    this.#currentTransitions = this.#transitions[nextState];
-
-    if (this.#actions !== null) {
-      const action = this.#actions.get(from)?.get(event);
-
-      if (action !== undefined) {
-        action(payload);
-      }
-    }
-
-    if (this.#listenerCount > 0) {
-      const info: TransitionInfo<TStates, TEvents, TPayloadMap> = {
-        from,
-        to: nextState,
-        event,
-        payload: payload,
-      };
-
-      for (const listener of this.#listeners) {
-        if (listener !== null) {
-          listener(info);
-        }
-      }
-    }
-
-    return this.#state;
-  }
-
-  canSend(event: TEvents): boolean {
-    return this.#currentTransitions[event] !== undefined;
-  }
-
-  /**
-   * Directly sets FSM state without triggering actions or listeners.
-   * Use for hot-path optimizations where the caller handles side effects.
-   */
-  forceState(state: TStates): void {
-    this.#state = state;
-    this.#currentTransitions = this.#transitions[state];
-  }
-
-  getState(): TStates {
-    return this.#state;
-  }
-
-  getContext(): TContext {
-    return this.#context;
-  }
-
-  on<E extends TEvents>(
-    from: TStates,
-    event: E,
-    action: E extends keyof TPayloadMap
-      ? (payload: TPayloadMap[E]) => void
-      : () => void,
-  ): () => void {
-    this.#actions ??= new Map();
-
-    let stateActions = this.#actions.get(from);
-
-    if (!stateActions) {
-      stateActions = new Map();
-      this.#actions.set(from, stateActions);
-    }
-
-    stateActions.set(event, action as (payload: unknown) => void);
-
-    return () => {
-      this.#actions?.get(from)?.delete(event);
-    };
-  }
-
-  onTransition(
-    listener: (info: TransitionInfo<TStates, TEvents, TPayloadMap>) => void,
-  ): () => void {
-    const nullIndex = this.#listeners.indexOf(null);
-    let index: number;
-
-    if (nullIndex === -1) {
-      index = this.#listeners.length;
-      this.#listeners.push(listener);
-    } else {
-      this.#listeners[nullIndex] = listener;
-      index = nullIndex;
-    }
-
-    this.#listenerCount++;
-    let subscribed = true;
-
-    return () => {
-      if (!subscribed) {
-        return;
-      }
-
-      subscribed = false;
-      this.#listeners[index] = null;
-      this.#listenerCount--;
-    };
-  }
-}

package/src/index.ts

@@ -1,3 +0,0 @@
-export { FSM } from "./fsm";
-
-export type { FSMConfig, TransitionInfo } from "./types";

package/src/types.ts

@@ -1,26 +0,0 @@
-export interface FSMConfig<
-  TStates extends string,
-  TEvents extends string,
-  TContext,
-> {
-  initial: TStates;
-  context: TContext;
-  transitions: Record<TStates, Partial<Record<TEvents, TStates>>>;
-}
-
-export interface TransitionInfo<
-  TStates extends string,
-  TEvents extends string,
-  TPayloadMap extends Partial<Record<TEvents, unknown>>,
-> {
-  from: TStates;
-  to: TStates;
-  event: TEvents;
-  payload: TPayloadMap[TEvents] | undefined;
-}
-
-export type TransitionListener<
-  TStates extends string,
-  TEvents extends string,
-  TPayloadMap extends Partial<Record<TEvents, unknown>>,
-> = (info: TransitionInfo<TStates, TEvents, TPayloadMap>) => void;