@fontdata/ai-harness 4.3.1 → 4.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/README.md +80 -2
  3. package/dist/config/config.js +37 -3
  4. package/dist/delphi/command.js +102 -1
  5. package/dist/delphi/encoding.js +112 -0
  6. package/dist/init.js +8 -2
  7. package/dist/install/perfis.js +14 -0
  8. package/dist/install/plan.js +29 -2
  9. package/dist/install/settings.js +40 -3
  10. package/dist/update/update.js +69 -7
  11. package/package.json +1 -1
  12. package/templates/catalog.json +3 -0
  13. package/templates/perfis/delphi/hooks/encoding.mjs +317 -0
  14. package/templates/perfis/delphi/rules/build-e-verificacao.md +59 -0
  15. package/templates/perfis/delphi/rules/dados/cnpj-alfanumerico-nao-extrair-so-numeros.md +65 -0
  16. package/templates/perfis/delphi/rules/dados/data-hora-sql-nunca-round-trip-textual.md +78 -0
  17. package/templates/perfis/delphi/rules/dados/datestyle-sessao-firedac-postgres.md +60 -0
  18. package/templates/perfis/delphi/rules/dados/ddl-tabela-nova-exige-trigger-de-log.md +68 -0
  19. package/templates/perfis/delphi/rules/dados/divisao-e-conversao-numerica.md +53 -0
  20. package/templates/perfis/delphi/rules/dados/fieldbyname-value-variant-cru-em-aritmetica.md +73 -0
  21. package/templates/perfis/delphi/rules/dados/filtro-condicional-sql-par-add-parambyname.md +72 -0
  22. package/templates/perfis/delphi/rules/dados/firedac.md +51 -0
  23. package/templates/perfis/delphi/rules/dados/macro-firedac-exige-entrada-macrodata.md +96 -0
  24. package/templates/perfis/delphi/rules/dados/sql-qualificacao-colunas.md +36 -0
  25. package/templates/perfis/delphi/rules/dados/tmeminifile-getstrings-nao-limpa-destino.md +89 -0
  26. package/templates/perfis/delphi/rules/encoding-eol.md +130 -0
  27. package/templates/perfis/delphi/rules/linguagem/dataset-nao-se-le-depois-do-laco-eof.md +56 -0
  28. package/templates/perfis/delphi/rules/linguagem/existencia-nunca-se-testa-por-campo-formatado.md +60 -0
  29. package/templates/perfis/delphi/rules/linguagem/float-nunca-comparado-por-igualdade-com-literal.md +55 -0
  30. package/templates/perfis/delphi/rules/linguagem/literal-enum-de-dfm-exige-unit-no-uses.md +84 -0
  31. package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +172 -0
  32. package/templates/perfis/delphi/rules/linguagem/sem-clipboard-debug.md +43 -0
  33. package/templates/perfis/delphi/rules/linguagem/validacao-em-onexit-nao-protege-a-gravacao.md +65 -0
  34. package/templates/perfis/delphi/rules/linguagem/variavel-inline-sai-de-escopo-ao-envolver-bloco.md +69 -0
  35. package/templates/perfis/delphi/rules/telas/foco-decisao-por-canfocus-nao-tabstop.md +40 -0
  36. package/templates/perfis/delphi/rules/telas/form-dinamico-liberar-em-toda-saida.md +80 -0
  37. package/templates/perfis/delphi/rules/telas/heranca-de-form-e-grade-de-selecao.md +58 -0
  38. package/templates/perfis/delphi/rules/threads-e-timers.md +131 -0
  39. package/templates/perfis/delphi/rules/try-finally-e-vazamento.md +109 -0
  40. package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +64 -0
  41. package/templates/perfis/delphi/skills/conhecimento-delphi/references/ATRIBUICAO.md +29 -0
  42. package/templates/perfis/delphi/skills/conhecimento-delphi/references/acbr-nfce-integracao.md +60 -0
  43. package/templates/perfis/delphi/skills/conhecimento-delphi/references/build-via-bat-com-log.md +86 -0
  44. package/templates/perfis/delphi/skills/conhecimento-delphi/references/class-var-vaza-para-campos-de-instancia.md +73 -0
  45. package/templates/perfis/delphi/skills/conhecimento-delphi/references/componentes-designer-vs-runtime.md +47 -0
  46. package/templates/perfis/delphi/skills/conhecimento-delphi/references/console-writeln-sem-flush-nao-loga.md +47 -0
  47. package/templates/perfis/delphi/skills/conhecimento-delphi/references/conversao-numerica-locale.md +47 -0
  48. package/templates/perfis/delphi/skills/conhecimento-delphi/references/delphi13-breaking-changes.md +41 -0
  49. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dpr-uses-project-manager.md +62 -0
  50. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-dcc-debuginformation-nao-booleano.md +78 -0
  51. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-projectguid-valido.md +38 -0
  52. package/templates/perfis/delphi/skills/conhecimento-delphi/references/firedac-registro-drivers.md +94 -0
  53. package/templates/perfis/delphi/skills/conhecimento-delphi/references/horse-gbswagger-rotas-jwt.md +61 -0
  54. package/templates/perfis/delphi/skills/conhecimento-delphi/references/msb6003-command-line-too-long.md +52 -0
  55. package/templates/perfis/delphi/skills/conhecimento-delphi/references/recursos-rcdata.md +67 -0
