Allow for runtime changes to needsExitTime etc.

- Removed the "readonly" modifier to fields such as needsExitTime and forceInstantly. This allows them to be changed at runtime, increasing the flexibility of UnityHFSM
- Added documentation describing when these runtime changes have an effect

See issue #71

Author: Inspiaaa

src/Base/StateBase.cs

@@ -8,8 +8,29 @@ namespace UnityHFSM
 	/// </summary>
 	public class StateBase<TStateId> : IVisitableState
 	{
-		public readonly bool needsExitTime;
-		public readonly bool isGhostState;
+		/// <summary>
+		/// If true, the state machine will wait for this state to signal it is "ready to exit"
+		/// before allowing a transition to occur.
+		/// </summary>
+		/// <remarks>
+		/// Changes to this at runtime only take effect the next time a transition is evaluated on this state.
+		/// </remarks>
+		public bool needsExitTime;
+		/// <summary>
+		/// When entered, the state machine will immediately check this state's outgoing transitions
+		/// and move to the next valid state within the same update tick if possible.
+		/// </summary>
+		/// <remarks>
+		/// Changes to this at runtime only take effect the next this state is entered.
+		/// </remarks>
+		public bool isGhostState;
+
+		/// <summary>
+		/// The unique identifier used to reference this state within the state machine.
+		/// </summary>
+		/// <remarks>
+		/// This field should not be changed once this state has been added to a state machine.
+		/// </remarks>
 		public TStateId name;
 
 		public IStateTimingManager fsm;

src/Base/TransitionBase.cs

@@ -9,7 +9,25 @@ public class TransitionBase<TStateId> : ITransitionListener
 		public readonly TStateId from;
 		public readonly TStateId to;
 
-		public readonly bool forceInstantly;
+		/// <summary>
+		/// If true, the state machine will ignore the current state's needsExitTime behaviour to immediately
+		/// transition to the 'to' state as soon as the condition is met.
+		/// </summary>
+		/// <remarks>
+		/// Changing this value at runtime will only take effect the next time the state machine
+		/// evaluates this transition.
+		/// </remarks>
+		public bool forceInstantly;
+
+		/// <summary>
+		/// Indicates if this transition is specifically designed to exit a nested
+		/// state machine and return control to the parent state machine.
+		/// </summary>
+		/// <remarks>
+		/// Changing this value at runtime will only take effect the next time the state machine
+		/// evaluates this transition. <para/>
+		/// If this field is true, the 'to' state is irrelevant (and can have any value).
+		/// </remarks>
 		public bool isExitTransition;
 
 		public IStateMachine<TStateId> fsm;