{
  "version": "0.2.0-preview.1",
  "content_digest": "70ac710f4d22dce040e7ac593379ba8aca9dcb59a0b9c0f839819cae0e2bb721",
  "status": "preview",
  "authority": {
    "repository": "cloakedinc/design",
    "path": "packages/design-system",
    "catalog": "packages/design-system/catalog.json",
    "status": "preview"
  },
  "provenance": {
    "repo": "cloakedinc/automation",
    "commit": "f96f416e1c3bfbfaffcd155a88b87b18b8bb25f1",
    "path": "packages/design-system",
    "imported_spec_status": "approved"
  },
  "adaptations": [
    {
      "id": "button-content-gap",
      "status": "preview",
      "description": "Use the specification's 4px content gap instead of the inherited 8px implementation gap."
    },
    {
      "id": "keyboard-focus",
      "status": "preview",
      "description": "Add visible Button and Input keyboard focus and an overridable inset focus default for shared button resets, including FAQ cards and ListItem rows."
    },
    {
      "id": "supporting-text-contrast",
      "status": "preview",
      "description": "Map light secondary text to the existing grey-04-strong primitive for readable helper text on white and cream."
    },
    {
      "id": "danger-text-contrast",
      "status": "preview",
      "description": "Separate readable danger text/borders from destructive fills; preserve the primary danger-button fill and label pair."
    },
    {
      "id": "preview-status",
      "status": "preview",
      "description": "Local components, specs and token adaptations await human sign-off; upstream approved status is provenance only."
    },
    {
      "id": "motion-comparison-accessibility",
      "status": "preview",
      "description": "Preserve the original MotionShowcase comparisons while requiring explicit replay, responding to live reduced-motion changes, and keeping duration tracks usable on small screens."
    },
    {
      "id": "list-item-ownership",
      "status": "preview",
      "description": "List owns listitem wrappers for its content rows, while section labels stay outside the row count and standalone rows retain their existing semantics."
    },
    {
      "id": "card-delta-text-contrast",
      "status": "preview",
      "description": "Mix Card.Delta foregrounds from 60% existing tone solid and 40% primary text for readable contrast in both themes; preserve the four original tone fills."
    },
    {
      "id": "carousel-keyboard-access",
      "status": "preview",
      "description": "Keep all native-scrolling carousel slide controls exposed to assistive technology and keyboard navigation; pause autoplay while focus is inside the carousel."
    }
  ],
  "id": "statusindicator",
  "name": "StatusIndicator",
  "category": "Status",
  "contract_status": "preview",
  "contract_kind": "source-derived",
  "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."
  },
  "approval": "required",
  "visual_reference": {
    "stories": [
      {
        "id": "cloaked-design-system-status-statusindicator--playground",
        "name": "Playground",
        "title": "Cloaked Design System/Status/StatusIndicator",
        "exportName": "Playground",
        "source_path": "packages/design-system/src/components/status/StatusIndicator/StatusIndicator.stories.tsx",
        "source_digest": "b528d92737a07e2ca7b020ff5cfff6cc378a316d554aff381d5077549c15464b",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-status-statusindicator--playground&viewMode=story"
      },
      {
        "id": "cloaked-design-system-status-statusindicator--tone-matrix",
        "name": "Tone Matrix",
        "title": "Cloaked Design System/Status/StatusIndicator",
        "exportName": "ToneMatrix",
        "source_path": "packages/design-system/src/components/status/StatusIndicator/StatusIndicator.stories.tsx",
        "source_digest": "b528d92737a07e2ca7b020ff5cfff6cc378a316d554aff381d5077549c15464b",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-status-statusindicator--tone-matrix&viewMode=story"
      },
      {
        "id": "cloaked-design-system-status-statusindicator--long-label",
        "name": "Long Label",
        "title": "Cloaked Design System/Status/StatusIndicator",
        "exportName": "LongLabel",
        "source_path": "packages/design-system/src/components/status/StatusIndicator/StatusIndicator.stories.tsx",
        "source_digest": "b528d92737a07e2ca7b020ff5cfff6cc378a316d554aff381d5077549c15464b",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-status-statusindicator--long-label&viewMode=story"
      },
      {
        "id": "cloaked-design-system-status-statusindicator--dark-theme",
        "name": "Dark Theme",
        "title": "Cloaked Design System/Status/StatusIndicator",
        "exportName": "DarkTheme",
        "source_path": "packages/design-system/src/components/status/StatusIndicator/StatusIndicator.stories.tsx",
        "source_digest": "b528d92737a07e2ca7b020ff5cfff6cc378a316d554aff381d5077549c15464b",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-status-statusindicator--dark-theme&viewMode=story"
      }
    ],
    "name": "StatusIndicator",
    "id": "statusindicator",
    "category": "Status"
  },
  "stories_source": {
    "path": "packages/design-system/src/components/status/StatusIndicator/StatusIndicator.stories.tsx",
    "code": "import React from 'react';\nimport type { Meta, StoryObj } from '@storybook/react-vite';\nimport { VStack } from '../../layout/VStack/VStack';\nimport { STATUS_TONE_OPTIONS, selectArgType } from '../../../storybook/controlOptions';\nimport type { StatusTone } from '../../../styles/statusTone';\nimport { StatusIndicator } from './StatusIndicator';\n\nconst STATUS_TONES: StatusTone[] = [...STATUS_TONE_OPTIONS];\n\nconst meta: Meta<typeof StatusIndicator> = {\n    title: 'Cloaked Design System/Status/StatusIndicator',\n    component: StatusIndicator,\n    parameters: {\n        a11y: { test: 'error' },\n        docs: {\n            description: {\n                component:\n                    'A tone-colored dot beside plain label text — the inline, in-context way to show a status ' +\n                    'inside a card or list row. Shared across surfaces so a given status reads identically ' +\n                    'everywhere. Reach for `Tag` instead when you want a filled pill that stands on its own ' +\n                    '(emphasis, a count, standalone placement); StatusIndicator stays quiet and rides alongside ' +\n                    'other content.',\n            },\n        },\n    },\n    args: {\n        tone: 'neutral',\n        children: 'Queued',\n    },\n    argTypes: {\n        tone: {\n            ...selectArgType(STATUS_TONE_OPTIONS),\n            description: 'Semantic status color applied to the dot (maps to `--cds-status-*`).',\n        },\n        children: { control: 'text', description: 'Visible status label.' },\n    },\n};\nexport default meta;\ntype Story = StoryObj<typeof StatusIndicator>;\n\nexport const Playground: Story = {};\n\nexport const ToneMatrix: Story = {\n    parameters: {\n        docs: { description: { story: 'Every `tone` in the status vocabulary.' } },\n    },\n    render: () => (\n        <VStack gap={12}>\n            {STATUS_TONES.map(tone => (\n                <StatusIndicator key={tone} tone={tone}>\n                    {tone}\n                </StatusIndicator>\n            ))}\n        </VStack>\n    ),\n};\n\nexport const LongLabel: Story = {\n    parameters: {\n        docs: { description: { story: 'Longer label to confirm the dot stays aligned as text wraps.' } },\n    },\n    args: {\n        tone: 'warning',\n        children: 'Verification still in progress',\n    },\n};\n\nexport const DarkTheme: Story = {\n    parameters: {\n        docs: { description: { story: 'Rendered against the dark theme surface.' } },\n    },\n    args: {\n        tone: 'success',\n        children: 'Protected',\n    },\n    globals: { theme: 'dark' },\n};\n"
  },
  "specification": {
    "$schema": "../../../specs/component-spec.schema.json",
    "identity": {
      "name": "StatusIndicator",
      "status": "preview",
      "version": "1.0.0",
      "summary": "A quiet inline status: a tone-colored dot beside neutral label text, shared across card and list surfaces."
    },
    "parts": [
      {
        "id": "root",
        "label": "Root",
        "description": "Pill that seats the dot and label with a rounded surface.",
        "required": true
      },
      {
        "id": "dot",
        "label": "Dot",
        "description": "Tone-colored status dot."
      },
      {
        "id": "label",
        "label": "Label",
        "description": "Neutral status text."
      }
    ],
    "allowedDesignChoices": {
      "variants": {
        "indicator": {
          "label": "Indicator",
          "description": "The single dot-plus-label treatment."
        }
      },
      "sizes": {},
      "tones": {
        "neutral": {
          "label": "Neutral"
        },
        "info": {
          "label": "Info"
        },
        "success": {
          "label": "Success"
        },
        "warning": {
          "label": "Warning"
        },
        "danger": {
          "label": "Danger"
        }
      }
    },
    "variants": [
      {
        "id": "indicator",
        "label": "Indicator",
        "description": "Dot beside a neutral label.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      }
    ],
    "sizes": [],
    "measurements": [
      {
        "id": "min-height",
        "label": "Minimum height",
        "kind": "exact",
        "token": "--cds-size-32",
        "value": 32,
        "unit": "px",
        "appliesTo": [
          "root"
        ]
      },
      {
        "id": "content-gap",
        "label": "Dot and label gap",
        "kind": "exact",
        "token": "--cds-space-4",
        "value": 4,
        "unit": "px",
        "appliesTo": [
          "root",
          "dot",
          "label"
        ]
      },
      {
        "id": "corner-radius",
        "label": "Corner radius",
        "kind": "exact",
        "token": "--cds-radius-xl",
        "value": 24,
        "unit": "px",
        "appliesTo": [
          "root"
        ]
      }
    ],
    "layout": {
      "alignment": "Dot and label center vertically inside the pill.",
      "flow": "A single inline pill with a leading dot and trailing label.",
      "notes": [
        "Use Tag when you need a filled pill that stands on its own with a count or emphasis."
      ]
    },
    "typographyAndColor": {
      "typography": [
        {
          "label": "Label",
          "description": "Uses the link ramp for compact status text.",
          "token": "--cds-type-link-size"
        }
      ],
      "colors": [
        {
          "label": "Surface",
          "description": "The pill sits on the page background.",
          "token": "--cds-bg-page"
        },
        {
          "label": "Label",
          "description": "Neutral primary text for the label.",
          "token": "--cds-text-primary"
        },
        {
          "label": "Dot",
          "description": "The dot uses the tone solid color.",
          "token": "--cds-status-success-solid"
        }
      ]
    },
    "states": [
      {
        "id": "neutral",
        "label": "Neutral",
        "description": "Neutral tone dot."
      },
      {
        "id": "info",
        "label": "Info",
        "description": "Info tone dot."
      },
      {
        "id": "success",
        "label": "Success",
        "description": "Success tone dot."
      },
      {
        "id": "warning",
        "label": "Warning",
        "description": "Warning tone dot."
      },
      {
        "id": "danger",
        "label": "Danger",
        "description": "Danger tone dot."
      }
    ],
    "behavior": [
      {
        "label": "Tone",
        "description": "Set tone to color only the dot; the label stays neutral for legibility."
      },
      {
        "label": "Shared surface",
        "description": "Reuse it in cards and list rows so a status reads identically everywhere."
      }
    ],
    "accessibility": [
      {
        "label": "Visible meaning",
        "description": "The label text carries the status; the dot is a supporting visual."
      },
      {
        "label": "Contrast",
        "description": "Neutral label text keeps contrast independent of the tone color."
      }
    ],
    "contentAdaptation": [
      {
        "label": "Concise label",
        "description": "Use a short status word; the pill does not wrap."
      },
      {
        "label": "Alignment",
        "description": "The dot stays aligned to the label as surrounding content shifts."
      }
    ],
    "motionHaptics": {
      "motion": [
        {
          "label": "Static",
          "description": "Changing tone recolors the dot without animation."
        }
      ],
      "haptics": [
        {
          "label": "No feedback",
          "description": "StatusIndicator is non-interactive and requests no haptics."
        }
      ]
    },
    "platformDifferences": []
  },
  "specification_source": "packages/design-system/src/components/status/StatusIndicator/StatusIndicator.spec.json",
  "guidance": {
    "summary": "A quiet inline status: a tone-colored dot beside neutral label text, shared across card and list surfaces.",
    "guidance": [
      {
        "heading": "Overview",
        "body": "A tone-colored dot beside plain label text — the quietest, in-context way to show a\nstatus inside a card or list row. `tone` sets the dot color. Reach for `Tag` when you\nwant a filled standalone pill (emphasis, a count) or the Figma active/inactive\ntreatment."
      },
      {
        "heading": "Use when",
        "body": "`tone` maps to the `--pui-status-*` vocabulary. StatusIndicator has no current\nconsumers in the app — it is the shared primitive that card and list-row statuses are\nmeant to compose, so a status reads identically everywhere."
      }
    ],
    "usage": [
      {
        "variant": "neutral",
        "use": "The default — a quiet, uncolored dot for an inactive or unremarkable state (queued, idle).",
        "axis": "Tone"
      },
      {
        "variant": "info",
        "use": "An in-progress or informational state.",
        "axis": "Tone"
      },
      {
        "variant": "success",
        "use": "A good or complete state — protected, done.",
        "axis": "Tone"
      },
      {
        "variant": "warning",
        "use": "A state that needs attention but is not a failure.",
        "axis": "Tone"
      },
      {
        "variant": "danger",
        "use": "A failed or at-risk state.",
        "axis": "Tone"
      }
    ],
    "examples": [],
    "source": "packages/design-system/src/components/status/StatusIndicator/StatusIndicator.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."
  },
  "links": {
    "human": "/component-statusindicator",
    "json": "/data/visual/components/statusindicator.json",
    "storybook": "/storybook/?path=/story/cloaked-design-system-status-statusindicator--playground"
  }
}