@oondemand/create-central-oon 0.5.5 → 0.6.0

package/README.md

@@ -1,141 +1,93 @@
 # @oondemand/create-central-oon
 
-Gerador de **Centrais Oon declarativas**. Cria backend e frontend prontos para consumir `@oondemand/oon-core-back` e `@oondemand/oon-core-front`, sem copiar shell, autenticação, páginas genéricas ou infraestrutura para a Central.
+Gerador estrutural de Apps Oon. Ele cria backend e frontend code-first prontos
+para consumir `@oondemand/oon-core-back` e `@oondemand/oon-core-front`.
 
 ## Uso
 
 ```bash
 npx create-central-oon central-transtour
-npx create-central-oon central-transtour --template=servicos-tomados
-npx create-central-oon --list
 ```
 
-Aliases: o binário também responde por `scaffold-central-oon`.
+O gerador possui uma única base `_base`. Não há seleção ou catálogo de
+templates funcionais. O binário também responde por `scaffold-central-oon`.
 
 ## Contrato `central.app.json`
 
-Toda Central gerada possui um manifesto raiz com identidade e capabilities:
-
 ```json
 {
   "$schema": "./node_modules/@oondemand/create-central-oon/schemas/central.app.schema.json",
-  "schemaVersion": 1,
+  "schemaVersion": 2,
   "id": "central-exemplo",
   "name": "Central Exemplo",
   "slug": "central-exemplo",
   "appKind": "member-central",
+  "accessMode": "private",
+  "authorization": { "mode": "tenant_members" },
   "modules": {
-    "collections": true,
+    "collections": false,
     "documents": false,
     "pipelines": false,
-    "integrations": false,
-    "omie": false,
     "assistants": false,
     "currencies": false
   },
-  "capabilities": ["core.collections"],
+  "capabilities": [],
   "compatibility": {
     "core": {
-      "minVersion": "0.5.0",
-      "maxVersionExclusive": "0.6.0"
+      "minVersion": "0.6.0",
+      "maxVersionExclusive": "0.7.0"
     }
   }
 }
 ```
 
-O schema versionado é publicado no pacote em:
+O manifesto contém identidade, política de acesso, capacidades de plataforma e
+compatibilidade. Rotas, menus, páginas, componentes, layouts e temas ficam no
+código do frontend, para qualquer `appKind`.
+
+## Estrutura gerada
 
 ```txt
-@oondemand/create-central-oon/schemas/central.app.schema.json
+<app>/
+├── central.app.json
+├── package.json
+├── backend/
+│   ├── central.config.js
+│   ├── central.domain.json
+│   └── src/{validations,triggers,hooks,mappings,rules}/
+└── frontend/
+    └── src/
+        ├── main.tsx
+        ├── app/{app,routes,navigation,theme}.tsx
+        ├── pages/
+        ├── components/
+        ├── features/
+        └── layouts/
 ```
 
-Responsabilidades do manifesto:
-
-- identidade estável (`id`, `name`, `slug`);
-- perfil arquitetural (`appKind`);
-- módulos e capabilities habilitados;
-- faixa compatível do OonCore;
-- metadados declarativos de ativação.
-
-`backend/central.config.js` fica reservado a extensões excepcionais de runtime. Em Centrais `member-central` e `portal-cockpit`, identidade, módulos e autenticação não podem ser reintroduzidos nesse arquivo. O desenvolvimento local usa sessão aleatória HttpOnly; tokens fixos são reprovados pela conformidade.
+O bootstrap gerado chama `startOonApp(app)`. A composição é feita com
+`defineOonApp`, `defineOonRoutes` e `defineOonNavigation`.
 
-## Verificação de conformidade
-
-Na raiz da Central:
+## Conformidade
 
 ```bash
 npm run ooncore:conformance
-```
-
-ou:
-
-```bash
-npx create-central-oon conformance
 npx create-central-oon conformance --json
 ```
 
