{
  "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",
  "summary": "A tappable option card for choice grids, with a title, description, optional check control, and selected state.",
  "documentation": {
    "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."
  },
  "source": {
    "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
    "code": "import React from 'react';\nimport { cn } from '../../../utilities';\nimport { useHaptic } from '../../../hooks/useHaptic';\nimport type { HapticFeedback } from '../../../tokens/CdsHaptic';\nimport { SelectionIndicator } from '../../primitives/SelectionIndicator/SelectionIndicator';\nimport { Text } from '../../primitives/Text/Text';\nimport styles from './SelectionCard.module.scss';\n\nexport type SelectionCardVariant = 'default';\nexport type SelectionCardGridSpan = 'auto' | 'full';\nexport type SelectionCardControl = 'checkbox' | 'none';\nexport type SelectionCardSurface = 'default' | 'muted';\n\n/**\n * Props for the selectable card. Selection is fully controlled: the card reports a tap through\n * `onSelect` and reflects whatever `selected` you pass back.\n */\nexport interface SelectionCardProps {\n    /** Leading line of the built-in content. Ignored when `children` is given. */\n    title?: string;\n    /** Secondary line under `title`, in the muted color. Ignored when `children` is given. */\n    description?: string;\n    children?: React.ReactNode;\n    className?: string;\n    style?: React.CSSProperties;\n    /** The only treatment today; it applies the card's 80px minimum height. */\n    variant?: SelectionCardVariant;\n    /** Column behavior inside a parent grid: one column, or `full` to span the row. */\n    gridSpan?: SelectionCardGridSpan;\n    /** Trailing indicator. Defaults to a checkbox; `none` hides it while the card stays tappable. */\n    control?: SelectionCardControl;\n    /** Card fill. Defaults to the standard surface; `muted` fills with the divider color. */\n    surface?: SelectionCardSurface;\n    /** Drives the brand border, the checkbox glyph, and `aria-pressed` together. */\n    selected?: boolean;\n    /** Blocks presses and greys the whole card, indicator included. */\n    disabled?: boolean;\n    /** Tap handler. Without it no click handler is attached and the card is inert. */\n    onSelect?: () => void;\n    /** Haptic feedback for selection. Defaults to `true` (`selection`). */\n    haptic?: HapticFeedback;\n    /** Accessible label when visible copy is custom or absent. */\n    ariaLabel?: string;\n    /** `data-testid` on the card `<button>`, which is the whole tap target. */\n    testId?: string;\n}\n\n/**\n * A card that is itself the selection control: the entire surface is one `<button>` reporting taps\n * through `onSelect`, with a checkbox indicator by default. Pass `children` to replace the built-in\n * title and description layout.\n */\nexport function SelectionCard({\n    title,\n    description,\n    children,\n    className,\n    style,\n    variant = 'default',\n    gridSpan = 'auto',\n    control,\n    surface = 'default',\n    selected = false,\n    disabled = false,\n    onSelect,\n    haptic = true,\n    ariaLabel,\n    testId,\n}: SelectionCardProps) {\n    const resolvedControl = control ?? 'checkbox';\n    const fireHaptic = useHaptic('selection');\n    const handleSelect = () => {\n        fireHaptic(haptic);\n        onSelect?.();\n    };\n\n    return (\n        <button\n            type='button'\n            className={cn(\n                styles.card,\n                styles[`variant-${variant}`],\n                styles[`gridSpan-${gridSpan}`],\n                styles[`surface-${surface}`],\n                selected && styles.selected,\n                className\n            )}\n            style={style}\n            aria-label={ariaLabel}\n            aria-pressed={selected}\n            onClick={onSelect ? handleSelect : undefined}\n            disabled={disabled}\n            data-testid={testId}\n        >\n            {children ?? (\n                <div className={styles.content}>\n                    {title && (\n                        <Text variant='body' color='primary'>\n                            {title}\n                        </Text>\n                    )}\n                    {description && (\n                        <Text variant='body-small' color='secondary'>\n                            {description}\n                        </Text>\n                    )}\n                </div>\n            )}\n            {resolvedControl === 'checkbox' && (\n                <SelectionIndicator selected={selected} glyph='check' disabled={disabled} />\n            )}\n        </button>\n    );\n}\n"
  },
  "spec": {
    "$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": []
  },
  "spec_source": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.spec.json",
  "guidance_source": {
    "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.mdx",
    "code": "import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';\nimport { ComponentSpec, UsageTable, Do, Dont, Compare } from '../../../../.storybook/blocks';\nimport * as Stories from './SelectionCard.stories';\nimport selectionCardSpec from './SelectionCard.spec.json';\n\n<Meta of={Stories} />\n\n# SelectionCard\n\nA 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.\n\n<Canvas of={Stories.Playground} />\n\n## Use when\n\n`control` picks the affordance, which in turn signals how many options a user may choose.\n\n<UsageTable\n    axis='Control'\n    rows={[\n        {\n            variant: 'checkbox',\n            use: 'Multi-select lists — the check circle signals \"pick any.\" The default when `control` is omitted.',\n            avoid: 'Single-select groups, where a check circle wrongly implies multiple picks are allowed.',\n        },\n        {\n            variant: 'none',\n            use: 'Single-select groups — the highlighted brand border alone marks the one pick, no check circle.',\n            avoid: 'Multi-select, where users need a persistent per-option checkbox to track several selections.',\n        },\n    ]}\n/>\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.\n\n## Selected state\n\nSelection adds the brand border and, for `checkbox`, fills the check circle.\n\n<Canvas of={Stories.Selected} />\n<Canvas of={Stories.NoControl} />\n\n## Design Guidelines\n\n<ComponentSpec spec={selectionCardSpec} />\n\n## Props\n\n<Controls of={Stories.Playground} />\n"
  },
  "props": [
    {
      "name": "title",
      "type": "string | undefined",
      "declared_type": "string",
      "required": false,
      "description": "Leading line of the built-in content. Ignored when `children` is given.",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 20
      }
    },
    {
      "name": "description",
      "type": "string | undefined",
      "declared_type": "string",
      "required": false,
      "description": "Secondary line under `title`, in the muted color. Ignored when `children` is given.",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 22
      }
    },
    {
      "name": "children",
      "type": "React.ReactNode",
      "declared_type": "React.ReactNode",
      "required": false,
      "description": "",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 23
      }
    },
    {
      "name": "className",
      "type": "string | undefined",
      "declared_type": "string",
      "required": false,
      "description": "",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 24
      }
    },
    {
      "name": "style",
      "type": "React.CSSProperties | undefined",
      "declared_type": "React.CSSProperties",
      "required": false,
      "description": "",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 25
      }
    },
    {
      "name": "variant",
      "type": "\"default\" | undefined",
      "declared_type": "SelectionCardVariant",
      "required": false,
      "description": "The only treatment today; it applies the card's 80px minimum height.",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 27
      },
      "values": [
        "default"
      ],
      "values_complete": true,
      "default": "'default'",
      "default_kind": "source-expression"
    },
    {
      "name": "gridSpan",
      "type": "SelectionCardGridSpan | undefined",
      "declared_type": "SelectionCardGridSpan",
      "required": false,
      "description": "Column behavior inside a parent grid: one column, or `full` to span the row.",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 29
      },
      "values": [
        "auto",
        "full"
      ],
      "values_complete": true,
      "default": "'auto'",
      "default_kind": "source-expression"
    },
    {
      "name": "control",
      "type": "SelectionCardControl | undefined",
      "declared_type": "SelectionCardControl",
      "required": false,
      "description": "Trailing indicator. Defaults to a checkbox; `none` hides it while the card stays tappable.",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 31
      },
      "values": [
        "checkbox",
        "none"
      ],
      "values_complete": true
    },
    {
      "name": "surface",
      "type": "SelectionCardSurface | undefined",
      "declared_type": "SelectionCardSurface",
      "required": false,
      "description": "Card fill. Defaults to the standard surface; `muted` fills with the divider color.",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 33
      },
      "values": [
        "default",
        "muted"
      ],
      "values_complete": true,
      "default": "'default'",
      "default_kind": "source-expression"
    },
    {
      "name": "selected",
      "type": "boolean | undefined",
      "declared_type": "boolean",
      "required": false,
      "description": "Drives the brand border, the checkbox glyph, and `aria-pressed` together.",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 35
      },
      "values": [
        false,
        true
      ],
      "values_complete": true,
      "default": "false",
      "default_kind": "source-expression"
    },
    {
      "name": "disabled",
      "type": "boolean | undefined",
      "declared_type": "boolean",
      "required": false,
      "description": "Blocks presses and greys the whole card, indicator included.",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 37
      },
      "values": [
        false,
        true
      ],
      "values_complete": true,
      "default": "false",
      "default_kind": "source-expression"
    },
    {
      "name": "onSelect",
      "type": "(() => void) | undefined",
      "declared_type": "() => void",
      "required": false,
      "description": "Tap handler. Without it no click handler is attached and the card is inert.",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 39
      }
    },
    {
      "name": "haptic",
      "type": "HapticFeedback | undefined",
      "declared_type": "HapticFeedback",
      "required": false,
      "description": "Haptic feedback for selection. Defaults to `true` (`selection`).",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 41
      },
      "values": [
        "error",
        "heavy",
        "light",
        "medium",
        "selection",
        "success",
        "warning",
        false,
        true
      ],
      "values_complete": true,
      "default": "true",
      "default_kind": "source-expression"
    },
    {
      "name": "ariaLabel",
      "type": "string | undefined",
      "declared_type": "string",
      "required": false,
      "description": "Accessible label when visible copy is custom or absent.",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 43
      }
    },
    {
      "name": "testId",
      "type": "string | undefined",
      "declared_type": "string",
      "required": false,
      "description": "`data-testid` on the card `<button>`, which is the whole tap target.",
      "source": {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 45
      }
    }
  ],
  "prop_shapes": {},
  "examples": [],
  "tokens": [
    {
      "name": "--cds-size-80",
      "light": "80px",
      "dark": "80px"
    },
    {
      "name": "--cds-space-20",
      "light": "20px",
      "dark": "20px"
    },
    {
      "name": "--cds-space-16",
      "light": "16px",
      "dark": "16px"
    },
    {
      "name": "--cds-radius-md",
      "light": "16px",
      "dark": "16px"
    },
    {
      "name": "--cds-border-width-emphasis",
      "light": "2px",
      "dark": "2px"
    },
    {
      "name": "--cds-type-body-size",
      "light": "1rem",
      "dark": "1rem"
    },
    {
      "name": "--cds-type-body-small-size",
      "light": "0.875rem",
      "dark": "0.875rem"
    },
    {
      "name": "--cds-bg-surface",
      "light": "#ffffff",
      "dark": "#1b1b18"
    },
    {
      "name": "--cds-divider",
      "light": "#e0ddd6",
      "dark": "#ffffff1a"
    },
    {
      "name": "--cds-brand",
      "light": "#ff550c",
      "dark": "#ff550c"
    }
  ],
  "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": [
    {
      "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"
    }
  ],
  "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"
  },
  "links": {
    "human": "/component-selectioncard",
    "json": "/data/components/selectioncard.json",
    "markdown": "/data/components/selectioncard.md",
    "storybook": "/storybook/?path=/story/cloaked-design-system-cards-selectioncard--playground"
  },
  "contract_status": "preview",
  "contract_kind": "source-derived",
  "approval": "required",
  "api": {
    "method": "typescript-type-checker",
    "typescript_version": "5.9.3",
    "public_export": "SelectionCard",
    "public_path": "SelectionCard",
    "import_path": "@cloakedinc/design-system",
    "root_kind": "component",
    "entrypoints": [
      {
        "name": "SelectionCard",
        "signature": 1,
        "visibility": "public",
        "source": {
          "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
          "line": 53
        },
        "props_type": "SelectionCardProps",
        "props": [
          {
            "name": "title",
            "type": "string | undefined",
            "declared_type": "string",
            "required": false,
            "description": "Leading line of the built-in content. Ignored when `children` is given.",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 20
            }
          },
          {
            "name": "description",
            "type": "string | undefined",
            "declared_type": "string",
            "required": false,
            "description": "Secondary line under `title`, in the muted color. Ignored when `children` is given.",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 22
            }
          },
          {
            "name": "children",
            "type": "React.ReactNode",
            "declared_type": "React.ReactNode",
            "required": false,
            "description": "",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 23
            }
          },
          {
            "name": "className",
            "type": "string | undefined",
            "declared_type": "string",
            "required": false,
            "description": "",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 24
            }
          },
          {
            "name": "style",
            "type": "React.CSSProperties | undefined",
            "declared_type": "React.CSSProperties",
            "required": false,
            "description": "",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 25
            }
          },
          {
            "name": "variant",
            "type": "\"default\" | undefined",
            "declared_type": "SelectionCardVariant",
            "required": false,
            "description": "The only treatment today; it applies the card's 80px minimum height.",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 27
            },
            "values": [
              "default"
            ],
            "values_complete": true,
            "default": "'default'",
            "default_kind": "source-expression"
          },
          {
            "name": "gridSpan",
            "type": "SelectionCardGridSpan | undefined",
            "declared_type": "SelectionCardGridSpan",
            "required": false,
            "description": "Column behavior inside a parent grid: one column, or `full` to span the row.",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 29
            },
            "values": [
              "auto",
              "full"
            ],
            "values_complete": true,
            "default": "'auto'",
            "default_kind": "source-expression"
          },
          {
            "name": "control",
            "type": "SelectionCardControl | undefined",
            "declared_type": "SelectionCardControl",
            "required": false,
            "description": "Trailing indicator. Defaults to a checkbox; `none` hides it while the card stays tappable.",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 31
            },
            "values": [
              "checkbox",
              "none"
            ],
            "values_complete": true
          },
          {
            "name": "surface",
            "type": "SelectionCardSurface | undefined",
            "declared_type": "SelectionCardSurface",
            "required": false,
            "description": "Card fill. Defaults to the standard surface; `muted` fills with the divider color.",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 33
            },
            "values": [
              "default",
              "muted"
            ],
            "values_complete": true,
            "default": "'default'",
            "default_kind": "source-expression"
          },
          {
            "name": "selected",
            "type": "boolean | undefined",
            "declared_type": "boolean",
            "required": false,
            "description": "Drives the brand border, the checkbox glyph, and `aria-pressed` together.",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 35
            },
            "values": [
              false,
              true
            ],
            "values_complete": true,
            "default": "false",
            "default_kind": "source-expression"
          },
          {
            "name": "disabled",
            "type": "boolean | undefined",
            "declared_type": "boolean",
            "required": false,
            "description": "Blocks presses and greys the whole card, indicator included.",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 37
            },
            "values": [
              false,
              true
            ],
            "values_complete": true,
            "default": "false",
            "default_kind": "source-expression"
          },
          {
            "name": "onSelect",
            "type": "(() => void) | undefined",
            "declared_type": "() => void",
            "required": false,
            "description": "Tap handler. Without it no click handler is attached and the card is inert.",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 39
            }
          },
          {
            "name": "haptic",
            "type": "HapticFeedback | undefined",
            "declared_type": "HapticFeedback",
            "required": false,
            "description": "Haptic feedback for selection. Defaults to `true` (`selection`).",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 41
            },
            "values": [
              "error",
              "heavy",
              "light",
              "medium",
              "selection",
              "success",
              "warning",
              false,
              true
            ],
            "values_complete": true,
            "default": "true",
            "default_kind": "source-expression"
          },
          {
            "name": "ariaLabel",
            "type": "string | undefined",
            "declared_type": "string",
            "required": false,
            "description": "Accessible label when visible copy is custom or absent.",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 43
            }
          },
          {
            "name": "testId",
            "type": "string | undefined",
            "declared_type": "string",
            "required": false,
            "description": "`data-testid` on the card `<button>`, which is the whole tap target.",
            "source": {
              "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
              "line": 45
            }
          }
        ],
        "branches": [],
        "constraints": [],
        "extraction_status": "extracted"
      }
    ],
    "type_sources": [
      {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 9,
        "name": "SelectionCardVariant",
        "code": "export type SelectionCardVariant = 'default';"
      },
      {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 10,
        "name": "SelectionCardGridSpan",
        "code": "export type SelectionCardGridSpan = 'auto' | 'full';"
      },
      {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 11,
        "name": "SelectionCardControl",
        "code": "export type SelectionCardControl = 'checkbox' | 'none';"
      },
      {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 12,
        "name": "SelectionCardSurface",
        "code": "export type SelectionCardSurface = 'default' | 'muted';"
      },
      {
        "path": "packages/design-system/src/components/cards/SelectionCard/SelectionCard.tsx",
        "line": 18,
        "name": "SelectionCardProps",
        "code": "export interface SelectionCardProps {\n    /** Leading line of the built-in content. Ignored when `children` is given. */\n    title?: string;\n    /** Secondary line under `title`, in the muted color. Ignored when `children` is given. */\n    description?: string;\n    children?: React.ReactNode;\n    className?: string;\n    style?: React.CSSProperties;\n    /** The only treatment today; it applies the card's 80px minimum height. */\n    variant?: SelectionCardVariant;\n    /** Column behavior inside a parent grid: one column, or `full` to span the row. */\n    gridSpan?: SelectionCardGridSpan;\n    /** Trailing indicator. Defaults to a checkbox; `none` hides it while the card stays tappable. */\n    control?: SelectionCardControl;\n    /** Card fill. Defaults to the standard surface; `muted` fills with the divider color. */\n    surface?: SelectionCardSurface;\n    /** Drives the brand border, the checkbox glyph, and `aria-pressed` together. */\n    selected?: boolean;\n    /** Blocks presses and greys the whole card, indicator included. */\n    disabled?: boolean;\n    /** Tap handler. Without it no click handler is attached and the card is inert. */\n    onSelect?: () => void;\n    /** Haptic feedback for selection. Defaults to `true` (`selection`). */\n    haptic?: HapticFeedback;\n    /** Accessible label when visible copy is custom or absent. */\n    ariaLabel?: string;\n    /** `data-testid` on the card `<button>`, which is the whole tap target. */\n    testId?: string;\n}"
      },
      {
        "path": "packages/design-system/src/tokens/CdsHaptic.ts",
        "line": 6,
        "name": "HapticFeedback",
        "code": "export type HapticFeedback = boolean | HapticType;"
      },
      {
        "path": "packages/design-system/src/tokens/HapticType.ts",
        "line": 2,
        "name": "HapticType",
        "code": "export type HapticType = 'light' | 'medium' | 'heavy' | 'success' | 'warning' | 'error' | 'selection';"
      }
    ],
    "defaults_policy": "Only explicit destructured parameter initializers are extracted. Other runtime defaults remain in implementation source."
  },
  "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"
    }
  },
  "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."
    }
  ],
  "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."
  }
}