How do you properly comment variants?

[cgatian]

I'm building a simple button component with a SVA recipe with a variant of size. I would like to document the size variant using JSDoc. However, it doesn't appear it's possible when using RecipeVariantProps to include code comments within the recipe.

As a workaround, I've exported the recipe's props using the RecipeVariantProps type utility and marked it as NonNullable.

export type ButtonRecipeVariantProps = NonNullable<RecipeVariantProps<typeof buttonRecipe>>;

This allows me to create an interface that extends from the ButtonRecipeVariantProps.

export interface BaseButtonProps extends ButtonRecipeVariantProps {
   /**
   * Document the size
   */
  size?: 'small' | 'large';
}

❓Is there a better way to go about doing this? How are others solving this. Thank you.