Documentação do Joss

Esta documentação descreve o comportamento do código atual. Está dividida em aprendizado, guias, referência e internos para que uma pessoa iniciante possa avançar em ordem e uma pessoa experiente encontre regras concretas.

Idiomas

• Español (fonte canônica): este diretório.
• English
• Português

Os 50 documentos mantêm o mesmo nome em cada idioma para que os links relativos funcionem igual. Depois de editar o espanhol, execute go run ./tools/docsi18n -translate -sync para atualizar traduções e o espelho web; go run ./tools/docsi18n -check detecta arquivos ausentes, traduções desatualizadas, links quebrados ou diferenças com JosSecurity.

Aprender Joss (Rota guiada do zero)

Se você nunca programou ou está aprendendo Joss pela primeira vez, siga este curso em ordem. Cada capítulo introduz um conceito por vez, partindo de como criar e executar seu projeto oficial com joss new console, com explicações linha por linha, resultados visíveis e três níveis de prática (Teste rápido, Exercício guiado e Desafio).

flowchart LR
    C0["0. Primeros pasos (joss new console)"] --> C1["1. Fundamentos"]
    C1 --> C2["2. Control de flujo"]
    C2 --> C3["3. Colecciones"]
    C3 --> C4["4. Funciones"]
    C4 --> C5["5. Errores"]
    C5 --> C6["6. Clases y POO"]
    C6 --> C7["7. Concurrencia"]
    C7 --> C8["8. Proyecto Consola (joss build)"]
    C8 --> C9["9. Proyecto Web MVC (joss new / joss make:*)"]

1. Primeiros passos: criar seu projeto com joss new console, entender main.joss e dialogar com cin
2. Valores, variáveis e operações fundamentais
3. Controle de fluxo: decisões e laços de repetição
4. Coleções: Arrays, Maps e texto Unicode
5. Funções, escopo (scope), guard, defer, closures, ref e pipelines
6. Tratamento de erros, diagnósticos JOSS-... e exceções try/catch
7. Classes, objetos, herança, interfaces, record e genéricos
8. Concorrência, async/await, Future e canais (channel)
9. Projeto prático de console com persistência JSON e joss build
10. Projeto web completo com joss new e arquitetura MVC nativa

O glossário explica todos os termos de programação e do Joss em linguagem cotidiana, sem exigir que você conheça outra linguagem. Depois de concluir o curso básico, aprofunde-se nas regras formais de tipos em Sistema de tipos, inferência e conversões.

Referência da linguagem e ferramentas

• Sintaxe, tokens e precedência
• Gramática EBNF e nós AST
• Funções, recursão e tipos
• Diagnósticos e analisador
• Funções globais
• Classes nativas e serviços
• Catálogo nativo gerado
• CLI, formatador, linter e testes
• Suporte móvel: Android e iOS
• Extensão do VS Code
• Estado e limites

Criar aplicações

• Estrutura de projetos e configuração
• Organização sem imports e plugins
• Web: servidor, HTTP/controladores, middleware, views, assets e WebSockets
• Dados: modelos/GranDB, Schema Builder e migrações
• Aplicação: autenticação e SEO/sitemap

Internos e manutenção

• Arquitetura da linguagem
• Guia de contribuição
• Auditoria de documentação
• Auditoria da linguagem Joss 2026
• Avaliação crítica e comparativa do Joss 2026
• Evolução do Joss 2026: fases 0 e 1
• Auditoria do ORM GranDB 2026
• Auditoria técnica de 2026
• Auditoria de otimização runtime
• Novidades históricas 3.6.7

Os documentos históricos preservam o contexto e podem descrever o estado de sua data. Diante de uma diferença, prevalecem a implementação, os testes e Estado de implementação.