@praxisui/crud 9.0.4-rc.2 → 9.0.4-rc.20

package/README.md

@@ -20,7 +20,7 @@ Use this package to combine `@praxisui/table`, `@praxisui/dynamic-form`, governe
 ## Install
 
 ```bash
-npm i @praxisui/crud@latest
+npm i @praxisui/crud@rc
 ```
 
 Peer dependencies:
@@ -123,6 +123,21 @@ Child component semantics stay with their owners:
 - dialog presentation belongs to `@praxisui/dialog` and host adapters
 - page composition belongs to `@praxisui/page-builder`
 
+Item surfaces published by capabilities are not limited to the conventional
+`create`, `view`, and `edit` ids. A row may expose domain surfaces such as
+`payroll-history`, `address`, or `equipment-custody`. The runtime trusts the
+canonical `ResourceSurfaceCatalogItem` carried by the row action; if that object
+is not forwarded, it resolves the exact `surface.id` through the row HATEOAS
+links. A surface is distinguished from a business action by its `kind` and is
+materialized with the corresponding widget. Related collection surfaces open a
+governed `praxis-table` filtered by the selected parent id, while unavailable
+surfaces remain disabled according to their published availability decision.
+
+Consumers should not translate these domain surfaces into local CRUD aliases or
+duplicate their filters in the host. The backend owns relationship metadata and
+availability; `@praxisui/core`, `@praxisui/table`, and `@praxisui/crud` own the
+materialization and immediate interaction feedback.
+
 ## Open Modes
 
 CRUD actions can open by route, modal, or drawer. `CrudLauncherService` resolves the final mode from persisted overrides, action metadata, and global/default configuration.
@@ -165,6 +180,10 @@ maximizing or restoring. The default edge is right/top; a configured left edge
 is preserved by the same lifecycle. `defaults.modal.edgeGap` controls the
 viewport inset while maximized. Provide `CRUD_DRAWER_ADAPTER` only when a
 host must replace that standard shell with a real corporate drawer implementation.
+Upstream surface materializers should publish the semantic `openMode` and leave
+geometry absent unless the host intentionally overrides it with a valid
+`DialogPosition` object. Values such as `position: "end"` are not drawer
+positions and must not be used to imitate a side panel.
 
 For edit drawers and modals, the runtime presents the selected record identity
 above the command form when the table has materialized it. An explicit valid

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-31T10:13:34.390Z",
+  "generatedAt": "2026-08-04T11:45:12.207Z",
   "packageName": "@praxisui/crud",
-  "packageVersion": "9.0.4-rc.2",
+  "packageVersion": "9.0.4-rc.20",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -11403,6 +11403,24 @@
           ],
           "description": "Metodo HTTP canonico para o submit quando o backend publica operacao explicita."
         },
+        {
+          "path": "inputs.submitIdempotencyKey",
+          "category": "inputs",
+          "valueKind": "string",
+          "description": "Identidade estavel da tentativa de comando, materializada a partir da politica execution da action."
+        },
+        {
+          "path": "inputs.submitCorrelationId",
+          "category": "inputs",
+          "valueKind": "string",
+          "description": "Identificador de correlacao governado para rastreabilidade ponta a ponta do comando."
+        },
+        {
+          "path": "inputs.submitResourceVersion",
+          "category": "inputs",
+          "valueKind": "string",
+          "description": "Versao persistida esperada, transportada como If-Match quando exigida pela action."
+        },
         {
           "path": "inputs.responseSchemaUrl",
           "category": "inputs",
@@ -11452,6 +11470,17 @@
           "description": "Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.",
           "safetyNotes": "Nao reprocessa layouts ja persistidos ou authorados."
         },
+        {
+          "path": "inputs.configPersistenceStrategy",
+          "category": "inputs",
+          "valueKind": "enum",
+          "allowedValues": [
+            "local-first",
+            "input-first"
+          ],
+          "description": "Define se preferências locais persistidas ou o contrato explícito do host governam a materialização corrente.",
+          "safetyNotes": "Use input-first em commands e surfaces transitórias; isso impede que mode e estados operacionais antigos sobrescrevam o schema atual."
+        },
         {
           "path": "inputs.layoutPolicy",
           "category": "inputs",
@@ -11522,6 +11551,13 @@
           "description": "Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.",
           "safetyNotes": "Use preserve quando o espaco vazio for intencional; use all apenas quando ate campos xs/sm devam ocupar a linha completa."
         },
