Skip to content

Interface em inglês, repositório público e correções da auditoria - #10

Merged
richassis merged 17 commits into
mainfrom
dev
Oct 9, 2026
Merged

richassis merged 17 commits into
mainfrom
dev

Conversation

@richassis

Copy link
Copy Markdown
Owner

Leva ao site tudo o que está no `dev`.

Principais mudanças

  • Interface em inglês: catálogo de textos tipado em `lib/i18n/`, seletor de idioma em Ajustes e nas boas-vindas, idioma inicial pelo navegador, `?lang=en|pt` na URL e os 5 exemplos em versão inglesa. O português ficou igual.
  • Repositório público: README em português e inglês com capturas e GIF, LICENSE (MIT), CONTRIBUTING, código de conduta, modelos de issue e PR, Dependabot e CI (checagem de tipos e build).
  • Card de compartilhamento do site (Open Graph) e favicon próprio.
  • Auditoria de código: remoção de código morto, comentários corrigidos, fonte única para ISA, sinais e flags, e correções de bugs (PC+1 sem saturar, reset do GPR, portas sem sinal em decimal com sinal, entre outras).
  • Feedback do professor: ajustes nas flags e nos fios, e formulário de feedback por email.

Verificação

  • `tsc`, lint (só a baseline conhecida em `EnhancedBusOverlay`) e build passam; CI verde no `dev`.
  • Os 5 exemplos simulados tick a tick, em hex e em decimal com sinal, nos dois idiomas.

- Bolinhas da UC acendem para todo sinal escrito no estado, mesmo com
  valor 0; escritas de limpeza que não mudam o valor não acendem.
- opULA: OR = 6 e NOT = 7; volta a 0 em BUSCA e ESCREVE_REG_3. R só
  grava no EXECUTA, para manter o resultado.
- Carry da subtração é o vai-um de A + ~B + 1 (C = 1 quando A >= B).
- Nova flag de overflow (V), exibida na UC e na ULA.
- Blocos acendem quando gravam, mesmo que o valor não mude.
- Coluna Nome na DMEM da visualização de memórias; sem "somente leitura".
- ULA mostra só a operação (ADD, SUB, AND, OR, NOT) e as flags.
- Contador de ticks em verde durante a simulação; controles centralizados.
- Componentes sem ícone no título.
- JC removido da ISA, do montador, da UC e da ajuda (opcode 01010 livre).
- ISA: um formato de instrução por grupo e coluna com a palavra do exemplo
  em hexadecimal e binário.
- Créditos com o link do projeto no GitHub.
- LDA/LDAI atualizam só as flags da UC; operações da ULA atualizam ambas
- Barramento visível de 4 bits de flags da ULA para a UC
- Remove reset/pausa da UC, entalhe de clock, rótulo s=N dos MUX e
  endereço no cabeçalho da IMem
- Entrada de opcode no canto inferior esquerdo da UC; PC+1 espelhado,
  MAR perto da DMem e R alinhado com A/B
- Roteamento de fios respeita as caixas dos blocos nas pontas
- Contador de ticks destacado; remove "ticks capturados" e o rótulo de
  opcode da barra
- Guia: seção de números reescrita (decimal, hexa e binário) e aviso
  sobre o imediato de 8 bits do LDAI; montador aceita 0b
- Duração da animação cresce com a raiz do comprimento do fio, para
  fios longos não destoarem
Os textos de ajuda diziam que o imediato vai de −128 a 255, mas o byte é
estendido com sinal: 128..255 são aceitos e viram negativos. O preset de
instruções lógicas usava 170 e 204, que carregavam 0xFFAA e 0xFFCC, e os
comentários mostravam resultados errados; agora usa 85 e 51.
O opcode passa a entrar pela esquerda e as flags pela direita, na mesma
altura, logo acima da faixa de sinais, com o nome de cada entrada escrito
acima da porta para não ficar sob a etiqueta de valor do fio. A faixa de
sinais fica mais alta para que os valores não encostem nas portas de baixo.
O fio do opcode no projeto padrão contorna a UC pela esquerda.
A timeline restaurava o estado final da UC no início do tick, flags
incluídas, então as flags da ULA e da UC acendiam antes de qualquer fio
se mover. Agora a FSM avança no início do tick, mas as flags ficam no
valor antigo até o dado que as produz chegar: as da ULA quando A/B
chegam, as da UC quando o fio de flags chega nela ou, no LDA/LDAI,
quando o valor é escrito no GPR.

As portas de cima da ULA (opULA e flags) ficavam na borda do retângulo,
flutuando acima do trapézio. PortConfig ganhou `inset`, e a ULA o
calcula a partir da própria aresta do desenho (lib/aluShape.ts).
O aluno escolhe o tipo (sugestão, problema, elogio), escreve a mensagem
e o botão abre o programa de email com destinatário, assunto e corpo
preenchidos, com o navegador e a data no fim. O endereço aparece com um
botão de copiar para quem usa webmail. A pesquisa rápida saiu.
- README novo em português e em inglês, com capturas, GIF da execução,
  ISA, seção para professores e guia de desenvolvimento.
- Licença MIT, guia de contribuição, código de conduta, modelos de
  issue e de PR.
- CI com checagem de tipos e build; Dependabot mensal no dev.
- Card de compartilhamento (Open Graph) para o link do site.
- Saem os documentos internos obsoletos: REFACTOR_PLAN.md,
  PORT_CONFIGURATION.md e .github/copilot-instructions.md.
Resolve as seções 1, 2, 3 e 6 da auditoria de código de outubro, sem
mudar o comportamento: os 5 exemplos rodam tick a tick com o mesmo
estado em todos os ticks.

