Allow combinators at start of selector query

Closes jhy#13

CHANGES

@@ -7,6 +7,9 @@ jsoup changelog
  * Relative links are resolved to absolute when cleaning, to normalize
     output and to verify safe protocol. (Were previously discarded.)
       <http://github.com/jhy/jsoup/issues/issue/12>
+
+ * Allow combinators at start of selector query, for query refinements
+ 	  <http://github.com/jhy/jsoup/issues/issue/13>
 
 *** Release 0.3.1 (2010-Feb-20)
  * New features: supports Elements#html(), html(String),

src/main/java/org/jsoup/select/Selector.java

@@ -87,9 +87,16 @@ public static Elements select(String query, Iterable<Element> roots) {
 
     private Elements select() {
         tq.consumeWhitespace();
-        addElements(findElements()); // chomp first matcher off queue        
+
+        if (tq.matchesAny(combinators)) { // if starts with a combinator, use root as elements
+            elements.add(root);
+            combinator(tq.consume().toString());
+        } else {
+            addElements(findElements()); // chomp first element matcher off queue 
+        }            
+
         while (!tq.isEmpty()) {
-            // hierarchy and extras (todo: implement +, ~)
+            // hierarchy and extras
             boolean seenWhite = tq.consumeWhitespace();
 
             if (tq.matchChomp(",")) { // group or

src/test/java/org/jsoup/select/SelectorTest.java

@@ -290,4 +290,21 @@ public class SelectorTest {
         Element el4 = doc.select(".b2-qux_bif").first();
         assertEquals("Two", el4.text());
     }
+
+    // for http://github.com/jhy/jsoup/issues#issue/13
+    @Test public void testSupportsLeadingCombinator() {
+        String h = "<div><p><span>One</span><span>Two</span></p></div>";
+        Document doc = Jsoup.parse(h);
+
+        Element p = doc.select("div > p").first();
+        Elements spans = p.select("> span");
+        assertEquals(2, spans.size());
+        assertEquals("One", spans.first().text());
+
+        // make sure doesn't get nested
+        h = "<div id=1><div id=2><div id=3></div></div></div>";
+        doc = Jsoup.parse(h);
+        Element div = doc.select("div").select(" > div").first();
+        assertEquals("2", div.id());
+    }
 }