shadcn-agents-cva-validator

To validate shadcn UI cva variant APIs during code review, run a deterministic seven-check audit that verifies base classes, variants shape, compoundVariants order, defaultVariants completeness, VariantProps export, cn() class merging, and Radix Slot usage, returning a clear PASS or FAIL verdict.

Shadcn component variant merging fails when raw className concatenation is used instead of the cn() utility; the validator checks that caller className is properly merged with cva base classes using cn() to prevent silent style overrides.

The correct cva structure for shadcn ui requires proper base classes, a valid variants shape, compoundVariants placed after variants, complete defaultVariants, an exported VariantProps type, and correct Radix Slot branching for asChild composition.

Yes, this cva validator catches frequent AI-generated component regressions like nested cn inside cva, compoundVariants declared before variants, defaultVariants typos, VariantProps drift, and missing Slot branching by stopping at the first failure with an exact verdict block.

You can use this validator as a pre-commit guardrail in TypeScript projects to audit shadcn component diffs, stopping at the first structural failure and emitting an exact verdict block with a line reference and canonical fix pointer before accepting the change.