Support ARRAY JOIN as table element in FROM clause

- Add ArrayJoin field to TablesInSelectQueryElement struct
- Handle ARRAY JOIN and LEFT ARRAY JOIN in parseTableElementWithJoin
- Include token.ARRAY in isJoinKeyword check
- Update explain output to handle ArrayJoin in table elements

This enables parsing of queries like:
  FROM table ARRAY JOIN col INNER JOIN other_table USING (...)

where ARRAY JOIN is followed by regular JOINs.

Author: claude

ast/ast.go

@@ -126,9 +126,10 @@ func (t *TablesInSelectQuery) End() token.Position { return t.Position }
 
 // TablesInSelectQueryElement represents a single table element in a SELECT.
 type TablesInSelectQueryElement struct {
-	Position token.Position   `json:"-"`
-	Table    *TableExpression `json:"table"`
-	Join     *TableJoin       `json:"join,omitempty"`
+	Position  token.Position    `json:"-"`
+	Table     *TableExpression  `json:"table,omitempty"`
+	Join      *TableJoin        `json:"join,omitempty"`
+	ArrayJoin *ArrayJoinClause  `json:"array_join,omitempty"` // For ARRAY JOIN as table element
 }
 
 func (t *TablesInSelectQueryElement) Pos() token.Position { return t.Position }

internal/explain/tables.go

@@ -15,10 +15,23 @@ func explainTablesInSelectQuery(sb *strings.Builder, n *ast.TablesInSelectQuery,
 }
 
 func explainTablesInSelectQueryElement(sb *strings.Builder, n *ast.TablesInSelectQueryElement, indent string, depth int) {
-	children := 1 // table
+	// If this element contains an ArrayJoin (not a table), handle it separately
+	if n.ArrayJoin != nil {
+		fmt.Fprintf(sb, "%sTablesInSelectQueryElement (children 1)\n", indent)
+		explainArrayJoinClause(sb, n.ArrayJoin, indent+" ", depth+1)
+		return
+	}
+
+	children := 0
+	if n.Table != nil {
+		children++
+	}
 	if n.Join != nil {
 		children++
 	}
+	if children == 0 {
+		children = 1 // Fallback
+	}
 	fmt.Fprintf(sb, "%sTablesInSelectQueryElement (children %d)\n", indent, children)
 	if n.Table != nil {
 		Node(sb, n.Table, depth+1)

parser/parser.go

@@ -793,13 +793,10 @@ func (p *Parser) parseTablesInSelect() *ast.TablesInSelectQuery {
 }
 
 func (p *Parser) isJoinKeyword() bool {
-	// LEFT ARRAY JOIN is handled by parseArrayJoin, not as a regular join
-	if p.currentIs(token.LEFT) && p.peekIs(token.ARRAY) {
-		return false
-	}
 	switch p.current.Token {
 	case token.JOIN, token.INNER, token.LEFT, token.RIGHT, token.FULL, token.CROSS,
-		token.GLOBAL, token.ANY, token.ALL, token.ASOF, token.SEMI, token.ANTI, token.PASTE:
+		token.GLOBAL, token.ANY, token.ALL, token.ASOF, token.SEMI, token.ANTI, token.PASTE,
+		token.ARRAY:
 		return true
 	case token.COMMA:
 		return true
@@ -837,6 +834,12 @@ func (p *Parser) parseTableElementWithJoin() *ast.TablesInSelectQueryElement {
 		return elem
 	}
 
+	// Handle ARRAY JOIN or LEFT ARRAY JOIN
+	if p.currentIs(token.ARRAY) || (p.currentIs(token.LEFT) && p.peekIs(token.ARRAY)) {
+		elem.ArrayJoin = p.parseArrayJoin()
+		return elem
+	}
+
 	// Parse JOIN
 	join := &ast.TableJoin{
 		Position: p.current.Pos,

parser/testdata/00855_join_with_array_join/metadata.json

@@ -1,13 +1,6 @@
 {
   "explain_todo": {
-    "stmt16": true,
-    "stmt17": true,
-    "stmt18": true,
-    "stmt19": true,
-    "stmt20": true,
-    "stmt21": true,
     "stmt22": true,
-    "stmt23": true,
-    "stmt3": true
+    "stmt23": true
   }
 }

parser/testdata/01881_union_header_mismatch_bug/metadata.json

@@ -1,5 +1 @@
-{
-  "explain_todo": {
-    "stmt3": true
-  }
-}
+{}

parser/testdata/02374_analyzer_array_join/metadata.json

@@ -1,7 +1,5 @@
 {
   "explain_todo": {
-    "stmt14": true,
-    "stmt29": true,
     "stmt32": true
   }
 }

parser/testdata/02477_analyzer_array_join_with_join/metadata.json

@@ -1,31 +1 @@
-{
-  "explain_todo": {
-    "stmt15": true,
-    "stmt17": true,
-    "stmt19": true,
-    "stmt21": true,
-    "stmt23": true,
-    "stmt25": true,
-    "stmt27": true,
-    "stmt29": true,
-    "stmt31": true,
-    "stmt33": true,
-    "stmt35": true,
-    "stmt37": true,
-    "stmt39": true,
-    "stmt41": true,
-    "stmt43": true,
-    "stmt45": true,
-    "stmt47": true,
-    "stmt49": true,
-    "stmt51": true,
-    "stmt53": true,
-    "stmt55": true,
-    "stmt57": true,
-    "stmt59": true,
-    "stmt61": true,
-    "stmt63": true,
-    "stmt65": true,
-    "stmt67": true
-  }
-}
+{}

parser/testdata/02521_analyzer_array_join_crash/metadata.json

@@ -1,7 +1 @@
-{
-  "explain_todo": {
-    "stmt6": true,
-    "stmt7": true,
-    "stmt8": true
-  }
-}
+{}

parser/testdata/03046_column_in_block_array_join/metadata.json

@@ -1,5 +1 @@
-{
-  "explain_todo": {
-    "stmt8": true
-  }
-}
+{}

parser/testdata/03130_analyzer_array_join_prefer_column/metadata.json

@@ -1,6 +1 @@
-{
-  "explain_todo": {
-    "stmt4": true,
-    "stmt5": true
-  }
-}
+{}