How about adding a story system to the library?
Currently we are defining the usage in static docs page but with stories we could display all the button sates in an interactive manner and let users play with the components.
I was working on this branch a while back and since I'm cleaning some local stuff up, I decided to publish it. I've played here a bit with histoire.dev to check it out and see how well we could integrate it. It's still in a very early stage but it looks promising. I've been having some major difficulties with integrating Vue/Vite projects with storybook in the past, hence the decision to play with Vite-native tool.
To run histoire: