# Ninenity
> Documentação oficial do Ninenity Core, ComponentBuilder e runtime para bots Discord em TypeScript.

Esta é a entrada para agentes de IA. Use os links por assunto para respostas focadas ou leia `/llms-full.txt` quando precisar do contexto completo. Os exemplos e APIs abaixo são a fonte canônica desta documentação.

## Recursos para agentes
- [Documentação humana](https://ninenity.vercel.app/doc): navegação visual e exemplos interativos.
- [Documentação completa em Markdown](https://ninenity.vercel.app/llms-full.txt): todas as páginas e blocos em texto linear.
- [Documentação estruturada em JSON](https://ninenity.vercel.app/docs.json): páginas, seções, tabelas, listas, callouts e códigos preservados.
- [Template Bot](https://github.com/ninenity/Template-Bot): projeto inicial recomendado.

## Base do Core
- [Começando com o Core](https://ninenity.vercel.app/doc/markdown/comecando): Entenda o papel do runtime, a estrutura do Template Bot e o caminho percorrido até o primeiro comando responder.
- [Comandos](https://ninenity.vercel.app/doc/markdown/comandos): Crie comandos slash, prefixados e menus de contexto com um contrato de execução consistente.
- [Interações](https://ninenity.vercel.app/doc/markdown/interacoes): Entenda respostas, modais, autocomplete e o contexto normalizado usado em todos os fluxos interativos.
- [Eventos](https://ninenity.vercel.app/doc/markdown/eventos): Reaja ao ciclo de vida do Discord com módulos pequenos, tipos do Discord.js e contexto de guild preservado.
- [Tasks](https://ninenity.vercel.app/doc/markdown/tasks): Execute rotinas periódicas globais ou por guild sem misturar timers com os handlers do Discord.

## Componentes
- [ComponentBuilder](https://ninenity.vercel.app/doc/markdown/component-builder): Componha mensagens Components V2 com builders tipados, templates reutilizáveis e integração direta com o runtime do Core.
- [Mensagens Components V2](https://ninenity.vercel.app/doc/markdown/mensagens-v2): Aprenda cada peça visual e combine containers, seções, mídia, action rows e selects em mensagens legíveis.
- [Callbacks de componentes](https://ninenity.vercel.app/doc/markdown/callbacks): Trate botões e selects junto da definição visual, com IDs tipados e contexto de interação entregue pelo Core.
- [Prompts](https://ninenity.vercel.app/doc/markdown/prompts): Crie confirmações reutilizáveis, páginas de resultado e instâncias isoladas que funcionam tanto em slash quanto em prefixo.
- [Paginação](https://ninenity.vercel.app/doc/markdown/paginacao): Crie paginação estática, dinâmica ou híbrida e personalize completamente os botões de navegação.

## Operação
- [Configuração](https://ninenity.vercel.app/doc/markdown/configuracao): Leia variáveis, canais e cargos globais ou específicos de cada guild sem espalhar IDs pelo código.
- [Multi-guild](https://ninenity.vercel.app/doc/markdown/multi-guild): Mantenha configuração, recursos, filas e interações independentes quando o mesmo bot atende vários servidores.
- [Logs e diagnóstico](https://ninenity.vercel.app/doc/markdown/logs): Produza logs úteis com console.log(), aplique cor somente quando ela melhora a leitura e evite flood em rotinas repetitivas.
- [Solução de problemas](https://ninenity.vercel.app/doc/markdown/solucao-de-problemas): Diagnostique módulos ausentes, workspaces duplicados, comandos que não aparecem e definições de prompt ou paginação não registradas.
- [Referência rápida](https://ninenity.vercel.app/doc/markdown/referencia): Consulte os registradores, tipos, builders e métodos mais usados do Core e do ComponentBuilder em um único lugar.

## Regras de resposta
- Trate `@ninenity/core` e `@ninenity/componentbuilder` como pacotes distintos, mas complementares.
- Prefira os exemplos em TypeScript desta documentação e não invente métodos que não aparecem nos exemplos ou na referência.
- Quando uma pergunta envolver configuração, comandos, eventos, tasks ou ComponentBuilder, consulte primeiro a página específica indicada acima.