@@ -0,0 +1,29 @@
1
+ # Atribuição
2
+
3
+ Os artigos desta pasta são adaptações (tradução, reorganização e cortes) de artigos do plugin **delphi-dev**,
4
+ disponível em https://github.com/adrianosantostreina/delphi-dev (commit `e5ed42ad1828b3d55ee87e7c6d2dad935391648e`),
5
+ distribuído sob a licença MIT reproduzida abaixo.
6
+
7
+ ---
8
+
9
+ MIT License
10
+
11
+ Copyright (c) 2026 Adriano Santos
12
+
13
+ Permission is hereby granted, free of charge, to any person obtaining a copy
14
+ of this software and associated documentation files (the "Software"), to deal
15
+ in the Software without restriction, including without limitation the rights
16
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
17
+ copies of the Software, and to permit persons to whom the Software is
18
+ furnished to do so, subject to the following conditions:
19
+
20
+ The above copyright notice and this permission notice shall be included in all
21
+ copies or substantial portions of the Software.
22
+
23
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
24
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
25
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
26
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
27
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
28
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
29
+ SOFTWARE.
@@ -0,0 +1,60 @@
1
+ # ACBr NFC-e: integração e armadilhas
2
+
3
+ Observado com ACBr Trunk2 (DCUs pré-compilados) e Delphi 12, usando `TACBrNFe` no modelo 65. Confira na versão do
4
+ ACBr do projeto antes de aplicar: a superfície muda entre revisões.
5
+
6
+ ## Sintoma e causa
7
+
8
+ | Sintoma | Causa | Correção |
9
+ |---|---|---|
10
+ | `E2003` em enum de NF-e (`moNFCe`, `ve400`, `fpDinheiro`, `csosn102`) | unit errada no `uses` | enums em `pcnConversaoNFe`; aliases legados (`taHomologacao`, `tnSaida`) em `pcnConversao`; tipos SSL em `ACBrDFeSSL`; componente em `ACBrNFe` |
11
+ | SSL configurado com valor errado ou exceção estranha | cast inteiro (`TSSLLib(4)`) com ordinal do DCU diferente do fonte | usar constantes nomeadas |
12
+ | `Configuracoes.Arquivos.PathPDF` não existe | o caminho do PDF pertence ao DANFE | `DANFE.PathPDF`, conferindo `Assigned(DANFE)` (pode ser nil em servidor) |
13
+ | incompatibilidade de tipo em `IdCSC` | `IdCSC` é `string` | `IdCSC := '000001'` |
14
+ | chave com 47 caracteres | `infNFe.ID` vem com o prefixo `NFe` | `Copy(ID, 4, 44)` |
15
+ | `EInOutError: Unable to create directory` | `ForceDirectories` com caminho relativo chama `ForceDirectories('')` | montar caminho absoluto |
16
+ | `ExtractFilePath(ParamStr(0))` vazio | executável chamado sem caminho completo | cair para `GetCurrentDir` |
17
+
18
+ ## Exemplo
19
+
20
+ SSL em simulação (sem transmissão) e em produção:
21
+
22
+ ```pascal
23
+ ACBrNFe.Configuracoes.Geral.SSLLib := libNone;
24
+ ACBrNFe.Configuracoes.Geral.SSLCryptLib := cryNone;
25
+ ACBrNFe.Configuracoes.Geral.SSLHttpLib := httpNone;
26
+ ACBrNFe.Configuracoes.Geral.SSLXmlSignLib := xsNone;
27
+ // produção: libOpenSSL, cryOpenSSL, httpOpenSSL, xsLibXml2
28
+ ```
29
+
30
+ Configuração mínima de NFC-e 4.00:
31
+
32
+ ```pascal
33
+ ACBrNFe.Configuracoes.Geral.ModeloDF := moNFCe;
34
+ ACBrNFe.Configuracoes.Geral.VersaoDF := ve400;
35
+ ACBrNFe.Configuracoes.Geral.VersaoQRCode := veqr200;
36
+ ACBrNFe.Configuracoes.Geral.IdCSC := '000001';
37
+ ACBrNFe.Configuracoes.Geral.CSC := LCsc;
38
+ ACBrNFe.Configuracoes.WebServices.Ambiente := taHomologacao;
39
+ ACBrNFe.Configuracoes.WebServices.UF := LUf;
40
+ ```
41
+
42
+ Chave de 44 dígitos depois de `GerarNFe`:
43
+
44
+ ```pascal
45
+ LChave := Copy(ACBrNFe.NotasFiscais.Items[0].NFe.infNFe.ID, 4, 44);
46
+ ```
47
+
48
+ Pasta de XML com caminho absoluto:
49
+
50
+ ```pascal
51
+ LPastaXml := ExtractFilePath(ParamStr(0));
52
+ if LPastaXml.IsEmpty then
53
+ LPastaXml := GetCurrentDir;
54
+ LPastaXml := IncludeTrailingPathDelimiter(LPastaXml) + 'xml';
55
+ ForceDirectories(LPastaXml);
56
+ ```
57
+
58
+ Forma de pagamento: PIX é `fpPagamentoInstantaneo` (código SEFAZ `17`). Em simulação sem certificado válido,
59
+ `NotasFiscais.Assinar` falha, mas o XML gerado por `GerarNFe` continua íntegro; trate a falha da assinatura como
60
+ aviso só nesse modo, nunca em produção.
@@ -0,0 +1,86 @@
1
+ # Build por `.bat` com log (para quem compila no Windows/VM)
2
+
3
+ **Este artigo é para o desenvolvedor que compila no Windows ou na VM, não para o agente.** O agente não compila: a
4
+ regra de build do perfil vale. O artigo serve para montar ou corrigir o `build.bat` do projeto e para ler o log que o
5
+ desenvolvedor devolver.
6
+
7
+ ## Sintoma
8
+
9
+ - A saída do msbuild/`dcc32` chega cortada, com acento quebrado ou nem chega quando o build é chamado de outro shell
10
+ (MSYS, PowerShell).
11
+ - `cd` antes do `cmd.exe /c` não vale: o `cmd.exe` filho não herda a pasta corrente.
12
+ - O `.bat` diz "BUILD OK", mas o log tem `error E2010`.
13
+ - DUnitX falha com `ECommandLineError: Option [exit] expected a following :value but none was found`.
14
+
15
+ ## Causa
16
+
17
+ - `2>&1` no shell externo nem sempre captura tudo, o compilador escreve em CP1252 e o buffer do PowerShell corta
18
+ linhas longas.
19
+ - `%ERRORLEVEL%` reflete o **último** comando: um `type "%LOG%"` antes do `exit /b %ERRORLEVEL%` devolve o código do
20
+ `type` (0) e mascara a falha.
21
+ - DUnitX exige `chave:valor`; a opção é `--exitbehavior:Continue`, não `--exit`.
22
+
23
+ ## Correção
24
+
25
+ - O `.bat` redireciona toda a saída para um arquivo ao lado dele (`%~dp0build_log.txt`) e guarda o código do msbuild
26
+ numa variável **logo depois** do msbuild.
27
+ - Conferir o resultado pelo conteúdo do log (`error E`, `error F`, `Fatal`), não só pelo código de saída.
28
+ - `build_log.txt` e `test_log.txt` no `.claudeignore` e no `.gitignore`.
29
+ - Pergunte antes de fixar a versão no `.bat` se houver mais de uma pasta em `Studio\<N>.0\`, plataforma diferente de
30
+ Win32/Win64, configurações além de Debug/Release ou Community Edition (outro caminho de instalação).
31
+
32
+ | Pasta | Versão |
33
+ |---|---|
34
+ | `Studio\21.0` | Delphi 10.4 Sydney |
35
+ | `Studio\22.0` | Delphi 11 Alexandria |
36
+ | `Studio\23.0` | Delphi 12 Athens |
37
+ | `Studio\37.0` | Delphi 13 |
38
+
39
+ ## Exemplo
40
+
41
+ ```bat
42
+ @echo off
43
+ setlocal
44
+ set CONFIG=%1
45
+ if "%CONFIG%"=="" set CONFIG=Debug
46
+ set PLAT=%2
47
+ if "%PLAT%"=="" set PLAT=Win32
48
+
49
+ set RSVARS=C:\Program Files (x86)\Embarcadero\Studio\37.0\bin\rsvars.bat
50
+ if not exist "%RSVARS%" (
51
+ echo [build.bat] rsvars.bat nao encontrado em "%RSVARS%"
52
+ exit /b 2
53
+ )
54
+ call "%RSVARS%"
55
+
56
+ set LOG=%~dp0build_log.txt
57
+ msbuild "%~dp0SeuProjeto.dproj" /t:Build /p:Config=%CONFIG% /p:Platform=%PLAT% /nologo /v:minimal /clp:NoSummary > "%LOG%" 2>&1
58
+ set ERR=%ERRORLEVEL%
59
+
60
+ type "%LOG%"
61
+ if %ERR% EQU 0 (echo === BUILD OK %PLAT%\%CONFIG% ===) else (echo === BUILD FALHOU codigo %ERR% ===)
62
+ exit /b %ERR%
63
+ ```
64
+
65
+ Chamada a partir de outro shell, sempre com caminho absoluto entre aspas:
66
+
67
+ ```bash
68
+ cmd.exe /c '"C:\caminho\do\projeto\build.bat" 2>&1'
69
+ ```
70
+
71
+ ```powershell
72
+ & cmd.exe /c '"C:\caminho\do\projeto\build.bat" 2>&1'
73
+ ```
74
+
75
+ ## Erros de compilação que se resolvem com uma unit no `uses`
76
+
77
+ | Identificador | Unit |
78
+ |---|---|
79
+ | `TColor`, `TBitmap`, `TFont`, `TCanvas` | `Vcl.Graphics` (VCL) ou `FMX.Graphics` (FMX) |
80
+ | `TList<>`, `TObjectList<>`, `TDictionary<>` | `System.Generics.Collections` |
81
+ | `Format`, `IntToStr`, `Trim`, `FreeAndNil` | `System.SysUtils` |
82
+ | `IncDay`, `DaysBetween` | `System.DateUtils` |
83
+ | `TStringList`, `TStringStream` | `System.Classes` |
84
+ | `RGB`, `MessageBox`, `LoadCursor` | `Winapi.Windows` |
85
+
86
+ Linha de comando longa demais (`MSB6003`): `msb6003-command-line-too-long.md`.
@@ -0,0 +1,73 @@
1
+ # `class var` contamina os campos seguintes — `E2356 Property accessor must be an instance field or method`
2
+
3
+ Aparece muito em código gerado e em singletons, porque o layout "bonito" (`class var` no topo, linha em branco,
4
+ campos de instância embaixo) é justamente o que produz o erro.
5
+
6
+ ## Sintoma
7
+
8
+ ```
9
+ MinhaUnit.pas(26): error E2356: Property accessor must be an instance field or method
10
+ MinhaUnit.pas(27): error E2356: Property accessor must be an instance field or method
11
+ ```
12
+
13
+ Um erro por **propriedade**, todas apontando para campos visivelmente declarados na classe, com tipo e visibilidade
14
+ corretos.
15
+
16
+ ## Causa
17
+
18
+ `class var` abre uma seção que continua ativa até o próximo especificador de visibilidade (`private`, `public`...) ou
19
+ um `var` explícito. **Linha em branco não fecha a seção.** Os campos declarados depois viram variáveis de classe, e
20
+ propriedade de instância não pode ter variável de classe como acessor.
21
+
22
+ O erro é apontado na linha da propriedade, não na do campo, o que leva a investigação para o lado errado.
23
+
24
+ ```pascal
25
+ type
26
+ TApiConfig = class
27
+ strict private
28
+ class var FInstancia: TApiConfig;
29
+
30
+ FPorta: Integer; // ainda é class var
31
+ FJwtSecret: string; // ainda é class var
32
+ public
33
+ class function Instancia: TApiConfig;
34
+ property Porta: Integer read FPorta; // E2356
35
+ property JwtSecret: string read FJwtSecret; // E2356
36
+ end;
37
+ ```
38
+
39
+ ## Correção
40
+
41
+ Nunca deixar `class var` e campos de instância na mesma seção. Três formas, em ordem de preferência:
42
+
43
+ 1. `var` explícito para voltar aos campos de instância;
44
+ 2. declarar o `class var` por último na seção;
45
+ 3. isolar o `class var` numa seção de visibilidade própria.
46
+
47
+ ## Exemplo
48
+
49
+ ```pascal
50
+ // 1. var explícito
51
+ strict private
52
+ class var FInstancia: TApiConfig;
53
+ var
54
+ FPorta: Integer;
55
+ FJwtSecret: string;
56
+
57
+ // 2. class var por último
58
+ strict private
59
+ FPorta: Integer;
60
+ FJwtSecret: string;
61
+ class var FInstancia: TApiConfig;
62
+ public
63
+
64
+ // 3. seção própria
65
+ strict private
66
+ FPorta: Integer;
67
+ FJwtSecret: string;
68
+ strict private
69
+ class var FInstancia: TApiConfig;
70
+ ```
71
+
72
+ Para achar o padrão antes de compilar: `grep -n -A6 "class var" *.pas` e verificar se há campo declarado depois do
73
+ `class var` sem `var` ou novo especificador de visibilidade no meio.
@@ -0,0 +1,47 @@
1
+ # Controle fixo criado em runtime não aparece no Designer
2
+
3
+ ## Sintoma
4
+
5
+ Um botão, label ou painel existe na tela em execução, mas não aparece no Form Designer nem na lista de componentes do
6
+ form. Quem for ajustar o layout pelo IDE não o encontra, e o visual fica diferente dos controles vizinhos.
7
+
8
+ ## Causa
9
+
10
+ O controle foi criado em código (`TSpeedButton.Create(Self)` no `FormCreate`) em vez de declarado no `.dfm`/`.fmx`.
11
+ Só o que está no arquivo de form é visível no Designer, declarado na classe pelo IDE e tem eventos ligados por ele.
12
+
13
+ ## Correção
14
+
15
+ - Controles **fixos** da tela: declarar no `.dfm`/`.fmx` e referenciar no `.pas`, seguindo o padrão visual dos
16
+ controles já existentes na mesma tela.
17
+ - Criação dinâmica só quando a **quantidade** é desconhecida em tempo de design: linhas geradas a partir de dados,
18
+ botões montados de uma lista, controles que dependem de configuração carregada em runtime.
19
+
20
+ ## Exemplo
21
+
22
+ Errado:
23
+
24
+ ```pascal
25
+ procedure TFrmCategorias.FormCreate(Sender: TObject);
26
+ begin
27
+ FBtnNova := TSpeedButton.Create(Self);
28
+ FBtnNova.Parent := pnlBotoes;
29
+ FBtnNova.Caption := 'Nova';
30
+ FBtnNova.OnClick := BtnNovaClick;
31
+ end;
32
+ ```
33
+
34
+ Certo:
35
+
36
+ ```
37
+ object btnNova: TSpeedButton
38
+ Caption = 'Nova'
39
+ OnClick = btnNovaClick
40
+ end
41
+ ```
42
+
43
+ ```pascal
44
+ published
45
+ btnNova: TSpeedButton;
46
+ procedure btnNovaClick(Sender: TObject);
47
+ ```
@@ -0,0 +1,47 @@
1
+ # App console: `Writeln` sem `Flush` não aparece em log redirecionado
2
+
3
+ Vale para qualquer `{$APPTYPE CONSOLE}`: servidor Horse, worker, serviço, ferramenta de linha de comando.
4
+
5
+ ## Sintoma
6
+
7
+ A aplicação está viva e responde normalmente, mas o arquivo que captura a saída fica com **0 bytes**:
8
+
9
+ ```powershell
10
+ Start-Process .\MinhaApi.exe -RedirectStandardOutput out.txt -RedirectStandardError err.txt
11
+ # ... a API responde HTTP 200 ...
12
+ Get-Item out.txt # Length: 0
13
+ ```
14
+
15
+ No console interativo a mesma linha aparece, o que dá a impressão de que só o redirecionamento está quebrado. Se o
16
+ processo é encerrado à força (`taskkill /F`, `Stop-Process -Force`, Ctrl+C sem tratamento), toda a saída some,
17
+ inclusive mensagens de erro que explicariam a falha.
18
+
19
+ ## Causa
20
+
21
+ Com `Output` ligado a um console, cada `Writeln` sai na hora. Redirecionado para arquivo ou pipe, o runtime passa a
22
+ usar buffer cheio (alguns KB), descarregado só quando enche, quando a aplicação termina normalmente ou quando alguém
23
+ chama `Flush(Output)`. Um servidor que fica no ar não cumpre nenhuma das condições; um processo morto descarta o
24
+ buffer.
25
+
26
+ ## Correção
27
+
28
+ - `Flush(Output)` depois de cada bloco que precisa aparecer imediatamente.
29
+ - Para log de servidor, não depender do stdout: gravar em arquivo próprio, com append e descarga a cada linha.
30
+ - Antes de usar o log de uma aplicação para diagnóstico ou automação de teste, confirmar que ele **existe e tem
31
+ conteúdo**; sem log, uma aplicação console não deixa rastro nenhum, e num servidor Horse o único sinal de erro
32
+ passa a ser o corpo do HTTP 500.
33
+
34
+ ## Exemplo
35
+
36
+ ```pascal
37
+ THorse.Listen(LPorta,
38
+ procedure
39
+ begin
40
+ Writeln(Format('API rodando na porta %d', [LPorta]));
41
+ Writeln('Swagger UI: http://localhost:' + LPorta.ToString + '/swagger/doc/html');
42
+ Flush(Output); // sem isto, nada aparece em saída redirecionada
43
+ end);
44
+ ```
45
+
46
+ Diagnóstico rápido: processo vivo (`Get-Process -Name MinhaApi`) e arquivo de captura com 0 bytes indicam buffer
47
+ retido, não código que deixou de executar.
@@ -0,0 +1,47 @@
1
+ # Conversão numérica e o separador decimal do locale
2
+
3
+ ## Sintoma
4
+
5
+ Valor preenchido "some": `StrToCurrDef`/`StrToFloatDef` devolvem o padrão (0) sem exceção, e a validação "informe o
6
+ valor" dispara com o campo preenchido. Com `StrToFloat`/`StrToCurr`, aparece `'37.55' is not a valid floating point
7
+ value` só em algumas máquinas, ou `'1.234,56' is not a valid floating point value` em todas. O mesmo código funciona
8
+ no computador do desenvolvedor e falha no do cliente (ou o contrário).
9
+
10
+ ## Causa
11
+
12
+ - `StrToFloat`, `StrToCurr`, as versões `...Def` e `Try...` usam por padrão o `FormatSettings` global, que vem da
13
+ configuração regional da máquina. Em pt-BR o decimal é vírgula. Trocar `,` por `.` "para virar decimal" faz a
14
+ conversão falhar porque o ponto não é o separador decimal configurado: o texto deixa de ser um número válido.
15
+ - Essas funções **não aceitam separador de milhar**. `ThousandSeparator` só é usado na formatação (`FormatFloat`,
16
+ `Format` com `%n`); defini-lo como `'.'` não faz `'1.234,56'` converter.
17
+ - `FloatToStr`/`FormatFloat` também dependem do locale na volta.
18
+
19
+ ## Correção
20
+
21
+ Converter a string **no formato em que ela está**, com um `TFormatSettings` explícito (unit `System.SysUtils`;
22
+ sobrecarga disponível desde o XE). O `TFormatSettings` descreve a **entrada**, não a saída desejada:
23
+
24
+ - texto digitado na tela em formato brasileiro: `DecimalSeparator := ','`; se o texto puder trazer milhar
25
+ (`1.234,56`), remover os pontos **antes** de converter;
26
+ - texto vindo de arquivo, API ou SQL com ponto decimal e sem milhar: `TFormatSettings.Invariant`.
27
+
28
+ ## Exemplo
29
+
30
+ ```pascal
31
+ // errado em máquina pt-BR
32
+ LTexto := Edit.Text.Replace(',', '.');
33
+ Result := StrToCurrDef(LTexto, 0);
34
+
35
+ // certo: formato brasileiro explícito, milhar removido antes da conversão
36
+ var
37
+ LFormato: TFormatSettings;
38
+ begin
39
+ LFormato := TFormatSettings.Create;
40
+ LFormato.DecimalSeparator := ',';
41
+ Result := StrToCurrDef(Edit.Text.Trim.Replace('.', ''), 0, LFormato);
42
+ end;
43
+
44
+ // texto com ponto decimal (JSON, arquivo, retorno de API)
45
+ LValor := StrToFloat(LJsonValor, TFormatSettings.Invariant);
46
+ LTexto := FloatToStr(LValor, TFormatSettings.Invariant);
47
+ ```
@@ -0,0 +1,41 @@
1
+ # Delphi 13 (RAD Studio 37.0): quebras de API na migração
2
+
3
+ Quebras que aparecem ao compilar no Delphi 13 código que vinha do 12.x ou anterior. A lista cobre o que foi
4
+ confirmado; quebra nova deve ser conferida no fonte da RTL/FMX instalada (`$(BDS)\source`).
5
+
6
+ ## `TAniCalculations.Interval` removida (FMX)
7
+
8
+ ### Sintoma
9
+
10
+ ```
11
+ [DCC Error] E2003 Undeclared identifier: 'Interval'
12
+ ```
13
+
14
+ numa linha como:
15
+
16
+ ```pascal
17
+ ScrollBox.AniCalculations.Interval := 100;
18
+ ```
19
+
20
+ ### Causa
21
+
22
+ Até o 12.x, `FMX.InertialMovement` expunha `Interval` (ms do timer que recalculava a inércia). No 13, a engine passou
23
+ a usar `TDisplayLinkService`, sincronizado com a taxa de atualização da tela; o campo virou privado e a propriedade
24
+ pública foi removida, sem substituta.
25
+
26
+ ### Correção
27
+
28
+ Remover a linha: a engine ajusta o intervalo sozinha.
29
+
30
+ ### Exemplo
31
+
32
+ ```pascal
33
+ // antes
34
+ vert.AniCalculations.Animation := True;
35
+ vert.AniCalculations.Interval := 100;
36
+
37
+ // depois
38
+ vert.AniCalculations.Animation := True;
39
+ ```
40
+
41
+ Para achar todas as ocorrências antes de compilar: `grep -rn "AniCalculations\.Interval" .`
@@ -0,0 +1,62 @@
1
+ # Unit fora do `uses` do `.dpr` não aparece no Project Manager
2
+
3
+ ## Sintoma
4
+
5
+ - A unit compila, mas não aparece no Project Manager do IDE.
6
+ - O Designer não abre o form/frame e diz "No form found".
7
+ - O IDE reclama de duplicidade ao abrir o `.dpr`.
8
+
9
+ Acontece quando os arquivos são criados fora do IDE (editor externo, script, agente).
10
+
11
+ ## Causa
12
+
13
+ O Project Manager lê a seção `uses` do `.dpr`, não o `.dproj`. Uma `<DCCReference>` só no `.dproj` faz o compilador
14
+ achar a unit, mas não a expõe no IDE. O sufixo entre chaves (`{NomeClasse}`, `{NomeClasse: TFrame}`) diz ao IDE qual
15
+ é a classe principal e o tipo base; sem ele o Designer não abre. Duplicidade vem de `.dpr` e `.dproj` apontando a
16
+ mesma unit com caminhos ligeiramente diferentes (`/` contra `\`, caixa diferente).
17
+
18
+ ## Correção
19
+
20
+ Toda unit nova entra nos **dois** arquivos, com o mesmo caminho, usando `\` e a mesma caixa:
21
+
22
+ | Tipo | Cláusula no `.dpr` |
23
+ |---|---|
24
+ | Unit de código | `Nome in 'pasta\Nome.pas',` |
25
+ | Form | `NomeUnit in 'pasta\NomeUnit.pas' {NomeForm},` |
26
+ | Frame | `NomeUnit in 'pasta\NomeUnit.pas' {NomeFrame: TFrame},` |
27
+ | DataModule | `NomeUnit in 'pasta\NomeUnit.pas' {NomeDM: TDataModule},` |
28
+
29
+ Pelo IDE (**File → New** ou **Project → Add to Project**) os dois arquivos são atualizados juntos.
30
+
31
+ ## Exemplo
32
+
33
+ ```pascal
34
+ program MeuApp;
35
+
36
+ uses
37
+ Vcl.Forms,
38
+ AppConfig in 'src\infra\AppConfig.pas',
39
+ Repository.Produto in 'src\repositories\Repository.Produto.pas',
40
+ FrameHome in 'src\frames\FrameHome.pas' {FrameHome: TFrame},
41
+ DMConexao in 'src\dados\DMConexao.pas' {DmConexao: TDataModule},
42
+ FormMain in 'src\forms\FormMain.pas' {FrmMain};
43
+
44
+ {$R *.res}
45
+
46
+ begin
47
+ Application.Initialize;
48
+ Application.CreateForm(TFrmMain, FrmMain);
49
+ Application.Run;
50
+ end.
51
+ ```
52
+
53
+ ```xml
54
+ <DCCReference Include="src\infra\AppConfig.pas"/>
55
+ <DCCReference Include="src\frames\FrameHome.pas">
56
+ <Form>FrameHome</Form>
57
+ <FormType>dfm</FormType>
58
+ <DesignClass>TFrame</DesignClass>
59
+ </DCCReference>
60
+ ```
61
+
62
+ Em FMX, `<FormType>` é `fmx`.
@@ -0,0 +1,78 @@
1
+ # `DCC_DebugInformation` não é booleano — `F1026 File not found: 'true.dpr'`
2
+
3
+ Atinge `.dproj` escrito ou gerado fora do IDE (agente, script, template), onde é natural pôr `true`/`false` em toda
4
+ propriedade que "parece booleana".
5
+
6
+ ## Sintoma
7
+
8
+ ```
9
+ CodeGear.Delphi.Targets(431,5): error F1026: File not found: 'true.dpr'
10
+ ```
11
+
12
+ O projeto se chama `MinhaApi.dpr`; `true.dpr` não existe e a palavra `true` não aparece no `.dpr`. Nenhuma linha de
13
+ código chega a ser compilada: o build morre antes. Confirmado no RAD Studio 37.0 (Delphi 13); o mecanismo vale para
14
+ qualquer versão moderna.
15
+
16
+ ## Causa
17
+
18
+ O `.dproj` tem:
19
+
20
+ ```xml
21
+ <DCC_DebugInformation>true</DCC_DebugInformation>
22
+ ```
23
+
24
+ `DCC_DebugInformation` é um **enum numérico** (`0` = informação de debug completa, `2` = nenhuma). O
25
+ `CodeGear.Delphi.Targets` repassa o valor cru à task do compilador (`DebugInformation="$(DCC_DebugInformation)"`), sem
26
+ validar. O valor desconhecido vira um token solto na linha de comando:
27
+
28
+ ```
29
+ dcc32.exe -$O- -$W+ true --no-config -B -Q ...
30
+ ```
31
+
32
+ O `dcc32` entende esse `true` como o arquivo-fonte a compilar, acrescenta `.dpr` e procura `true.dpr`.
33
+
34
+ ## Correção
35
+
36
+ Usar o valor numérico, como o IDE grava:
37
+
38
+ ```xml
39
+ <PropertyGroup Condition="'$(Cfg_1)'!=''"> <!-- Debug -->
40
+ <DCC_Define>DEBUG;$(DCC_Define)</DCC_Define>
41
+ <DCC_Optimize>false</DCC_Optimize>
42
+ <DCC_GenerateStackFrames>true</DCC_GenerateStackFrames>
43
+ <DCC_DebugInformation>0</DCC_DebugInformation>
44
+ <DCC_DebugInfoInExe>true</DCC_DebugInfoInExe>
45
+ </PropertyGroup>
46
+
47
+ <PropertyGroup Condition="'$(Cfg_2)'!=''"> <!-- Release -->
48
+ <DCC_Define>RELEASE;$(DCC_Define)</DCC_Define>
49
+ <DCC_Optimize>true</DCC_Optimize>
50
+ <DCC_GenerateStackFrames>false</DCC_GenerateStackFrames>
51
+ <DCC_DebugInformation>2</DCC_DebugInformation>
52
+ </PropertyGroup>
53
+ ```
54
+
55
+ | Propriedade | Tipo | Valores |
56
+ |---|---|---|
57
+ | `DCC_Optimize` | booleana | `true` / `false` |
58
+ | `DCC_GenerateStackFrames` | booleana | `true` / `false` |
59
+ | `DCC_DebugInfoInExe` | booleana | `true` / `false` |
60
+ | **`DCC_DebugInformation`** | **enum numérico** | `0` (debug) / `2` (nenhuma) |
61
+
62
+ **Não invente o tipo de uma propriedade do `.dproj`.** A referência confiável é um `.dproj` salvo pelo próprio IDE
63
+ na mesma versão do RAD Studio: crie um projeto vazio e compare.
64
+
65
+ ## Exemplo de diagnóstico
66
+
67
+ Quando o erro citar um arquivo inexistente cujo nome parece um **valor** (`true.dpr`, `false.dpr`, `0.dpr`), quem
68
+ compila no Windows pode gerar o log com verbosidade diagnóstica e procurar a linha do compilador:
69
+
70
+ ```
71
+ msbuild Projeto.dproj /t:Build /v:diag > diag.txt
72
+ findstr /C:"dcc32.exe" diag.txt
73
+ ```
74
+
75
+ O token solto aparece na linha; a propriedade que o produziu é a do switch imediatamente anterior. Sem acesso ao
76
+ build, procure no `.dproj` por propriedades `DCC_*` com `true`/`false` e confira o tipo na tabela acima.
77
+
78
+ Outra armadilha de `.dproj` escrito à mão: `dproj-projectguid-valido.md`.
@@ -0,0 +1,38 @@
1
+ # `ProjectGuid` precisa ser um GUID hexadecimal válido
2
+
3
+ Atinge `.dproj` criado fora do IDE (agente ou script gerando o projeto).
4
+
5
+ ## Sintoma
6
+
7
+ O projeto compila pela linha de comando, mas o RAD Studio se recusa a abri-lo:
8
+
9
+ ```
10
+ Unable to load project ...\DemoChat.dproj
11
+ '{A1B2C3D4-0002-4ABC-9DEF-0001DEMOCHAT}' is not a valid GUID value
12
+ ```
13
+
14
+ ## Causa
15
+
16
+ O `<ProjectGuid>` recebeu um marcador "legível" com letras que não são hexadecimais (`M`, `H`, `T`, `O`...). Um GUID
17
+ válido tem 32 dígitos hexadecimais (`0-9`, `A-F`) no formato `{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}`.
18
+
19
+ O msbuild e o `dcc32` **ignoram** o campo; só o IDE o valida. Por isso um build verde pela linha de comando não
20
+ garante que o projeto abre no IDE.
21
+
22
+ ## Correção
23
+
24
+ Gerar um GUID de verdade:
25
+
26
+ - PowerShell: `[guid]::NewGuid().ToString().ToUpper()`
27
+ - Delphi: `CreateGUID` + `GUIDToString`
28
+ - macOS/Linux: `uuidgen`
29
+
30
+ ## Exemplo
31
+
32
+ ```xml
33
+ <ProjectGuid>{C2DA9E20-AA07-4515-999D-4713D17196BB}</ProjectGuid>
34
+ ```
35
+
36
+ Ao abrir um `.dproj` mínimo feito à mão, o RAD Studio costuma reescrevê-lo por inteiro (grupos de plataforma,
37
+ VerInfo etc.). É esperado: confira que os blocos críticos (por exemplo `DCC_UnitSearchPath` e defines) sobreviveram
38
+ e versione a versão gravada pelo IDE.