{
  "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": "skeleton",
  "name": "Skeleton",
  "category": "Primitives",
  "summary": "A decorative shimmer placeholder that preserves the expected text, avatar, or block layout while content loads.",
  "documentation": {
    "summary": "A decorative shimmer placeholder that preserves the expected text, avatar, or block layout while content loads.",
    "guidance": [
      {
        "heading": "Overview",
        "body": "A shimmer placeholder that stands in for content while it loads, sized to the shape it replaces."
      },
      {
        "heading": "When to use",
        "body": "Reach for `Skeleton` to hold the layout in place while data loads, so the screen doesn't jump when\ncontent arrives. It is decorative — `aria-hidden` and reduced-motion aware — so it never announces a\nbusy state to assistive tech. Size each placeholder to the real element it stands in for.\n\n-   Content finished loading but there's genuinely nothing to show? Use `EmptyState`.\n-   Need a small, announced, indeterminate busy indicator (not a layout stand-in)? Use `Spinner`, or\n    `Progress` for a determinate bar.\n\nPick `variant` by the shape you're standing in for:"
      }
    ],
    "usage": [
      {
        "variant": "text",
        "use": "A line of copy — headings, labels, body runs. Set width to the expected text length."
      },
      {
        "variant": "circle",
        "use": "A round element — avatars, icon bubbles. Match width and height."
      },
      {
        "variant": "rectangle",
        "use": "A block — cards, images, thumbnails, buttons. The default."
      }
    ],
    "examples": [],
    "source": "packages/design-system/src/components/primitives/Skeleton/Skeleton.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/primitives/Skeleton/Skeleton.tsx",
    "code": "import React from 'react';\nimport { cn } from '../../../utilities';\nimport styles from './Skeleton.module.scss';\n\nexport type SkeletonVariant = 'text' | 'circle' | 'rectangle';\n\n/**\n * Props for the shimmer placeholder. An unsized skeleton fills its container's width, but only\n * the `text` variant carries a height of its own — the others collapse without one.\n */\nexport interface SkeletonProps {\n    /** Shape preset: corner radius for all three, plus a 16px height for `text`. Defaults to `rectangle`. */\n    variant?: SkeletonVariant;\n    /** Width as a number (px) or any CSS length. */\n    width?: number | string;\n    /** Height as a number (px) or any CSS length. */\n    height?: number | string;\n    /** Corner radius override (number = px); otherwise the variant default applies. */\n    borderRadius?: number | string;\n    className?: string;\n    style?: React.CSSProperties;\n    /** Selector on the placeholder — it is `aria-hidden`, so there is no role or name to query by. */\n    testId?: string;\n}\n\n/**\n * Animated shimmer placeholder shown while content loads. Decorative, so it is\n * hidden from assistive tech and stops animating under reduced-motion.\n */\nexport function Skeleton({\n    variant = 'rectangle',\n    width,\n    height,\n    borderRadius,\n    className,\n    style: styleProp,\n    testId,\n}: SkeletonProps) {\n    const style: React.CSSProperties = {\n        ...styleProp,\n        width: typeof width === 'number' ? `${width}px` : width,\n        height: typeof height === 'number' ? `${height}px` : height,\n        borderRadius: typeof borderRadius === 'number' ? `${borderRadius}px` : borderRadius,\n    };\n\n    return (\n        <div\n            className={cn(styles.skeleton, styles[`variant-${variant}`], className)}\n            style={style}\n            data-testid={testId}\n            aria-hidden='true'\n        />\n    );\n}\n"
  },
  "spec": {
    "$schema": "../../../specs/component-spec.schema.json",
    "identity": {
      "name": "Skeleton",
      "status": "preview",
      "version": "1.0.0",
      "summary": "A decorative shimmer placeholder that preserves the expected text, avatar, or block layout while content loads."
    },
    "parts": [
      {
        "id": "placeholder",
        "label": "Placeholder",
        "description": "Owns the requested dimensions, shape, and loading shimmer."
      },
      {
        "id": "base",
        "label": "Base layer",
        "description": "Provides the resting loading surface."
      },
      {
        "id": "highlight",
        "label": "Highlight layer",
        "description": "Moves across the base to communicate ongoing loading."
      }
    ],
    "allowedDesignChoices": {
      "variants": {
        "text": {
          "label": "Text"
        },
        "circle": {
          "label": "Circle"
        },
        "rectangle": {
          "label": "Rectangle"
        }
      },
      "sizes": {}
    },
    "variants": [
      {
        "id": "text",
        "label": "Text",
        "description": "A 16-unit line placeholder with a compact radius.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      },
      {
        "id": "circle",
        "label": "Circle",
        "description": "A fully round placeholder for an avatar or circular icon.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      },
      {
        "id": "rectangle",
        "label": "Rectangle",
        "description": "A rounded block placeholder for cards, media, or larger content.",
        "platforms": [
          "ios",
          "android",
          "web"
        ]
      }
    ],
    "sizes": [],
    "measurements": [
      {
        "id": "text-height",
        "label": "Text placeholder height",
        "kind": "exact",
        "token": "--cds-size-16",
        "value": 16,
        "unit": "px",
        "appliesTo": [
          "placeholder",
          "text"
        ]
      },
      {
        "id": "text-radius",
        "label": "Text placeholder radius",
        "kind": "exact",
        "token": "--cds-radius-xxs",
        "value": 4,
        "unit": "px",
        "appliesTo": [
          "placeholder",
          "text"
        ]
      },
      {
        "id": "rectangle-radius",
        "label": "Rectangle placeholder radius",
        "kind": "exact",
        "token": "--cds-radius-xs",
        "value": 8,
        "unit": "px",
        "appliesTo": [
          "placeholder",
          "rectangle"
        ]
      }
    ],
    "layout": {
      "alignment": "The placeholder occupies the exact box requested by its parent.",
      "flow": "It is a block-shaped decorative replacement for one expected content region.",
      "notes": [
        "Set width and height to match the content being reserved; circle placeholders need equal dimensions."
      ]
    },
    "typographyAndColor": {
      "typography": [
        {
          "label": "Text-line reference",
          "description": "The default text placeholder height aligns with the body text size.",
          "token": "--cds-type-body-size"
        }
      ],
      "colors": [
        {
          "label": "Base",
          "description": "Uses the theme-aware skeleton base role.",
          "token": "--cds-skeleton-base"
        },
        {
          "label": "Highlight",
          "description": "Uses the theme-aware skeleton highlight role.",
          "token": "--cds-skeleton-highlight"
        }
      ]
    },
    "states": [
      {
        "id": "loading",
        "label": "Loading",
        "description": "Shows the moving shimmer between base and highlight colors."
      },
      {
        "id": "reduced-motion",
        "label": "Reduced motion",
        "description": "Shows the same placeholder without shimmer animation."
      },
      {
        "id": "custom-geometry",
        "label": "Custom geometry",
        "description": "Uses caller-provided dimensions or radius while retaining the selected shape semantics."
      }
    ],
    "behavior": [
      {
        "label": "Layout preservation",
        "description": "Reserve the approximate geometry of the content that will replace the placeholder."
      },
      {
        "label": "Decoration only",
        "description": "Do not use Skeleton as a determinate progress indicator or status message."
      }
    ],
    "accessibility": [
      {
        "label": "Hidden placeholder",
        "description": "Hide the decorative shape from assistive technology."
      },
      {
        "label": "Busy region",
        "description": "When loading must be announced, mark the containing region busy or provide separate status copy."
      }
    ],
    "contentAdaptation": [
      {
        "label": "Shape matching",
        "description": "Use text for a text run, circle for a round identity or icon, and rectangle for a larger block."
      },
      {
        "label": "Unknown content",
        "description": "Avoid over-specific placeholder layouts when the eventual content shape is not known."
      }
    ],
    "motionHaptics": {
      "motion": [
        {
          "label": "Shimmer",
          "description": "Move the highlight across the base while loading and stop it for reduced motion."
        }
      ],
      "haptics": [
        {
          "label": "No feedback",
          "description": "Skeleton is non-interactive and does not request haptic feedback."
        }
      ]
    },
    "platformDifferences": []
  },
  "spec_source": "packages/design-system/src/components/primitives/Skeleton/Skeleton.spec.json",
  "guidance_source": {
    "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.mdx",
    "code": "import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';\nimport { ComponentSpec, UsageTable } from '../../../../.storybook/blocks';\nimport * as Stories from './Skeleton.stories';\nimport skeletonSpec from './Skeleton.spec.json';\n\n<Meta of={Stories} />\n\n# Skeleton\n\nA shimmer placeholder that stands in for content while it loads, sized to the shape it replaces.\n\n<Canvas of={Stories.Playground} />\n\n## When to use\n\nReach for `Skeleton` to hold the layout in place while data loads, so the screen doesn't jump when\ncontent arrives. It is decorative — `aria-hidden` and reduced-motion aware — so it never announces a\nbusy state to assistive tech. Size each placeholder to the real element it stands in for.\n\n-   Content finished loading but there's genuinely nothing to show? Use `EmptyState`.\n-   Need a small, announced, indeterminate busy indicator (not a layout stand-in)? Use `Spinner`, or\n    `Progress` for a determinate bar.\n\nPick `variant` by the shape you're standing in for:\n\n<UsageTable\n    rows={[\n        {\n            variant: 'text',\n            use: 'A line of copy — headings, labels, body runs. Set width to the expected text length.',\n        },\n        { variant: 'circle', use: 'A round element — avatars, icon bubbles. Match width and height.' },\n        { variant: 'rectangle', use: 'A block — cards, images, thumbnails, buttons. The default.' },\n    ]}\n/>\n\n## Design Guidelines\n\n<ComponentSpec spec={skeletonSpec} />\n\n## Props\n\n<Controls of={Stories.Playground} />\n"
  },
  "props": [
    {
      "name": "variant",
      "type": "SkeletonVariant | undefined",
      "declared_type": "SkeletonVariant",
      "required": false,
      "description": "Shape preset: corner radius for all three, plus a 16px height for `text`. Defaults to `rectangle`.",
      "source": {
        "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
        "line": 13
      },
      "values": [
        "circle",
        "rectangle",
        "text"
      ],
      "values_complete": true,
      "default": "'rectangle'",
      "default_kind": "source-expression"
    },
    {
      "name": "width",
      "type": "string | number | undefined",
      "declared_type": "number | string",
      "required": false,
      "description": "Width as a number (px) or any CSS length.",
      "source": {
        "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
        "line": 15
      }
    },
    {
      "name": "height",
      "type": "string | number | undefined",
      "declared_type": "number | string",
      "required": false,
      "description": "Height as a number (px) or any CSS length.",
      "source": {
        "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
        "line": 17
      }
    },
    {
      "name": "borderRadius",
      "type": "string | number | undefined",
      "declared_type": "number | string",
      "required": false,
      "description": "Corner radius override (number = px); otherwise the variant default applies.",
      "source": {
        "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
        "line": 19
      }
    },
    {
      "name": "className",
      "type": "string | undefined",
      "declared_type": "string",
      "required": false,
      "description": "",
      "source": {
        "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
        "line": 20
      }
    },
    {
      "name": "style",
      "type": "React.CSSProperties | undefined",
      "declared_type": "React.CSSProperties",
      "required": false,
      "description": "",
      "source": {
        "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
        "line": 21
      }
    },
    {
      "name": "testId",
      "type": "string | undefined",
      "declared_type": "string",
      "required": false,
      "description": "Selector on the placeholder — it is `aria-hidden`, so there is no role or name to query by.",
      "source": {
        "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
        "line": 23
      }
    }
  ],
  "prop_shapes": {},
  "examples": [],
  "tokens": [
    {
      "name": "--cds-size-16",
      "light": "16px",
      "dark": "16px"
    },
    {
      "name": "--cds-radius-xxs",
      "light": "4px",
      "dark": "4px"
    },
    {
      "name": "--cds-radius-xs",
      "light": "8px",
      "dark": "8px"
    },
    {
      "name": "--cds-type-body-size",
      "light": "1rem",
      "dark": "1rem"
    },
    {
      "name": "--cds-skeleton-base",
      "light": "#0b0b0a0d",
      "dark": "#ffffff0d"
    },
    {
      "name": "--cds-skeleton-highlight",
      "light": "#0b0b0a26",
      "dark": "#ffffff26"
    }
  ],
  "visual_reference": {
    "stories": [
      {
        "id": "cloaked-design-system-primitives-skeleton--playground",
        "name": "Playground",
        "title": "Cloaked Design System/Primitives/Skeleton",
        "exportName": "Playground",
        "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
        "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--playground&viewMode=story"
      },
      {
        "id": "cloaked-design-system-primitives-skeleton--rectangle",
        "name": "Rectangle",
        "title": "Cloaked Design System/Primitives/Skeleton",
        "exportName": "Rectangle",
        "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
        "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--rectangle&viewMode=story"
      },
      {
        "id": "cloaked-design-system-primitives-skeleton--text",
        "name": "Text",
        "title": "Cloaked Design System/Primitives/Skeleton",
        "exportName": "Text",
        "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
        "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--text&viewMode=story"
      },
      {
        "id": "cloaked-design-system-primitives-skeleton--circle",
        "name": "Circle",
        "title": "Cloaked Design System/Primitives/Skeleton",
        "exportName": "Circle",
        "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
        "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--circle&viewMode=story"
      },
      {
        "id": "cloaked-design-system-primitives-skeleton--custom-radius",
        "name": "Custom Radius",
        "title": "Cloaked Design System/Primitives/Skeleton",
        "exportName": "CustomRadius",
        "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
        "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--custom-radius&viewMode=story"
      },
      {
        "id": "cloaked-design-system-primitives-skeleton--styled",
        "name": "Styled",
        "title": "Cloaked Design System/Primitives/Skeleton",
        "exportName": "Styled",
        "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
        "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--styled&viewMode=story"
      },
      {
        "id": "cloaked-design-system-primitives-skeleton--dark-theme",
        "name": "Dark Theme",
        "title": "Cloaked Design System/Primitives/Skeleton",
        "exportName": "DarkTheme",
        "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
        "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
        "status": "preview",
        "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--dark-theme&viewMode=story"
      }
    ],
    "name": "Skeleton",
    "id": "skeleton",
    "category": "Primitives"
  },
  "stories": [
    {
      "id": "cloaked-design-system-primitives-skeleton--playground",
      "name": "Playground",
      "title": "Cloaked Design System/Primitives/Skeleton",
      "exportName": "Playground",
      "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
      "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
      "status": "preview",
      "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--playground&viewMode=story"
    },
    {
      "id": "cloaked-design-system-primitives-skeleton--rectangle",
      "name": "Rectangle",
      "title": "Cloaked Design System/Primitives/Skeleton",
      "exportName": "Rectangle",
      "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
      "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
      "status": "preview",
      "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--rectangle&viewMode=story"
    },
    {
      "id": "cloaked-design-system-primitives-skeleton--text",
      "name": "Text",
      "title": "Cloaked Design System/Primitives/Skeleton",
      "exportName": "Text",
      "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
      "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
      "status": "preview",
      "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--text&viewMode=story"
    },
    {
      "id": "cloaked-design-system-primitives-skeleton--circle",
      "name": "Circle",
      "title": "Cloaked Design System/Primitives/Skeleton",
      "exportName": "Circle",
      "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
      "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
      "status": "preview",
      "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--circle&viewMode=story"
    },
    {
      "id": "cloaked-design-system-primitives-skeleton--custom-radius",
      "name": "Custom Radius",
      "title": "Cloaked Design System/Primitives/Skeleton",
      "exportName": "CustomRadius",
      "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
      "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
      "status": "preview",
      "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--custom-radius&viewMode=story"
    },
    {
      "id": "cloaked-design-system-primitives-skeleton--styled",
      "name": "Styled",
      "title": "Cloaked Design System/Primitives/Skeleton",
      "exportName": "Styled",
      "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
      "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
      "status": "preview",
      "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--styled&viewMode=story"
    },
    {
      "id": "cloaked-design-system-primitives-skeleton--dark-theme",
      "name": "Dark Theme",
      "title": "Cloaked Design System/Primitives/Skeleton",
      "exportName": "DarkTheme",
      "source_path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
      "source_digest": "0436f88ccc17a9d435ce410a8793457af02a19086ee454c92ac6efa799d38e62",
      "status": "preview",
      "local_url": "/storybook/iframe.html?id=cloaked-design-system-primitives-skeleton--dark-theme&viewMode=story"
    }
  ],
  "stories_source": {
    "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.stories.tsx",
    "code": "import type { Meta, StoryObj } from '@storybook/react-vite';\nimport { selectArgType } from '../../../storybook/controlOptions';\nimport { Skeleton, type SkeletonVariant } from './Skeleton';\n\nconst SKELETON_VARIANTS = ['text', 'circle', 'rectangle'] as const satisfies readonly SkeletonVariant[];\n\nconst meta: Meta<typeof Skeleton> = {\n    title: 'Cloaked Design System/Primitives/Skeleton',\n    component: Skeleton,\n    parameters: {\n        a11y: { test: 'error' },\n        docs: {\n            description: {\n                component:\n                    'Shimmer placeholder that stands in for content while it loads, sized to the shape it ' +\n                    'replaces (`text` line, `circle` avatar, `rectangle` block). It is decorative — `aria-hidden` ' +\n                    'and reduced-motion aware — so use it for layout-preserving loading states, and reach for ' +\n                    '`Spinner`/`Progress` when you need a determinate or announced busy indicator instead.',\n            },\n        },\n    },\n    args: {\n        variant: 'rectangle',\n        width: 240,\n        height: 48,\n    },\n    argTypes: {\n        variant: {\n            ...selectArgType(SKELETON_VARIANTS),\n            description: 'Shape and default corner radius of the placeholder.',\n        },\n        width: { control: 'text', description: 'Width as a number (px) or any CSS length.' },\n        height: { control: 'text', description: 'Height as a number (px) or any CSS length.' },\n        borderRadius: {\n            control: 'text',\n            description: 'Corner-radius override (number = px); otherwise the variant default applies.',\n        },\n    },\n};\nexport default meta;\ntype Story = StoryObj<typeof Skeleton>;\n\nexport const Playground: Story = {};\n\n/** Block placeholder for cards, images, and large regions. */\nexport const Rectangle: Story = { args: { variant: 'rectangle', width: 240, height: 48 } };\n\n/** Line placeholder sized to a text run. */\nexport const Text: Story = { args: { variant: 'text', width: 160 } };\n\n/** Round placeholder for avatars and icons. */\nexport const Circle: Story = { args: { variant: 'circle', width: 48, height: 48 } };\n\n/** `borderRadius` override on a rectangle. */\nexport const CustomRadius: Story = { args: { variant: 'rectangle', width: 240, height: 80, borderRadius: 20 } };\n\n/** `style` escape hatch for one-off spacing. */\nexport const Styled: Story = {\n    args: {\n        variant: 'rectangle',\n        width: 240,\n        height: 48,\n        style: { margin: 'var(--cds-space-8)' },\n    },\n};\n\nexport const DarkTheme: Story = {\n    args: { variant: 'rectangle', width: 240, height: 48 },\n    globals: { theme: 'dark' },\n};\n"
  },
  "links": {
    "human": "/component-skeleton",
    "json": "/data/components/skeleton.json",
    "markdown": "/data/components/skeleton.md",
    "storybook": "/storybook/?path=/story/cloaked-design-system-primitives-skeleton--playground"
  },
  "contract_status": "preview",
  "contract_kind": "source-derived",
  "approval": "required",
  "api": {
    "method": "typescript-type-checker",
    "typescript_version": "5.9.3",
    "public_export": "Skeleton",
    "public_path": "Skeleton",
    "import_path": "@cloakedinc/design-system",
    "root_kind": "component",
    "entrypoints": [
      {
        "name": "Skeleton",
        "signature": 1,
        "visibility": "public",
        "source": {
          "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
          "line": 30
        },
        "props_type": "SkeletonProps",
        "props": [
          {
            "name": "variant",
            "type": "SkeletonVariant | undefined",
            "declared_type": "SkeletonVariant",
            "required": false,
            "description": "Shape preset: corner radius for all three, plus a 16px height for `text`. Defaults to `rectangle`.",
            "source": {
              "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
              "line": 13
            },
            "values": [
              "circle",
              "rectangle",
              "text"
            ],
            "values_complete": true,
            "default": "'rectangle'",
            "default_kind": "source-expression"
          },
          {
            "name": "width",
            "type": "string | number | undefined",
            "declared_type": "number | string",
            "required": false,
            "description": "Width as a number (px) or any CSS length.",
            "source": {
              "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
              "line": 15
            }
          },
          {
            "name": "height",
            "type": "string | number | undefined",
            "declared_type": "number | string",
            "required": false,
            "description": "Height as a number (px) or any CSS length.",
            "source": {
              "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
              "line": 17
            }
          },
          {
            "name": "borderRadius",
            "type": "string | number | undefined",
            "declared_type": "number | string",
            "required": false,
            "description": "Corner radius override (number = px); otherwise the variant default applies.",
            "source": {
              "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
              "line": 19
            }
          },
          {
            "name": "className",
            "type": "string | undefined",
            "declared_type": "string",
            "required": false,
            "description": "",
            "source": {
              "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
              "line": 20
            }
          },
          {
            "name": "style",
            "type": "React.CSSProperties | undefined",
            "declared_type": "React.CSSProperties",
            "required": false,
            "description": "",
            "source": {
              "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
              "line": 21
            }
          },
          {
            "name": "testId",
            "type": "string | undefined",
            "declared_type": "string",
            "required": false,
            "description": "Selector on the placeholder — it is `aria-hidden`, so there is no role or name to query by.",
            "source": {
              "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
              "line": 23
            }
          }
        ],
        "branches": [],
        "constraints": [],
        "extraction_status": "extracted"
      }
    ],
    "type_sources": [
      {
        "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
        "line": 5,
        "name": "SkeletonVariant",
        "code": "export type SkeletonVariant = 'text' | 'circle' | 'rectangle';"
      },
      {
        "path": "packages/design-system/src/components/primitives/Skeleton/Skeleton.tsx",
        "line": 11,
        "name": "SkeletonProps",
        "code": "export interface SkeletonProps {\n    /** Shape preset: corner radius for all three, plus a 16px height for `text`. Defaults to `rectangle`. */\n    variant?: SkeletonVariant;\n    /** Width as a number (px) or any CSS length. */\n    width?: number | string;\n    /** Height as a number (px) or any CSS length. */\n    height?: number | string;\n    /** Corner radius override (number = px); otherwise the variant default applies. */\n    borderRadius?: number | string;\n    className?: string;\n    style?: React.CSSProperties;\n    /** Selector on the placeholder — it is `aria-hidden`, so there is no role or name to query by. */\n    testId?: string;\n}"
      }
    ],
    "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."
  }
}