Wild Vitals

3.7.14 — Architecture Regression Guard & Final Hardening / Guard de Regressão Arquitetural e Endurecimento Final

English (en-US)

• Added one consolidated architecture guard for the current WildVitals contract. It invokes the specialized Stage 1–6 guards and fails on direct mandatory EcoTermico/Cold Sweat imports, legacy Administration geometry, obsolete fixed-column helpers, ambiguous biological clocks, unsafe optional capabilities, scroll/layout drift, missing required translations, or reintroduced historical symbols.
• Added pure geometry regressions for exactly 854×480, 500×300, 320×240 and 320×180, validating non-negative coordinates, non-inverted rectangles, region containment, valid viewports and clipping.
• Added regressions for repeated semantic page switching, dynamic maxScroll recomputation/clamping, empty pages, and an external thermal capability disappearing and recovering during simulated runtime without stale provider state.
• Finalized historical hygiene from Stage 6: six obsolete symbols/overloads remain removed, 25 dead translation keys per locale remain removed, and pt_br, en_us and es_es now share the same 747-key contract with equivalent placeholder signatures.
• Final static certification reports zero internal symbol/method audit errors and the cumulative Guide regression suite passes. Full Gradle/NeoForge/JUnit/GameTest certification remains a separate release-environment step when the Gradle 9.2.1 distribution is reachable.
• No EcoTermico project source file was modified by this seven-stage WildVitals hardening line.

Português (pt-BR)

• Adicionado um guard arquitetural consolidado para o contrato atual do WildVitals. Ele executa os guards especializados dos Estágios 1–6 e falha com import obrigatório direto de EcoTermico/Cold Sweat, geometria administrativa legada, helpers antigos de coluna fixa, relógios biológicos ambíguos, capabilities opcionais inseguras, desvio de scroll/layout, traduções obrigatórias ausentes ou símbolos históricos reintroduzidos.
• Adicionadas regressões puras de geometria exatamente para 854×480, 500×300, 320×240 e 320×180, validando coordenadas não negativas, retângulos não invertidos, contenção nas regiões, viewports válidas e clipping válido.
• Adicionadas regressões para troca semântica repetida de páginas, recálculo/clamp dinâmico de maxScroll, páginas vazias e desaparecimento/retorno de capability térmica externa durante runtime simulado sem estado stale de provedor.
• Finalizada a higiene histórica do Estágio 6: seis símbolos/overloads obsoletos permanecem removidos, 25 traduções mortas por locale permanecem removidas e pt_br, en_us e es_es passam a compartilhar contrato idêntico de 747 chaves com placeholders equivalentes.
• A certificação estática final registra zero erros na auditoria interna de símbolos/métodos e a suíte cumulativa do Guia passa. A certificação Gradle/NeoForge/JUnit/GameTest completa continua como etapa separada no ambiente de release quando a distribuição Gradle 9.2.1 estiver acessível.
• Nenhum arquivo-fonte do projeto EcoTermico foi alterado por esta linha de endurecimento em sete estágios do WildVitals.

3.7.13 — Responsive Guide Restructure, Unified Scrolling & Overlap Protection / Reestruturação Responsiva do Guia, Scrolling Unificado e Proteção contra Sobreposição

English (en-US)

