# Progress

A determinate progress family in three shapes: a linear Bar, a segmented Steps counter, and a circular Ring.

Version: 0.2.0-preview.1 (preview)
Content digest: 70ac710f4d22dce040e7ac593379ba8aca9dcb59a0b9c0f839819cae0e2bb721
Contract kind: source-derived
Source: packages/design-system/src/components/status/Progress/Progress.tsx

## Guidance

{
  "summary": "A determinate progress family in three shapes: a linear Bar, a segmented Steps counter, and a circular Ring.",
  "guidance": [
    {
      "heading": "Overview",
      "body": "Determinate progress in three shapes chosen by context. All three take a 0-100\n`value` (`Progress.Steps` derives it from `completed` / `total`)."
    },
    {
      "heading": "Use when",
      "body": "Pick the shape by how the progress reads in place, not by preference.\n\n`Progress.Bar` and `Progress.Ring` are both in use today; `Progress.Steps` is\navailable but currently unused in the app."
    },
    {
      "heading": "Steps",
      "body": "`Progress.Steps` marks completed, active, and upcoming stages. Add `showStepNumbers`\nfor numbered markers and `stepLabels` for per-step captions."
    },
    {
      "heading": "Size and pulsing",
      "body": "`size` is `sm` (default, compact), `md`, or `lg` and is shared by all three shapes;\nreach for `lg` to emphasize progress on a standalone screen. `pulsing` (Bar) animates\nthe fill to signal an active operation."
    },
    {
      "heading": "Props",
      "body": "Controls below are for `Progress.Bar`; `Progress.Steps` and `Progress.Ring` expose\ntheir own args in the Steps and Ring stories above."
    }
  ],
  "usage": [
    {
      "variant": "Progress.Bar",
      "use": "A value along a known scale that fills as work completes — a percentage on a screen or row.",
      "axis": "Shape"
    },
    {
      "variant": "Progress.Steps",
      "use": "A small, fixed count of discrete stages — a setup wizard or onboarding flow.",
      "avoid": "Stages that each carry a title, description, or timestamp — use Timeline, which shows event detail.",
      "axis": "Shape"
    },
    {
      "variant": "Progress.Ring",
      "use": "The same 0-100 value in a compact circular badge for cards and tight corners.",
      "axis": "Shape"
    }
  ],
  "examples": [],
  "source": "packages/design-system/src/components/status/Progress/Progress.mdx",
  "status": "local-preview",
  "note": "Guidance is read from local documentation, originally imported from the frozen source. Platform assertions in guidance are not parity verification."
}

## Contract and public API

