Documenting ViewComponent slots

[koppen]

Summary

Adds a custom YARD plugin that defines the @viewcomponent_slot tag for documenting ViewComponent slots. This allows developers to document slots in a structured way, similar to how @param works for method parameters.

The tag accepts types (optional), a slot name, and a description, and is rendered in the generated documentation as a styled list section.

Test plan

• Run bundle exec rake docs:refresh_registry to generate docs with the new plugin
• Verify slot documentation is parsed correctly in YARD registry
• Check that the "Slots" section renders properly in the demo docs view

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR adds a custom YARD plugin to enable structured documentation of ViewComponent slots using the @viewcomponent_slot tag. The implementation follows YARD's conventions for custom tags and provides rendering in the documentation viewer.

Changes:

• Added a YARD plugin that defines the @viewcomponent_slot tag with type, name, and description support
• Updated the documentation view template to render slot documentation in a "Slots" section
• Added @viewcomponent_slot documentation to three existing components (Card, Breadcrumb, and InputField)
• Modified the Rakefile to load the custom YARD plugin during documentation generation
• Regenerated YARD registry files to include the new slot documentation

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
lib/yard/flowbite_viewcomponent.rb	New YARD plugin defining the @viewcomponent_slot tag for documenting ViewComponent slots
demo/app/views/docs/components/show.html.erb	Added rendering logic for the "Slots" section displaying documented slots with types and descriptions
Rakefile	Updated the docs:refresh_registry task to load the custom YARD plugin with the -e flag
app/components/flowbite/card.rb	Added @viewcomponent_slot documentation for the title slot
app/components/flowbite/breadcrumb.rb	Added @viewcomponent_slot documentation for the items slot
app/components/flowbite/input_field.rb	Added @viewcomponent_slot documentation for hint, input, and label slots
demo/.yardoc/objects/root.dat	Regenerated YARD registry file with the new slot documentation
demo/.yardoc/checksums	Updated checksums for files with new slot documentation

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Using html_safe on user-provided content from link_to can introduce XSS vulnerabilities. The slot_tag.types values come from YARD documentation tags, but treating them as safe HTML without proper sanitization is risky. Consider using safe_join instead to properly escape each type before joining them, or ensure that the types are already properly escaped by the link_to helper before joining.

Suggested change

	<span class="type">(<%= slot_tag.types.map { |t| link_to(t, "#") }.join(", ").html_safe %>)</span>
	<span class="type">(<%= safe_join(slot_tag.types.map { |t| link_to(t, "#") }, ", ") %>)</span>

[Copilot]

The links generated for slot types point to "#" which doesn't navigate anywhere useful. Consider implementing proper links to the actual type documentation, or if the links aren't functional yet, use a <span> or <code> tag instead of generating non-functional anchor tags.

Suggested change

	<span class="type">(<%= slot_tag.types.map { |t| link_to(t, "#") }.join(", ").html_safe %>)</span>
	<span class="type">(<%= slot_tag.types.join(", ") %>)</span>