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.
- package/CHANGELOG.md +205 -0
- package/LICENSE +22 -0
- package/README.md +2 -2
- package/dist/xstate.interpreter.js +1 -1
- package/dist/xstate.js +1 -1
- package/dist/xstate.web.js +2 -2
- package/es/Actor.d.ts +5 -3
- package/es/Actor.js +26 -4
- package/es/State.d.ts +5 -2
- package/es/StateNode.d.ts +8 -8
- package/es/StateNode.js +61 -41
- package/es/actions.d.ts +9 -5
- package/es/actions.js +28 -13
- package/es/index.d.ts +2 -2
- package/es/index.js +1 -1
- package/es/interpreter.d.ts +29 -15
- package/es/interpreter.js +99 -112
- package/es/invokeUtils.d.ts +7 -0
- package/es/invokeUtils.js +39 -0
- package/es/match.d.ts +4 -1
- package/es/serviceScope.d.ts +10 -0
- package/es/serviceScope.js +18 -0
- package/es/stateUtils.d.ts +1 -1
- package/es/types.d.ts +79 -32
- package/es/utils.d.ts +4 -3
- package/es/utils.js +12 -3
- package/lib/Actor.d.ts +5 -3
- package/lib/Actor.js +24 -3
- package/lib/Machine.js +1 -0
- package/lib/SimulatedClock.js +1 -0
- package/lib/State.d.ts +5 -2
- package/lib/State.js +1 -0
- package/lib/StateNode.d.ts +8 -8
- package/lib/StateNode.js +69 -42
- package/lib/actionTypes.js +1 -0
- package/lib/actions.d.ts +9 -5
- package/lib/actions.js +27 -19
- package/lib/constants.js +1 -0
- package/lib/devTools.js +1 -0
- package/lib/each.js +1 -0
- package/lib/environment.js +1 -0
- package/lib/index.d.ts +2 -2
- package/lib/index.js +29 -20
- package/lib/interpreter.d.ts +28 -14
- package/lib/interpreter.js +82 -88
- package/lib/invokeUtils.d.ts +7 -0
- package/lib/invokeUtils.js +42 -0
- package/lib/json.js +1 -0
- package/lib/mapState.js +1 -0
- package/lib/match.d.ts +4 -1
- package/lib/match.js +1 -0
- package/lib/patterns.js +1 -0
- package/lib/registry.js +1 -0
- package/lib/scheduler.js +1 -0
- package/lib/scxml.js +1 -0
- package/lib/serviceScope.d.ts +10 -0
- package/lib/serviceScope.js +15 -0
- package/lib/stateUtils.d.ts +1 -1
- package/lib/stateUtils.js +1 -0
- package/lib/types.d.ts +79 -32
- package/lib/types.js +1 -0
- package/lib/utils.d.ts +4 -3
- package/lib/utils.js +9 -2
- package/package.json +6 -6
package/lib/registry.js
CHANGED
package/lib/scheduler.js
CHANGED
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]); };
|
package/lib/stateUtils.d.ts
CHANGED
|
@@ -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
|
|
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>) =>
|
|
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
|
|
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
|
-
|
|
71
|
-
[K in keyof
|
|
72
|
-
states:
|
|
73
|
-
} ?
|
|
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
|
-
|
|
191
|
-
|
|
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
|
-
}
|
|
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?:
|
|
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> =
|
|
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) =>
|
|
577
|
-
export declare type PropertyMapper<TContext, TEvent extends EventObject> =
|
|
578
|
-
[
|
|
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():
|
|
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
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:
|
|
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.
|
|
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.
|
|
52
|
-
"@babel/core": "^7.
|
|
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": "^
|
|
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": "^
|
|
67
|
+
"ts-jest": "^26.4.0",
|
|
68
68
|
"tslib": "^1.10.0",
|
|
69
|
-
"typescript": "^
|
|
69
|
+
"typescript": "^4.0.3",
|
|
70
70
|
"xml-js": "^1.6.11"
|
|
71
71
|
}
|
|
72
72
|
}
|