Canais de lançamento

Text.js é distribuído em três dist-tags do npm. Todos os pacotes (@textjs/app, @textjs/react, @textjs/core, @textjs/font, @textjs/opencode, create-text-app e eslint-plugin-textjs) são versionados em conjunto, então um único número de versão descreve todo o framework.

#Canais

Use o canal estável em produção. Use o canary para testar correções e recursos no dia em que chegam à dev. Quando houver uma linha LTS, use-a se você atualiza uma vez por ano.

bun create text-app@canary my-console

#Estável

As versões estáveis seguem o versionamento semântico: versões de correção corrigem bugs, versões menores adicionam recursos retrocompatíveis e versões maiores podem quebrar APIs após um período de descontinuação. Uma versão estável é promovida a partir de uma canary que passou por toda a suíte de testes e é publicada com comprovação de procedência do npm.

#Canary

Cada push para dev no repositório oficial passa por verificação de tipos e testes e é publicado como a próxima versão de correção com o sufixo -canary.N:

N continua a partir do maior número canary já no npm, então os números nunca se repetem. As versões canary não são registradas em commits no repositório. Adicione [skip canary] à mensagem de um commit para pular uma publicação.

As versões canary são builds de dev, a branch em que todo pull request é integrado. Elas podem alterar ou remover APIs ainda não lançadas sem aviso prévio. Fixe uma versão canary exata se você depende de uma.

#Procedência

As versões são publicadas pelo GitHub Actions com npm publish --provenance, que vincula cada tarball ao commit e ao workflow exatos que o geraram. Verifique um pacote com:

npm audit signatures

#Publicar uma versão

Os mantenedores incrementam a versão de todos os pacotes do workspace em conjunto com os scripts de publicação:

bun run release:version minor   # 1.0.0 → 1.1.0 (also: patch, major, canary, stable, x.y.z)bun run release:publish --tag latest --provenance

release:version reescreve cada package.json e as constantes de versão que o espelham (VERSION, rendererVersion do reconciliador), recusa a execução quando as versões dos pacotes divergem, e --dry-run exibe o plano. release:publish compila, empacota (resolvendo workspace:*), aplica publishConfig, recusa publicar uma pré-versão em latest ou uma versão estável em canary e ignora versões que já existem no npm.

Consulte a Política de suporte para saber por quanto tempo cada linha de versões é mantida.