+        {
+          "path": "inputs.layoutPolicy.groupedCommand.contextFields",
+          "category": "inputs",
+          "valueKind": "array",
+          "description": "Campos canônicos do request cujo valor vem do contexto da surface. Eles permanecem no FormGroup e no payload, sem renderizar controles redundantes.",
+          "safetyNotes": "Use somente para campos realmente hidratados por initialValue ou leitura da entidade; nunca use para esconder dados que a pessoa ainda precisa informar."
+        },
         {
           "path": "inputs.layoutPolicy.detailSummary",
           "category": "inputs",
@@ -12183,9 +12219,9 @@
         {
           "chunkIndex": 10,
           "chunkKind": "capabilities",
-          "content": "Schema Capability:\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n\nSchema Capability:\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n\nSchema Capability:\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n\nSchema Capability:\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n\nSchema Capability:\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n\nSchema Capability:\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n\nSchema Capability:\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n\nSchema Capability:\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n\nSchema Capability:\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n\nSchema Capability:\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n\nComponent Capability:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n\nComponent Capability:\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n\nComponent Capability:\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n\nComponent Capability:\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n\nComponent Capability:\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n\nComponent Capability:\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n\nComponent Capability:\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n\nComponent Capability:\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n\nComponent Capability:\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n\nComponent Capability:\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n\nComponent Capability:\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n\nComponent Capability:\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n\nComponent Capability:\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n\nComponent Capability:\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n\nComponent Capability:\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n\nComponent Capability:\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n\nComponent Capability:\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n\nComponent Capability:\n  - Path: inputs.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.orphanFieldExpansion\n    Category: inputs\n    Kind: enum\n    Description: Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary\n    Category: inputs\n    Kind: object\n    Description: Politica declarativa para resumo read-only compacto em compactPresentation, sem FormConfig.sections locais.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeFields\n    Category: inputs\n    Kind: array\n    Description: Lista de campos canônicos do schema que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeFields\n    Category: inputs\n    Kind: array\n    Description: Lista de campos canônicos do schema que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeGroups\n    Category: inputs\n    Kind: array\n    Description: Lista de grupos do schema que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeGroups\n    Category: inputs\n    Kind: array\n    Description: Lista de grupos do schema que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeRoles\n    Category: inputs\n    Kind: array\n    Description: Lista de papeis semanticos de campo que devem entrar no resumo read-only compacto.",
+          "content": "Schema Capability:\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n\nSchema Capability:\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n\nSchema Capability:\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n\nSchema Capability:\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n\nSchema Capability:\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n\nSchema Capability:\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n\nSchema Capability:\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n\nSchema Capability:\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n\nSchema Capability:\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n\nSchema Capability:\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n\nComponent Capability:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n\nComponent Capability:\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n\nComponent Capability:\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n\nComponent Capability:\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n\nComponent Capability:\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n\nComponent Capability:\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n\nComponent Capability:\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n\nComponent Capability:\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n\nComponent Capability:\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n\nComponent Capability:\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n\nComponent Capability:\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n\nComponent Capability:\n  - Path: inputs.submitIdempotencyKey\n    Category: inputs\n    Kind: string\n    Description: Identidade estavel da tentativa de comando, materializada a partir da politica execution da action.\n\nComponent Capability:\n  - Path: inputs.submitCorrelationId\n    Category: inputs\n    Kind: string\n    Description: Identificador de correlacao governado para rastreabilidade ponta a ponta do comando.\n\nComponent Capability:\n  - Path: inputs.submitResourceVersion\n    Category: inputs\n    Kind: string\n    Description: Versao persistida esperada, transportada como If-Match quando exigida pela action.\n\nComponent Capability:\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n\nComponent Capability:\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n\nComponent Capability:\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n\nComponent Capability:\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n\nComponent Capability:\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n\nComponent Capability:\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n\nComponent Capability:\n  - Path: inputs.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n\nComponent Capability:\n  - Path: inputs.configPersistenceStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se preferências locais persistidas ou o contrato explícito do host governam a materialização corrente.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.orphanFieldExpansion\n    Category: inputs\n    Kind: enum\n    Description: Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.contextFields\n    Category: inputs\n    Kind: array\n    Description: Campos canônicos do request cujo valor vem do contexto da surface. Eles permanecem no FormGroup e no payload, sem renderizar controles redundantes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary\n    Category: inputs\n    Kind: object\n    Description: Politica declarativa para resumo read-only compacto em compactPresentation, sem FormConfig.sections locais.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-ai-capabilities.ts",
-          "contentHash": "e89e40f565c3d190defcdd4bb253f57ddde076effae96d6b2a0c9d85aa2cc82f",
+          "contentHash": "c0a08ef89a122e2e5ec62606017281c689a4e7e35662112e4ea5c00dbd4e3055",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form-dialog-host",
           "corpusVersion": "1.0.0"
@@ -12193,9 +12229,9 @@
         {
           "chunkIndex": 11,
           "chunkKind": "capabilities",
-          "content": "Component Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeRoles\n    Category: inputs\n    Kind: array\n    Description: Lista de papeis semanticos de campo que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.maxFields\n    Category: inputs\n    Kind: number\n    Description: Limite maximo de campos materializados no primeiro painel compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.fieldPriority\n    Category: inputs\n    Kind: object\n    Description: Mapa campo -> prioridade para ordenar campos do resumo quando o schema publica candidatos suficientes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.groupPriority\n    Category: inputs\n    Kind: object\n    Description: Mapa grupo -> prioridade para ordenar grupos do resumo quando o schema publica agrupamento semantico.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.columns\n    Category: inputs\n    Kind: number\n    Description: Quantidade base de colunas para distribuir campos de resumo schema-driven sem criar FormConfig.sections locais.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.responsiveColumns\n    Category: inputs\n    Kind: object\n    Description: Mapa de colunas por breakpoint xs/sm/md/lg/xl para detalhes read-only compactos em drawers, side sheets e desktop largo.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.widthPrecedence\n    Category: inputs\n    Kind: enum\n    Description: Define se larguras explicitas do schema ou a densidade do resumo controlam os spans no compactPresentation read-only.\n\nComponent Capability:\n  - Path: inputs.fieldIconPolicy\n    Category: inputs\n    Kind: enum\n    Description: Controla se icones prefix/suffix dos metadados aparecem em todos os modos, apenas apresentacao, ou nunca.\n\nComponent Capability:\n  - Path: inputs.backConfig\n    Category: inputs\n    Kind: object\n    Description: Configuracao de navegacao/retorno (BackConfig).\n\nComponent Capability:\n  - Path: inputs.backConfig.strategy\n    Category: inputs\n    Kind: enum\n    Description: Estrategia de retorno (auto/close/navigate).\n\nComponent Capability:\n  - Path: inputs.backConfig.returnTo\n    Category: inputs\n    Kind: string\n    Description: Rota para retornar quando strategy=navigate.\n\nComponent Capability:\n  - Path: inputs.backConfig.confirmOnDirty\n    Category: inputs\n    Kind: boolean\n    Description: Solicita confirmacao ao sair com mudancas nao salvas.\n\nComponent Capability:\n  - Path: inputs.hooks\n    Category: inputs\n    Kind: object\n    Description: Declaracoes de hooks fornecidas diretamente ao componente.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da inicializacao.\n\nComponent Capability:\n  - Path: inputs.hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a inicializacao.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da validacao.\n\nComponent Capability:\n  - Path: inputs.hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a validacao.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes do submit.\n\nComponent Capability:\n  - Path: inputs.hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos o submit.\n\nComponent Capability:\n  - Path: inputs.hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados em erros de submit/validacao.\n\nComponent Capability:\n  - Path: inputs.removeEmptyContainersOnSave\n    Category: inputs\n    Kind: boolean\n    Description: Remove containers vazios ao salvar configuracao.\n\nComponent Capability:\n  - Path: inputs.reactiveValidation\n    Category: inputs\n    Kind: boolean\n    Description: Ativa validacao reativa (afterValidate em valueChanges).\n\nComponent Capability:\n  - Path: inputs.reactiveValidationDebounceMs\n    Category: inputs\n    Kind: number\n    Description: Debounce em ms para validacao reativa.\n\nComponent Capability:\n  - Path: inputs.notifyIfOutdated\n    Category: inputs\n    Kind: enum\n    Description: Canal de notificacao para schema desatualizado.\n\nComponent Capability:\n  - Path: inputs.snoozeMs\n    Category: inputs\n    Kind: number\n    Description: Duracao do snooze para alertas de schema.\n\nComponent Capability:\n  - Path: inputs.autoOpenSettingsOnOutdated\n    Category: inputs\n    Kind: boolean\n    Description: Abre automaticamente o editor ao detectar schema desatualizado.\n\nComponent Capability:\n  - Path: inputs.readonlyModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo somente leitura global.\n\nComponent Capability:\n  - Path: inputs.disabledModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo desabilitado global.\n\nComponent Capability:\n  - Path: inputs.presentationModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Ativa modo de apresentacao global (somente view).\n\nComponent Capability:\n  - Path: inputs.visibleGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca visibilidade global dos campos.\n\nComponent Capability:\n  - Path: inputs.customEndpoints\n    Category: inputs\n    Kind: object\n    Description: Override de endpoints CRUD (EndpointConfig).\n\nComponent Capability:\n  - Path: inputs.customEndpoints.getAll\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para listar registros.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.getById\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para obter registro por ID.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.create\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para criar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.update\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para atualizar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.delete\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para deletar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.filter\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para filtro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.schema\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para schemas.\n\nComponent Capability:\n  - Path: inputs.config.presentation\n    Category: appearance\n    Kind: object\n    Description: Preferencias visuais persistidas no config.\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do label (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.valueFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do valor (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelPosition\n    Category: appearance\n    Kind: enum\n    Description: Posicionamento do label (above/left).\n\nComponent Capability:\n  - Path: inputs.config.presentation.compact\n    Category: appearance\n    Kind: boolean\n    Description: Modo compacto de apresentacao.\n\nComponent Capability:\n  - Path: inputs.config.presentation.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual global.\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelWidth\n    Category: appearance\n    Kind: number\n    Description: Largura do label (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do label.",
+          "content": "Component Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeFields\n    Category: inputs\n    Kind: array\n    Description: Lista de campos canônicos do schema que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeFields\n    Category: inputs\n    Kind: array\n    Description: Lista de campos canônicos do schema que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeGroups\n    Category: inputs\n    Kind: array\n    Description: Lista de grupos do schema que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeGroups\n    Category: inputs\n    Kind: array\n    Description: Lista de grupos do schema que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeRoles\n    Category: inputs\n    Kind: array\n    Description: Lista de papeis semanticos de campo que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeRoles\n    Category: inputs\n    Kind: array\n    Description: Lista de papeis semanticos de campo que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.maxFields\n    Category: inputs\n    Kind: number\n    Description: Limite maximo de campos materializados no primeiro painel compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.fieldPriority\n    Category: inputs\n    Kind: object\n    Description: Mapa campo -> prioridade para ordenar campos do resumo quando o schema publica candidatos suficientes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.groupPriority\n    Category: inputs\n    Kind: object\n    Description: Mapa grupo -> prioridade para ordenar grupos do resumo quando o schema publica agrupamento semantico.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.columns\n    Category: inputs\n    Kind: number\n    Description: Quantidade base de colunas para distribuir campos de resumo schema-driven sem criar FormConfig.sections locais.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.responsiveColumns\n    Category: inputs\n    Kind: object\n    Description: Mapa de colunas por breakpoint xs/sm/md/lg/xl para detalhes read-only compactos em drawers, side sheets e desktop largo.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.widthPrecedence\n    Category: inputs\n    Kind: enum\n    Description: Define se larguras explicitas do schema ou a densidade do resumo controlam os spans no compactPresentation read-only.\n\nComponent Capability:\n  - Path: inputs.fieldIconPolicy\n    Category: inputs\n    Kind: enum\n    Description: Controla se icones prefix/suffix dos metadados aparecem em todos os modos, apenas apresentacao, ou nunca.\n\nComponent Capability:\n  - Path: inputs.backConfig\n    Category: inputs\n    Kind: object\n    Description: Configuracao de navegacao/retorno (BackConfig).\n\nComponent Capability:\n  - Path: inputs.backConfig.strategy\n    Category: inputs\n    Kind: enum\n    Description: Estrategia de retorno (auto/close/navigate).\n\nComponent Capability:\n  - Path: inputs.backConfig.returnTo\n    Category: inputs\n    Kind: string\n    Description: Rota para retornar quando strategy=navigate.\n\nComponent Capability:\n  - Path: inputs.backConfig.confirmOnDirty\n    Category: inputs\n    Kind: boolean\n    Description: Solicita confirmacao ao sair com mudancas nao salvas.\n\nComponent Capability:\n  - Path: inputs.hooks\n    Category: inputs\n    Kind: object\n    Description: Declaracoes de hooks fornecidas diretamente ao componente.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da inicializacao.\n\nComponent Capability:\n  - Path: inputs.hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a inicializacao.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da validacao.\n\nComponent Capability:\n  - Path: inputs.hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a validacao.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes do submit.\n\nComponent Capability:\n  - Path: inputs.hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos o submit.\n\nComponent Capability:\n  - Path: inputs.hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados em erros de submit/validacao.\n\nComponent Capability:\n  - Path: inputs.removeEmptyContainersOnSave\n    Category: inputs\n    Kind: boolean\n    Description: Remove containers vazios ao salvar configuracao.\n\nComponent Capability:\n  - Path: inputs.reactiveValidation\n    Category: inputs\n    Kind: boolean\n    Description: Ativa validacao reativa (afterValidate em valueChanges).\n\nComponent Capability:\n  - Path: inputs.reactiveValidationDebounceMs\n    Category: inputs\n    Kind: number\n    Description: Debounce em ms para validacao reativa.\n\nComponent Capability:\n  - Path: inputs.notifyIfOutdated\n    Category: inputs\n    Kind: enum\n    Description: Canal de notificacao para schema desatualizado.\n\nComponent Capability:\n  - Path: inputs.snoozeMs\n    Category: inputs\n    Kind: number\n    Description: Duracao do snooze para alertas de schema.\n\nComponent Capability:\n  - Path: inputs.autoOpenSettingsOnOutdated\n    Category: inputs\n    Kind: boolean\n    Description: Abre automaticamente o editor ao detectar schema desatualizado.\n\nComponent Capability:\n  - Path: inputs.readonlyModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo somente leitura global.\n\nComponent Capability:\n  - Path: inputs.disabledModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo desabilitado global.\n\nComponent Capability:\n  - Path: inputs.presentationModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Ativa modo de apresentacao global (somente view).\n\nComponent Capability:\n  - Path: inputs.visibleGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca visibilidade global dos campos.\n\nComponent Capability:\n  - Path: inputs.customEndpoints\n    Category: inputs\n    Kind: object\n    Description: Override de endpoints CRUD (EndpointConfig).\n\nComponent Capability:\n  - Path: inputs.customEndpoints.getAll\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para listar registros.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.getById\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para obter registro por ID.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.create\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para criar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.update\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para atualizar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.delete\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para deletar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.filter\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para filtro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.schema\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para schemas.\n\nComponent Capability:\n  - Path: inputs.config.presentation\n    Category: appearance\n    Kind: object\n    Description: Preferencias visuais persistidas no config.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-ai-capabilities.ts",
-          "contentHash": "3201790d3d1d9216e42135caea0bdbc3ff94f7c46bbeb54a48bb5d700c53d8ff",
+          "contentHash": "e04d360e46c5cf6d9856c9b55a6f140cc7a2fa07a670575bfe1319fd5079b158",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form-dialog-host",
           "corpusVersion": "1.0.0"
@@ -12203,9 +12239,9 @@
         {
           "chunkIndex": 12,
           "chunkKind": "capabilities",
-          "content": "Component Capability:\n  - Path: inputs.config.presentation.valueAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do valor.\n\nComponent Capability:\n  - Path: outputs.formSubmit\n    Category: outputs\n    Kind: object\n    Description: Evento emitido no submit do formulario.\n\nComponent Capability:\n  - Path: outputs.formCancel\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao cancelar.\n\nComponent Capability:\n  - Path: outputs.formReset\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao resetar o formulario.\n\nComponent Capability:\n  - Path: outputs.configChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando a configuracao muda.\n\nComponent Capability:\n  - Path: outputs.formReady\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o formulario esta pronto.\n\nComponent Capability:\n  - Path: outputs.valueChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o valor do formulario muda.\n\nComponent Capability:\n  - Path: outputs.syncCompleted\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao completar sincronizacao com schema.\n\nComponent Capability:\n  - Path: outputs.initializationError\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando ocorre erro na inicializacao.\n\nComponent Capability:\n  - Path: outputs.enableCustomizationChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o modo de customizacao muda.\n\nComponent Capability:\n  - Path: outputs.customAction\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao disparar acao customizada.\n\nComponent Capability:\n  - Path: outputs.actionConfirmation\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando acao requer confirmacao.\n\nComponent Capability:\n  - Path: outputs.schemaStatusChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o status do schema muda.\n\nCapability Note:\n  - Este catalogo descreve inputs e outputs do componente.\n\nCapability Note:\n  - O objeto inputs.config segue o schema de FormConfig (veja form-ai-capabilities).\n\nCapability Note:\n  - inputs.config.presentation e uma extensao de runtime aplicada pelo componente.\n\nCapability Note:\n  - Preferir FormConfig (sections/fieldMetadata) em vez do layout legado (fieldsets).\n\nCapability Note:\n  - Use inputs.editorialContext apenas para override de contexto editorial do host; a precedencia final e runtime < config.editorialContext < host.\n\nCapability Note:\n  - rich content editorial hospedado pelo form pode ser renderizado em tres slots semanticos: before, beforeActions e after.",
+          "content": "Component Capability:\n  - Path: inputs.config.presentation.labelFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do label (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.valueFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do valor (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelPosition\n    Category: appearance\n    Kind: enum\n    Description: Posicionamento do label (above/left).\n\nComponent Capability:\n  - Path: inputs.config.presentation.compact\n    Category: appearance\n    Kind: boolean\n    Description: Modo compacto de apresentacao.\n\nComponent Capability:\n  - Path: inputs.config.presentation.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual global.\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelWidth\n    Category: appearance\n    Kind: number\n    Description: Largura do label (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do label.\n\nComponent Capability:\n  - Path: inputs.config.presentation.valueAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do valor.\n\nComponent Capability:\n  - Path: outputs.formSubmit\n    Category: outputs\n    Kind: object\n    Description: Evento emitido no submit do formulario.\n\nComponent Capability:\n  - Path: outputs.formCancel\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao cancelar.\n\nComponent Capability:\n  - Path: outputs.formReset\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao resetar o formulario.\n\nComponent Capability:\n  - Path: outputs.configChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando a configuracao muda.\n\nComponent Capability:\n  - Path: outputs.formReady\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o formulario esta pronto.\n\nComponent Capability:\n  - Path: outputs.valueChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o valor do formulario muda.\n\nComponent Capability:\n  - Path: outputs.syncCompleted\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao completar sincronizacao com schema.\n\nComponent Capability:\n  - Path: outputs.initializationError\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando ocorre erro na inicializacao.\n\nComponent Capability:\n  - Path: outputs.enableCustomizationChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o modo de customizacao muda.\n\nComponent Capability:\n  - Path: outputs.customAction\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao disparar acao customizada.\n\nComponent Capability:\n  - Path: outputs.actionConfirmation\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando acao requer confirmacao.\n\nComponent Capability:\n  - Path: outputs.schemaStatusChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o status do schema muda.\n\nCapability Note:\n  - Este catalogo descreve inputs e outputs do componente.\n\nCapability Note:\n  - O objeto inputs.config segue o schema de FormConfig (veja form-ai-capabilities).\n\nCapability Note:\n  - inputs.config.presentation e uma extensao de runtime aplicada pelo componente.\n\nCapability Note:\n  - Preferir FormConfig (sections/fieldMetadata) em vez do layout legado (fieldsets).\n\nCapability Note:\n  - Use inputs.editorialContext apenas para override de contexto editorial do host; a precedencia final e runtime < config.editorialContext < host.\n\nCapability Note:\n  - rich content editorial hospedado pelo form pode ser renderizado em tres slots semanticos: before, beforeActions e after.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-ai-capabilities.ts",
-          "contentHash": "0e9fb6b721474a0c25bacf19e9b00e48e90c790f721745ed2438da208ad4a9a0",
+          "contentHash": "beda7b0e56767eb05d2104f64b078e5d582354da389421f4cc5db0853bf87a2a",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form-dialog-host",
           "corpusVersion": "1.0.0"

package/fesm2022/praxisui-crud.mjs

@@ -103,6 +103,7 @@ class CrudLauncherService {
     storage = inject(ASYNC_CONFIG_STORAGE);
     global = inject(GlobalConfigService);
     operationResolver = inject(CrudOperationResolutionService);
+    dialogHostPromise;
     drawerAdapter = (() => {
         try {
             return inject(CRUD_DRAWER_ADAPTER);
@@ -112,6 +113,9 @@ class CrudLauncherService {
         }
     })();
     async launch(action, row, metadata, componentKeyId, drawerCallbacks, runtime) {
+        const prefetchedDialogHost = this.isLikelyOverlayAction(action, metadata)
+            ? this.loadDialogHost()
+            : undefined;
         // Carregar overrides de CRUD (se houver) e mesclar em uma cópia local
         const merged = await this.mergeCrudOverrides(metadata, action, componentKeyId || undefined);
         merged.action = this.normalizeActionForLaunch(merged.action);
@@ -177,7 +181,7 @@ class CrudLauncherService {
             backdropClasses.push('pfx-transparent-backdrop');
         }
         const mergedBackdropClasses = mergeClassList(backdropClasses, modalCfg.backdropClass);
-        const ref = await this.dialog.openAsync(() => Promise.resolve().then(function () { return dynamicFormDialogHost_component; }).then((m) => m.DynamicFormDialogHostComponent), {
+        const ref = await this.dialog.openAsync(() => prefetchedDialogHost ?? this.loadDialogHost(), {
             ...modalCfg,
             panelClass: panelClasses,
             backdropClass: mergedBackdropClasses,
@@ -256,6 +260,13 @@ class CrudLauncherService {
             return 'route';
         }
     }
+    isLikelyOverlayAction(action, metadata) {
+        const configuredMode = action.openMode ?? metadata.defaults?.openMode;
+        return configuredMode === 'drawer' || configuredMode === 'modal';
+    }
+    loadDialogHost() {
+        return this.dialogHostPromise ??= Promise.resolve().then(function () { return dynamicFormDialogHost_component; }).then((module) => module.DynamicFormDialogHostComponent);
+    }
     buildRoute(action, row, metadata) {
         let route = action.route;
         const query = {};
@@ -896,6 +907,9 @@ const PRAXIS_CRUD_RUNTIME_I18N_CONFIG = {
                 'crud.actions.view': 'Ver',
                 'crud.actions.edit': 'Editar',
                 'crud.actions.delete': 'Excluir',
+                'crud.actions.default': 'ação',
+                'crud.actions.opening': 'Abrindo {action}…',
+                'crud.surface.openFailed': 'Não foi possível abrir {title}. Tente novamente ou confirme se esse recurso continua disponível.',
                 'crud.dialog.recordContextLabel': 'Registro em edição',
                 'crud.delete.confirmMessage': 'Esta ação não pode ser desfeita. Deseja continuar?',
                 'crud.delete.cancel': 'Cancelar',
@@ -914,6 +928,9 @@ const PRAXIS_CRUD_RUNTIME_I18N_CONFIG = {
                 'crud.actions.view': 'View',
                 'crud.actions.edit': 'Edit',
                 'crud.actions.delete': 'Delete',
+                'crud.actions.default': 'action',
+                'crud.actions.opening': 'Opening {action}…',
+                'crud.surface.openFailed': 'Could not open {title}. Try again or confirm that this resource is still available.',
                 'crud.dialog.recordContextLabel': 'Record being edited',
                 'crud.delete.confirmMessage': 'This action cannot be undone. Do you want to continue?',
                 'crud.delete.cancel': 'Cancel',
@@ -3664,6 +3681,7 @@ class PraxisCrudComponent {
     tableQueryContext = null;
     tableFilterCriteria = {};
     tableCrudContext;
+    openingActionLabel = signal(null, ...(ngDevMode ? [{ debugName: "openingActionLabel" }] : /* istanbul ignore next */ []));
     launcher = inject(CrudLauncherService);
     http = inject(HttpClient);
     destroyRef = inject(DestroyRef);
@@ -3815,8 +3833,11 @@ class PraxisCrudComponent {
         }
     }
     async onAction(action, row, runtimeEvent) {
+        if (this.openingActionLabel()) {
+            return;
+        }
+        this.openingActionLabel.set(this.resolveOpeningActionLabel(action, runtimeEvent));
         try {
-            document.activeElement?.blur();
             const normalizedAction = this.normalizeCrudActionName(action);
             const contextualRow = row ?? this.resolveSelectedRowForAction(normalizedAction);
             let actionMeta = this.resolvedMetadata.actions?.find((candidate) => this.normalizeCrudActionName(candidate.action) === normalizedAction);
@@ -3921,6 +3942,26 @@ class PraxisCrudComponent {
         catch (err) {
             this.error.emit(err);
         }
+        finally {
+            this.openingActionLabel.set(null);
+        }
+    }
+    getOpeningActionStatus(actionLabel) {
+        return this.txWithParams('crud.actions.opening', 'Abrindo {action}…', { action: actionLabel });
+    }
+    resolveOpeningActionLabel(action, runtimeEvent) {
+        const configuredLabel = String(runtimeEvent?.actionConfig?.label || '').trim();
+        if (configuredLabel) {
+            return configuredLabel;
+        }
+        const normalized = this.normalizeCrudActionName(action);
+        if (normalized === 'create'
+            || normalized === 'view'
+            || normalized === 'edit'
+            || normalized === 'delete') {
+            return this.getCrudActionLabel(normalized);
+        }
+        return String(action || '').trim() || this.tx('crud.actions.default', 'ação');
     }
     hasExplicitOpenBinding(action) {
         const mode = action.openMode;
@@ -4335,9 +4376,6 @@ class PraxisCrudComponent {
             return false;
         }
         const providedSurface = this.resolveProvidedSurface(normalizedAction, this.extractDiscoveryActionConfig(runtimeEvent));
-        if (!providedSurface && !this.isDiscoveryManagedCrudAction(normalizedAction)) {
-            return false;
-        }
         const catalog = providedSurface
             ? null
             : await this.resolveDiscoveredSurfaceCatalog(normalizedAction, row);
@@ -4358,10 +4396,15 @@ class PraxisCrudComponent {
                 endpointKey: this.resolvedMetadata?.resource?.endpointKey,
                 apiUrlEntry: this.resolveDiscoveryApiEntry(),
                 group: catalog?.group ?? null,
+                presentation: 'drawer',
+                title: surface.title,
+                subtitle: surface.description ?? undefined,
             });
         }
-        catch {
-            return false;
+        catch (error) {
+            this.error.emit(error);
+            this.snack.open(this.txWithParams('crud.surface.openFailed', 'Não foi possível abrir {title}. Tente novamente ou confirme se esse recurso continua disponível.', { title: surface.title || surface.id }), undefined, { duration: 4500 });
+            return true;
         }
         let openPromise;
         try {
@@ -4393,9 +4436,12 @@ class PraxisCrudComponent {
             mode: this.mapSurfacePresentationToCrudMode(payload?.presentation),
             action,
         });
-        void openPromise
-            .then((result) => this.handleDiscoveredSurfaceResult(result))
-            .catch((err) => this.error.emit(err));
+        try {
+            this.bindDiscoveredSurfaceLifecycle(await openPromise);
+        }
+        catch (err) {
+            this.error.emit(err);
+        }
         return true;
     }
     async resolveDiscoveredSurfaceCatalog(action, row) {
@@ -4518,13 +4564,13 @@ class PraxisCrudComponent {
         }
         return catalogCandidate;
     }
-    resolveProvidedSurface(action, candidate) {
+    resolveProvidedSurface(_action, candidate) {
         if (!candidate || typeof candidate !== 'object') {
             return null;
         }
         const catalogCandidate = candidate;
         const normalizedId = String(catalogCandidate.id || '').trim().toLowerCase();
-        if (!normalizedId || normalizedId !== action) {
+        if (!normalizedId) {
             return null;
         }
         const surface = catalogCandidate;
@@ -4540,6 +4586,10 @@ class PraxisCrudComponent {
         const candidates = surfaces
             .filter((surface) => surface.availability?.allowed !== false)
             .sort((left, right) => (left.order ?? 0) - (right.order ?? 0));
+        const exact = candidates.find((surface) => String(surface.id || '').trim().toLowerCase() === action);
+        if (exact) {
+            return exact;
+        }
         const preferredIds = this.getPreferredSurfaceIdsForCrudAction(action);
         const preferred = candidates.find((surface) => preferredIds.includes(String(surface.id || '').trim().toLowerCase()));
         if (preferred) {
@@ -4600,7 +4650,6 @@ class PraxisCrudComponent {
         return presentation === 'modal' ? 'modal' : 'drawer';
     }
     handleDiscoveredSurfaceResult(result) {
-        this.afterClose.emit();
         const data = (result?.data || {});
         const idField = this.getIdField();
         if (result?.type === 'save') {
@@ -4614,6 +4663,34 @@ class PraxisCrudComponent {
             this.refreshTable();
         }
     }
+    bindDiscoveredSurfaceLifecycle(ref) {
+        const surfaceRef = ref;
+        if (!surfaceRef)
+            return;
+        let terminalResultHandled = false;
+        let closeHandled = false;
+        const handleResult = (result) => {
+            const type = String(result?.type || '');
+            if (terminalResultHandled || (type !== 'save' && type !== 'delete'))
+                return;
+            terminalResultHandled = true;
+            this.handleDiscoveredSurfaceResult(result);
+        };
+        surfaceRef.result$?.pipe(takeUntilDestroyed(this.destroyRef)).subscribe(handleResult);
+        const handleClose = (result) => {
+            handleResult(result);
+            if (closeHandled)
+                return;
+            closeHandled = true;
+            this.afterClose.emit();
+        };
+        if (surfaceRef.closed$) {
+            surfaceRef.closed$.pipe(takeUntilDestroyed(this.destroyRef)).subscribe(handleClose);
+        }
+        else {
+            surfaceRef.afterClosed?.().pipe(takeUntilDestroyed(this.destroyRef)).subscribe(handleClose);
+        }
+    }
     buildEffectiveTableConfig(meta, capabilities) {
         const base = meta.table;
         const current = this.getCurrentTableConfigSnapshot();
@@ -5161,38 +5238,46 @@ class PraxisCrudComponent {
             providePraxisI18nConfig(RESOURCE_DISCOVERY_I18N_CONFIG),
             providePraxisI18nConfig(PRAXIS_CRUD_RUNTIME_I18N_CONFIG),
         ], viewQueries: [{ propertyName: "table", first: true, predicate: PraxisTable, descendants: true }], usesOnChanges: true, ngImport: i0, template: `
-    @if (shouldRenderTable(resolvedMetadata)) {
-      <praxis-table
-        [config]="tableConfigForBinding"
-        [resourcePath]="resolveResourcePath(resolvedMetadata)"
-        [data]="resolveTableData(resolvedMetadata)"
-        [queryContext]="tableQueryContext"
-        [filterCriteria]="tableFilterCriteria"
-        [tableId]="crudId || 'default'"
-        [crudContext]="tableCrudContext"
-        [enableCustomization]="enableCustomization"
-        [authoringCapability]="authoringCapability"
-        (rowClick)="onTableRowClick($event)"
-        (selectionChange)="onTableSelectionChange($event)"
-        (rowAction)="onAction($event.action, $event.row, $event)"
-        (toolbarAction)="onToolbarAction($event)"
-        (bulkAction)="onBulkAction($event)"
-        (collectionLinksChange)="onCollectionLinksChange($event)"
-        (reset)="onResetPreferences()"
-        (metadataChange)="onTableMetadataChange()"
-        (loadingStateChange)="onTableLoadingStateChange($event)"
-      ></praxis-table>
-    } @else {
-      @if (isCustomizationAvailable()) {
-        <praxis-empty-state-card
-          icon="table_rows"
-          [title]="getEmptyStateTitle()"
-          [description]="getEmptyStateDescription()"
-          [primaryAction]="{ label: getEmptyStatePrimaryAction(), icon: 'bolt', action: onConfigureRequested.bind(this) }"
-        />
+    <div class="praxis-crud-runtime" [attr.aria-busy]="openingActionLabel() ? 'true' : null">
+      @if (openingActionLabel(); as actionLabel) {
+        <div class="praxis-crud-opening-status" role="status" aria-live="polite" data-testid="praxis-crud-opening-status">
+          <span class="praxis-crud-opening-status__spinner" aria-hidden="true"></span>
+          <span>{{ getOpeningActionStatus(actionLabel) }}</span>
+        </div>
       }
-    }
-  `, isInline: true, styles: [":host{display:block;width:100%;min-width:0;max-width:100%}\n"], dependencies: [{ kind: "component", type: PraxisTable, selector: "praxis-table", inputs: ["config", "resourcePath", "data", "tableId", "componentInstanceId", "configPersistenceStrategy", "title", "subtitle", "icon", "autoDelete", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "crudContext", "filterCriteria", "queryContext", "aiContext", "aiAssistantVoiceInputMode", "aiAssistantVoiceLanguage", "horizontalScroll", "enableCustomization", "authoringCapability", "dense"], outputs: ["rowClick", "widgetEvent", "resourceEvent", "rowDoubleClick", "rowExpansionChange", "rowAction", "toolbarAction", "bulkAction", "exportAction", "columnReorder", "columnReorderAttempt", "columnResize", "beforeDelete", "afterDelete", "deleteError", "beforeBulkDelete", "afterBulkDelete", "bulkDeleteError", "schemaStatusChange", "configChange", "metadataChange", "loadingStateChange", "collectionLinksChange", "selectionChange"] }, { kind: "component", type: EmptyStateCardComponent, selector: "praxis-empty-state-card", inputs: ["icon", "title", "description", "primaryAction", "secondaryActions", "inline", "tone", "variant", "alignment", "density", "iconContainer"] }] });
+      @if (shouldRenderTable(resolvedMetadata)) {
+        <praxis-table
+          [config]="tableConfigForBinding"
+          [resourcePath]="resolveResourcePath(resolvedMetadata)"
+          [data]="resolveTableData(resolvedMetadata)"
+          [queryContext]="tableQueryContext"
+          [filterCriteria]="tableFilterCriteria"
+          [tableId]="crudId || 'default'"
+          [crudContext]="tableCrudContext"
+          [enableCustomization]="enableCustomization"
+          [authoringCapability]="authoringCapability"
+          (rowClick)="onTableRowClick($event)"
+          (selectionChange)="onTableSelectionChange($event)"
+          (rowAction)="onAction($event.action, $event.row, $event)"
+          (toolbarAction)="onToolbarAction($event)"
+          (bulkAction)="onBulkAction($event)"
+          (collectionLinksChange)="onCollectionLinksChange($event)"
+          (reset)="onResetPreferences()"
+          (metadataChange)="onTableMetadataChange()"
+          (loadingStateChange)="onTableLoadingStateChange($event)"
+        ></praxis-table>
+      } @else {
+        @if (isCustomizationAvailable()) {
+          <praxis-empty-state-card
+            icon="table_rows"
+            [title]="getEmptyStateTitle()"
+            [description]="getEmptyStateDescription()"
+            [primaryAction]="{ label: getEmptyStatePrimaryAction(), icon: 'bolt', action: onConfigureRequested.bind(this) }"
+          />
+        }
+      }
+    </div>
+  `, isInline: true, styles: [":host{display:block;width:100%;min-width:0;max-width:100%}.praxis-crud-runtime{position:relative;min-width:0}.praxis-crud-opening-status{position:absolute;z-index:6;top:.7rem;right:.7rem;display:inline-flex;align-items:center;gap:.55rem;min-height:2.25rem;max-width:min(24rem,calc(100% - 1.4rem));padding:.48rem .72rem;border:1px solid color-mix(in srgb,var(--md-sys-color-primary, #3f51b5) 32%,transparent);border-radius:999px;color:var(--md-sys-color-on-surface, currentColor);background:color-mix(in srgb,var(--md-sys-color-surface-container-high, #fff) 94%,transparent);box-shadow:0 10px 28px #0f172a29;font-size:.82rem;font-weight:650;line-height:1.25;pointer-events:none}.praxis-crud-opening-status__spinner{width:.95rem;height:.95rem;flex:0 0 auto;border:2px solid color-mix(in srgb,var(--md-sys-color-primary, #3f51b5) 26%,transparent);border-top-color:var(--md-sys-color-primary, #3f51b5);border-radius:50%;animation:praxis-crud-opening-spin .72s linear infinite}@keyframes praxis-crud-opening-spin{to{transform:rotate(360deg)}}@media(prefers-reduced-motion:reduce){.praxis-crud-opening-status__spinner{animation:none;border-top-color:currentColor}}\n"], dependencies: [{ kind: "component", type: PraxisTable, selector: "praxis-table", inputs: ["config", "resourcePath", "data", "tableId", "componentInstanceId", "configPersistenceStrategy", "title", "subtitle", "icon", "autoDelete", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "crudContext", "filterCriteria", "queryContext", "aiContext", "aiAssistantVoiceInputMode", "aiAssistantVoiceLanguage", "horizontalScroll", "enableCustomization", "authoringCapability", "dense"], outputs: ["rowClick", "widgetEvent", "resourceEvent", "rowDoubleClick", "rowExpansionChange", "rowAction", "toolbarAction", "bulkAction", "exportAction", "columnReorder", "columnReorderAttempt", "columnResize", "beforeDelete", "afterDelete", "deleteError", "beforeBulkDelete", "afterBulkDelete", "bulkDeleteError", "schemaStatusChange", "configChange", "metadataChange", "loadingStateChange", "collectionLinksChange", "selectionChange"] }, { kind: "component", type: EmptyStateCardComponent, selector: "praxis-empty-state-card", inputs: ["icon", "title", "description", "primaryAction", "secondaryActions", "inline", "tone", "variant", "alignment", "density", "iconContainer"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisCrudComponent, decorators: [{
             type: Component,
@@ -5200,38 +5285,46 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                         providePraxisI18nConfig(RESOURCE_DISCOVERY_I18N_CONFIG),
                         providePraxisI18nConfig(PRAXIS_CRUD_RUNTIME_I18N_CONFIG),
                     ], template: `
-    @if (shouldRenderTable(resolvedMetadata)) {
-      <praxis-table
-        [config]="tableConfigForBinding"
-        [resourcePath]="resolveResourcePath(resolvedMetadata)"
-        [data]="resolveTableData(resolvedMetadata)"
-        [queryContext]="tableQueryContext"
-        [filterCriteria]="tableFilterCriteria"
-        [tableId]="crudId || 'default'"
-        [crudContext]="tableCrudContext"
-        [enableCustomization]="enableCustomization"
-        [authoringCapability]="authoringCapability"
-        (rowClick)="onTableRowClick($event)"
-        (selectionChange)="onTableSelectionChange($event)"
-        (rowAction)="onAction($event.action, $event.row, $event)"
-        (toolbarAction)="onToolbarAction($event)"
-        (bulkAction)="onBulkAction($event)"
-        (collectionLinksChange)="onCollectionLinksChange($event)"
-        (reset)="onResetPreferences()"
-        (metadataChange)="onTableMetadataChange()"
-        (loadingStateChange)="onTableLoadingStateChange($event)"
-      ></praxis-table>
-    } @else {
-      @if (isCustomizationAvailable()) {
-        <praxis-empty-state-card
-          icon="table_rows"
-          [title]="getEmptyStateTitle()"
-          [description]="getEmptyStateDescription()"
-          [primaryAction]="{ label: getEmptyStatePrimaryAction(), icon: 'bolt', action: onConfigureRequested.bind(this) }"
-        />
+    <div class="praxis-crud-runtime" [attr.aria-busy]="openingActionLabel() ? 'true' : null">
+      @if (openingActionLabel(); as actionLabel) {
+        <div class="praxis-crud-opening-status" role="status" aria-live="polite" data-testid="praxis-crud-opening-status">
+          <span class="praxis-crud-opening-status__spinner" aria-hidden="true"></span>
+          <span>{{ getOpeningActionStatus(actionLabel) }}</span>
+        </div>
       }
-    }
-  `, styles: [":host{display:block;width:100%;min-width:0;max-width:100%}\n"] }]
+      @if (shouldRenderTable(resolvedMetadata)) {
+        <praxis-table
+          [config]="tableConfigForBinding"
+          [resourcePath]="resolveResourcePath(resolvedMetadata)"
+          [data]="resolveTableData(resolvedMetadata)"
+          [queryContext]="tableQueryContext"
+          [filterCriteria]="tableFilterCriteria"
+          [tableId]="crudId || 'default'"
+          [crudContext]="tableCrudContext"
+          [enableCustomization]="enableCustomization"
+          [authoringCapability]="authoringCapability"
+          (rowClick)="onTableRowClick($event)"
+          (selectionChange)="onTableSelectionChange($event)"
+          (rowAction)="onAction($event.action, $event.row, $event)"
+          (toolbarAction)="onToolbarAction($event)"
+          (bulkAction)="onBulkAction($event)"
+          (collectionLinksChange)="onCollectionLinksChange($event)"
+          (reset)="onResetPreferences()"
+          (metadataChange)="onTableMetadataChange()"
+          (loadingStateChange)="onTableLoadingStateChange($event)"
+        ></praxis-table>
+      } @else {
+        @if (isCustomizationAvailable()) {
+          <praxis-empty-state-card
+            icon="table_rows"
+            [title]="getEmptyStateTitle()"
+            [description]="getEmptyStateDescription()"
+            [primaryAction]="{ label: getEmptyStatePrimaryAction(), icon: 'bolt', action: onConfigureRequested.bind(this) }"
+          />
+        }
+      }
+    </div>
+  `, styles: [":host{display:block;width:100%;min-width:0;max-width:100%}.praxis-crud-runtime{position:relative;min-width:0}.praxis-crud-opening-status{position:absolute;z-index:6;top:.7rem;right:.7rem;display:inline-flex;align-items:center;gap:.55rem;min-height:2.25rem;max-width:min(24rem,calc(100% - 1.4rem));padding:.48rem .72rem;border:1px solid color-mix(in srgb,var(--md-sys-color-primary, #3f51b5) 32%,transparent);border-radius:999px;color:var(--md-sys-color-on-surface, currentColor);background:color-mix(in srgb,var(--md-sys-color-surface-container-high, #fff) 94%,transparent);box-shadow:0 10px 28px #0f172a29;font-size:.82rem;font-weight:650;line-height:1.25;pointer-events:none}.praxis-crud-opening-status__spinner{width:.95rem;height:.95rem;flex:0 0 auto;border:2px solid color-mix(in srgb,var(--md-sys-color-primary, #3f51b5) 26%,transparent);border-top-color:var(--md-sys-color-primary, #3f51b5);border-radius:50%;animation:praxis-crud-opening-spin .72s linear infinite}@keyframes praxis-crud-opening-spin{to{transform:rotate(360deg)}}@media(prefers-reduced-motion:reduce){.praxis-crud-opening-status__spinner{animation:none;border-top-color:currentColor}}\n"] }]
         }], ctorParameters: () => [], propDecorators: { metadata: [{
                 type: Input,
                 args: [{ required: true }]
@@ -5458,6 +5551,22 @@ class DynamicFormDialogHostComponent {
             deriveModeTitle(this.mode, this.resolveResourceTitle()) ||
             this.texts.title;
     }
+    get dialogSubtitle() {
+        const action = this.data.action ?? {};
+        const form = this.formConfig;
+        const resource = this.data.metadata?.resource ?? {};
+        const table = this.data.metadata?.table ?? {};
+        return stringOrUndefined(action.description ??
+            action.tooltip ??
+            form['description'] ??
+            resource.description ??
+            table.subtitle ??
+            table.description);
+    }
+    get dialogIcon() {
+        const action = this.data.action ?? {};
+        return stringOrUndefined(action.icon ?? this.modal.titleIcon ?? this.modal.icon);
+    }
     resolveActionDialogTitle() {
         const actionLabel = stringOrUndefined(this.data.action?.label);
         if (!actionLabel) {
@@ -5709,9 +5818,21 @@ class DynamicFormDialogHostComponent {
             providePraxisI18nConfig(PRAXIS_CRUD_RUNTIME_I18N_CONFIG),
         ], viewQueries: [{ propertyName: "formComp", first: true, predicate: PraxisDynamicForm, descendants: true }], ngImport: i0, template: `
     <div mat-dialog-title class="dialog-header">
-      <h2 id="crudDialogTitle" class="dialog-title">
-        {{ dialogTitle }}
-      </h2>
+      @if (dialogIcon; as icon) {
+        <span class="dialog-title-icon" aria-hidden="true">
+          <mat-icon [praxisIcon]="icon"></mat-icon>
+        </span>
+      }
+      <span class="dialog-heading">
+        <h2 id="crudDialogTitle" class="dialog-title">
+          {{ dialogTitle }}
+        </h2>
+        @if (dialogSubtitle; as subtitle) {
+          <span id="crudDialogDescription" class="dialog-subtitle">
+            {{ subtitle }}
+          </span>
+        }
+      </span>
       <span class="spacer"></span>
       @if (modal.canMaximize) {
         <button
@@ -5735,6 +5856,7 @@ class DynamicFormDialogHostComponent {
     <mat-dialog-content
       class="dialog-content"
       aria-labelledby="crudDialogTitle"
+      [attr.aria-describedby]="dialogSubtitle ? 'crudDialogDescription' : null"
     >
       @if (resourceIdentity) {
         <div class="crud-resource-identity" data-testid="crud-resource-identity">
@@ -5770,13 +5892,15 @@ class DynamicFormDialogHostComponent {
         (formCancel)="onCancel()"
       ></praxis-dynamic-form>
     </mat-dialog-content>
-  `, isInline: true, styles: ["praxis-dynamic-form-dialog-host{--dlg-header-h: 56px;--dlg-footer-h: 56px;--dlg-pad: 16px;display:flex;flex-direction:column;height:100%;overflow:hidden}praxis-dynamic-form-dialog-host[data-density=compact]{--dlg-header-h: 44px;--dlg-footer-h: 44px;--dlg-pad: 12px}praxis-dynamic-form-dialog-host .dialog-header{position:sticky;top:0;z-index:1;display:flex;align-items:center;gap:var(--dlg-pad);padding:0 var(--dlg-pad);height:var(--dlg-header-h);margin:0;background:var(--md-sys-color-surface-container-high);border-bottom:1px solid var(--md-sys-color-outline-variant);color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host .dialog-title{margin:0;font:inherit;font-weight:600;color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host .spacer{flex:1}praxis-dynamic-form-dialog-host .dialog-content{flex:1 1 auto;overflow:auto;padding:var(--dlg-pad);max-height:calc(100svh - var(--dlg-header-h) - 32px)}praxis-dynamic-form-dialog-host .crud-resource-identity{position:sticky;top:0;z-index:1;display:grid;gap:.25rem;margin-block-end:var(--dlg-pad);padding-block:.5rem .75rem;background:var(--pfx-form-surface, var(--md-sys-color-surface));border-bottom:1px solid var(--md-sys-color-outline-variant)}praxis-dynamic-form-dialog-host .crud-resource-identity__label{color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-label-medium, 500 .75rem/1rem inherit)}praxis-dynamic-form-dialog-host.praxis-drawer{--dlg-header-h: 64px;width:100%;min-width:0;max-width:100vw;height:100dvh;background:var(--pfx-form-surface, var(--md-sys-color-surface));color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-header{background:color-mix(in srgb,var(--md-sys-color-surface-container-high, var(--md-sys-color-surface)),transparent 4%)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-content{max-height:none;min-height:0;padding:clamp(12px,2.4vw,24px)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button{color:var(--md-sys-color-on-surface-variant)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button:hover{color:var(--md-sys-color-primary)}praxis-dynamic-form-dialog-host .dialog-footer{position:sticky;bottom:0;z-index:1;padding:var(--dlg-pad)}.pfx-blur-backdrop{background-color:var(--pfx-backdrop, rgba(15, 23, 42, .42))!important;backdrop-filter:blur(var(--pfx-backdrop-blur, 10px)) saturate(110%);-webkit-backdrop-filter:blur(var(--pfx-backdrop-blur, 10px)) saturate(110%)}.pfx-transparent-backdrop{background-color:transparent!important}.cdk-overlay-pane.pfx-dialog-pane{overflow:hidden;transition:width .2s ease,height .2s ease,margin .2s ease}.cdk-overlay-pane.pfx-dialog-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-dialog-pane .mdc-dialog__surface{display:flex;flex-direction:column;width:100%;height:100%;max-height:inherit;overflow:hidden;background:var(--pfx-form-surface, var(--md-sys-color-surface))!important;border:1px solid var(--pfx-form-stroke, var(--md-sys-color-outline-variant))!important}.cdk-overlay-pane.pfx-dialog-pane.pfx-dialog-frosted .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-dialog-pane.pfx-dialog-frosted .mdc-dialog__surface{backdrop-filter:blur(8px);-webkit-backdrop-filter:blur(8px)}.cdk-overlay-pane.pfx-drawer-pane{margin:0!important;border-radius:0!important;box-shadow:var(--md-sys-elevation-level3, 0 24px 80px rgba(15, 23, 42, .28)),0 0 0 1px color-mix(in srgb,var(--md-sys-color-outline, #64748b) 24%,transparent)}.cdk-overlay-pane.pfx-drawer-pane.pfx-drawer-maximized{margin:var(--pfx-drawer-edge-gap, 8px)!important}.cdk-overlay-pane.pfx-drawer-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-drawer-pane .mdc-dialog__surface{border-radius:0!important}\n"], dependencies: [{ kind: "ngmodule", type: MatDialogModule }, { kind: "directive", type: i1.MatDialogTitle, selector: "[mat-dialog-title], [matDialogTitle]", inputs: ["id"], exportAs: ["matDialogTitle"] }, { kind: "directive", type: i1.MatDialogContent, selector: "[mat-dialog-content], mat-dialog-content, [matDialogContent]" }, { kind: "component", type: PraxisIconButtonComponent, selector: "button[praxisIconButton]", inputs: ["praxisIconButton", "size", "appearance", "presentation", "pressed", "busy"] }, { kind: "component", type: PraxisResourceIdentityComponent, selector: "praxis-resource-identity", inputs: ["identity", "emptyTitle", "density", "showMetadataLabels", "showKeyLabel", "ariaLabel"] }, { kind: "component", type: PraxisDynamicForm, selector: "praxis-dynamic-form", inputs: ["resourcePath", "resourceId", "initialValue", "editorialContext", "mode", "config", "actions", "schemaSource", "schemaUrl", "readUrl", "submitUrl", "submitMethod", "responseSchemaUrl", "apiEndpointKey", "apiUrlEntry", "enableCustomization", "showAiAssistant", "formId", "componentInstanceId", "configPersistenceStrategy", "layout", "generatedLayoutPreset", "layoutPolicy", "backConfig", "hooks", "removeEmptyContainersOnSave", "reactiveValidation", "reactiveValidationDebounceMs", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "readonlyModeGlobal", "disabledModeGlobal", "presentationModeGlobal", "visibleGlobal", "fieldIconPolicy", "domainRules", "customEndpoints"], outputs: ["formSubmit", "formCancel", "formReset", "configChange", "configPatchChange", "formReady", "valueChange", "syncCompleted", "initializationError", "loadingStateChange", "enableCustomizationChange", "customAction", "actionConfirmation", "schemaStatusChange", "fieldRenderError", "ruleDiagnosticsChange"] }], encapsulation: i0.ViewEncapsulation.None });
+  `, isInline: true, styles: ["praxis-dynamic-form-dialog-host{--dlg-header-h: 56px;--dlg-footer-h: 56px;--dlg-pad: 16px;display:flex;flex-direction:column;height:100%;overflow:hidden}praxis-dynamic-form-dialog-host[data-density=compact]{--dlg-header-h: 44px;--dlg-footer-h: 44px;--dlg-pad: 12px}praxis-dynamic-form-dialog-host .dialog-header{position:sticky;top:0;z-index:1;display:flex;align-items:center;gap:var(--dlg-pad);min-height:var(--dlg-header-h);padding:10px var(--dlg-pad);margin:0;background:var(--md-sys-color-surface-container-high);border-bottom:1px solid var(--md-sys-color-outline-variant);color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host .dialog-title{margin:0;font:inherit;font-weight:600;color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host .dialog-heading{display:grid;min-width:0;gap:2px}praxis-dynamic-form-dialog-host .dialog-title-icon{display:inline-grid;flex:0 0 auto;width:36px;height:36px;place-items:center;border-radius:10px;color:var(--md-sys-color-primary);background:color-mix(in srgb,var(--md-sys-color-primary) 12%,transparent)}praxis-dynamic-form-dialog-host .dialog-title-icon mat-icon{width:22px;height:22px;font-size:22px}praxis-dynamic-form-dialog-host .dialog-subtitle{display:-webkit-box;overflow:hidden;color:var(--md-sys-color-on-surface-variant);font-size:.82rem;font-weight:400;line-height:1.35;-webkit-box-orient:vertical;-webkit-line-clamp:2}praxis-dynamic-form-dialog-host .spacer{flex:1}praxis-dynamic-form-dialog-host .dialog-content{flex:1 1 auto;overflow:auto;padding:var(--dlg-pad);max-height:calc(100svh - var(--dlg-header-h) - 32px)}praxis-dynamic-form-dialog-host .crud-resource-identity{position:sticky;top:0;z-index:1;display:grid;gap:.25rem;margin-block-end:var(--dlg-pad);padding-block:.5rem .75rem;background:var(--pfx-form-surface, var(--md-sys-color-surface));border-bottom:1px solid var(--md-sys-color-outline-variant)}praxis-dynamic-form-dialog-host .crud-resource-identity__label{color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-label-medium, 500 .75rem/1rem inherit)}praxis-dynamic-form-dialog-host.praxis-drawer{--dlg-header-h: 72px;width:100%;min-width:0;max-width:100vw;height:100dvh;background:var(--pfx-form-surface, var(--md-sys-color-surface));color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-header{background:color-mix(in srgb,var(--md-sys-color-surface-container-high, var(--md-sys-color-surface)),transparent 4%)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-content{max-height:none;min-height:0;padding:clamp(12px,2.4vw,24px)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button{color:var(--md-sys-color-on-surface-variant)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button:hover{color:var(--md-sys-color-primary)}praxis-dynamic-form-dialog-host .dialog-footer{position:sticky;bottom:0;z-index:1;padding:var(--dlg-pad)}.pfx-blur-backdrop{background-color:var(--pfx-backdrop, rgba(15, 23, 42, .42))!important;backdrop-filter:blur(var(--pfx-backdrop-blur, 10px)) saturate(110%);-webkit-backdrop-filter:blur(var(--pfx-backdrop-blur, 10px)) saturate(110%)}.pfx-transparent-backdrop{background-color:transparent!important}.cdk-overlay-pane.pfx-dialog-pane{overflow:hidden;transition:width .2s ease,height .2s ease,margin .2s ease}.cdk-overlay-pane.pfx-dialog-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-dialog-pane .mdc-dialog__surface{display:flex;flex-direction:column;width:100%;min-width:0;height:100%;max-height:inherit;overflow:hidden;background:var(--pfx-form-surface, var(--md-sys-color-surface))!important;border:1px solid var(--pfx-form-stroke, var(--md-sys-color-outline-variant))!important}.cdk-overlay-pane.pfx-dialog-pane.pfx-dialog-frosted .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-dialog-pane.pfx-dialog-frosted .mdc-dialog__surface{backdrop-filter:blur(8px);-webkit-backdrop-filter:blur(8px)}.cdk-overlay-pane.pfx-drawer-pane{margin:0!important;border-radius:0!important;box-shadow:var(--md-sys-elevation-level3, 0 24px 80px rgba(15, 23, 42, .28)),0 0 0 1px color-mix(in srgb,var(--md-sys-color-outline, #64748b) 24%,transparent)}.cdk-overlay-pane.pfx-drawer-pane.pfx-drawer-maximized{margin:var(--pfx-drawer-edge-gap, 8px)!important}.cdk-overlay-pane.pfx-drawer-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-drawer-pane .mdc-dialog__surface{min-width:0!important;border-radius:0!important}\n"], dependencies: [{ kind: "ngmodule", type: MatDialogModule }, { kind: "directive", type: i1.MatDialogTitle, selector: "[mat-dialog-title], [matDialogTitle]", inputs: ["id"], exportAs: ["matDialogTitle"] }, { kind: "directive", type: i1.MatDialogContent, selector: "[mat-dialog-content], mat-dialog-content, [matDialogContent]" }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i6.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "component", type: PraxisIconButtonComponent, selector: "button[praxisIconButton]", inputs: ["praxisIconButton", "size", "appearance", "presentation", "pressed", "busy"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "component", type: PraxisResourceIdentityComponent, selector: "praxis-resource-identity", inputs: ["identity", "emptyTitle", "density", "showMetadataLabels", "showKeyLabel", "ariaLabel"] }, { kind: "component", type: PraxisDynamicForm, selector: "praxis-dynamic-form", inputs: ["resourcePath", "resourceId", "initialValue", "editorialContext", "mode", "config", "actions", "schemaSource", "schemaUrl", "readUrl", "submitUrl", "submitMethod", "submitIdempotencyKey", "submitCorrelationId", "submitResourceVersion", "responseSchemaUrl", "apiEndpointKey", "apiUrlEntry", "enableCustomization", "showAiAssistant", "formId", "componentInstanceId", "configPersistenceStrategy", "layout", "generatedLayoutPreset", "layoutPolicy", "backConfig", "hooks", "removeEmptyContainersOnSave", "reactiveValidation", "reactiveValidationDebounceMs", "notifyIfOutdated", "snoozeMs", "autoOpenSettingsOnOutdated", "readonlyModeGlobal", "disabledModeGlobal", "presentationModeGlobal", "visibleGlobal", "fieldIconPolicy", "domainRules", "customEndpoints"], outputs: ["formSubmit", "formCancel", "formReset", "configChange", "configPatchChange", "formReady", "valueChange", "syncCompleted", "initializationError", "loadingStateChange", "enableCustomizationChange", "customAction", "actionConfirmation", "schemaStatusChange", "fieldRenderError", "ruleDiagnosticsChange"] }], encapsulation: i0.ViewEncapsulation.None });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: DynamicFormDialogHostComponent, decorators: [{
             type: Component,
             args: [{ selector: 'praxis-dynamic-form-dialog-host', standalone: true, imports: [
                         MatDialogModule,
+                        MatIconModule,
                         PraxisIconButtonComponent,
+                        PraxisIconDirective,
                         PraxisResourceIdentityComponent,
                         PraxisDynamicForm
                     ], encapsulation: ViewEncapsulation.None, providers: [
@@ -5789,9 +5913,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                         '[class.praxis-drawer]': 'presentation === "drawer"',
                     }, template: `
     <div mat-dialog-title class="dialog-header">
-      <h2 id="crudDialogTitle" class="dialog-title">
-        {{ dialogTitle }}
-      </h2>
+      @if (dialogIcon; as icon) {
+        <span class="dialog-title-icon" aria-hidden="true">
+          <mat-icon [praxisIcon]="icon"></mat-icon>
+        </span>
+      }
+      <span class="dialog-heading">
+        <h2 id="crudDialogTitle" class="dialog-title">
+          {{ dialogTitle }}
+        </h2>
+        @if (dialogSubtitle; as subtitle) {
+          <span id="crudDialogDescription" class="dialog-subtitle">
+            {{ subtitle }}
+          </span>
+        }
+      </span>
       <span class="spacer"></span>
       @if (modal.canMaximize) {
         <button
@@ -5815,6 +5951,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
     <mat-dialog-content
       class="dialog-content"
       aria-labelledby="crudDialogTitle"
+      [attr.aria-describedby]="dialogSubtitle ? 'crudDialogDescription' : null"
     >
       @if (resourceIdentity) {
         <div class="crud-resource-identity" data-testid="crud-resource-identity">
@@ -5850,7 +5987,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
         (formCancel)="onCancel()"
       ></praxis-dynamic-form>
     </mat-dialog-content>
-  `, styles: ["praxis-dynamic-form-dialog-host{--dlg-header-h: 56px;--dlg-footer-h: 56px;--dlg-pad: 16px;display:flex;flex-direction:column;height:100%;overflow:hidden}praxis-dynamic-form-dialog-host[data-density=compact]{--dlg-header-h: 44px;--dlg-footer-h: 44px;--dlg-pad: 12px}praxis-dynamic-form-dialog-host .dialog-header{position:sticky;top:0;z-index:1;display:flex;align-items:center;gap:var(--dlg-pad);padding:0 var(--dlg-pad);height:var(--dlg-header-h);margin:0;background:var(--md-sys-color-surface-container-high);border-bottom:1px solid var(--md-sys-color-outline-variant);color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host .dialog-title{margin:0;font:inherit;font-weight:600;color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host .spacer{flex:1}praxis-dynamic-form-dialog-host .dialog-content{flex:1 1 auto;overflow:auto;padding:var(--dlg-pad);max-height:calc(100svh - var(--dlg-header-h) - 32px)}praxis-dynamic-form-dialog-host .crud-resource-identity{position:sticky;top:0;z-index:1;display:grid;gap:.25rem;margin-block-end:var(--dlg-pad);padding-block:.5rem .75rem;background:var(--pfx-form-surface, var(--md-sys-color-surface));border-bottom:1px solid var(--md-sys-color-outline-variant)}praxis-dynamic-form-dialog-host .crud-resource-identity__label{color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-label-medium, 500 .75rem/1rem inherit)}praxis-dynamic-form-dialog-host.praxis-drawer{--dlg-header-h: 64px;width:100%;min-width:0;max-width:100vw;height:100dvh;background:var(--pfx-form-surface, var(--md-sys-color-surface));color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-header{background:color-mix(in srgb,var(--md-sys-color-surface-container-high, var(--md-sys-color-surface)),transparent 4%)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-content{max-height:none;min-height:0;padding:clamp(12px,2.4vw,24px)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button{color:var(--md-sys-color-on-surface-variant)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button:hover{color:var(--md-sys-color-primary)}praxis-dynamic-form-dialog-host .dialog-footer{position:sticky;bottom:0;z-index:1;padding:var(--dlg-pad)}.pfx-blur-backdrop{background-color:var(--pfx-backdrop, rgba(15, 23, 42, .42))!important;backdrop-filter:blur(var(--pfx-backdrop-blur, 10px)) saturate(110%);-webkit-backdrop-filter:blur(var(--pfx-backdrop-blur, 10px)) saturate(110%)}.pfx-transparent-backdrop{background-color:transparent!important}.cdk-overlay-pane.pfx-dialog-pane{overflow:hidden;transition:width .2s ease,height .2s ease,margin .2s ease}.cdk-overlay-pane.pfx-dialog-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-dialog-pane .mdc-dialog__surface{display:flex;flex-direction:column;width:100%;height:100%;max-height:inherit;overflow:hidden;background:var(--pfx-form-surface, var(--md-sys-color-surface))!important;border:1px solid var(--pfx-form-stroke, var(--md-sys-color-outline-variant))!important}.cdk-overlay-pane.pfx-dialog-pane.pfx-dialog-frosted .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-dialog-pane.pfx-dialog-frosted .mdc-dialog__surface{backdrop-filter:blur(8px);-webkit-backdrop-filter:blur(8px)}.cdk-overlay-pane.pfx-drawer-pane{margin:0!important;border-radius:0!important;box-shadow:var(--md-sys-elevation-level3, 0 24px 80px rgba(15, 23, 42, .28)),0 0 0 1px color-mix(in srgb,var(--md-sys-color-outline, #64748b) 24%,transparent)}.cdk-overlay-pane.pfx-drawer-pane.pfx-drawer-maximized{margin:var(--pfx-drawer-edge-gap, 8px)!important}.cdk-overlay-pane.pfx-drawer-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-drawer-pane .mdc-dialog__surface{border-radius:0!important}\n"] }]
+  `, styles: ["praxis-dynamic-form-dialog-host{--dlg-header-h: 56px;--dlg-footer-h: 56px;--dlg-pad: 16px;display:flex;flex-direction:column;height:100%;overflow:hidden}praxis-dynamic-form-dialog-host[data-density=compact]{--dlg-header-h: 44px;--dlg-footer-h: 44px;--dlg-pad: 12px}praxis-dynamic-form-dialog-host .dialog-header{position:sticky;top:0;z-index:1;display:flex;align-items:center;gap:var(--dlg-pad);min-height:var(--dlg-header-h);padding:10px var(--dlg-pad);margin:0;background:var(--md-sys-color-surface-container-high);border-bottom:1px solid var(--md-sys-color-outline-variant);color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host .dialog-title{margin:0;font:inherit;font-weight:600;color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host .dialog-heading{display:grid;min-width:0;gap:2px}praxis-dynamic-form-dialog-host .dialog-title-icon{display:inline-grid;flex:0 0 auto;width:36px;height:36px;place-items:center;border-radius:10px;color:var(--md-sys-color-primary);background:color-mix(in srgb,var(--md-sys-color-primary) 12%,transparent)}praxis-dynamic-form-dialog-host .dialog-title-icon mat-icon{width:22px;height:22px;font-size:22px}praxis-dynamic-form-dialog-host .dialog-subtitle{display:-webkit-box;overflow:hidden;color:var(--md-sys-color-on-surface-variant);font-size:.82rem;font-weight:400;line-height:1.35;-webkit-box-orient:vertical;-webkit-line-clamp:2}praxis-dynamic-form-dialog-host .spacer{flex:1}praxis-dynamic-form-dialog-host .dialog-content{flex:1 1 auto;overflow:auto;padding:var(--dlg-pad);max-height:calc(100svh - var(--dlg-header-h) - 32px)}praxis-dynamic-form-dialog-host .crud-resource-identity{position:sticky;top:0;z-index:1;display:grid;gap:.25rem;margin-block-end:var(--dlg-pad);padding-block:.5rem .75rem;background:var(--pfx-form-surface, var(--md-sys-color-surface));border-bottom:1px solid var(--md-sys-color-outline-variant)}praxis-dynamic-form-dialog-host .crud-resource-identity__label{color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-label-medium, 500 .75rem/1rem inherit)}praxis-dynamic-form-dialog-host.praxis-drawer{--dlg-header-h: 72px;width:100%;min-width:0;max-width:100vw;height:100dvh;background:var(--pfx-form-surface, var(--md-sys-color-surface));color:var(--md-sys-color-on-surface)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-header{background:color-mix(in srgb,var(--md-sys-color-surface-container-high, var(--md-sys-color-surface)),transparent 4%)}praxis-dynamic-form-dialog-host.praxis-drawer .dialog-content{max-height:none;min-height:0;padding:clamp(12px,2.4vw,24px)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button{color:var(--md-sys-color-on-surface-variant)}praxis-dynamic-form-dialog-host .dialog-header button.praxis-icon-button:hover{color:var(--md-sys-color-primary)}praxis-dynamic-form-dialog-host .dialog-footer{position:sticky;bottom:0;z-index:1;padding:var(--dlg-pad)}.pfx-blur-backdrop{background-color:var(--pfx-backdrop, rgba(15, 23, 42, .42))!important;backdrop-filter:blur(var(--pfx-backdrop-blur, 10px)) saturate(110%);-webkit-backdrop-filter:blur(var(--pfx-backdrop-blur, 10px)) saturate(110%)}.pfx-transparent-backdrop{background-color:transparent!important}.cdk-overlay-pane.pfx-dialog-pane{overflow:hidden;transition:width .2s ease,height .2s ease,margin .2s ease}.cdk-overlay-pane.pfx-dialog-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-dialog-pane .mdc-dialog__surface{display:flex;flex-direction:column;width:100%;min-width:0;height:100%;max-height:inherit;overflow:hidden;background:var(--pfx-form-surface, var(--md-sys-color-surface))!important;border:1px solid var(--pfx-form-stroke, var(--md-sys-color-outline-variant))!important}.cdk-overlay-pane.pfx-dialog-pane.pfx-dialog-frosted .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-dialog-pane.pfx-dialog-frosted .mdc-dialog__surface{backdrop-filter:blur(8px);-webkit-backdrop-filter:blur(8px)}.cdk-overlay-pane.pfx-drawer-pane{margin:0!important;border-radius:0!important;box-shadow:var(--md-sys-elevation-level3, 0 24px 80px rgba(15, 23, 42, .28)),0 0 0 1px color-mix(in srgb,var(--md-sys-color-outline, #64748b) 24%,transparent)}.cdk-overlay-pane.pfx-drawer-pane.pfx-drawer-maximized{margin:var(--pfx-drawer-edge-gap, 8px)!important}.cdk-overlay-pane.pfx-drawer-pane .mat-mdc-dialog-surface,.cdk-overlay-pane.pfx-drawer-pane .mdc-dialog__surface{min-width:0!important;border-radius:0!important}\n"] }]
         }], ctorParameters: () => [{ type: undefined, decorators: [{
                     type: Inject,
                     args: [MatDialogRef]

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@praxisui/crud",
-  "version": "9.0.4-rc.2",
+  "version": "9.0.4-rc.20",
   "description": "CRUD building blocks for Praxis UI: integrates dynamic forms and tables with unified configuration and services.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@praxisui/dynamic-form": "^9.0.4-rc.2",
-    "@praxisui/table": "^9.0.4-rc.2",
-    "@praxisui/core": "^9.0.4-rc.2",
-    "@praxisui/dynamic-fields": "^9.0.4-rc.2",
-    "@praxisui/settings-panel": "^9.0.4-rc.2",
+    "@praxisui/dynamic-form": "^9.0.4-rc.20",
+    "@praxisui/table": "^9.0.4-rc.20",
+    "@praxisui/core": "^9.0.4-rc.20",
+    "@praxisui/dynamic-fields": "^9.0.4-rc.20",
+    "@praxisui/settings-panel": "^9.0.4-rc.20",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.4-rc.2",
+    "@praxisui/ai": "^9.0.4-rc.20",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-crud.d.ts

@@ -1,8 +1,8 @@
+import * as _angular_core from '@angular/core';
+import { NgZone, OnChanges, EventEmitter, SimpleChanges, OnInit, Provider, AfterViewInit, OnDestroy } from '@angular/core';
 import * as _praxisui_core from '@praxisui/core';
 import { RowAction, ToolbarAction, ApiEndpoint, ApiUrlEntry, DynamicFormLayoutPolicy, BackConfig, TableConfig, PraxisDataQueryContext, FormConfig, ResourceActionCatalogItem, ResourceSurfaceCatalogItem, MaterializedResourceIdentity, LoadingState, RestApiLinks, ResourceCapabilitySnapshot, GenericCrudService, AsyncConfigStorage, ComponentDocMeta, AiCapabilityCatalog, AiCapability, AiCapabilityCategory, AiValueKind, ComponentAuthoringManifest, SettingsValueProvider } from '@praxisui/core';
 export { BackConfig } from '@praxisui/core';
-import * as _angular_core from '@angular/core';
-import { NgZone, OnChanges, EventEmitter, SimpleChanges, OnInit, Provider, AfterViewInit, OnDestroy } from '@angular/core';
 import { MatDialogConfig, MatDialogRef, MatDialog } from '@angular/material/dialog';
 export { MAT_DIALOG_DATA as DIALOG_DATA } from '@angular/material/dialog';
 import { ComponentType } from '@angular/cdk/portal';
@@ -199,6 +199,7 @@ declare class PraxisCrudComponent implements OnChanges {
     tableQueryContext: Record<string, unknown> | null;
     tableFilterCriteria: Record<string, unknown>;
     tableCrudContext?: CrudContextValue;
+    readonly openingActionLabel: _angular_core.WritableSignal<string | null>;
     private readonly launcher;
     private readonly http;
     private readonly destroyRef;
@@ -244,6 +245,8 @@ declare class PraxisCrudComponent implements OnChanges {
     onToolbarAction(event: CrudActionRuntimeEvent): Promise<void>;
     ngOnChanges(changes: SimpleChanges): void;
     onAction(action: string, row?: Record<string, unknown>, runtimeEvent?: CrudActionRuntimeEvent): Promise<void>;
+    getOpeningActionStatus(actionLabel: string): string;
+    private resolveOpeningActionLabel;
     private hasExplicitOpenBinding;
     getCurrentTableConfigSnapshot(): TableConfig | null;
     onTableMetadataChange(): void;
@@ -294,6 +297,7 @@ declare class PraxisCrudComponent implements OnChanges {
     private resolveRowResourceId;
     private mapSurfacePresentationToCrudMode;
     private handleDiscoveredSurfaceResult;
+    private bindDiscoveredSurfaceLifecycle;
     private buildEffectiveTableConfig;
     private isAddLike;
     private normalizeCrudActionName;
@@ -343,6 +347,7 @@ declare class CrudLauncherService {
     private readonly storage;
     private readonly global;
     private readonly operationResolver;
+    private dialogHostPromise?;
     private readonly drawerAdapter;
     launch(action: CrudAction, row: Record<string, unknown> | undefined, metadata: CrudMetadata, componentKeyId?: string | null, drawerCallbacks?: {
         onClose?: () => void;
@@ -356,6 +361,8 @@ declare class CrudLauncherService {
         ref?: DialogRef<any>;
     }>;
     resolveOpenMode(action: CrudAction, metadata: CrudMetadata): FormOpenMode;
+    private isLikelyOverlayAction;
+    private loadDialogHost;
     private buildRoute;
     private mapInputs;
     private resolveActionForLaunch;
@@ -421,6 +428,8 @@ declare class DynamicFormDialogHostComponent implements OnInit {
     private extractInitialValue;
     private resolveFormConfig;
     get dialogTitle(): string;
+    get dialogSubtitle(): string | undefined;
+    get dialogIcon(): string | undefined;
     private resolveActionDialogTitle;
     private resolveResourceTitle;
     private resolveFormActions;