Add a treeApi.setSelection method.

[jameskerr]

Adds a new method to the TreeApi class called setSelection.

It allows for programatic control over the selection state. It is not concerned with changing focus or scrolling, only selection.

It accepts one argument. An object with the keys {ids, anchor, mostRecent}. These are the three pieces of state necessary for multiple selection.

Example:

useEffect(() => {
  tree.setSelection({
    ids: ["1", "2", "3"],
    anchor: "1", // or null
    mostRecent: "3" // or null
  })
}, [])

Fixes #156 #130 #145

[jameskerr]

@adrianwysocki1993
@victorvianaom
@rkistinger
@liamdon
@lanesawyer

You've all recently submitted issues/PRs around the Tree's selection API. Would this PR solve your specific problems? Please provide feedback.

[adrianwysocki1993]

@adrianwysocki1993 @victorvianaom @rkistinger @liamdon @lanesawyer

You've all recently submitted issues/PRs around the Tree's selection API. Would this PR solve your specific problems? Please provide feedback.

It solves at least my problems. Thank you very much!

[lanesawyer]

Yeah, this looks great. Thank you for working on it!

[jameskerr]

Version 3.2.0 is now out and contains this fix. Thanks for your contributions! https://github.com/brimdata/react-arborist/releases/tag/v3.2.0