@alwatr/fsm 0.30.0 → 0.31.0

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [0.31.0](https://github.com/AliMD/alwatr/compare/v0.30.0...v0.31.0) (2023-05-08)
+
+### Bug Fixes
+
+- **fms:** import path ([f6770a0](https://github.com/AliMD/alwatr/commit/f6770a07fdf6855ccd63a85822d44d5ef9c72dee))
+- **fsm:** action maybe async ([50efffa](https://github.com/AliMD/alwatr/commit/50efffa34a2ea5a3515561d7425da0c109631f36))
+- **fsm:** autoSignalUnsubscribe type ([f7db30b](https://github.com/AliMD/alwatr/commit/f7db30bf5a90ff3d163f036b313a412a5149ff2b))
+- **fsm:** call render states function in there own this ([a950478](https://github.com/AliMD/alwatr/commit/a95047811366e375785b2cd8fb176b1176638cab))
+- **fsm:** fix order of `initFsmInstance` args ([3b60138](https://github.com/AliMD/alwatr/commit/3b60138ecebcbcb4d732e4d1a3e79f5b8661ae47))
+- **fsm:** initial exec actions ([e7dd5c8](https://github.com/AliMD/alwatr/commit/e7dd5c8aaf9760c9856e4392cc899020f7e796d9))
+- **fsm:** last reported bugs in set state ([e7435c8](https://github.com/AliMD/alwatr/commit/e7435c870a054b0ec3e4004f13c6db7610610be0))
+- **fsm:** review reset process ([af6e81c](https://github.com/AliMD/alwatr/commit/af6e81c068b467d8b3aa96f2431e13ac479f018c))
+- **fsm:** run init entry actions ([777ae45](https://github.com/AliMD/alwatr/commit/777ae459f2b77f79696daf3a0ca355d6d78e57d3))
+- new logger api ([9d83a7d](https://github.com/AliMD/alwatr/commit/9d83a7dc5c103bc3bb4282dacfd85fa998915300))
+
+### Features
+
+- **fsm:** add `signalRecord` to config ([1a35291](https://github.com/AliMD/alwatr/commit/1a352915fba978da141513517655d1e07350c3ec))
+- **fsm:** add unsubscribe ([85ed3c3](https://github.com/AliMD/alwatr/commit/85ed3c3439e1f40c2760f6011df112242f10be06))
+- **fsm:** callback in provider signals ([772818b](https://github.com/AliMD/alwatr/commit/772818baa7953b6fbb4d4128fcee76733f42cc2d))
+- **fsm:** custom signal callback ([47c22e9](https://github.com/AliMD/alwatr/commit/47c22e92a8a8085148b44b316d649b695ff8071a))
+- **fsm:** destroy and expire api ([e1a1c15](https://github.com/AliMD/alwatr/commit/e1a1c150d81f4428718bd18f039235c7fce9caf2))
+- **fsm:** new types ([2866e3b](https://github.com/AliMD/alwatr/commit/2866e3bd5ff56fd2b5bddcaed3673a5868bae4bb))
+- **fsm:** rewrite state machine ([7f24695](https://github.com/AliMD/alwatr/commit/7f246959e5a80b21c1c4b21e895e75f8fbe56798))
+- **fsm:** subscribe ([2af4f44](https://github.com/AliMD/alwatr/commit/2af4f44f0e8a2dee39cde10dcaa3281075632e6a))
+
 # [0.30.0](https://github.com/AliMD/alwatr/compare/v0.29.0...v0.30.0) (2023-03-06)
 
 ### Bug Fixes

package/README.md

@@ -1,3 +1,3 @@
 # Alwatr Finite State Machines - `@alwatr/fsm`
 
-Managing invocations finite-state machines as actors written in tiny TypeScript module.
+Managing invocations finite-state machines for lit-element written in tiny TypeScript module.

package/core.d.ts

@@ -1,54 +1,158 @@
-import type { Stringifyable, StringifyableRecord } from '@alwatr/type';
-export interface MachineConfig<TState extends string, TEventId extends string, TContext extends Stringifyable> extends StringifyableRecord {
-    /**
-     * Machine ID (It is used in the state change signal identifier, so it must be unique).
-     */
-    id: string;
-    /**
-     * Initial state.
-     */
-    initial: TState;
-    /**
-     * Initial context.
-     */
-    context: TContext;
-    /**
-     * States list
-     */
-    states: {
-        [S in TState | '$all']: {
-            /**
-             * An object mapping eventId (keys) to state.
-             */
-            on: {
-                [E in TEventId]?: TState | '$self';
-            };
-        };
-    };
-}
-export interface StateContext<TState extends string, TEventId extends string> {
-    [T: string]: string;
-    to: TState;
-    from: TState | 'init';
-    by: TEventId | 'INIT';
-}
-export declare class FiniteStateMachine<TState extends string = string, TEventId extends string = string, TContext extends StringifyableRecord = StringifyableRecord> {
-    readonly config: Readonly<MachineConfig<TState, TEventId, TContext>>;
-    state: StateContext<TState, TEventId>;
-    context: TContext;
-    signal: {
-        readonly id: string;
-        readonly getValue: () => StateContext<TState, TEventId> | undefined;
-        readonly untilChange: () => Promise<StateContext<TState, TEventId>>;
-        readonly subscribe: (listenerCallback: import("@alwatr/signal/type.js").ListenerFunction<StateContext<TState, TEventId>>, options?: Partial<import("@alwatr/signal/type.js").SubscribeOptions> | undefined) => import("@alwatr/signal").ListenerSpec;
-        readonly unsubscribe: (listener: import("@alwatr/signal").ListenerSpec) => void;
-    };
-    protected _logger: import("@alwatr/logger").AlwatrLogger;
-    protected setState(to: TState, by: TEventId | 'INIT'): void;
-    constructor(config: Readonly<MachineConfig<TState, TEventId, TContext>>);
-    /**
-     * Machine transition.
-     */
-    transition(event: TEventId, context?: Partial<TContext>): TState | null;
-}
+import { ListenerSpec } from '@alwatr/signal';
+import { SubscribeOptions } from '@alwatr/signal/type.js';
+import type { ActionRecord, FsmConstructor, FsmConstructorConfig, FsmConsumerInterface, FsmInstance, FsmState, SignalConfig } from './type.js';
+import type { MaybePromise, SingleOrArray, StringifyableRecord } from '@alwatr/type';
+export declare const defineConstructor: <TState extends string = string, TEventId extends string = string, TActionName extends string = string, TContext extends StringifyableRecord = StringifyableRecord>(id: string, config: FsmConstructorConfig<TState, TEventId, TActionName, TContext>) => FsmConstructorConfig<TState, TEventId, TActionName, TContext>;
+/**
+ * Get finite state machine instance by id.
+ */
+export declare const getFsmInstance: <TState extends string = string, TEventId extends string = string, TContext extends StringifyableRecord = StringifyableRecord>(instanceId: string) => FsmInstance<TState, TEventId, TContext>;
+/**
+ * Get finite state machine constructor by id.
+ */
+export declare const getFsmConstructor: (constructorId: string) => FsmConstructor;
+/**
+ * Get current state of finite state machine instance.
+ */
+export declare const getState: <TState extends string = string, TEventId extends string = string>(instanceId: string) => FsmState<TState, TEventId>;
+/**
+ * Get current context of finite state machine instance.
+ */
+export declare const getContext: <TContext extends StringifyableRecord = StringifyableRecord>(instanceId: string) => TContext;
+/**
+ * Set context of finite state machine instance.
+ */
+export declare const setContext: <TContext extends StringifyableRecord = StringifyableRecord>(instanceId: string, context: Partial<TContext>, notify?: boolean) => void;
+/**
+ * Transition finite state machine instance to new state.
+ */
+export declare const transition: <TEventId extends string = string, TContext extends StringifyableRecord = StringifyableRecord>(instanceId: string, event: TEventId, context?: Partial<TContext> | undefined) => void;
+/**
+ * Define actions for finite state machine constructor.
+ */
+export declare const defineActions: <T extends Readonly<{
+    TState: string;
+    TEventId: string;
+    TActionName: string;
+    TContext: StringifyableRecord;
+}>>(constructorId: string, actionRecord: ActionRecord<T>) => void;
+/**
+ * Execute all actions for current state.
+ */
+export declare const _execAllActions: (constructor: FsmConstructor, state: FsmState, consumerInterface: FsmConsumerInterface) => void;
+/**
+ * Execute single action.
+ */
+export declare const _execAction: (constructor: FsmConstructor, actionNames: SingleOrArray<string> | undefined, finiteStateMachine: FsmConsumerInterface) => boolean | MaybePromise<void>;
+/**
+ * Initialize new finite state machine instance.
+ */
+export declare const initFsmInstance: (instanceId: string, constructorId: string) => void;
+/**
+ * Subscribe to all defined signals for finite state machine instance.
+ */
+export declare const subscribeSignals: (instanceId: string, signalList: Array<SignalConfig>, subscribeConstructorSignals?: boolean) => Array<ListenerSpec>;
+/**
+ * Define signals for finite state machine constructor.
+ */
+export declare const defineConstructorSignals: <T extends Readonly<{
+    TState: string;
+    TEventId: string;
+    TActionName: string;
+    TContext: StringifyableRecord;
+}>>(constructorId: string, signalList: SignalConfig<T>[]) => void;
+/**
+ * Define signals for finite state machine instance.
+ */
+export declare const defineInstanceSignals: <T extends Readonly<{
+    TState: string;
+    TEventId: string;
+    TActionName: string;
+    TContext: StringifyableRecord;
+}>>(instanceId: string, signalList: SignalConfig<T>[], subscribeConstructorSignals?: boolean) => Array<ListenerSpec>;
+/**
+ * Render helper for use finite state machine instance in UI.
+ *
+ * Example:
+ *
+ * ```ts
+ * render('myFsm', {
+ *   state1: () => html`<div>State 1 Render...</div>`,
+ *   state2: () => html`<div>State 2 Render...</div>`,
+ *   state3: 'state1',
+ * });
+ * ```
+ */
+export declare const render: <TState extends string = string>(instanceId: string, states: { [P in TState]: TState | (() => unknown); }, thisArg?: unknown) => unknown;
+/**
+ * Subscribe to finite state machine instance state changes.
+ */
+export declare const subscribe: (instanceId: string, callback: () => void, options?: Partial<SubscribeOptions>) => ListenerSpec;
+/**
+ * Destroy finite state machine instance object to clear memory.
+ */
+export declare const destroy: (instanceId: string) => void;
+/**
+ * Reset finite state machine instance to initial state and context.
+ */
+export declare const reset: (instanceId: string) => void;
+/**
+ * Finite state machine instance consumer.
+ * Lookup current finite state machine instance or initialize new one and return consumer object .
+ */
+export declare const finiteStateMachineConsumer: <T extends Readonly<{
+    TState: string;
+    TEventId: string;
+    TActionName: string;
+    TContext: StringifyableRecord;
+}>, TContext extends T["TContext"] = T["TContext"]>(instanceId: string, makeFromConstructor?: string) => {
+    /**
+     * Finite state machine instance id.
+     */
+    readonly id: string;
+    /**
+     * Finite state machine constructor id.
+     */
+    readonly constructorId: string;
+    /**
+     * Render helper for use finite state machine instance in UI.
+     */
+    readonly render: (states: { [P in T["TState"]]: (() => unknown) | T["TState"]; }, thisArg?: unknown) => unknown;
+    /**
+     * Subscribe to finite state machine instance state changes.
+     */
+    readonly subscribe: (callback: () => void, options?: Partial<SubscribeOptions> | undefined) => ListenerSpec;
+    /**
+     * Unsubscribe from finite state machine instance state changes.
+     */
+    readonly unsubscribe: (listener: ListenerSpec) => void;
+    /**
+     * Get current state of finite state machine instance.
+     */
+    readonly getState: () => FsmState<T["TState"], T["TEventId"]>;
+    /**
+     * Get current context of finite state machine instance.
+     */
+    readonly getContext: () => TContext;
+    /**
+     * Set context of finite state machine instance.
+     */
+    readonly setContext: (context: Partial<TContext>, notify?: boolean | undefined) => void;
+    /**
+     * Transition finite state machine instance to new state.
+     */
+    readonly transition: (event: T["TEventId"], context?: Partial<TContext> | undefined) => void;
+    /**
+     * Define signals for finite state machine instance.
+     */
+    readonly defineSignals: (signalList: SignalConfig<T>[], subscribeConstructorSignals?: boolean | undefined) => ListenerSpec[];
+    /**
+     * Reset finite state machine instance to initial state and context.
+     */
+    readonly reset: () => void;
+    /**
+     * Destroy finite state machine instance object to clear memory.
+     */
+    readonly destroy: () => void;
+};
 //# sourceMappingURL=core.d.ts.map

package/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["src/core.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAE,mBAAmB,EAAC,MAAM,cAAc,CAAC;AAOrE,MAAM,WAAW,aAAa,CAAC,MAAM,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM,EAAE,QAAQ,SAAS,aAAa,CAC3G,SAAQ,mBAAmB;IAC3B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,QAAQ,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE;SACL,CAAC,IAAI,MAAM,GAAG,MAAM,GAAG;YACtB;;eAEG;YACH,EAAE,EAAE;iBACD,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;aACnC,CAAC;SACH;KACF,CAAC;CACH;AAED,MAAM,WAAW,YAAY,CAAC,MAAM,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM;IAC1E,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,EAAE,EAAE,QAAQ,GAAG,MAAM,CAAC;CACvB;AAED,qBAAa,kBAAkB,CAC7B,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,QAAQ,SAAS,MAAM,GAAG,MAAM,EAChC,QAAQ,SAAS,mBAAmB,GAAG,mBAAmB;aAqB9B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAnBvF,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAInC;IACF,OAAO,WAAuB;IAC9B,MAAM;;;;;;MAAkG;IAExG,SAAS,CAAC,OAAO,wCAAgD;IAEjE,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI;gBAS/B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAQvF;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,IAAI;CAoCxE"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["src/core.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,YAAY,EAAmC,MAAM,gBAAgB,CAAC;AAE9E,OAAO,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,QAAQ,EAER,YAAY,EACb,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAC,YAAY,EAAkB,aAAa,EAAE,mBAAmB,EAAC,MAAM,cAAc,CAAC;AAcnG,eAAO,MAAM,iBAAiB,0KAMtB,MAAM,yIAYb,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,6IAKX,MAAM,4CAMrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,kBAAmB,MAAM,KAAG,cAKzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,iFACP,MAAM,+BAInB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,2EACT,MAAM,aAInB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,2EACT,MAAM,uCAET,OAAO,KACf,IAWF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,6GAIP,MAAM,+DAGjB,IAgDJ,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;mBAA4C,MAAM,oCAAkC,IAO7G,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,gBACX,cAAc,SACpB,QAAQ,qBACI,oBAAoB,KACxC,IA0BF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,gBACP,cAAc,eACd,cAAc,MAAM,CAAC,GAAG,SAAS,sBAC1B,oBAAoB,KACzC,OAAO,GAAG,aAAa,IAAI,CA4B7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,eAAgB,MAAM,iBAAiB,MAAM,KAAG,IAgB3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,eACb,MAAM,cACN,MAAM,YAAY,CAAC,4CAEhC,MAAM,YAAY,CAmCpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;mBACpB,MAAM,oCAEpB,IAIF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;gBACpB,MAAM,2EAGjB,MAAM,YAAY,CAGpB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM,+CACL,MAAM,2CACa,OAAO,gBAC7B,OAAO,KACf,OAcF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,eACN,MAAM,YACR,MAAM,IAAI,YACV,QAAQ,gBAAgB,CAAC,KACpC,YAGF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,eAAgB,MAAM,KAAG,IAG5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,KAAK,eAAgB,MAAM,KAAG,IAK1C,CAAC;AAEF;;;GAGG;AAEH,eAAO,MAAM,0BAA0B;;;;;gEACzB,MAAM,wBACI,MAAM;IAc1B;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;2DAjF0B,OAAO;IAoFpC;;OAEG;yCA/Da,IAAI;IAkEpB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAGN,CAAC"}

package/core.js

@@ -1,63 +1,371 @@
 import { createLogger, globalAlwatr } from '@alwatr/logger';
-import { contextConsumer } from '@alwatr/signal';
-import { dispatch } from '@alwatr/signal/core.js';
+import { contextProvider, contextConsumer } from '@alwatr/signal';
+import { destroySignal, unsubscribe } from '@alwatr/signal/core.js';
 globalAlwatr.registeredList.push({
     name: '@alwatr/fsm',
     version: _ALWATR_VERSION_,
 });
-export class FiniteStateMachine {
-    setState(to, by) {
-        var _a, _b;
-        this.state = {
-            to,
-            from: (_b = (_a = this.signal.getValue()) === null || _a === void 0 ? void 0 : _a.to) !== null && _b !== void 0 ? _b : 'init',
-            by,
-        };
-        dispatch(this.signal.id, this.state, { debounce: 'NextCycle' });
+const logger = createLogger(`alwatr/fsm`);
+/**
+ * Finite state machine constructor storage.
+ */
+const fsmConstructorStorage = {};
+export const defineConstructor = (id, config) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'defineConstructor', { id, config });
+    if (fsmConstructorStorage[id] != null)
+        throw new Error('fsm_exist', { cause: { id } });
+    fsmConstructorStorage[id] = {
+        id,
+        config,
+        actionRecord: {},
+        signalList: [],
+    };
+    return config;
+};
+/**
+ * Get finite state machine instance by id.
+ */
+export const getFsmInstance = (instanceId) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, '_getFsmInstance', instanceId);
+    const fsmInstance = contextConsumer.getValue(instanceId);
+    if (fsmInstance == null)
+        throw new Error('fsm_undefined', { cause: { instanceId } });
+    return fsmInstance;
+};
+/**
+ * Get finite state machine constructor by id.
+ */
+export const getFsmConstructor = (constructorId) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, '_getFsmConstructor', constructorId);
+    const fsmConstructor = fsmConstructorStorage[constructorId];
+    if (fsmConstructor == null)
+        throw new Error('fsm_undefined', { cause: { constructorId: constructorId } });
+    return fsmConstructor;
+};
+/**
+ * Get current state of finite state machine instance.
+ */
+export const getState = (instanceId) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'getState', instanceId);
+    return getFsmInstance(instanceId).state;
+};
+/**
+ * Get current context of finite state machine instance.
+ */
+export const getContext = (instanceId) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'getContext', instanceId);
+    return getFsmInstance(instanceId).context;
+};
+/**
+ * Set context of finite state machine instance.
+ */
+export const setContext = (instanceId, context, notify) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'setContext', { instanceId, context });
+    const fsmInstance = getFsmInstance(instanceId);
+    fsmInstance.context = {
+        ...fsmInstance.context,
+        ...context,
+    };
+    if (notify) {
+        contextProvider.setValue(instanceId, fsmInstance, { debounce: 'Timeout' });
     }
-    constructor(config) {
-        this.config = config;
-        this.state = {
-            to: this.config.initial,
-            from: 'init',
-            by: 'INIT',
+};
+/**
+ * Transition finite state machine instance to new state.
+ */
+export const transition = (instanceId, event, context) => {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const fsmInstance = getFsmInstance(instanceId);
+    const fsmConstructor = getFsmConstructor(fsmInstance.constructorId);
+    const fromState = fsmInstance.state.target;
+    const stateRecord = fsmConstructor.config.stateRecord;
+    const transitionConfig = (_b = (_a = stateRecord[fromState]) === null || _a === void 0 ? void 0 : _a.on[event]) !== null && _b !== void 0 ? _b : stateRecord.$all.on[event];
+    (_c = logger.logMethodArgs) === null || _c === void 0 ? void 0 : _c.call(logger, 'transition', { instanceId, fromState, event, context, target: transitionConfig === null || transitionConfig === void 0 ? void 0 : transitionConfig.target });
+    if (context !== undefined) {
+        fsmInstance.context = {
+            ...fsmInstance.context,
+            ...context,
         };
-        this.context = this.config.context;
-        this.signal = contextConsumer.bind('finite-state-machine-' + this.config.id);
-        this._logger = createLogger(`alwatr/fsm:${this.config.id}`);
-        this._logger.logMethodArgs('constructor', config);
-        dispatch(this.signal.id, this.state, { debounce: 'NextCycle' });
-        if (!config.states[config.initial]) {
-            this._logger.error('constructor', 'invalid_initial_state', config);
-        }
     }
-    /**
-     * Machine transition.
-     */
-    transition(event, context) {
-        var _a, _b, _c, _d, _e, _f, _g;
-        const fromState = this.state.to;
-        let toState = (_c = (_b = (_a = this.config.states[fromState]) === null || _a === void 0 ? void 0 : _a.on) === null || _b === void 0 ? void 0 : _b[event]) !== null && _c !== void 0 ? _c : (_e = (_d = this.config.states.$all) === null || _d === void 0 ? void 0 : _d.on) === null || _e === void 0 ? void 0 : _e[event];
-        if (toState === '$self') {
-            toState = fromState;
-        }
-        this._logger.logMethodFull('transition', { fromState, event, context }, toState);
-        if (context !== undefined) {
-            this.context = {
-                ...this.context,
-                ...context,
-            };
-        }
-        if (toState == null) {
-            this._logger.incident('transition', 'invalid_target_state', 'Defined target state for this event not found in state config', {
-                fromState,
-                event,
-                events: { ...(_f = this.config.states.$all) === null || _f === void 0 ? void 0 : _f.on, ...(_g = this.config.states[fromState]) === null || _g === void 0 ? void 0 : _g.on },
+    if (transitionConfig == null) {
+        (_d = logger.incident) === null || _d === void 0 ? void 0 : _d.call(logger, 'transition', 'invalid_target_state', 'Defined target state for this event not found in state config', {
+            fromState,
+            event,
+            events: {
+                ...(_e = stateRecord.$all) === null || _e === void 0 ? void 0 : _e.on,
+                ...(_f = stateRecord[fromState]) === null || _f === void 0 ? void 0 : _f.on,
+            },
+        });
+        return;
+    }
+    const consumerInterface = finiteStateMachineConsumer(instanceId);
+    if (transitionConfig.condition) {
+        if (_execAction(fsmConstructor, transitionConfig.condition, consumerInterface) === false)
+            return;
+    }
+    fsmInstance.state = {
+        target: (_g = transitionConfig.target) !== null && _g !== void 0 ? _g : fromState,
+        from: fromState,
+        by: event,
+    };
+    contextProvider.setValue(instanceId, fsmInstance, { debounce: 'Timeout' });
+    _execAllActions(fsmConstructor, fsmInstance.state, consumerInterface);
+};
+/**
+ * Define actions for finite state machine constructor.
+ */
+export const defineActions = (constructorId, actionRecord) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'defineActions', { constructorId, actionRecord });
+    const fmsConstructor = getFsmConstructor(constructorId);
+    fmsConstructor.actionRecord = {
+        ...fmsConstructor.actionRecord,
+        ...actionRecord,
+    };
+};
+/**
+ * Execute all actions for current state.
+ */
+export const _execAllActions = (constructor, state, consumerInterface) => {
+    var _a, _b, _c, _d, _e, _f, _g;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, '_execAllActions', consumerInterface.id);
+    const stateRecord = constructor.config.stateRecord;
+    if (state.by === 'INIT') {
+        _execAction(constructor, stateRecord.$all.entry, consumerInterface);
+        _execAction(constructor, (_b = stateRecord[state.target]) === null || _b === void 0 ? void 0 : _b.entry, consumerInterface);
+        return;
+    }
+    // else
+    if (state.from !== state.target) {
+        _execAction(constructor, stateRecord.$all.exit, consumerInterface);
+        _execAction(constructor, (_c = stateRecord[state.from]) === null || _c === void 0 ? void 0 : _c.exit, consumerInterface);
+        _execAction(constructor, stateRecord.$all.entry, consumerInterface);
+        _execAction(constructor, (_d = stateRecord[state.target]) === null || _d === void 0 ? void 0 : _d.entry, consumerInterface);
+    }
+    _execAction(constructor, ((_e = stateRecord[state.from]) === null || _e === void 0 ? void 0 : _e.on[state.by]) != null
+        ? (_f = stateRecord[state.from].on[state.by]) === null || _f === void 0 ? void 0 : _f.actions
+        : (_g = stateRecord.$all.on[state.by]) === null || _g === void 0 ? void 0 : _g.actions, consumerInterface);
+};
+/**
+ * Execute single action.
+ */
+export const _execAction = (constructor, actionNames, finiteStateMachine) => {
+    var _a;
+    if (actionNames == null)
+        return;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'execAction', { constructorId: constructor.id, actionNames });
+    if (Array.isArray(actionNames)) {
+        return actionNames
+            .map((actionName) => _execAction(constructor, actionName, finiteStateMachine))
+            .every((r) => r === true);
+    }
+    try {
+        const actionFn = constructor.actionRecord[actionNames];
+        if (actionFn == null) {
+            return logger.error('execAction', 'action_not_found', {
+                actionNames,
+                constructorId: constructor.id,
+                instanceId: finiteStateMachine.id,
             });
-            return null;
         }
-        this.setState(toState, event);
-        return toState;
+        return actionFn(finiteStateMachine);
+    }
+    catch (error) {
+        return logger.error('execAction', 'action_error', error, {
+            actionNames,
+            constructorId: constructor.id,
+            instanceId: finiteStateMachine.id,
+        });
+    }
+};
+/**
+ * Initialize new finite state machine instance.
+ */
+export const initFsmInstance = (instanceId, constructorId) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'initializeMachine', { constructorId, instanceId });
+    const constructor = getFsmConstructor(constructorId);
+    const { initial, context } = constructor.config;
+    const newInstance = {
+        constructorId,
+        state: {
+            target: initial,
+            from: initial,
+            by: 'INIT',
+        },
+        context,
+    };
+    contextProvider.setValue(instanceId, newInstance, { debounce: 'NextCycle' });
+    _execAllActions(constructor, newInstance.state, finiteStateMachineConsumer(instanceId));
+};
+/**
+ * Subscribe to all defined signals for finite state machine instance.
+ */
+export const subscribeSignals = (instanceId, signalList, subscribeConstructorSignals = true) => {
+    var _a, _b, _c;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'subscribeSignals', { instanceId, signalList });
+    const listenerList = [];
+    if (subscribeConstructorSignals) {
+        signalList = signalList.concat(getFsmConstructor(getFsmInstance(instanceId).constructorId).signalList);
+    }
+    for (const signalConfig of signalList) {
+        (_b = signalConfig.signalId) !== null && _b !== void 0 ? _b : (signalConfig.signalId = instanceId);
+        listenerList.push(contextConsumer.subscribe(signalConfig.signalId, (signalDetail) => {
+            var _a;
+            (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'execSignalCallback', { instanceId, signalId: signalConfig.signalId, signalDetail });
+            if (signalConfig.callback) {
+                signalConfig.callback(signalDetail, finiteStateMachineConsumer(instanceId));
+            }
+            else {
+                // prettier-ignore
+                transition(instanceId, signalConfig.transition, signalConfig.contextName == null ? undefined : {
+                    [signalConfig.contextName]: signalDetail,
+                });
+            }
+        }, { receivePrevious: (_c = signalConfig.receivePrevious) !== null && _c !== void 0 ? _c : 'No' }));
+    }
+    return listenerList;
+};
+/**
+ * Define signals for finite state machine constructor.
+ */
+export const defineConstructorSignals = (constructorId, signalList) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'defineSignals', { constructorId, signalList: signalList });
+    const fsmConstructor = getFsmConstructor(constructorId);
+    fsmConstructor.signalList = fsmConstructor.signalList.concat(signalList);
+};
+/**
+ * Define signals for finite state machine instance.
+ */
+export const defineInstanceSignals = (instanceId, signalList, subscribeConstructorSignals = true) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'defineSignals', { instanceId, signals: signalList });
+    return subscribeSignals(instanceId, signalList, subscribeConstructorSignals);
+};
+/**
+ * Render helper for use finite state machine instance in UI.
+ *
+ * Example:
+ *
+ * ```ts
+ * render('myFsm', {
+ *   state1: () => html`<div>State 1 Render...</div>`,
+ *   state2: () => html`<div>State 2 Render...</div>`,
+ *   state3: 'state1',
+ * });
+ * ```
+ */
+export const render = (instanceId, states, thisArg = null) => {
+    var _a;
+    const state = getFsmInstance(instanceId).state;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'render', { instanceId, state: state.target });
+    let renderFn = states[state.target];
+    if (typeof renderFn === 'string') {
+        renderFn = states[renderFn];
+    }
+    if (typeof renderFn === 'function') {
+        return renderFn.call(thisArg);
+    }
+    return;
+};
+/**
+ * Subscribe to finite state machine instance state changes.
+ */
+export const subscribe = (instanceId, callback, options) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'subscribe', instanceId);
+    return contextConsumer.subscribe(instanceId, callback, options);
+};
+/**
+ * Destroy finite state machine instance object to clear memory.
+ */
+export const destroy = (instanceId) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'destroy', instanceId);
+    destroySignal(instanceId);
+};
+/**
+ * Reset finite state machine instance to initial state and context.
+ */
+export const reset = (instanceId) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'reset', instanceId);
+    const constructorId = getFsmInstance(instanceId).constructorId;
+    // contextProvider.expire(instanceId);
+    initFsmInstance(instanceId, constructorId);
+};
+/**
+ * Finite state machine instance consumer.
+ * Lookup current finite state machine instance or initialize new one and return consumer object .
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+export const finiteStateMachineConsumer = (instanceId, makeFromConstructor) => {
+    var _a, _b;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'stateMachineLookup', instanceId);
+    const machineInstance = contextConsumer.getValue(instanceId);
+    if (machineInstance == null) {
+        // instance not initialized.
+        if (makeFromConstructor == null) {
+            throw new Error('fsm_undefined', { cause: { instanceId } });
+        }
+        initFsmInstance(instanceId, makeFromConstructor);
     }
-}
+    return {
+        /**
+         * Finite state machine instance id.
+         */
+        id: instanceId,
+        /**
+         * Finite state machine constructor id.
+         */
+        constructorId: (_b = machineInstance === null || machineInstance === void 0 ? void 0 : machineInstance.constructorId) !== null && _b !== void 0 ? _b : makeFromConstructor,
+        /**
+         * Render helper for use finite state machine instance in UI.
+         */
+        render: render.bind(null, instanceId),
+        /**
+         * Subscribe to finite state machine instance state changes.
+         */
+        subscribe: subscribe.bind(null, instanceId),
+        /**
+         * Unsubscribe from finite state machine instance state changes.
+         */
+        unsubscribe: unsubscribe,
+        /**
+         * Get current state of finite state machine instance.
+         */
+        getState: getState.bind(null, instanceId),
+        /**
+         * Get current context of finite state machine instance.
+         */
+        getContext: getContext.bind(null, instanceId),
+        /**
+         * Set context of finite state machine instance.
+         */
+        setContext: setContext.bind(null, instanceId),
+        /**
+         * Transition finite state machine instance to new state.
+         */
+        transition: transition.bind(null, instanceId),
+        /**
+         * Define signals for finite state machine instance.
+         */
+        defineSignals: defineInstanceSignals.bind(null, instanceId),
+        /**
+         * Reset finite state machine instance to initial state and context.
+         */
+        reset: reset.bind(null, instanceId),
+        /**
+         * Destroy finite state machine instance object to clear memory.
+         */
+        destroy: destroy.bind(null, instanceId),
+    };
+};
 //# sourceMappingURL=core.js.map

package/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAC,eAAe,EAAC,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAIhD,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC;IAC/B,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,gBAAgB;CAC1B,CAAC,CAAC;AAyCH,MAAM,OAAO,kBAAkB;IAenB,QAAQ,CAAC,EAAU,EAAE,EAAqB;;QAClD,IAAI,CAAC,KAAK,GAAG;YACX,EAAE;YACF,IAAI,EAAE,MAAA,MAAA,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,0CAAE,EAAE,mCAAI,MAAM;YAC1C,EAAE;SACH,CAAC;QACF,QAAQ,CAAiC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,EAAC,QAAQ,EAAE,WAAW,EAAC,CAAC,CAAC;IAChG,CAAC;IAED,YAA4B,MAA2D;QAA3D,WAAM,GAAN,MAAM,CAAqD;QAnBvF,UAAK,GAAmC;YACtC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM;YACZ,EAAE,EAAE,MAAM;SACX,CAAC;QACF,YAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAC9B,WAAM,GAAG,eAAe,CAAC,IAAI,CAAiC,uBAAuB,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAE9F,YAAO,GAAG,YAAY,CAAC,cAAc,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAY/D,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAClD,QAAQ,CAAiC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,EAAC,QAAQ,EAAE,WAAW,EAAC,CAAC,CAAC;QAC9F,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;YAClC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,uBAAuB,EAAE,MAAM,CAAC,CAAC;SACpE;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAe,EAAE,OAA2B;;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAEhC,IAAI,OAAO,GACT,MAAA,MAAA,MAAA,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,0CAAE,EAAE,0CAAG,KAAK,CAAC,mCAAI,MAAA,MAAA,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,0CAAE,EAAE,0CAAG,KAAK,CAAC,CAAC;QAErF,IAAI,OAAO,KAAK,OAAO,EAAE;YACvB,OAAO,GAAG,SAAS,CAAC;SACrB;QAED,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,EAAE,EAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAC,EAAE,OAAO,CAAC,CAAC;QAE/E,IAAI,OAAO,KAAK,SAAS,EAAE;YACzB,IAAI,CAAC,OAAO,GAAG;gBACb,GAAG,IAAI,CAAC,OAAO;gBACf,GAAG,OAAO;aACX,CAAC;SACH;QAED,IAAI,OAAO,IAAI,IAAI,EAAE;YACnB,IAAI,CAAC,OAAO,CAAC,QAAQ,CACjB,YAAY,EACZ,sBAAsB,EACtB,+DAA+D,EAC/D;gBACE,SAAS;gBACT,KAAK;gBACL,MAAM,EAAE,EAAC,GAAG,MAAA,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,0CAAE,EAAE,EAAE,GAAG,MAAA,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,0CAAE,EAAE,EAAC;aAC/E,CACJ,CAAC;YACF,OAAO,IAAI,CAAC;SACb;QAED,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,OAAO,CAAC;IACjB,CAAC;CACF","sourcesContent":["import {createLogger, globalAlwatr} from '@alwatr/logger';\nimport {contextConsumer} from '@alwatr/signal';\nimport {dispatch} from '@alwatr/signal/core.js';\n\nimport type {Stringifyable, StringifyableRecord} from '@alwatr/type';\n\nglobalAlwatr.registeredList.push({\n  name: '@alwatr/fsm',\n  version: _ALWATR_VERSION_,\n});\n\nexport interface MachineConfig<TState extends string, TEventId extends string, TContext extends Stringifyable>\n  extends StringifyableRecord {\n  /**\n   * Machine ID (It is used in the state change signal identifier, so it must be unique).\n   */\n  id: string;\n\n  /**\n   * Initial state.\n   */\n  initial: TState;\n\n  /**\n   * Initial context.\n   */\n  context: TContext;\n\n  /**\n   * States list\n   */\n  states: {\n    [S in TState | '$all']: {\n      /**\n       * An object mapping eventId (keys) to state.\n       */\n      on: {\n        [E in TEventId]?: TState | '$self';\n      };\n    };\n  };\n}\n\nexport interface StateContext<TState extends string, TEventId extends string> {\n  [T: string]: string;\n  to: TState;\n  from: TState | 'init';\n  by: TEventId | 'INIT';\n}\n\nexport class FiniteStateMachine<\n  TState extends string = string,\n  TEventId extends string = string,\n  TContext extends StringifyableRecord = StringifyableRecord\n> {\n  state: StateContext<TState, TEventId> = {\n    to: this.config.initial,\n    from: 'init',\n    by: 'INIT',\n  };\n  context = this.config.context;\n  signal = contextConsumer.bind<StateContext<TState, TEventId>>('finite-state-machine-' + this.config.id);\n\n  protected _logger = createLogger(`alwatr/fsm:${this.config.id}`);\n\n  protected setState(to: TState, by: TEventId | 'INIT'): void {\n    this.state = {\n      to,\n      from: this.signal.getValue()?.to ?? 'init',\n      by,\n    };\n    dispatch<StateContext<TState, TEventId>>(this.signal.id, this.state, {debounce: 'NextCycle'});\n  }\n\n  constructor(public readonly config: Readonly<MachineConfig<TState, TEventId, TContext>>) {\n    this._logger.logMethodArgs('constructor', config);\n    dispatch<StateContext<TState, TEventId>>(this.signal.id, this.state, {debounce: 'NextCycle'});\n    if (!config.states[config.initial]) {\n      this._logger.error('constructor', 'invalid_initial_state', config);\n    }\n  }\n\n  /**\n   * Machine transition.\n   */\n  transition(event: TEventId, context?: Partial<TContext>): TState | null {\n    const fromState = this.state.to;\n\n    let toState: TState | '$self' | undefined =\n      this.config.states[fromState]?.on?.[event] ?? this.config.states.$all?.on?.[event];\n\n    if (toState === '$self') {\n      toState = fromState;\n    }\n\n    this._logger.logMethodFull('transition', {fromState, event, context}, toState);\n\n    if (context !== undefined) {\n      this.context = {\n        ...this.context,\n        ...context,\n      };\n    }\n\n    if (toState == null) {\n      this._logger.incident(\n          'transition',\n          'invalid_target_state',\n          'Defined target state for this event not found in state config',\n          {\n            fromState,\n            event,\n            events: {...this.config.states.$all?.on, ...this.config.states[fromState]?.on},\n          },\n      );\n      return null;\n    }\n\n    this.setState(toState, event);\n    return toState;\n  }\n}\n"]}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["src/core.ts"],"names":[],"mappings":"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","sourcesContent":["import {createLogger, globalAlwatr} from '@alwatr/logger';\nimport {ListenerSpec, contextProvider, contextConsumer} from '@alwatr/signal';\nimport {destroySignal, unsubscribe} from '@alwatr/signal/core.js';\nimport {SubscribeOptions} from '@alwatr/signal/type.js';\n\nimport type {\n  ActionRecord,\n  FsmConstructor,\n  FsmConstructorConfig,\n  FsmConsumerInterface,\n  FsmInstance,\n  FsmState,\n  FsmTypeHelper,\n  SignalConfig,\n} from './type.js';\nimport type {MaybePromise, OmitFirstParam, SingleOrArray, StringifyableRecord} from '@alwatr/type';\n\nglobalAlwatr.registeredList.push({\n  name: '@alwatr/fsm',\n  version: _ALWATR_VERSION_,\n});\n\nconst logger = createLogger(`alwatr/fsm`);\n\n/**\n * Finite state machine constructor storage.\n */\nconst fsmConstructorStorage: Record<string, FsmConstructor | undefined> = {};\n\nexport const defineConstructor = <\n  TState extends string = string,\n  TEventId extends string = string,\n  TActionName extends string = string,\n  TContext extends StringifyableRecord = StringifyableRecord\n>(\n    id: string,\n    config: FsmConstructorConfig<TState, TEventId, TActionName, TContext>,\n  ): FsmConstructorConfig<TState, TEventId, TActionName, TContext> => {\n  logger.logMethodArgs?.('defineConstructor', {id, config});\n  if (fsmConstructorStorage[id] != null) throw new Error('fsm_exist', {cause: {id}});\n  fsmConstructorStorage[id] = {\n    id,\n    config,\n    actionRecord: {},\n    signalList: [],\n  };\n  return config;\n};\n\n/**\n * Get finite state machine instance by id.\n */\nexport const getFsmInstance = <\n  TState extends string = string,\n  TEventId extends string = string,\n  TContext extends StringifyableRecord = StringifyableRecord\n>(\n    instanceId: string,\n  ): FsmInstance<TState, TEventId, TContext> => {\n  logger.logMethodArgs?.('_getFsmInstance', instanceId);\n  const fsmInstance = contextConsumer.getValue<FsmInstance<TState, TEventId, TContext>>(instanceId);\n  if (fsmInstance == null) throw new Error('fsm_undefined', {cause: {instanceId}});\n  return fsmInstance;\n};\n\n/**\n * Get finite state machine constructor by id.\n */\nexport const getFsmConstructor = (constructorId: string): FsmConstructor => {\n  logger.logMethodArgs?.('_getFsmConstructor', constructorId);\n  const fsmConstructor = fsmConstructorStorage[constructorId];\n  if (fsmConstructor == null) throw new Error('fsm_undefined', {cause: {constructorId: constructorId}});\n  return fsmConstructor;\n};\n\n/**\n * Get current state of finite state machine instance.\n */\nexport const getState = <TState extends string = string, TEventId extends string = string>(\n  instanceId: string,\n): FsmState<TState, TEventId> => {\n  logger.logMethodArgs?.('getState', instanceId);\n  return getFsmInstance<TState, TEventId>(instanceId).state;\n};\n\n/**\n * Get current context of finite state machine instance.\n */\nexport const getContext = <TContext extends StringifyableRecord = StringifyableRecord>(\n  instanceId: string,\n): TContext => {\n  logger.logMethodArgs?.('getContext', instanceId);\n  return getFsmInstance<string, string, TContext>(instanceId).context;\n};\n\n/**\n * Set context of finite state machine instance.\n */\nexport const setContext = <TContext extends StringifyableRecord = StringifyableRecord>(\n  instanceId: string,\n  context: Partial<TContext>,\n  notify?: boolean,\n): void => {\n  logger.logMethodArgs?.('setContext', {instanceId, context});\n  const fsmInstance = getFsmInstance(instanceId);\n  fsmInstance.context = {\n    ...fsmInstance.context,\n    ...context,\n  };\n\n  if (notify) {\n    contextProvider.setValue(instanceId, fsmInstance, {debounce: 'Timeout'});\n  }\n};\n\n/**\n * Transition finite state machine instance to new state.\n */\nexport const transition = <\n  TEventId extends string = string,\n  TContext extends StringifyableRecord = StringifyableRecord\n>(\n    instanceId: string,\n    event: TEventId,\n    context?: Partial<TContext>,\n  ): void => {\n  const fsmInstance = getFsmInstance(instanceId);\n  const fsmConstructor = getFsmConstructor(fsmInstance.constructorId);\n  const fromState = fsmInstance.state.target;\n  const stateRecord = fsmConstructor.config.stateRecord;\n  const transitionConfig = stateRecord[fromState]?.on[event] ?? stateRecord.$all.on[event];\n\n  logger.logMethodArgs?.('transition', {instanceId, fromState, event, context, target: transitionConfig?.target});\n\n  if (context !== undefined) {\n    fsmInstance.context = {\n      ...fsmInstance.context,\n      ...context,\n    };\n  }\n\n  if (transitionConfig == null) {\n    logger.incident?.(\n        'transition',\n        'invalid_target_state',\n        'Defined target state for this event not found in state config',\n        {\n          fromState,\n          event,\n          events: {\n            ...stateRecord.$all?.on,\n            ...stateRecord[fromState]?.on,\n          },\n        },\n    );\n    return;\n  }\n\n  const consumerInterface = finiteStateMachineConsumer(instanceId);\n\n  if (transitionConfig.condition) {\n    if (_execAction(fsmConstructor, transitionConfig.condition, consumerInterface) === false) return;\n  }\n\n  fsmInstance.state = {\n    target: transitionConfig.target ?? fromState,\n    from: fromState,\n    by: event,\n  };\n\n  contextProvider.setValue(instanceId, fsmInstance, {debounce: 'Timeout'});\n\n  _execAllActions(fsmConstructor, fsmInstance.state, consumerInterface);\n};\n\n/**\n * Define actions for finite state machine constructor.\n */\nexport const defineActions = <T extends FsmTypeHelper>(constructorId: string, actionRecord: ActionRecord<T>): void => {\n  logger.logMethodArgs?.('defineActions', {constructorId, actionRecord});\n  const fmsConstructor = getFsmConstructor(constructorId);\n  fmsConstructor.actionRecord = {\n    ...fmsConstructor.actionRecord,\n    ...actionRecord,\n  };\n};\n\n/**\n * Execute all actions for current state.\n */\nexport const _execAllActions = (\n    constructor: FsmConstructor,\n    state: FsmState,\n    consumerInterface: FsmConsumerInterface,\n): void => {\n  logger.logMethodArgs?.('_execAllActions', consumerInterface.id);\n\n  const stateRecord = constructor.config.stateRecord;\n\n  if (state.by === 'INIT') {\n    _execAction(constructor, stateRecord.$all.entry, consumerInterface);\n    _execAction(constructor, stateRecord[state.target]?.entry, consumerInterface);\n    return;\n  }\n\n  // else\n  if (state.from !== state.target) {\n    _execAction(constructor, stateRecord.$all.exit, consumerInterface);\n    _execAction(constructor, stateRecord[state.from]?.exit, consumerInterface);\n    _execAction(constructor, stateRecord.$all.entry, consumerInterface);\n    _execAction(constructor, stateRecord[state.target]?.entry, consumerInterface);\n  }\n\n  _execAction(\n      constructor,\n    stateRecord[state.from]?.on[state.by] != null\n      ? stateRecord[state.from].on[state.by]?.actions\n      : stateRecord.$all.on[state.by]?.actions,\n    consumerInterface,\n  );\n};\n\n/**\n * Execute single action.\n */\nexport const _execAction = (\n    constructor: FsmConstructor,\n    actionNames: SingleOrArray<string> | undefined,\n    finiteStateMachine: FsmConsumerInterface,\n): boolean | MaybePromise<void> => {\n  if (actionNames == null) return;\n  logger.logMethodArgs?.('execAction', {constructorId: constructor.id, actionNames});\n\n  if (Array.isArray(actionNames)) {\n    return actionNames\n        .map((actionName) => _execAction(constructor, actionName, finiteStateMachine))\n        .every((r) => r === true);\n  }\n\n  try {\n    const actionFn = constructor.actionRecord[actionNames];\n    if (actionFn == null) {\n      return logger.error('execAction', 'action_not_found', {\n        actionNames,\n        constructorId: constructor.id,\n        instanceId: finiteStateMachine.id,\n      });\n    }\n    return actionFn(finiteStateMachine);\n  }\n  catch (error) {\n    return logger.error('execAction', 'action_error', error, {\n      actionNames,\n      constructorId: constructor.id,\n      instanceId: finiteStateMachine.id,\n    });\n  }\n};\n\n/**\n * Initialize new finite state machine instance.\n */\nexport const initFsmInstance = (instanceId: string, constructorId: string): void => {\n  logger.logMethodArgs?.('initializeMachine', {constructorId, instanceId});\n  const constructor = getFsmConstructor(constructorId);\n  const {initial, context} = constructor.config;\n  const newInstance: FsmInstance = {\n    constructorId,\n    state: {\n      target: initial,\n      from: initial,\n      by: 'INIT',\n    },\n    context,\n  };\n  contextProvider.setValue<FsmInstance>(instanceId, newInstance, {debounce: 'NextCycle'});\n\n  _execAllActions(constructor, newInstance.state, finiteStateMachineConsumer(instanceId));\n};\n\n/**\n * Subscribe to all defined signals for finite state machine instance.\n */\nexport const subscribeSignals = (\n    instanceId: string,\n    signalList: Array<SignalConfig>,\n    subscribeConstructorSignals = true,\n): Array<ListenerSpec> => {\n  logger.logMethodArgs?.('subscribeSignals', {instanceId, signalList});\n  const listenerList: Array<ListenerSpec> = [];\n\n  if (subscribeConstructorSignals) {\n    signalList = signalList.concat(getFsmConstructor(getFsmInstance(instanceId).constructorId).signalList);\n  }\n\n  for (const signalConfig of signalList) {\n    signalConfig.signalId ??= instanceId;\n    listenerList.push(\n        contextConsumer.subscribe(\n            signalConfig.signalId,\n            (signalDetail: StringifyableRecord): void => {\n              logger.logMethodArgs?.('execSignalCallback', {instanceId, signalId: signalConfig.signalId, signalDetail});\n              if (signalConfig.callback) {\n                signalConfig.callback(signalDetail, finiteStateMachineConsumer(instanceId));\n              }\n              else {\n                // prettier-ignore\n                transition(\n                    instanceId,\n                    signalConfig.transition,\n                    signalConfig.contextName == null ? undefined : {\n                      [signalConfig.contextName]: signalDetail,\n                    },\n                );\n              }\n            },\n            {receivePrevious: signalConfig.receivePrevious ?? 'No'},\n        ),\n    );\n  }\n\n  return listenerList;\n};\n\n/**\n * Define signals for finite state machine constructor.\n */\nexport const defineConstructorSignals = <T extends FsmTypeHelper>(\n  constructorId: string,\n  signalList: Array<SignalConfig<T>>,\n): void => {\n  logger.logMethodArgs?.('defineSignals', {constructorId, signalList: signalList});\n  const fsmConstructor = getFsmConstructor(constructorId);\n  fsmConstructor.signalList = fsmConstructor.signalList.concat(signalList as Array<SignalConfig>);\n};\n\n/**\n * Define signals for finite state machine instance.\n */\nexport const defineInstanceSignals = <T extends FsmTypeHelper>(\n  instanceId: string,\n  signalList: Array<SignalConfig<T>>,\n  subscribeConstructorSignals = true,\n): Array<ListenerSpec> => {\n  logger.logMethodArgs?.('defineSignals', {instanceId, signals: signalList});\n  return subscribeSignals(instanceId, signalList as Array<SignalConfig>, subscribeConstructorSignals);\n};\n\n/**\n * Render helper for use finite state machine instance in UI.\n *\n * Example:\n *\n * ```ts\n * render('myFsm', {\n *   state1: () => html`<div>State 1 Render...</div>`,\n *   state2: () => html`<div>State 2 Render...</div>`,\n *   state3: 'state1',\n * });\n * ```\n */\nexport const render = <TState extends string = string>(\n  instanceId: string,\n  states: {[P in TState]: (() => unknown) | TState},\n  thisArg: unknown = null,\n): unknown => {\n  const state = getFsmInstance(instanceId).state;\n  logger.logMethodArgs?.('render', {instanceId, state: state.target});\n  let renderFn = states[state.target as TState];\n\n  if (typeof renderFn === 'string') {\n    renderFn = states[renderFn as TState];\n  }\n\n  if (typeof renderFn === 'function') {\n    return renderFn.call(thisArg);\n  }\n\n  return;\n};\n\n/**\n * Subscribe to finite state machine instance state changes.\n */\nexport const subscribe = (\n    instanceId: string,\n    callback: () => void,\n    options?: Partial<SubscribeOptions>,\n): ListenerSpec => {\n  logger.logMethodArgs?.('subscribe', instanceId);\n  return contextConsumer.subscribe(instanceId, callback, options);\n};\n\n/**\n * Destroy finite state machine instance object to clear memory.\n */\nexport const destroy = (instanceId: string): void => {\n  logger.logMethodArgs?.('destroy', instanceId);\n  destroySignal(instanceId);\n};\n\n/**\n * Reset finite state machine instance to initial state and context.\n */\nexport const reset = (instanceId: string): void => {\n  logger.logMethodArgs?.('reset', instanceId);\n  const constructorId = getFsmInstance(instanceId).constructorId;\n  // contextProvider.expire(instanceId);\n  initFsmInstance(instanceId, constructorId);\n};\n\n/**\n * Finite state machine instance consumer.\n * Lookup current finite state machine instance or initialize new one and return consumer object .\n */\n// eslint-disable-next-line @typescript-eslint/explicit-function-return-type\nexport const finiteStateMachineConsumer = <T extends FsmTypeHelper, TContext extends T['TContext'] = T['TContext']>(\n  instanceId: string,\n  makeFromConstructor?: string,\n) => {\n  logger.logMethodArgs?.('stateMachineLookup', instanceId);\n\n  const machineInstance = contextConsumer.getValue<FsmInstance>(instanceId);\n  if (machineInstance == null) {\n    // instance not initialized.\n    if (makeFromConstructor == null) {\n      throw new Error('fsm_undefined', {cause: {instanceId}});\n    }\n    initFsmInstance(instanceId, makeFromConstructor);\n  }\n\n  return {\n    /**\n     * Finite state machine instance id.\n     */\n    id: instanceId,\n\n    /**\n     * Finite state machine constructor id.\n     */\n    constructorId: <string>machineInstance?.constructorId ?? makeFromConstructor,\n\n    /**\n     * Render helper for use finite state machine instance in UI.\n     */\n    render: render.bind(null, instanceId) as OmitFirstParam<typeof render<T['TState']>>,\n\n    /**\n     * Subscribe to finite state machine instance state changes.\n     */\n    subscribe: subscribe.bind(null, instanceId) as OmitFirstParam<typeof subscribe>,\n\n    /**\n     * Unsubscribe from finite state machine instance state changes.\n     */\n    unsubscribe: unsubscribe,\n\n    /**\n     * Get current state of finite state machine instance.\n     */\n    getState: getState.bind(null, instanceId) as OmitFirstParam<typeof getState<T['TState'], T['TEventId']>>,\n\n    /**\n     * Get current context of finite state machine instance.\n     */\n    getContext: getContext.bind(null, instanceId) as OmitFirstParam<typeof getContext<TContext>>,\n\n    /**\n     * Set context of finite state machine instance.\n     */\n    setContext: setContext.bind(null, instanceId) as OmitFirstParam<typeof setContext<TContext>>,\n\n    /**\n     * Transition finite state machine instance to new state.\n     */\n    transition: transition.bind(null, instanceId) as OmitFirstParam<typeof transition<T['TEventId'], TContext>>,\n\n    /**\n     * Define signals for finite state machine instance.\n     */\n    defineSignals: defineInstanceSignals.bind(null, instanceId) as OmitFirstParam<typeof defineInstanceSignals<T>>,\n\n    /**\n     * Reset finite state machine instance to initial state and context.\n     */\n    reset: reset.bind(null, instanceId) as OmitFirstParam<typeof reset>,\n\n    /**\n     * Destroy finite state machine instance object to clear memory.\n     */\n    destroy: destroy.bind(null, instanceId) as OmitFirstParam<typeof destroy>,\n  } as const;\n};\n"]}

package/index.d.ts

@@ -0,0 +1,22 @@
+export { finiteStateMachineConsumer } from './core.js';
+/**
+ * Finite State Machine Provider.
+ */
+export declare const finiteStateMachineProvider: {
+    readonly defineConstructor: <TState extends string = string, TEventId extends string = string, TActionName extends string = string, TContext extends import("@alwatr/type").StringifyableRecord = import("@alwatr/type").StringifyableRecord>(id: string, config: import("./type.js").FsmConstructorConfig<TState, TEventId, TActionName, TContext>) => import("./type.js").FsmConstructorConfig<TState, TEventId, TActionName, TContext>;
+    readonly defineActions: <T extends Readonly<{
+        TState: string;
+        TEventId: string;
+        TActionName: string;
+        TContext: import("@alwatr/type").StringifyableRecord;
+    }>>(constructorId: string, actionRecord: import("./type.js").ActionRecord<T>) => void;
+    readonly defineSignals: <T_1 extends Readonly<{
+        TState: string;
+        TEventId: string;
+        TActionName: string;
+        TContext: import("@alwatr/type").StringifyableRecord;
+    }>>(constructorId: string, signalList: import("./type.js").SignalConfig<T_1>[]) => void;
+    readonly subscribe: (instanceId: string, callback: () => void, options?: Partial<import("@alwatr/signal/type.js").SubscribeOptions> | undefined) => import("@alwatr/signal").ListenerSpec;
+};
+export type { FsmTypeHelper, FsmConstructorConfig, FsmConsumerInterface } from './type.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,0BAA0B,EAAC,MAAM,WAAW,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;CAK7B,CAAC;AAEX,YAAY,EAAC,aAAa,EAAE,oBAAoB,EAAE,oBAAoB,EAAC,MAAM,WAAW,CAAC"}

package/index.js

@@ -0,0 +1,12 @@
+import { defineActions, defineConstructor, defineConstructorSignals, subscribe } from './core.js';
+export { finiteStateMachineConsumer } from './core.js';
+/**
+ * Finite State Machine Provider.
+ */
+export const finiteStateMachineProvider = {
+    defineConstructor,
+    defineActions,
+    defineSignals: defineConstructorSignals,
+    subscribe,
+};
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,SAAS,EAAC,MAAM,WAAW,CAAC;AAEhG,OAAO,EAAC,0BAA0B,EAAC,MAAM,WAAW,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,iBAAiB;IACjB,aAAa;IACb,aAAa,EAAE,wBAAwB;IACvC,SAAS;CACD,CAAC","sourcesContent":["import {defineActions, defineConstructor, defineConstructorSignals, subscribe} from './core.js';\n\nexport {finiteStateMachineConsumer} from './core.js';\n\n/**\n * Finite State Machine Provider.\n */\nexport const finiteStateMachineProvider = {\n  defineConstructor,\n  defineActions,\n  defineSignals: defineConstructorSignals,\n  subscribe,\n} as const;\n\nexport type {FsmTypeHelper, FsmConstructorConfig, FsmConsumerInterface} from './type.js';\n"]}

package/package.json

@@ -1,18 +1,21 @@
 {
   "name": "@alwatr/fsm",
-  "version": "0.30.0",
-  "description": "Managing invocations finite-state machines as actors written in tiny TypeScript module.",
+  "version": "0.31.0",
+  "description": "Managing invocations finite-state machines for lit-element written in tiny TypeScript module.",
   "keywords": [
     "state",
     "finite",
     "machine",
+    "lit",
+    "lit-element",
+    "lit-html",
     "typescript",
     "esm",
     "alwatr"
   ],
-  "main": "core.js",
+  "main": "index.js",
   "type": "module",
-  "types": "core.d.ts",
+  "types": "index.d.ts",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
   "license": "MIT",
   "files": [
@@ -31,10 +34,10 @@
     "url": "https://github.com/AliMD/alwatr/issues"
   },
   "dependencies": {
-    "@alwatr/logger": "^0.30.0",
-    "@alwatr/signal": "^0.30.0",
-    "@alwatr/type": "^0.30.0",
+    "@alwatr/logger": "^0.31.0",
+    "@alwatr/signal": "^0.31.0",
+    "@alwatr/type": "^0.31.0",
     "tslib": "^2.5.0"
   },
-  "gitHead": "36f55780ccdcb1acc07400b0cdb3fe7b0df56cca"
+  "gitHead": "896e64b58eed6e9048e870557ecf399d42705612"
 }

package/type.d.ts

@@ -0,0 +1,107 @@
+import type { finiteStateMachineConsumer } from './core.js';
+import type { DebounceType } from '@alwatr/signal';
+import type { ArrayItems, MaybePromise, SingleOrArray, StringifyableRecord } from '@alwatr/type';
+export interface FsmConstructor {
+    /**
+     * Constructor id.
+     */
+    readonly id: string;
+    readonly config: FsmConstructorConfig;
+    actionRecord: ActionRecord;
+    signalList: Array<SignalConfig>;
+}
+export interface FsmConstructorConfig<TState extends string = string, TEventId extends string = string, TActionName extends string = string, TContext extends StringifyableRecord = StringifyableRecord> extends StringifyableRecord {
+    /**
+     * Initial context.
+     */
+    readonly context: TContext;
+    /**
+     * Initial state.
+     */
+    readonly initial: TState;
+    /**
+     * Define state list
+     */
+    readonly stateRecord: StateRecord<TState, TEventId, TActionName>;
+}
+export type StateRecord<TState extends string = string, TEventId extends string = string, TActionName extends string = string> = {
+    readonly [S in TState | '$all']: {
+        /**
+         * On state exit actions
+         */
+        readonly exit?: SingleOrArray<TActionName>;
+        /**
+         * On state entry actions
+         */
+        readonly entry?: SingleOrArray<TActionName>;
+        /**
+         * An object mapping eventId to state.
+         *
+         * Example:
+         *
+         * ```ts
+         * stateRecord: {
+         *   on: {
+         *     TIMER: {
+         *       target: 'green',
+         *       condition: () => car.gas > 0,
+         *       actions: () => car.go(),
+         *     }
+         *   }
+         * }
+         * ```
+         */
+        readonly on: {
+            readonly [E in TEventId]?: TransitionConfig<TState, TActionName> | undefined;
+        };
+    };
+};
+export interface FsmState<TState extends string = string, TEventId extends string = string> extends StringifyableRecord {
+    /**
+     * Current state
+     */
+    target: TState;
+    /**
+     * Last state
+     */
+    from: TState;
+    /**
+     * Transition event
+     */
+    by: TEventId | 'INIT';
+}
+export interface TransitionConfig<TState extends string = string, TActionName extends string = string> extends StringifyableRecord {
+    readonly target?: TState;
+    readonly condition?: TActionName;
+    readonly actions?: SingleOrArray<TActionName>;
+}
+export interface FsmInstance<TState extends string = string, TEventId extends string = string, TContext extends StringifyableRecord = StringifyableRecord> extends StringifyableRecord {
+    readonly constructorId: string;
+    state: FsmState<TState, TEventId>;
+    context: TContext;
+}
+export type ActionRecord<T extends FsmTypeHelper = FsmTypeHelper> = {
+    readonly [P in T['TActionName']]?: (finiteStateMachine: FsmConsumerInterface<T>) => MaybePromise<void> | boolean;
+};
+export type SignalConfig<T extends FsmTypeHelper = FsmTypeHelper> = {
+    signalId?: string;
+    /**
+     * @default `No`
+     */
+    receivePrevious?: DebounceType;
+} & ({
+    transition: T['TEventId'];
+    contextName?: keyof T['TContext'];
+    callback?: never;
+} | {
+    callback: (detail: any, fsmInstance: FsmConsumerInterface<T>) => void;
+    transition?: never;
+});
+export type FsmTypeHelper<T extends FsmConstructorConfig = FsmConstructorConfig> = Readonly<{
+    TState: Exclude<keyof T['stateRecord'], '$all'>;
+    TEventId: keyof T['stateRecord'][FsmTypeHelper<T>['TState']]['on'];
+    TActionName: NonNullable<ArrayItems<T['stateRecord'][FsmTypeHelper<T>['TState']]['entry']>>;
+    TContext: T['context'];
+}>;
+export type FsmConsumerInterface<T extends FsmTypeHelper = FsmTypeHelper, TContext extends T['TContext'] = T['TContext']> = ReturnType<typeof finiteStateMachineConsumer<T, TContext>>;
+//# sourceMappingURL=type.d.ts.map

package/type.d.ts.map

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

package/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["src/type.ts"],"names":[],"mappings":"","sourcesContent":["import type {finiteStateMachineConsumer} from './core.js';\nimport type {DebounceType} from '@alwatr/signal';\nimport type {ArrayItems, MaybePromise, SingleOrArray, StringifyableRecord} from '@alwatr/type';\n\nexport interface FsmConstructor {\n  /**\n   * Constructor id.\n   */\n  readonly id: string;\n  readonly config: FsmConstructorConfig;\n  actionRecord: ActionRecord;\n  signalList: Array<SignalConfig>;\n}\n\nexport interface FsmConstructorConfig<\n  TState extends string = string,\n  TEventId extends string = string,\n  TActionName extends string = string,\n  TContext extends StringifyableRecord = StringifyableRecord\n> extends StringifyableRecord {\n  /**\n   * Initial context.\n   */\n  readonly context: TContext;\n\n  /**\n   * Initial state.\n   */\n  readonly initial: TState;\n\n  /**\n   * Define state list\n   */\n  readonly stateRecord: StateRecord<TState, TEventId, TActionName>;\n}\n\nexport type StateRecord<\n  TState extends string = string,\n  TEventId extends string = string,\n  TActionName extends string = string\n> = {\n  readonly [S in TState | '$all']: {\n    /**\n     * On state exit actions\n     */\n    readonly exit?: SingleOrArray<TActionName>;\n\n    /**\n     * On state entry actions\n     */\n    readonly entry?: SingleOrArray<TActionName>;\n\n    /**\n     * An object mapping eventId to state.\n     *\n     * Example:\n     *\n     * ```ts\n     * stateRecord: {\n     *   on: {\n     *     TIMER: {\n     *       target: 'green',\n     *       condition: () => car.gas > 0,\n     *       actions: () => car.go(),\n     *     }\n     *   }\n     * }\n     * ```\n     */\n    readonly on: {\n      readonly [E in TEventId]?: TransitionConfig<TState, TActionName> | undefined;\n    };\n  };\n};\n\nexport interface FsmState<TState extends string = string, TEventId extends string = string>\n  extends StringifyableRecord {\n  /**\n   * Current state\n   */\n  target: TState;\n  /**\n   * Last state\n   */\n  from: TState;\n  /**\n   * Transition event\n   */\n  by: TEventId | 'INIT';\n}\n\nexport interface TransitionConfig<TState extends string = string, TActionName extends string = string>\n  extends StringifyableRecord {\n  readonly target?: TState;\n  readonly condition?: TActionName;\n  readonly actions?: SingleOrArray<TActionName>;\n}\n\nexport interface FsmInstance<\n  TState extends string = string,\n  TEventId extends string = string,\n  TContext extends StringifyableRecord = StringifyableRecord\n> extends StringifyableRecord {\n  readonly constructorId: string;\n  state: FsmState<TState, TEventId>;\n  context: TContext;\n}\n\nexport type ActionRecord<T extends FsmTypeHelper = FsmTypeHelper> = {\n  readonly [P in T['TActionName']]?: (finiteStateMachine: FsmConsumerInterface<T>) => MaybePromise<void> | boolean;\n};\n\nexport type SignalConfig<T extends FsmTypeHelper = FsmTypeHelper> = {\n  signalId?: string;\n  /**\n   * @default `No`\n   */\n  receivePrevious?: DebounceType;\n} & (\n  | {\n      transition: T['TEventId'];\n      contextName?: keyof T['TContext'];\n      callback?: never;\n    }\n  | {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      callback: (detail: any, fsmInstance: FsmConsumerInterface<T>) => void;\n      transition?: never;\n    }\n);\n\n// type helper\nexport type FsmTypeHelper<T extends FsmConstructorConfig = FsmConstructorConfig> = Readonly<{\n  TState: Exclude<keyof T['stateRecord'], '$all'>;\n  TEventId: keyof T['stateRecord'][FsmTypeHelper<T>['TState']]['on'];\n  TActionName: NonNullable<ArrayItems<T['stateRecord'][FsmTypeHelper<T>['TState']]['entry']>>;\n  TContext: T['context'];\n}>;\n\nexport type FsmConsumerInterface<\n  T extends FsmTypeHelper = FsmTypeHelper,\n  TContext extends T['TContext'] = T['TContext']\n> = ReturnType<typeof finiteStateMachineConsumer<T, TContext>>;\n"]}