kind: "BarChart"
spec:
  calculation: <Calculation specification>
  [ format: <Format specification> ]
  [ sort: <enum = "asc" | "desc"> ]
  [ mode: <enum = "value" | "percentage"> ]

kind: "GaugeChart"
spec:
  calculation: <Calculation specification>
  [ format: <Format specification> ]
  [ thresholds: <Thresholds specification> ]
  [ max: <int> ]

kind: "Markdown"
spec:
  text: <string>

kind: "StatChart"
spec:
  calculation: <Calculation specification>
  [ format: <Format specification> ]
  [ thresholds: <Thresholds specification> ]
  [ sparkline: <Sparkline specification> ]
  [ valueFontSize: <int> ]

[ color: <string> ]
[ width: <int> ]

kind: "ScatterChart"
spec: # TODO document the spec of ScatterChart

kind: "TimeSeriesChart"
spec:
  [ legend: <Legend specification> ]
  [ tooltip: <Tooltip specification> ]
  [ yAxis: <YAxis specification> ]
  [ thresholds: <Thresholds specification> ]
  [ visual: <Visual specification> ]
  querySettings:
  - [ <Query Settings specification> ]

position: <enum = "bottom" | "right">
[ mode: <enum = "list" | "table"> ]
[ size: <enum = "small" | "medium"> ]
values:
  - [ <calculation> ]

[ enablePinning: <boolean | default = false> ]

[ show: <boolean> ]
[ label: <string> ]
[ format: <format_spec> ]
[ min: <int> ]
[ max: <int> ]

[ display: <enum = "line" | "bar"> ]
# Must be between 0.25 and 3
[ lineWidth: <int> ]
# Must be between 0 and 1
[ areaOpacity: <int> ]
[ showPoints: <enum = "auto" | "always"> ]
[ palette: <Palette specification> ]
# Must be between 0 and 6
[ pointRadius: <number> ]
[ stack: <enum = "all" | "percent"> ]
[ connectNulls: boolean | default = false ]

mode: <enum = "auto" | "categorical">

# queryIndex is an unsigned integer that should match an existing index in the panel's `queries` array
queryIndex: <number>
# colorMode represents the coloring strategy to use
# - "fixed":        for any serie returned by the query, apply the colorValue defined
# - "fixed-single": if only one serie returned by the query, apply the colorValue defined, otherwise do nothing
colorMode: <enum = "fixed" | "fixed-single">
# colorValue is an hexadecimal color code
colorValue: <string>

unit: <enum = "milliseconds" | "seconds" | "minutes" | "hours" | "days" | "weeks" | "months" | "years">
[ decimalPlaces: <int> ]

unit: <enum =  "percent" | "percent-decimal">
[ decimalPlaces: <int> ]

unit: "decimal"
[ decimalPlaces: <int> ]
[ shortValues: <boolean> | default = false ]

unit: "bytes"
[ decimalPlaces: <int> ]
[ shortValues: <boolean> | default = false ]

unit: < enum = "counts/sec" | "events/sec" | "messages/sec" | "ops/sec" | "packets/sec" | "reads/sec" | "records/sec" | "requests/sec" | "rows/sec" | "writes/sec">
[ decimalPlaces: <int> ]
[ shortValues: <boolean> | default = false ]

[ mode: <enum = "percent" | "absolute"> ]
[ defaultColor: string ]
steps:
  - [ <Step specification> ]

value: <int>
[ color: <string> ]
[ name: <string> ]