PO-UI Migration Assistant 🚀

Extensão Visual Studio Code que automatiza a migração de código Angular PO-UI de qualquer versão (v1-v18) para a versão 19.

✨ Funcionalidades

🔍 Detecção Automática Universal

• Detecta qualquer versão do PO-UI (v1-v19)
• Identifica versões legadas (v1-v10) com alertas especiais
• Mostra indicadores visuais (CodeLens) em tempo real
• Confiança alta baseada em package.json/package-lock.json

⚡ Migrações Automáticas Completas

• 100+ regras de migração cobrindo 8 anos de PO-UI
• Quick Fixes (Ctrl+.) para aplicar migrações individualmente
• Aplicar todas as migrações de um arquivo de uma vez
• Sistema em fases para migrações progressivas

Era v1-v5 (2017-2018) - Inicial

• po-textfield → po-input
• po-datepicker → po-date
• po-panel → po-container
• po-grid → po-table
• PoFormsModule → PoFieldModule
• 30+ regras específicas

Era v6-v10 (2018-2019) - Intermediária

• po-field-* intermediários → componentes simples
• po-chart-line/bar/pie → po-chart
• po-dialog-* → po-modal
• po-step-wizard → po-stepper
• 40+ regras específicas

Era v11-v19 (2019-2025) - Moderna

• po-field-* → novos componentes (po-input, po-select, etc)
• po-dynamic-page → po-page
• Propriedades [p-*] → HTML nativas
• Eventos (p-change) → (change)
• 30+ regras específicas

📋 Planos de Migração por Era

• v1-v5 → v19: Plano completo com 3-6 meses estimados
• v6-v10 → v19: Plano completo com 2-4 meses estimados
• v11-v19: Planos detalhados por versão
• Estimativa de tempo e complexidade
• Breaking changes documentados
• Comandos npm prontos
• Checklists de validação

🎯 CodeLens Interativo

• Mostra quantidade de migrações necessárias
• Range de versão (ex: v3 → v6 → v11 → v19)
• Links rápidos para análise e migração

📦 Instalação

Via VS Code Marketplace (Recomendado)

1. Abra VS Code
2. Vá em Extensions (Ctrl+Shift+X)
3. Procure por "PO-UI Migration Assistant"
4. Clique em Install

Via arquivo .vsix

1. Baixe o arquivo .vsix da release
2. No VS Code: Ctrl+Shift+P → "Extensions: Install from VSIX..."
3. Selecione o arquivo baixado

🚀 Como Usar

Migração Rápida

1. Abra um arquivo TypeScript ou HTML com código PO-UI antigo

2. CodeLens mostrará quantas migrações são necessárias:

   🔄 3 migrações PO-UI disponíveis | Analisar | Plano | Aplicar
   

3. Clique em "Aplicar" ou use Quick Fix (Ctrl+.) em qualquer linha

Comandos Disponíveis

Abra a Command Palette (Ctrl+Shift+P) e digite:

Exemplo de Migração

Antes:

<po-field-text 
  name="email" 
  [(ngModel)]="email" 
  [p-required]="true"
  (p-change)="onChange()">
</po-field-text>

Depois (aplicado automaticamente):

<po-input 
  name="email" 
  [(ngModel)]="email" 
  required
  (change)="onChange()">
</po-input>

📖 Suporte por Versão

🔧 Requisitos

• Visual Studio Code 1.85.0 ou superior
• Projeto Angular com PO-UI (qualquer versão 11-19)
• Node.js (para executar comandos npm sugeridos)

📝 Notas Importantes

• ⚠️ Sempre faça backup antes de aplicar migrações em massa
• ✅ Teste após cada migração - os planos incluem checklists de validação
• 🔄 Migração incremental - não pule versões (v15→v16→v17→v18→v19)
• 📋 Revise o código - algumas migrações podem precisar ajustes manuais

🐛 Problemas Conhecidos

• Alguns padrões complexos podem precisar revisão manual
• Recomendamos revisar o código após aplicação automática
• Em caso de dúvida, use o plano de migração como guia

📜 Changelog

1.0.0 (Fevereiro 2026)

• 🎉 Lançamento inicial
• ✅ Suporte para v11-v19
• ✅ CodeLens interativo
• ✅ Quick Fixes automáticos
• ✅ Planos de migração detalhados
• ✅ 8 versões suportadas

📄 Licença

MIT

Gostou? ⭐ Deixe uma estrela no GitHub!