Markdown is non deterministic when it comes to piping it through an LLM. Sure the prompt intent is the same, but it doesn't guarantee the same output.
I would much rather have significantly more detailed comments inline with code to describe the intention at any given step than just a high level markdown file. We already have PDRs and markdown seems like it would just be an extension of that.
That is visible in your code. I was mildly skeptical at first because it just didn't seem like it was doing much more than other design systems. Then I looked at the code.
You've built something really great here, your grasp of web components is incredibly strong, and the way you use TypeScript is very light handed in a way that made the code just a delight to read through, in a way I've not had in many years. It's been a while since I looked at a new library's codebase and learned something new, so thank you for that!
This may sound silly, but I think you've laid the foundation here for the next Bootstrap / MUI. It just needs more expandability and distribution options.
I would much rather have significantly more detailed comments inline with code to describe the intention at any given step than just a high level markdown file. We already have PDRs and markdown seems like it would just be an extension of that.
reply