Support parentheses for lists in grammar (#312)

Author: georgestagg

CLAUDE.md

@@ -11,7 +11,7 @@ SELECT date, revenue, region FROM sales WHERE year = 2024
 VISUALISE date AS x, revenue AS y, region AS color
 DRAW line
 SCALE x VIA date
-SCALE y FROM [0, 100000]
+SCALE y FROM (0, 100000)
 LABEL title => 'Sales by Region', x => 'Date', y => 'Revenue'
 ```
 
@@ -1186,7 +1186,7 @@ Creates annotation layers with literal values only (no data mappings). All aesth
 PLACE point SETTING x => 5, y => 10, color => 'red'
 
 -- Multiple annotations (array recycling)
-PLACE point SETTING x => [1, 2, 3], y => [10, 20, 30]
+PLACE point SETTING x => (1, 2, 3), y => (10, 20, 30)
 
 -- Reference line
 PLACE rule SETTING x => 5, color => 'red'
@@ -1211,8 +1211,8 @@ SCALE [TYPE] <aesthetic> [FROM <input>] [TO <output>] [VIA <transform>]
 
 **Subclauses**:
 
-- **`FROM [...]`** - Input range specification (maps to Vega-Lite `scale.domain`)
-- **`TO [...]`** or **`TO palette`** - Output range as array or named palette (maps to Vega-Lite `scale.range` or `scale.scheme`)
+- **`FROM (...)`** - Input range specification (maps to Vega-Lite `scale.domain`). Square brackets `[...]` are also accepted.
+- **`TO (...)`** or **`TO palette`** - Output range as array or named palette (maps to Vega-Lite `scale.range` or `scale.scheme`). Square brackets `[...]` are also accepted.
 - **`VIA transform`** - Transformation method (reserved for future use)
 - **`SETTING ...`** - Additional properties (e.g., `breaks`)
 
@@ -1234,10 +1234,10 @@ The `FROM` clause explicitly sets the input range for a scale:
 
 ```sql
 -- Set range for discrete scale
-SCALE DISCRETE color FROM ['A', 'B', 'C']
+SCALE DISCRETE color FROM ('A', 'B', 'C')
 
 -- Set range for continuous scale
-SCALE CONTINUOUS x FROM [0, 100]
+SCALE CONTINUOUS x FROM (0, 100)
 ```
 
 **Range Specification** (TO clause):
@@ -1246,7 +1246,7 @@ The `TO` clause sets the output range - either explicit values or a named palett
 
 ```sql
 -- Explicit color values
-SCALE color FROM ['A', 'B'] TO ['red', 'blue']
+SCALE color FROM ('A', 'B') TO ('red', 'blue')
 
 -- Named palette
 SCALE color TO viridis
@@ -1259,16 +1259,16 @@ SCALE color TO viridis
 SCALE x VIA date
 
 -- Continuous scale with input range
-SCALE CONTINUOUS y FROM [0, 100]
+SCALE CONTINUOUS y FROM (0, 100)
 
 -- Discrete color scale with input range and output range
-SCALE DISCRETE color FROM ['A', 'B', 'C'] TO ['red', 'green', 'blue']
+SCALE DISCRETE color FROM ('A', 'B', 'C') TO ('red', 'green', 'blue')
 
 -- Color scale with named palette
 SCALE color TO viridis
 
 -- Scale with input range and additional settings
-SCALE x VIA date FROM ['2024-01-01', '2024-12-31']
+SCALE x VIA date FROM ('2024-01-01', '2024-12-31')
   SETTING breaks => '1 month'
 ```
 
@@ -1297,7 +1297,7 @@ FACET <row_vars> BY <col_vars>
 - `null` or omitted (default) - Shared/fixed scales across all facets
 - `'x'` - Independent x-axis, shared y-axis
 - `'y'` - Shared x-axis, independent y-axis
-- `['x', 'y']` - Independent scales for both axes
+- `('x', 'y')` - Independent scales for both axes
 
 **Customizing Strip Labels**:
 
@@ -1327,7 +1327,7 @@ SCALE panel
 
 -- Combined grid with settings
 FACET region BY category
-  SETTING free => ['x', 'y'], spacing => 10
+  SETTING free => ('x', 'y'), spacing => 10
 ```
 
 ### PROJECT Clause
@@ -1372,16 +1372,16 @@ PROJECT y, x TO cartesian
 
 - `ratio => <number>` - Set aspect ratio (not yet implemented)
 
-Note: For axis limits, use `SCALE x FROM [min, max]` or `SCALE y FROM [min, max]`.
+Note: For axis limits, use `SCALE x FROM (min, max)` or `SCALE y FROM (min, max)`.
 
 **Polar**:
 
 - No special properties (angle/radius aesthetics are used directly)
 
 **Important Notes**:
 
-1. **Axis limits**: Use `SCALE x/y FROM [min, max]` to set axis limits
-2. **Aesthetic domains**: Use `SCALE <aesthetic> FROM [...]` to set aesthetic domains
+1. **Axis limits**: Use `SCALE x/y FROM (min, max)` to set axis limits
+2. **Aesthetic domains**: Use `SCALE <aesthetic> FROM (...)` to set aesthetic domains
 3. **Custom aesthetics**: User can define custom position names (e.g., `PROJECT a, b TO cartesian`)
 4. **Multi-layer support**: All projection transforms apply to all layers
 
@@ -1421,8 +1421,8 @@ PROJECT TO cartesian
 -- Combined with other clauses
 DRAW bar
   MAPPING category AS x, value AS y
-SCALE x FROM [0, 100]
-SCALE y FROM [0, 200]
+SCALE x FROM (0, 100)
+SCALE y FROM (0, 200)
 PROJECT y, x TO cartesian
   SETTING clip => true
 LABEL x => 'Category', y => 'Count'

doc/gallery/examples/heatmap.qmd

@@ -52,5 +52,5 @@ FROM ggsql:airquality
 
 VISUALISE Month AS y, Day AS x, centered AS fill
   DRAW rect
-  SCALE fill FROM [-20, 20] TO vik
+  SCALE fill FROM (-20, 20) TO vik
 ```

doc/gallery/examples/minard.qmd

@@ -114,24 +114,24 @@ VISUALISE long AS x, lat AS y FROM 'minard_troops.csv'
   DRAW path
     MAPPING direction AS stroke, survivors AS linewidth
     PARTITION BY direction, group
-  SCALE stroke TO ['burlywood', 'black']
+  SCALE stroke TO ('burlywood', 'black')
     RENAMING 'A' => 'Advance', 'R' => 'Retreat'
 ```
 
 Now for a slightly more complicated scale, we're going to set one for the `linewidth` variable that represent the number of troops.
 If you want to build in some extra intuition for the scale, you can let 0 troops coincide with 0 linewidth.
-We define the output range using `TO [0, 20]` because for a continuous variable it expects the output limits.
-Slightly more elaborate is the input domain, where we use `FROM [0, null]` to state that the scale should start at 0 and go up to the largest value in the data.
+We define the output range using `TO (0, 20)` because for a continuous variable it expects the output limits.
+Slightly more elaborate is the input domain, where we use `FROM (0, null)` to state that the scale should start at 0 and go up to the largest value in the data.
 Because both the input and output ranges start at 0, we get a well-proportioned line.
 
 ```{ggsql}
 VISUALISE long AS x, lat AS y FROM 'minard_troops.csv'
   DRAW path
     MAPPING direction AS stroke, survivors AS linewidth
     PARTITION BY direction, group
-  SCALE stroke TO ['burlywood', 'black']
+  SCALE stroke TO ('burlywood', 'black')
     RENAMING 'A' => 'Advance', 'R' => 'Retreat'
-  SCALE linewidth FROM [0, null] TO [0, 20]
+  SCALE linewidth FROM (0, null) TO (0, 20)
 ```
 
 ## Polishing
@@ -153,9 +153,9 @@ VISUALISE long AS x, lat AS y FROM 'minard_troops.csv'
   DRAW text
     MAPPING city AS label FROM 'minard_cities.csv'
     SETTING fontsize => 6
-  SCALE stroke TO ['burlywood', 'black']
+  SCALE stroke TO ('burlywood', 'black')
     RENAMING 'A' => 'Advance', 'R' => 'Retreat'
-  SCALE linewidth FROM [0, null] TO [0, 30]
+  SCALE linewidth FROM (0, null) TO (0, 30)
 ```
 
 An additional obvious way to polish your graphic is to add nicer titles for all your variables.
@@ -172,9 +172,9 @@ VISUALISE long AS x, lat AS y FROM 'minard_troops.csv'
   DRAW text
     MAPPING city AS label FROM 'minard_cities.csv'
     SETTING fontsize => 6
-  SCALE stroke TO ['burlywood', 'black']
+  SCALE stroke TO ('burlywood', 'black')
     RENAMING 'A' => 'Advance', 'R' => 'Retreat'
-  SCALE linewidth FROM [0, null] TO [0, 20]
+  SCALE linewidth FROM (0, null) TO (0, 20)
   LABEL
     title => 'Napoleon\'s Russian Campaign',
     subtitle => 'Inspired by the graphic of C.J. Minard',

doc/gallery/examples/scatterplot.qmd

@@ -47,7 +47,7 @@ The color palette can be changed by detailing the `SCALE color` clause.
 ```{ggsql}
 VISUALISE bill_len AS x, bill_dep AS y, species AS color FROM ggsql:penguins
 DRAW point
-SCALE color TO ['DeepSkyBlue', 'Fuchsia', 'Lime']
+SCALE color TO ('DeepSkyBlue', 'Fuchsia', 'Lime')
 LABEL
     title => 'Penguin Bill Dimensions by Species',
     x => 'Bill Length (mm)',

doc/get_started/anatomy.qmd

@@ -64,7 +64,7 @@ As [described above](#scales), ggsql automatically creates a default for mapped
 The clause allows you to set the type of scale, the input range, the output range, the transformation, and lets you control breaks and label formatting. So, the clause can end up with a lot of information but the syntax has been designed so it reads very natural. Further, every part is optional and can be left out if the default fits. An example of a rather complex `SCALE` clause could be:
 
 ```ggsql
-SCALE ORDINAL fill FROM ['Low', 'Mid', 'High'] TO viridis
+SCALE ORDINAL fill FROM ('Low', 'Mid', 'High') TO viridis
   SETTING breaks => 6
 ```
 
@@ -85,7 +85,7 @@ DRAW point
 DRAW smooth 
   SETTING method => 'ols'
 SCALE stroke TO dark2
-SCALE BINNED size TO [4, 15]
+SCALE BINNED size TO (4, 15)
   SETTING breaks => 4
 ```
 

doc/get_started/the_rest.qmd

@@ -99,7 +99,7 @@ DRAW bar
 PROJECT TO polar
 FACET island
   SETTING free => 'angle'
-SCALE panel FROM ['Biscoe', 'Dream']
+SCALE panel FROM ('Biscoe', 'Dream')
 ```
 
 Above, we use the `free` parameter of facet to allow each facet to have their own angle scale. Further, we use `SCALE` on the panel aesthetic to only show panels for the Biscoe and Dream islands.
@@ -112,7 +112,7 @@ DRAW bar
 PROJECT TO polar
 FACET island
   SETTING free => 'angle'
-SCALE panel FROM ['Biscoe', 'Dream']
+SCALE panel FROM ('Biscoe', 'Dream')
 LABEL
   title => 'Distribution of penguin species between islands',
   subtitle => 'Compared across 344 penguins',

doc/syntax/layer/type/line.qmd

@@ -73,7 +73,7 @@ WITH data(x, y, z) AS (VALUES
 VISUALISE x, y FROM data
 DRAW line
   MAPPING z AS stroke
-SCALE stroke TO ['red', 'green', 'blue']
+SCALE stroke TO ('red', 'green', 'blue')
 ```
 
 The `linewidth` aesthetic can vary point to point.
@@ -88,5 +88,5 @@ WITH data(x, y, z) AS (VALUES
 VISUALISE x, y FROM data
 DRAW line
   MAPPING z AS linewidth
-SCALE linewidth TO [0, 30]
+SCALE linewidth TO (0, 30)
 ```

doc/syntax/layer/type/path.qmd

@@ -102,7 +102,7 @@ WITH data(x, y, z) AS (VALUES
 VISUALISE x, y FROM data
 DRAW path
   MAPPING z AS stroke
-SCALE stroke TO ['red', 'green', 'blue']
+SCALE stroke TO ('red', 'green', 'blue')
 ```
 
 The `linewidth` aesthetic can vary point to point.
@@ -117,5 +117,5 @@ WITH data(x, y, z) AS (VALUES
 VISUALISE x, y FROM data
 DRAW path
   MAPPING z AS linewidth
-SCALE linewidth TO [0, 30]
+SCALE linewidth TO (0, 30)
 ```

doc/syntax/layer/type/text.qmd

@@ -100,7 +100,7 @@ DRAW text
     opacity => 0.8, 
     fontweight => 'bold', 
     typeface => 'Times New Roman'
-SCALE fontsize TO [6, 20]
+SCALE fontsize TO (6, 20)
 ```
 
 The 'stroke' aesthetic is applied to the outline of the text.
@@ -120,7 +120,7 @@ VISUALISE island AS x, n AS y
 DRAW bar
 DRAW text
   MAPPING n AS label
-  SETTING vjust => 'top', offset => [0, -11], fill => 'white'
+  SETTING vjust => 'top', offset => (0, -11), fill => 'white'
 ```
 
 If you label bars at the extreme end, you may need to expand the scale to accommodate the labels.
@@ -131,8 +131,8 @@ VISUALISE island AS x, n AS y
 DRAW bar
 DRAW text
   MAPPING n AS label
-  SETTING vjust => 'bottom', offset => [0, 11]
-SCALE y FROM [0, 200]
+  SETTING vjust => 'bottom', offset => (0, 11)
+SCALE y FROM (0, 200)
 ```
 
 You can use `PLACE` to annotate a plot directly without needing to map data.
@@ -142,7 +142,7 @@ VISUALISE bill_len AS x, bill_dep AS y FROM ggsql:penguins
 DRAW point MAPPING species AS colour
 PLACE text 
   SETTING
-    label => ['Adelie', 'Chinstrap', 'Gentoo'],
-    x => [40, 50, 50],
-    y => [19, 19, 15]
+    label => ('Adelie', 'Chinstrap', 'Gentoo'),
+    x => (40, 50, 50),
+    y => (19, 19, 15)
 ```

doc/syntax/scale/aesthetic/1_color.qmd

@@ -50,7 +50,7 @@ DRAW line
 when you define the output range of a fill or stroke scale manually, e.g.
 
 ```ggsql
-SCALE fill TO ['rgb(100%, 0%, 0%)', 'lemonchiffon']
+SCALE fill TO ('rgb(100%, 0%, 0%)', 'lemonchiffon')
 ```
 
 or when using an identity scale for color in which case the data values must be parsable as colors.
@@ -79,7 +79,7 @@ VISUALISE FROM ggsql:penguins
 DRAW point
   MAPPING bill_dep AS x, body_mass AS y, flipper_len AS fill
   SETTING stroke => null
-SCALE color TO ['antiquewhite', 'firebrick']
+SCALE color TO ('antiquewhite', 'firebrick')
 ```
 
 ### Continuous palettes