-O comando falha quando encontra, entre outros desvios:
-
-- ausência ou incompatibilidade de `central.app.json`;
-- transformações ou registries no bootstrap do frontend;
-- páginas genéricas e extensões executáveis locais;
-- identidade ou autenticação reintroduzida em `central.config.js`;
-- models técnicos de integração;
-- workers, runtimes, locks, clients Omie ou registries locais;
-- patches de métodos do Mongoose;
-- arquivos com extensões fora da allowlist.
-
-A CI de uma Central deve executar o comando antes do build e da publicação.
+A verificação exige schema v2 e bootstrap code-first, protege rotas reservadas,
+guards de segurança e imports internos, e rejeita código remoto, segredos no
+bundle e dependências fora do frontend.
 
-## Documentação distribuída para IA/Agents
+## Documentação
 
-O pacote inclui documentação canônica em `docs/`. Ao criar uma Central, o CLI gera `.ooncore/` como cache local da documentação da versão instalada.
+O pacote distribui documentação canônica em `docs/`. O comando abaixo atualiza
+o cache `.ooncore/` usado por ferramentas de desenvolvimento:
 
 ```bash
 npm run ooncore:docs
 npm run ooncore:docs:check
 ```
 
-`.ooncore/AGENTS.md` é a entrada neutra e `.ooncore/docs/` contém os contratos completos de backend, frontend e capacidades. A pasta pode ser regenerada a partir do pacote npm sem sobrescrever o `AGENTS.md` da raiz.
-
-## Templates funcionais
-
-| Template | O que gera |
-| --- | --- |
-| `basic` | Uma coleção dinâmica (`Pessoa`). |
-| `omie-sidecar` | Estrutura declarativa inicial para mapping Omie. |
-| `servicos-tomados` | Prestadores e esteira por status. |
-| `servicos-prestados` | Clientes e esteira por etapa. |
-| `pedidos-marketplace` | Catálogo e esteira de pedidos. |
-| `documentos-fiscais` | Documento fiscal com aprovação. |
-| `multi-moedas` | Moedas e cotações. |
-
-## Estrutura gerada
-
-```txt
-<central>/
-├── central.app.json            # identidade, appKind, módulos e capabilities
-├── package.json                # docs, conformance e comandos locais
-├── .ooncore/                   # cache regenerável da documentação
-├── backend/
-│   ├── central.config.js       # somente extensão excepcional de runtime
-│   ├── central.domain.json     # domínio declarativo
-│   └── src/{validations,triggers,hooks,mappings,rules}/
-└── frontend/
-    ├── central.ui.json         # telas, formulários, grids e esteiras
-    └── src/main.tsx            # bootstrap mínimo gerado
-```
-
-O bootstrap gerado importa `central.app.json` e `central.ui.json` e chama `startCentralFromManifest`. Não deve transformar manifestos, registrar componentes padrão nem conhecer regras de um cliente.
-
-## Próximos passos
-
-```bash
-cd <central>
-npm run check
-cp backend/.env.example backend/.env
-cp frontend/.env.example frontend/.env
-npm run dev
-```
+Consulte `docs/FRONTEND_CODE_FIRST.md` para o contrato completo.
 
-Evoluir a Central significa declarar domínio, UI, mappings e regras específicas. O OonCore implementa como a aplicação funciona.

package/bin/cli.js

@@ -1,17 +1,15 @@
 #!/usr/bin/env node
 "use strict";
 
