Add API to provide a selection range, and return the updated selection after formatting.

test/selections/selections.stmt

Index: test/selections/selections.stmt
diff --git a/test/selections/selections.stmt b/test/selections/selections.stmt
new file mode 100644
index 0000000000000000000000000000000000000000..354bc83c4617bd62c99d3737f11565abba1a7087
--- /dev/null
+++ b/test/selections/selections.stmt
@@ -0,0 +1,73 @@
+40 columns                              |
+>>> start at beginning
+‹123›45;
+<<<
+‹123›45;
+>>> start at end
+12345;‹›
+<<<
+12345;‹›
+>>> zero length
+123‹›45;
+<<<
+123‹›45;
+>>> length at end
+12‹345;›
+<<<
+12‹345;›
+>>> unchanged
+f‹oo(a, ›b, c);
+<<<
+f‹oo(a, ›b, c);
+>>> includes added whitespace
+a+f‹irst+se›cond;
+<<<
+a + f‹irst + se›cond;
+>>> inside comment
+foo(   /* ‹ */  bar/*›*/);
+<<<
+foo(/* ‹ */ bar /*›*/);
+>>> in beginning of multi-line string literal
+  """f‹irs›t
+second""";
+<<<
+"""f‹irs›t
+second""";
+>>> in middle of multi-line string literal
+    """first
+se‹cond
+thi›rd
+fourth""";
+<<<
+"""first
+se‹cond
+thi›rd
+fourth""";
+>>> in end of multi-line string literal
+  """first
+sec‹ond"""  ;›
+<<<
+"""first
+sec‹ond""";›
+>>> in string interpolation
+foo(  "$fi‹rst",  "$sec›ond" );
+<<<
+foo("$fi‹rst", "$sec›ond");
+>>> in moved comment
+someMethod(argument /* long com‹ment that wraps */, other /* last com›ment */);
+<<<
+someMethod(
+    argument /* long com‹ment that wraps */,
+    other /* last com›ment */);
+>>> before comments
+1  ‹  /* */ +  ›  /* */ 2;
+<<<
+1 ‹/* */ + ›/* */ 2;
+>>> after comments
+1/* */  ‹  +/* */  ›   2;
+<<<
+1 /* */ ‹+ /* */ ›2;
+>>> between adjacent comments
+1/* */  ‹  /* */ › /* */ +  2;
+<<<
+1 /* */ ‹/* */ ›/* */ + 2;