{
  "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": "actionorbs",
  "name": "ActionOrbs",
  "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-actionorbs--default",
        "name": "Default",
        "title": "Cloaked Design System/Visualizations/ActionOrbs",
        "exportName": "Default",
        "source_path": "packages/design-system/src/components/visualizations/ActionOrbs/ActionOrbs.stories.tsx",
        "source_digest": "bc3978f3bbcc3423204789b31d9631c9c095cb2aabd0a5e429cf4301b0adc55b",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-visualizations-actionorbs--default&viewMode=story"
      },
      {
        "id": "cloaked-design-system-visualizations-actionorbs--balanced",
        "name": "Balanced",
        "title": "Cloaked Design System/Visualizations/ActionOrbs",
        "exportName": "Balanced",
        "source_path": "packages/design-system/src/components/visualizations/ActionOrbs/ActionOrbs.stories.tsx",
        "source_digest": "bc3978f3bbcc3423204789b31d9631c9c095cb2aabd0a5e429cf4301b0adc55b",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-visualizations-actionorbs--balanced&viewMode=story"
      },
      {
        "id": "cloaked-design-system-visualizations-actionorbs--empty",
        "name": "Empty",
        "title": "Cloaked Design System/Visualizations/ActionOrbs",
        "exportName": "Empty",
        "source_path": "packages/design-system/src/components/visualizations/ActionOrbs/ActionOrbs.stories.tsx",
        "source_digest": "bc3978f3bbcc3423204789b31d9631c9c095cb2aabd0a5e429cf4301b0adc55b",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-visualizations-actionorbs--empty&viewMode=story"
      },
      {
        "id": "cloaked-design-system-visualizations-actionorbs--constrained-width",
        "name": "Constrained Width",
        "title": "Cloaked Design System/Visualizations/ActionOrbs",
        "exportName": "ConstrainedWidth",
        "source_path": "packages/design-system/src/components/visualizations/ActionOrbs/ActionOrbs.stories.tsx",
        "source_digest": "bc3978f3bbcc3423204789b31d9631c9c095cb2aabd0a5e429cf4301b0adc55b",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-visualizations-actionorbs--constrained-width&viewMode=story"
      },
      {
        "id": "cloaked-design-system-visualizations-actionorbs--dark-theme",
        "name": "Dark Theme",
        "title": "Cloaked Design System/Visualizations/ActionOrbs",
        "exportName": "DarkTheme",
        "source_path": "packages/design-system/src/components/visualizations/ActionOrbs/ActionOrbs.stories.tsx",
        "source_digest": "bc3978f3bbcc3423204789b31d9631c9c095cb2aabd0a5e429cf4301b0adc55b",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-visualizations-actionorbs--dark-theme&viewMode=story"
      }
    ],
    "name": "ActionOrbs",
    "id": "actionorbs",
    "category": "Visualizations"
  },
  "stories_source": {
    "path": "packages/design-system/src/components/visualizations/ActionOrbs/ActionOrbs.stories.tsx",
    "code": "import React from 'react';\nimport type { Meta, StoryObj } from '@storybook/react-vite';\nimport { disabledControl } from '../../../storybook/controlOptions';\nimport { ActionOrbs } from './ActionOrbs';\n\nconst items = [\n    { id: 'data-removal', label: 'Data removed', value: 3840, color: '#62c081' },\n    { id: 'spam', label: 'Spam blocked', value: 1460, color: '#2a9ae8' },\n    { id: 'identity', label: 'Identities created', value: 16, color: '#a474ff' },\n];\n\nconst meta: Meta<typeof ActionOrbs> = {\n    title: 'Cloaked Design System/Visualizations/ActionOrbs',\n    component: ActionOrbs,\n    parameters: {\n        a11y: { test: 'error' },\n        docs: {\n            description: {\n                component:\n                    'Overlapping proportional circles for a small summary set (≈2–4 top-level action ' +\n                    'categories) — a hero \"here is what we did for you\" glance where relative magnitude ' +\n                    'matters more than exact counts. The orb areas scale to each `value`, so wildly ' +\n                    'uneven values read as one big orb plus small satellites. Reach for `CategoryBars` ' +\n                    'when you need a ranked list with readable numeric values, or `BarChart` when the ' +\n                    'data is a time series. Omit `color` to fall back to the built-in action-orb palette. ' +\n                    'The component fills its container width and scales with it.',\n            },\n        },\n    },\n    argTypes: {\n        items: {\n            ...disabledControl,\n            description: 'Action categories rendered as proportional orbs; orb area scales to `value`.',\n        },\n        ariaLabel: {\n            control: 'text',\n            description: 'Accessible label; sets `role=\"img\"`. Always provide one for meaningful data.',\n        },\n        testId: { control: 'text', description: 'Test selector on the chart root.' },\n    },\n};\nexport default meta;\ntype Story = StoryObj<typeof ActionOrbs>;\n\n// ActionOrbs fills its container width (and scales with it), so give stories a\n// representative card-width context to render in.\nconst width = (children: React.ReactNode) => <div style={{ width: 353, maxWidth: '100%' }}>{children}</div>;\n\nexport const Default: Story = {\n    decorators: [Story => width(<Story />)],\n    args: { items, ariaLabel: 'Actions taken by category' },\n};\n\nexport const Balanced: Story = {\n    decorators: [Story => width(<Story />)],\n    parameters: {\n        docs: {\n            description: {\n                story: 'Equal values render as equal orbs — the degenerate case that shows the area scaling is honest.',\n            },\n        },\n    },\n    args: {\n        items: items.map(item => ({ ...item, value: 20 })),\n        ariaLabel: 'Balanced actions taken by category',\n    },\n};\n\nexport const Empty: Story = {\n    decorators: [Story => width(<Story />)],\n    parameters: {\n        docs: { description: { story: 'No items — nothing renders; pair with an EmptyState upstream.' } },\n    },\n    args: { items: [], ariaLabel: 'No actions yet' },\n};\n\nexport const ConstrainedWidth: Story = {\n    parameters: {\n        docs: { description: { story: 'Narrower container — orbs scale down with the available width.' } },\n    },\n    render: args => (\n        <div style={{ width: 280, outline: '1px dashed var(--cds-divider)' }}>\n            <ActionOrbs {...args} />\n        </div>\n    ),\n    args: { items, ariaLabel: 'Constrained actions taken by category' },\n};\n\nexport const DarkTheme: Story = {\n    decorators: [Story => width(<Story />)],\n    globals: { theme: 'dark' },\n    args: { items, ariaLabel: 'Actions taken by category' },\n};\n"
  },
  "specification": {
    "$schema": "../../../specs/component-spec.schema.json",
    "identity": {
      "name": "ActionOrbs",
      "status": "preview",
      "version": "1.0.0",
      "summary": "Overlapping proportional circles for a small summary set, a hero glance where relative magnitude matters more than exact counts, with a gentle breathing motion."
    },
    "parts": [
      {
        "id": "field",
        "label": "Field",
        "description": "The container the orbs are absolutely placed within, sized by container width.",
        "required": true
      },
      {
        "id": "orb",
        "label": "Orb",
        "description": "A proportional circle whose area scales to its category value."
      },
      {
        "id": "orb-label",
        "label": "Orb label",
        "description": "The percentage ink centered inside each orb."
      }
    ],
    "allowedDesignChoices": {
      "variants": {
        "base": {
          "label": "Base",
          "description": "Category data changes the reading without changing the orb treatment."
        }
      },
      "sizes": {}
    },
    "variants": [
      {
        "id": "base",
        "label": "Base",
        "description": "Overlapping proportional orbs distributed across the field.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      }
    ],
    "sizes": [],
    "measurements": [
      {
        "id": "orb-radius",
        "label": "Orb corner radius",
        "kind": "exact",
        "token": "--cds-radius-full",
        "value": 9999,
        "unit": "px",
        "appliesTo": [
          "orb"
        ],
        "notes": "Each orb is fully rounded (a circle with aspect ratio 1); its diameter is data-driven from the category share, so only the corner radius is fixed."
      },
      {
        "id": "orb-diameter",
        "label": "Orb diameter",
        "kind": "example-only",
        "value": "share-driven",
        "unit": "none",
        "appliesTo": [
          "orb"
        ],
        "notes": "Diameters are a fraction of the container width proportional to each category value, so there is no fixed token size."
      }
    ],
    "layout": {
      "alignment": "Orbs are absolutely positioned within a fixed-aspect field and scale with its width.",
      "flow": "Overlapping circles layered by z-index, largest reading as the anchor.",
      "notes": [
        "The field uses container-query units so orbs scale with the available width."
      ]
    },
    "typographyAndColor": {
      "typography": [
        {
          "label": "Orb label",
          "description": "The percentage inside each orb sits near the body-small ramp.",
          "token": "--cds-type-body-small-size"
        }
      ],
      "colors": [
        {
          "label": "Orb blend",
          "description": "Each orb gradient blends its category color toward the surface.",
          "token": "--cds-bg-surface"
        },
        {
          "label": "Orb label",
          "description": "The percentage ink reads as inverse text over the colored orb.",
          "token": "--cds-text-inverse"
        },
        {
          "label": "Label shadow",
          "description": "A soft shadow tinted from primary text keeps the label legible.",
          "token": "--cds-text-primary"
        }
      ]
    },
    "states": [
      {
        "id": "populated",
        "label": "Populated",
        "description": "Two to four categories render as proportional overlapping orbs."
      },
      {
        "id": "balanced",
        "label": "Balanced",
        "description": "Equal values render equal orbs, showing the area scaling is honest."
      },
      {
        "id": "empty",
        "label": "Empty",
        "description": "No items renders nothing, so pair with an upstream empty state."
      }
    ],
    "behavior": [
      {
        "label": "Area scaling",
        "description": "Orb area scales to each value, so uneven values read as one anchor plus satellites."
      },
      {
        "label": "Small set",
        "description": "Keep the set small (roughly two to four categories) so orbs stay legible."
      },
      {
        "label": "Palette fallback",
        "description": "Omit a category color to fall back to the built-in action-orb palette."
      }
    ],
    "accessibility": [
      {
        "label": "Meaningful chart",
        "description": "Pass an accessible label so the field is announced as a meaningful image summarizing the actions."
      },
      {
        "label": "Values in a title",
        "description": "Each orb carries a label and percentage title so its meaning is exposed to assistive technology."
      }
    ],
    "contentAdaptation": [
      {
        "label": "Magnitude over precision",
        "description": "Use ActionOrbs for a proportional glance; use CategoryBars when exact counts must be read."
      },
      {
        "label": "Fills its width",
        "description": "The field fills and scales with the container, so give it a representative width."
      }
    ],
    "motionHaptics": {
      "motion": [
        {
          "label": "Breathing orbs",
          "description": "Orbs gently breathe on a staggered loop to feel alive without demanding attention."
        },
        {
          "label": "Reduced motion",
          "description": "When reduced motion is set the breathing stops and orbs hold a still, resolved position."
        }
      ],
      "haptics": [
        {
          "label": "No feedback",
          "description": "The chart is a display and requests no haptic feedback."
        }
      ]
    },
    "platformDifferences": []
  },
  "specification_source": "packages/design-system/src/components/visualizations/ActionOrbs/ActionOrbs.spec.json",
  "guidance": {
    "summary": "Overlapping proportional circles for a small summary set, a hero glance where relative magnitude matters more than exact counts, with a gentle breathing motion.",
    "guidance": [
      {
        "heading": "Overview",
        "body": "Overlapping proportional circles for a small summary set — a hero \"here is what we did for you\"\nglance."
      },
      {
        "heading": "When to use",
        "body": "Use ActionOrbs for roughly 2-4 top-level action categories where relative magnitude matters\nmore than exact counts. Orb areas scale to each `value`, so wildly uneven values read as one\nbig orb plus small satellites. Omit `color` to fall back to the built-in palette; the component\nfills its container width and scales with it.\n\nReach for `CategoryBars` when you need a ranked list with readable numeric values, or `BarChart`\nwhen the data is a time series. For a decorative many-category field, use `BubbleMatrix` or\n`BurstGraph`.\n\nNot currently used in the app."
      }
    ],
    "usage": [],
    "examples": [],
    "source": "packages/design-system/src/components/visualizations/ActionOrbs/ActionOrbs.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-actionorbs",
    "json": "/data/visual/components/actionorbs.json",
    "storybook": "/storybook/?path=/story/cloaked-design-system-visualizations-actionorbs--default"
  }
}