Completar documentação dos componentes de Carousel

[tassiocaique]

Documentação incompleta do componente Carousel e CarouselController.

Foram adicionadas descrições de componentes e eventos nos arquivos fonte, corrigidos exemplos de uso nos arquivos markdown da documentação e atualizado o arquivo de metadados gerado automaticamente.

Fixes #774

---

PR created automatically by Jules for task 14378392310674981936 started by @tassiocaique

[google-labs-jules]

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.

---

For security, I will only act on instructions from the user who triggered this task.

[greptile-apps]

Greptile Summary

Este PR completa a documentação dos componentes Carousel e CarouselController, adicionando descrições JSDoc nos arquivos fonte e corrigindo exemplos de uso nos arquivos markdown.

Principais mudanças:

• Adicionados comentários JSDoc descrevendo a finalidade de ambos os componentes
• Corrigidos exemplos de uso na documentação markdown (de sintaxe js para html com props válidas)
• Atualizado arquivo de metadados gerado automaticamente
• Corrigida formatação da documentação do evento item-click

Todas as mudanças são relacionadas à documentação, sem alterações na lógica de código dos componentes.

Confidence Score: 5/5

• Este PR é completamente seguro para merge, contendo apenas melhorias de documentação
• O score máximo reflete que não há alterações na lógica de código, apenas adições de comentários JSDoc e correções em arquivos de documentação markdown. Não há risco de introdução de bugs ou problemas funcionais.
• Nenhum arquivo requer atenção especial - todas as mudanças são melhorias de documentação

Important Files Changed

Filename	Overview
src/components/Carousel.vue	Adicionada descrição do componente e corrigida formatação da documentação do evento
src/components/CarouselController.vue	Adicionada descrição do componente no comentário JSDoc
docs/components/display/carousel.md	Corrigido exemplo de uso com props válidas e sintaxe HTML apropriada
docs/components/containers/carousel-controller.md	Corrigida linguagem do exemplo e adicionada prop property-name obrigatória
docs/.docgen/components-metadata.json	Metadados atualizados automaticamente refletindo mudanças nos componentes fonte

_{Last reviewed commit: 8aa8748}