xstate 4.10.0 → 4.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/CHANGELOG.md +205 -0
  2. package/LICENSE +22 -0
  3. package/README.md +2 -2
  4. package/dist/xstate.interpreter.js +1 -1
  5. package/dist/xstate.js +1 -1
  6. package/dist/xstate.web.js +2 -2
  7. package/es/Actor.d.ts +5 -3
  8. package/es/Actor.js +26 -4
  9. package/es/State.d.ts +5 -2
  10. package/es/StateNode.d.ts +8 -8
  11. package/es/StateNode.js +61 -41
  12. package/es/actions.d.ts +9 -5
  13. package/es/actions.js +28 -13
  14. package/es/index.d.ts +2 -2
  15. package/es/index.js +1 -1
  16. package/es/interpreter.d.ts +29 -15
  17. package/es/interpreter.js +99 -112
  18. package/es/invokeUtils.d.ts +7 -0
  19. package/es/invokeUtils.js +39 -0
  20. package/es/match.d.ts +4 -1
  21. package/es/serviceScope.d.ts +10 -0
  22. package/es/serviceScope.js +18 -0
  23. package/es/stateUtils.d.ts +1 -1
  24. package/es/types.d.ts +79 -32
  25. package/es/utils.d.ts +4 -3
  26. package/es/utils.js +12 -3
  27. package/lib/Actor.d.ts +5 -3
  28. package/lib/Actor.js +24 -3
  29. package/lib/Machine.js +1 -0
  30. package/lib/SimulatedClock.js +1 -0
  31. package/lib/State.d.ts +5 -2
  32. package/lib/State.js +1 -0
  33. package/lib/StateNode.d.ts +8 -8
  34. package/lib/StateNode.js +69 -42
  35. package/lib/actionTypes.js +1 -0
  36. package/lib/actions.d.ts +9 -5
  37. package/lib/actions.js +27 -19
  38. package/lib/constants.js +1 -0
  39. package/lib/devTools.js +1 -0
  40. package/lib/each.js +1 -0
  41. package/lib/environment.js +1 -0
  42. package/lib/index.d.ts +2 -2
  43. package/lib/index.js +29 -20
  44. package/lib/interpreter.d.ts +28 -14
  45. package/lib/interpreter.js +82 -88
  46. package/lib/invokeUtils.d.ts +7 -0
  47. package/lib/invokeUtils.js +42 -0
  48. package/lib/json.js +1 -0
  49. package/lib/mapState.js +1 -0
  50. package/lib/match.d.ts +4 -1
  51. package/lib/match.js +1 -0
  52. package/lib/patterns.js +1 -0
  53. package/lib/registry.js +1 -0
  54. package/lib/scheduler.js +1 -0
  55. package/lib/scxml.js +1 -0
  56. package/lib/serviceScope.d.ts +10 -0
  57. package/lib/serviceScope.js +15 -0
  58. package/lib/stateUtils.d.ts +1 -1
  59. package/lib/stateUtils.js +1 -0
  60. package/lib/types.d.ts +79 -32
  61. package/lib/types.js +1 -0
  62. package/lib/utils.d.ts +4 -3
  63. package/lib/utils.js +9 -2
  64. package/package.json +6 -6
package/lib/registry.js CHANGED
@@ -1,5 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.registry = void 0;
3
4
  var children = new Map();
4
5
  var sessionIdIndex = 0;