```json
{
  "props": [],
  "prop_shapes": {},
  "api": {
    "method": "typescript-type-checker",
    "typescript_version": "5.9.3",
    "public_export": "Progress",
    "public_path": "Progress",
    "import_path": "@cloakedinc/design-system",
    "root_kind": "namespace",
    "entrypoints": [
      {
        "name": "Progress.Bar",
        "signature": 1,
        "visibility": "public",
        "source": {
          "path": "packages/design-system/src/components/status/Progress/ProgressBar/ProgressBar.tsx",
          "line": 13
        },
        "props_type": "ProgressBarProps",
        "props": [
          {
            "name": "value",
            "type": "number",
            "declared_type": "number",
            "required": true,
            "description": "Progress value from 0 to 100.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 10
            }
          },
          {
            "name": "size",
            "type": "ProgressSize | undefined",
            "declared_type": "ProgressSize",
            "required": false,
            "description": "Named size for the track height. Defaults to `sm` for the compact existing treatment.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 12
            },
            "values": [
              "lg",
              "md",
              "sm"
            ],
            "values_complete": true,
            "default": "'sm'",
            "default_kind": "source-expression"
          },
          {
            "name": "pulsing",
            "type": "boolean | undefined",
            "declared_type": "boolean",
            "required": false,
            "description": "Pulses the fill to signal an active/indeterminate state.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 14
            },
            "values": [
              false,
              true
            ],
            "values_complete": true,
            "default": "false",
            "default_kind": "source-expression"
          },
          {
            "name": "label",
            "type": "ReactNode",
            "declared_type": "ReactNode",
            "required": false,
            "description": "Optional caption shown above the bar.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 16
            }
          },
          {
            "name": "valueLabel",
            "type": "ReactNode",
            "declared_type": "ReactNode",
            "required": false,
            "description": "Explicit visible value shown opposite the label.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 18
            }
          },
          {
            "name": "showValue",
            "type": "boolean | undefined",
            "declared_type": "boolean",
            "required": false,
            "description": "Shows a rounded percentage value when `valueLabel` is not provided.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 20
            },
            "values": [
              false,
              true
            ],
            "values_complete": true,
            "default": "false",
            "default_kind": "source-expression"
          },
          {
            "name": "ariaLabel",
            "type": "string | undefined",
            "declared_type": "string",
            "required": false,
            "description": "Accessible name for the value; omit when the bar is purely decorative.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 22
            }
          },
          {
            "name": "testId",
            "type": "string | undefined",
            "declared_type": "string",
            "required": false,
            "description": "Optional test selector. Lands on the track itself, not the label group.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 24
            }
          }
        ],
        "branches": [],
        "constraints": [],
        "extraction_status": "extracted"
      },
      {
        "name": "Progress.Steps",
        "signature": 1,
        "visibility": "public",
        "source": {
          "path": "packages/design-system/src/components/status/Progress/ProgressSteps/ProgressSteps.tsx",
          "line": 14
        },
        "props_type": "ProgressStepsProps",
        "props": [
          {
            "name": "total",
            "type": "number",
            "declared_type": "number",
            "required": true,
            "description": "Step count; truncated to a whole number and clamped to 1-12.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 32
            }
          },
          {
            "name": "completed",
            "type": "number",
            "declared_type": "number",
            "required": true,
            "description": "Steps finished so far; clamped to `0..total`.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 34
            }
          },
          {
            "name": "size",
            "type": "ProgressSize | undefined",
            "declared_type": "ProgressSize",
            "required": false,
            "description": "Named marker size. Defaults to `sm` for the compact existing treatment.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 36
            },
            "values": [
              "lg",
              "md",
              "sm"
            ],
            "values_complete": true,
            "default": "'sm'",
            "default_kind": "source-expression"
          },
          {
            "name": "showActiveStep",
            "type": "boolean | undefined",
            "declared_type": "boolean",
            "required": false,
            "description": "Marks the next incomplete step as active.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 38
            },
            "values": [
              false,
              true
            ],
            "values_complete": true,
            "default": "false",
            "default_kind": "source-expression"
          },
          {
            "name": "label",
            "type": "ReactNode",
            "declared_type": "ReactNode",
            "required": false,
            "description": "Optional caption shown above the steps.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 40
            }
          },
          {
            "name": "valueLabel",
            "type": "ReactNode",
            "declared_type": "ReactNode",
            "required": false,
            "description": "Explicit visible value shown opposite the label.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 42
            }
          },
          {
            "name": "showValue",
            "type": "boolean | undefined",
            "declared_type": "boolean",
            "required": false,
            "description": "Shows a compact completed/total value when `valueLabel` is not provided.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 44
            },
            "values": [
              false,
              true
            ],
            "values_complete": true,
            "default": "false",
            "default_kind": "source-expression"
          },
          {
            "name": "showStepNumbers",
            "type": "boolean | undefined",
            "declared_type": "boolean",
            "required": false,
            "description": "Renders step numbers inside each marker.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 46
            },
            "values": [
              false,
              true
            ],
            "values_complete": true,
            "default": "false",
            "default_kind": "source-expression"
          },
          {
            "name": "stepLabels",
            "type": "readonly ReactNode[] | undefined",
            "declared_type": "readonly ReactNode[]",
            "required": false,
            "description": "Optional compact labels shown beneath each step marker.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 48
            }
          },
          {
            "name": "ariaLabel",
            "type": "string | undefined",
            "declared_type": "string",
            "required": false,
            "description": "Accessible name for the value; omit when the markers are purely decorative.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 50
            }
          },
          {
            "name": "testId",
            "type": "string | undefined",
            "declared_type": "string",
            "required": false,
            "description": "Optional test selector. Lands on the step row itself, not the label group.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 52
            }
          }
        ],
        "branches": [],
        "constraints": [],
        "extraction_status": "extracted"
      },
      {
        "name": "Progress.Ring",
        "signature": 1,
        "visibility": "public",
        "source": {
          "path": "packages/design-system/src/components/status/Progress/ProgressRing/ProgressRing.tsx",
          "line": 13
        },
        "props_type": "ProgressRingProps",
        "props": [
          {
            "name": "value",
            "type": "number | undefined",
            "declared_type": "number",
            "required": false,
            "description": "Progress value from 0 to 100.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 60
            },
            "default": "0",
            "default_kind": "source-expression"
          },
          {
            "name": "size",
            "type": "ProgressSize | undefined",
            "declared_type": "ProgressSize",
            "required": false,
            "description": "Named ring size. Defaults to `sm` for the compact existing treatment.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 62
            },
            "values": [
              "lg",
              "md",
              "sm"
            ],
            "values_complete": true,
            "default": "'sm'",
            "default_kind": "source-expression"
          },
          {
            "name": "label",
            "type": "ReactNode",
            "declared_type": "ReactNode",
            "required": false,
            "description": "Optional caption shown beneath the ring.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 64
            }
          },
          {
            "name": "valueLabel",
            "type": "ReactNode",
            "declared_type": "ReactNode",
            "required": false,
            "description": "Explicit visible value shown inside the ring.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 66
            }
          },
          {
            "name": "showValue",
            "type": "boolean | undefined",
            "declared_type": "boolean",
            "required": false,
            "description": "Shows a rounded percentage value inside the ring when `valueLabel` is not provided.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 68
            },
            "values": [
              false,
              true
            ],
            "values_complete": true,
            "default": "false",
            "default_kind": "source-expression"
          },
          {
            "name": "ariaLabel",
            "type": "string | undefined",
            "declared_type": "string",
            "required": false,
            "description": "Accessible name for the value; omit when the ring is purely decorative.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 70
            }
          },
          {
            "name": "testId",
            "type": "string | undefined",
            "declared_type": "string",
            "required": false,
            "description": "Optional test selector. Lands on the ring itself, not the label group.",
            "source": {
              "path": "packages/design-system/src/components/status/Progress/types.ts",
              "line": 72
            }
          }
        ],
        "branches": [],
        "constraints": [],
        "extraction_status": "extracted"
      }
    ],
    "type_sources": [
      {
        "path": "packages/design-system/src/components/status/Progress/types.ts",
        "line": 3,
        "name": "ProgressSize",
        "code": "export type ProgressSize = 'sm' | 'md' | 'lg';"
      },
      {
        "path": "packages/design-system/src/components/status/Progress/types.ts",
        "line": 8,
        "name": "ProgressBarProps",
        "code": "export interface ProgressBarProps {\n    /** Progress value from 0 to 100. */\n    value: number;\n    /** Named size for the track height. Defaults to `sm` for the compact existing treatment. */\n    size?: ProgressSize;\n    /** Pulses the fill to signal an active/indeterminate state. */\n    pulsing?: boolean;\n    /** Optional caption shown above the bar. */\n    label?: ReactNode;\n    /** Explicit visible value shown opposite the label. */\n    valueLabel?: ReactNode;\n    /** Shows a rounded percentage value when `valueLabel` is not provided. */\n    showValue?: boolean;\n    /** Accessible name for the value; omit when the bar is purely decorative. */\n    ariaLabel?: string;\n    /** Optional test selector. Lands on the track itself, not the label group. */\n    testId?: string;\n}"
      },
      {
        "path": "packages/design-system/src/components/status/Progress/types.ts",
        "line": 30,
        "name": "ProgressStepsProps",
        "code": "export interface ProgressStepsProps {\n    /** Step count; truncated to a whole number and clamped to 1-12. */\n    total: number;\n    /** Steps finished so far; clamped to `0..total`. */\n    completed: number;\n    /** Named marker size. Defaults to `sm` for the compact existing treatment. */\n    size?: ProgressSize;\n    /** Marks the next incomplete step as active. */\n    showActiveStep?: boolean;\n    /** Optional caption shown above the steps. */\n    label?: ReactNode;\n    /** Explicit visible value shown opposite the label. */\n    valueLabel?: ReactNode;\n    /** Shows a compact completed/total value when `valueLabel` is not provided. */\n    showValue?: boolean;\n    /** Renders step numbers inside each marker. */\n    showStepNumbers?: boolean;\n    /** Optional compact labels shown beneath each step marker. */\n    stepLabels?: readonly ReactNode[];\n    /** Accessible name for the value; omit when the markers are purely decorative. */\n    ariaLabel?: string;\n    /** Optional test selector. Lands on the step row itself, not the label group. */\n    testId?: string;\n}"
      },
      {
        "path": "packages/design-system/src/components/status/Progress/types.ts",
        "line": 58,
        "name": "ProgressRingProps",
        "code": "export interface ProgressRingProps {\n    /** Progress value from 0 to 100. */\n    value?: number;\n    /** Named ring size. Defaults to `sm` for the compact existing treatment. */\n    size?: ProgressSize;\n    /** Optional caption shown beneath the ring. */\n    label?: ReactNode;\n    /** Explicit visible value shown inside the ring. */\n    valueLabel?: ReactNode;\n    /** Shows a rounded percentage value inside the ring when `valueLabel` is not provided. */\n    showValue?: boolean;\n    /** Accessible name for the value; omit when the ring is purely decorative. */\n    ariaLabel?: string;\n    /** Optional test selector. Lands on the ring itself, not the label group. */\n    testId?: string;\n}"
      }
    ],
    "defaults_policy": "Only explicit destructured parameter initializers are extracted. Other runtime defaults remain in implementation source."
  },
  "spec": {
    "$schema": "../../../specs/component-spec.schema.json",
    "identity": {
      "name": "Progress",
      "status": "preview",
      "version": "1.0.0",
      "summary": "A determinate progress family in three shapes: a linear Bar, a segmented Steps counter, and a circular Ring."
    },
    "parts": [
      {
        "id": "bar",
        "label": "Progress.Bar",
        "description": "Linear track that fills from 0 to 100.",
        "required": true
      },
      {
        "id": "steps",
        "label": "Progress.Steps",
        "description": "Segmented markers for a small fixed count of stages."
      },
      {
        "id": "ring",
        "label": "Progress.Ring",
        "description": "Circular badge form for cards and tight corners."
      }
    ],
    "allowedDesignChoices": {
      "variants": {
        "bar": {
          "label": "Bar",
          "description": "Linear determinate track."
        },
        "steps": {
          "label": "Steps",
          "description": "Discrete stage markers."
        },
        "ring": {
          "label": "Ring",
          "description": "Compact circular badge."
        }
      },
      "sizes": {
        "sm": {
          "label": "Small",
          "description": "Compact default track, marker, and ring."
        },
        "md": {
          "label": "Medium",
          "description": "Mid-scale track, marker, and ring."
        },
        "lg": {
          "label": "Large",
          "description": "Emphasis track, marker, and ring."
        }
      }
    },
    "variants": [
      {
        "id": "bar",
        "label": "Bar",
        "description": "Linear determinate progress.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      },
      {
        "id": "steps",
        "label": "Steps",
        "description": "Segmented stage progress.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      },
      {
        "id": "ring",
        "label": "Ring",
        "description": "Circular determinate progress.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      }
    ],
    "sizes": [
      {
        "id": "sm",
        "label": "Small",
        "description": "The compact existing treatment."
      },
      {
        "id": "md",
        "label": "Medium",
        "description": "A mid-scale treatment."
      },
      {
        "id": "lg",
        "label": "Large",
        "description": "An emphasis treatment for standalone screens."
      }
    ],
    "measurements": [
      {
        "id": "bar-track-height-sm",
        "label": "Bar track height (small)",
        "kind": "exact",
        "token": "--cds-size-4",
        "value": 4,
        "unit": "px",
        "appliesTo": [
          "bar"
        ]
      },
      {
        "id": "bar-track-height-md",
        "label": "Bar track height (medium)",
        "kind": "exact",
        "token": "--cds-size-8",
        "value": 8,
        "unit": "px",
        "appliesTo": [
          "bar"
        ]
      },
      {
        "id": "bar-track-height-lg",
        "label": "Bar track height (large)",
        "kind": "exact",
        "token": "--cds-size-12",
        "value": 12,
        "unit": "px",
        "appliesTo": [
          "bar"
        ]
      },
      {
        "id": "ring-diameter-sm",
        "label": "Ring diameter (small)",
        "kind": "exact",
        "token": "--cds-size-32",
        "value": 32,
        "unit": "px",
        "appliesTo": [
          "ring"
        ]
      },
      {
        "id": "ring-diameter-md",
        "label": "Ring diameter (medium)",
        "kind": "exact",
        "token": "--cds-size-48",
        "value": 48,
        "unit": "px",
        "appliesTo": [
          "ring"
        ]
      },
      {
        "id": "ring-diameter-lg",
        "label": "Ring diameter (large)",
        "kind": "exact",
        "token": "--cds-size-64",
        "value": 64,
        "unit": "px",
        "appliesTo": [
          "ring"
        ]
      },
      {
        "id": "group-gap",
        "label": "Label and track gap",
        "kind": "exact",
        "token": "--cds-space-8",
        "value": 8,
        "unit": "px",
        "appliesTo": [
          "bar",
          "steps",
          "ring"
        ]
      },
      {
        "id": "step-dot-size-sm",
        "label": "Step dot size (small)",
        "kind": "exact",
        "token": "--cds-size-8",
        "value": 8,
        "unit": "px",
        "appliesTo": [
          "steps"
        ]
      },
      {
        "id": "step-dot-size-md",
        "label": "Step dot size (medium)",
        "kind": "exact",
        "token": "--cds-size-12",
        "value": 12,
        "unit": "px",
        "appliesTo": [
          "steps"
        ]
      },
      {
        "id": "step-dot-size-lg",
        "label": "Step dot size (large)",
        "kind": "exact",
        "token": "--cds-size-16",
        "value": 16,
        "unit": "px",
        "appliesTo": [
          "steps"
        ]
      }
    ],
    "layout": {
      "alignment": "An optional label and value sit above the bar/steps; the ring centers its value.",
      "flow": "Each shape is self-contained; Bar and Steps fill their container width while Ring is inline.",
      "notes": [
        "Use Timeline when each stage carries its own title, description, and timestamp."
      ]
    },
    "typographyAndColor": {
      "typography": [
        {
          "label": "Caption and value",
          "description": "Labels and values use the body-small ramp.",
          "token": "--cds-type-body-small-size"
        }
      ],
      "colors": [
        {
          "label": "Fill",
          "description": "Completed progress uses the brand accent.",
          "token": "--cds-brand"
        },
        {
          "label": "Track",
          "description": "The unfilled track uses the graph background.",
          "token": "--cds-graph-bg"
        }
      ]
    },
    "states": [
      {
        "id": "determinate",
        "label": "Determinate",
        "description": "Fill reflects the current 0 to 100 value."
      },
      {
        "id": "pulsing",
        "label": "Pulsing",
        "description": "The bar fill pulses to signal an active or indeterminate operation."
      },
      {
        "id": "complete",
        "label": "Complete",
        "description": "All steps or full value are filled with the brand accent."
      }
    ],
    "behavior": [
      {
        "label": "Shape choice",
        "description": "Pick Bar for a scale, Steps for a small fixed count of stages, and Ring for a compact badge."
      },
      {
        "label": "Value clamping",
        "description": "Values are clamped to the 0 to 100 range before rendering."
      }
    ],
    "accessibility": [
      {
        "label": "Meaningful progress",
        "description": "Set ariaLabel to expose role=progressbar with min, max, and current value."
      },
      {
        "label": "Decorative progress",
        "description": "Omit ariaLabel to hide purely decorative progress from assistive tech."
      }
    ],
    "contentAdaptation": [
      {
        "label": "Optional value",
        "description": "showValue renders a rounded percentage or completed/total count opposite the label."
      },
      {
        "label": "Step labels",
        "description": "Steps can render numbers inside markers and captions beneath them."
      }
    ],
    "motionHaptics": {
      "motion": [
        {
          "label": "Fill transition",
          "description": "The bar fill eases to its new width; the pulsing fill animates until it settles."
        }
      ],
      "haptics": [
        {
          "label": "No feedback",
          "description": "Progress is non-interactive and requests no haptics."
        }
      ]
    },
    "platformDifferences": []
  },
  "platforms": {
    "implemented": [
      "web"
    ],
    "native": "Imported design guidance only; no native implementation or parity verification in this preview.",
    "react": {
      "implementation": "local",
      "status": "preview",
      "parity": "web-reference"
    },
    "vue": {
      "implementation": "absent",
      "parity": "not-verified",
      "status": "reference-only"
    },
    "swift": {
      "implementation": "absent",
      "parity": "not-verified",
      "status": "reference-only"
    },
    "kotlin": {
      "implementation": "absent",
      "parity": "not-verified",
      "status": "reference-only"
    }
  },
  "tokens": [
    {
      "name": "--cds-size-4",
      "light": "4px",
      "dark": "4px"
    },
    {
      "name": "--cds-size-8",
      "light": "8px",
      "dark": "8px"
    },
    {
      "name": "--cds-size-12",
      "light": "12px",
      "dark": "12px"
    },
    {
      "name": "--cds-size-32",
      "light": "32px",
      "dark": "32px"
    },
    {
      "name": "--cds-size-48",
      "light": "48px",
      "dark": "48px"
    },
    {
      "name": "--cds-size-64",
      "light": "64px",
      "dark": "64px"
    },
    {
      "name": "--cds-space-8",
      "light": "8px",
      "dark": "8px"
    },
    {
      "name": "--cds-size-16",
      "light": "16px",
      "dark": "16px"
    },
    {
      "name": "--cds-type-body-small-size",
      "light": "0.875rem",
      "dark": "0.875rem"
    },
    {
      "name": "--cds-brand",
      "light": "#ff550c",
      "dark": "#ff550c"
    },
    {
      "name": "--cds-graph-bg",
      "light": "#0b0b0a0d",
      "dark": "#ffffff0d"
    }
  ],
  "review": {
    "local_status": "not-reviewed",
    "source_approval": null,
    "imported_spec_status": "approved",
    "spec_origin": "imported-adapted",
    "local_spec_source_status": "approved",
    "imported_source_revision": "f96f416e1c3bfbfaffcd155a88b87b18b8bb25f1",
    "note": "Inherited specification status is provenance, not approval of the current local implementation or extracted contract."
  },
  "missing_facts": [
    {
      "code": "human-review-pending",
      "detail": "This local preview has no recorded human design or engineering sign-off."
    },
    {
      "code": "platform-parity-unverified",
      "detail": "Vue, Swift and Kotlin implementations are absent from this package; platform parity has not been verified."
    },
    {
      "code": "figma-mapping-unverified",
      "detail": "No current component-level Figma node and immutable revision have been verified for this contract."
    }
  ]
}
```

