@xstate/react 4.0.0-beta.4 → 4.0.0-beta.6

package/dist/declarations/src/createActorContext.d.ts

@@ -1,15 +1,17 @@
 import * as React from 'react';
-import { ActorRefFrom, AnyStateMachine, SnapshotFrom, InterpreterOptions, Observer, StateFrom, AreAllImplementationsAssumedToBeProvided, MarkAllImplementationsAsProvided, StateMachine } from 'xstate';
+import { ActorRefFrom, AnyStateMachine, SnapshotFrom, InterpreterOptions, Observer, AreAllImplementationsAssumedToBeProvided, MarkAllImplementationsAsProvided, StateMachine, AnyActorLogic } from 'xstate';
 type ToMachinesWithProvidedImplementations<TMachine extends AnyStateMachine> = TMachine extends StateMachine<infer TContext, infer TEvent, infer TAction, infer TActorMap, infer TResolvedTypesMeta> ? StateMachine<TContext, TEvent, TAction, TActorMap, AreAllImplementationsAssumedToBeProvided<TResolvedTypesMeta> extends false ? MarkAllImplementationsAsProvided<TResolvedTypesMeta> : TResolvedTypesMeta> : never;
-export declare function createActorContext<TMachine extends AnyStateMachine>(machine: TMachine, interpreterOptions?: InterpreterOptions<TMachine>, observerOrListener?: Observer<StateFrom<TMachine>> | ((value: StateFrom<TMachine>) => void)): {
+export declare function createActorContext<TMachine extends AnyActorLogic>(actorLogic: TMachine, interpreterOptions?: InterpreterOptions<TMachine>, observerOrListener?: Observer<SnapshotFrom<TMachine>> | ((value: SnapshotFrom<TMachine>) => void)): {
     useSelector: <T>(selector: (snapshot: SnapshotFrom<TMachine>) => T, compare?: (a: T, b: T) => boolean) => T;
     useActorRef: () => ActorRefFrom<TMachine>;
     Provider: (props: {
         children: React.ReactNode;
-    } & (AreAllImplementationsAssumedToBeProvided<TMachine['__TResolvedTypesMeta']> extends true ? {
-        machine?: TMachine;
+    } & (TMachine extends AnyStateMachine ? AreAllImplementationsAssumedToBeProvided<TMachine['__TResolvedTypesMeta']> extends true ? {
+        logic?: TMachine;
     } : {
-        machine: ToMachinesWithProvidedImplementations<TMachine>;
+        logic: ToMachinesWithProvidedImplementations<TMachine>;
+    } : {
+        logic?: TMachine;
     })) => React.ReactElement<any, any>;
 };
 export {};

package/dist/declarations/src/index.d.ts

@@ -1,6 +1,6 @@
-export { useActor } from './useActor.ts';
-export { useActorRef } from './useActorRef.ts';
-export { useSelector } from './useSelector.ts';
-export { shallowEqual } from './shallowEqual.ts';
-export { createActorContext } from './createActorContext.ts';
-export { useMachine } from './useMachine.ts';
+export { useActor } from "./useActor.js";
+export { useActorRef } from "./useActorRef.js";
+export { useSelector } from "./useSelector.js";
+export { shallowEqual } from "./shallowEqual.js";
+export { createActorContext } from "./createActorContext.js";
+export { useMachine } from "./useMachine.js";

package/dist/declarations/src/useActor.d.ts

@@ -1,6 +1,2 @@
-import { ActorRefFrom, AnyActorBehavior, InterpreterOptions, SnapshotFrom } from 'xstate';
-export declare function useActor<TBehavior extends AnyActorBehavior>(behavior: TBehavior, options?: InterpreterOptions<TBehavior>): [
-    SnapshotFrom<TBehavior>,
-    ActorRefFrom<TBehavior>['send'],
-    ActorRefFrom<TBehavior>
-];
+import { ActorRefFrom, AnyActorLogic, InterpreterOptions, SnapshotFrom } from 'xstate';
+export declare function useActor<TLogic extends AnyActorLogic>(logic: TLogic, options?: InterpreterOptions<TLogic>): [SnapshotFrom<TLogic>, ActorRefFrom<TLogic>['send'], ActorRefFrom<TLogic>];

package/dist/declarations/src/useActorRef.d.ts

@@ -1,14 +1,14 @@
-import { AnyActorBehavior, AnyInterpreter, AnyStateMachine, AreAllImplementationsAssumedToBeProvided, InternalMachineImplementations, ActorRefFrom, InterpreterOptions, Observer, StateFrom, SnapshotFrom } from 'xstate';
-export declare function useIdleInterpreter(machine: AnyActorBehavior, options: Partial<InterpreterOptions<AnyActorBehavior>>): AnyInterpreter;
-type RestParams<TBehavior extends AnyActorBehavior> = TBehavior extends AnyStateMachine ? AreAllImplementationsAssumedToBeProvided<TBehavior['__TResolvedTypesMeta']> extends false ? [
-    options: InterpreterOptions<TBehavior> & InternalMachineImplementations<TBehavior['__TContext'], TBehavior['__TEvent'], TBehavior['__TResolvedTypesMeta'], true>,
-    observerOrListener?: Observer<StateFrom<TBehavior>> | ((value: StateFrom<TBehavior>) => void)
+import { AnyActorLogic, AnyInterpreter, AnyStateMachine, AreAllImplementationsAssumedToBeProvided, InternalMachineImplementations, ActorRefFrom, InterpreterOptions, Observer, StateFrom, SnapshotFrom } from 'xstate';
+export declare function useIdleInterpreter(machine: AnyActorLogic, options: Partial<InterpreterOptions<AnyActorLogic>>): AnyInterpreter;
+type RestParams<TLogic extends AnyActorLogic> = TLogic extends AnyStateMachine ? AreAllImplementationsAssumedToBeProvided<TLogic['__TResolvedTypesMeta']> extends false ? [
+    options: InterpreterOptions<TLogic> & InternalMachineImplementations<TLogic['__TContext'], TLogic['__TEvent'], TLogic['__TResolvedTypesMeta'], true>,
+    observerOrListener?: Observer<StateFrom<TLogic>> | ((value: StateFrom<TLogic>) => void)
 ] : [
-    options?: InterpreterOptions<TBehavior> & InternalMachineImplementations<TBehavior['__TContext'], TBehavior['__TEvent'], TBehavior['__TResolvedTypesMeta']>,
-    observerOrListener?: Observer<StateFrom<TBehavior>> | ((value: StateFrom<TBehavior>) => void)
+    options?: InterpreterOptions<TLogic> & InternalMachineImplementations<TLogic['__TContext'], TLogic['__TEvent'], TLogic['__TResolvedTypesMeta']>,
+    observerOrListener?: Observer<StateFrom<TLogic>> | ((value: StateFrom<TLogic>) => void)
 ] : [
-    options?: InterpreterOptions<TBehavior>,
-    observerOrListener?: Observer<SnapshotFrom<TBehavior>> | ((value: SnapshotFrom<TBehavior>) => void)
+    options?: InterpreterOptions<TLogic>,
+    observerOrListener?: Observer<SnapshotFrom<TLogic>> | ((value: SnapshotFrom<TLogic>) => void)
 ];
-export declare function useActorRef<TBehavior extends AnyActorBehavior>(machine: TBehavior, ...[options, observerOrListener]: RestParams<TBehavior>): ActorRefFrom<TBehavior>;
+export declare function useActorRef<TLogic extends AnyActorLogic>(machine: TLogic, ...[options, observerOrListener]: RestParams<TLogic>): ActorRefFrom<TLogic>;
 export {};

package/dist/{useConstant-720f1662.cjs.prod.js → useConstant-2ee82f84.cjs.js}

@@ -23,7 +23,7 @@ function _interopNamespace(e) {
 var React__namespace = /*#__PURE__*/_interopNamespace(React);
 
 function useConstant(fn) {
-  var ref = React__namespace.useRef();
+  const ref = React__namespace.useRef();
   if (!ref.current) {
     ref.current = {
       v: fn()

package/dist/useConstant-ae6dceac.development.cjs.js

@@ -0,0 +1,35 @@
+'use strict';
+
+var React = require('react');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n["default"] = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+function useConstant(fn) {
+  const ref = React__namespace.useRef();
+  if (!ref.current) {
+    ref.current = {
+      v: fn()
+    };
+  }
+  return ref.current.v;
+}
+
+exports.useConstant = useConstant;

package/dist/useConstant-bac83df4.development.esm.js

@@ -0,0 +1,13 @@
+import * as React from 'react';
+
+function useConstant(fn) {
+  const ref = React.useRef();
+  if (!ref.current) {
+    ref.current = {
+      v: fn()
+    };
+  }
+  return ref.current.v;
+}
+
+export { useConstant as u };

package/dist/useConstant-c7ec0fdd.esm.js

@@ -0,0 +1,13 @@
+import * as React from 'react';
+
+function useConstant(fn) {
+  const ref = React.useRef();
+  if (!ref.current) {
+    ref.current = {
+      v: fn()
+    };
+  }
+  return ref.current.v;
+}
+
+export { useConstant as u };

package/dist/xstate-react.cjs.js

@@ -1,7 +1,187 @@
 'use strict';
 
-if (process.env.NODE_ENV === "production") {
-  module.exports = require("./xstate-react.cjs.prod.js");
-} else {
-  module.exports = require("./xstate-react.cjs.dev.js");
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var React = require('react');
+var withSelector = require('use-sync-external-store/shim/with-selector');
+var xstate = require('xstate');
+var useConstant = require('./useConstant-2ee82f84.cjs.js');
+var useIsomorphicLayoutEffect = require('use-isomorphic-layout-effect');
+require('xstate/actors');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { 'default': e }; }
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n["default"] = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+var useIsomorphicLayoutEffect__default = /*#__PURE__*/_interopDefault(useIsomorphicLayoutEffect);
+
+function useIdleInterpreter(machine, options) {
+  const actorRef = useConstant.useConstant(() => {
+    return xstate.interpret(machine, options);
+  });
+
+  // TODO: consider using `useAsapEffect` that would do this in `useInsertionEffect` is that's available
+  useIsomorphicLayoutEffect__default["default"](() => {
+    actorRef.logic.options = machine.options;
+  });
+  return actorRef;
+}
+function useActorRef(machine, ...[options = {}, observerOrListener]) {
+  const service = useIdleInterpreter(machine, options);
+  React.useEffect(() => {
+    if (!observerOrListener) {
+      return;
+    }
+    let sub = service.subscribe(xstate.toObserver(observerOrListener));
+    return () => {
+      sub.unsubscribe();
+    };
+  }, [observerOrListener]);
+  React.useEffect(() => {
+    service.start();
+    return () => {
+      service.stop();
+      service.status = xstate.InterpreterStatus.NotStarted;
+      service._initState();
+    };
+  }, []);
+  return service;
+}
+
+function identity(a) {
+  return a;
+}
+const isEqual = (prevState, nextState) => {
+  return prevState === nextState || nextState.changed === false;
+};
+function useActor(logic, options = {}) {
+  const actorRef = useIdleInterpreter(logic, options);
+  const getSnapshot = React.useCallback(() => {
+    return actorRef.getSnapshot();
+  }, [actorRef]);
+  const subscribe = React.useCallback(handleStoreChange => {
+    const {
+      unsubscribe
+    } = actorRef.subscribe(handleStoreChange);
+    return unsubscribe;
+  }, [actorRef]);
+  const actorSnapshot = withSelector.useSyncExternalStoreWithSelector(subscribe, getSnapshot, getSnapshot, identity, isEqual);
+  React.useEffect(() => {
+    actorRef.start();
+    return () => {
+      actorRef.stop();
+      actorRef.status = xstate.InterpreterStatus.NotStarted;
+      actorRef._initState();
+    };
+  }, [actorRef]);
+  return [actorSnapshot, actorRef.send, actorRef];
 }
+
+function defaultCompare(a, b) {
+  return a === b;
+}
+function useSelector(actor, selector, compare = defaultCompare) {
+  const subscribe = React.useCallback(handleStoreChange => {
+    const {
+      unsubscribe
+    } = actor.subscribe(handleStoreChange);
+    return unsubscribe;
+  }, [actor]);
+  const boundGetSnapshot = React.useCallback(() => actor.getSnapshot(), [actor]);
+  const selectedSnapshot = withSelector.useSyncExternalStoreWithSelector(subscribe, boundGetSnapshot, boundGetSnapshot, selector, compare);
+  return selectedSnapshot;
+}
+
+// From https://github.com/reduxjs/react-redux/blob/720f0ba79236cdc3e1115f4ef9a7760a21784b48/src/utils/shallowEqual.ts
+function is(x, y) {
+  if (x === y) {
+    return x !== 0 || y !== 0 || 1 / x === 1 / y;
+  } else {
+    return x !== x && y !== y;
+  }
+}
+function shallowEqual(objA, objB) {
+  if (is(objA, objB)) return true;
+  if (typeof objA !== 'object' || objA === null || typeof objB !== 'object' || objB === null) {
+    return false;
+  }
+  const keysA = Object.keys(objA);
+  const keysB = Object.keys(objB);
+  if (keysA.length !== keysB.length) return false;
+  for (let i = 0; i < keysA.length; i++) {
+    if (!Object.prototype.hasOwnProperty.call(objB, keysA[i]) || !is(objA[keysA[i]], objB[keysA[i]])) {
+      return false;
+    }
+  }
+  return true;
+}
+
+function createActorContext(actorLogic, interpreterOptions, observerOrListener) {
+  const ReactContext = /*#__PURE__*/React__namespace.createContext(null);
+  const OriginalProvider = ReactContext.Provider;
+  function Provider({
+    children,
+    logic: providedLogic = actorLogic,
+    machine
+  }) {
+    if (machine) {
+      throw new Error(`The "machine" prop has been deprecated. Please use "logic" instead.`);
+    }
+    const actor = useActorRef(providedLogic, interpreterOptions, observerOrListener);
+    return /*#__PURE__*/React__namespace.createElement(OriginalProvider, {
+      value: actor,
+      children
+    });
+  }
+
+  // TODO: add properties to actor ref to make more descriptive
+  Provider.displayName = `ActorProvider`;
+  function useContext() {
+    const actor = React__namespace.useContext(ReactContext);
+    if (!actor) {
+      throw new Error(`You used a hook from "${Provider.displayName}" but it's not inside a <${Provider.displayName}> component.`);
+    }
+    return actor;
+  }
+  function useSelector$1(selector, compare) {
+    const actor = useContext();
+    return useSelector(actor, selector, compare);
+  }
+  return {
+    Provider: Provider,
+    useActorRef: useContext,
+    useSelector: useSelector$1
+  };
+}
+
+/**
+ *
+ * @deprecated Use `useActor(...)` instead.
+ */
+function useMachine(machine, options = {}) {
+  return useActor(machine, options);
+}
+
+exports.createActorContext = createActorContext;
+exports.shallowEqual = shallowEqual;
+exports.useActor = useActor;
+exports.useActorRef = useActorRef;
+exports.useMachine = useMachine;
+exports.useSelector = useSelector;

package/dist/xstate-react.development.cjs.js

@@ -0,0 +1,196 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var React = require('react');
+var withSelector = require('use-sync-external-store/shim/with-selector');
+var xstate = require('xstate');
+var useConstant = require('./useConstant-ae6dceac.development.cjs.js');
+var useIsomorphicLayoutEffect = require('use-isomorphic-layout-effect');
+var actors = require('xstate/actors');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { 'default': e }; }
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n["default"] = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+var useIsomorphicLayoutEffect__default = /*#__PURE__*/_interopDefault(useIsomorphicLayoutEffect);
+
+function useIdleInterpreter(machine, options) {
+  {
+    const [initialMachine] = React.useState(machine);
+    if (machine.config !== initialMachine.config) {
+      console.warn(`Actor logic has changed between renders. This is not supported and may lead to invalid snapshots.`);
+    }
+  }
+  const actorRef = useConstant.useConstant(() => {
+    return xstate.interpret(machine, options);
+  });
+
+  // TODO: consider using `useAsapEffect` that would do this in `useInsertionEffect` is that's available
+  useIsomorphicLayoutEffect__default["default"](() => {
+    actorRef.logic.options = machine.options;
+  });
+  return actorRef;
+}
+function useActorRef(machine, ...[options = {}, observerOrListener]) {
+  const service = useIdleInterpreter(machine, options);
+  React.useEffect(() => {
+    if (!observerOrListener) {
+      return;
+    }
+    let sub = service.subscribe(xstate.toObserver(observerOrListener));
+    return () => {
+      sub.unsubscribe();
+    };
+  }, [observerOrListener]);
+  React.useEffect(() => {
+    service.start();
+    return () => {
+      service.stop();
+      service.status = xstate.InterpreterStatus.NotStarted;
+      service._initState();
+    };
+  }, []);
+  return service;
+}
+
+function identity(a) {
+  return a;
+}
+const isEqual = (prevState, nextState) => {
+  return prevState === nextState || nextState.changed === false;
+};
+function useActor(logic, options = {}) {
+  if (actors.isActorRef(logic)) {
+    throw new Error(`useActor() expects actor logic (e.g. a machine), but received an ActorRef. Use the useSelector(actorRef, ...) hook instead to read the ActorRef's snapshot.`);
+  }
+  const actorRef = useIdleInterpreter(logic, options);
+  const getSnapshot = React.useCallback(() => {
+    return actorRef.getSnapshot();
+  }, [actorRef]);
+  const subscribe = React.useCallback(handleStoreChange => {
+    const {
+      unsubscribe
+    } = actorRef.subscribe(handleStoreChange);
+    return unsubscribe;
+  }, [actorRef]);
+  const actorSnapshot = withSelector.useSyncExternalStoreWithSelector(subscribe, getSnapshot, getSnapshot, identity, isEqual);
+  React.useEffect(() => {
+    actorRef.start();
+    return () => {
+      actorRef.stop();
+      actorRef.status = xstate.InterpreterStatus.NotStarted;
+      actorRef._initState();
+    };
+  }, [actorRef]);
+  return [actorSnapshot, actorRef.send, actorRef];
+}
+
+function defaultCompare(a, b) {
+  return a === b;
+}
+function useSelector(actor, selector, compare = defaultCompare) {
+  const subscribe = React.useCallback(handleStoreChange => {
+    const {
+      unsubscribe
+    } = actor.subscribe(handleStoreChange);
+    return unsubscribe;
+  }, [actor]);
+  const boundGetSnapshot = React.useCallback(() => actor.getSnapshot(), [actor]);
+  const selectedSnapshot = withSelector.useSyncExternalStoreWithSelector(subscribe, boundGetSnapshot, boundGetSnapshot, selector, compare);
+  return selectedSnapshot;
+}
+
+// From https://github.com/reduxjs/react-redux/blob/720f0ba79236cdc3e1115f4ef9a7760a21784b48/src/utils/shallowEqual.ts
+function is(x, y) {
+  if (x === y) {
+    return x !== 0 || y !== 0 || 1 / x === 1 / y;
+  } else {
+    return x !== x && y !== y;
+  }
+}
+function shallowEqual(objA, objB) {
+  if (is(objA, objB)) return true;
+  if (typeof objA !== 'object' || objA === null || typeof objB !== 'object' || objB === null) {
+    return false;
+  }
+  const keysA = Object.keys(objA);
+  const keysB = Object.keys(objB);
+  if (keysA.length !== keysB.length) return false;
+  for (let i = 0; i < keysA.length; i++) {
+    if (!Object.prototype.hasOwnProperty.call(objB, keysA[i]) || !is(objA[keysA[i]], objB[keysA[i]])) {
+      return false;
+    }
+  }
+  return true;
+}
+
+function createActorContext(actorLogic, interpreterOptions, observerOrListener) {
+  const ReactContext = /*#__PURE__*/React__namespace.createContext(null);
+  const OriginalProvider = ReactContext.Provider;
+  function Provider({
+    children,
+    logic: providedLogic = actorLogic,
+    machine
+  }) {
+    if (machine) {
+      throw new Error(`The "machine" prop has been deprecated. Please use "logic" instead.`);
+    }
+    const actor = useActorRef(providedLogic, interpreterOptions, observerOrListener);
+    return /*#__PURE__*/React__namespace.createElement(OriginalProvider, {
+      value: actor,
+      children
+    });
+  }
+
+  // TODO: add properties to actor ref to make more descriptive
+  Provider.displayName = `ActorProvider`;
+  function useContext() {
+    const actor = React__namespace.useContext(ReactContext);
+    if (!actor) {
+      throw new Error(`You used a hook from "${Provider.displayName}" but it's not inside a <${Provider.displayName}> component.`);
+    }
+    return actor;
+  }
+  function useSelector$1(selector, compare) {
+    const actor = useContext();
+    return useSelector(actor, selector, compare);
+  }
+  return {
+    Provider: Provider,
+    useActorRef: useContext,
+    useSelector: useSelector$1
+  };
+}
+
+/**
+ *
+ * @deprecated Use `useActor(...)` instead.
+ */
+function useMachine(machine, options = {}) {
+  return useActor(machine, options);
+}
+
+exports.createActorContext = createActorContext;
+exports.shallowEqual = shallowEqual;
+exports.useActor = useActor;
+exports.useActorRef = useActorRef;
+exports.useMachine = useMachine;
+exports.useSelector = useSelector;