Visão Geral da Sintaxe
tyrus usa sintaxe concisa enquanto preserva as garantias da linguagem. A análise semântica aplica checagens nativas de inicialização, nullability, ownership e fluxo de controle.
Variáveis
const name: string = "tyrus";
let count: i32 = 1;Bindings const são imutáveis depois da inicialização. Bindings let podem ser reatribuídos quando o novo valor é compatível com o tipo declarado.
Funções
function add(left: i32, right: i32): i32 {
return left + right;
}Funções usam tipos explícitos para parâmetros e retorno. Uma função que não retorna void deve retornar um valor em todo caminho alcançável.
Result<T, E> é um valor de tipo que representa sucesso ou erro. Consulte Valores Result para as regras de payload, construtores, narrowing e propagação.
Objetos
interface User {
id: i32;
name: string;
}Interfaces descrevem formatos de objetos. Literais de objeto são checados estruturalmente contra os campos declarados.
Módulos
Um módulo publica nomes com export, seja na própria declaração, seja por uma cláusula separada que pode renomeá-los. Um nome por módulo pode ser o export default.
// math.tyr
export const add = (left: i32, right: i32): i32 => left + right;
const subtract = (left: i32, right: i32): i32 => left - right;
export { subtract as minus };
export default add;export protect estreita quem pode importar um nome. Um nome protegido é visível na pasta que o declara e em todas as subpastas dela, nunca na pasta pai e nunca numa pasta irmã. A regra depende apenas do arquivo declarante, então mover uma pasta inteira preserva todas as relações dentro dela.
// src/auth/token.tyr
export protect const verify = (id: i32): i32 => id + 1;
export const open = (id: i32): i32 => id + 2;// src/auth/login.tyr
import { verify } from "./token";
export const login = (id: i32): i32 => verify(id);// src/auth/session/refresh.tyr
import { verify } from "../token";
export const refresh = (id: i32): i32 => verify(id);Importá-lo de fora dessa pasta é erro de compilação, e a mensagem nomeia o símbolo, a pasta à qual ele está limitado e as duas saídas.
error
// src/http/handler.tyr
import { verify } from "../auth/token";
export const handle = (id: i32): i32 => verify(id);Uma pasta aninhada é um limite novo e mais estreito: um nome protegido em src/auth/session/ não é visível em src/auth/, nem mesmo através de um arquivo barril no meio. Um re-export carrega o escopo original sem alterá-lo, então export * e export { nome } from não conseguem alargá-lo, e um import por namespace simplesmente omite os nomes protegidos. protect é recusado num export default e num re-export, pois nenhum dos dois declara o nome que publica. Coloque os testes que precisam de um nome protegido dentro da pasta que o possui; não há exceção para arquivos de teste.
O lado do import tem as formas correspondentes. Um import default liga o export default do módulo de origem a qualquer nome local, um import por namespace liga todos os exports de uma vez, e ambos podem ser combinados com imports nomeados em uma única declaração.
import { readFileSync } from "tyrus:fs"; // native module
import { add, minus as sub } from "./math"; // named, with an alias
import sum from "./math"; // default
import sum, { minus } from "./math"; // default plus named
import * as math from "./math"; // namespace
import { default as plus } from "./math"; // explicit default{
"imports": {
"#src/*": "./src/*"
}
}import { settings } from "#src/config/settings";
import { formatDate } from "#src/utils/dates";tyrus.json pode declarar aliases internos estáticos no objeto imports. Cada chave começa com # e mapeia uma pasta dentro da raiz do projeto. # mapeia a raiz de código fonte, enquanto uma chave mais longa como #config mapeia uma pasta aninhada. Prefixos de alias mais longos têm precedência sobre os mais curtos. Aliases são expandidos uma vez em tempo de compilação e nunca resolvem pacotes, URLs ou valores de runtime.
Um namespace é resolvido em tempo de compilação: math.add(1, 2) vira uma chamada direta à função daquele módulo, e nenhum valor de namespace existe em runtime. Citar um membro que o módulo não exporta é erro de compilação, e a mensagem nomeia tanto o módulo quanto o membro.
Um módulo também pode encaminhar os exports de outro módulo sem ligá-los localmente.
export { minus as difference } from "./math";
export * from "./extra";export * nunca encaminha um default
export * encaminha apenas exports nomeados. O export default do módulo de origem fica privado. Dois exports publicando o mesmo nome público são erro de compilação, e não um último-vence silencioso.
APIs nativas de runtime são importadas por nomes de módulo estáveis tyrus:* quando a superfície está implementada. Imports são resolvidos recursivamente em tempo de compilação; imports circulares, nomes duplicados e imports de símbolos não exportados são erros de compilação.
Padrões de Segurança
- Todo statement e toda declaração terminam com
;(E3218), incluindo umconstassociado a uma arrow function e uma declaração com destructuring. Um construto que se fecha sozinho não precisa de;:if,else,while,do ... while,for,for ... of,for ... in,match,switch,loop,try/catch/finally, um blocodefer,interface, uma behaviorinterface,functioneenum. A cláusula de atualização de umforclássico, escritai++, é fechada pelo). - Variáveis devem ser inicializadas antes do uso.
- A ausência é representada explicitamente por
Nonee por tipos opcionais comostring?;nullnunca é um valor. - Valores non-Copy seguem regras de ownership e move.
Execução Nativa e Cobertura da Linguagem
- APIs de runtime como filesystem e HTTP são recursos nativos linkados ao programa gerado.
- Valores opcionais usam a sintaxe familiar
T?,None,??e narrowing;nullnão é um valor eOptional<T>é a forma equivalente por extenso. - Algumas sintaxes são parseadas antes de terem lowering completo para código nativo; páginas experimentais apontam isso explicitamente.