• Stage 5 hardens the scrolling contract: each semantic region owns one fixed unit (ANIMAL_LIST=ROW, CONTENT=LINE, ADMIN_FLOW/ADMIN_EDITOR/COMPATIBILITY=PIXEL) and mismatched configuration is rejected instead of silently mixing coordinate domains.
• Semantic context keys reset residual offsets when page/category/entity ownership changes, while resize invalidates stale geometry, preserves same-context position, recomputes maxScroll and clamps it to the new bounds.
• Partially visible scroll widgets now render through their exact 2D intersection and restrict hover/click/tooltip to that visible rectangle; fully outside widgets are neither rendered nor interactive.
• Scissor ownership is centralized in exception-safe GuideClipScope/try-with-resources, the canonical z-order is background → content → widgets → tooltips, and the Stage 5 guard plus both standalone probes are part of the cumulative Guide regression suite.
• Stage 14 adds the canonical docs/04_architecture/GUIDE_UI_DEVELOPMENT_CONTRACT.md, documenting how to create Guide pages and administrative controls without magic coordinates, including measured layout flow, unified scrolling, clipping, reserved regions, responsive minimums and regression requirements. The cumulative suite now guards this development contract.
• Stages 10–13 close the responsive Guide line with resolution/GUI-scale stress coverage, dynamic localization validation, a cumulative regression suite and final cleanup/reconciliation of the Stage 4–9 layout branches.
• Administration and the animal editor now compress reserved vertical regions under extreme logical heights without allowing search/list, navigation/content, editor/footer or footer/action overlap; the standalone probe covers 32 supported resolution/GUI-scale combinations plus compact cases down to 320×180.
• pt-BR, en-US and es-ES are kept at an identical 772-key contract with matching placeholder signatures; audited dynamic ON/OFF, disabled-trait and duration text now uses translatable components instead of runtime literals.
• Regression guards now validate the final architecture: Stage 4–6 flows coexist with Stage 9 fixed global actions, Stage 7 compatibility uses measured wrapped records, and editor text/widgets share viewport-derived clipping/hitbox geometry. Legacy performance-panel helpers and temporary merge artifacts were removed.
• Stages 7–9 harden Administration: Compatibility records now form one measured scroll document, including thermal-provider status, with text and toggle widgets sharing the same scissor and exact visible-intersection interaction gate.
• The ten Administration tabs now keep a readable minimum width and fall back to paginated navigation when needed; truncated localized labels expose the complete name through tooltips in pt-BR, en-US and es-ES.
• GuideResponsiveLayout.AdminWorkspace reserves exclusive content, footer-help and action regions; contextual Apply/action, Back and Close occupy dedicated slots, and covered administrative flows no longer rely on conflicting imageHeight - 30/-32/-48 footer offsets.
• Stage 2 scrolling hardening centralizes wheel ownership and priority in GuideScrollController.scrollFirst(...), preserving bounded semantic states for ANIMAL_LIST, CONTENT, ADMIN_FLOW, ADMIN_EDITOR and COMPATIBILITY without per-page scroll routing drift.
• Stage 3 clipping safety clamps every registered scroll viewport to the guide frame before creating the absolute scissor rectangle, fails closed for stale/out-of-frame geometry, and upgrades scrollable widget visibility to two-dimensional containment.
• Stage 4 migrates Animals and Administration > Animals to GuideResponsiveLayout.AnimalWorkspace, a single two-column geometry shared by rendering, search, list hit-testing, detail/editor scrolling and administrative controls.
• Search is now reserved inside the list column; in Administration > Animals it moves below the section navigation instead of competing with the administrative tab strip.
• The admin detail column reserves header, category navigation, editor viewport and footer before placing content; compact heights shrink those reserved regions without allowing them to overlap.
• Editor labels are bounded to a text lane and ON/OFF / - / + controls to a control lane; category/footer buttons use the actual responsive region height.
• Window/GUI-scale resize preserves search, selected animal, editor section and scroll offsets when still valid; the next viewport configuration clamps preserved offsets to the new bounds.
• Stage 3 replaces the four independent Field Guide scroll states with GuideScrollController, a single bounded viewport/offset contract for row, line and pixel scrolling.
• Articles, animal lists/details, Administration > Animals editor, Compatibility, Performance and Presets now derive clipping from the registered scroll viewport instead of maintaining section-specific scissor coordinates.
• Mouse wheel routing, animal-list hit-testing and scrollable widget visibility consume the same viewport contract, preventing render/input drift and hidden widgets remaining interactive outside the clip.
• The legacy animalListScroll, contentScroll, adminEditorScrollPixels and compatibilityScrollPixels fields (and their duplicated max/clamp state) were removed from WildVitalsGuideScreen.
• Stage 2 migrates the Field Guide shell to authoritative header, primaryNavigation, body and sectionNavigation regions resolved by GuideResponsiveLayout.
• Normal-size geometry is preserved, while short/high-GUI-scale windows use a compact shell that reclaims vertical content space without allowing primary navigation to overlap the body.
• Overview/article/Animals structural anchors and Animals hit-testing now consume the same body geometry, preventing visual/click-coordinate drift after resize.
• Removed direct shell dependencies on the legacy 29/56/65/88 top offsets; unified scrolling remains intentionally deferred to Stage 3.
• Stage 1 maps the complete Field Guide UI surface, current layout strategies, four independent scroll domains, fixed-coordinate hotspots, clipping boundaries and z-order/tooltip overlap risks.
• Added GuideResponsiveLayout as the shared geometry contract for frame sizing, safe rectangles, inset viewports and non-overlapping column splits.
• WildVitalsGuideScreen now delegates only its legacy-equivalent outer frame sizing to that contract; internal panel behavior is intentionally unchanged until the next stages.
• Added unit coverage and a static Stage 1 validation guard.

