README

🚀 Engenharia Avançada de Componentes Object Pascal: A Enciclopédia Definitiva (50 Módulos)

Coleção técnica definitiva e orientada à produção para arquitetos de software e desenvolvedores sêniores que desejam dominar a engenharia, design-time, computação gráfica, criptografia, mensageria IoT e integração de inteligência artificial em Free Pascal / Lazarus 3.x+ e Embarcadero Delphi 12 Athens+ (VCL & FMX).

📚 Os Dois Livros da Obra

📘 Livro 1: Engenharia e Arquitetura Avançada de Componentes para Lazarus IDE & LCL

• Ambiente Alvo: Free Pascal 3.2.2+ e Lazarus 3.x+ (Multiplataforma: Windows, Linux e macOS).
• Foco Técnico: LCL (Lazarus Component Library), LCLIntf, IDEIntf (Prop/Component Editors, Wizards), FPC RTL, arquitetura WS (Widgetset Bridge: Win32, GTK2/GTK3, Qt5/Qt6, Cocoa), memória blindada e concorrência multithread.
• Volume Gerado: Livro1_Lazarus_LCL_Completo.pdf (Diagramação Editorial Limpa O'Reilly / Addison-Wesley, fundo branco, blocos de código com realce tipográfico).

📕 Livro 2: Desenvolvimento Moderno de Componentes no Delphi: VCL, FireMonkey e ToolsAPI

• Ambiente Alvo: Embarcadero Delphi 12 Athens+ (12.x+) para Windows (Win32/Win64), Linux e Mobile.
• Foco Técnico: VCL moderna (Per-Monitor v2 High-DPI, VCL Styles), FireMonkey vetorial (Styled Controls, FMX GPU Canvas), ToolsAPI profunda (OTA Interfaces, IDE Notifiers), RTTI estendida, FastMM5 e concorrência paralela.
• Volume Gerado: Livro2_Delphi_Completo.pdf (Diagramação Editorial Limpa O'Reilly / Addison-Wesley).

📑 Catálogo Técnico & Resumo Executivo dos 50 Componentes (Guia Rápido)

• Finalidade: Ficha técnica isolada contendo a tabela comparativa completa dos 50 componentes (Lazarus e Delphi), mapeamento das unidades fonte, finalidades arquiteturais, cenários reais de aplicação e guia rápido dos 50 projetos de exemplo.
• Volume Gerado: Resumo_50_Componentes_Lazarus_Delphi.pdf (Diagramação editorial profissional em A4 Paisagem, otimizado para leitura fluida em tela e impressão de referência técnica).

🧭 Tabela Mestra dos 50 Módulos: Guia de Finalidade e Arquitetura

Abaixo está a relação analítica dos 50 módulos da obra, informando o propósito e para que serve cada componente desenvolvido:

🛠️ Requisitos de Sistema

• Lazarus & Free Pascal:
  • Free Pascal Compiler 3.2.2 ou superior.
  • Lazarus IDE 3.0, 3.2 ou 3.4+.
  • Plataformas: Windows (x86_64), Linux (x86_64, aarch64), macOS.
• Embarcadero Delphi:
  • Delphi 12 Athens (12.0, 12.1 ou 12.2+).
  • Plataformas: Windows 32-bit e 64-bit (VCL & FMX), Linux 64-bit, Android e iOS.
• Ferramental de Compilação Editorial (Opcional):
  • Pandoc 3.0+.
  • Microsoft Edge ou Google Chrome (para geração de PDF headless).

📦 Como Instalar os Componentes nos IDEs

No Lazarus IDE:

1. Abra o Lazarus.
2. Acesse o menu Package $\rightarrow$ Open Package File (.lpk)....
3. Selecione Livro1_Lazarus_LCL/code/packages/laz_eng_components_rt.lpk e clique em Compile.
4. Em seguida, abra Livro1_Lazarus_LCL/code/packages/laz_eng_components_dt.lpk, clique em Compile e depois em Use $\rightarrow$ Install.
5. Confirme a recompilação da IDE. Após reiniciar, a paleta 'Lazarus Engenharia Avancada' estará disponível com todos os componentes registrados.

No Embarcadero Delphi 12:

1. Abra o Delphi 12 Athens.
2. Acesse File $\rightarrow$ Open Project... e selecione Livro2_Delphi_VCL_FMX/code/packages/DlpComponents_RT.dpk.
3. No Project Manager, clique com o botão direito sobre o pacote e selecione Build (para Win32 e Win64).
4. Abra o pacote de design-time Livro2_Delphi_VCL_FMX/code/packages/DlpComponents_DT.dpk, clique com o botão direito e selecione Install.
5. A paleta 'Delphi Engenharia Avancada' será inserida na Tool Palette com todos os componentes prontos para uso em formulários VCL e FMX.

🖥️ Aplicativos de Demonstração Interativa (Demos em Execução)

Para experimentar imediatamente os componentes em tempo de execução sem precisar instalá-los previamente, a obra disponibiliza aplicativos completos de demonstração com interface moderna, abas temáticas e console de auditoria em tempo real:

1. Demonstração Lazarus (FPC / LCL):

• Localização do Projeto: Livro1_Lazarus_LCL/code/demo/LazComponentsDemo.lpi (e espelhado em lazarus/demo/).
• Como executar: Abra o projeto no Lazarus IDE e pressione F9, ou compile via terminal:
  bashCopy

  lazbuild Livro1_Lazarus_LCL/code/demo/LazComponentsDemo.lpi

• O que a demo exibe:
  • Instrumentação & Dashboards: Mostrador analógico TLazAnalogGauge animado a 60 FPS com Double Buffering, medidor de reservatórios TLazIndustrialTankGauge, gráfico vetorial TLazVectorDonutChart, mapa de calor térmico TLazMatrixHeatmap e indicador TLazProductStockIndicator.
  • UI Moderna & Contêineres: Painel sanfonado colapsável TLazAccordionContainer, barra de abas tipadas com badges TLazCustomTabBar, painel High-DPI TLazHighDpiThemedPanel e barra de ações TLazCRUDOperationsBar.
  • Segurança & Criptografia: Cofre em memória TLazCryptoVaultStorage, emissor e validador de tokens TLazJwtSecurityManager, compactador TLazBinaryBlobContainer e validador de chave NF-e TLazFiscalXmlValidator.
  • Diagnósticos & RTTI: Auditoria genealógica TLazTypeInfoInspector, micro-benchmarks em nanossegundos TLazCodeBenchmarkHarness e sonda de telemetria TLazSystemMetricsProbe.

2. Demonstração Delphi (VCL & FMX):

• Localização do Projeto: Livro2_Delphi_VCL_FMX/code/demo/DlpComponentsDemo.dproj (e espelhado em delphi/demo/).
• Como executar: Abra o projeto no Delphi 12 Athens e pressione F9, ou compile via MSBuild:
  bashCopy

  msbuild Livro2_Delphi_VCL_FMX/code/demo/DlpComponentsDemo.dproj /p:Configuration=Release

📂 50 Projetos Independentes de Exemplo (Aprenda Componente por Componente)

Para facilitar o estudo isolado, depuração e experimentação individual de cada recurso sem sobrecarga de um projeto monolítico, a obra conta com 50 pastas de projetos independentes para cada ambiente (Lazarus e Delphi):

• Lazarus / LCL: Disponíveis em Livro1_Lazarus_LCL/code/examples/ (e espelhado em lazarus/examples/).
• Delphi / VCL-FMX: Disponíveis em Livro2_Delphi_VCL_FMX/code/examples/ (e espelhado em delphi/examples/).

Cada subpasta (do 01 ao 50) contém:

1. Projeto compilável independente: Arquivo .lpi + .lpr (Lazarus) ou .dproj + .dpr (Delphi).
2. Formulário de teste dedicado: FormMain.pas e FormMain.lfm / FormMain.dfm com interface funcional focada no componente em questão.
3. Documentação local (README.md): Explicação teórica do componente, tabela de propriedades principais, eventos e instruções diretas de execução.

Exemplo de Uso Rápido:

Para testar isoladamente o mostrador analógico (TLazAnalogGauge):

# Abrir no Lazarus ou compilar via linha de comando:
lazbuild lazarus/examples/09_AnalogGauge/Demo_09_LazAnalogGauge.lpi

Para testar o executor assíncrono multithread (TDlpAsyncTaskRunner no Delphi):

msbuild delphi/examples/21_AsyncTaskRunner/Demo_21_DlpAsyncTaskRunner.dproj

📖 Compilação Automatizada dos Livros em PDF

Para recompilar os dois livros em formato PDF com o tema editorial limpo (padrão de editora internacional com fundo branco e destaque de sintaxe Pascal):

# Execução no PowerShell
powershell -ExecutionPolicy Bypass -File "scripts/compile_books_to_pdf.ps1"

O script utiliza Pandoc + o tema scripts/book_theme.css + o motor headless do Chromium/Edge para compilar e renderizar os dois livros em menos de 15 segundos sem gerar URLs ou rodapés de navegador.

📄 Licença

Este projeto é distribuído sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.