{
  "name": "FeatureCardTwentyFive",
  "description": "Feature section with icon, title, description, and two-column media grid per card.",
  "constraints": {
    "textRules": {
      "title": {
        "required": true,
        "example": "Our Features",
        "minChars": 2,
        "maxChars": 50
      },
      "description": {
        "required": true,
        "example": "Discover what makes us different",
        "minChars": 5,
        "maxChars": 250
      },
      "tag": {
        "required": false,
        "example": "Features",
        "minChars": 2,
        "maxChars": 30
      }
    },
    "buttonRules": {
      "maxButtons": 2,
      "structure": {
        "text": "string - Button label",
        "href": "string - Link destination (optional)",
        "onClick": "() => void - Additional click handler (optional)",
        "props": "Partial<ButtonPropsForVariant> - Additional button props (optional)"
      },
      "note": "Button variant is controlled by ThemeProvider's defaultButtonVariant."
    },
    "featureRules": {
      "title": {
        "required": true,
        "example": "Advanced Analytics",
        "minChars": 2,
        "maxChars": 50
      },
      "description": {
        "required": true,
        "example": "Track your metrics in real-time.",
        "minChars": 5,
        "maxChars": 150
      },
      "icon": {
        "required": true,
        "note": "LucideIcon displayed in primary-button styled container"
      },
      "mediaItems": {
        "required": true,
        "exactCount": 2,
        "note": "Tuple of exactly 2 MediaItems, each with imageSrc/videoSrc and optional alt/ariaLabel"
      }
    }
  },
  "propsSchema": {
    "features": "FeatureCard[] (required) - Array with title, description, icon, mediaItems (tuple of 2)",
    "carouselMode?": "'auto' | 'buttons' (default: 'buttons')",
    "uniformGridCustomHeightClasses?": "string",
    "animationType": "CardAnimationTypeWith3D",
    "title": "string",
    "titleSegments?": "TitleSegment[]",
    "description": "string",
    "tag?": "string",
    "tagIcon?": "LucideIcon",
    "tagAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
    "buttons?": "ButtonConfig[]",
    "buttonAnimation?": "'none' | 'opacity' | 'slide-up' | 'blur-reveal'",
    "textboxLayout": "TextboxLayout",
    "useInvertedBackground": "InvertedBackground",
    "ariaLabel?": "string (default: 'Feature section')",
    "className?": "string",
    "containerClassName?": "string",
    "cardClassName?": "string",
    "mediaClassName?": "string",
    "textBoxTitleClassName?": "string",
    "textBoxTitleImageWrapperClassName?": "string",
    "textBoxTitleImageClassName?": "string",
    "textBoxDescriptionClassName?": "string",
    "cardTitleClassName?": "string",
    "cardDescriptionClassName?": "string",
    "cardIconClassName?": "string",
    "cardIconWrapperClassName?": "string",
    "gridClassName?": "string",
    "carouselClassName?": "string",
    "controlsClassName?": "string",
    "textBoxClassName?": "string",
    "textBoxTagClassName?": "string",
    "textBoxButtonContainerClassName?": "string",
    "textBoxButtonClassName?": "string",
    "textBoxButtonTextClassName?": "string"
  },
  "usageExample": "<ThemeProvider defaultButtonVariant=\"icon-arrow\" borderRadius=\"rounded\">\n  <FeatureCardTwentyFive\n    title=\"Our Features\"\n    description=\"Discover what makes us different.\"\n    tag=\"Features\"\n    tagIcon={Sparkles}\n    textboxLayout=\"default\"\n    animationType=\"fade\"\n    useInvertedBackground=\"none\"\n    features={[\n      {\n        title: \"Advanced Analytics\",\n        description: \"Track your metrics in real-time.\",\n        icon: BarChart,\n        mediaItems: [\n          { imageSrc: \"/analytics1.jpg\", imageAlt: \"Analytics dashboard\" },\n          { imageSrc: \"/analytics2.jpg\", imageAlt: \"Analytics charts\" }\n        ]\n      },\n      {\n        title: \"Team Collaboration\",\n        description: \"Work together seamlessly.\",\n        icon: Users,\n        mediaItems: [\n          { imageSrc: \"/team1.jpg\", imageAlt: \"Team working\" },\n          { imageSrc: \"/team2.jpg\", imageAlt: \"Collaboration\" }\n        ]\n      }\n    ]}\n  />\n</ThemeProvider>",
  "do": [
    "Use for features with visual examples",
    "Each feature requires exactly 2 media items",
    "Use relevant icons for each feature",
    "Supports 3D animations"
  ],
  "dont": [
    "Do not use without 2 media items per feature",
    "Do not use without icons"
  ],
  "editRules": {
    "textOnly": true,
    "layoutLocked": true,
    "styleLocked": true
  }
}