Português (pt-BR)

• O Estágio 5 endurece o contrato de scrolling: cada região semântica possui uma unidade fixa (ANIMAL_LIST=ROW, CONTENT=LINE, ADMIN_FLOW/ADMIN_EDITOR/COMPATIBILITY=PIXEL) e configurações com unidade divergente são rejeitadas em vez de misturar domínios de coordenadas silenciosamente.
• Chaves semânticas de contexto zeram offsets residuais quando muda a página/categoria/entidade proprietária; no resize a geometria antiga é invalidada, a posição do mesmo contexto é preservada, maxScroll é recalculado e o offset é limitado aos novos bounds.
• Widgets roláveis parcialmente visíveis passam a renderizar somente na interseção 2D exata e restringem hover/click/tooltip a esse retângulo visível; widgets totalmente fora não são renderizados nem interativos.
• O ownership do scissor fica centralizado em GuideClipScope com try-with-resources seguro contra exceções, o z-order canônico passa a ser fundo → conteúdo → widgets → tooltips e o guard do Estágio 5 com os dois probes independentes passa a integrar a suíte cumulativa do Guia.
• O Estágio 14 adiciona o contrato canônico docs/04_architecture/GUIDE_UI_DEVELOPMENT_CONTRACT.md, documentando como criar páginas do Guia e controles administrativos sem coordenadas mágicas, incluindo fluxo de layout medido, scrolling unificado, clipping, áreas reservadas, requisitos mínimos responsivos e proteção de regressão. A suíte cumulativa passa a proteger esse contrato de desenvolvimento.
• Os Estágios 10–13 fecham a linha responsiva do Guia com testes de estresse de resolução/GUI Scale, validação de internacionalização dinâmica, suíte cumulativa de regressão e limpeza/reconciliação final das linhas de layout dos Estágios 4–9.
• Administração e Editor de Animais passam a comprimir regiões verticais reservadas em alturas lógicas extremas sem permitir colisão entre busca/lista, navegação/conteúdo, editor/rodapé ou ajuda/ações; o probe cobre 32 combinações suportadas de resolução/GUI Scale e casos compactos até 320×180.
• pt-BR, en-US e es-ES permanecem com contrato idêntico de 772 chaves e assinaturas de placeholders equivalentes; textos dinâmicos auditados de ON/OFF, trait desativado e duração agora usam componentes traduzíveis em vez de literais de runtime.
• Os guards de regressão passam a validar a arquitetura final: fluxos dos Estágios 4–6 coexistem com ações globais fixas do Estágio 9, Compatibilidade do Estágio 7 usa registros medidos com wrapping, e texto/widgets do Editor compartilham geometria de clipping/hitbox derivada da viewport. Helpers legados de painel de Desempenho e artefatos temporários de merge foram removidos.
• Os Estágios 7–9 endurecem a Administração: registros de Compatibilidade formam um único documento rolável medido, incluindo o status do provedor térmico, com textos e toggles usando o mesmo scissor e interação limitada à interseção realmente visível.
• As dez abas administrativas passam a respeitar largura mínima legível e usam paginação quando necessário; rótulos localizados truncados exibem o nome completo por tooltip em pt-BR, en-US e es-ES.
• GuideResponsiveLayout.AdminWorkspace reserva regiões exclusivas para conteúdo, ajuda do rodapé e ações; Aplicar/ação contextual, Voltar e Fechar usam slots próprios, e os fluxos administrativos cobertos deixam de depender dos offsets conflitantes imageHeight - 30/-32/-48.
• O endurecimento do Estágio 2 centraliza ownership e prioridade do wheel em GuideScrollController.scrollFirst(...), preservando estados semânticos limitados para ANIMAL_LIST, CONTENT, ADMIN_FLOW, ADMIN_EDITOR e COMPATIBILITY, sem divergência de roteamento por página.
• O Estágio 3 limita todo viewport rolável ao frame do Guia antes de gerar o scissor absoluto, falha fechado quando a geometria estiver stale/fora do frame e passa a usar contenção bidimensional para visibilidade de widgets roláveis.
• O Estágio 4 migra Animais e Administração > Animais para GuideResponsiveLayout.AnimalWorkspace, uma geometria única em duas colunas compartilhada por renderização, busca, hit-test da lista, scrolling de detalhe/editor e controles administrativos.
• A busca passa a ocupar uma área reservada dentro da coluna da lista; em Administração > Animais ela fica abaixo da navegação de seções, sem disputar espaço com as abas administrativas.
• A coluna de detalhe administrativo reserva cabeçalho, navegação de categoria, viewport do editor e footer antes de posicionar conteúdo; em alturas compactas essas regiões encolhem sem se sobrepor.
• Labels do editor ficam limitados à faixa de texto e controles ON/OFF / - / + à faixa de controles; botões de categoria/footer usam a altura real da região responsiva.
• Resize de janela/escala GUI preserva busca, animal selecionado, seção do editor e offsets de scroll quando ainda válidos; a configuração seguinte do viewport limita os offsets aos novos bounds.
• O Estágio 3 substitui os quatro estados independentes de rolagem do Guia por GuideScrollController, um contrato único e limitado de viewport/offset para rolagem por linha de lista, linha de texto e pixel.
• Artigos, listas/detalhes de animais, editor Administração > Animais, Compatibilidade, Desempenho e Presets passam a derivar o clipping do viewport de scroll registrado, sem scissors próprios por seção.
• Wheel do mouse, hit-test da lista de animais e visibilidade dos widgets roláveis usam o mesmo viewport, evitando divergência entre desenho/entrada e widgets ocultos ainda interativos fora do recorte.
• Os campos legados animalListScroll, contentScroll, adminEditorScrollPixels e compatibilityScrollPixels (e seus estados duplicados de máximo/clamp) foram removidos de WildVitalsGuideScreen.
• O Estágio 2 migra o shell do Guia para regiões autoritativas header, primaryNavigation, body e sectionNavigation, resolvidas pelo GuideResponsiveLayout.
• A geometria em tamanho normal é preservada; janelas baixas/escala GUI alta usam shell compacto que recupera espaço vertical sem permitir sobreposição entre navegação principal e body.
• Âncoras estruturais do Overview/artigos/Animals e o hit-test de Animals passam a consumir a mesma geometria do body, evitando divergência entre desenho e clique após resize.
• Removida a dependência direta do shell nos offsets históricos 29/56/65/88; a unificação de scrolling permanece intencionalmente para o Estágio 3.
• O Estágio 1 mapeia toda a superfície gráfica do Guia, estratégias atuais de layout, quatro domínios independentes de rolagem, pontos críticos de coordenadas fixas, limites de clipping e riscos de sobreposição de z-order/tooltips.
• Adicionado GuideResponsiveLayout como contrato geométrico compartilhado para tamanho do frame, retângulos seguros, viewports com reservas e divisão de colunas sem sobreposição.
• WildVitalsGuideScreen delega neste estágio somente o dimensionamento externo equivalente ao legado para esse contrato; o comportamento interno dos painéis permanece intencionalmente inalterado até os próximos estágios.
• Adicionados teste unitário e guard estático específico do Estágio 1.