{
  "$schema": "../_schema.json",
  "format": "pptx",
  "element": "chart-series",
  "elementAliases": ["series", "chartseries"],
  "parent": "chart",
  "operations": {
    "add": true,
    "set": true,
    "get": true,
    "remove": true
  },
  "paths": {
    "stable": [
      "/slide[N]/chart[@id=ID]/series[@id=ID]"
    ],
    "positional": [
      "/slide[N]/chart[N]/series[N]"
    ]
  },
  "note": "At Add time, series pass as dotted props on the parent chart (series1.name, series1.values, series1.color, series1.categories); this schema is per-series Set/Get after creation. Combo charts (mixed chartType / secondary axis) are unsupported — create separate charts. `lineStyle` is not a key (rejected as UNSUPPORTED — use lineWidth + lineDash).",
  "extends": [
    "_shared/chart-series",
    "_shared/chart-series.pptx-xlsx"
  ],
  "properties": {
    "x": {
      "type": "string",
      "description": "scatter/bubble per-series X values (the numeric X domain read from <c:xVal>). Read-only readback key surfaced by Get on scatter/bubble series. X data is supplied at Add time through the chart-level `categories=` list (scatter/bubble map categories onto the X axis), not via a per-series Set. Functional but previously undocumented.",
      "add": false,
      "set": false,
      "get": true,
      "examples": ["officecli get deck.pptx \"/slide[1]/chart[1]/series[1]\"  # → x: 1,2,3"],
      "readback": "comma-separated numeric X values",
      "enforcement": "report"
    },
    "categories": {
      "type": "string",
      "description": "per-series category override; range reference only. pptx override: not supported on per-series Set (handler rejects categories on /chart[N]/series[N] paths). Set categories at chart level via `categories=...` instead.",
      "add": true,
      "set": false,
      "get": true,
      "examples": ["--prop series1.categories=\"Sheet1!$A$2:$A$5\""],
      "readback": "range reference string",
      "enforcement": "report"
    }
  }
}
