{
  "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": "toast",
  "name": "Toast",
  "category": "Overlays",
  "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-overlays-toast--playground",
        "name": "Playground",
        "title": "Cloaked Design System/Overlays/Toast",
        "exportName": "Playground",
        "source_path": "packages/design-system/src/components/overlays/Toast/Toast.stories.tsx",
        "source_digest": "6e6a983755849a9808a0e851fe04772c8ffac914e9b4eb7717f21672c3dcdf8d",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-overlays-toast--playground&viewMode=story"
      },
      {
        "id": "cloaked-design-system-overlays-toast--title-only",
        "name": "Title Only",
        "title": "Cloaked Design System/Overlays/Toast",
        "exportName": "TitleOnly",
        "source_path": "packages/design-system/src/components/overlays/Toast/Toast.stories.tsx",
        "source_digest": "6e6a983755849a9808a0e851fe04772c8ffac914e9b4eb7717f21672c3dcdf8d",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-overlays-toast--title-only&viewMode=story"
      },
      {
        "id": "cloaked-design-system-overlays-toast--info",
        "name": "Info",
        "title": "Cloaked Design System/Overlays/Toast",
        "exportName": "Info",
        "source_path": "packages/design-system/src/components/overlays/Toast/Toast.stories.tsx",
        "source_digest": "6e6a983755849a9808a0e851fe04772c8ffac914e9b4eb7717f21672c3dcdf8d",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-overlays-toast--info&viewMode=story"
      },
      {
        "id": "cloaked-design-system-overlays-toast--danger",
        "name": "Danger",
        "title": "Cloaked Design System/Overlays/Toast",
        "exportName": "Danger",
        "source_path": "packages/design-system/src/components/overlays/Toast/Toast.stories.tsx",
        "source_digest": "6e6a983755849a9808a0e851fe04772c8ffac914e9b4eb7717f21672c3dcdf8d",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-overlays-toast--danger&viewMode=story"
      },
      {
        "id": "cloaked-design-system-overlays-toast--custom-icon",
        "name": "Custom Icon",
        "title": "Cloaked Design System/Overlays/Toast",
        "exportName": "CustomIcon",
        "source_path": "packages/design-system/src/components/overlays/Toast/Toast.stories.tsx",
        "source_digest": "6e6a983755849a9808a0e851fe04772c8ffac914e9b4eb7717f21672c3dcdf8d",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-overlays-toast--custom-icon&viewMode=story"
      },
      {
        "id": "cloaked-design-system-overlays-toast--tone-matrix",
        "name": "Tone Matrix",
        "title": "Cloaked Design System/Overlays/Toast",
        "exportName": "ToneMatrix",
        "source_path": "packages/design-system/src/components/overlays/Toast/Toast.stories.tsx",
        "source_digest": "6e6a983755849a9808a0e851fe04772c8ffac914e9b4eb7717f21672c3dcdf8d",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-overlays-toast--tone-matrix&viewMode=story"
      },
      {
        "id": "cloaked-design-system-overlays-toast--dark-theme",
        "name": "Dark Theme",
        "title": "Cloaked Design System/Overlays/Toast",
        "exportName": "DarkTheme",
        "source_path": "packages/design-system/src/components/overlays/Toast/Toast.stories.tsx",
        "source_digest": "6e6a983755849a9808a0e851fe04772c8ffac914e9b4eb7717f21672c3dcdf8d",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-overlays-toast--dark-theme&viewMode=story"
      }
    ],
    "name": "Toast",
    "id": "toast",
    "category": "Overlays"
  },
  "stories_source": {
    "path": "packages/design-system/src/components/overlays/Toast/Toast.stories.tsx",
    "code": "import React from 'react';\nimport type { Meta, StoryObj } from '@storybook/react-vite';\nimport { VStack } from '../../layout/VStack/VStack';\nimport { STATUS_TONES } from '../../../styles/statusTone';\nimport { hapticArgType, selectArgType } from '../../../storybook/controlOptions';\nimport { Toast } from './Toast';\n\nconst TONE_GLYPH = {\n    neutral: 'bell',\n    info: 'info',\n    success: 'check',\n    warning: 'info',\n    danger: 'block',\n} as const;\n\nconst meta: Meta<typeof Toast> = {\n    title: 'Cloaked Design System/Overlays/Toast',\n    component: Toast,\n    parameters: {\n        a11y: { test: 'error' },\n        docs: {\n            description: {\n                component:\n                    'A compact, top-anchored feedback pill. Toast renders only the visual — a host owns the ' +\n                    'show/hide timer. `tone` colors the leading icon disc and sets the ARIA urgency: `danger` uses ' +\n                    '`role=\"alert\"`, every other tone `role=\"status\"`. `glyph` and `title` are required; `subtitle` ' +\n                    'is optional.',\n            },\n        },\n    },\n    args: {\n        tone: 'success',\n        glyph: 'check',\n        title: 'Done',\n        subtitle: 'Confirmed',\n    },\n    argTypes: {\n        tone: {\n            ...selectArgType(STATUS_TONES),\n            description: 'Colors the icon disc and sets ARIA urgency. `danger` announces as `role=\"alert\"`.',\n        },\n        glyph: { control: 'text', description: 'Registered glyph shown in the tone disc.' },\n        title: { control: 'text', description: 'Primary message.' },\n        subtitle: { control: 'text', description: 'Optional secondary line under the title.' },\n        haptic: hapticArgType,\n    },\n};\nexport default meta;\ntype Story = StoryObj<typeof Toast>;\n\nexport const Playground: Story = {};\n\nexport const TitleOnly: Story = {\n    args: { tone: 'success', glyph: 'check', title: 'Link copied', subtitle: undefined },\n    parameters: { docs: { description: { story: 'Without a `subtitle` the pill is a single centered line.' } } },\n};\n\nexport const Info: Story = {\n    args: { tone: 'info', glyph: 'info', title: 'Heads up', subtitle: 'Review one item to continue.' },\n};\n\nexport const Danger: Story = {\n    args: { tone: 'danger', glyph: 'block', title: 'Could not save', subtitle: 'Check your connection.' },\n};\n\nexport const CustomIcon: Story = {\n    args: { tone: 'success', glyph: 'lock', title: 'File unlocked', subtitle: undefined },\n    parameters: {\n        docs: { description: { story: 'The glyph is not derived from tone — any DS glyph works with any tone.' } },\n    },\n};\n\nexport const ToneMatrix: Story = {\n    parameters: { docs: { description: { story: 'Every tone treatment side by side.' } } },\n    render: () => (\n        <VStack gap={12} align='center'>\n            {STATUS_TONES.map(tone => (\n                <Toast\n                    key={tone}\n                    tone={tone}\n                    glyph={TONE_GLYPH[tone]}\n                    title={tone}\n                    subtitle={`The ${tone} treatment.`}\n                />\n            ))}\n        </VStack>\n    ),\n};\n\nexport const DarkTheme: Story = {\n    args: { tone: 'success', glyph: 'check', title: 'Done', subtitle: 'Confirmed' },\n    globals: { theme: 'dark' },\n};\n"
  },
  "specification": {
    "$schema": "../../../specs/component-spec.schema.json",
    "identity": {
      "name": "Toast",
      "status": "preview",
      "version": "1.0.0",
      "summary": "A transient feedback banner with variant color, viewport position, optional icon, action, and dismiss control."
    },
    "parts": [
      {
        "id": "root",
        "label": "Root",
        "description": "Grid surface carrying the variant color and position animation.",
        "required": true
      },
      {
        "id": "icon",
        "label": "Icon",
        "description": "Optional leading marker."
      },
      {
        "id": "content",
        "label": "Content",
        "description": "Title, body, and optional action column."
      },
      {
        "id": "action",
        "label": "Action",
        "description": "Optional trailing control."
      },
      {
        "id": "dismiss",
        "label": "Dismiss",
        "description": "Optional close button."
      }
    ],
    "allowedDesignChoices": {
      "variants": {
        "info": {
          "label": "Info",
          "description": "Neutral status; announced as role=status."
        },
        "success": {
          "label": "Success",
          "description": "Positive confirmation."
        },
        "warning": {
          "label": "Warning",
          "description": "Cautionary feedback."
        },
        "danger": {
          "label": "Danger",
          "description": "Error feedback; announced as role=alert."
        }
      },
      "sizes": {},
      "positions": {
        "top": {
          "label": "Top",
          "description": "Anchored to the top edge with a top-entering animation."
        },
        "bottom": {
          "label": "Bottom",
          "description": "Anchored to the bottom edge with a bottom-entering animation."
        }
      }
    },
    "variants": [
      {
        "id": "info",
        "label": "Info",
        "description": "Neutral surface, role=status.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      },
      {
        "id": "success",
        "label": "Success",
        "description": "Success subtle surface.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      },
      {
        "id": "warning",
        "label": "Warning",
        "description": "Warning subtle surface.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      },
      {
        "id": "danger",
        "label": "Danger",
        "description": "Danger subtle surface, role=alert.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      }
    ],
    "sizes": [],
    "measurements": [
      {
        "id": "content-gap",
        "label": "Content gap",
        "kind": "exact",
        "token": "--cds-space-12",
        "value": 12,
        "unit": "px",
        "appliesTo": [
          "root"
        ]
      },
      {
        "id": "container-inset",
        "label": "Container inset",
        "kind": "exact",
        "token": "--cds-space-16",
        "value": 16,
        "unit": "px",
        "appliesTo": [
          "root"
        ]
      },
      {
        "id": "max-width",
        "label": "Maximum width",
        "kind": "exact",
        "token": "--cds-size-320",
        "value": 320,
        "unit": "px",
        "appliesTo": [
          "root"
        ],
        "notes": "The toast width is capped at this token, shrinking on narrow viewports."
      },
      {
        "id": "corner-radius",
        "label": "Corner radius",
        "kind": "exact",
        "token": "--cds-radius-2xl",
        "value": 32,
        "unit": "px",
        "appliesTo": [
          "root"
        ]
      }
    ],
    "layout": {
      "alignment": "Leading icon, content column, and dismiss align to the top of the toast.",
      "flow": "A three-column grid: optional icon, flexible content, optional dismiss.",
      "notes": [
        "Toast renders only the visual; a toast host owns the show and hide timer."
      ]
    },
    "typographyAndColor": {
      "typography": [
        {
          "label": "Title and body",
          "description": "Title and body use the body-small ramp.",
          "token": "--cds-type-body-small-size"
        }
      ],
      "colors": [
        {
          "label": "Info surface",
          "description": "The info variant uses the raised surface.",
          "token": "--cds-bg-surface"
        },
        {
          "label": "Success surface",
          "description": "The success variant uses the success subtle token.",
          "token": "--cds-status-success-subtle"
        },
        {
          "label": "Title text",
          "description": "The title uses primary text.",
          "token": "--cds-text-primary"
        },
        {
          "label": "Body text",
          "description": "The body uses secondary text.",
          "token": "--cds-text-secondary"
        }
      ]
    },
    "states": [
      {
        "id": "info",
        "label": "Info",
        "description": "Neutral surface announced as status."
      },
      {
        "id": "success",
        "label": "Success",
        "description": "Success subtle surface."
      },
      {
        "id": "warning",
        "label": "Warning",
        "description": "Warning subtle surface."
      },
      {
        "id": "danger",
        "label": "Danger",
        "description": "Danger subtle surface announced as alert."
      },
      {
        "id": "dismissible",
        "label": "Dismissible",
        "description": "Shows the close button when onDismiss is provided."
      }
    ],
    "behavior": [
      {
        "label": "Host-owned lifecycle",
        "description": "Toast does not schedule its own dismissal; the host times it and passes onDismiss."
      },
      {
        "label": "Urgency",
        "description": "danger uses role=alert; the other variants use role=status."
      }
    ],
    "accessibility": [
      {
        "label": "Live region",
        "description": "The variant maps to an appropriate status or alert live region."
      },
      {
        "label": "Dismiss label",
        "description": "The close button carries an accessible label."
      }
    ],
    "contentAdaptation": [
      {
        "label": "Responsive width",
        "description": "The toast caps at the max-width token and shrinks on narrow viewports."
      },
      {
        "label": "Optional slots",
        "description": "Icon, action, and dismiss render only when supplied."
      }
    ],
    "motionHaptics": {
      "motion": [
        {
          "label": "Entrance",
          "description": "The toast slides in from its anchored edge; disabled under reduced motion."
        }
      ],
      "haptics": [
        {
          "label": "Dismiss haptic",
          "description": "Dismissal requests a light haptic."
        }
      ]
    },
    "platformDifferences": []
  },
  "specification_source": "packages/design-system/src/components/overlays/Toast/Toast.spec.json",
  "guidance": {
    "summary": "A transient feedback banner with variant color, viewport position, optional icon, action, and dismiss control.",
    "guidance": [
      {
        "heading": "Overview",
        "body": "A compact, top-anchored feedback pill. Toast renders only the visual — a toast host owns the\nshow/hide timer. `tone` colors the leading icon disc and sets the ARIA urgency. `glyph` and\n`title` are required; `subtitle` is optional."
      },
      {
        "heading": "Use when",
        "body": "App toasts today are share/copy confirmations whose `tone` is set at runtime."
      },
      {
        "heading": "Icon",
        "body": "`glyph` is required and is not derived from `tone` — any DS glyph pairs with any tone."
      }
    ],
    "usage": [
      {
        "variant": "neutral",
        "use": "A plain notice with no status color — a bold disc.",
        "axis": "Tone"
      },
      {
        "variant": "info",
        "use": "A heads-up or neutral confirmation — copied to clipboard.",
        "axis": "Tone"
      },
      {
        "variant": "success",
        "use": "A completed action — scan complete, saved.",
        "axis": "Tone"
      },
      {
        "variant": "warning",
        "use": "Something needs attention.",
        "axis": "Tone"
      },
      {
        "variant": "danger",
        "use": "A failure — could not save. Announced as role=\"alert\" so screen readers interrupt; the other tones use role=\"status\".",
        "avoid": "A routine confirmation — the alert role is disruptive when nothing is wrong.",
        "axis": "Tone"
      }
    ],
    "examples": [],
    "source": "packages/design-system/src/components/overlays/Toast/Toast.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-toast",
    "json": "/data/visual/components/toast.json",
    "storybook": "/storybook/?path=/story/cloaked-design-system-overlays-toast--playground"
  }
}