{
  "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": "shadows",
  "name": "Shadows",
  "summary": "Compare subtle separation with an elevated layer. See the two defined shadows on real surfaces, including a flat reference.",
  "demo": "foundation-shadows",
  "guidance": [
    {
      "title": "Use the two defined treatments",
      "body": "The card shadow is a small downward shadow. The modal shadow is broader and extends upward. They are two distinct definitions, not a numbered elevation scale."
    },
    {
      "title": "Start with the surface",
      "body": "A different background or boundary may provide enough separation. Compare the same object with and without shadow before adding another visual layer."
    },
    {
      "title": "Check both themes",
      "body": "A dark shadow becomes subtle on a dark background. Preserve the real token and assess the complete surface and boundary treatment instead of inventing a bright replacement."
    }
  ],
  "source": "packages/design-system/foundations.json",
  "tokens": [
    {
      "name": "--cds-shadow-modal",
      "value": "0 -10px 40px rgb(0 0 0 / 15%)",
      "selector": ":root",
      "source_path": "packages/design-system/src/tokens/effects.css"
    },
    {
      "name": "--cds-shadow-card",
      "value": "0 2px 8px rgb(0 0 0 / 10%)",
      "selector": ":root",
      "source_path": "packages/design-system/src/tokens/effects.css"
    }
  ],
  "example": {
    "id": "foundation-shadows",
    "title": "Shadows",
    "source": "packages/design-system/examples/foundations/FoundationShadows.tsx",
    "export": "FoundationShadows",
    "components": [],
    "description": "Exactly the two canonical shadows compared with an unraised surface.",
    "synthetic_data": true,
    "storybook_id": "foundations-shadows--explore",
    "code": "import { FoundationFrame } from './FoundationShared';\nimport { shadowSteps } from './foundation-data';\n\nexport function FoundationShadows() {\n  const examples = [{ name: 'none', value: 'none' }, ...shadowSteps];\n  return <FoundationFrame code={`const cardStyle = { boxShadow: 'var(--cds-shadow-card)' };\\nconst sheetStyle = { boxShadow: 'var(--cds-shadow-modal)' };`}>\n    <span className=\"demo-eyebrow\">Elevation has a purpose</span>\n    <div className=\"foundation-shadow-grid\">{examples.map(token => <div key={token.name} className=\"foundation-shadow-item\">\n      <div className=\"foundation-shadow-stage\"><div data-testid=\"shadow-specimen\" className=\"foundation-shadow-card\" style={{ boxShadow: token.name === 'none' ? 'none' : `var(${token.name})` }}>\n        <span aria-hidden=\"true\">@</span><span>Protected email</span>\n      </div></div>\n      <h2>{token.name === 'none' ? 'In the page' : token.name.endsWith('card') ? 'A raised card' : 'A sheet above content'}</h2>\n      <code>{token.name === 'none' ? 'box-shadow: none' : token.name}</code>\n      <p>{token.name === 'none' ? 'Let spacing and the surface establish the group.' : token.name.endsWith('card') ? 'A small lift separates one content layer.' : 'The upward shadow marks content appearing from below.'}</p>\n    </div>)}</div>\n    <p className=\"foundation-caption\">These are the two canonical shadows. Dark surfaces rely more on their surface color and boundary; the shadows themselves stay unchanged.</p>\n  </FoundationFrame>;\n}\n"
  },
  "visual_reference": {
    "stories": [
      {
        "id": "cloaked-design-system-foundations-overview--effects",
        "name": "Effects",
        "title": "Cloaked Design System/Foundations/Overview",
        "exportName": "Effects",
        "source_path": "packages/design-system/src/foundations/Foundations.stories.tsx",
        "source_digest": "02b89302834e3cdcee9f8e4762838a3baade84a5ffb336904f0df924bb29506e",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-foundations-overview--effects&viewMode=story"
      }
    ]
  },
  "links": {
    "human": "/shadows",
    "json": "/data/foundations/shadows.json"
  }
}