@fontdata/ai-harness 4.3.1 → 4.5.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 (257) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/README.md +154 -3
  3. package/dist/cli.js +1 -0
  4. package/dist/config/config.js +45 -3
  5. package/dist/delphi/catalogo.js +299 -0
  6. package/dist/delphi/classificar.js +21 -0
  7. package/dist/delphi/command.js +144 -2
  8. package/dist/delphi/encoding.js +112 -0
  9. package/dist/doctor/checks.js +19 -1
  10. package/dist/init.js +16 -2
  11. package/dist/install/perfis.js +21 -0
  12. package/dist/install/plan.js +29 -2
  13. package/dist/install/settings.js +40 -3
  14. package/dist/mapa/extratores/pascal.js +1 -1
  15. package/dist/update/update.js +126 -7
  16. package/package.json +1 -1
  17. package/templates/CLAUDE.md +2 -1
  18. package/templates/catalog.json +11 -3
  19. package/templates/hooks/comentarios/check.mjs +62 -5
  20. package/templates/hooks/hooks.json +2 -1
  21. package/templates/hooks/lib/config.mjs +1 -0
  22. package/templates/hooks/padroes-proibidos.mjs +68 -0
  23. package/templates/perfis/delphi/hooks/encoding.mjs +317 -0
  24. package/templates/perfis/delphi/rules/build-e-verificacao.md +59 -0
  25. package/templates/perfis/delphi/rules/dados/cnpj-alfanumerico-nao-extrair-so-numeros.md +65 -0
  26. package/templates/perfis/delphi/rules/dados/data-hora-sql-nunca-round-trip-textual.md +78 -0
  27. package/templates/perfis/delphi/rules/dados/datestyle-sessao-firedac-postgres.md +60 -0
  28. package/templates/perfis/delphi/rules/dados/ddl-tabela-nova-exige-trigger-de-log.md +68 -0
  29. package/templates/perfis/delphi/rules/dados/divisao-e-conversao-numerica.md +53 -0
  30. package/templates/perfis/delphi/rules/dados/fieldbyname-value-variant-cru-em-aritmetica.md +73 -0
  31. package/templates/perfis/delphi/rules/dados/filtro-condicional-sql-par-add-parambyname.md +72 -0
  32. package/templates/perfis/delphi/rules/dados/firedac.md +51 -0
  33. package/templates/perfis/delphi/rules/dados/macro-firedac-exige-entrada-macrodata.md +96 -0
  34. package/templates/perfis/delphi/rules/dados/sql-qualificacao-colunas.md +36 -0
  35. package/templates/perfis/delphi/rules/dados/tmeminifile-getstrings-nao-limpa-destino.md +89 -0
  36. package/templates/perfis/delphi/rules/encoding-eol.md +130 -0
  37. package/templates/perfis/delphi/rules/linguagem/dataset-nao-se-le-depois-do-laco-eof.md +56 -0
  38. package/templates/perfis/delphi/rules/linguagem/existencia-nunca-se-testa-por-campo-formatado.md +60 -0
  39. package/templates/perfis/delphi/rules/linguagem/float-nunca-comparado-por-igualdade-com-literal.md +55 -0
  40. package/templates/perfis/delphi/rules/linguagem/literal-enum-de-dfm-exige-unit-no-uses.md +84 -0
  41. package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +172 -0
  42. package/templates/perfis/delphi/rules/linguagem/sem-clipboard-debug.md +43 -0
  43. package/templates/perfis/delphi/rules/linguagem/validacao-em-onexit-nao-protege-a-gravacao.md +65 -0
  44. package/templates/perfis/delphi/rules/linguagem/variavel-inline-sai-de-escopo-ao-envolver-bloco.md +69 -0
  45. package/templates/perfis/delphi/rules/telas/foco-decisao-por-canfocus-nao-tabstop.md +40 -0
  46. package/templates/perfis/delphi/rules/telas/form-dinamico-liberar-em-toda-saida.md +80 -0
  47. package/templates/perfis/delphi/rules/telas/heranca-de-form-e-grade-de-selecao.md +58 -0
  48. package/templates/perfis/delphi/rules/threads-e-timers.md +131 -0
  49. package/templates/perfis/delphi/rules/try-finally-e-vazamento.md +109 -0
  50. package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +70 -0
  51. package/templates/perfis/delphi/skills/conhecimento-delphi/references/ATRIBUICAO.md +29 -0
  52. package/templates/perfis/delphi/skills/conhecimento-delphi/references/acbr-nfce-integracao.md +60 -0
  53. package/templates/perfis/delphi/skills/conhecimento-delphi/references/build-via-bat-com-log.md +86 -0
  54. package/templates/perfis/delphi/skills/conhecimento-delphi/references/class-var-vaza-para-campos-de-instancia.md +73 -0
  55. package/templates/perfis/delphi/skills/conhecimento-delphi/references/componentes-designer-vs-runtime.md +47 -0
  56. package/templates/perfis/delphi/skills/conhecimento-delphi/references/console-writeln-sem-flush-nao-loga.md +47 -0
  57. package/templates/perfis/delphi/skills/conhecimento-delphi/references/conversao-numerica-locale.md +47 -0
  58. package/templates/perfis/delphi/skills/conhecimento-delphi/references/delphi13-breaking-changes.md +41 -0
  59. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dpr-uses-project-manager.md +62 -0
  60. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-dcc-debuginformation-nao-booleano.md +78 -0
  61. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-projectguid-valido.md +38 -0
  62. package/templates/perfis/delphi/skills/conhecimento-delphi/references/firedac-registro-drivers.md +94 -0
  63. package/templates/perfis/delphi/skills/conhecimento-delphi/references/horse-gbswagger-rotas-jwt.md +61 -0
  64. package/templates/perfis/delphi/skills/conhecimento-delphi/references/msb6003-command-line-too-long.md +52 -0
  65. package/templates/perfis/delphi/skills/conhecimento-delphi/references/recursos-rcdata.md +67 -0
  66. package/templates/perfis/delphi-fiscal/rules/campo-novo-acbr-preenchimento-explicito.md +61 -0
  67. package/templates/perfis/delphi-fiscal/rules/retorno-de-evento-nfe-pelo-cstat.md +51 -0
  68. package/templates/perfis/delphi-fiscal/rules/sucesso-de-webservice-fiscal-nao-prova-documento.md +100 -0
  69. package/templates/perfis/delphi-fiscal/rules/total-tributo-acbr-soma-itens.md +63 -0
  70. package/templates/perfis/delphi-fiscal/skills/diagnosticar-rejeicao-nfse/SKILL.md +155 -0
  71. package/templates/perfis/delphi-fiscal/skills/patch-acbr/SKILL.md +143 -0
  72. package/templates/skills/auditar-performance/SKILL.md +9 -0
  73. package/templates/skills/auditar-performance/references/pontos-quentes.md +8 -0
  74. package/templates/skills/auditar-seguranca/SKILL.md +55 -14
  75. package/templates/skills/auditar-seguranca/templates/relatorios/TECNICO.md +5 -0
  76. package/templates/skills/auditar-ui/SKILL.md +18 -3
  77. package/templates/skills/auditar-ui/references/ATRIBUICAO.md +44 -0
  78. package/templates/skills/auditar-ui/references/web-interface-guidelines.md +191 -0
  79. package/templates/skills/harness/references/validar-ideia.md +7 -6
  80. package/templates/skills/security-audit/AI-AND-LLM.md +83 -0
  81. package/templates/skills/security-audit/ATTACK-CLASSES.md +130 -0
  82. package/templates/skills/security-audit/CLIENT-SIDE.md +83 -0
  83. package/templates/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
  84. package/templates/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
  85. package/templates/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
  86. package/templates/skills/security-audit/HUNTING.md +251 -0
  87. package/templates/skills/security-audit/LICENSE +21 -0
  88. package/templates/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
  89. package/templates/skills/security-audit/ORIGEM.md +51 -0
  90. package/templates/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
  91. package/templates/skills/security-audit/RECONNAISSANCE.md +156 -0
  92. package/templates/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
  93. package/templates/skills/security-audit/SKILL.md +192 -0
  94. package/templates/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
  95. package/templates/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
  96. package/templates/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
  97. package/templates/skills/security-audit/report-schema.json +461 -0
  98. package/templates/skills/security-audit/validate-coverage-ledger.cjs +872 -0
  99. package/templates/skills/security-audit/validate-findings.cjs +773 -0
  100. package/templates/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
  101. package/templates/skills/supabase-postgres-best-practices/LICENSE +21 -0
  102. package/templates/skills/supabase-postgres-best-practices/ORIGEM.md +43 -0
  103. package/templates/skills/supabase-postgres-best-practices/SKILL.md +64 -0
  104. package/templates/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
  105. package/templates/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
  106. package/templates/skills/supabase-postgres-best-practices/references/_template.md +34 -0
  107. package/templates/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
  108. package/templates/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
  109. package/templates/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
  110. package/templates/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
  111. package/templates/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
  112. package/templates/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
  113. package/templates/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
  114. package/templates/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
  115. package/templates/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
  116. package/templates/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
  117. package/templates/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
  118. package/templates/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
  119. package/templates/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
  120. package/templates/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
  121. package/templates/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
  122. package/templates/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
  123. package/templates/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
  124. package/templates/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
  125. package/templates/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
  126. package/templates/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
  127. package/templates/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
  128. package/templates/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
  129. package/templates/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
  130. package/templates/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
  131. package/templates/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
  132. package/templates/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
  133. package/templates/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
  134. package/templates/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
  135. package/templates/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
  136. package/templates/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
  137. package/templates/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
  138. package/templates/skills/vercel-react-best-practices/AGENTS.md +3810 -0
  139. package/templates/skills/vercel-react-best-practices/ORIGEM.md +39 -0
  140. package/templates/skills/vercel-react-best-practices/README.md +123 -0
  141. package/templates/skills/vercel-react-best-practices/SKILL.md +149 -0
  142. package/templates/skills/vercel-react-best-practices/metadata.json +15 -0
  143. package/templates/skills/vercel-react-best-practices/rules/_sections.md +46 -0
  144. package/templates/skills/vercel-react-best-practices/rules/_template.md +28 -0
  145. package/templates/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  146. package/templates/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  147. package/templates/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  148. package/templates/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  149. package/templates/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  150. package/templates/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  151. package/templates/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  152. package/templates/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  153. package/templates/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
  154. package/templates/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  155. package/templates/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  156. package/templates/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  157. package/templates/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  158. package/templates/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  159. package/templates/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  160. package/templates/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  161. package/templates/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  162. package/templates/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  163. package/templates/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  164. package/templates/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  165. package/templates/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  166. package/templates/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  167. package/templates/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  168. package/templates/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  169. package/templates/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  170. package/templates/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  171. package/templates/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  172. package/templates/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  173. package/templates/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  174. package/templates/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  175. package/templates/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  176. package/templates/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  177. package/templates/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  178. package/templates/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  179. package/templates/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  180. package/templates/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  181. package/templates/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  182. package/templates/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  183. package/templates/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  184. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  185. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  186. package/templates/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  187. package/templates/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  188. package/templates/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  189. package/templates/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  190. package/templates/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  191. package/templates/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  192. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  193. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  194. package/templates/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  195. package/templates/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  196. package/templates/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  197. package/templates/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  198. package/templates/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  199. package/templates/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  200. package/templates/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  201. package/templates/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  202. package/templates/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  203. package/templates/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  204. package/templates/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  205. package/templates/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  206. package/templates/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  207. package/templates/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  208. package/templates/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  209. package/templates/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  210. package/templates/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  211. package/templates/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  212. package/templates/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  213. package/templates/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  214. package/templates/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
  215. package/templates/skills/vercel-react-native-skills/AGENTS.md +2897 -0
  216. package/templates/skills/vercel-react-native-skills/ORIGEM.md +39 -0
  217. package/templates/skills/vercel-react-native-skills/README.md +165 -0
  218. package/templates/skills/vercel-react-native-skills/SKILL.md +121 -0
  219. package/templates/skills/vercel-react-native-skills/metadata.json +16 -0
  220. package/templates/skills/vercel-react-native-skills/rules/_sections.md +86 -0
  221. package/templates/skills/vercel-react-native-skills/rules/_template.md +28 -0
  222. package/templates/skills/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
  223. package/templates/skills/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
  224. package/templates/skills/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
  225. package/templates/skills/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
  226. package/templates/skills/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
  227. package/templates/skills/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
  228. package/templates/skills/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
  229. package/templates/skills/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
  230. package/templates/skills/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
  231. package/templates/skills/vercel-react-native-skills/rules/list-performance-images.md +53 -0
  232. package/templates/skills/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
  233. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
  234. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
  235. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
  236. package/templates/skills/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
  237. package/templates/skills/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
  238. package/templates/skills/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
  239. package/templates/skills/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
  240. package/templates/skills/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
  241. package/templates/skills/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
  242. package/templates/skills/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
  243. package/templates/skills/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
  244. package/templates/skills/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
  245. package/templates/skills/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
  246. package/templates/skills/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
  247. package/templates/skills/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
  248. package/templates/skills/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
  249. package/templates/skills/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
  250. package/templates/skills/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
  251. package/templates/skills/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
  252. package/templates/skills/vercel-react-native-skills/rules/ui-menus.md +174 -0
  253. package/templates/skills/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
  254. package/templates/skills/vercel-react-native-skills/rules/ui-pressable.md +61 -0
  255. package/templates/skills/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
  256. package/templates/skills/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
  257. package/templates/skills/vercel-react-native-skills/rules/ui-styling.md +87 -0
