@praxisui/metadata-editor 10.0.0-rc.40 → 10.0.0-rc.42

package/README.md

@@ -130,6 +130,11 @@ Configs de authoring podem declarar `labelKey`, `hintKey`, `placeholderKey`,
 essas chaves no namespace `praxis.metadataEditor.*` e mantém o texto literal
 como fallback.
 
+Configurações de Quick View também possuem cobertura visual dedicada:
+- Na seção de apresentação de todos os campos (`field-presentation.config.ts`), `quickViewVisible` (`checkbox`) e `quickViewOrder` (`number`) permitem governar quais campos do recurso aparecem no card de Quick View e em qual ordem, enquanto `quickView.previewSurfaceId` e `quickView.detailPresentation` (`auto` | `overlay-only` | `Drawer` | `Modal` | `Route`) governam a superfície de pré-visualização e de abertura do registro.
+- Em controles de relacionamento (`entity-lookup` e `async-select`), `actions.showQuickView` e `quickViewActionLabel` governam a exibição e o rótulo acessível do botão explícito de Quick View em modo de edição.
+- Ao normalizar patches de apresentação, `FieldMetadataEditorComponent` preserva integralmente `seed.quickView.recordOpen` e demais contratos de navegação vindos do backend.
+
 Para `controlType: "array"`, o editor renderiza `array.itemSchema.fields`
 como uma lista visual estruturada de `FieldMetadata[]`. O fluxo preserva
 propriedades avançadas dos subcampos, como `options`, `optionSource`,

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-26T18:09:20.136Z",
+  "generatedAt": "2026-11-01T13:59:56.156Z",
   "packageName": "@praxisui/metadata-editor",
-  "packageVersion": "10.0.0-rc.40",
+  "packageVersion": "10.0.0-rc.42",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,
@@ -182,6 +182,12 @@
                     "presentation.badge",
                     "presentation.tooltip",
                     "presentationRules",
+                    "quickViewVisible",
+                    "quickViewOrder",
+                    "quickViewActionLabel",
+                    "actions.showQuickView",
+                    "quickView.previewSurfaceId",
+                    "quickView.detailPresentation",
                     "options",
                     "optionSource",
                     "validators",
@@ -252,6 +258,12 @@
                           "presentation.badge",
                           "presentation.tooltip",
                           "presentationRules",
+                          "quickViewVisible",
+                          "quickViewOrder",
+                          "quickViewActionLabel",
+                          "actions.showQuickView",
+                          "quickView.previewSurfaceId",
+                          "quickView.detailPresentation",
                           "options",
                           "optionSource",
                           "validators",
@@ -479,6 +491,14 @@
                     },
                     "statusToneMap": {
                       "type": "object"
+                    },
+                    "actions": {
+                      "type": "object",
+                      "properties": {
+                        "showQuickView": {
+                          "type": "boolean"
+                        }
+                      }
                     }
                   }
                 },
@@ -492,9 +512,15 @@
                         "href"
                       ]
                     },
+                    "resourceKey": {
+                      "type": "string"
+                    },
                     "surfaceId": {
                       "type": "string"
                     },
+                    "previewSurfaceId": {
+                      "type": "string"
+                    },
                     "presentation": {
                       "enum": [
                         "drawer",
@@ -626,6 +652,14 @@
                           },
                           "statusToneMap": {
                             "type": "object"
+                          },
+                          "actions": {
+                            "type": "object",
+                            "properties": {
+                              "showQuickView": {
+                                "type": "boolean"
+                              }
+                            }
                           }
                         }
                       },
@@ -639,9 +673,15 @@
                               "href"
                             ]
                           },
+                          "resourceKey": {
+                            "type": "string"
+                          },
                           "surfaceId": {
                             "type": "string"
                           },
