Configuração e manifestos

Veja versões, mudanças e requisitos em Framework 4.0 e CLI 1.2.

Dois documentos com autoridades diferentes

A configuração de wu.init() pertence ao shell. wu.json pertence a uma aplicação e é baixado de <url>/wu.json. O manifesto solicita recursos; o shell concede a autoridade máxima. Nenhum campo do manifesto pode conceder permissões a si mesmo.

import { wu } from 'wu-framework';

await wu.init({
  sandbox: 'module',
  strictEvents: true,
  strictFallback: false,
  manifestPolicy: { imports: 'error' },
  apps: [{
    name: 'catalog',
    url: '/apps/catalog',
    framework: 'react',
    container: '#catalog-slot',
    keepAlive: false,
    grants: [
      { capability: 'store.read', resource: 'catalog' },
      { capability: 'events.emit', resource: 'catalog:selected' },
    ],
  }],
});

container configura um destino que wu.app() pode aproveitar. A chamada explícita wu.mount('catalog', '#catalog-slot') mantém visível o destino de cada montagem.

Opções globais

init agrupa chamadas concorrentes, aguarda a instalação de plugins, registra apps e valida imports após o registro completo. Uma inicialização malsucedida reverte os registros criados nessa tentativa. Após uma inicialização bem-sucedida, outra chamada a init emite aviso e termina: não constitui uma API para substituir a configuração a quente.

whenReady() retorna uma promise com booleano. Se ninguém iniciou o WU, retorna false; se houver uma inicialização pendente, aguarda seu resultado. mount() já aguarda um init em andamento.

Manifesto completo e válido

{
  "name": "catalog",
  "version": "1.2.0",
  "entry": "assets/catalog.js",
  "styleMode": "own-only",
  "wu": {
    "exports": { "ProductCard": "components/product-card.js" },
    "imports": [],
    "permissions": [
      { "capability": "store.read", "resource": "catalog", "required": true },
      { "capability": "events.emit", "resource": "catalog:selected" }
    ],
    "roles": ["catalog-reader"]
  },
  "metadata": {
    "description": "Explorador del catálogo",
    "routes": ["/catalog", "/catalog/:id"]
  }
}

Os campos superiores aceitos são name, entry, wu, metadata, styleMode, version, folder e roles. Dentro de wu, são reconhecidos exports, imports, permissions, roles e o nome histórico routes, embora rotas não vazias ali sejam rejeitadas na normalização do Framework 4. Use metadata.routes para informações descritivas.

framework, sandbox, grants, domOwnership e keepAlive pertencem à configuração do shell. Campos extras não são aceitos indiscriminadamente: guarde metadados próprios dentro de metadata.

Regras de carregamento e validação

Um 404 real permite gerar o manifesto padrão com entry: 'index.js' e permissões vazias. Um erro de rede, um 500, um JSON inválido ou uma página HTML retornada como manifesto produz erro. Isso evita que um servidor mal configurado seja interpretado como aplicação sem manifesto.

A validação verifica se o nome baixado corresponde ao registrado. Inspeciona propriedades próprias, rejeita accessors e estruturas perigosas e entrega um snapshot congelado. Não use manifest.wu.permissions.push(...) para alterar a política após o registro.

Permissões: sintaxe exata

Uma declaração de objeto exige capability e resource explícito. A forma string válida é, por exemplo, store.read:catalog. Use um objeto para declarar também required; use uma string quando precisar apenas de capacidade e recurso.

// Solicitud de la aplicación:
const permission = {
  capability: 'store.read',
  resource: 'catalog',
  required: true,
};

// Dos formas equivalentes de conceder esa lectura desde el host:
const objectGrant = { capability: 'store.read', resource: 'catalog' };
const stringGrant = 'store.read:catalog';

store.read sozinho não é uma declaração válida para o parser. A declaração TypeScript de entrada permite alguns valores mais amplos, por isso é necessário preencher o recurso explicitamente mesmo quando o editor não exige.

required é false por padrão. Uma permissão opcional negada fica documentada nos diagnósticos e sua operação será rejeitada se for tentada. required: true faz o registro falhar quando o shell não cobre toda a solicitação.

Estratégia de carregamento, layout e estilos

strategy seleciona como antecipar o carregamento de uma aplicação; consulte carregamento e pré-carregamento para escolher entre carregar ao montar, importar de imediato ou antecipar recursos. fullBleed controla se a app ocupa a altura do host ou flui com o conteúdo. Ambos os campos são lidos na configuração da aplicação, embora não estejam listados em WuAppConfig.

Configure styleMode no manifesto. A montagem entrega app.manifest.styleMode ao sandbox; o campo de mesmo nome na configuração superior do host não o substitui. O guia de sandbox e CSS explica como combinar estilos próprios e compartilhados.

Referência de implementação

Implementação: src/core/wu-core.js, src/core/wu-core.js, src/core/wu-core.js; parser e limites: src/core/wu-manifest.js, src/core/wu-manifest.js, src/core/wu-manifest.js; política: src/core/wu-policy.js e src/core/wu-policy.js. Testes: tests/unit/manifest-policy.test.js, tests/unit/manifest-dependencies.test.js, tests/unit/init-race.test.js.