@oondemand/create-central-oon 0.5.1 → 0.5.3

package/docs/FRONTEND_MANIFEST_REFERENCE.md

@@ -444,3 +444,44 @@ Tipos de aba:
 - `customComponent`: chave de componente registrado.
 
 `apiAction.endpoint` aceita `:id`, `:parentId`, `:fieldName` e `:parent.fieldName`. `refresh` aceita `self`, `parent`, `all` ou ids de abas.
+
+
+## Opções remotas em campos de formulário
+
+Campos `enum` podem carregar opções de um endpoint dependente do formulário atual ou do registro pai. O contrato funciona em formulários principais e em criação/edição de `relatedGrid`.
+
+```ts
+{
+  field: "roleCode",
+  label: "Perfil",
+  kind: "enum",
+  optionsEndpoint: "/control-plane/app-role-catalogs/:appId?tenantId=:parentId",
+  optionsResponsePath: "options",
+  optionsValueField: "value",
+  optionsLabelField: "label",
+  optionsDescriptionField: "description",
+  optionsEditablePath: "editable",
+  optionsDependsOn: ["appId", "tenantId"],
+  fallbackOptions: [{ value: "admin", label: "Administrador" }],
+  readonlyOnFallback: true,
+  optionsUnavailableMessage: "Catálogo indisponível; perfil admin aplicado."
+}
+```
+
+| Campo | Uso |
+| --- | --- |
+| `optionsEndpoint` | Endpoint relativo. Aceita `:field`, `:parentId` e `:parent.field`; valores são codificados para URL. |
+| `optionsResponsePath` | Caminho da lista na resposta. Sem valor, a própria resposta deve ser um array. |
+| `optionsValueField` | Campo usado como valor da opção; padrão `value`. |
+| `optionsLabelField` | Campo usado como rótulo; padrão `label`. |
+| `optionsDescriptionField` | Campo opcional de descrição. |
+| `optionsEditablePath` | Booleano remoto que permite ou bloqueia a edição. |
+| `optionsDependsOn` | Campos que precisam estar preenchidos e cuja mudança invalida a seleção atual. |
+| `fallbackOptions` | Opções seguras usadas quando o endpoint falha ou retorna lista vazia. |
+| `readonlyOnFallback` | Bloqueia a seleção durante o fallback; padrão `true`. |
+| `optionsUnavailableMessage` | Mensagem explicando o fallback ao usuário. |
+| `readonly` | Bloqueia o campo em qualquer estado. |
+
+Durante a edição, a interpolação também considera os valores iniciais completos do registro, inclusive campos somente leitura que não são renderizados no formulário. Valores alterados pelo usuário prevalecem sobre os valores iniciais.
+
+O backend continua responsável por validar o valor selecionado. Opções remotas melhoram a experiência, mas não substituem autorização nem validação de domínio.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oondemand/create-central-oon",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/oondemand/oon-platform.git",

package/templates/_base/backend/package.json

@@ -12,6 +12,6 @@
     "deploy": "oonCore-back deploy"
   },
   "dependencies": {
-    "@oondemand/oon-core-back": "^0.5.1"
+    "@oondemand/oon-core-back": "^0.5.3"
   }
 }

package/templates/_base/frontend/package.json

@@ -11,7 +11,7 @@
     "sync:metadata": "oonCore-front sync:metadata"
   },
   "dependencies": {
-    "@oondemand/oon-core-front": "^0.5.1",
+    "@oondemand/oon-core-front": "^0.5.3",
     "@chakra-ui/react": "^3.13.0",
     "@emotion/react": "^11.14.0",
     "@tanstack/react-query": "^5.65.0",

package/templates/_base/package.json

@@ -13,6 +13,6 @@
     "dev:frontend": "npm run dev --prefix frontend"
   },
   "devDependencies": {
-    "@oondemand/create-central-oon": "0.5.1"
+    "@oondemand/create-central-oon": "0.5.3"
   }
 }