{
  "$schema": "../manifest.schema.json",
  "schemaVersion": "1.2.0",
  "name": "ds-progress-steps",
  "description": "Step progress indicator",
  "docUrl": "https://design.soracom.io/design-system/elements/progress-steps/",
  "category": "elements",
  "htmlElements": [
    "ul",
    "ol"
  ],
  "isWebComponent": false,
  "usageNotes": [
    "The active step uses the container’s --color-text, falling back to --color and then --ds-progress-steps-highlight-color. Explicit --color-text or --color on the active step takes precedence. Color modifiers keep the base palette color for indicators and connecting lines while active text uses the theme-adjusted foreground.",
    "Use --1 through --10 on the list to select the active li. Earlier steps are completed and later steps are pending. An index beyond the last item marks all items completed; for example, --5 completes a four-step list.",
    "Apply --icon-* to individual li elements to replace their dots with icons. Size modifiers on the list set the default icon size; a size modifier on a step overrides it for that icon. Use --vertical on the list for a vertical sequence, and --striped for striped connecting lines."
  ],
  "modifiers": {
    "size": {
      "support": "custom",
      "values": [
        "--4xsmall",
        "--3xsmall",
        "--2xsmall",
        "--xsmall",
        "--small",
        "--medium",
        "--large",
        "--xlarge",
        "--2xlarge",
        "--3xlarge",
        "--4xlarge",
        "--huge",
        "--xhuge",
        "--2xhuge",
        "--3xhuge",
        "--4xhuge"
      ]
    },
    "color": {
      "support": "all"
    },
    "icon": {
      "support": "all"
    },
    "layout": {
      "support": "custom",
      "values": [
        "--middle",
        "--bottom",
        "--vertical"
      ]
    },
    "variant": {
      "support": "custom",
      "values": [
        "--striped"
      ]
    },
    "utility": {
      "support": "custom",
      "values": [
        "--1",
        "--2",
        "--3",
        "--4",
        "--5",
        "--6",
        "--7",
        "--8",
        "--9",
        "--10"
      ]
    }
  },
  "cssCustomProperties": [
    {
      "name": "--ds-progress-steps-indicator-size",
      "default": "8px",
      "description": "Dot size for the active step. Pending and completed dots use a reduced scale; icon steps use their icon size."
    },
    {
      "name": "--ds-progress-steps-color",
      "default": "var(--color-default)",
      "description": "Base color for pending dots and connecting lines, with opacity applied internally."
    },
    {
      "name": "--ds-progress-steps-text-color",
      "default": "var(--color-default)",
      "description": "Text color for completed and pending steps."
    },
    {
      "name": "--ds-progress-steps-highlight-color",
      "default": "var(--color-green-tint)",
      "description": "Color for completed indicators and lines leading to the active step, plus the active indicator and text fallback. A color modifier on the list sets this to its base palette color; active text prefers the theme-adjusted foreground."
    }
  ],
  "structure": {
    "requiredChildren": [
      "li"
    ],
    "parts": {
      "step": {
        "element": "li",
        "required": true,
        "repeatable": true
      }
    },
    "patterns": {
      "unordered": "<ul class=\"ds-progress-steps\"><li>{step}</li></ul>",
      "ordered": "<ol class=\"ds-progress-steps\"><li>{step}</li></ol>"
    }
  },
  "attributes": {},
  "dataAttributes": [],
  "examples": [
    {
      "name": "basic",
      "html": "<ul class=\"ds-progress-steps\"><li>Step 1</li><li>Step 2</li><li>Step 3</li><li>Step 4</li></ul>"
    },
    {
      "name": "step-1",
      "html": "<ul class=\"ds-progress-steps --1\"><li>Register</li><li>Configure</li><li>Verify</li><li>Complete</li></ul>"
    },
    {
      "name": "step-2",
      "html": "<ul class=\"ds-progress-steps --2\"><li>Register</li><li>Configure</li><li>Verify</li><li>Complete</li></ul>"
    },
    {
      "name": "step-3",
      "html": "<ul class=\"ds-progress-steps --3\"><li>Register</li><li>Configure</li><li>Verify</li><li>Complete</li></ul>"
    },
    {
      "name": "completed",
      "html": "<ul class=\"ds-progress-steps --5\"><li>Register</li><li>Configure</li><li>Verify</li><li>Complete</li></ul>"
    },
    {
      "name": "striped",
      "html": "<ul class=\"ds-progress-steps --3 --striped\"><li>Register</li><li>Configure</li><li>Verify</li><li>Complete</li></ul>"
    },
    {
      "name": "color-blue",
      "html": "<ol class=\"ds-progress-steps --2 --color-blue\"><li>Register</li><li>Configure</li><li>Verify</li></ol>"
    },
    {
      "name": "vertical",
      "html": "<ol class=\"ds-progress-steps --2 --vertical\"><li>Register</li><li>Configure</li><li>Verify</li></ol>"
    },
    {
      "name": "with-icons",
      "html": "<ol class=\"ds-progress-steps --2 --large\"><li class=\"--icon-user\">Register</li><li class=\"--icon-settings\">Configure</li><li class=\"--icon-check-mark\">Verify</li></ol>"
    }
  ]
}