5
6
  exports.registry = {
package/lib/scheduler.js CHANGED
@@ -11,6 +11,7 @@ var __assign = (this && this.__assign) || function () {
11
11
  return __assign.apply(this, arguments);
12
12
  };
13
13
  Object.defineProperty(exports, "__esModule", { value: true });
14
+ exports.Scheduler = void 0;
14
15
  var defaultOptions = {
15
16
  deferEvents: false
16
17
  };
package/lib/scxml.js CHANGED
@@ -42,6 +42,7 @@ var __values = (this && this.__values) || function(o) {
42
42
  throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
43
43
  };
44
44
  Object.defineProperty(exports, "__esModule", { value: true });
45
+ exports.toMachine = void 0;
45
46
  var xml_js_1 = require("xml-js");
46
47
  var index_1 = require("./index");
47
48
  var utils_1 = require("./utils");
@@ -0,0 +1,10 @@
1
+ import { Interpreter } from './interpreter';
2
+ export declare const provide: <T, TService extends Interpreter<any, any, any, {
3
+ value: any;
4
+ context: any;
5
+ }>>(service: TService | undefined, fn: (service: TService | undefined) => T) => T;
6
+ export declare const consume: <T, TService extends Interpreter<any, any, any, {
7
+ value: any;
8
+ context: any;
9
+ }>>(fn: (service: TService) => T) => T;
10
+ //# sourceMappingURL=serviceScope.d.ts.map
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.consume = exports.provide = void 0;
4
+ /**
5
+ * Maintains a stack of the current service in scope.
6
+ * This is used to provide the correct service to spawn().
7
+ */
8
+ var serviceStack = [];
9
+ exports.provide = function (service, fn) {
10
+ serviceStack.push(service);
11
+ var result = fn(service);
12
+ serviceStack.pop();
13
+ return result;
14
+ };
15
+ exports.consume = function (fn) { return fn(serviceStack[serviceStack.length - 1]); };
@@ -1,7 +1,7 @@
1
1
  import { EventObject, StateNode, StateValue } from '.';
2
2
  declare type Configuration<TC, TE extends EventObject> = Iterable<StateNode<TC, any, TE>>;
3
3
  declare type AdjList<TC, TE extends EventObject> = Map<StateNode<TC, any, TE>, Array<StateNode<TC, any, TE>>>;
4
- export declare const isLeafNode: (stateNode: StateNode<any, any, any, any>) => boolean;
4
+ export declare const isLeafNode: (stateNode: StateNode<any, any, any>) => boolean;
5
5
  export declare function getChildren<TC, TE extends EventObject>(stateNode: StateNode<TC, any, TE>): Array<StateNode<TC, any, TE>>;
6
6
  export declare function getAllStateNodes<TC, TE extends EventObject>(stateNode: StateNode<TC, any, TE>): Array<StateNode<TC, any, TE>>;
7
7
  export declare function getConfiguration<TC, TE extends EventObject>(prevStateNodes: Iterable<StateNode<TC, any, TE>>, stateNodes: Iterable<StateNode<TC, any, TE>>): Iterable<StateNode<TC, any, TE>>;
package/lib/stateUtils.js CHANGED
@@ -31,6 +31,7 @@ var __spread = (this && this.__spread) || function () {
31
31
  return ar;
32
32
  };
33
33
  Object.defineProperty(exports, "__esModule", { value: true });
34
+ exports.isInFinalState = exports.nextEvents = exports.has = exports.getValue = exports.getAdjList = exports.getConfiguration = exports.getAllStateNodes = exports.getChildren = exports.isLeafNode = void 0;
34
35
  var utils_1 = require("./utils");
35
36
  exports.isLeafNode = function (stateNode) {
36
37
  return stateNode.type === 'atomic' || stateNode.type === 'final';
package/lib/types.d.ts CHANGED
@@ -49,12 +49,12 @@ export interface AssignMeta<TContext, TEvent extends EventObject> {
49
49
  action: AssignAction<TContext, TEvent>;
50
50
  _event: SCXML.Event<TEvent>;
51
51
  }
52
- export declare type ActionFunction<TContext, TEvent extends EventObject> = (context: TContext, event: TEvent, meta: ActionMeta<TContext, TEvent>) => any | void;
52
+ export declare type ActionFunction<TContext, TEvent extends EventObject> = (context: TContext, event: TEvent, meta: ActionMeta<TContext, TEvent>) => void;
53
53
  export interface ChooseConditon<TContext, TEvent extends EventObject> {
54
54
  cond?: Condition<TContext, TEvent>;
55
55
  actions: Actions<TContext, TEvent>;
56
56
  }
57
- export declare type Action<TContext, TEvent extends EventObject> = ActionType | ActionObject<TContext, TEvent> | ActionFunction<TContext, TEvent> | AssignAction<Required<TContext>, TEvent> | SendAction<TContext, TEvent, AnyEventObject> | RaiseAction<AnyEventObject> | ChooseAction<TContext, TEvent>;
57
+ export declare type Action<TContext, TEvent extends EventObject> = ActionType | ActionObject<TContext, TEvent> | ActionFunction<TContext, TEvent>;
58
58
  export declare type Actions<TContext, TEvent extends EventObject> = SingleOrArray<Action<TContext, TEvent>>;
59
59
  export declare type StateKey = string | State<any>;
60
60
  export interface StateValueMap {
@@ -67,11 +67,14 @@ export interface StateValueMap {
67
67
  * - For complex state nodes, this is an object, e.g., `{ success: "someChildState" }`.
68
68
  */
69
69
  export declare type StateValue = string | StateValueMap;
70
- export declare type ExtractStateValue<TS extends StateSchema<any>, TSS = TS['states']> = TSS extends undefined ? never : {
71
- [K in keyof TSS]?: (TSS[K] extends {
72
- states: any;
73
- } ? keyof TSS[K]['states'] : never) | ExtractStateValue<TSS[K]>;
74
- };
70
+ declare type KeysWithStates<TStates extends Record<string, StateSchema> | undefined> = TStates extends object ? {
71
+ [K in keyof TStates]-?: TStates[K] extends {
72
+ states: object;
73
+ } ? K : never;
74
+ }[keyof TStates] : never;
75
+ export declare type ExtractStateValue<TSchema extends Required<Pick<StateSchema<any>, 'states'>>> = keyof TSchema['states'] | (KeysWithStates<TSchema['states']> extends never ? never : {
76
+ [K in KeysWithStates<TSchema['states']>]?: ExtractStateValue<TSchema['states'][K]>;
77
+ });
75
78
  export interface HistoryValue {
76
79
  states: Record<string, HistoryValue | undefined>;
77
80
  current: StateValue | undefined;
@@ -113,8 +116,30 @@ export interface ActivityDefinition<TContext, TEvent extends EventObject> extend
113
116
  type: string;
114
117
  }
115
118
  export declare type Sender<TEvent extends EventObject> = (event: Event<TEvent>) => void;
119
+ declare type ExcludeType<A> = {
120
+ [K in Exclude<keyof A, 'type'>]: A[K];
121
+ };
122
+ declare type ExtractExtraParameters<A, T> = A extends {
123
+ type: T;
124
+ } ? ExcludeType<A> : never;
125
+ declare type ExtractSimple<A> = A extends any ? {} extends ExcludeType<A> ? A : never : never;
126
+ declare type NeverIfEmpty<T> = {} extends T ? never : T;
127
+ export interface PayloadSender<TEvent extends EventObject> {
128
+ /**
129
+ * Send an event object or just the event type, if the event has no other payload
130
+ */
131
+ (event: TEvent | ExtractSimple<TEvent>['type']): void;
132
+ /**
133
+ * Send an event type and its payload
134
+ */
135
+ <K extends TEvent['type']>(eventType: K, payload: NeverIfEmpty<ExtractExtraParameters<TEvent, K>>): void;
136
+ }
116
137
  export declare type Receiver<TEvent extends EventObject> = (listener: (event: TEvent) => void) => void;
117
138
  export declare type InvokeCallback = (callback: Sender<any>, onReceive: Receiver<EventObject>) => any;
139
+ export interface InvokeMeta {
140
+ data: any;
141
+ src: InvokeSourceDefinition;
142
+ }
118
143
  /**
119
144
  * Returns either a Promises or a callback handler (for streams of events) given the
120
145
  * machine's current `context` and `event` that invoked the service.
@@ -128,12 +153,12 @@ export declare type InvokeCallback = (callback: Sender<any>, onReceive: Receiver
128
153
  * @param context The current machine `context`
129
154
  * @param event The event that invoked the service
130
155
  */
131
- export declare type InvokeCreator<TContext, TEvent = AnyEventObject, TFinalContext = any> = (context: TContext, event: TEvent) => PromiseLike<TFinalContext> | StateMachine<TFinalContext, any, any> | Subscribable<any> | InvokeCallback;
156
+ export declare type InvokeCreator<TContext, TEvent = AnyEventObject, TFinalContext = any> = (context: TContext, event: TEvent, meta: InvokeMeta) => PromiseLike<TFinalContext> | StateMachine<TFinalContext, any, any> | Subscribable<any> | InvokeCallback;
132
157
  export interface InvokeDefinition<TContext, TEvent extends EventObject> extends ActivityDefinition<TContext, TEvent> {
133
158
  /**
134
159
  * The source of the machine to be invoked, or the machine itself.
135
160
  */
136
- src: string;
161
+ src: string | InvokeSourceDefinition;
137
162
  /**
138
163
  * If `true`, events sent to the parent service will be forwarded to the invoked service.
139
164
  *
@@ -152,7 +177,7 @@ export interface InvokeDefinition<TContext, TEvent extends EventObject> extends
152
177
  *
153
178
  * Data should be mapped to match the child machine's context shape.
154
179
  */
155
- data?: Mapper<TContext, TEvent> | PropertyMapper<TContext, TEvent>;
180
+ data?: Mapper<TContext, TEvent, any> | PropertyMapper<TContext, TEvent, any>;
156
181
  }
157
182
  export interface Delay {
158
183
  id: string;
@@ -186,18 +211,18 @@ declare type TransitionsConfigMap<TContext, TEvent extends EventObject> = {
186
211
  } & {
187
212
  '*'?: TransitionConfigOrTarget<TContext, TEvent>;
188
213
  };
189
- declare type TransitionsConfigArray<TContext, TEvent extends EventObject> = Array<{
190
- [K in TEvent['type']]: TransitionConfig<TContext, TEvent extends {
191
- type: K;
192
- } ? TEvent : never> & {
193
- event: K;
194
- };
195
- }[TEvent['type']] | (TransitionConfig<TContext, TEvent> & {
214
+ declare type TransitionsConfigArray<TContext, TEvent extends EventObject> = Array<(TEvent extends EventObject ? TransitionConfig<TContext, TEvent> & {
215
+ event: TEvent['type'];
216
+ } : never) | (TransitionConfig<TContext, TEvent> & {
196
217
  event: '';
197
218
  }) | (TransitionConfig<TContext, TEvent> & {
198
219
  event: '*';
199
220
  })>;
200
221
  export declare type TransitionsConfig<TContext, TEvent extends EventObject> = TransitionsConfigMap<TContext, TEvent> | TransitionsConfigArray<TContext, TEvent>;
222
+ export interface InvokeSourceDefinition {
223
+ [key: string]: any;
224
+ type: string;
225
+ }
201
226
  export declare type InvokeConfig<TContext, TEvent extends EventObject> = {
202
227
  /**
203
228
  * The unique identifier for the invoked machine. If not specified, this
@@ -207,7 +232,7 @@ export declare type InvokeConfig<TContext, TEvent extends EventObject> = {
207
232
  /**
208
233
  * The source of the machine to be invoked, or the machine itself.
209
234
  */
210
- src: string | StateMachine<any, any, any> | InvokeCreator<TContext, TEvent, any>;
235
+ src: string | InvokeSourceDefinition | StateMachine<any, any, any> | InvokeCreator<TContext, TEvent, any>;
211
236
  /**
212
237
  * If `true`, events sent to the parent service will be forwarded to the invoked service.
213
238
  *
@@ -226,7 +251,7 @@ export declare type InvokeConfig<TContext, TEvent extends EventObject> = {
226
251
  *
227
252
  * Data should be mapped to match the child machine's context shape.
228
253
  */
229
- data?: Mapper<TContext, TEvent> | PropertyMapper<TContext, TEvent>;
254
+ data?: Mapper<TContext, TEvent, any> | PropertyMapper<TContext, TEvent, any>;
230
255
  /**
231
256
  * The transition to take upon the invoked child machine reaching its final top-level state.
232
257
  */
@@ -235,7 +260,7 @@ export declare type InvokeConfig<TContext, TEvent extends EventObject> = {
235
260
  * The transition to take upon the invoked child machine sending an error event.
236
261
  */
237
262
  onError?: string | SingleOrArray<TransitionConfig<TContext, DoneInvokeEvent<any>>>;
238
- } | StateMachine<any, any, any>;
263
+ };
239
264
  export interface StateNodeConfig<TContext, TStateSchema extends StateSchema, TEvent extends EventObject> {
240
265
  /**
241
266
  * The relative key of the state node, which represents its location in the overall state value.
@@ -279,7 +304,7 @@ export interface StateNodeConfig<TContext, TStateSchema extends StateSchema, TEv
279
304
  /**
280
305
  * The services to invoke upon entering this state node. These services will be stopped upon exiting this state node.
281
306
  */
282
- invoke?: SingleOrArray<InvokeConfig<TContext, TEvent>>;
307
+ invoke?: SingleOrArray<InvokeConfig<TContext, TEvent> | StateMachine<any, any, any>>;
283
308
  /**
284
309
  * The mapping of event types to their potential transition(s).
285
310
  */
@@ -315,6 +340,11 @@ export interface StateNodeConfig<TContext, TStateSchema extends StateSchema, TEv
315
340
  * The delayed transitions are taken after the specified delay in an interpreter.
316
341
  */
317
342
  after?: DelayedTransitions<TContext, TEvent>;
343
+ /**
344
+ * An eventless transition that is always taken when this state node is active.
345
+ * Equivalent to a transition specified as an empty `''`' string in the `on` property.
346
+ */
347
+ always?: TransitionConfigOrTarget<TContext, TEvent>;
318
348
  /**
319
349
  * The activities to be started upon entering the state node,
320
350
  * and stopped upon exiting the state node.
@@ -337,7 +367,7 @@ export interface StateNodeConfig<TContext, TStateSchema extends StateSchema, TEv
337
367
  * The data will be evaluated with the current `context` and placed on the `.data` property
338
368
  * of the event.
339
369
  */
340
- data?: Mapper<TContext, TEvent> | PropertyMapper<TContext, TEvent>;
370
+ data?: Mapper<TContext, TEvent, any> | PropertyMapper<TContext, TEvent, any>;
341
371
  /**
342
372
  * The unique ID of the state node, which can be referenced as a transition target via the
343
373
  * `#id` syntax.
@@ -388,18 +418,18 @@ export interface FinalStateNodeConfig<TContext, TEvent extends EventObject> exte
388
418
  * The data to be sent with the "done.state.<id>" event. The data can be
389
419
  * static or dynamic (based on assigners).
390
420
  */
391
- data?: Assigner<TContext, TEvent> | PropertyAssigner<TContext, TEvent> | any;
421
+ data?: Mapper<TContext, TEvent, any> | PropertyMapper<TContext, TEvent, any>;
392
422
  }
393
423
  export declare type SimpleOrStateNodeConfig<TContext, TStateSchema extends StateSchema, TEvent extends EventObject> = AtomicStateNodeConfig<TContext, TEvent> | StateNodeConfig<TContext, TStateSchema, TEvent>;
394
424
  export declare type ActionFunctionMap<TContext, TEvent extends EventObject> = Record<string, ActionObject<TContext, TEvent> | ActionFunction<TContext, TEvent>>;
395
425
  export declare type DelayFunctionMap<TContext, TEvent extends EventObject> = Record<string, DelayConfig<TContext, TEvent>>;
396
- export declare type ServiceConfig<TContext> = string | StateMachine<any, any, any> | InvokeCreator<TContext>;
426
+ export declare type ServiceConfig<TContext, TEvent extends EventObject = AnyEventObject> = string | StateMachine<any, any, any> | InvokeCreator<TContext, TEvent>;
397
427
  export declare type DelayConfig<TContext, TEvent extends EventObject> = number | DelayExpr<TContext, TEvent>;
398
428
  export interface MachineOptions<TContext, TEvent extends EventObject> {
399
429
  guards: Record<string, ConditionPredicate<TContext, TEvent>>;
400
430
  actions: ActionFunctionMap<TContext, TEvent>;
401
431
  activities: Record<string, ActivityConfig<TContext, TEvent>>;
402
- services: Record<string, ServiceConfig<TContext>>;
432
+ services: Record<string, ServiceConfig<TContext, TEvent>>;
403
433
  delays: DelayFunctionMap<TContext, TEvent>;
404
434
  /**
405
435
  * @private
@@ -434,7 +464,10 @@ export interface HistoryStateNode<TContext> extends StateNode<TContext> {
434
464
  history: 'shallow' | 'deep';
435
465
  target: StateValue | undefined;
436
466
  }
437
- export interface StateMachine<TContext, TStateSchema extends StateSchema, TEvent extends EventObject, TTypestate extends Typestate<TContext> = any> extends StateNode<TContext, TStateSchema, TEvent, TTypestate> {
467
+ export interface StateMachine<TContext, TStateSchema extends StateSchema, TEvent extends EventObject, TTypestate extends Typestate<TContext> = {
468
+ value: any;
469
+ context: TContext;
470
+ }> extends StateNode<TContext, TStateSchema, TEvent, TTypestate> {
438
471
  id: string;
439
472
  states: StateNode<TContext, TStateSchema, TEvent>['states'];
440
473
  }
@@ -526,7 +559,7 @@ export interface NullEvent {
526
559
  }
527
560
  export interface ActivityActionObject<TContext, TEvent extends EventObject> extends ActionObject<TContext, TEvent> {
528
561
  type: ActionTypes.Start | ActionTypes.Stop;
529
- activity: ActivityDefinition<TContext, TEvent>;
562
+ activity: ActivityDefinition<TContext, TEvent> | undefined;
530
563
  exec: ActionFunction<TContext, TEvent> | undefined;
531
564
  }
532
565
  export interface InvokeActionObject<TContext, TEvent extends EventObject> extends ActivityActionObject<TContext, TEvent> {
@@ -554,6 +587,20 @@ export interface SendActionObject<TContext, TEvent extends EventObject, TSentEve
554
587
  delay?: number;
555
588
  id: string | number;
556
589
  }
590
+ export interface StopAction<TContext, TEvent extends EventObject> extends ActionObject<TContext, TEvent> {
591
+ type: ActionTypes.Stop;
592
+ activity: string | {
593
+ id: string;
594
+ } | Expr<TContext, TEvent, string | {
595
+ id: string;
596
+ }>;
597
+ }
598
+ export interface StopActionObject {
599
+ type: ActionTypes.Stop;
600
+ activity: {
601
+ id: string;
602
+ };
603
+ }
557
604
  export declare type Expr<TContext, TEvent extends EventObject, T> = (context: TContext, event: TEvent) => T;
558
605
  export declare type ExprWithMeta<TContext, TEvent extends EventObject, T> = (context: TContext, event: TEvent, meta: SCXMLEventMeta<TEvent>) => T;
559
606
  export declare type SendExpr<TContext, TEvent extends EventObject, TSentEvent extends EventObject = AnyEventObject> = ExprWithMeta<TContext, TEvent, TSentEvent>;
@@ -573,10 +620,10 @@ export declare type Assigner<TContext, TEvent extends EventObject> = (context: T
573
620
  export declare type PropertyAssigner<TContext, TEvent extends EventObject> = {
574
621
  [K in keyof TContext]?: ((context: TContext, event: TEvent, meta: AssignMeta<TContext, TEvent>) => TContext[K]) | TContext[K];
575
622
  };
576
- export declare type Mapper<TContext, TEvent extends EventObject> = (context: TContext, event: TEvent) => any;
577
- export declare type PropertyMapper<TContext, TEvent extends EventObject> = Partial<{
578
- [key: string]: ((context: TContext, event: TEvent) => any) | any;
579
- }>;
623
+ export declare type Mapper<TContext, TEvent extends EventObject, TParams extends {}> = (context: TContext, event: TEvent) => TParams;
624
+ export declare type PropertyMapper<TContext, TEvent extends EventObject, TParams extends {}> = {
625
+ [K in keyof TParams]?: ((context: TContext, event: TEvent) => TParams[K]) | TParams[K];
626
+ };
580
627
  export interface AnyAssignAction<TContext, TEvent extends EventObject> extends ActionObject<TContext, TEvent> {
581
628
  type: ActionTypes.Assign;
582
629
  assignment: any;
@@ -795,7 +842,7 @@ export declare namespace SCXML {
795
842
  }
796
843
  }
797
844
  export interface Unsubscribable {
798
- unsubscribe(): any | void;
845
+ unsubscribe(): void;
799
846
  }
800
847
  export interface Subscribable<T> {
801
848
  subscribe(next?: (value: T) => void, error?: (error: any) => void, complete?: () => void): Unsubscribable;
package/lib/types.js CHANGED
@@ -1,5 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SpecialTargets = exports.ActionTypes = void 0;
3
4
  var ActionTypes;
4
5
  (function (ActionTypes) {
5
6
  ActionTypes["Start"] = "xstate.start";
package/lib/utils.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { Event, StateValue, ActionType, Action, EventObject, PropertyMapper, Mapper, EventType, HistoryValue, AssignAction, Condition, Subscribable, StateMachine, ConditionPredicate, SCXML, StateLike, EventData, TransitionConfig, TransitionConfigTarget, NullEvent, SingleOrArray, Guard } from './types';
1
+ import { Event, StateValue, ActionType, Action, EventObject, PropertyMapper, Mapper, EventType, HistoryValue, AssignAction, Condition, Subscribable, StateMachine, ConditionPredicate, SCXML, StateLike, EventData, TransitionConfig, TransitionConfigTarget, NullEvent, SingleOrArray, Guard, InvokeSourceDefinition } from './types';
2
2
  import { StateNode } from './StateNode';
3
3
  import { State } from '.';
4
4
  import { Actor } from './Actor';
@@ -39,7 +39,7 @@ export declare function pathsToStateValue(paths: string[][]): StateValue;
39
39
  export declare function flatten<T>(array: Array<T | T[]>): T[];
40
40
  export declare function toArrayStrict<T>(value: T[] | T): T[];
41
41
  export declare function toArray<T>(value: T[] | T | undefined): T[];
42
- export declare function mapContext<TContext, TEvent extends EventObject>(mapper: Mapper<TContext, TEvent> | PropertyMapper<TContext, TEvent>, context: TContext, _event: SCXML.Event<TEvent>): any;
42
+ export declare function mapContext<TContext, TEvent extends EventObject>(mapper: Mapper<TContext, TEvent, any> | PropertyMapper<TContext, TEvent, any>, context: TContext, _event: SCXML.Event<TEvent>): any;
43
43
  export declare function isBuiltInEvent(eventType: EventType): boolean;
44
44
  export declare function isPromiseLike(value: any): value is PromiseLike<any>;
45
45
  export declare function partition<T, A extends T, B extends T>(items: T[], predicate: (item: T) => item is A): [A[], B[]];
@@ -52,7 +52,7 @@ export declare function isArray(value: any): value is any[];
52
52
  export declare function isFunction(value: any): value is Function;
53
53
  export declare function isString(value: any): value is string;
54
54
  export declare function toGuard<TContext, TEvent extends EventObject>(condition?: Condition<TContext, TEvent>, guardMap?: Record<string, ConditionPredicate<TContext, TEvent>>): Guard<TContext, TEvent> | undefined;
55
- export declare function isObservable<T>(value: Subscribable<T> | any): value is Subscribable<T>;
55
+ export declare function isObservable<T>(value: any): value is Subscribable<T>;
56
56
  export declare const symbolObservable: string | symbol;
57
57
  export declare function isMachine(value: any): value is StateMachine<any, any, any>;
58
58
  export declare function isActor(value: any): value is Actor;
@@ -65,4 +65,5 @@ export declare function toTransitionConfigArray<TContext, TEvent extends EventOb
65
65
  export declare function normalizeTarget<TContext, TEvent extends EventObject>(target: SingleOrArray<string | StateNode<TContext, any, TEvent>> | undefined): Array<string | StateNode<TContext, any, TEvent>> | undefined;
66
66
  export declare function reportUnhandledExceptionOnInvocation(originalError: any, currentError: any, id: string): void;
67
67
  export declare function evaluateGuard<TContext, TEvent extends EventObject>(machine: StateNode<TContext, any, TEvent>, guard: Guard<TContext, TEvent>, context: TContext, _event: SCXML.Event<TEvent>, state: State<TContext, TEvent>): boolean;
68
+ export declare function toInvokeSource(src: string | InvokeSourceDefinition): InvokeSourceDefinition;
68
69
  //# sourceMappingURL=utils.d.ts.map
package/lib/utils.js CHANGED
@@ -42,6 +42,7 @@ var __spread = (this && this.__spread) || function () {
42
42
  return ar;
43
43
  };
44
44
  Object.defineProperty(exports, "__esModule", { value: true });
45
+ exports.toInvokeSource = exports.evaluateGuard = exports.reportUnhandledExceptionOnInvocation = exports.normalizeTarget = exports.toTransitionConfigArray = exports.toSCXMLEvent = exports.toEventObject = exports.uniqueId = exports.isActor = exports.isMachine = exports.symbolObservable = exports.isObservable = exports.toGuard = exports.isString = exports.isFunction = exports.isArray = exports.warn = exports.updateContext = exports.updateHistoryValue = exports.updateHistoryStates = exports.partition = exports.isPromiseLike = exports.isBuiltInEvent = exports.mapContext = exports.toArray = exports.toArrayStrict = exports.flatten = exports.pathsToStateValue = exports.toStatePaths = exports.nestedPath = exports.path = exports.mapFilterValues = exports.mapValues = exports.pathToStateValue = exports.toStateValue = exports.isStateLike = exports.toStatePath = exports.getActionType = exports.getEventType = exports.matchesState = exports.keys = void 0;
45
46
  var constants_1 = require("./constants");
46
47
  var environment_1 = require("./environment");
47
48
  function keys(value) {
@@ -304,7 +305,7 @@ function mapContext(mapper, context, _event) {
304
305
  }
305
306
  var result = {};
306
307
  try {
307
- for (var _b = __values(keys(mapper)), _c = _b.next(); !_c.done; _c = _b.next()) {
308
+ for (var _b = __values(Object.keys(mapper)), _c = _b.next(); !_c.done; _c = _b.next()) {
308
309
  var key = _c.value;
309
310
  var subMapper = mapper[key];
310
311
  if (isFunction(subMapper)) {
@@ -549,7 +550,6 @@ function toTransitionConfigArray(event, configLike) {
549
550
  if (typeof transitionLike === 'undefined' ||
550
551
  typeof transitionLike === 'string' ||
551
552
  isMachine(transitionLike)) {
552
- // @ts-ignore until Type instantiation is excessively deep and possibly infinite bug is fixed
553
553
  return { target: transitionLike, event: event };
554
554
  }
555
555
  return __assign(__assign({}, transitionLike), { event: event });
@@ -602,3 +602,10 @@ function evaluateGuard(machine, guard, context, _event, state) {
602
602
  return condFn(context, _event.data, guardMeta);
603
603
  }
604
604
  exports.evaluateGuard = evaluateGuard;
605
+ function toInvokeSource(src) {
606
+ if (typeof src === 'string') {
607
+ return { type: src };
608
+ }
609
+ return src;
610
+ }
611
+ exports.toInvokeSource = toInvokeSource;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "xstate",
3
- "version": "4.10.0",
3
+ "version": "4.14.0",
4
4
  "description": "Finite State Machines and Statecharts for the Modern Web.",
5
5
  "main": "lib/index.js",
6
6
  "module": "es/index.js",
@@ -48,11 +48,11 @@
48
48
  },
49
49
  "homepage": "https://github.com/davidkpiano/xstate/tree/master/packages/core#readme",
50
50
  "devDependencies": {
51
- "@babel/cli": "^7.6.0",
52
- "@babel/core": "^7.6.0",
51
+ "@babel/cli": "^7.10.5",
52
+ "@babel/core": "^7.10.5",
53
53
  "@scion-scxml/test-framework": "^2.0.15",
54
54
  "babel-plugin-annotate-pure-calls": "^0.4.0",
55
- "jest": "^24.8.0",
55
+ "jest": "^26.4.2",
56
56
  "jsdom": "^14.0.0",
57
57
  "jsdom-global": "^3.0.2",
58
58
  "lerna-alias": "3.0.3-0",
@@ -64,9 +64,9 @@
64
64
  "rollup-plugin-typescript2": "^0.25.2",
65
65
  "rollup-plugin-uglify": "^6.0.2",
66
66
  "rxjs": "^6.5.1",
67
- "ts-jest": "^24.1.9",
67
+ "ts-jest": "^26.4.0",
68
68
  "tslib": "^1.10.0",
69
- "typescript": "^3.8.3",
69
+ "typescript": "^4.0.3",
70
70
  "xml-js": "^1.6.11"
71
71
  }
72
72
  }