{
  "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": "selectioncard",
  "name": "SelectionCard",
  "category": "Cards",
  "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-cards-selectioncard--playground",
        "name": "Playground",
        "title": "Cloaked Design System/Cards/SelectionCard",
        "exportName": "Playground",
        "source_path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.stories.tsx",
        "source_digest": "52393abba376bc2c8f1b0be0645a0d5c1120fa2f4d16dbc92373c84542672727",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-cards-selectioncard--playground&viewMode=story"
      },
      {
        "id": "cloaked-design-system-cards-selectioncard--selected",
        "name": "Selected",
        "title": "Cloaked Design System/Cards/SelectionCard",
        "exportName": "Selected",
        "source_path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.stories.tsx",
        "source_digest": "52393abba376bc2c8f1b0be0645a0d5c1120fa2f4d16dbc92373c84542672727",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-cards-selectioncard--selected&viewMode=story"
      },
      {
        "id": "cloaked-design-system-cards-selectioncard--muted-surface",
        "name": "Muted Surface",
        "title": "Cloaked Design System/Cards/SelectionCard",
        "exportName": "MutedSurface",
        "source_path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.stories.tsx",
        "source_digest": "52393abba376bc2c8f1b0be0645a0d5c1120fa2f4d16dbc92373c84542672727",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-cards-selectioncard--muted-surface&viewMode=story"
      },
      {
        "id": "cloaked-design-system-cards-selectioncard--no-control",
        "name": "No Control",
        "title": "Cloaked Design System/Cards/SelectionCard",
        "exportName": "NoControl",
        "source_path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.stories.tsx",
        "source_digest": "52393abba376bc2c8f1b0be0645a0d5c1120fa2f4d16dbc92373c84542672727",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-cards-selectioncard--no-control&viewMode=story"
      },
      {
        "id": "cloaked-design-system-cards-selectioncard--full-span",
        "name": "Full Span",
        "title": "Cloaked Design System/Cards/SelectionCard",
        "exportName": "FullSpan",
        "source_path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.stories.tsx",
        "source_digest": "52393abba376bc2c8f1b0be0645a0d5c1120fa2f4d16dbc92373c84542672727",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-cards-selectioncard--full-span&viewMode=story"
      },
      {
        "id": "cloaked-design-system-cards-selectioncard--disabled",
        "name": "Disabled",
        "title": "Cloaked Design System/Cards/SelectionCard",
        "exportName": "Disabled",
        "source_path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.stories.tsx",
        "source_digest": "52393abba376bc2c8f1b0be0645a0d5c1120fa2f4d16dbc92373c84542672727",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-cards-selectioncard--disabled&viewMode=story"
      },
      {
        "id": "cloaked-design-system-cards-selectioncard--dark-theme",
        "name": "Dark Theme",
        "title": "Cloaked Design System/Cards/SelectionCard",
        "exportName": "DarkTheme",
        "source_path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.stories.tsx",
        "source_digest": "52393abba376bc2c8f1b0be0645a0d5c1120fa2f4d16dbc92373c84542672727",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-cards-selectioncard--dark-theme&viewMode=story"
      }
    ],
    "name": "SelectionCard",
    "id": "selectioncard",
    "category": "Cards"
  },
  "stories_source": {
    "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.stories.tsx",
    "code": "import type { Meta, StoryObj } from '@storybook/react-vite';\nimport {\n    SelectionCard,\n    type SelectionCardControl,\n    type SelectionCardGridSpan,\n    type SelectionCardSurface,\n    type SelectionCardVariant,\n} from './SelectionCard';\nimport { disabledControl, hapticArgType, selectArgType } from '../../../storybook/controlOptions';\n\nconst SELECTION_CARD_VARIANTS = ['default'] as const satisfies readonly SelectionCardVariant[];\nconst SELECTION_CARD_GRID_SPANS = ['auto', 'full'] as const satisfies readonly SelectionCardGridSpan[];\nconst SELECTION_CARD_CONTROLS = ['checkbox', 'none'] as const satisfies readonly SelectionCardControl[];\nconst SELECTION_CARD_SURFACES = ['default', 'muted'] as const satisfies readonly SelectionCardSurface[];\n\nconst meta: Meta<typeof SelectionCard> = {\n    title: 'Cloaked Design System/Cards/SelectionCard',\n    component: SelectionCard,\n    parameters: {\n        a11y: { test: 'error' },\n        docs: {\n            description: {\n                component:\n                    'A tappable card for choice grids. The card is stateless — drive `selected` from parent state and ' +\n                    'toggle it inside `onSelect`. Use `control=\"checkbox\"` for multi-select lists, where the check circle ' +\n                    'signals \"pick any\"; use `control=\"none\"` for single-select groups, where the highlighted border alone ' +\n                    'conveys the pick. Reach for `RadioGroup` when the options are short text-only rows rather than titled ' +\n                    'cards with supporting copy.',\n            },\n        },\n    },\n    args: {\n        title: 'Data removal',\n        description: 'Remove your personal data from broker sites',\n        selected: false,\n    },\n    argTypes: {\n        children: disabledControl,\n        title: { control: 'text', description: 'Primary label rendered when no custom `children` are supplied.' },\n        description: { control: 'text', description: 'Supporting copy shown beneath the title.' },\n        variant: {\n            ...selectArgType(SELECTION_CARD_VARIANTS),\n            description:\n                'Layout treatment. Only `default` exists today; the prop is kept open for future option styles.',\n        },\n        gridSpan: {\n            ...selectArgType(SELECTION_CARD_GRID_SPANS),\n            description:\n                '`full` spans every column of a parent grid (`grid-column: 1 / -1`); `auto` occupies one cell.',\n        },\n        control: {\n            ...selectArgType(SELECTION_CARD_CONTROLS),\n            description:\n                'Selection affordance: `checkbox` shows a check circle (multi-select), `none` hides it (single-select).',\n        },\n        surface: {\n            ...selectArgType(SELECTION_CARD_SURFACES),\n            description: 'Background token: `default` uses `--cds-bg-surface`, `muted` uses `--cds-divider`.',\n        },\n        selected: {\n            control: 'boolean',\n            description: 'Selected state — adds the brand border and fills the check circle.',\n        },\n        disabled: { control: 'boolean', description: 'Blocks taps and dims the card via `--cds-opacity-disabled`.' },\n        onSelect: disabledControl,\n        haptic: hapticArgType,\n    },\n};\nexport default meta;\ntype Story = StoryObj<typeof SelectionCard>;\n\nexport const Playground: Story = {\n    args: { onSelect: () => undefined, testId: 'selection-card-playground' },\n};\n\nexport const Selected: Story = {\n    args: { selected: true, onSelect: () => undefined, testId: 'selection-card-selected' },\n    parameters: {\n        docs: { description: { story: 'Selected state: brand border plus the filled check circle.' } },\n    },\n};\n\nexport const MutedSurface: Story = {\n    args: { surface: 'muted', onSelect: () => undefined, testId: 'selection-card-muted' },\n    parameters: {\n        docs: {\n            description: { story: 'The `muted` surface sits the card on `--cds-divider` for lower-emphasis groups.' },\n        },\n    },\n};\n\nexport const NoControl: Story = {\n    args: { control: 'none', selected: true, onSelect: () => undefined, testId: 'selection-card-no-control' },\n    parameters: {\n        docs: {\n            description: {\n                story: 'Single-select style: `control=\"none\"` drops the check circle so the highlight alone marks the pick.',\n            },\n        },\n    },\n};\n\nexport const FullSpan: Story = {\n    args: { gridSpan: 'full', onSelect: () => undefined, testId: 'selection-card-full-span' },\n    parameters: {\n        docs: { description: { story: '`gridSpan=\"full\"` breaks the card out to the full width of a card grid.' } },\n    },\n};\n\nexport const Disabled: Story = {\n    args: { disabled: true, onSelect: () => undefined, testId: 'selection-card-disabled' },\n    parameters: {\n        docs: { description: { story: 'Disabled cards ignore taps and dim via `--cds-opacity-disabled`.' } },\n    },\n};\n\nexport const DarkTheme: Story = {\n    args: { selected: true, onSelect: () => undefined, testId: 'selection-card-dark' },\n    globals: { theme: 'dark' },\n};\n"
  },
  "specification": {
    "$schema": "../../../specs/component-spec.schema.json",
    "identity": {
      "name": "SelectionCard",
      "status": "preview",
      "version": "1.0.0",
      "summary": "A tappable option card for choice grids, with a title, description, optional check control, and selected state."
    },
    "parts": [
      {
        "id": "root",
        "label": "Root",
        "description": "Pressable card carrying the surface, selected border, and layout.",
        "required": true
      },
      {
        "id": "content",
        "label": "Content",
        "description": "Title and description column."
      },
      {
        "id": "indicator",
        "label": "Indicator",
        "description": "Optional selection check control."
      }
    ],
    "allowedDesignChoices": {
      "variants": {
        "default": {
          "label": "Default",
          "description": "The single card layout; kept open for future option styles."
        }
      },
      "sizes": {},
      "surfaces": {
        "default": {
          "label": "Default",
          "description": "Raised surface background."
        },
        "muted": {
          "label": "Muted",
          "description": "Divider-toned background for lower-emphasis groups."
        }
      },
      "controls": {
        "checkbox": {
          "label": "Checkbox",
          "description": "Shows a check circle for multi-select lists."
        },
        "none": {
          "label": "None",
          "description": "Hides the check so the highlight border alone marks the pick."
        }
      },
      "gridSpans": {
        "auto": {
          "label": "Auto",
          "description": "Occupies one cell of a parent grid."
        },
        "full": {
          "label": "Full",
          "description": "Spans every column of a parent grid."
        }
      }
    },
    "variants": [
      {
        "id": "default",
        "label": "Default",
        "description": "Standard selectable option card.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      }
    ],
    "sizes": [],
    "measurements": [
      {
        "id": "row-min-height",
        "label": "Minimum height",
        "kind": "exact",
        "token": "--cds-size-80",
        "value": 80,
        "unit": "px",
        "appliesTo": [
          "root"
        ]
      },
      {
        "id": "content-inset",
        "label": "Content inset",
        "kind": "exact",
        "token": "--cds-space-20",
        "value": 20,
        "unit": "px",
        "appliesTo": [
          "root"
        ]
      },
      {
        "id": "content-gap",
        "label": "Content and control gap",
        "kind": "exact",
        "token": "--cds-space-16",
        "value": 16,
        "unit": "px",
        "appliesTo": [
          "root"
        ]
      },
      {
        "id": "corner-radius",
        "label": "Corner radius",
        "kind": "exact",
        "token": "--cds-radius-md",
        "value": 16,
        "unit": "px",
        "appliesTo": [
          "root"
        ]
      },
      {
        "id": "selection-border",
        "label": "Selection border width",
        "kind": "exact",
        "token": "--cds-border-width-emphasis",
        "value": 2,
        "unit": "px",
        "appliesTo": [
          "root"
        ]
      }
    ],
    "layout": {
      "alignment": "Content column and optional control sit centered on the card's vertical center.",
      "flow": "A pressable row: flexible content followed by the optional selection control.",
      "notes": [
        "Use RadioGroup when the options are short text-only rows rather than titled cards."
      ]
    },
    "typographyAndColor": {
      "typography": [
        {
          "label": "Title",
          "description": "Uses the body ramp.",
          "token": "--cds-type-body-size"
        },
        {
          "label": "Description",
          "description": "Uses the body-small ramp.",
          "token": "--cds-type-body-small-size"
        }
      ],
      "colors": [
        {
          "label": "Surface",
          "description": "Default cards use the raised surface.",
          "token": "--cds-bg-surface"
        },
        {
          "label": "Muted surface",
          "description": "Muted cards use the divider color.",
          "token": "--cds-divider"
        },
        {
          "label": "Selected border",
          "description": "Selection uses the brand border.",
          "token": "--cds-brand"
        }
      ]
    },
    "states": [
      {
        "id": "default",
        "label": "Default",
        "description": "Unselected card with a transparent border."
      },
      {
        "id": "selected",
        "label": "Selected",
        "description": "Brand border plus a filled check control."
      },
      {
        "id": "disabled",
        "label": "Disabled",
        "description": "Blocks taps and dims via the disabled opacity."
      }
    ],
    "behavior": [
      {
        "label": "Stateless",
        "description": "Drive selected from parent state and toggle it inside onSelect."
      },
      {
        "label": "Control mode",
        "description": "Use checkbox for multi-select and none for single-select groups."
      }
    ],
    "accessibility": [
      {
        "label": "Pressed state",
        "description": "The card is a button exposing aria-pressed for its selected state."
      },
      {
        "label": "Accessible name",
        "description": "Provide ariaLabel when the visible copy is custom or absent."
      }
    ],
    "contentAdaptation": [
      {
        "label": "Custom children",
        "description": "Custom children replace the default title/description block."
      },
      {
        "label": "Grid span",
        "description": "gridSpan=full breaks the card out to the full grid width."
      }
    ],
    "motionHaptics": {
      "motion": [
        {
          "label": "Border transition",
          "description": "The selection border eases in on state change."
        }
      ],
      "haptics": [
        {
          "label": "Selection haptic",
          "description": "Selecting an enabled card requests the selection haptic."
        }
      ]
    },
    "platformDifferences": []
  },
  "specification_source": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.spec.json",
  "guidance": {
    "summary": "A tappable option card for choice grids, with a title, description, optional check control, and selected state.",
    "guidance": [
      {
        "heading": "Overview",
        "body": "A tappable card for choice grids. `control` encodes the selection model. The card is stateless —\ndrive `selected` from parent state and toggle it inside `onSelect`. For short text-only options, use\n`RadioGroup` instead."
      },
      {
        "heading": "Use when",
        "body": "`control` picks the affordance, which in turn signals how many options a user may choose.\n\nBoth values are live in the questionnaire, chosen per question type (`single` → `none`, multi →\n`checkbox`). `surface=\"muted\"` and the `variant` prop (only `default` today) exist for future styles\nbut are not yet used in app code."
      },
      {
        "heading": "Selected state",
        "body": "Selection adds the brand border and, for `checkbox`, fills the check circle."
      }
    ],
    "usage": [
      {
        "variant": "checkbox",
        "use": "Multi-select lists — the check circle signals \"pick any.\" The default when `control` is omitted.",
        "avoid": "Single-select groups, where a check circle wrongly implies multiple picks are allowed.",
        "axis": "Control"
      },
      {
        "variant": "none",
        "use": "Single-select groups — the highlighted brand border alone marks the one pick, no check circle.",
        "avoid": "Multi-select, where users need a persistent per-option checkbox to track several selections.",
        "axis": "Control"
      }
    ],
    "examples": [],
    "source": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.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-selectioncard",
    "json": "/data/visual/components/selectioncard.json",
    "storybook": "/storybook/?path=/story/cloaked-design-system-cards-selectioncard--playground"
  }
}