Atualizar ambiente, aprimorar hooks e scripts

[matbrgz]

🎯 Objetivo

Consolidar diversas melhorias ao projeto, incluindo:

• Requisitos de ambiente: passar a exigir Node.js ≥18 e pnpm ≥9.15.3;

• Fluxo de contribuições: atualizar CONTRIBUTING.md e README.md com as novas instruções de setup;

• Qualidade de código: adicionar Husky + Commitlint + lint-staged para pré-commits e mensagens;

• CLI: reforçar checagem de versão de Node e pnpm em guara-cli;

• Hooks:

  • useAxios: novos métodos para configurar cabeçalhos, baseURL, timeout, interceptors e cancelamento de requisição;
  • useBetterAuth: novo hook para fluxo de autenticação completo (login, logout, refresh, updateUser);
  • Ajustes de tipagem e genéricos em diversos hooks (useFetch, useCookie, useLocalStorage, useSessionStorage, useNotifications, useNextAuth, etc.);

• Registry:

  • Ajustar tipos em __registry__/index.tsx e em scripts/build-registry.mts;
  • Remover arquivos de tipagem obsoletos (types/docs.d.ts, types/lucide-react.d.ts, types/unist.d.ts);

• Scripts de validação: criar scripts/check-node.mjs e scripts/check-pnpm.mjs para verificar versões mínimas;

• Dependências: bump de versões em package.json e lockfile.

---

📝 Descrição das principais alterações

1. Ambientação

   • Adição de .nvmrc com 18 e .npmrc com engine-strict=true.
   • Atualização de preinstall em package.json para rodar check-node e check-pnpm.
   • Documentação (CONTRIBUTING.md, README.md, content/docs/**) agora instruem uso de Node.js 18+ e pnpm 9.15.3+.

2. Ferramentas de qualidade

   • Configuração do Husky: hooks pre-commit (lint-staged) e commit-msg (commitlint).
   • Ajuste de scripts no package.json para só-allow-pnpm via pnpm dlx only-allow pnpm.

3. Melhorias na CLI (packages/cli)

   • Verificação de versão de Node.js e pnpm no entrypoint; mensagens de erro orientam nvm install/nvm use.
   • Readme e package.json alinhados ao novo diretório packages/cli.

4. Aprimoramento dos Hooks

   • useAxios: suporte a setHeaders, resetHeaders, setBaseURL, resetBaseURL, setTimeout, resetTimeout, setConfig, resetConfig, setInterceptors, resetInterceptors, cancelRequest, resetError, resetData.
   • useBetterAuth: novo hook genérico para gerenciar token, usuário, login, logout, refresh, interceptor automático e persistência em storage customizável.
   • Ajustes de tipagem genérica em useFetch, useCookie, useLocalStorage, useSessionStorage, useNotifications e useNextAuth, para garantir inferência correta de TData, TBody e opções.

5. Registro de Hooks (Registry)

   • Atualização de tipos em __registry__/index.tsx e script build-registry para indexar corretamente RegistryItem.
   • Remoção de arquivos de tipagem redundantes: types/docs.d.ts, types/lucide-react.d.ts, types/unist.d.ts.

6. Scripts utilitários

   • Criação de scripts/check-node.mjs e scripts/check-pnpm.mjs para checar versões mínimas de ambiente antes de instalar.

7. Dependências

   • Bump de versões de @commitlint/cli, @commitlint/config-conventional, prettier-plugin-tailwindcss, entre outras;
   • Adição de better-auth, formik, motion, next-auth, posthog-js, etc.
   • Limpeza de lockfile (pnpm-lock.yaml com 23 adições e 5 deleções correspondentes).

---

⚠️ Observação: após o merge, lembre de rodar pnpm install para atualizar o lockfile e garantir que o ambiente local respeite o Node 18+ e pnpm 9.15.3+.

[vercel]

@matbrgz is attempting to deploy a commit to the H3rmel Team on Vercel.

A member of the Team first needs to authorize it.