Pacote de idioma: catálogos em português e espanhol

Objetivo e pré-requisitos

Distribua um catálogo propositalmente parcial de seis textos de interface em pt-BR e es. Ele demonstra estrutura e alternativa de idioma; não é tradução completa nem nova release do Translator oficial.

Host alvo: 0.3.0, SDK 1.0.0. Textos da interface do exemplo estão em inglês. Preserve a versão solicitada ao adaptar.

Arquivos completos

Baixar pacote-fonte ZIP

Estes são fontes completos, sem assinatura. Depois de revisar o código, teste por Instalar de ZIP em um host descartável. Para publicar pelo Marketplace, prepare a assinatura e o catálogo da referência de assinatura e ativação. Nenhuma chave privada acompanha o download.

• manifest.json

• main.mjs

• locales/pt-BR.json

• locales/es.json

• LICENSE.txt

• README.md

Manifesto completo

{
  "id": "example.language-demo",
  "name": "Example language demo",
  "version": "1.0.0",
  "sdk": {
    "requires": ">=1.0.0 <2.0.0",
    "tested": "1.0.0"
  },
  "description": "Partial original interface catalogs for Portuguese and Spanish.",
  "author": "Gravewright documentation examples",
  "license": "GPL-3.0-only",
  "entry": "main.mjs",
  "locales": {
    "pt-BR": {
      "name": "Português (Brasil)",
      "path": "locales/pt-BR.json"
    },
    "es": {
      "name": "Español",
      "path": "locales/es.json"
    }
  }
}

Código do exemplo

main.mjs

export default { start() {}, register() {}, stop() {} };

locales/pt-BR.json

{
  "Actors": "Personagens",
  "Items": "Itens",
  "Settings": "Configurações",
  "Close": "Fechar",
  "Save": "Salvar",
  "Search": "Buscar"
}

locales/es.json

{
  "Actors": "Personajes",
  "Items": "Objetos",
  "Settings": "Ajustes",
  "Close": "Cerrar",
  "Save": "Guardar",
  "Search": "Buscar"
}

Como executar

1. Use um host isolado sem outro pacote global ativo fornecendo esses idiomas. Como proprietário, revise/instale o ZIP-fonte por Módulos → Instalar de ZIP e ative-o na instalação.

2. Escolha português ou espanhol nas Configurações da conta e recarregue. Textos nativos presentes no catálogo podem ser traduzidos; os ausentes ficam em inglês.

3. Desative o exemplo e recarregue. Confira retorno ao inglês e preservação dos nomes escritos na campanha.

Resultado esperado e ciclo de vida

locales é metadado do pacote, não um campo kind. A entrada JavaScript sem ações atende ao contrato de pacote de navegador, sem montar um módulo na campanha. Não combine system e locales nem declare en como substituição.

Erros e limites

JSON inválido de idioma/catálogo, variáveis de interpolação alteradas ou combinação system/locales são rejeitados na instalação. Ativação global exige proprietário. Idiomas instalados ficam fora da seleção de módulos da campanha.

Como validar

• Valide os dois catálogos não vazios com o validador nativo.

• Troque de conta e confira que cada uma conserva a própria escolha explícita.

• Confira alternativa em inglês para chaves ausentes e preservação de texto autoral.

Como usar a IA neste exemplo

Amplie os catálogos language-demo com [textos da interface] do host atual. Preserve variáveis e alternativa em inglês, use chaves alinhadas em pt-BR/es e mantenha conteúdo autoral e avisos legais exatos. Valide com o parser nativo e troca real de idioma por conta.