Este documento descreve os scripts organizados para o projeto Archbase React v3.
Objetivo: Atualizar a versão de todos os packages de forma unificada.
Uso: npm run version:update 3.0.12
O que faz:
- ✅ Atualiza a versão do projeto principal
- ✅ Atualiza a versão de todos os packages
- ✅ Configura dependências internas como
workspace:*para desenvolvimento - ✅ Configura vite.config.ts para usar versões específicas no build
- ✅ Cria configs do vite automaticamente se não existirem
Objetivo: Compilar todos os packages.
Uso:
npm run build(modo release)npm run build:debug(modo debug)
O que faz:
- ✅ Compila packages em ordem de dependência
- ✅ Gera arquivos JS, CSS e TypeScript declarations
- ✅ Valida se todos os arquivos foram gerados corretamente
- ✅ Exibe estatísticas de tamanho
- ✅ Modo debug adiciona timestamp nas versões
Objetivo: Empacotar packages para distribuição.
Uso:
npm run pack(modo release)npm run pack:debug(modo debug)
O que faz:
- ✅ Atualiza package.json para usar versões específicas das dependências
- ✅ Gera arquivos .tgz de cada package
- ✅ Configura exports corretamente
- ✅ Valida se build existe antes de empacotar
- ✅ Exibe estatísticas de tamanho dos packages
Objetivo: Publicar packages no registry Verdaccio.
Uso: npm run publish:verdaccio
O que faz:
- ✅ Verifica se o registry está configurado para Verdaccio
- ✅ Publica packages em ordem de dependência
- ✅ Usa os arquivos .tgz gerados pelo pack
- ✅ Aguarda entre publicações para evitar conflitos
- ✅ Valida se todos os packages foram publicados
Objetivo: Limpar arquivos temporários e builds.
Uso: npm run clean
O que faz:
- ✅ Remove diretórios dist, node_modules, .turbo
- ✅ Remove arquivos .tgz, .log, .tsbuildinfo
- ✅ Remove backups de package.json
- ✅ Limpa tanto o diretório raiz quanto todos os packages
# 1. Atualizar versão (apenas quando necessário)
npm run version:update 3.0.12
# 2. Desenvolver usando workspace dependencies
# As dependências internas usam workspace:* durante desenvolvimento# 1. Limpar projeto
npm run clean
# 2. Compilar packages
npm run build
# 3. Empacotar packages
npm run pack
# 4. Publicar no Verdaccio
npm run publish:verdaccio# Para builds de debug (com timestamp)
npm run build:debug
npm run pack:debug
npm run publish:verdaccioPara usar o Verdaccio localmente:
# Instalar Verdaccio
npm install -g verdaccio
# Iniciar Verdaccio
verdaccio
# Configurar registry (em outro terminal)
pnpm config set registry http://localhost:4873Todos os scripts estão em /scripts/ e seguem as seguintes convenções:
- ✅ ES Modules: Usando import/export
- ✅ Colorização: Output colorido para melhor UX
- ✅ Validação: Verificações antes de executar operações
- ✅ Backup: Backup automático de arquivos modificados
- ✅ Recovery: Restauração automática em caso de erro
- ✅ Logs: Informações detalhadas sobre o processo
{
"dependencies": {
"@archbase/core": "workspace:*",
"@archbase/data": "workspace:*"
}
}{
"dependencies": {
"@archbase/core": "3.0.11",
"@archbase/data": "3.0.11"
}
}Essa abordagem garante que:
- ✅ Durante desenvolvimento, sempre use a versão local mais recente
- ✅ Durante build/pack, use versões específicas para garantir compatibilidade
- ✅ Vite configs são atualizados automaticamente
- ✅ Não há conflitos entre workspace e versões específicas
Os packages são construídos na seguinte ordem para respeitar dependências:
- core - Utilitários base
- data - Camada de dados
- security - Segurança
- layout - Sistema de layout
- components - Componentes UI
- advanced - Componentes avançados
- admin - Interface admin
- template - Templates
- tools - Ferramentas
- ssr - Server-side rendering
npm run clean
npm run version:update <version>
npm run buildchmod +x scripts/*.jspnpm config set registry http://localhost:4873npm run clean
npm run build:debug # Para mais informações