## Visual states

- [Bar](/storybook/iframe.html?id=cloaked-design-system-status-progress--bar&viewMode=story) | export: Bar | source: packages/design-system/src/components/status/Progress/Progress.stories.tsx

- [Bar With Label](/storybook/iframe.html?id=cloaked-design-system-status-progress--bar-with-label&viewMode=story) | export: BarWithLabel | source: packages/design-system/src/components/status/Progress/Progress.stories.tsx

- [Bar Large](/storybook/iframe.html?id=cloaked-design-system-status-progress--bar-large&viewMode=story) | export: BarLarge | source: packages/design-system/src/components/status/Progress/Progress.stories.tsx

- [Bar Pulsing](/storybook/iframe.html?id=cloaked-design-system-status-progress--bar-pulsing&viewMode=story) | export: BarPulsing | source: packages/design-system/src/components/status/Progress/Progress.stories.tsx

- [Steps](/storybook/iframe.html?id=cloaked-design-system-status-progress--steps&viewMode=story) | export: Steps | source: packages/design-system/src/components/status/Progress/Progress.stories.tsx

- [Steps With Numbers](/storybook/iframe.html?id=cloaked-design-system-status-progress--steps-with-numbers&viewMode=story) | export: StepsWithNumbers | source: packages/design-system/src/components/status/Progress/Progress.stories.tsx

- [Steps With Labels](/storybook/iframe.html?id=cloaked-design-system-status-progress--steps-with-labels&viewMode=story) | export: StepsWithLabels | source: packages/design-system/src/components/status/Progress/Progress.stories.tsx

- [Ring](/storybook/iframe.html?id=cloaked-design-system-status-progress--ring&viewMode=story) | export: Ring | source: packages/design-system/src/components/status/Progress/Progress.stories.tsx

- [Ring With Value](/storybook/iframe.html?id=cloaked-design-system-status-progress--ring-with-value&viewMode=story) | export: RingWithValue | source: packages/design-system/src/components/status/Progress/Progress.stories.tsx

- [Dark Theme](/storybook/iframe.html?id=cloaked-design-system-status-progress--dark-theme&viewMode=story) | export: DarkTheme | source: packages/design-system/src/components/status/Progress/Progress.stories.tsx

Preview pending human sign-off. Source-derived APIs and successful checks do not certify accessibility, native parity or approval.