Uma skill de agente para Claude que cria ilustrações SVG isométricas e interativas de máquinas e sistemas reais para explicar ideias técnicas.
Bogdan-Lyashenko/js-code-to-svg-flowchart
Biblioteca JavaScript e CLI que converte código JS em fluxogramas SVG, com níveis de abstração, modificadores de blocos de código e temas.
- Estrelas
- 7,105
- Forks
- 478
- Issues abertas
- 45
- Último commit
- há 3 anos
O que é?
js2flowchart analisa código JavaScript e o transforma em uma árvore sintática abstrata, monta a partir dela uma árvore de fluxo e renderiza essa árvore como um fluxograma SVG. A biblioteca funciona tanto no cliente quanto no servidor e oferece suporte à sintaxe ES6. É possível gerar o resultado pela API JavaScript ou pela linha de comando, passando um único arquivo como argumento.
A biblioteca permite controlar o nível de detalhe exibido. Os níveis de abstração predefinidos mostram apenas imports e exports, nomes de classes e funções ou dependências entre funções; também é possível definir níveis personalizados. Os modificadores podem representar iteradores como map, forEach e filter com formas de loop, reduzir um bloco a uma única forma ou ignorar nós como chamadas de log. As funções de foco e desfoque destacam ou ocultam ramificações específicas do gráfico.
A renderização pode ser configurada com temas predefinidos (default, preto e branco, desfocado e claro) ou com cores e estilos personalizados. Um gerador de apresentações produz uma sequência de SVGs em diferentes níveis de abstração, e um editor online permite colar código e baixar o resultado.
Recursos principais
- 01Converte código-fonte JavaScript (ES6) em fluxogramas SVG no navegador ou no Node.js.
- 02Oferece uma CLI que gera um arquivo SVG a partir de um arquivo JS local.
- 03Inclui níveis de abstração predefinidos, como imports/exports, classes e dependências entre funções.
- 04Permite definir níveis de abstração personalizados e modificadores da árvore de fluxo.
- 05Inclui controles de foco, desfoque e remoção de blocos no gráfico.
- 06Oferece vários temas de cores e permite personalizar os estilos.
Casos de uso
- Documentar o funcionamento de um módulo ou função com um diagrama visual.
- Entender uma base de código desconhecida visualizando seu fluxo de controle passo a passo.
- Gerar slides de apresentação que vão da estrutura geral à lógica detalhada.
- Criar fluxogramas para um processo descrito com sintaxe JS válida.
Início rápido
- 1
Instale o pacote pelo NPM
yarn add js2flowchart - 2
Instale globalmente para usar a CLI em qualquer lugar
yarn global add js2flowchart - 3
Gere um fluxograma SVG a partir de um arquivo JS
js2flowchart main.js
Antes de usar
- A documentação informa que o suporte a vários arquivos é tratado por um projeto separado, o Codecrumbs, e não por esta biblioteca.
- O último envio de código foi em outubro de 2023, então a manutenção pode ser lenta.
- O README não descreve como o fluxograma é gerado para códigos além dos exemplos apresentados.
Tópicos
Perguntas frequentes
- O que é js-code-to-svg-flowchart?
- Biblioteca JavaScript e CLI que converte código JS em fluxogramas SVG, com níveis de abstração, modificadores de blocos de código e temas. js2flowchart analisa código JavaScript e o transforma em uma árvore sintática abstrata, monta a partir dela uma árvore de fluxo e renderiza essa árvore como um fluxograma SVG. A biblioteca funciona tanto no cliente quanto no servidor e oferece suporte à sintaxe ES6. É possível gerar o resultado pela API JavaScript ou pela linha de comando, passando um único arquivo como argumento.
- js-code-to-svg-flowchart é gratuito? Qual é a licença?
- js-code-to-svg-flowchart é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- js-code-to-svg-flowchart ainda é mantido?
- Sem commits há mais de 6 meses. O último commit de js-code-to-svg-flowchart foi em 2 de out. de 2023.
- Para que posso usar js-code-to-svg-flowchart?
- Documentar o funcionamento de um módulo ou função com um diagrama visual. Entender uma base de código desconhecida visualizando seu fluxo de controle passo a passo. Gerar slides de apresentação que vão da estrutura geral à lógica detalhada. Criar fluxogramas para um processo descrito com sintaxe JS válida.
- Como instalar js-code-to-svg-flowchart?
- Instale o pacote pelo NPM: yarn add js2flowchart Instale globalmente para usar a CLI em qualquer lugar: yarn global add js2flowchart Gere um fluxograma SVG a partir de um arquivo JS: js2flowchart main.js
- Onde consigo js-code-to-svg-flowchart?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Bogdan-Lyashenko/js-code-to-svg-flowchart
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Um renderizador leve e síncrono que converte texto de diagramas Mermaid em SVG, sem dependências em tempo de execução.
Um compilador experimental de TypeScript e JavaScript que transforma programas em executáveis nativos ou WebAssembly, sem exigir Node.js em tempo de execução.
Uma ferramenta de terminal que reproduz commits do Git como sessões de digitação animadas, com realce de sintaxe e transições na árvore de arquivos.
Uma skill para agentes e um linter sem dependências que ensinam agentes de programação a criar diagramas SVG com posicionamento manual e um estilo visual consistente.
Serviço de registro gratuito de domínios com várias extensões, além de um guia de aprendizado sobre DNS e criação de sites, documentado neste repositório.