@@ -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.
@@ -0,0 +1,94 @@
1
+ # Driver FireDAC não encontrado — "Object factory for class ... is missing"
2
+
3
+ ## Sintoma
4
+
5
+ Na primeira conexão ou consulta, em runtime:
6
+
7
+ ```
8
+ Object factory for class {3E9B315B-F456-4175-A864-B2573C4A2201} is missing.
9
+ To register it, you can drop component [TFDGUIxWaitCursor] into your project.
10
+ ```
11
+
12
+ O GUID varia; o que importa é o nome da classe na mensagem (`TFDGUIxWaitCursor`, `TFDPhysSQLiteDriverLink`,
13
+ `TFDStanJSONFile`...). No mobile com SQLite, a variante é:
14
+
15
+ ```
16
+ [FireDAC][Phys][SQLite]-314. Cannot load vendor library [libsqlite.so or libdb_sql.so].
17
+ dlopen failed: library "libdb_sql.so" not found
18
+ ```
19
+
20
+ ## Causa
21
+
22
+ O FireDAC separa drivers e UI em units que se registram no `initialization`. Se nenhuma unit da cadeia de `uses` as
23
+ referencia, o linker não as inclui e a classe não é registrada. Acontece em projetos sem DataModule (conexão criada
24
+ em código), porque quem arrasta o componente no Designer ganha as units e a instância de
25
+ graça.
26
+
27
+ Duas pegadinhas:
28
+
29
+ - **Registrar a classe não basta.** `FireDAC.ConsoleUI.Wait` só registra `TFDGUIxWaitCursor`; sem DataModule, é
30
+ preciso criar a **instância** do componente.
31
+ - **SQLite no Android/iOS exige linkagem estática:** `slDefault`/`slDynamic` tentam `dlopen` de uma biblioteca do
32
+ sistema que o app não alcança. O Designer grava `EngineLinkage = slStatic` no `.dfm`; em código, é preciso setar.
33
+
34
+ ## Correção
35
+
36
+ No `uses` de uma unit viva no projeto (normalmente a de conexão), incluir conforme o uso:
37
+
38
+ | Banco | Units |
39
+ |---|---|
40
+ | SQLite | `FireDAC.Phys.SQLite`, `FireDAC.Phys.SQLiteDef` (+ `FireDAC.Phys.SQLiteWrapper.Stat` no mobile) |
41
+ | MySQL/MariaDB | `FireDAC.Phys.MySQL`, `FireDAC.Phys.MySQLDef` |
42
+ | PostgreSQL | `FireDAC.Phys.PG`, `FireDAC.Phys.PGDef` |
43
+
44
+ | Tipo de aplicação | Unit de espera (escolha uma) |
45
+ |---|---|
46
+ | VCL | `FireDAC.VCLUI.Wait` |
47
+ | Console, serviço, mobile | `FireDAC.ConsoleUI.Wait` |
48
+ | FMX desktop | `FireDAC.ConsoleUI.Wait` ou `FireDAC.FMXUI.Wait` |
49
+
50
+ | Unit | Para quê |
51
+ |---|---|
52
+ | `FireDAC.DApt` | necessária para `Open`/`Fetch` de queries |
53
+ | `FireDAC.Stan.ExprFuncs` | funções de expressão em filtros locais |
54
+ | `FireDAC.Stan.JSONFile` / `FireDAC.Stan.StorageBin` | salvar/carregar dataset em JSON ou binário |
55
+
56
+ A unit de setup precisa ser referenciada antes de qualquer acesso a banco no boot (primeiras posições do `uses` do
57
+ `.dpr`). Em Delphi 10.3 e anteriores, `EngineLinkage := slStatic` se escreve `StaticLink := True`.
58
+
59
+ Outro GUID da mesma família: procure o nome da classe em `$(BDS)\source\data\firedac\`; a unit que a registra é a que
60
+ falta no `uses`.
61
+
62
+ ## Exemplo
63
+
64
+ Unit de setup sem DataModule:
65
+
66
+ ```pascal
67
+ unit App.Infra.FireDAC.Setup;
68
+
69
+ interface
70
+
71
+ implementation
72
+
73
+ uses
74
+ FireDAC.Phys.SQLite, FireDAC.Phys.SQLiteDef, FireDAC.Phys.SQLiteWrapper.Stat,
75
+ FireDAC.Stan.ExprFuncs, FireDAC.Stan.Intf, FireDAC.UI.Intf,
76
+ FireDAC.Comp.UI, FireDAC.ConsoleUI.Wait, FireDAC.DApt;
77
+
78
+ var
79
+ FWaitCursor: TFDGUIxWaitCursor;
80
+ FSQLiteDriver: TFDPhysSQLiteDriverLink;
81
+
82
+ initialization
83
+ FWaitCursor := TFDGUIxWaitCursor.Create(nil);
84
+ FWaitCursor.Provider := 'Console';
85
+ FWaitCursor.ScreenCursor := gcrNone;
86
+ FSQLiteDriver := TFDPhysSQLiteDriverLink.Create(nil);
87
+ FSQLiteDriver.EngineLinkage := slStatic;
88
+
89
+ finalization
90
+ FSQLiteDriver.Free;
91
+ FWaitCursor.Free;
92
+
93
+ end.
94
+ ```
@@ -0,0 +1,61 @@
1
+ # Horse + gbswagger + JWT: rota que muda, rota que some e 401 no Swagger
2
+
3
+ Para projetos Delphi com Horse que documentam rotas com `Horse.GBSwagger` e protegem com `Horse.JWT`. Superfície de
4
+ API confirmada no gbswagger 3.1.0; a versão instalada pelo Boss em `modules/` é a única verdade, leia a interface ali
5
+ antes de escrever código de memória.
6
+
7
+ ## Sintoma
8
+
9
+ 1. Depois de converter um controller para o padrão de classe gbswagger, o cliente (app mobile) passa a receber 404:
10
+ `/cargo` virou `/v1/cargo`.
11
+ 2. O projeto compila e sobe, mas as rotas anotadas **não existem**; o build só mostrou
12
+ `warning W1074: Unknown custom attribute`.
13
+ 3. A UI do Swagger devolve **401**, ou o banner do console anuncia uma URL que não abre.
14
+ 4. `E2003`/`E2066` em cascata no `.dpr` ao configurar `Swagger.Title(...)` ou `Horse.GBSwagger.Middleware`.
15
+
16
+ ## Causa
17
+
18
+ 1. A rota é `BasePath + SwagPath.Name + '/' + SwagEndPoint.Path` (`{id}` vira `:id`). `[SwagPath('Tag')]` (1
19
+ argumento) deixa `Name` vazio e a rota fica na raiz; `[SwagPath(C_Prefix, 'Tag')]` acrescenta o prefixo.
20
+ 2. Os atributos `SwagPath`, `SwagGET`, `SwagPOST`, `SwagPUT`, `SwagDELETE` estão em `GBSwagger.Path.Attributes`, que
21
+ `Horse.GBSwagger` não reexporta. Sem a unit, o atributo é ignorado com um simples warning.
22
+ 3. A UI fica em `/swagger/doc/html` e o JSON em `/swagger/doc/json`. `/swagger` não é rota: pular `'/swagger'` no
23
+ `SkipRoutes` não libera a UI.
24
+ 4. `Title` e `Description` vivem em `IGBSwaggerInfo` (acesso por `.Info`, fechado com `.&End`), e o middleware é a
25
+ função `HorseSwagger`.
26
+
27
+ Sobre a ordem do JWT: `THorse.Use(...)` **sem path** registra no nó raiz e roda para toda rota, registrada antes ou
28
+ depois. Controllers que se registram na `initialization` (`THorseGBSwaggerRegister.RegisterPath`) continuam
29
+ protegidos pelo `Use(HorseJWT(...))` global. A ordem só importa para `Use` com path específico. O cadeado do Swagger
30
+ é documental (endpoints não públicos ganham o cadeado automaticamente; `[SwagGET('rota', 'desc', True)]` deixa
31
+ público); a proteção real é o middleware.
32
+
33
+ ## Correção
34
+
35
+ - Ao converter controller que já atende na raiz, usar `[SwagPath('Tag')]` para preservar o caminho.
36
+ - `GBSwagger.Path.Attributes` no `uses` de todo controller anotado; tratar `W1074` como erro.
37
+ - `SkipRoutes` com `/swagger/doc/html` e `/swagger/doc/json`, e o banner anunciando `/swagger/doc/html`.
38
+ - Configuração pelo `.Info ... .&End` e `THorse.Use(HorseSwagger)`. `Version`, `BasePath`, `Host`, `AddSecurity`,
39
+ `AddBearerSecurity`, `Path` e `AddModel` ficam direto em `IGBSwagger`; `Swagger` é variável global da unit.
40
+
41
+ ## Exemplo
42
+
43
+ ```pascal
44
+ uses
45
+ Horse, Horse.GBSwagger, Horse.JWT, GBSwagger.Path.Attributes;
46
+
47
+ Swagger
48
+ .Info
49
+ .Title('MinhaApi')
50
+ .Description('API REST')
51
+ .Version('1.0.0')
52
+ .&End
53
+ .AddBearerSecurity;
54
+
55
+ THorse
56
+ .Use(HorseSwagger)
57
+ .Use(HorseJWT(LSegredo,
58
+ THorseJWTConfig.New.SkipRoutes(['/health', '/swagger/doc/html', '/swagger/doc/json'])));
59
+ ```
60
+
61
+ Banner que não aparece em saída redirecionada: `console-writeln-sem-flush-nao-loga.md`.
@@ -0,0 +1,52 @@
1
+ # `MSB6003` / `MSB6002` — linha de comando do compilador longa demais
2
+
3
+ ## Sintoma
4
+
5
+ O build pelo msbuild falha com:
6
+
7
+ ```
8
+ warning MSB6002: The command-line for the "DCC" task is too long. Command-lines longer than 32000 characters
9
+ error MSB6003: The specified task executable "dcc32.exe" could not be run. The filename or extension is too long
10
+ ```
11
+
12
+ (em português: "O nome do arquivo ou a extensão é muito grande"). Costuma compilar no IDE e falhar na linha de
13
+ comando, principalmente em Android64/iOS e em máquinas com muitas bibliotecas de terceiros instaladas.
14
+
15
+ ## Causa
16
+
17
+ O limite do `CreateProcess` do Windows é de cerca de 32.000 caracteres. `DCC_UnitSearchPath` inchado por bibliotecas
18
+ globais (TMS, ACBr, DevExpress...) e `DCC_UsePackage` expandido em flags de pacote fazem o comando do `dcc` passar
19
+ disso, às vezes de 50.000.
20
+
21
+ ## Correção
22
+
23
+ 1. **Preferida:** arquivo de resposta do compilador. Numa `PropertyGroup` base do `.dproj` (sem condição de
24
+ plataforma), acrescentar `DCC_ForceExecute`. O msbuild grava `<Projeto>.cmds` e passa só `@Projeto.cmds` ao `dcc`.
25
+ Não remove caminhos nem muda a estrutura do projeto.
26
+ 2. Se ainda estourar ou não der para mexer no `.dproj`:
27
+ - encurtar `DCC_UnitSearchPath`, tirando caminhos de bibliotecas que o projeto não usa;
28
+ - concentrar os `.dcu` pré-compilados das bibliotecas num único diretório e referenciar só ele;
29
+ - usar caminhos curtos ou mapear a raiz das bibliotecas num drive (`subst`);
30
+ - chamar o `dcc32`/`dcc64` direto com um `<Projeto>.cfg` na pasta do projeto, que não tem limite de tamanho. Os
31
+ caminhos relativos do `.cfg` são resolvidos a partir da pasta corrente, então o `.bat` precisa de `cd /d` para a
32
+ pasta do projeto antes.
33
+
34
+ ## Exemplo
35
+
36
+ ```xml
37
+ <PropertyGroup>
38
+ <DCC_ForceExecute>true</DCC_ForceExecute>
39
+ </PropertyGroup>
40
+ ```
41
+
42
+ Formato do `.cfg` (alternativa do item 2):
43
+
44
+ ```ini
45
+ -DDEBUG
46
+ -NSWinapi;System;Vcl;Data
47
+ -E".\bin"
48
+ -N0".\dcu"
49
+ -U"modules\horse\src"
50
+ ```
51
+
52
+ Quem compila no Windows encontra o modelo de `.bat` com log em `build-via-bat-com-log.md`.