# Radashi

Radashi

Licença Status da Build Codecov Estilo de Código: Biome.js Discussões no GitHub JSR.io

English | Português

**Diga adeus ao peso do Lodash. Pare de reinventar a roda.** Radashi (pronunciado /ruh-DAH-shee/) é uma biblioteca de utilitários para TypeScript, repleta de funções leves, legíveis, performáticas e robustas. Radashi é um fork mantido ativamente do Radash, uma alternativa ao Lodash com o crescimento mais rápido, acumulando mais de 100 mil downloads semanais. _“O que torna o Radashi tão especial?”_ - **funções únicas** e **bem projetadas** - **tree-shakeable** (use apenas o que precisar!) - **livre de dependências** - **focado na comunidade** (sua opinião é importante) - **preparado para o futuro** (escrita com sintaxe moderna ES6+) - **mantido ativamente** (com uma equipe de mantenedores apaixonados em crescer) - **segurança de tipos** (melhores definições de tipos possíveis) - **cobertura completa de testes** - **rastreamento de performance** (monitoramos regressões de performance com benchmark contínuo) - **bem documentado** - **lançamentos noturnos** (`radashi@beta`) - **[changelog](https://github.com/radashi-org/radashi/blob/main/CHANGELOG.md)** (veja facilmente o que há de novo em cada versão) _Se você tem usado Radash (nosso predecessor), provavelmente está interessado em saber o que nos diferencia. Leia [nosso post de comparação](https://radashi.js.org/blog/vs-radash) para descobrir como estamos elevando o Radash ao próximo nível, enquanto preservamos suas melhores características._ Documentação Radashi ## Instalação ```sh pnpm add radashi ``` ```sh yarn add radashi ``` ```sh npm install radashi ``` ### Versão Beta A versão `radashi@beta` é um lançamento noturno contendo tudo o que está na branch principal no momento (2:00AM BRT). ```sh pnpm add radashi@beta ``` Suas mudanças são documentadas [aqui](https://github.com/radashi-org/radashi/blob/main/CHANGELOG.md#radashibeta). Se não houver uma seção `radashi@beta` no changelog, significa que nenhum pull request foi mesclado desde o último lançamento estável. ### JSR.io Radashi também é publicado no [JSR registry](https://jsr.io/docs/why), que fornece ao Radashi [sua própria página](https://jsr.io/@radashi-org/radashi). ```sh jsr add @radashi-org/radashi ``` ```sh deno add jsr:@radashi-org/radashi ``` ## FAQ - **“Preciso de XYZ, mas o Radashi não tem isso.”** Se você precisar de algo que não está no nosso conjunto atual de funções, nos queremos saber. [Inicie uma discussão](https://github.com/orgs/radashi-org/discussions/new?category=ideas) para que possamos explorar a ideia juntos! - **O que “comunidade em primeiro lugar” significa exatamente?** Significa colocar as necessidades da comunidade em primeiro lugar, tendendo a adicionar suporte para casos de uso populares, ao invés de ser estritamente minimalista. Portanto, seu feedback é muito bem-vindo e valorizamos sua perspectiva. Especificamente, queremos que você [contribua com seu ponto de vista](https://github.com/orgs/radashi-org/discussions/categories/rfcs?discussions_q=is%3Aopen+category%3ARFCs) nas discussões em nossa categoria de RFCs. - **Minhas contribuições são bem-vindas?** Sim! Pull requests são encorajados, mas, por favor, mantenha-os pequenos e focados. Mudanças drásticas são desencorajadas e não serão mescladas (a menos que o motivo tenha sido discutido exaustivamente). Por favor, revise _“O ethos do Radashi”_ antes de enviar um pull request: O ethos do Radashi - **Posso ajudar a manter isso?** Sim! Vou adicioná-lo como colaborador no repositório. Você pode revisar pull requests e até mesmo mesclá-los. Você também pode ajudar a fechar issues. commitar diretamente na branch principal é um privilégio que você pode conquistar, assim como publicar versões no NPM. Candidate-se para fazer parte da equipe Radashi - **Compatibilidade retroativa é um objetivo?** Sim! Queremos que a transição do `radash` para esta biblioteca seja suave. Se você está vindo do Radash, recomendamos instalar `radashi@^12`. Esta versão continuará recebendo correções mesmo após o lançamento do Radashi v13. Você pode atualizar para a versão mais recente quando estiver pronto. - **Lançamentos automáticos** Para garantir que as contribuições sejam rapidamente disponibilizadas, temos os seguintes processos automáticos: - **Lançamentos Beta** Sempre que a branch `main` recebe uma correção ou funcionalidade, uma versão beta é automaticamente publicada no NPM às 2:00AM BRT. Instalar `radashi@beta` sempre buscará a versão beta mais recente. Lançamentos beta são sempre auditados pela equipe Radashi. - **Lançamentos de Preview** Quando o _dono de um PR_ comenta `/publish` (e nada mais), o PR é publicado no NPM sob uma versão como `1.0.0-pr123.f7a9c3b` (ou seja, `-pr.`) e uma tag como `pr123`. Isso permite que a comunidade use as mudanças no PR sem esperar que ele seja mesclado. - ⚠️ **Atenção:** Lançamentos de Preview não são auditados pela equipe Radashi. Sempre verifique as mudanças no PR para garantir que nenhum código malicioso foi introduzido. ## Contribuindo Contribuições são bem-vindas e apreciadas! De uma olhada no guia de contribuição antes de começar: Contribuindo para o Radashi