-const { run, listTemplates, syncDocs, checkDocs, runLocalDevelopment } = require("../src/index");
+const { run, syncDocs, checkDocs, runLocalDevelopment } = require("../src/index");
 const { checkConformance } = require("../src/conformance");
 
 function parseArgs(argv) {
   const opts = {
     command: null,
-    template: "basic",
     here: false,
     force: false,
     install: true,
-    list: false,
     docsSync: false,
     docsCheck: false,
     json: false,
@@ -24,15 +22,13 @@ function parseArgs(argv) {
     if (arg === "--here") opts.here = true;
     else if (arg === "--force") opts.force = true;
     else if (arg === "--no-install") opts.install = false;
-    else if (arg === "--list") opts.list = true;
     else if (arg === "--sync") opts.docsSync = true;
     else if (arg === "--check") opts.docsCheck = true;
     else if (arg === "--json") opts.json = true;
     else if (arg.startsWith("--root=")) opts.root = arg.slice("--root=".length);
     else if (arg === "--root") { opts.root = argv[i + 1]; i += 1; }
-    else if (arg.startsWith("--template=")) opts.template = arg.slice("--template=".length);
-    else if (arg === "--template") { opts.template = argv[i + 1]; i += 1; }
     else if (!arg.startsWith("-")) positionals.push(arg);
+    else throw new Error(`Opção desconhecida: ${arg}.`);
   }
 
   if (["docs", "conformance", "dev"].includes(positionals[0])) {
@@ -45,24 +41,15 @@ function parseArgs(argv) {
 
 function printUsage() {
   console.error("Uso:");
-  console.error("  npx create-central-oon <nome-da-central> [--template=basic]");
-  console.error("  npx create-central-oon --list");
+  console.error("  npx create-central-oon <nome-do-app>");
   console.error("  npx create-central-oon docs sync|check");
   console.error("  npx create-central-oon conformance [--root .] [--json]");
   console.error("  npx create-central-oon dev");
 }
 
 async function main() {
-  const opts = parseArgs(process.argv.slice(2));
-  if (opts.list) {
-    console.log("Templates disponíveis:\n");
-    for (const template of listTemplates()) {
-      console.log(`  ${template.id.padEnd(20)} ${template.description}`);
-    }
-    return;
-  }
-
   try {
+    const opts = parseArgs(process.argv.slice(2));
     if (opts.command === "docs") {
       if (opts.docsCheck) checkDocs();
       else syncDocs();

package/docs/ADVANCED_UX_PATTERNS.md

@@ -1,6 +1,7 @@
 # ADVANCED_UX_PATTERNS.md — UX Avançada Declarativa no OonCore
 
-Este documento orienta Agents a usarem o máximo de recursos do OonCore antes de criar telas customizadas. O foco é transformar padrões recorrentes de sistemas operacionais em **manifesto declarativo** e componentes reutilizáveis.
+Este documento orienta Agents a usarem os componentes públicos do OonCore e a
+composição code-first antes de recriar padrões operacionais.
 
 ## Objetivo
 
@@ -22,7 +23,7 @@ Caso de referência: `OrcamentoProjeto -> OrcamentoItem -> Pagamento`.
 
 Antes de criar uma página React customizada, verifique se a necessidade pode ser resolvida por:
 
-1. `collections[]` no `central.ui.json`.
+1. Views `collection` em `defineOonApp({ ui })`.
 2. `list.filters` e `list.rowActions`.
 3. `detailModal.tabs`.
 4. `form.groups`.

package/docs/AGENTS.md

@@ -8,7 +8,7 @@ Este arquivo é o contrato inicial neutro para Codex, ChatGPT, Kimi, Manus e out
 2. Confirme `schemaVersion`, `version`, `docsHash` e `entrypointsHash` em `.ooncore/manifest.json`.
 3. Rode `npm run ooncore:docs:check`; se falhar, rode `npm run ooncore:docs` e verifique novamente.
 4. Consulte `docs/CAPABILITIES.md` antes de criar código.
-5. Leia os contratos de backend, frontend, runtime, RBAC ou integração indicados abaixo.
+5. Leia os contratos de backend, frontend, runtime ou RBAC indicados abaixo.
 6. Leia a documentação de domínio do projeto consumidor.
 
 O `AGENTS.md` da raiz pertence ao projeto e nunca pode ser sobrescrito pelo scaffold ou pelo sync do Core.
@@ -18,17 +18,16 @@ O `AGENTS.md` da raiz pertence ao projeto e nunca pode ser sobrescrito pelo scaf
 | Tarefa | Leitura obrigatória |
 |---|---|
 | Domínio, models, validações e fórmulas | `BACKEND_API.md`, `BACKEND_DOMAIN_MANIFEST.md`, `BACKEND_PATTERNS.md`, `REACTIVE_DOMAIN_FORMULAS.md` |
-| CRUD, metadata e UI | `METADATA_CRUD_UI.md`, `FRONTEND_API.md`, `FRONTEND_MANIFEST_REFERENCE.md` |
+| CRUD, metadata e UI | `METADATA_CRUD_UI.md`, `FRONTEND_API.md`, `FRONTEND_CODE_FIRST.md` |
 | Auth, ativação, tenant ou permissões | `AUTH_ACTIVATION_RBAC.md`, `RBAC_SECURITY.md`, `DO_AND_DONT.md` |
 | Execução local | `RUNTIME_MODES.md`, `LOCAL_DEVELOPMENT.md`, `LOCAL_SECURITY_BOUNDARY.md` |
 | Rotas, hooks, jobs e filas | `ROUTES_HOOKS_WORKERS.md`, `BACKEND_PATTERNS.md` |
-| Integrações | `CONNECTORS_AND_INTEGRATIONS.md`, `LOCAL_SECURITY_BOUNDARY.md` |
 | Upgrade do Core | `CORE_UPGRADE.md`, `TESTING_CONFORMANCE.md`, `releases/0.5.0.md` |
 | UX avançada | `ADVANCED_UX_PATTERNS.md`, `DETAIL_MODAL_AND_RELATED_GRIDS.md`, `PORTAL_COCKPIT_PATTERNS.md` |
 
 ## Fronteira obrigatória
 
-- A Central declara domínio e experiência; o Core fornece bootstrap, autenticação, ativação, RBAC, tenant, CRUD, metadata, shell, componentes genéricos, integração operacional e deployment.
+- O App declara domínio e experiência em código; o Core fornece bootstrap, autenticação, ativação, RBAC, tenant, CRUD, metadata, shell, componentes genéricos e deployment.
 - Use somente exports públicos documentados. Arquivos internos de `src/` não são contrato de extensão.
 - Autorização, tenant e regras que alteram dados são sempre validados no backend.
 - Não crie autenticação, ativação, RBAC, CRUD, shell, registry ou infraestrutura paralelos.

package/docs/BACKEND_API.md

@@ -7,7 +7,7 @@ Importe exclusivamente de `@oondemand/oon-core-back`. Caminhos internos não tê
 - `start(options)`: carrega a Central, conecta Mongo, inicializa capabilities e inicia HTTP. `options.listen=false` devolve somente o app.
 - `createApp()`: cria o Express já protegido e com rotas do Core.
 - `activate()`: fluxo legado de ativação; não é usado no runtime local.
-- `defineCentral`, `defineModel`, `defineCollection`, `defineDocument`, `definePipeline`, `defineOmieMapping`, `defineRoutes`, `defineValidation`, `defineTrigger`: extensões imperativas suportadas.
+- `defineCentral`, `defineModel`, `defineCollection`, `defineDocument`, `definePipeline`, `defineRoutes`, `defineValidation`, `defineTrigger`: extensões imperativas suportadas.
 - `fields`: factories de campos compatíveis com schema e metadata.
 - `registry`: registry do processo; use APIs `define*`, não mutações internas.
 
@@ -27,10 +27,8 @@ Importe exclusivamente de `@oondemand/oon-core-back`. Caminhos internos não tê
 
 Erros de manifesto carregam `code`, `statusCode` e `issues[]` com `path` e `message`.
 
-## Integrações e capabilities
+## Capabilities
 
-- `integrations`, `registerIntegrationProvider`, `enqueueIntegration`, `receiveIntegrationWebhook`.
-- `omie`, `omieModule`, `createOmieClient`, `OmieApiError`, `enqueueOmieCall`, `ensureOmieProviderRegistered`, `collectOmieDefinitions`, `describeOmieDefinitions`, `saveOmieConfiguration`, `listOmieConfigurations`, `testOmieConnection`.
 - `capabilities`, `PdfRenderingError`, `TransactionalEmailError`.
 - `operationalRequestHeaders(options)`: headers de identidade do Deployment. Retorna `LOCAL_OPERATION_NOT_SUPPORTED` no runtime local; nunca improvise identidade local.
 

package/docs/BACKEND_PATTERNS.md

@@ -16,7 +16,6 @@ backend/
     ├── mappings/
     ├── documents/
     ├── pipelines/
-    ├── integrations/
     ├── routes/
     ├── controllers/
     └── services/
@@ -24,7 +23,7 @@ backend/
 
 ## Models
 
-Use models para declarar entidades de negócio. Cada model deve ser pequeno, com nomes claros e campos compatíveis com as telas e integrações.
+Use models para declarar entidades de negócio. Cada model deve ser pequeno, com nomes claros e campos compatíveis com as telas e processos.
 
 Boas práticas:
 

package/docs/BACKEND_PROCESS_MANIFEST.md

@@ -6,7 +6,7 @@ Ele complementa:
 
 - `central.app.json`: identidade, módulos e capabilities da aplicação;
 - `backend/central.domain.json`: models, campos, fórmulas do próprio registro e validações locais;
-- `frontend/central.ui.json`: projeção visual, coleções, esteiras e ações exibidas.
+- `frontend/src/app`: composição code-first de coleções, esteiras e ações exibidas.
 
 O manifesto de processos é carregado **depois** do domínio. Por isso, toda model e todo campo citados precisam existir em `central.domain.json`.
 
@@ -51,16 +51,16 @@ O runtime não executa JavaScript, `eval`, nomes de funções ou módulos inform
       }
     ],
     "lockedFieldsByStage": {
-      "Enviado para Omie": ["valor", "projetoId", "projetoItemId"],
+      "Enviado para pagamento": ["valor", "projetoId", "projetoItemId"],
       "Pagamento Ok": ["valor", "projetoId", "projetoItemId"]
     },
     "lockedMessage": "Os dados de negócio ficam bloqueados nesta etapa.",
     "onEnter": [
       {
-        "stage": "Enviado para Omie",
+        "stage": "Enviado para pagamento",
         "set": {
           "statusTrabalho": "Trabalhando",
-          "omieStatusIntegracao": "Pendente"
+          "statusPagamento": "Pendente"
         }
       }
     ],
@@ -69,7 +69,7 @@ O runtime não executa JavaScript, `eval`, nomes de funções ou módulos inform
         "when": {
           "op": "eq",
           "args": [
-            { "field": "omieLiquidado" },
+            { "field": "pagamentoLiquidado" },
             { "value": true }
           ]
         },
@@ -253,4 +253,4 @@ Permanece na Central:
 - integrações e mapeamentos particulares;
 - mensagens e condições próprias do processo.
 
-A Central declara essas particularidades usando o contrato; não reimplementa o mecanismo.
+A Central declara essas particularidades usando o contrato; não reimplementa o mecanismo.

package/docs/CAPABILITIES.md

@@ -4,7 +4,7 @@ Consulte este catálogo antes de criar infraestrutura ou componentes customizado
 
 | Capacidade | Backend | Frontend | Declaração/extensão | Local | Plataforma |
 |---|---|---|---|---|---|
-| Models e CRUD | `defineModel`, domain manifest, `/core/*` | `CoreCollection`, hooks de API | `central.domain.json`, `central.ui.json` | Sim | Sim |
+| Models e CRUD | `defineModel`, domain manifest, `/core/*` | `CoreCollection`, hooks de API | `central.domain.json`, composição code-first | Sim | Sim |
 | Metadata | registry e `/core/metadata` | `useCoreMetadata`, renderers | models/domain manifest | Sim | Sim |
 | Validações e fórmulas | `defineValidation`, domain rules | prévia reativa | domain manifest/validation | Sim | Sim |
 | Esteiras | process manifest/runtime | `CorePipeline` | `central.process.json`, UI manifest | Sim | Sim |
@@ -14,8 +14,7 @@ Consulte este catálogo antes de criar infraestrutura ou componentes customizado
 | Tenant e escopo | access context e scope helpers | `TenantProvider` | `central.app.json` | Contexto técnico | Contexto autorizado |
 | Auditoria | CRUD e request context | headers do SDK | automática/extensão | Local | Operacional |
 | Rotas customizadas | `defineRoutes` | página/ação declarada | `backend/src/routes` | Sim | Sim |
-| Jobs e workers | process/integration workers | status operacional | manifestos/hooks | Sim | Sim |
-| Integrações | runtime/provider registry | `CoreIntegration` | mapping/provider suportado | Dublê ou credencial local | Credencial operacional |
+| Jobs e workers | process workers | status operacional | manifestos/hooks | Sim | Sim |
 | E-mail transacional | capability nativa | `CoreTransactionalEmail` | capability settings | Dublê/local | Provider configurado |
 | PDF | capability nativa | consumo por ação | capability contract | Dublê/local | Provider configurado |
 | Publicação/promoção | contratos de delivery | indisponível no App | CLI/ponte pública | Não | Sim |

package/docs/CHECKLIST_IMPLEMENTACAO.md

@@ -11,7 +11,7 @@ Use este checklist antes de concluir qualquer tarefa de codificação em uma Cen
 
 ## Backend
 
-- [ ] Usei model, validation, trigger, hook, mapping ou integration quando aplicável.
+- [ ] Usei model, validation, trigger, hook ou mapping quando aplicável.
 - [ ] Evitei recriar CRUD.
 - [ ] Validei entrada.
 - [ ] Validei permissão no backend.
@@ -21,9 +21,9 @@ Use este checklist antes de concluir qualquer tarefa de codificação em uma Cen
 
 ## Frontend
 
-- [ ] Usei `central.ui.json` antes de criar componente customizado.
-- [ ] Evitei recriar shell, rotas, menu, datagrid ou form.
-- [ ] Usei override apenas quando necessário.
+- [ ] Defini o App com `defineOonApp` e `startOonApp`.
+- [ ] Reutilizei shell, guards, primitives e padrões públicos do Core.
+- [ ] Mantive rotas, navegação, páginas, layouts e temas no código do App.
 - [ ] Não coloquei regra crítica apenas no frontend.
 
 ## Integrações

package/docs/FRONTEND_API.md

@@ -1,34 +1,31 @@
 # API pública do `@oondemand/oon-core-front`
 
-Importe exclusivamente da raiz do pacote.
+O contrato principal do frontend é code-first.
 
-## Bootstrap e manifestos
+## Bootstrap
 
-- `start`, `oonCoreFront.start`: inicialização com configuração completa.
-- `startFromManifest`, `startCentralFromManifest`, `manifestToConfig`: caminho preferencial para uma Central declarativa.
-- Tipos: `CentralUiManifest`, `CentralAppManifest`, `CentralManifestBundle`, `CentralUiOnlyManifest`, `ManifestRuntime`.
-- `ManifestRuntime.runtimeMode`: `local` usa sessão HttpOnly; `platform` usa o contrato de autenticação publicado.
+- `defineOonApp`: define identidade, API, rotas, navegação, shell, layouts, páginas, componentes e temas.
+- `startOonApp`: valida e monta o App React.
+- `defineOonRoutes`, `defineOonNavigation`: helpers tipados para composição local.
 
-## Views e componentes
+## Subpaths públicos
 
-- Definições: `defineCollectionView`, `defineDocumentView`, `definePipelineView`, `defineDashboard`, `defineOonModule`.
-- Componentes: `CoreCollection`, `CoreDocument`, `CorePipeline`, `CoreIntegration`, `CoreCurrency`, `CoreAssistant`, `CoreDashboard`, `CoreUsersAccess`, `CoreTransactionalEmail`, `CorePage`.
-- Primitivas UI v2: `CorePageHeader`, `CoreToolbar`, `CoreDataGrid`, `CoreCards`, `CoreForm`, `CoreField`, `CoreRelationField`, `CoreActions`, `CoreEmptyState`, `CoreLoadingState`.
-- Registre componentes customizados por chave em `registry`; não serialize React no JSON.
+- `/ui`: primitives, padrões e componentes de domínio;
+- `/routing`: rotas, navegação e helpers;
+- `/theme`: temas, tokens e seleção em runtime;
+- `/hooks`: hooks de autenticação, tenant, API e metadata;
+- `/testing`: utilitários de teste.
 
-## Hooks, sessão e autorização
+## Segurança
 
-- `useOonAuth`, `can`, `PermissionGate`, `Can`: experiência baseada em permissões já resolvidas pelo backend.
-- `useOonTenant`, `createTenantStorage`: seleção de tenant; o backend continua sendo a autoridade.
-- `useOonApi`, `useOonResource`, `useCoreMetadata`, `useModelSchema`: acesso HTTP/metadata padronizado.
-- O runtime local não grava bearer no `localStorage`, envia cookie com `withCredentials` e usa CSRF double-submit nas mutações.
+- `useOonAuth`, `can`, `PermissionGate`, `Can`: permissões resolvidas pelo backend;
+- `useOonTenant`, `createTenantStorage`: contexto tenant quando aplicável;
+- `useOonApi`, `useOonResource`, `useCoreMetadata`, `useModelSchema`: acesso padronizado;
+- rotas reservadas e guards obrigatórios pertencem ao Core.
 
-## Domínio reativo
+## Domínio e UI
 
-- `DomainExpressionError`, `evaluateDomainExpression`, `applyReactiveFormulas`, `buildDomainMutationPayload`, `coerceDomainFormValue`.
-- Tipos `OonDomainExpression`, `OonComputedFieldDefinition`, `OonReactiveFormField` e `ReactiveFormulaResult`.
-- A prévia do frontend nunca substitui o recálculo e a validação do backend.
+Views declarativas continuam disponíveis como composição opcional dentro do
+objeto App. Componentes, páginas e layouts locais podem ser usados em qualquer
+`appKind`. Consulte `FRONTEND_CODE_FIRST.md`.
 
-## Tipos públicos
-
-Os tipos exportados incluem config, app, auth, runtime, módulos, rotas, menus, UI v1/v2, layout, registry, páginas, blocos, ações, views, campos, metadata, paginação, erros e usuário. Consulte `dist/index.d.ts` da versão instalada quando precisar da assinatura exata; ele faz parte do pacote público.

package/docs/FRONTEND_CODE_FIRST.md

@@ -0,0 +1,35 @@
+# Frontend code-first
+
+O frontend de todo App Oon é composto em TypeScript/React. O `appKind` não
+limita páginas, componentes, layouts ou temas locais.
+
+```tsx
+import { defineOonApp, startOonApp } from "@oondemand/oon-core-front";
+import { defineOonNavigation, defineOonRoutes } from "@oondemand/oon-core-front/routing";
+import { HomePage } from "./pages/HomePage";
+
+const routes = defineOonRoutes([{ path: "/", element: <HomePage /> }]);
+const navigation = defineOonNavigation([{ id: "home", label: "Início", to: "/" }]);
+
+startOonApp(defineOonApp({
+  app: { id: "meu-app", name: "Meu App" },
+  api: { baseUrl: import.meta.env.VITE_API_URL },
+  routes,
+  navigation,
+}));
+```
+
+Rotas aceitam `element`, `component`, `lazy`, `layout`, `permissions` e
+`capabilities`. Rotas de autenticação e estados de ativação são reservadas.
+
+Use os subpaths públicos:
+
+- `@oondemand/oon-core-front/ui` para primitives e padrões;
+- `@oondemand/oon-core-front/routing` para rotas e navegação;
+- `@oondemand/oon-core-front/theme` para temas;
+- `@oondemand/oon-core-front/hooks` para hooks;
+- `@oondemand/oon-core-front/testing` para testes.
+
+Não carregue código remoto, não desative guards, não exponha segredos no bundle
+e não importe arquivos internos do pacote. Rode `npm run ooncore:conformance`.
+

package/docs/FRONTEND_PATTERNS.md

@@ -1,27 +1,28 @@
 # Padrões Frontend
 
-O frontend da Central deve ser declarativo. Shell, providers, rotas, menu, datagrid, formulários, documentos, esteiras, modais de detalhe e grids relacionados pertencem ao `@oondemand/oon-core-front`.
+O frontend do App é code-first. Shell, providers e guards pertencem ao
+`@oondemand/oon-core-front`; rotas, navegação, páginas, componentes, layouts e
+temas são compostos localmente com as APIs públicas do Core.
 
-Para a lista completa de opções do manifesto, use `FRONTEND_MANIFEST_REFERENCE.md`.
+Para o contrato completo, use `FRONTEND_CODE_FIRST.md`.
 Para UX avançada com abas e itens relacionados, use também `ADVANCED_UX_PATTERNS.md` e `DETAIL_MODAL_AND_RELATED_GRIDS.md`.
 
 ## Estrutura esperada
 
 ```txt
 frontend/
-├── central.ui.json
 └── src/
     ├── main.tsx
-    ├── collections/
-    ├── documents/
-    ├── pipelines/
-    ├── dashboards/
-    └── overrides/
+    ├── app/{app,routes,navigation,theme}.tsx
+    ├── pages/
+    ├── components/
+    ├── features/
+    └── layouts/
 ```
 
-## central.ui.json
+## Composição
 
-Use `central.ui.json` como entrada principal para declarar:
+Use o objeto criado por `defineOonApp` para compor:
 
 - menu;
 - coleções;
@@ -43,11 +44,8 @@ Use `central.ui.json` como entrada principal para declarar:
 - edição inline;
 - ações por linha.
 
-## Manifesto v1 e v2
-
-- Manifesto sem `schemaVersion` mantém compatibilidade v1.
-- Manifesto com `schemaVersion: 2` habilita composição por `layout`, `navigation`, `pages`, `blocks`, coleções avançadas e componentes declarativos.
-- Componentes React não devem ser serializados no JSON; use chaves e registre os componentes no `registry` em TypeScript.
+Views e blocos declarativos continuam opcionais para telas simples, dentro do
+objeto code-first. Componentes React são registrados diretamente em TypeScript.
 
 ## Padrão de tela operacional
 

package/docs/METADATA_CRUD_UI.md

@@ -3,7 +3,7 @@
 1. `central.domain.json` ou `defineModel` registra model, campos, CRUD, roles e metadata.
 2. O backend expõe `/core/metadata`, `/core/models` e o router CRUD do `basePath`.
 3. Escopo de tenant/usuário, validação, fórmulas, referência, auditoria e triggers são aplicados no servidor.
-4. `central.ui.json` declara coleções, formulários, filtros, relações, esteiras, documentos e dashboards.
+4. O objeto code-first do App compõe coleções, formulários, filtros, relações, esteiras, documentos e dashboards.
 5. O frontend consulta metadata e monta componentes do Core.
 
 O CRUD padrão inclui listagem paginada, leitura, criação, atualização parcial, exclusão e import/export quando habilitados. Use rota customizada somente quando a operação não puder ser representada por CRUD, ação declarativa ou processo.