+                          "previewSurfaceId": {
+                            "type": "string"
+                          },
                           "presentation": {
                             "enum": [
                               "drawer",
@@ -1873,9 +1913,9 @@
         {
           "chunkIndex": 1,
           "chunkKind": "authoring_manifest",
-          "content": "{\"operationId\":\"fieldMetadata.property.set\",\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"operation_card\",\"semanticSummary\":\"Set FieldMetadata property Effects: compile-domain-patch. Set this field label to Customer name.\",\"scope\":\"fieldMetadataPath\",\"target\":{\"kind\":\"fieldMetadata\",\"resolver\":\"field-metadata-json-path\",\"required\":true},\"inputContract\":{\"required\":[\"path\",\"value\"],\"properties\":[\"path\",\"value\",\"merge\"],\"semanticTerms\":[\"path\",\"value\",\"merge\",\"name\",\"label\",\"description\",\"controlType\",\"placeholder\",\"defaultValue\",\"group\",\"order\",\"required\",\"disabled\",\"readOnly\",\"hidden\",\"source\",\"transient\",\"submitPolicy\",\"hint\",\"helpText\",\"tooltip\",\"valuePresentation\",\"presentation\",\"presentation.presenter\",\"presentation.tone\",\"presentation.appearance\",\"presentation.icon\",\"presentation.label\",\"presentation.badge\",\"presentation.tooltip\",\"presentationRules\",\"options\",\"optionSource\",\"validators\",\"conditionalRequired\",\"conditionalDisplay\",\"visibleIn\",\"ariaLabel\",\"ariaDescribedBy\"]},\"effects\":[\"compile-domain-patch\"],\"affectedPaths\":[\"fieldMetadata\"],\"validators\":[{\"validatorId\":\"field-metadata-shape-canonical\",\"level\":\"error\",\"code\":\"METADATA_FIELD_SHAPE_CANONICAL\",\"description\":\"Edited metadata must remain compatible with canonical FieldMetadata.\"},{\"validatorId\":\"field-path-supported-by-editor\",\"level\":\"error\",\"code\":\"METADATA_FIELD_PATH_SUPPORTED\",\"description\":\"Edited paths must be supported by visual editor coverage or explicitly delegated.\"},{\"validatorId\":\"metadata-round-trip\",\"level\":\"error\",\"code\":\"METADATA_ROUND_TRIP\",\"description\":\"Open, edit, apply/save, reopen and runtime consume must preserve metadata.\"}],\"preconditions\":[\"field-metadata-loaded\"],\"submissionImpact\":\"affects-schema-backed-data\",\"presentationAffordances\":[],\"positiveExamples\":[{\"id\":\"set-label\",\"request\":\"Set this field label to Customer name.\",\"operationId\":\"fieldMetadata.property.set\",\"params\":{\"path\":\"label\",\"value\":\"Customer name\"},\"isPositive\":true}],\"negativeExamples\":[]}",
+          "content": "{\"operationId\":\"fieldMetadata.property.set\",\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"operation_card\",\"semanticSummary\":\"Set FieldMetadata property Effects: compile-domain-patch. Set this field label to Customer name.\",\"scope\":\"fieldMetadataPath\",\"target\":{\"kind\":\"fieldMetadata\",\"resolver\":\"field-metadata-json-path\",\"required\":true},\"inputContract\":{\"required\":[\"path\",\"value\"],\"properties\":[\"path\",\"value\",\"merge\"],\"semanticTerms\":[\"path\",\"value\",\"merge\",\"name\",\"label\",\"description\",\"controlType\",\"placeholder\",\"defaultValue\",\"group\",\"order\",\"required\",\"disabled\",\"readOnly\",\"hidden\",\"source\",\"transient\",\"submitPolicy\",\"hint\",\"helpText\",\"tooltip\",\"valuePresentation\",\"presentation\",\"presentation.presenter\",\"presentation.tone\",\"presentation.appearance\",\"presentation.icon\",\"presentation.label\",\"presentation.badge\",\"presentation.tooltip\",\"presentationRules\",\"quickViewVisible\",\"quickViewOrder\",\"quickViewActionLabel\",\"actions.showQuickView\",\"quickView.previewSurfaceId\",\"quickView.detailPresentation\",\"options\",\"optionSource\",\"validators\",\"conditionalRequired\",\"conditionalDisplay\",\"visibleIn\",\"ariaLabel\",\"ariaDescribedBy\"]},\"effects\":[\"compile-domain-patch\"],\"affectedPaths\":[\"fieldMetadata\"],\"validators\":[{\"validatorId\":\"field-metadata-shape-canonical\",\"level\":\"error\",\"code\":\"METADATA_FIELD_SHAPE_CANONICAL\",\"description\":\"Edited metadata must remain compatible with canonical FieldMetadata.\"},{\"validatorId\":\"field-path-supported-by-editor\",\"level\":\"error\",\"code\":\"METADATA_FIELD_PATH_SUPPORTED\",\"description\":\"Edited paths must be supported by visual editor coverage or explicitly delegated.\"},{\"validatorId\":\"metadata-round-trip\",\"level\":\"error\",\"code\":\"METADATA_ROUND_TRIP\",\"description\":\"Open, edit, apply/save, reopen and runtime consume must preserve metadata.\"}],\"preconditions\":[\"field-metadata-loaded\"],\"submissionImpact\":\"affects-schema-backed-data\",\"presentationAffordances\":[],\"positiveExamples\":[{\"id\":\"set-label\",\"request\":\"Set this field label to Customer name.\",\"operationId\":\"fieldMetadata.property.set\",\"params\":{\"path\":\"label\",\"value\":\"Customer name\"},\"isPositive\":true}],\"negativeExamples\":[]}",
           "sourcePointer": "projects/praxis-metadata-editor/src/lib/ai/praxis-metadata-editor-authoring-manifest.ts",
-          "contentHash": "cef5507ef8785f477a8f7b35c35aa16eb04d2d492a41b77bff023582be8088e5",
+          "contentHash": "4f7b26803c56d14364b0d1087058cee0984bb7d088bdcbea3c2b8512f770fc9d",
           "sourceKind": "component_definition",
           "sourceId": "praxis-metadata-editor",
           "corpusVersion": "1.0.0"
@@ -1893,9 +1933,9 @@
         {
           "chunkIndex": 3,
           "chunkKind": "authoring_manifest",
-          "content": "{\"operationId\":\"optionSource.configure\",\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"operation_card\",\"semanticSummary\":\"Configure option source Effects: compile-domain-patch. Load options from the customers resource using id and name. Save a host-only URL string as the option source.\",\"scope\":\"dataBinding\",\"target\":{\"kind\":\"optionSource\",\"resolver\":\"field-metadata-option-source\",\"required\":false},\"inputContract\":{\"required\":[],\"properties\":[\"kind\",\"resource\",\"endpoint\",\"valueField\",\"labelField\",\"dependsOn\",\"dependencyFilterMap\",\"display\",\"detail\",\"options\"],\"semanticTerms\":[\"kind\",\"resource\",\"endpoint\",\"valueField\",\"labelField\",\"dependsOn\",\"dependencyFilterMap\",\"display\",\"detail\",\"options\",\"static\",\"remote\",\"lookup\",\"display.preset\",\"display.usage\",\"display.density\",\"display.selectedLayout\",\"display.resultLayout\",\"display.primaryPropertyPath\",\"display.fields\",\"display.secondaryPropertyPaths\",\"display.badgePropertyPaths\",\"display.statusToneMap\",\"detail.kind\",\"detail.surfaceId\",\"detail.presentation\",\"detail.preferredWidget\",\"detail.mode\",\"compact\",\"rich\",\"directory\",\"status\",\"reference\",\"hierarchical\",\"form\",\"filter\",\"table-cell\",\"dashboard\",\"wizard\",\"review\",\"comfortable\",\"card\",\"inline\",\"token\",\"list\",\"denseList\",\"table\",\"surface\",\"route\",\"href\",\"drawer\",\"modal\",\"view\",\"edit\",\"create\"]},\"effects\":[\"compile-domain-patch\"],\"affectedPaths\":[\"fieldMetadata.optionSource\"],\"validators\":[{\"validatorId\":\"option-source-shape-canonical\",\"level\":\"error\",\"code\":\"METADATA_OPTION_SOURCE_CANONICAL\",\"description\":\"Option source must use canonical FieldMetadata/x-ui shape.\"},{\"validatorId\":\"remote-option-source-governed\",\"level\":\"error\",\"code\":\"METADATA_REMOTE_OPTION_SOURCE_GOVERNED\",\"description\":\"Remote option sources must resolve through governed resource or endpoint metadata.\"},{\"validatorId\":\"cascade-backend-shape-preserved\",\"level\":\"error\",\"code\":\"METADATA_CASCADE_BACKEND_SHAPE_PRESERVED\",\"description\":\"Cascade config must preserve x-ui optionSource dependsOn and dependencyFilterMap semantics.\"},{\"validatorId\":\"metadata-round-trip\",\"level\":\"error\",\"code\":\"METADATA_ROUND_TRIP\",\"description\":\"Open, edit, apply/save, reopen and runtime consume must preserve metadata.\"}],\"preconditions\":[\"field-metadata-loaded\"],\"submissionImpact\":\"affects-remote-binding\",\"presentationAffordances\":[],\"positiveExamples\":[{\"id\":\"configure-remote-options\",\"request\":\"Load options from the customers resource using id and name.\",\"operationId\":\"optionSource.configure\",\"params\":{\"kind\":\"resource\",\"resource\":\"customers\",\"valueField\":\"id\",\"labelField\":\"name\"},\"isPositive\":true}],\"negativeExamples\":[{\"id\":\"reject-host-only-option-source\",\"request\":\"Save a host-only URL string as the option source.\",\"operationId\":\"optionSource.configure\",\"params\":{\"kind\":\"remote\",\"endpoint\":\"local-only://options\"},\"isPositive\":false}]}",
+          "content": "{\"operationId\":\"optionSource.configure\",\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"operation_card\",\"semanticSummary\":\"Configure option source Effects: compile-domain-patch. Load options from the customers resource using id and name. Save a host-only URL string as the option source.\",\"scope\":\"dataBinding\",\"target\":{\"kind\":\"optionSource\",\"resolver\":\"field-metadata-option-source\",\"required\":false},\"inputContract\":{\"required\":[],\"properties\":[\"kind\",\"resource\",\"endpoint\",\"valueField\",\"labelField\",\"dependsOn\",\"dependencyFilterMap\",\"display\",\"detail\",\"options\"],\"semanticTerms\":[\"kind\",\"resource\",\"endpoint\",\"valueField\",\"labelField\",\"dependsOn\",\"dependencyFilterMap\",\"display\",\"detail\",\"options\",\"static\",\"remote\",\"lookup\",\"display.preset\",\"display.usage\",\"display.density\",\"display.selectedLayout\",\"display.resultLayout\",\"display.primaryPropertyPath\",\"display.fields\",\"display.secondaryPropertyPaths\",\"display.badgePropertyPaths\",\"display.statusToneMap\",\"display.actions\",\"detail.kind\",\"detail.resourceKey\",\"detail.surfaceId\",\"detail.previewSurfaceId\",\"detail.presentation\",\"detail.preferredWidget\",\"detail.mode\",\"compact\",\"rich\",\"directory\",\"status\",\"reference\",\"hierarchical\",\"form\",\"filter\",\"table-cell\",\"dashboard\",\"wizard\",\"review\",\"comfortable\",\"card\",\"inline\",\"token\",\"list\",\"denseList\",\"table\",\"display.actions.showQuickView\",\"surface\",\"route\",\"href\",\"drawer\",\"modal\",\"view\",\"edit\",\"create\"]},\"effects\":[\"compile-domain-patch\"],\"affectedPaths\":[\"fieldMetadata.optionSource\"],\"validators\":[{\"validatorId\":\"option-source-shape-canonical\",\"level\":\"error\",\"code\":\"METADATA_OPTION_SOURCE_CANONICAL\",\"description\":\"Option source must use canonical FieldMetadata/x-ui shape.\"},{\"validatorId\":\"remote-option-source-governed\",\"level\":\"error\",\"code\":\"METADATA_REMOTE_OPTION_SOURCE_GOVERNED\",\"description\":\"Remote option sources must resolve through governed resource or endpoint metadata.\"},{\"validatorId\":\"cascade-backend-shape-preserved\",\"level\":\"error\",\"code\":\"METADATA_CASCADE_BACKEND_SHAPE_PRESERVED\",\"description\":\"Cascade config must preserve x-ui optionSource dependsOn and dependencyFilterMap semantics.\"},{\"validatorId\":\"metadata-round-trip\",\"level\":\"error\",\"code\":\"METADATA_ROUND_TRIP\",\"description\":\"Open, edit, apply/save, reopen and runtime consume must preserve metadata.\"}],\"preconditions\":[\"field-metadata-loaded\"],\"submissionImpact\":\"affects-remote-binding\",\"presentationAffordances\":[],\"positiveExamples\":[{\"id\":\"configure-remote-options\",\"request\":\"Load options from the customers resource using id and name.\",\"operationId\":\"optionSource.configure\",\"params\":{\"kind\":\"resource\",\"resource\":\"customers\",\"valueField\":\"id\",\"labelField\":\"name\"},\"isPositive\":true}],\"negativeExamples\":[{\"id\":\"reject-host-only-option-source\",\"request\":\"Save a host-only URL string as the option source.\",\"operationId\":\"optionSource.configure\",\"params\":{\"kind\":\"remote\",\"endpoint\":\"local-only://options\"},\"isPositive\":false}]}",
           "sourcePointer": "projects/praxis-metadata-editor/src/lib/ai/praxis-metadata-editor-authoring-manifest.ts",
-          "contentHash": "037355de1c38dbb6cde763014aa5c89698eed8af1c9aa5bdbfc80e955ba1f3b4",
+          "contentHash": "4dcc9f7ae06d7cc3bbc58c2b1dba28262c3172faba29339540cd4b550b8e9738",
           "sourceKind": "component_definition",
           "sourceId": "praxis-metadata-editor",
           "corpusVersion": "1.0.0"
@@ -1993,9 +2033,9 @@
         {
           "chunkIndex": 13,
           "chunkKind": "authoring_manifest",
-          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"operations\",\"operations\":[{\"operationId\":\"fieldMetadata.property.set\",\"title\":\"Set FieldMetadata property\",\"scope\":\"fieldMetadataPath\",\"targetKind\":\"fieldMetadata\",\"target\":{\"kind\":\"fieldMetadata\",\"resolver\":\"field-metadata-json-path\",\"ambiguityPolicy\":\"fail\",\"required\":true},\"inputSchema\":{\"type\":\"object\",\"required\":[\"path\",\"value\"],\"properties\":{\"path\":{\"enum\":[\"name\",\"label\",\"description\",\"controlType\",\"placeholder\",\"defaultValue\",\"group\",\"order\",\"required\",\"disabled\",\"readOnly\",\"hidden\",\"source\",\"transient\",\"submitPolicy\",\"hint\",\"helpText\",\"tooltip\",\"valuePresentation\",\"presentation\",\"presentation.presenter\",\"presentation.tone\",\"presentation.appearance\",\"presentation.icon\",\"presentation.label\",\"presentation.badge\",\"presentation.tooltip\",\"presentationRules\",\"options\",\"optionSource\",\"validators\",\"conditionalRequired\",\"conditionalDisplay\",\"visibleIn\",\"ariaLabel\",\"ariaDescribedBy\"]},\"value\":{},\"merge\":{\"type\":\"boolean\"}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-field-property-set\",\"handlerContract\":{\"reads\":[\"fieldMetadata\",\"fieldMetadataPath\",\"SchemaNormalizerService\"],\"writes\":[\"fieldMetadata\"],\"identityKeys\":[\"field.name\",\"path\"],\"inputSchema\":{\"type\":\"object\",\"required\":[\"path\",\"value\"],\"properties\":{\"path\":{\"enum\":[\"name\",\"label\",\"description\",\"controlType\",\"placeholder\",\"defaultValue\",\"group\",\"order\",\"required\",\"disabled\",\"readOnly\",\"hidden\",\"source\",\"transient\",\"submitPolicy\",\"hint\",\"helpText\",\"tooltip\",\"valuePresentation\",\"presentation\",\"presentation.presenter\",\"presentation.tone\",\"presentation.appearance\",\"presentation.icon\",\"presentation.label\",\"presentation.badge\",\"presentation.tooltip\",\"presentationRules\",\"options\",\"optionSource\",\"validators\",\"conditionalRequired\",\"conditionalDisplay\",\"visibleIn\",\"ariaLabel\",\"ariaDescribedBy\"]},\"value\":{},\"merge\":{\"type\":\"boolean\"}}},\"failureModes\":[\"unknown-field-metadata-path\",\"non-canonical-shape\",\"readonly-field\",\"normalization-failed\"],\"description\":\"Sets a canonical FieldMetadata property through a governed metadata path and re-runs schema normalization.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"field-metadata-shape-canonical\",\"field-path-supported-by-editor\",\"metadata-round-trip\"],\"affectedPaths\":[\"fieldMetadata\"],\"submissionImpact\":\"affects-schema-backed-data\",\"preconditions\":[\"field-metadata-loaded\"]},{\"operationId\":\"controlType.set\",\"title\":\"Set control type\",\"scope\":\"controlType\",\"targetKind\":\"controlType\",\"target\":{\"kind\":\"controlType\",\"resolver\":\"dynamic-fields-control-type-discovery\",\"ambiguityPolicy\":\"fail\",\"required\":true},\"inputSchema\":{\"type\":\"object\",\"required\":[\"controlType\"],\"properties\":{\"controlType\":{\"type\":\"string\"},\"preserveCompatibleProperties\":{\"type\":\"boolean\"}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-control-type-set\",\"handlerContract\":{\"reads\":[\"FieldControlType\",\"ConfigRegistryService\",\"dynamic-fields-discovery\",\"fieldMetadata\"],\"writes\":[\"fieldMetadata.controlType\",\"properties\",\"normalizedSeed\"],\"identityKeys\":[\"field.name\",\"controlType\"],\"inputSchema\":{\"type\":\"object\",\"required\":[\"controlType\"],\"properties\":{\"controlType\":{\"type\":\"string\"},\"preserveCompatibleProperties\":{\"type\":\"boolean\"}}},\"failureModes\":[\"control-type-not-discovered\",\"editor-coverage-missing\",\"incompatible-metadata-preservation\"],\"description\":\"Changes control type only when dynamic-fields discovery and metadata-editor config registry both expose renderer/editor coverage.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"control-type-exists-in-discovery\",\"editor-coverage-exists\",\"metadata-round-trip\"],\"affectedPaths\":[\"fieldMetadata.controlType\",\"properties\",\"normalizedSeed\"],\"submissionImpact\":\"affects-schema-backed-data\",\"preconditions\":[\"dynamic-fields-discovery-loaded\"]},{\"operationId\":\"optionSource.configure\",\"title\":\"Configure option source\",\"scope\":\"dataBinding\",\"targetKind\":\"optionSource\",\"target\":{\"kind\":\"optionSource\",\"resolver\":\"field-metadata-option-source\",\"ambiguityPolicy\":\"fail\",\"required\":false},\"inputSchema\":{\"type\":\"object\",\"minProperties\":1,\"properties\":{\"kind\":{\"enum\":[\"static\",\"remote\",\"resource\",\"lookup\"]},\"resource\":{\"type\":\"string\"},\"endpoint\":{\"type\":\"string\"},\"valueField\":{\"type\":\"string\"},\"labelField\":{\"type\":\"string\"},\"dependsOn\":{\"type\":\"string\"},\"dependencyFilterMap\":{\"type\":\"object\"},\"display\":{\"type\":\"object\",\"properties\":{\"preset\":{\"enum\":[\"compact\",\"rich\",\"directory\",\"status\",\"reference\",\"hierarchical\"]},\"usage\":{\"enum\":[\"form\",\"filter\",\"table-cell\",\"dashboard\",\"wizard\",\"review\"]},\"density\":{\"enum\":[\"compact\",\"comfortable\",\"rich\"]},\"selectedLayout\":{\"enum\":[\"card\",\"inline\",\"compact\",\"token\"]},\"resultLayout\":{\"enum\":[\"list\",\"denseList\",\"table\",\"card\"]},\"primaryPropertyPath\":{\"type\":\"string\"},\"fields\":{\"type\":\"array\"},\"secondaryPropertyPaths\":{\"type\":\"array\"},\"badgePropertyPaths\":{\"type\":\"array\"},\"statusToneMap\":{\"type\":\"object\"}}},\"detail\":{\"type\":\"object\",\"properties\":{\"kind\":{\"enum\":[\"surface\",\"route\",\"href\"]},\"surfaceId\":{\"type\":\"string\"},\"presentation\":{\"enum\":[\"drawer\",\"modal\"]},\"preferredWidget\":{\"type\":\"string\"},\"mode\":{\"enum\":[\"view\",\"edit\",\"create\"]}}},\"options\":{\"type\":\"array\"}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-option-source-configure\",\"handlerContract\":{\"reads\":[\"fieldMetadata.optionSource\",\"backend.x-ui.optionSource\",\"SchemaNormalizerService\"],\"writes\":[\"fieldMetadata.optionSource\"],\"identityKeys\":[\"field.name\",\"optionSource.kind\",\"optionSource.resource\"],\"inputSchema\":{\"type\":\"object\",\"minProperties\":1,\"properties\":{\"kind\":{\"enum\":[\"static\",\"remote\",\"resource\",\"lookup\"]},\"resource\":{\"type\":\"string\"},\"endpoint\":{\"type\":\"string\"},\"valueField\":{\"type\":\"string\"},\"labelField\":{\"type\":\"string\"},\"dependsOn\":{\"type\":\"string\"},\"dependencyFilterMap\":{\"type\":\"object\"},\"display\":{\"type\":\"object\",\"properties\":{\"preset\":{\"enum\":[\"compact\",\"rich\",\"directory\",\"status\",\"reference\",\"hierarchical\"]},\"usage\":{\"enum\":[\"form\",\"filter\",\"table-cell\",\"dashboard\",\"wizard\",\"review\"]},\"density\":{\"enum\":[\"compact\",\"comfortable\",\"rich\"]},\"selectedLayout\":{\"enum\":[\"card\",\"inline\",\"compact\",\"token\"]},\"resultLayout\":{\"enum\":[\"list\",\"denseList\",\"table\",\"card\"]},\"primaryPropertyPath\":{\"type\":\"string\"},\"fields\":{\"type\":\"array\"},\"secondaryPropertyPaths\":{\"type\":\"array\"},\"badgePropertyPaths\":{\"type\":\"array\"},\"statusToneMap\":{\"type\":\"object\"}}},\"detail\":{\"type\":\"object\",\"properties\":{\"kind\":{\"enum\":[\"surface\",\"route\",\"href\"]},\"surfaceId\":{\"type\":\"string\"},\"presentation\":{\"enum\":[\"drawer\",\"modal\"]},\"preferredWidget\":{\"type\":\"string\"},\"mode\":{\"enum\":[\"view\",\"edit\",\"create\"]}}},\"options\":{\"type\":\"array\"}}},\"failureModes\":[\"invalid-option-source-kind\",\"remote-source-missing-governed-resource\",\"dependency-filter-map-invalid\"],\"description\":\"Configures canonical optionSource fields while preserving backend x-ui dependsOn and dependencyFilterMap semantics.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"option-source-shape-canonical\",\"remote-option-source-governed\",\"cascade-backend-shape-preserved\",\"metadata-round-trip\"],\"affectedPaths\":[\"fieldMetadata.optionSource\"],\"submissionImpact\":\"affects-remote-binding\",\"preconditions\":[\"field-metadata-loaded\"]}]}",
+          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-metadata-editor\",\"ownerPackage\":\"@praxisui/metadata-editor\",\"configSchemaId\":\"FieldMetadata\",\"chunkSection\":\"operations\",\"operations\":[{\"operationId\":\"fieldMetadata.property.set\",\"title\":\"Set FieldMetadata property\",\"scope\":\"fieldMetadataPath\",\"targetKind\":\"fieldMetadata\",\"target\":{\"kind\":\"fieldMetadata\",\"resolver\":\"field-metadata-json-path\",\"ambiguityPolicy\":\"fail\",\"required\":true},\"inputSchema\":{\"type\":\"object\",\"required\":[\"path\",\"value\"],\"properties\":{\"path\":{\"enum\":[\"name\",\"label\",\"description\",\"controlType\",\"placeholder\",\"defaultValue\",\"group\",\"order\",\"required\",\"disabled\",\"readOnly\",\"hidden\",\"source\",\"transient\",\"submitPolicy\",\"hint\",\"helpText\",\"tooltip\",\"valuePresentation\",\"presentation\",\"presentation.presenter\",\"presentation.tone\",\"presentation.appearance\",\"presentation.icon\",\"presentation.label\",\"presentation.badge\",\"presentation.tooltip\",\"presentationRules\",\"quickViewVisible\",\"quickViewOrder\",\"quickViewActionLabel\",\"actions.showQuickView\",\"quickView.previewSurfaceId\",\"quickView.detailPresentation\",\"options\",\"optionSource\",\"validators\",\"conditionalRequired\",\"conditionalDisplay\",\"visibleIn\",\"ariaLabel\",\"ariaDescribedBy\"]},\"value\":{},\"merge\":{\"type\":\"boolean\"}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-field-property-set\",\"handlerContract\":{\"reads\":[\"fieldMetadata\",\"fieldMetadataPath\",\"SchemaNormalizerService\"],\"writes\":[\"fieldMetadata\"],\"identityKeys\":[\"field.name\",\"path\"],\"inputSchema\":{\"type\":\"object\",\"required\":[\"path\",\"value\"],\"properties\":{\"path\":{\"enum\":[\"name\",\"label\",\"description\",\"controlType\",\"placeholder\",\"defaultValue\",\"group\",\"order\",\"required\",\"disabled\",\"readOnly\",\"hidden\",\"source\",\"transient\",\"submitPolicy\",\"hint\",\"helpText\",\"tooltip\",\"valuePresentation\",\"presentation\",\"presentation.presenter\",\"presentation.tone\",\"presentation.appearance\",\"presentation.icon\",\"presentation.label\",\"presentation.badge\",\"presentation.tooltip\",\"presentationRules\",\"quickViewVisible\",\"quickViewOrder\",\"quickViewActionLabel\",\"actions.showQuickView\",\"quickView.previewSurfaceId\",\"quickView.detailPresentation\",\"options\",\"optionSource\",\"validators\",\"conditionalRequired\",\"conditionalDisplay\",\"visibleIn\",\"ariaLabel\",\"ariaDescribedBy\"]},\"value\":{},\"merge\":{\"type\":\"boolean\"}}},\"failureModes\":[\"unknown-field-metadata-path\",\"non-canonical-shape\",\"readonly-field\",\"normalization-failed\"],\"description\":\"Sets a canonical FieldMetadata property through a governed metadata path and re-runs schema normalization.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"field-metadata-shape-canonical\",\"field-path-supported-by-editor\",\"metadata-round-trip\"],\"affectedPaths\":[\"fieldMetadata\"],\"submissionImpact\":\"affects-schema-backed-data\",\"preconditions\":[\"field-metadata-loaded\"]},{\"operationId\":\"controlType.set\",\"title\":\"Set control type\",\"scope\":\"controlType\",\"targetKind\":\"controlType\",\"target\":{\"kind\":\"controlType\",\"resolver\":\"dynamic-fields-control-type-discovery\",\"ambiguityPolicy\":\"fail\",\"required\":true},\"inputSchema\":{\"type\":\"object\",\"required\":[\"controlType\"],\"properties\":{\"controlType\":{\"type\":\"string\"},\"preserveCompatibleProperties\":{\"type\":\"boolean\"}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-control-type-set\",\"handlerContract\":{\"reads\":[\"FieldControlType\",\"ConfigRegistryService\",\"dynamic-fields-discovery\",\"fieldMetadata\"],\"writes\":[\"fieldMetadata.controlType\",\"properties\",\"normalizedSeed\"],\"identityKeys\":[\"field.name\",\"controlType\"],\"inputSchema\":{\"type\":\"object\",\"required\":[\"controlType\"],\"properties\":{\"controlType\":{\"type\":\"string\"},\"preserveCompatibleProperties\":{\"type\":\"boolean\"}}},\"failureModes\":[\"control-type-not-discovered\",\"editor-coverage-missing\",\"incompatible-metadata-preservation\"],\"description\":\"Changes control type only when dynamic-fields discovery and metadata-editor config registry both expose renderer/editor coverage.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"control-type-exists-in-discovery\",\"editor-coverage-exists\",\"metadata-round-trip\"],\"affectedPaths\":[\"fieldMetadata.controlType\",\"properties\",\"normalizedSeed\"],\"submissionImpact\":\"affects-schema-backed-data\",\"preconditions\":[\"dynamic-fields-discovery-loaded\"]},{\"operationId\":\"optionSource.configure\",\"title\":\"Configure option source\",\"scope\":\"dataBinding\",\"targetKind\":\"optionSource\",\"target\":{\"kind\":\"optionSource\",\"resolver\":\"field-metadata-option-source\",\"ambiguityPolicy\":\"fail\",\"required\":false},\"inputSchema\":{\"type\":\"object\",\"minProperties\":1,\"properties\":{\"kind\":{\"enum\":[\"static\",\"remote\",\"resource\",\"lookup\"]},\"resource\":{\"type\":\"string\"},\"endpoint\":{\"type\":\"string\"},\"valueField\":{\"type\":\"string\"},\"labelField\":{\"type\":\"string\"},\"dependsOn\":{\"type\":\"string\"},\"dependencyFilterMap\":{\"type\":\"object\"},\"display\":{\"type\":\"object\",\"properties\":{\"preset\":{\"enum\":[\"compact\",\"rich\",\"directory\",\"status\",\"reference\",\"hierarchical\"]},\"usage\":{\"enum\":[\"form\",\"filter\",\"table-cell\",\"dashboard\",\"wizard\",\"review\"]},\"density\":{\"enum\":[\"compact\",\"comfortable\",\"rich\"]},\"selectedLayout\":{\"enum\":[\"card\",\"inline\",\"compact\",\"token\"]},\"resultLayout\":{\"enum\":[\"list\",\"denseList\",\"table\",\"card\"]},\"primaryPropertyPath\":{\"type\":\"string\"},\"fields\":{\"type\":\"array\"},\"secondaryPropertyPaths\":{\"type\":\"array\"},\"badgePropertyPaths\":{\"type\":\"array\"},\"statusToneMap\":{\"type\":\"object\"},\"actions\":{\"type\":\"object\",\"properties\":{\"showQuickView\":{\"type\":\"boolean\"}}}}},\"detail\":{\"type\":\"object\",\"properties\":{\"kind\":{\"enum\":[\"surface\",\"route\",\"href\"]},\"resourceKey\":{\"type\":\"string\"},\"surfaceId\":{\"type\":\"string\"},\"previewSurfaceId\":{\"type\":\"string\"},\"presentation\":{\"enum\":[\"drawer\",\"modal\"]},\"preferredWidget\":{\"type\":\"string\"},\"mode\":{\"enum\":[\"view\",\"edit\",\"create\"]}}},\"options\":{\"type\":\"array\"}}},\"effects\":[{\"kind\":\"compile-domain-patch\",\"handler\":\"metadata-option-source-configure\",\"handlerContract\":{\"reads\":[\"fieldMetadata.optionSource\",\"backend.x-ui.optionSource\",\"SchemaNormalizerService\"],\"writes\":[\"fieldMetadata.optionSource\"],\"identityKeys\":[\"field.name\",\"optionSource.kind\",\"optionSource.resource\"],\"inputSchema\":{\"type\":\"object\",\"minProperties\":1,\"properties\":{\"kind\":{\"enum\":[\"static\",\"remote\",\"resource\",\"lookup\"]},\"resource\":{\"type\":\"string\"},\"endpoint\":{\"type\":\"string\"},\"valueField\":{\"type\":\"string\"},\"labelField\":{\"type\":\"string\"},\"dependsOn\":{\"type\":\"string\"},\"dependencyFilterMap\":{\"type\":\"object\"},\"display\":{\"type\":\"object\",\"properties\":{\"preset\":{\"enum\":[\"compact\",\"rich\",\"directory\",\"status\",\"reference\",\"hierarchical\"]},\"usage\":{\"enum\":[\"form\",\"filter\",\"table-cell\",\"dashboard\",\"wizard\",\"review\"]},\"density\":{\"enum\":[\"compact\",\"comfortable\",\"rich\"]},\"selectedLayout\":{\"enum\":[\"card\",\"inline\",\"compact\",\"token\"]},\"resultLayout\":{\"enum\":[\"list\",\"denseList\",\"table\",\"card\"]},\"primaryPropertyPath\":{\"type\":\"string\"},\"fields\":{\"type\":\"array\"},\"secondaryPropertyPaths\":{\"type\":\"array\"},\"badgePropertyPaths\":{\"type\":\"array\"},\"statusToneMap\":{\"type\":\"object\"},\"actions\":{\"type\":\"object\",\"properties\":{\"showQuickView\":{\"type\":\"boolean\"}}}}},\"detail\":{\"type\":\"object\",\"properties\":{\"kind\":{\"enum\":[\"surface\",\"route\",\"href\"]},\"resourceKey\":{\"type\":\"string\"},\"surfaceId\":{\"type\":\"string\"},\"previewSurfaceId\":{\"type\":\"string\"},\"presentation\":{\"enum\":[\"drawer\",\"modal\"]},\"preferredWidget\":{\"type\":\"string\"},\"mode\":{\"enum\":[\"view\",\"edit\",\"create\"]}}},\"options\":{\"type\":\"array\"}}},\"failureModes\":[\"invalid-option-source-kind\",\"remote-source-missing-governed-resource\",\"dependency-filter-map-invalid\"],\"description\":\"Configures canonical optionSource fields while preserving backend x-ui dependsOn and dependencyFilterMap semantics.\"}}],\"destructive\":false,\"requiresConfirmation\":false,\"validators\":[\"option-source-shape-canonical\",\"remote-option-source-governed\",\"cascade-backend-shape-preserved\",\"metadata-round-trip\"],\"affectedPaths\":[\"fieldMetadata.optionSource\"],\"submissionImpact\":\"affects-remote-binding\",\"preconditions\":[\"field-metadata-loaded\"]}]}",
           "sourcePointer": "projects/praxis-metadata-editor/src/lib/ai/praxis-metadata-editor-authoring-manifest.ts",
-          "contentHash": "3cbf9d244088100c598a101e744d6bfa766a130030aa42544e015f9d203865b1",
+          "contentHash": "cc0e26b2ad9262aa2b3f9d034cafadb57ce4abcd180c565a7cdaab81cd5fc98e",
           "sourceKind": "component_definition",
           "sourceId": "praxis-metadata-editor",
           "corpusVersion": "1.0.0"

package/fesm2022/praxisui-metadata-editor.mjs

@@ -559,6 +559,16 @@ const METADATA_EDITOR_EN_US = {
     'praxis.metadataEditor.presentationFields.tooltip.hint': 'Short explanation shown as a tooltip.',
     'praxis.metadataEditor.presentationFields.presentationRules.label': 'Presentation rules',
     'praxis.metadataEditor.presentationFields.presentationRules.hint': 'Guided builder for ordered Json Logic rules that only change presentation. Later rules win.',
+    'praxis.metadataEditor.presentationFields.quickViewVisible.label': 'Show in Quick View summary',
+    'praxis.metadataEditor.presentationFields.quickViewVisible.hint': 'Controls x-ui.quickViewVisible when this resource is previewed inside a Quick View card.',
+    'praxis.metadataEditor.presentationFields.quickViewOrder.label': 'Quick View summary order',
+    'praxis.metadataEditor.presentationFields.quickViewOrder.hint': 'Numeric priority (x-ui.quickViewOrder) for this field in Quick View summary items.',
+    'praxis.metadataEditor.presentationFields.quickViewPreviewSurfaceId.label': 'Quick View: preview surface',
+    'praxis.metadataEditor.presentationFields.quickViewPreviewSurfaceId.hint': 'Optional dedicated read-only surface for this field\u2019s Quick View card (preserves canonical server recordOpen).',
+    'praxis.metadataEditor.presentationFields.quickViewDetailPresentation.label': 'Quick View: detail handoff mode',
+    'praxis.metadataEditor.presentationFields.quickViewDetailPresentation.hint': 'Defines whether the primary Quick View CTA opens the full surface in a drawer or modal.',
+    'praxis.metadataEditor.presentationFields.quickViewDetailPresentation.option.drawer': 'Side drawer',
+    'praxis.metadataEditor.presentationFields.quickViewDetailPresentation.option.modal': 'Modal dialog',
     'praxis.metadataEditor.presentationChoice.help': 'Help',
     'praxis.metadataEditor.presentationChoice.clear': 'Clear selection',
     'praxis.metadataEditor.presentationRulesBuilder.title': 'Presentation rules',
@@ -813,6 +823,16 @@ const METADATA_EDITOR_PT_BR = {
     'praxis.metadataEditor.presentationFields.tooltip.hint': 'Explica\u00e7\u00e3o curta exibida como tooltip.',
     'praxis.metadataEditor.presentationFields.presentationRules.label': 'Regras de apresenta\u00e7\u00e3o',
     'praxis.metadataEditor.presentationFields.presentationRules.hint': 'Builder guiado para regras Json Logic ordenadas que alteram somente a apresenta\u00e7\u00e3o. Regras posteriores vencem.',
+    'praxis.metadataEditor.presentationFields.quickViewVisible.label': 'Exibir no resumo Quick View',
+    'praxis.metadataEditor.presentationFields.quickViewVisible.hint': 'Controla x-ui.quickViewVisible quando este recurso \u00e9 exibido em um card de Quick View.',
+    'praxis.metadataEditor.presentationFields.quickViewOrder.label': 'Ordem no resumo Quick View',
+    'praxis.metadataEditor.presentationFields.quickViewOrder.hint': 'Prioridade num\u00e9rica (x-ui.quickViewOrder) deste campo na s\u00edntese do card Quick View.',
+    'praxis.metadataEditor.presentationFields.quickViewPreviewSurfaceId.label': 'Quick View: surface de preview',
+    'praxis.metadataEditor.presentationFields.quickViewPreviewSurfaceId.hint': 'Surface read-only opcional dedicada ao card de Quick View deste v\u00ednculo (preserva o recordOpen can\u00f4nico do servidor).',
+    'praxis.metadataEditor.presentationFields.quickViewDetailPresentation.label': 'Quick View: abertura de detalhe',
+    'praxis.metadataEditor.presentationFields.quickViewDetailPresentation.hint': 'Define se o CTA prim\u00e1rio do Quick View abre a superf\u00edcie completa em drawer ou modal.',
+    'praxis.metadataEditor.presentationFields.quickViewDetailPresentation.option.drawer': 'Gaveta lateral (drawer)',
+    'praxis.metadataEditor.presentationFields.quickViewDetailPresentation.option.modal': 'Modal (dialog)',
     'praxis.metadataEditor.presentationChoice.help': 'Ajuda',
     'praxis.metadataEditor.presentationChoice.clear': 'Limpar sele\u00e7\u00e3o',
     'praxis.metadataEditor.presentationRulesBuilder.title': 'Regras de apresenta\u00e7\u00e3o',
@@ -4228,6 +4248,20 @@ const selectProperties = [
             { value: 'danger', text: 'Danger' },
         ],
     },
+    {
+        name: 'actions.showQuickView',
+        label: 'Quick View: exibir botão',
+        editorType: 'checkbox',
+        group: 'Ações',
+        hint: 'Controla o botão de visualização rápida quando um único item está selecionado e há vínculo governado (resourceReference / optionSource.detail).',
+    },
+    {
+        name: 'quickViewActionLabel',
+        label: 'Quick View: label da ação',
+        editorType: 'text',
+        group: 'Ações',
+        hint: 'Rótulo acessível customizado para o botão de visualização rápida do item selecionado.',
+    },
     // 7) Aparência
     {
         name: 'materialDesign.appearance',
@@ -4601,6 +4635,13 @@ const entityLookupProperties = [
         group: 'Display canonico',
         hint: 'Limite preferencial de badges antes de overflow.',
     },
+    {
+        name: 'optionSource.display.actions.showQuickView',
+        label: 'Display: acao visualizacao rapida',
+        editorType: 'checkbox',
+        group: 'Display canonico',
+        hint: 'Exibe ou oculta o gatilho de Quick View na projecao canonica de display do optionSource.',
+    },
     {
         name: 'selectedLayout',
         label: 'Layout selecionado',
@@ -4929,6 +4970,13 @@ const entityLookupProperties = [
         ],
         hint: 'Use surface como contrato canonico de plataforma; route/href ficam como fallback legado.',
     },
+    {
+        name: 'optionSource.detail.resourceKey',
+        label: 'ResourceKey de detalhe',
+        editorType: 'text',
+        group: 'Navegacao',
+        hint: 'Chave canonica do recurso destino publicada pelo backend (ex.: human-resources.departamentos).',
+    },
     {
         name: 'optionSource.detail.surfaceId',
         label: 'Surface de detalhe',
@@ -4936,6 +4984,13 @@ const entityLookupProperties = [
         group: 'Navegacao',
         hint: 'Id da surface item-level preferida. Ex.: view, detail.',
     },
+    {
+        name: 'optionSource.detail.previewSurfaceId',
+        label: 'Surface de preview (Quick View)',
+        editorType: 'text',
+        group: 'Navegacao',
+        hint: 'Surface read-only opcional dedicada ao card de Quick View; quando ausente, usa surfaceId.',
+    },
     {
         name: 'optionSource.detail.presentation',
         label: 'Apresentacao da surface',
@@ -5066,6 +5121,13 @@ const entityLookupProperties = [
         editorType: 'text',
         group: 'Acoes do lookup',
     },
+    {
+        name: 'quickViewActionLabel',
+        label: 'Label visualizacao rapida',
+        editorType: 'text',
+        group: 'Acoes do lookup',
+        hint: 'Rotulo customizado para o botao/acao de Quick View do registro selecionado.',
+    },
     {
         name: 'changeActionLabel',
         label: 'Label trocar',
@@ -5102,6 +5164,13 @@ const entityLookupProperties = [
         editorType: 'checkbox',
         group: 'Acoes do lookup',
     },
+    {
+        name: 'actions.showQuickView',
+        label: 'Acao: visualizacao rapida',
+        editorType: 'checkbox',
+        group: 'Acoes do lookup',
+        hint: 'Exibe ou oculta o gatilho de Quick View quando houver target governado (resourceReference ou optionSource.detail).',
+    },
     {
         name: 'actions.showChange',
         label: 'Acao: trocar',
@@ -8754,6 +8823,58 @@ const fieldPresentationProperties = [
         hint: 'Builder guiado para regras Json Logic ordenadas que alteram somente a apresentação. Regras posteriores vencem.',
         hintKey: 'presentationFields.presentationRules.hint',
     },
+    {
+        name: 'quickViewVisible',
+        label: 'Exibir no resumo Quick View',
+        labelKey: 'presentationFields.quickViewVisible.label',
+        editorType: 'checkbox',
+        group: 'Apresentação',
+        groupKey: 'presentationFields.group',
+        hint: 'Controla x-ui.quickViewVisible quando este recurso é exibido em um card de Quick View.',
+        hintKey: 'presentationFields.quickViewVisible.hint',
+    },
+    {
+        name: 'quickViewOrder',
+        label: 'Ordem no resumo Quick View',
+        labelKey: 'presentationFields.quickViewOrder.label',
+        editorType: 'number',
+        group: 'Apresentação',
+        groupKey: 'presentationFields.group',
+        hint: 'Prioridade numérica (x-ui.quickViewOrder) deste campo na síntese do card Quick View.',
+        hintKey: 'presentationFields.quickViewOrder.hint',
+    },
+    {
+        name: 'quickView.previewSurfaceId',
+        label: 'Quick View: surface de preview',
+        labelKey: 'presentationFields.quickViewPreviewSurfaceId.label',
+        editorType: 'text',
+        group: 'Apresentação',
+        groupKey: 'presentationFields.group',
+        hint: 'Surface read-only opcional dedicada ao card de Quick View deste vínculo (preserva o recordOpen canônico do servidor).',
+        hintKey: 'presentationFields.quickViewPreviewSurfaceId.hint',
+    },
+    {
+        name: 'quickView.detailPresentation',
+        label: 'Quick View: abertura de detalhe',
+        labelKey: 'presentationFields.quickViewDetailPresentation.label',
+        editorType: 'select',
+        group: 'Apresentação',
+        groupKey: 'presentationFields.group',
+        options: [
+            {
+                value: 'drawer',
+                text: 'Gaveta lateral (drawer)',
+                textKey: 'presentationFields.quickViewDetailPresentation.option.drawer',
+            },
+            {
+                value: 'modal',
+                text: 'Modal (dialog)',
+                textKey: 'presentationFields.quickViewDetailPresentation.option.modal',
+            },
+        ],
+        hint: 'Define se o CTA primário do Quick View abre a superfície completa em drawer ou modal.',
+        hintKey: 'presentationFields.quickViewDetailPresentation.hint',
+    },
 ];
 
 /** Garante que minLength <= maxLength quando ambos definidos. */
@@ -11904,6 +12025,18 @@ class FieldMetadataEditorComponent {
         this.normalizeJsonObjectProperty(patch, 'valuePresentation');
         this.normalizeJsonObjectProperty(patch, 'presentation');
         this.normalizeJsonArrayProperty(patch, 'presentationRules');
+        const seedRecordOpen = this.seed?.quickView?.recordOpen;
+        if (patch?.quickView &&
+            typeof patch.quickView === 'object' &&
+            !Array.isArray(patch.quickView) &&
+            seedRecordOpen &&
+            typeof seedRecordOpen === 'object' &&
+            patch.quickView.recordOpen === undefined) {
+            patch.quickView = {
+                recordOpen: this.cloneSnapshot(seedRecordOpen),
+                ...patch.quickView,
+            };
+        }
     }
     normalizeEntityLookupPatchValues(patch) {
         const optionSource = patch?.optionSource;
@@ -14567,6 +14700,44 @@ const BASE_CAPABILITIES = [
         description: 'Ordered Json Logic presentation rules edited by a guided builder for common conditions and semantic visual effects.',
         safetyNotes: 'Rules may only affect tone, icon, label, badge, appearance and tooltip; they must not mutate submitted values or execute commands.',
     },
+    {
+        path: 'seed.quickViewVisible',
+        category: 'appearance',
+        valueKind: 'boolean',
+        description: 'Whether this field is shown in Resource Quick View summary items when the resource is previewed.',
+    },
+    {
+        path: 'seed.quickViewOrder',
+        category: 'layout',
+        valueKind: 'number',
+        description: 'Numeric ordering priority for this field inside Resource Quick View summary items.',
+    },
+    {
+        path: 'seed.quickView.previewSurfaceId',
+        category: 'behavior',
+        valueKind: 'string',
+        description: 'Optional dedicated read-only surfaceId used to hydrate the Quick View card while preserving the canonical server recordOpen target.',
+        safetyNotes: 'Must only refine the preview surface; never override backend-owned recordOpen.target.resourceKey or surfaceId.',
+    },
+    {
+        path: 'seed.quickView.detailPresentation',
+        category: 'layout',
+        valueKind: 'enum',
+        allowedValues: ['drawer', 'modal'],
+        description: 'Preferred presentation mode (drawer or modal) when handing off from Quick View to the full detail surface.',
+    },
+    {
+        path: 'seed.quickViewActionLabel',
+        category: 'identity',
+        valueKind: 'string',
+        description: 'Accessible custom label for the Quick View trigger action on lookup and select controls.',
+    },
+    {
+        path: 'seed.actions.showQuickView',
+        category: 'behavior',
+        valueKind: 'boolean',
+        description: 'Controls whether the explicit Quick View action button is shown when a governed reference target is present.',
+    },
     {
         path: 'seed.shortcuts',
         category: 'behavior',
@@ -14623,6 +14794,12 @@ const fieldMetadataPropertySchema = {
                 'presentation.badge',
                 'presentation.tooltip',
                 'presentationRules',
+                'quickViewVisible',
+                'quickViewOrder',
+                'quickViewActionLabel',
+                'actions.showQuickView',
+                'quickView.previewSurfaceId',
+                'quickView.detailPresentation',
                 'options',
                 'optionSource',
                 'validators',
@@ -14661,13 +14838,21 @@ const optionSourceSchema = {
                 secondaryPropertyPaths: { type: 'array' },
                 badgePropertyPaths: { type: 'array' },
                 statusToneMap: { type: 'object' },
+                actions: {
+                    type: 'object',
+                    properties: {
+                        showQuickView: { type: 'boolean' },
+                    },
+                },
             },
         },
         detail: {
             type: 'object',
             properties: {
                 kind: { enum: ['surface', 'route', 'href'] },
+                resourceKey: { type: 'string' },
                 surfaceId: { type: 'string' },
+                previewSurfaceId: { type: 'string' },
                 presentation: { enum: ['drawer', 'modal'] },
                 preferredWidget: { type: 'string' },
                 mode: { enum: ['view', 'edit', 'create'] },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/metadata-editor",
-  "version": "10.0.0-rc.40",
+  "version": "10.0.0-rc.42",
   "description": "Metadata editor for Praxis UI fields and components with runtime integration.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -8,10 +8,10 @@
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.40",
-    "@praxisui/core": "^10.0.0-rc.40",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.40",
-    "@praxisui/settings-panel": "^10.0.0-rc.40",
+    "@praxisui/ai": "^10.0.0-rc.42",
+    "@praxisui/core": "^10.0.0-rc.42",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.42",
+    "@praxisui/settings-panel": "^10.0.0-rc.42",
     "rxjs": "~7.8.0"
   },
   "dependencies": {