{
  "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": "halfgauge",
  "name": "HalfGauge",
  "category": "Visualizations",
  "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-visualizations-halfgauge--default",
        "name": "Default",
        "title": "Cloaked Design System/Visualizations/HalfGauge",
        "exportName": "Default",
        "source_path": "packages/design-system/src/components/visualizations/HalfGauge/HalfGauge.stories.tsx",
        "source_digest": "69be361e52e2ead56f0a659814b82562afa916fb67a5bdd1944b7c12ebc9fdf7",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-visualizations-halfgauge--default&viewMode=story"
      },
      {
        "id": "cloaked-design-system-visualizations-halfgauge--empty",
        "name": "Empty",
        "title": "Cloaked Design System/Visualizations/HalfGauge",
        "exportName": "Empty",
        "source_path": "packages/design-system/src/components/visualizations/HalfGauge/HalfGauge.stories.tsx",
        "source_digest": "69be361e52e2ead56f0a659814b82562afa916fb67a5bdd1944b7c12ebc9fdf7",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-visualizations-halfgauge--empty&viewMode=story"
      },
      {
        "id": "cloaked-design-system-visualizations-halfgauge--full",
        "name": "Full",
        "title": "Cloaked Design System/Visualizations/HalfGauge",
        "exportName": "Full",
        "source_path": "packages/design-system/src/components/visualizations/HalfGauge/HalfGauge.stories.tsx",
        "source_digest": "69be361e52e2ead56f0a659814b82562afa916fb67a5bdd1944b7c12ebc9fdf7",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-visualizations-halfgauge--full&viewMode=story"
      },
      {
        "id": "cloaked-design-system-visualizations-halfgauge--clamped-over-max",
        "name": "Clamped Over Max",
        "title": "Cloaked Design System/Visualizations/HalfGauge",
        "exportName": "ClampedOverMax",
        "source_path": "packages/design-system/src/components/visualizations/HalfGauge/HalfGauge.stories.tsx",
        "source_digest": "69be361e52e2ead56f0a659814b82562afa916fb67a5bdd1944b7c12ebc9fdf7",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-visualizations-halfgauge--clamped-over-max&viewMode=story"
      },
      {
        "id": "cloaked-design-system-visualizations-halfgauge--dark-theme",
        "name": "Dark Theme",
        "title": "Cloaked Design System/Visualizations/HalfGauge",
        "exportName": "DarkTheme",
        "source_path": "packages/design-system/src/components/visualizations/HalfGauge/HalfGauge.stories.tsx",
        "source_digest": "69be361e52e2ead56f0a659814b82562afa916fb67a5bdd1944b7c12ebc9fdf7",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-visualizations-halfgauge--dark-theme&viewMode=story"
      }
    ],
    "name": "HalfGauge",
    "id": "halfgauge",
    "category": "Visualizations"
  },
  "stories_source": {
    "path": "packages/design-system/src/components/visualizations/HalfGauge/HalfGauge.stories.tsx",
    "code": "import type { Meta, StoryObj } from '@storybook/react-vite';\nimport { HalfGauge } from './HalfGauge';\n\nconst meta: Meta<typeof HalfGauge> = {\n    title: 'Cloaked Design System/Visualizations/HalfGauge',\n    component: HalfGauge,\n    parameters: {\n        a11y: { test: 'error' },\n        docs: {\n            description: {\n                component:\n                    'A semicircular 0–100 dial for a single neutral progress or score value — \"how far ' +\n                    'toward complete.\" Values are clamped to 0–100. Use it when the number is a share or ' +\n                    'completion with no severity meaning. Reach for `RiskMeter` instead when the value ' +\n                    'sits on a severity scale (its track carries a low→high risk gradient and supports a ' +\n                    '`thumb` vs `pointer` marker); use `Progress` for a plain linear bar.',\n            },\n        },\n    },\n    argTypes: {\n        value: {\n            control: { type: 'range', min: 0, max: 100, step: 1 },\n            description: 'Gauge fill from 0 to 100; values outside the range are clamped.',\n        },\n        ariaLabel: { control: 'text', description: 'Accessible label; sets `role=\"img\"`.' },\n        testId: { control: 'text', description: 'Test selector on the gauge root.' },\n    },\n};\nexport default meta;\ntype Story = StoryObj<typeof HalfGauge>;\n\nexport const Default: Story = { args: { value: 64, ariaLabel: 'Gauge progress' } };\nexport const Empty: Story = {\n    parameters: { docs: { description: { story: 'Zero fill — the minimum.' } } },\n    args: { value: 0, ariaLabel: 'Empty gauge progress' },\n};\nexport const Full: Story = {\n    parameters: { docs: { description: { story: 'Fully swept dial at 100.' } } },\n    args: { value: 100, ariaLabel: 'Full gauge progress' },\n};\nexport const ClampedOverMax: Story = {\n    parameters: { docs: { description: { story: '140 clamps to 100 — out-of-range values never overflow.' } } },\n    args: { value: 140, ariaLabel: 'Clamped gauge progress' },\n};\nexport const DarkTheme: Story = { args: { value: 64, ariaLabel: 'Gauge progress' }, globals: { theme: 'dark' } };\n"
  },
  "specification": {
    "$schema": "../../../specs/component-spec.schema.json",
    "identity": {
      "name": "HalfGauge",
      "status": "preview",
      "version": "1.0.0",
      "summary": "A semicircular 0-100 dial for a single neutral progress or score value, with a low-to-high gradient sweep and clamped out-of-range input."
    },
    "parts": [
      {
        "id": "dial",
        "label": "Dial",
        "description": "The semicircular SVG that scales to its container.",
        "required": true
      },
      {
        "id": "track",
        "label": "Track",
        "description": "The unfilled arc behind the value sweep."
      },
      {
        "id": "value-arc",
        "label": "Value arc",
        "description": "The gradient arc swept from empty to the value."
      }
    ],
    "allowedDesignChoices": {
      "variants": {
        "base": {
          "label": "Base",
          "description": "The value changes the sweep without changing the dial treatment."
        }
      },
      "sizes": {}
    },
    "variants": [
      {
        "id": "base",
        "label": "Base",
        "description": "A single gradient semicircle swept to the clamped value.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      }
    ],
    "sizes": [],
    "measurements": [
      {
        "id": "max-width",
        "label": "Maximum rendered width",
        "kind": "example-only",
        "token": "--cds-size-120",
        "value": 120,
        "unit": "px",
        "appliesTo": [
          "dial"
        ],
        "notes": "The dial otherwise fills 100% of its container. Its width cap is --cds-size-120 minus --cds-size-8 for optical balance; the arc geometry itself is drawn in SVG view-box units, not tokens, so this is the only token-backed dimension and is example-only."
      }
    ],
    "layout": {
      "alignment": "The dial fills its container width up to the cap and keeps its 112-by-62 aspect.",
      "flow": "A single arc pair (track plus value) sharing one semicircular SVG.",
      "notes": [
        "The arc radius and stroke are SVG view-box units so the dial scales cleanly at any width."
      ]
    },
    "typographyAndColor": {
      "typography": [
        {
          "label": "Adjacent caption",
          "description": "Surrounding value or caption text uses the body-small ramp; the dial draws no text itself.",
          "token": "--cds-type-body-small-size"
        }
      ],
      "colors": [
        {
          "label": "Track",
          "description": "The unfilled arc behind the value.",
          "token": "--cds-graph-bg"
        },
        {
          "label": "Low value",
          "description": "The good end of the gradient sweep.",
          "token": "--cds-risk-good"
        },
        {
          "label": "Mid value",
          "description": "The fair midpoint of the gradient sweep.",
          "token": "--cds-risk-fair"
        },
        {
          "label": "High value",
          "description": "The critical end of the gradient sweep.",
          "token": "--cds-risk-critical"
        }
      ]
    },
    "states": [
      {
        "id": "value",
        "label": "Value shown",
        "description": "The arc sweeps to the clamped 0-100 value and exposes it to assistive technology."
      },
      {
        "id": "empty",
        "label": "Empty",
        "description": "A zero value shows the track with no swept arc."
      },
      {
        "id": "clamped",
        "label": "Clamped",
        "description": "Out-of-range values are pinned to 0 or 100 so the arc never overflows."
      }
    ],
    "behavior": [
      {
        "label": "Clamped value",
        "description": "Values outside 0-100 are clamped so the sweep stays within the arc."
      },
      {
        "label": "Neutral meaning",
        "description": "Use HalfGauge for completion or share values with no severity meaning."
      },
      {
        "label": "Scales to width",
        "description": "The dial fills its container up to its width cap and keeps a fixed aspect."
      }
    ],
    "accessibility": [
      {
        "label": "Meaningful value",
        "description": "Pass an accessible label so the dial exposes a progressbar with min, max, and the value."
      },
      {
        "label": "Decorative dial",
        "description": "Omit the label to hide the dial from assistive technology when nearby text states the value."
      }
    ],
    "contentAdaptation": [
      {
        "label": "Neutral vs severity",
        "description": "Use HalfGauge for neutral completion; use RiskMeter when the value sits on a severity scale."
      },
      {
        "label": "One value only",
        "description": "Use CategoryBars instead when comparing several values rather than showing one."
      }
    ],
    "motionHaptics": {
      "motion": [
        {
          "label": "Sweep transition",
          "description": "The value arc eases to a new sweep; honor reduced-motion by letting the platform shorten it."
        }
      ],
      "haptics": [
        {
          "label": "No feedback",
          "description": "The dial is a display and requests no haptic feedback."
        }
      ]
    },
    "platformDifferences": []
  },
  "specification_source": "packages/design-system/src/components/visualizations/HalfGauge/HalfGauge.spec.json",
  "guidance": {
    "summary": "A semicircular 0-100 dial for a single neutral progress or score value, with a low-to-high gradient sweep and clamped out-of-range input.",
    "guidance": [
      {
        "heading": "Overview",
        "body": "A semicircular 0-100 dial for a single neutral progress or score value — \"how far toward\ncomplete.\""
      },
      {
        "heading": "When to use",
        "body": "Use HalfGauge for one bounded value that reads as a share or completion with no severity\nmeaning; values outside 0-100 are clamped.\n\nReach for `RiskMeter` instead when the value sits on a severity scale — its track carries a\nlow-to-high risk gradient and supports a `thumb` vs `pointer` marker. Use `Progress` for a\nplain linear bar, and `CategoryBars` when you are comparing several values rather than showing\none.\n\nNot currently used in the app."
      }
    ],
    "usage": [],
    "examples": [],
    "source": "packages/design-system/src/components/visualizations/HalfGauge/HalfGauge.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-halfgauge",
    "json": "/data/visual/components/halfgauge.json",
    "storybook": "/storybook/?path=/story/cloaked-design-system-visualizations-halfgauge--default"
  }
}