fix(pathNode): add backwards compat for PathNode.clone(). Add retaine…

…dWithToParams to treeChanges interface.

src/path/pathNode.ts

@@ -28,6 +28,12 @@ export class PathNode {
   /** The state's declared view configuration objects */
   public views: ViewConfig[];
 
+  /**
+   * Returns a clone of the PathNode
+   * @deprecated use instance method `node.clone()`
+   */
+  static clone = (node: PathNode) => node.clone();
+
   /** Creates a copy of a PathNode */
   constructor(node: PathNode);
   /** Creates a new (empty) PathNode for a State */

src/transition/interface.ts

@@ -137,6 +137,16 @@ export interface TreeChanges {
    */
   retained: PathNode[];
 
+  /**
+   * The path of active nodes that the transition is retaining with updated "to params" applied.
+   *
+   * These nodes are neither exited, nor entered.
+   * Before and after the transition is successful, these nodes are active.
+   *
+   * This is a shallow copy of [[retained]], but with new (dynamic) parameter values from [[to]] applied.
+   */
+  retainedWithToParams: PathNode[];
+
   /**
    * The path of previously active nodes that the transition is exiting.
    *