Skip to content

fix: adiciona comments (blockComment) ao configuracao-foles.json para habilitar Ctrl+/ (#119) - #130

Merged
leonelsanchesdasilva merged 2 commits into
DesignLiquido:principalfrom
kunaaaalcodes:fix-119-comments-foles
Jul 29, 2026
Merged

fix: adiciona comments (blockComment) ao configuracao-foles.json para habilitar Ctrl+/ (#119)#130
leonelsanchesdasilva merged 2 commits into
DesignLiquido:principalfrom
kunaaaalcodes:fix-119-comments-foles

Conversation

@kunaaaalcodes

Copy link
Copy Markdown
Contributor

Resolve #119

Descrição

Esta PR adiciona suporte à funcionalidade de comentar e descomentar código em arquivos FolEs através do atalho Ctrl+/ do VS Code.

A alteração consiste na inclusão da seção comments no arquivo de configuração da linguagem (configuracao-foles.json), permitindo que o editor reconheça corretamente comentários em bloco.


Problema

O arquivo configuracoes/configuracao-foles.json definia apenas:

  • brackets;
  • autoClosingPairs;
  • surroundingPairs;

porém não declarava a seção comments.

Como consequência, o atalho Ctrl+/ não funcionava em arquivos .foles, impedindo que usuários comentassem ou descomentassem trechos de código utilizando o comportamento padrão do VS Code.

Por se tratar de um dos atalhos mais utilizados do editor, sua ausência era percebida como uma limitação da extensão.


Solução

Foi adicionada a seção comments ao arquivo:

configuracoes/configuracao-foles.json
{
  "comments": {
    "blockComment": [
      "/*",
      "*/"
    ]
  },
  "brackets": [...],
  "autoClosingPairs": [...],
  "surroundingPairs": [...]
}

Com essa alteração, o VS Code passa a reconhecer corretamente comentários em bloco para arquivos FolEs, habilitando o suporte ao comando Toggle Line Comment (Ctrl+/).


Decisões técnicas

Decisão Justificativa
Utilizar apenas blockComment FolEs é uma linguagem inspirada em CSS e suporta apenas comentários em bloco (/* ... */).
Não adicionar lineComment A gramática (gramaticas/foles.tmLanguage.json) define apenas comment.block.foles, não existindo suporte para comentários de linha.
Utilizar o comportamento padrão do VS Code Quando apenas blockComment é definido, o VS Code utiliza automaticamente esse formato para o atalho Ctrl+/, comportamento idêntico ao da linguagem CSS.

Comportamento esperado

Após esta alteração, o atalho Ctrl+/ passa a funcionar corretamente nos seguintes cenários:

  • comentar uma linha;
  • descomentar uma linha já comentada;
  • comentar múltiplas linhas selecionadas;
  • comentar uma linha vazia.

Arquivos alterados

Arquivo Descrição
configuracoes/configuracao-foles.json Adiciona a configuração de comentários para FolEs

Verificação

Foram realizadas as seguintes verificações:

  • validação da sintaxe do arquivo JSON:
node -e "JSON.parse(require('fs').readFileSync('configuracoes/configuracao-foles.json','utf8')); console.log('valid JSON')"

Resultado:

valid JSON
  • estrutura validada de acordo com o esquema language-configuration.json do VS Code.

Resultado

Com esta PR, arquivos FolEs passam a oferecer suporte ao comando Toggle Line Comment (Ctrl+/), alinhando o comportamento da linguagem ao esperado pelos usuários do VS Code e às demais linguagens suportadas pela extensão.


Resolve #119

@leonelsanchesdasilva leonelsanchesdasilva left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Obrigado!

@leonelsanchesdasilva
leonelsanchesdasilva merged commit b9e6fdb into DesignLiquido:principal Jul 29, 2026
4 checks passed
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.

FolEs não declara comments no arquivo de configuração de linguagem (Ctrl+/ quebrado)

2 participants