v0.7.0 (beta)

Code Scope 0.7.0 is a beta. It is here for people to try and help shape before it goes to the VS Code Marketplace. If something looks wrong, confusing or missing, open an issue. A screenshot from the panel's Save image button helps a lot.

Install

1. Download code-scope.vsix below.
2. Run code --install-extension code-scope.vsix, or in VS Code open the Extensions view, click ... and choose Install from VSIX....
3. Open one of your programs (or a sample from the repository), set a breakpoint and start debugging. The Code Scope panel opens on the first stop.

You need VS Code 1.95 or newer and the debugger for your language: Extension Pack for Java, Node.js 22 or newer for JavaScript, the Python extension, the C# extension, or the C/C++ extension with gdb.

What changed since 0.6.0

• Needs VS Code 1.95 or newer (it was 1.90). From 1.90 to 1.94, the JavaScript debugger that ships with VS Code did not show objects when stepping over a new.
• Tested on Linux and macOS in CI, besides Windows, and on VS Code 1.95.
• High contrast themes: cards, boxes and tables now use the theme border, and the next line gets an outline.
• Contrast: gray text that was below 4.5:1 (on the "changed" highlight, out-of-scope variables, positions outside the binary search range) is now readable.
• Binary search: arrows with long names (inicio, encontradoEm) no longer cover each other.
• Recursion tree: each call sits at the end of its line, with room before the variables below.
• Screen readers: a matrix is read as a table, row by row.
• codeScope.animationSpeed now takes slow, normal, fast and off. The old values still work.

Full list in the CHANGELOG.

Known limits

• Not tested yet with a real screen reader, with Marketplace color themes, with C on macOS, or with JavaScript in the browser.
• C++ containers (std::vector, std::map) are not drawn yet.

Want to help?

There are now issues ready to pick up, several with no code at all. Questions and ideas go to Discussions.

---

O Code Scope 0.7.0 é uma beta. Ela existe para as pessoas testarem e ajudarem a melhorar antes de ir para o Marketplace do VS Code. Se algo parecer errado, confuso ou faltando, abra uma issue. Uma imagem do botão Salvar imagem do painel ajuda muito.

Instalar

1. Baixe o code-scope.vsix abaixo.
2. Rode code --install-extension code-scope.vsix ou, no VS Code, abra a aba Extensões, clique em ... e escolha Install from VSIX....
3. Abra um programa seu (ou um exemplo do repositório), coloque um breakpoint e comece a debugar. O painel Code Scope abre na primeira parada.

É preciso o VS Code 1.95 ou mais novo e o debugger da sua linguagem: Extension Pack for Java, Node.js 22 ou mais novo para JavaScript, a extensão Python, a extensão C#, ou a extensão C/C++ com gdb.

O que mudou desde a 0.6.0

• Pede VS Code 1.95 ou mais novo (antes, 1.90). Do 1.90 ao 1.94, o debugger de JavaScript que vem com o VS Code não mostrava os objetos ao dar F10 por cima de um new.
• Testado no Linux e no macOS no CI, além do Windows, e no VS Code 1.95.
• Temas de alto contraste: cartões, caixas e tabelas usam a borda do tema, e a próxima linha ganha um contorno.
• Contraste: o texto cinza que ficava abaixo de 4,5:1 (no destaque de "mudou", nas variáveis fora de escopo e nas posições fora do intervalo da busca binária) agora dá para ler.
• Busca binária: setas com nome comprido (inicio, encontradoEm) não se cobrem mais.
• Árvore de recursão: cada chamada fica na ponta da sua linha, com espaço antes das variáveis de baixo.
• Leitores de tela: a matriz é lida como tabela, linha por linha.
• codeScope.animationSpeed agora usa slow, normal, fast e off. Os valores antigos continuam funcionando.

Lista completa no CHANGELOG.

Limites conhecidos

• Ainda sem teste com leitor de tela de verdade, com temas de cores do Marketplace, com C no macOS e com JavaScript no navegador.
• As coleções do C++ (std::vector, std::map) ainda não são desenhadas.

Quer ajudar?

Agora há issues prontas para pegar, várias sem código. Dúvidas e ideias vão nas Discussions.