{
  "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": "divider",
  "name": "Divider",
  "category": "Primitives",
  "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-primitives-divider--section-on-page",
        "name": "Section On Page",
        "title": "Cloaked Design System/Primitives/Divider",
        "exportName": "SectionOnPage",
        "source_path": "packages/design-system/src/components/primitives/Divider/Divider.stories.tsx",
        "source_digest": "e824b1c171120778c6ec01b0f69d9d887b228eefe92ae3e7fd1a12b0e2da79d3",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-divider--section-on-page&viewMode=story"
      },
      {
        "id": "cloaked-design-system-primitives-divider--section-on-surface",
        "name": "Section On Surface",
        "title": "Cloaked Design System/Primitives/Divider",
        "exportName": "SectionOnSurface",
        "source_path": "packages/design-system/src/components/primitives/Divider/Divider.stories.tsx",
        "source_digest": "e824b1c171120778c6ec01b0f69d9d887b228eefe92ae3e7fd1a12b0e2da79d3",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-divider--section-on-surface&viewMode=story"
      },
      {
        "id": "cloaked-design-system-primitives-divider--line",
        "name": "Line",
        "title": "Cloaked Design System/Primitives/Divider",
        "exportName": "Line",
        "source_path": "packages/design-system/src/components/primitives/Divider/Divider.stories.tsx",
        "source_digest": "e824b1c171120778c6ec01b0f69d9d887b228eefe92ae3e7fd1a12b0e2da79d3",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-divider--line&viewMode=story"
      },
      {
        "id": "cloaked-design-system-primitives-divider--line-on-surface",
        "name": "Line On Surface",
        "title": "Cloaked Design System/Primitives/Divider",
        "exportName": "LineOnSurface",
        "source_path": "packages/design-system/src/components/primitives/Divider/Divider.stories.tsx",
        "source_digest": "e824b1c171120778c6ec01b0f69d9d887b228eefe92ae3e7fd1a12b0e2da79d3",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-divider--line-on-surface&viewMode=story"
      },
      {
        "id": "cloaked-design-system-primitives-divider--dark-theme",
        "name": "Dark Theme",
        "title": "Cloaked Design System/Primitives/Divider",
        "exportName": "DarkTheme",
        "source_path": "packages/design-system/src/components/primitives/Divider/Divider.stories.tsx",
        "source_digest": "e824b1c171120778c6ec01b0f69d9d887b228eefe92ae3e7fd1a12b0e2da79d3",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-divider--dark-theme&viewMode=story"
      }
    ],
    "name": "Divider",
    "id": "divider",
    "category": "Primitives"
  },
  "stories_source": {
    "path": "packages/design-system/src/components/primitives/Divider/Divider.stories.tsx",
    "code": "import React from 'react';\nimport type { Meta, StoryObj } from '@storybook/react-vite';\nimport { Background } from '../../layout/Background/Background';\nimport { selectArgType, SURFACE_OPTIONS } from '../../../storybook/controlOptions';\nimport { Divider, type DividerVariant } from './Divider';\n\nconst DIVIDER_VARIANTS = ['section', 'line'] as const satisfies readonly DividerVariant[];\n\nconst meta: Meta<typeof Divider> = {\n    title: 'Cloaked Design System/Primitives/Divider',\n    component: Divider,\n    parameters: {\n        a11y: { test: 'error' },\n        layout: 'fullscreen',\n        docs: {\n            description: {\n                component:\n                    'Separator between content groups. A `label` (or `variant=\"section\"`) renders a titled band for ' +\n                    'grouping a scroll feed; `variant=\"line\"` is a plain hairline between rows. Match `surface` to its ' +\n                    'container — `page` for the cream feed background, `surface` for a bottom hairline inside a Card. ' +\n                    'For a heading with a trailing action use `SectionHeader`, not a labeled Divider.',\n            },\n        },\n    },\n    argTypes: {\n        variant: {\n            ...selectArgType(DIVIDER_VARIANTS),\n            description:\n                '`section` renders a labeled band; `line` a hairline. Defaults to `section` when `label` is set.',\n        },\n        surface: {\n            ...selectArgType(SURFACE_OPTIONS),\n            description:\n                'Container context: `page` (cream, borderless band) or `surface` (white with a bottom hairline).',\n        },\n    },\n};\nexport default meta;\ntype Story = StoryObj<typeof Divider>;\n\nexport const SectionOnPage: Story = {\n    parameters: {\n        docs: { description: { story: 'Labeled band on the cream page feed — the default scroll-feed grouping.' } },\n    },\n    args: { label: 'Today', surface: 'page' },\n};\nexport const SectionOnSurface: Story = {\n    parameters: { docs: { description: { story: 'Labeled band on white — for grouping rows inside a Card.' } } },\n    args: { label: 'Today', surface: 'surface' },\n};\nexport const Line: Story = {\n    parameters: { docs: { description: { story: 'Plain hairline with no label — a lightweight row separator.' } } },\n    args: { variant: 'line' },\n};\nexport const LineOnSurface: Story = {\n    parameters: {\n        docs: { description: { story: 'Hairline inside a white Card, rendered against a surface backdrop.' } },\n    },\n    args: { variant: 'line', surface: 'surface' },\n    decorators: [\n        Story => (\n            <Background surface='surface' padding={16}>\n                {Story()}\n            </Background>\n        ),\n    ],\n};\nexport const DarkTheme: Story = {\n    args: { label: 'Today', surface: 'page' },\n    globals: { theme: 'dark' },\n};\n"
  },
  "specification": {
    "$schema": "../../../specs/component-spec.schema.json",
    "identity": {
      "name": "Divider",
      "status": "preview",
      "version": "1.1.0",
      "summary": "A full-width content separator that renders either a labeled section band or a plain hairline."
    },
    "parts": [
      {
        "id": "separator",
        "label": "Separator",
        "description": "Owns full-width separator semantics and the selected treatment."
      },
      {
        "id": "section-band",
        "label": "Section band",
        "description": "Provides inset space and a surface behind a section label."
      },
      {
        "id": "label",
        "label": "Label",
        "description": "Names the following section when the section variant is used."
      },
      {
        "id": "line",
        "label": "Line",
        "description": "Draws the unlabeled hairline treatment."
      }
    ],
    "allowedDesignChoices": {
      "variants": {
        "section": {
          "label": "Section"
        },
        "line": {
          "label": "Line"
        }
      },
      "sizes": {},
      "surfaces": {
        "page": {
          "label": "Page",
          "description": "Uses the page background for a section band."
        },
        "surface": {
          "label": "Surface",
          "description": "Uses the raised surface background for a section band. Borderless — spacing separates groups."
        }
      }
    },
    "variants": [
      {
        "id": "section",
        "label": "Section",
        "description": "A labeled band for separating larger content groups.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      },
      {
        "id": "line",
        "label": "Line",
        "description": "An unlabeled hairline between adjacent content.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      }
    ],
    "sizes": [],
    "measurements": [
      {
        "id": "line-thickness",
        "label": "Line thickness",
        "kind": "exact",
        "token": "--cds-border-width-default",
        "value": 1,
        "unit": "px",
        "appliesTo": [
          "line"
        ]
      },
      {
        "id": "section-horizontal-inset",
        "label": "Section horizontal inset",
        "kind": "exact",
        "token": "--cds-space-20",
        "value": 20,
        "unit": "px",
        "appliesTo": [
          "section-band",
          "label"
        ]
      },
      {
        "id": "section-top-inset",
        "label": "Section top inset",
        "kind": "exact",
        "token": "--cds-space-32",
        "value": 32,
        "unit": "px",
        "appliesTo": [
          "section-band",
          "label"
        ]
      },
      {
        "id": "section-bottom-inset",
        "label": "Section bottom inset",
        "kind": "exact",
        "token": "--cds-space-12",
        "value": 12,
        "unit": "px",
        "appliesTo": [
          "section-band",
          "label"
        ]
      }
    ],
    "layout": {
      "alignment": "The separator spans its parent width; section labels align to the leading inset.",
      "flow": "A line consumes one stroke of height; a section band wraps one uppercase label.",
      "notes": [
        "A label automatically selects the section treatment unless a variant is explicit.",
        "The surface choice is page or raised surface and does not create another public variant."
      ]
    },
    "typographyAndColor": {
      "typography": [
        {
          "label": "Section label",
          "description": "Uses the compact link ramp and uppercase presentation.",
          "token": "--cds-type-link-size"
        }
      ],
      "colors": [
        {
          "label": "Hairline",
          "description": "Uses the theme-aware divider role.",
          "token": "--cds-divider"
        },
        {
          "label": "Page band",
          "description": "Uses the page background when separating feed sections.",
          "token": "--cds-bg-page"
        },
        {
          "label": "Surface band",
          "description": "Uses the raised surface background inside a card.",
          "token": "--cds-bg-surface"
        },
        {
          "label": "Section label",
          "description": "Uses primary text emphasis.",
          "token": "--cds-text-primary"
        }
      ]
    },
    "states": [
      {
        "id": "section-page",
        "label": "Section on page",
        "description": "Shows a borderless labeled band on the page canvas."
      },
      {
        "id": "section-surface",
        "label": "Section on surface",
        "description": "Shows a labeled raised band with a bottom hairline."
      },
      {
        "id": "line",
        "label": "Line",
        "description": "Shows only the theme-aware hairline."
      }
    ],
    "behavior": [
      {
        "label": "Variant inference",
        "description": "Resolve to section when a label exists and line when no label exists, unless the caller selects a variant."
      },
      {
        "label": "Separation only",
        "description": "Do not make the separator interactive or use it as a heading with an action."
      }
    ],
    "accessibility": [
      {
        "label": "Separator semantics",
        "description": "Expose separator role for both the line and section treatments."
      },
      {
        "label": "Section label",
        "description": "Keep the visible label concise; use a real heading component when document hierarchy is required."
      }
    ],
    "contentAdaptation": [
      {
        "label": "Labels",
        "description": "Use short section names that remain readable when transformed to uppercase."
      }
    ],
    "motionHaptics": {
      "motion": [
        {
          "label": "No motion",
          "description": "Divider has no animated state transition."
        }
      ],
      "haptics": [
        {
          "label": "No feedback",
          "description": "Divider is not interactive and does not request haptic feedback."
        }
      ]
    },
    "platformDifferences": []
  },
  "specification_source": "packages/design-system/src/components/primitives/Divider/Divider.spec.json",
  "guidance": {
    "summary": "A full-width content separator that renders either a labeled section band or a plain hairline.",
    "guidance": [
      {
        "heading": "Overview",
        "body": "A separator between content groups. Pass a `label` for a titled band, or leave it off for\na plain hairline."
      },
      {
        "heading": "Use when",
        "body": "Match `surface` to the container the divider sits in: `page` is the cream, borderless band\nfor the scroll-feed background; `surface` is white with a bottom hairline for grouping rows\ninside a Card."
      }
    ],
    "usage": [
      {
        "variant": "section",
        "use": "A labeled band that groups a scroll feed by time or category (Today, Yesterday). Defaults on when `label` is set.",
        "avoid": "A heading that needs a trailing action — use `SectionHeader`.",
        "axis": "Variant"
      },
      {
        "variant": "line",
        "use": "A plain hairline between rows or blocks when the group needs no title.",
        "avoid": "Grouping that reads better with a label — use section.",
        "axis": "Variant"
      }
    ],
    "examples": [],
    "source": "packages/design-system/src/components/primitives/Divider/Divider.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-divider",
    "json": "/data/visual/components/divider.json",
    "storybook": "/storybook/?path=/story/cloaked-design-system-primitives-divider--section-on-page"
  }
}