- Saem a classe Clock, o PortTooltipWrapper, o sinal muxAMem, métodos
  sem uso das classes do simulador, campos e ações de store que nada
  lia (incluindo os interruptores de animação sem botão), ramos
  inalcançáveis da interface, a base octal, o preset Multiplicação, o
  console.log dos desvios, CSS e SVGs sem uso e duas dependências.
- Comentários corrigidos, com prioridade aos que ensinavam errado:
  muxPC invertido, enum da ISA no modelo antigo de acumulador, PC
  incrementado "no DECODE", sinais que "voltavam a 0" e flags que "só a
  ULA" mudava. O cabeçalho do montador descreve a sintaxe aceita.
- Na tela: a legenda diz que o estado de erro é a CPU parada pelo HLT,
  o diagrama da ajuda mostra a flag V e o registrador B perde a porta
  de escrita solta que o A não tinha.
Cada instrução da ISA passa a declarar seus operandos (campo, rótulo,
tipo, sinal), e deles saem o codificador, o passo 2 do montador, a
sintaxe da Ajuda e o significado dos campos nas figuras. Há uma só
busca por opcode, um só layout de campos e um só nome por operação da
ULA. O Encoder.ts duplicado sai.

Os sinais da UC viram uma tabela (nome, largura, valor de repouso) da
qual saem as portas, os valores padrão, a emissão por estado e as
listas da Ajuda e da faixa de sinais.

Sem mudança de comportamento: o montador gera as mesmas palavras e os
mesmos erros, e os 5 exemplos têm o mesmo estado em todos os ticks.
- Um só componente de lista de endereços (AddressList) no lugar das
  três cópias em MemoryTable e nos widgets de memória, com formatação
  de endereço e destaque compartilhados (agora 8% em todos).
- Tamanho do texto definido antes do primeiro paint: a primeira visita
  não abre mais em "médio" para depois encolher. Tema e tamanho são
  aplicados por um assinante em cada store, e o migrate das preferências
  respeita a versão em vez de reiniciar a velocidade a cada mudança.
- O trilho do painel recolhido usa a mesma largura em rem no desenho e
  no cálculo do layout, que antes só batiam no tamanho "médio".
- Textos em português: "parado" no contador, nomes das flags na UC e
  na ULA, botões das memórias.
- Esc fecha o painel de memórias; a Ajuda diz que os atalhos de
  reprodução valem com a linha do tempo ativa.
- Toast de erro, bounding box do canvas e cálculo de posição dos pontos
  nos fios sem duplicação.
- lib/portKinds.ts passa a ser o único lugar que diz de que tipo é uma
  porta (controle, flag, endereço, opcode, instrução, dado). Dele saem o
  formato do ponto, a formatação sem sinal, a cor e a fase de animação
  dos fios, e a chegada das flags na UC. Os sinais de controle ganham
  um papel na tabela da UC (seleção, escrita, leitura, operação), de
  onde saem as habilitações de escrita e o gatilho dos MUX.
- O nome interno das portas da ULA, do somador e do MUX passa a ser a
  própria chave; nenhum fio do .cpud muda.
- O carry do somador e do incrementador e o out_halted da UC viram
  portas numéricas de 1 bit; o tipo "boolean", que não podia ser
  ligado a nada, sai.

Sem mudança visível: mesmos formatos de porta, mesmas cores e fases de
animação e o mesmo estado em todos os ticks, em hex e em decimal com
sinal.
O barramento de flags aparecia como -8 com Z ligado e o overflow como -1
com V ligado. As duas portas passam a ser classificadas como flag.
O idioma vem de ?lang, da escolha salva ou do navegador, e vai para o
<html lang> antes do primeiro paint. Os textos passam a sair de um
catálogo por idioma (lib/i18n), com o inglês tipado contra o português.

Prepara a tradução sem mudar o que aparece em português:
- erros do montador e de execução viram dados, com o texto montado na
  hora de mostrar;
- exemplos têm uma versão por idioma e continuam reconhecidos ao trocar;
- rótulos ULA e UC são traduzidos na exibição, sem mudar o .cpud;
- campos não usados, tipos de feedback e créditos deixam de depender
  do texto.
Barra, painéis do programa, memórias, canvas, legenda, abertura, tour e
Ajuda passam a ler os textos de lib/i18n, e cada área ganha a tradução
em inglês. As tabelas da Ajuda (instruções, estados, sinais e blocos)
ficam no catálogo; helpContent.ts guarda só o que não é texto.

Em português nada muda, a não ser o singular em "1 linha" e
"1 instrução" e o aviso de canvas sem fios, que estava em inglês.
- Os 5 exemplos ganham versão em inglês, com comentários e labels
  traduzidos; as duas versões montam as mesmas palavras.
- Seletor de idioma em Ajustes e no canto das boas-vindas, cada opção
  escrita no próprio idioma.
- Um programa sem nome é salvo como program.asm em inglês, e o nome
  padrão continua neutro ao trocar de idioma.
- README aponta para ?lang=en e o CONTRIBUTING explica o catálogo.
Substitui o favicon padrão do Create Next App por um ícone SVG, com
favicon.ico (16, 32 e 48 px) e apple-icon.png gerados do mesmo desenho.
@vercel

vercel Bot commented Oct 9, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
cpu-didatica Ready Ready Preview Oct 9, 2026 9:34pm UTC

@richassis
richassis merged commit fc6c7b0 into main Oct 9, 2026
4 checks passed

This branch was successfully deployed

1 active deployment
Preview — 2edadbe0 Deployed Oct 9, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant