@uuxxx/fsm 1.1.0 → 1.2.0

package/dist/index.d.ts

@@ -4,6 +4,7 @@ type Rec<T = unknown> = Record<string, T>;
 type Key = string | number | symbol;
 type Vdx<T> = T | void;
 type KeyOf<T extends Rec> = keyof T;
+type EmptyArray = [];
 type Entries<T extends Rec> = { [K in KeyOf<T>]: [K, T[K]] }[KeyOf<T>];
 type Label = string;
 type Transition<TState extends Label> = {
@@ -22,29 +23,37 @@ type LifecycleMethods<TState extends Label, TTransitions extends Rec<Transition<
   onBeforeTransition?: CancelableLifecycleMethod<TState, TTransitions>;
   onAfterTransition?: LifecycleMethod<TState, TTransitions>;
 };
+type StateMethods<TState extends Label> = {
+  state: () => TState;
+  allStates: () => TState[];
+};
 type ApiForPlugin<TState extends Label, TTransitions extends Rec<Transition<TState>>> = {
   init: (listener: (state: TState) => void) => void;
-} & { [K in KeyOf<LifecycleMethods<TState, TTransitions>>]-?: (listener: LifecycleMethods<TState, TTransitions>[K]) => Noop };
+} & StateMethods<TState> & { [K in KeyOf<LifecycleMethods<TState, TTransitions>>]-?: (listener: LifecycleMethods<TState, TTransitions>[K]) => Noop };
 type PluginApi = {
   name: string;
   api: Rec<AnyFn>;
 };
 type Plugin<TState extends Label = Label, TTransitions extends Rec<Transition<TState>> = Rec<Transition<TState>>> = (api: ApiForPlugin<TState, TTransitions>) => PluginApi;
-type Config<TState extends Label, TTransitions extends Rec<Transition<TState>>, TPlugins extends Array<Plugin<TState, TTransitions>> = []> = {
+type Config<TState extends Label, TTransitions extends Rec<Transition<TState>>, TPlugins extends Array<Plugin<TState, TTransitions>> = EmptyArray> = {
   init: TState;
   states: TState[];
   transitions: TTransitions;
   methods?: LifecycleMethods<TState, TTransitions>;
   plugins?: TPlugins;
 };
-type StateMethods<TState extends Label> = {
-  state: () => TState;
-  allStates: () => TState[];
-};
 type TransitionMethods<TTransitions extends Rec<Transition<Label>>> = { [K in KeyOf<TTransitions>]: TTransitions[K]['to'] extends Label ? () => TTransitions[K]['to'] : TTransitions[K]['to'] };
 type PluginsMethods<TState extends Label, TTransitions extends Rec<Transition<TState>>, TPlugins extends Array<Plugin<TState, TTransitions>>> = { [K in ReturnType<TPlugins[number]>['name']]: Extract<ReturnType<TPlugins[number]>, {
   name: K;
 }>['api'] };
 type Methods<TState extends Label, TTransitions extends Rec<Transition<TState>>, TPlugins extends Array<Plugin<TState, TTransitions>>> = TransitionMethods<TTransitions> & StateMethods<TState> & PluginsMethods<TState, TTransitions, TPlugins>;
 declare const makeFsm: <TState extends Label, TTransitions extends Rec<Transition<TState>>, TPlugins extends Array<Plugin<TState, TTransitions>>>(config: Config<TState, TTransitions, TPlugins>) => Methods<TState, TTransitions, TPlugins>;
-export { makeFsm };
+declare const historyPlugin: <TState extends Label, TTransitions extends Rec<Transition<TState>>>() => (api: ApiForPlugin<TState, TTransitions>) => {
+  name: "history";
+  api: {
+    get(): Label[];
+    back(steps: number): Label;
+    forward(steps: number): Label;
+  };
+};
+export { type Config as FsmConfig, type Label as FsmLabel, type Plugin as FsmPlugin, type Transition as FsmTransition, historyPlugin as fsmHistoryPlugin, makeFsm };

package/dist/index.js

@@ -1 +1 @@
-let t={nlx:t=>null===t,ulx:t=>void 0===t,nil:e=>t.nlx(e)||t.ulx(e),not:{nlx:t=>null!==t,ulx:t=>void 0!==t,nil:e=>t.not.nlx(e)&&t.not.ulx(e)},array:t=>Array.isArray(t),string:t=>"string"==typeof t,function:t=>"function"==typeof t,promise:t=>t instanceof Promise,boolean:t=>"boolean"==typeof t,false:t=>!1===t,true:t=>!0===t};function e(t){return(e="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t})(t)}function r(t,e){var r=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter(function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable})),r.push.apply(r,n)}return r}function n(t){for(var n=1;n<arguments.length;n++){var i=null!=arguments[n]?arguments[n]:{};n%2?r(Object(i),!0).forEach(function(r){!function(t,r,n){var i;(i=function(t,r){if("object"!=e(t)||!t)return t;var n=t[Symbol.toPrimitive];if(void 0!==n){var i=n.call(t,r||"default");if("object"!=e(i))return i;throw TypeError("@@toPrimitive must return a primitive value.")}return("string"===r?String:Number)(t)}(r,"string"),(r="symbol"==e(i)?i:i+"")in t)?Object.defineProperty(t,r,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[r]=n}(t,r,i[r])}):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(i)):r(Object(i)).forEach(function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(i,e))})}return t}let i=e=>{var r,i,o,l;let s,a,u,f,c,m,p,b,y,g=e.init,v=(s=new Map,{listen(t,e){var r;return s.has(t)||s.set(t,[]),null==(r=s.get(t))||r.push(e),()=>{this.unlisten(t,e)}},unlisten(t,e){let r=s.get(t);if(!r)return;let n=r.filter(t=>t!==e);n.length?s.set(t,n):s.delete(t)},emit(e,...r){var n,i;return null!=(n=null==(i=s.get(e))?void 0:i.map(t=>t(...r)).filter(t.not.ulx))?n:[]},unlistenAll(t){s.delete(t)}});Object.entries(null!=(r=e.methods)?r:{}).forEach(([t,e])=>{v.listen(t,e)}),v.listen("onAfterTransition",({to:t})=>{g=t}),v.listen("error",t=>{throw Error(`[FSM]: ${t}`)});let O=(i=e.transitions,o=()=>g,u={},c=f={register(e,r){let n=e=>{v.emit("onBeforeTransition",e).filter(t.boolean).every(t.true)&&v.emit("onAfterTransition",e)};return u[e]=(...i)=>{if(t.array(r.from)?!r.from.includes(o()):"*"!==r.from&&r.from!==o())return v.emit("error",`Transition: ${e} is forbidden`),o();if(a)return v.emit("error",`Transition: ${e} can't be made. Has pending transtion: ${a}`),o();if(!t.function(r.to))return n({transition:e,from:o(),to:r.to}),o();let l=r.to(...i);return t.promise(l)?(a=e,l.then(t=>(a=void 0,n({transition:e,from:o(),to:t,args:i}),o()))):(n({transition:e,from:o(),to:l,args:i}),o())},f},make:()=>u},Object.entries(i).forEach(([t,e])=>c.register(t,e)),c.make()),h=(l=e.plugins,m={},p={init(t){v.listen("init",t)},onBeforeTransition:t=>v.listen("onBeforeTransition",t),onAfterTransition:t=>v.listen("onAfterTransition",t)},y=b={register(t){let{name:e,api:r}=t(p);return e in m&&v.emit("error",`There are at least two plugins with the same name: ${e}`),m[e]=r,b},make:()=>m},(null!=l?l:[]).forEach(y.register),y.make());return v.emit("init",g),n(n(n({},{state:()=>g,allStates:()=>[...e.states]}),h),O)};export{i as makeFsm};
+let t={nlx:t=>null===t,ulx:t=>void 0===t,nil:e=>t.nlx(e)||t.ulx(e),not:{nlx:t=>null!==t,ulx:t=>void 0!==t,nil:e=>t.not.nlx(e)&&t.not.ulx(e)},array:t=>Array.isArray(t),string:t=>"string"==typeof t,function:t=>"function"==typeof t,promise:t=>t instanceof Promise,boolean:t=>"boolean"==typeof t,false:t=>!1===t,true:t=>!0===t};function e(t){return(e="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t})(t)}function r(t,e){var r=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter(function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable})),r.push.apply(r,n)}return r}function n(t){for(var n=1;n<arguments.length;n++){var i=null!=arguments[n]?arguments[n]:{};n%2?r(Object(i),!0).forEach(function(r){!function(t,r,n){var i;(i=function(t,r){if("object"!=e(t)||!t)return t;var n=t[Symbol.toPrimitive];if(void 0!==n){var i=n.call(t,r||"default");if("object"!=e(i))return i;throw TypeError("@@toPrimitive must return a primitive value.")}return("string"===r?String:Number)(t)}(r,"string"),(r="symbol"==e(i)?i:i+"")in t)?Object.defineProperty(t,r,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[r]=n}(t,r,i[r])}):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(i)):r(Object(i)).forEach(function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(i,e))})}return t}let i=e=>{var r,i,o,l;let s,a,u,f,m,c,p,y,b,g=e.init,h=(s=new Map,{listen(t,e){var r;return s.has(t)||s.set(t,[]),null==(r=s.get(t))||r.push(e),()=>{this.unlisten(t,e)}},unlisten(t,e){let r=s.get(t);if(!r)return;let n=r.filter(t=>t!==e);n.length?s.set(t,n):s.delete(t)},emit(e,...r){var n,i;return null!=(n=null==(i=s.get(e))?void 0:i.map(t=>t(...r)).filter(t.not.ulx))?n:[]},unlistenAll(t){s.delete(t)}});Object.entries(null!=(r=e.methods)?r:{}).forEach(([t,e])=>{h.listen(t,e)}),h.listen("onAfterTransition",({to:t})=>{g=t}),h.listen("error",t=>{throw Error(`[FSM]: ${t}`)});let v={state:()=>g,allStates:()=>[...e.states]},O=(i=e.transitions,o=v.state,u={},m=f={register(e,r){let n=e=>{h.emit("onBeforeTransition",e).filter(t.boolean).every(t.true)&&h.emit("onAfterTransition",e)};return u[e]=(...i)=>{if(t.array(r.from)?!r.from.includes(o()):"*"!==r.from&&r.from!==o())return h.emit("error",`Transition: ${e} is forbidden`),o();if(a)return h.emit("error",`Transition: ${e} can't be made. Has pending transtion: ${a}`),o();if(!t.function(r.to))return n({transition:e,from:o(),to:r.to}),o();let l=r.to(...i);return t.promise(l)?(a=e,l.then(t=>(a=void 0,n({transition:e,from:o(),to:t,args:i}),o()))):(n({transition:e,from:o(),to:l,args:i}),o())},f},make:()=>u},Object.entries(i).forEach(([t,e])=>m.register(t,e)),m.make()),d=(l=e.plugins,c={},p=n({init(t){h.listen("init",t)},onBeforeTransition:t=>h.listen("onBeforeTransition",t),onAfterTransition:t=>h.listen("onAfterTransition",t)},v),b=y={register(t){let{name:e,api:r}=t(p);return e in c&&h.emit("error",`There are at least two plugins with the same name: ${e}`),c[e]=r,y},make:()=>c},(null!=l?l:[]).forEach(b.register),b.make());return h.emit("init",g),n(n(n({},v),d),O)},o=()=>t=>{let e=[],r=0;return t.init(t=>e.push(t)),t.onAfterTransition(({to:t})=>{r++,e.splice(r,e.length-r,t)}),{name:"history",api:{get:()=>e,back:t=>e[r=Math.max(0,r-t)],forward:t=>(r=Math.min(e.length-1,r+t),e[r])}}};export{o as fsmHistoryPlugin,i as makeFsm};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uuxxx/fsm",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "author": "Artem Tryapichnikov <golysheeet@gmail.com>",
   "license": "MIT",
   "description": "Javascript library for creating finite state machine",