@praxisui/dynamic-form 9.0.66 → 9.0.68-rc.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "9.0.66",
+  "version": "9.0.68-rc.0",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -9,13 +9,13 @@
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.66",
-    "@praxisui/dynamic-fields": "^9.0.66",
-    "@praxisui/metadata-editor": "^9.0.66",
-    "@praxisui/rich-content": "^9.0.66",
-    "@praxisui/settings-panel": "^9.0.66",
-    "@praxisui/visual-builder": "^9.0.66",
-    "@praxisui/core": "^9.0.66",
+    "@praxisui/ai": "^9.0.68-rc.0",
+    "@praxisui/dynamic-fields": "^9.0.68-rc.0",
+    "@praxisui/metadata-editor": "^9.0.68-rc.0",
+    "@praxisui/rich-content": "^9.0.68-rc.0",
+    "@praxisui/settings-panel": "^9.0.68-rc.0",
+    "@praxisui/visual-builder": "^9.0.68-rc.0",
+    "@praxisui/core": "^9.0.68-rc.0",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

package/src/lib/config-editor/praxis-dynamic-form-config-editor.json-api.md

@@ -55,6 +55,13 @@ Este documento e a referencia canonica da API JSON de praxis-dynamic-form-config
 
 ## Canonical authoring semantics
 
+- Em Geral → Dados do formulário, `Modo de dados` e `Modo de exibição` são preferências independentes.
+- `bindings.presentationModeGlobal` reutiliza o input runtime existente: `true` = Apresentação (efetiva somente em `view`), `false` = Campos de formulário, `null`/ausência = Automático, seguindo `layoutPolicy`.
+- Em replace-all, omitir a preferência remove o override anterior; `false` deve ser preservado. Não existe um quarto valor em `bindings.mode`.
+- O Page Builder projeta a preferência nos inputs do widget, preservando ausência de `config` em formulários schema-driven. No editor do runtime, Apply/Save também publicam `mode` e `presentationModeGlobal` em `configPatchChange.inputPatch`.
+- `contextSnapshot.presentation` continua reservado aos estilos (tipografia, densidade e alinhamento), editáveis nos dois caminhos pela aba Estilo da apresentação; não é o seletor de ativação. O Filter Form não oferece o seletor de exibição porque seu runtime não suporta apresentação.
+
+
 - O editor visual e o editor JSON operam sobre `DynamicFormAuthoringDocument`.
 - O editor JSON aceita apenas o envelope canônico; payloads legados pertencem aos caminhos de compatibilidade do runtime.
 - `Apply` e `Save` emitem um snapshot canonico completo com semantica `replace-all`.
@@ -481,3 +488,24 @@ Correcao: e diff estrutural para UX do painel, nao auditoria de negocio.
 | local-file | projects/praxis-dynamic-form/src/lib/praxis-dynamic-form.ts | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |
 | local-file | projects/praxis-settings-panel/src/lib/settings-panel.types.ts | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |
 | local-file | projects/praxis-core/src/lib/models/form/form-config.model.ts | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |
+
+
+### Presentation style projection and editor UX
+
+- `contextSnapshot.presentation` is the canonical style snapshot. The optional runtime input `presentation: DynamicFormPresentationSnapshot | null` projects it into page widgets independently of schema-generated `config`. Explicit styles take precedence over stored style preferences; `null` restores defaults and blocks stale stored overrides; omission retains normal style resolution.
+- Runtime editor Apply/Save emits `presentation` with `mode` and `presentationModeGlobal` in `configPatchChange.inputPatch`. Widget save/reopen preserves the same snapshot; omitting the document block clears the widget projection with `null`.
+- Numeric font sizes and label widths are pixels. Capturing a runtime `rem` size converts it using the host root font size; opening and saving must not reinterpret `0.78rem` as `0.78px`.
+- **Geral → Dados do formulário** separates **Criar / Editar / Visualizar** from **Automático / Campos / Apresentação**. Selecting presentation in Create/Edit keeps the operation unchanged and explains the inactive state with an explicit action to switch to View.
+- **Estilo da apresentação** remains discoverable regardless of the current mode. It previews sample data and does not activate presentation by itself. Filter Form does not expose this tab because it has no presentation runtime.
+- Applying or finishing widget editing updates the page draft. **Salvar página** persists the composition. Shortening sample text affects the preview only.
+
+
+### Orientação antes da seleção de um registro
+
+O editor nativo, em **Geral → Sem registro selecionado**, materializa o contrato existente `PraxisDynamicFormEmptyState` em `bindings.emptyState`. O wrapper Page Builder projeta esse binding para `inputs.emptyState`; Apply, Save e JSON usam o mesmo documento. Não pertence a `FormConfig` nem substitui o modo dos dados.
+
+`title` é obrigatório e não pode conter apenas espaços. `description` e `icon` são textos opcionais; a cópia de negócio permanece literal, sem ser interpretada automaticamente como chave i18n. O seletor usa o catálogo canônico de ícones. Restaurar o ícone padrão limpa a escolha explícita. Os controles do editor usam o catálogo i18n Form; a aparência runtime usa os tokens do empty state compartilhado.
+
+As opções de aparência ficam em disclosure avançado: `tone` (`neutral`, `primary`, `secondary`), `variant` (`card`, `inline`, `panel`, `transparent`), `alignment` (`start`, `center`), `density` (`compact`, `comfortable`) e `iconContainer` (`none`, `circle`, `soft`). Ausência de opção herda o padrão do componente; JSON inválido produz diagnóstico.
+
+A orientação aparece somente em `mode=view`, sem registro selecionado nem snapshot local. Criar e Editar preservam a configuração sem exibi-la. Desligar grava `null`, que impede reativação por uma preferência antiga; substituir um documento que omite o binding também limpa a orientação. Em `input-first`, a página governa o valor. Filter Form não expõe essa seção, pois não possui contexto de seleção equivalente.

package/src/lib/layout-editor/praxis-layout-editor.json-api.md

@@ -268,8 +268,11 @@ Use quando precisar de:
 | `fieldMetadata[].formHidden` | Active | Campos ocultos não aparecem na palette. |
 | `actions/behavior/messages/hooks/api/...` | Declared-only | Não manipulados neste editor de layout. |
 
-Extensoes de runtime no editor (fora do contrato canonico):
-- `section.gapCustomized` (controle interno de aplicacao de gap).
+O controle **Espaço após as seções** usa `sections[].gapBottom` (pixels após a
+seção inteira). **Preencher espaços não definidos** preenche somente valores
+ausentes/nulos, preservando valores explícitos, inclusive zero. Editar o número
+não emite configuração; o comando explícito emite o rascunho. A marca antiga
+`gapCustomized` não é mais gerada nem consultada para decidir elegibilidade.
 
 ### 4. Mapeamento de Comportamento
 - Palette de campos:
@@ -330,8 +333,9 @@ Correcao: ele cobre layout; demais blocos sao editados em componentes dedicados.
 5. Ignorar `select` e perder contexto de qual elemento esta em foco.
 Correcao: conecte `select` com painel lateral/inspector quando houver.
 
-6. Persistir extensoes internas (`gapCustomized`) como se fossem contrato estavel.
-Correcao: trate como detalhe de editor; sanitize se necessario no pipeline.
+6. Confundir espaço após a seção com espaço entre colunas ou usar `gapCustomized`.
+Correcao: `gapBottom` é o contrato canônico; sua ausência indica elegibilidade
+para preenchimento. Espaçamento entre colunas pertence ao layout da linha.
 
 ### 8. Referencias Cruzadas
 - Orquestrador superior: `projects/praxis-dynamic-form/src/lib/config-editor/praxis-dynamic-form-config-editor.ts`

package/src/lib/praxis-dynamic-form.json-api.md

@@ -68,6 +68,13 @@ Este documento e a referencia canonica da API JSON de praxis-dynamic-form.
 
 ## Canonical authoring semantics
 
+- Em Geral → Dados do formulário, `Modo de dados` e `Modo de exibição` são preferências independentes.
+- `bindings.presentationModeGlobal` reutiliza o input runtime existente: `true` = Apresentação (efetiva somente em `view`), `false` = Campos de formulário, `null`/ausência = Automático, seguindo `layoutPolicy`.
+- Em replace-all, omitir a preferência remove o override anterior; `false` deve ser preservado. Não existe um quarto valor em `bindings.mode`.
+- O Page Builder projeta a preferência nos inputs do widget, preservando ausência de `config` em formulários schema-driven. No editor do runtime, Apply/Save também publicam `mode` e `presentationModeGlobal` em `configPatchChange.inputPatch`.
+- `contextSnapshot.presentation` continua reservado aos estilos (tipografia, densidade e alinhamento), editáveis nos dois caminhos pela aba Estilo da apresentação; não é o seletor de ativação. O Filter Form não oferece o seletor de exibição porque seu runtime não suporta apresentação.
+
+
 - `DynamicFormAuthoringDocument` e o snapshot canonico completo de autoria de `praxis-dynamic-form`.
 - Quando aplicado por fluxos canonicos de editor, `config`, `bindings` e `contextSnapshot` possuem semantica `replace-all`.
 - Ausencia de `bindings.mode` limpa o binding persistido e restaura o modo default efetivo do host.
@@ -411,7 +418,7 @@ Limites de segurança:
 | `formCancel` | `void` | Acao cancelar. | Partial | Preservado da documentação anterior. |
 | `formReset` | `void` | Acao reset. | Partial | Preservado da documentação anterior. |
 | `configChange` | `FormConfig` | Alteracoes de layout/config durante edicao. | Partial | Preservado da documentação anterior. |
-| `configPatchChange` | `{ inputPatch: { config: FormConfig } }` | Alteracoes autoradas de configuracao que devem ser persistidas pelo host. | Partial | Contrato aditivo para hosts genericos sem alterar o payload legado de `configChange`. |
+| `configPatchChange` | `{ inputPatch: { config?: FormConfig; resourcePath?: string \| null; mode?: DynamicFormMode; presentationModeGlobal?: boolean \| null; presentation?: DynamicFormPresentationSnapshot \| null } }` | Alteracoes autoradas de configuracao que devem ser persistidas pelo host. | Partial | Contrato aditivo para hosts genericos sem alterar o payload legado de `configChange`. |
 | `formReady` | `FormReadyEvent` | Form pronto para interacao. | Partial | Preservado da documentação anterior. |
 | `valueChange` | `FormValueChangeEvent` | Alteracao de valor no form runtime. | Partial | Preservado da documentação anterior. |
 | `syncCompleted` | `SyncResult` | Sincronizacao de schema/config concluida. | Partial | Preservado da documentação anterior. |
@@ -745,7 +752,7 @@ Validado em 2026-04-23 contra `praxis-api-quickstart` publicado no Render com
 | `formCancel` | `void` | Acao cancelar. |
 | `formReset` | `void` | Acao reset. |
 | `configChange` | `FormConfig` | Alteracoes de layout/config durante edicao. |
-| `configPatchChange` | `{ inputPatch: { config: FormConfig } }` | Alteracoes autoradas de configuracao que devem ser persistidas pelo host. |
+| `configPatchChange` | `{ inputPatch: { config?: FormConfig; resourcePath?: string \| null; mode?: DynamicFormMode; presentationModeGlobal?: boolean \| null; presentation?: DynamicFormPresentationSnapshot \| null } }` | Alteracoes autoradas de configuracao que devem ser persistidas pelo host. |
 | `formReady` | `FormReadyEvent` | Form pronto para interacao. |
 | `valueChange` | `FormValueChangeEvent` | Alteracao de valor no form runtime. |
 | `syncCompleted` | `SyncResult` | Sincronizacao de schema/config concluida. |
@@ -971,7 +978,7 @@ O runtime emite `target-not-found` quando uma regra aponta para `section`, `row`
 | `formCancel` | `void` | Acao cancelar. | Partial | Preservado da documentação anterior. |
 | `formReset` | `void` | Acao reset. | Partial | Preservado da documentação anterior. |
 | `configChange` | `FormConfig` | Alteracoes de layout/config durante edicao. | Partial | Preservado da documentação anterior. |
-| `configPatchChange` | `{ inputPatch: { config: FormConfig } }` | Alteracoes autoradas de configuracao que devem ser persistidas pelo host. | Partial | Contrato aditivo para hosts genericos sem alterar o payload legado de `configChange`. |
+| `configPatchChange` | `{ inputPatch: { config?: FormConfig; resourcePath?: string \| null; mode?: DynamicFormMode; presentationModeGlobal?: boolean \| null; presentation?: DynamicFormPresentationSnapshot \| null } }` | Alteracoes autoradas de configuracao que devem ser persistidas pelo host. | Partial | Contrato aditivo para hosts genericos sem alterar o payload legado de `configChange`. |
 | `formReady` | `FormReadyEvent` | Form pronto para interacao. | Partial | Preservado da documentação anterior. |
 | `valueChange` | `FormValueChangeEvent` | Alteracao de valor no form runtime. | Partial | Preservado da documentação anterior. |
 | `syncCompleted` | `SyncResult` | Sincronizacao de schema/config concluida. | Partial | Preservado da documentação anterior. |
@@ -1110,3 +1117,24 @@ O runtime emite `target-not-found` quando uma regra aponta para `section`, `row`
 | local-file | projects/praxis-dynamic-fields/src/lib/directives/dynamic-field-loader.directive.ts | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |
 | local-file | projects/praxis-core/src/lib/models/form/form-config.model.ts | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |
 | local-file | projects/praxis-core/src/lib/models/form/form-layout.model.ts | Evidencia de implementacao e contrato. | 2026-03-05 | referencia preservada da versao anterior |
+
+
+### Presentation style projection and editor UX
+
+- `contextSnapshot.presentation` is the canonical style snapshot. The optional runtime input `presentation: DynamicFormPresentationSnapshot | null` projects it into page widgets independently of schema-generated `config`. Explicit styles take precedence over stored style preferences; `null` restores defaults and blocks stale stored overrides; omission retains normal style resolution.
+- Runtime editor Apply/Save emits `presentation` with `mode` and `presentationModeGlobal` in `configPatchChange.inputPatch`. Widget save/reopen preserves the same snapshot; omitting the document block clears the widget projection with `null`.
+- Numeric font sizes and label widths are pixels. Capturing a runtime `rem` size converts it using the host root font size; opening and saving must not reinterpret `0.78rem` as `0.78px`.
+- **Geral → Dados do formulário** separates **Criar / Editar / Visualizar** from **Automático / Campos / Apresentação**. Selecting presentation in Create/Edit keeps the operation unchanged and explains the inactive state with an explicit action to switch to View.
+- **Estilo da apresentação** remains discoverable regardless of the current mode. It previews sample data and does not activate presentation by itself. Filter Form does not expose this tab because it has no presentation runtime.
+- Applying or finishing widget editing updates the page draft. **Salvar página** persists the composition. Shortening sample text affects the preview only.
+
+
+### Orientação antes da seleção de um registro
+
+O editor nativo, em **Geral → Sem registro selecionado**, materializa o contrato existente `PraxisDynamicFormEmptyState` em `bindings.emptyState`. O wrapper Page Builder projeta esse binding para `inputs.emptyState`; Apply, Save e JSON usam o mesmo documento. Não pertence a `FormConfig` nem substitui o modo dos dados.
+
+`title` é obrigatório e não pode conter apenas espaços. `description` e `icon` são textos opcionais; a cópia de negócio permanece literal, sem ser interpretada automaticamente como chave i18n. O seletor usa o catálogo canônico de ícones. Restaurar o ícone padrão limpa a escolha explícita. Os controles do editor usam o catálogo i18n Form; a aparência runtime usa os tokens do empty state compartilhado.
+
+As opções de aparência ficam em disclosure avançado: `tone` (`neutral`, `primary`, `secondary`), `variant` (`card`, `inline`, `panel`, `transparent`), `alignment` (`start`, `center`), `density` (`compact`, `comfortable`) e `iconContainer` (`none`, `circle`, `soft`). Ausência de opção herda o padrão do componente; JSON inválido produz diagnóstico.
+
+A orientação aparece somente em `mode=view`, sem registro selecionado nem snapshot local. Criar e Editar preservam a configuração sem exibi-la. Desligar grava `null`, que impede reativação por uma preferência antiga; substituir um documento que omite o binding também limpa a orientação. Em `input-first`, a página governa o valor. Filter Form não expõe essa seção, pois não possui contexto de seleção equivalente.

package/types/praxisui-dynamic-form.d.ts

@@ -1,13 +1,13 @@
 import * as i0 from '@angular/core';
 import { OnChanges, OnDestroy, EventEmitter, SimpleChanges, OnInit, ChangeDetectorRef, NgZone, Provider, AfterViewInit, ElementRef } from '@angular/core';
 import { HttpClient } from '@angular/common/http';
-import { FormGroup, AbstractControl, FormBuilder, FormArray } from '@angular/forms';
+import { FormGroup, AbstractControl, FormBuilder, FormArray, FormControl } from '@angular/forms';
 import { Router, ActivatedRoute } from '@angular/router';
 import { MatDialog } from '@angular/material/dialog';
 import { MatSnackBar } from '@angular/material/snack-bar';
 import { CdkDragStart, CdkDragMove, CdkDragEnd, CdkDragDrop } from '@angular/cdk/drag-drop';
 import * as _praxisui_core from '@praxisui/core';
-import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, PraxisJsonLogicService, FormSection, FormRow, FormColumn, FormConfig, FormConfigWithSections, FormLayoutItem, ReactiveDeterminationDefinition, ReactiveDeterminationExecutionEvent, FormActionButton, AiCapability, BackConfig, FormPresentationConfig, RichBlockHostCapabilities, EmptyStateTone, EmptyStateVariant, EmptyStateAlignment, EmptyStateDensity, EmptyStateIconContainer, ApiEndpoint, ApiUrlEntry, DynamicFormLayoutPolicy, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, FormPayloadPreviewEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, RichContentDocument, JsonLogicRecord, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, ApiUrlConfig, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, EnterpriseRuntimeContextService, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, JsonLogicExpression, FormHelpPresentationConfig, GlobalActionCatalogEntry, PraxisRuntimeConditionalEffectRule, PraxisRuntimeGlobalActionEffect, SurfaceOpenPayload, GlobalActionField, PraxisEffectPolicy, FieldDefinition, ComponentDocMeta, Breakpoint, DomainRuleRequestOptions, DomainRuleService, DomainRuleMaterialization, TableConfig, IconPickerService, GlobalActionRef, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
+import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, PraxisJsonLogicService, FormSection, FormRow, FormColumn, FormConfig, FormConfigWithSections, FormLayoutItem, ReactiveDeterminationDefinition, ReactiveDeterminationExecutionEvent, FormActionButton, AiCapability, BackConfig, FormPresentationConfig, EmptyStateTone, EmptyStateVariant, EmptyStateAlignment, EmptyStateDensity, EmptyStateIconContainer, RichBlockHostCapabilities, ApiEndpoint, ApiUrlEntry, DynamicFormLayoutPolicy, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, FormPayloadPreviewEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, RichContentDocument, JsonLogicRecord, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, ApiUrlConfig, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, EnterpriseRuntimeContextService, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, JsonLogicExpression, FormHelpPresentationConfig, GlobalActionCatalogEntry, PraxisRuntimeConditionalEffectRule, PraxisRuntimeGlobalActionEffect, SurfaceOpenPayload, GlobalActionField, PraxisEffectPolicy, FieldDefinition, ComponentDocMeta, Breakpoint, DomainRuleRequestOptions, DomainRuleService, DomainRuleMaterialization, TableConfig, SurfaceOpenActionEditorComponent, IconPickerService, GlobalActionRef, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { Observable, Subscription, BehaviorSubject } from 'rxjs';
 import { SettingsPanelService, SettingsValueProvider } from '@praxisui/settings-panel';
@@ -575,6 +575,10 @@ interface EditorDiagnostic {
 type DynamicFormMode = 'create' | 'edit' | 'view';
 interface DynamicFormBindings {
     mode?: DynamicFormMode;
+    /** Opt-in view placeholder; null explicitly disables it. */
+    emptyState?: PraxisDynamicFormEmptyState | null;
+    /** true: presentation in view; false: fields; null/absent: inherit layout policy. */
+    presentationModeGlobal?: boolean | null;
 }
 type DynamicFormPresentationSnapshot = FormPresentationConfig;
 interface DynamicFormSchemaPrefsSnapshot {
@@ -628,6 +632,8 @@ interface DynamicFormApplyPlan {
     runtime?: {
         rebindMode?: boolean;
         clearMode?: boolean;
+        clearPresentationMode?: boolean;
+        clearEmptyState?: boolean;
         rebuildForm?: boolean;
         refreshPresentation?: boolean;
         clearPresentation?: boolean;
@@ -650,7 +656,12 @@ interface DynamicFormApplyPlan {
 
 interface DynamicFormConfigPatchChangeEvent {
     inputPatch: {
-        config: FormConfig;
+        config?: FormConfig;
+        resourcePath?: string | null;
+        mode?: DynamicFormMode;
+        presentationModeGlobal?: boolean | null;
+        presentation?: DynamicFormPresentationSnapshot | null;
+        emptyState?: PraxisDynamicFormEmptyState | null;
     };
 }
 /**
@@ -863,6 +874,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     readonlyModeGlobal: boolean | null;
     disabledModeGlobal: boolean | null;
     presentationModeGlobal: boolean | null;
+    /** Projection of contextSnapshot.presentation; null clears authored style overrides. */
+    presentation?: DynamicFormPresentationSnapshot | null;
     visibleGlobal: boolean | null;
     fieldIconPolicy: 'all' | 'presentation-only' | 'none';
     /** Opt-in loader for shared domain rule materializations persisted outside FormConfig. */
@@ -954,9 +967,20 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private ruleApplicationDiagnosticsSignature;
     private pendingEntityId;
     private loadedEntityId;
+    private entitySelectionCleared;
     private hydratedEntityId;
     private loadedEntityData;
     protected entityHydrationPending: boolean;
+    protected entityReadFailed: boolean;
+    protected entityReadText(key: 'loading' | 'error' | 'retry' | 'region' | 'success'): string;
+    protected entityReadStatusText(): string;
+    protected retryEntityRead(focusRegion?: HTMLElement): void;
+    private readonly schemaTransportOptions;
+    private readonly schemaReadControllers;
+    private schemaInitializationCycle;
+    private cancelSchemaReads;
+    private assertSchemaInitializationCurrent;
+    private isSchemaTransportInterruption;
     private schemaCache;
     private lastSchemaMeta?;
     private readonly schemaMetaPersistenceQueues;
@@ -967,6 +991,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private schemaRootReactiveDeterminations;
     private schemaRootOperationId;
     private destroy$;
+    private readonly entityReadCancel$;
     private isDestroyed;
     private formValueChangesSubscription;
     private readonly submitFieldErrorSubscriptions;
@@ -1510,7 +1535,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private applyPresentationVars;
     private applyPresentationConfig;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisDynamicForm, [null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisDynamicForm, "praxis-dynamic-form", never, { "resourcePath": { "alias": "resourcePath"; "required": false; }; "resourceId": { "alias": "resourceId"; "required": false; }; "initialValue": { "alias": "initialValue"; "required": false; }; "emptyState": { "alias": "emptyState"; "required": false; }; "editorialContext": { "alias": "editorialContext"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "config": { "alias": "config"; "required": false; }; "actions": { "alias": "actions"; "required": false; }; "schemaSource": { "alias": "schemaSource"; "required": false; }; "schemaUrl": { "alias": "schemaUrl"; "required": false; }; "readUrl": { "alias": "readUrl"; "required": false; }; "submitUrl": { "alias": "submitUrl"; "required": false; }; "submitMethod": { "alias": "submitMethod"; "required": false; }; "submitIdempotencyKey": { "alias": "submitIdempotencyKey"; "required": false; }; "submitCorrelationId": { "alias": "submitCorrelationId"; "required": false; }; "submitResourceVersion": { "alias": "submitResourceVersion"; "required": false; }; "submitResourceVersionTargetResourceKey": { "alias": "submitResourceVersionTargetResourceKey"; "required": false; }; "submitResourceVersionTargetIdField": { "alias": "submitResourceVersionTargetIdField"; "required": false; }; "responseSchemaUrl": { "alias": "responseSchemaUrl"; "required": false; }; "apiEndpointKey": { "alias": "apiEndpointKey"; "required": false; }; "apiUrlEntry": { "alias": "apiUrlEntry"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showAiAssistant": { "alias": "showAiAssistant"; "required": false; }; "formId": { "alias": "formId"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "configPersistenceStrategy": { "alias": "configPersistenceStrategy"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "generatedLayoutPreset": { "alias": "generatedLayoutPreset"; "required": false; }; "layoutPolicy": { "alias": "layoutPolicy"; "required": false; }; "backConfig": { "alias": "backConfig"; "required": false; }; "hooks": { "alias": "hooks"; "required": false; }; "removeEmptyContainersOnSave": { "alias": "removeEmptyContainersOnSave"; "required": false; }; "reactiveValidation": { "alias": "reactiveValidation"; "required": false; }; "reactiveValidationDebounceMs": { "alias": "reactiveValidationDebounceMs"; "required": false; }; "notifyIfOutdated": { "alias": "notifyIfOutdated"; "required": false; }; "snoozeMs": { "alias": "snoozeMs"; "required": false; }; "autoOpenSettingsOnOutdated": { "alias": "autoOpenSettingsOnOutdated"; "required": false; }; "readonlyModeGlobal": { "alias": "readonlyModeGlobal"; "required": false; }; "disabledModeGlobal": { "alias": "disabledModeGlobal"; "required": false; }; "presentationModeGlobal": { "alias": "presentationModeGlobal"; "required": false; }; "visibleGlobal": { "alias": "visibleGlobal"; "required": false; }; "fieldIconPolicy": { "alias": "fieldIconPolicy"; "required": false; }; "domainRules": { "alias": "domainRules"; "required": false; }; "customEndpoints": { "alias": "customEndpoints"; "required": false; }; }, { "formSubmit": "formSubmit"; "formCancel": "formCancel"; "formReset": "formReset"; "configChange": "configChange"; "configPatchChange": "configPatchChange"; "formReady": "formReady"; "valueChange": "valueChange"; "payloadPreviewChange": "payloadPreviewChange"; "syncCompleted": "syncCompleted"; "initializationError": "initializationError"; "loadingStateChange": "loadingStateChange"; "enableCustomizationChange": "enableCustomizationChange"; "customAction": "customAction"; "actionConfirmation": "actionConfirmation"; "schemaStatusChange": "schemaStatusChange"; "fieldRenderError": "fieldRenderError"; "ruleDiagnosticsChange": "ruleDiagnosticsChange"; "reactiveDeterminationExecuted": "reactiveDeterminationExecuted"; "reactiveDeterminationPendingChange": "reactiveDeterminationPendingChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisDynamicForm, "praxis-dynamic-form", never, { "resourcePath": { "alias": "resourcePath"; "required": false; }; "resourceId": { "alias": "resourceId"; "required": false; }; "initialValue": { "alias": "initialValue"; "required": false; }; "emptyState": { "alias": "emptyState"; "required": false; }; "editorialContext": { "alias": "editorialContext"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "config": { "alias": "config"; "required": false; }; "actions": { "alias": "actions"; "required": false; }; "schemaSource": { "alias": "schemaSource"; "required": false; }; "schemaUrl": { "alias": "schemaUrl"; "required": false; }; "readUrl": { "alias": "readUrl"; "required": false; }; "submitUrl": { "alias": "submitUrl"; "required": false; }; "submitMethod": { "alias": "submitMethod"; "required": false; }; "submitIdempotencyKey": { "alias": "submitIdempotencyKey"; "required": false; }; "submitCorrelationId": { "alias": "submitCorrelationId"; "required": false; }; "submitResourceVersion": { "alias": "submitResourceVersion"; "required": false; }; "submitResourceVersionTargetResourceKey": { "alias": "submitResourceVersionTargetResourceKey"; "required": false; }; "submitResourceVersionTargetIdField": { "alias": "submitResourceVersionTargetIdField"; "required": false; }; "responseSchemaUrl": { "alias": "responseSchemaUrl"; "required": false; }; "apiEndpointKey": { "alias": "apiEndpointKey"; "required": false; }; "apiUrlEntry": { "alias": "apiUrlEntry"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showAiAssistant": { "alias": "showAiAssistant"; "required": false; }; "formId": { "alias": "formId"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "configPersistenceStrategy": { "alias": "configPersistenceStrategy"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "generatedLayoutPreset": { "alias": "generatedLayoutPreset"; "required": false; }; "layoutPolicy": { "alias": "layoutPolicy"; "required": false; }; "backConfig": { "alias": "backConfig"; "required": false; }; "hooks": { "alias": "hooks"; "required": false; }; "removeEmptyContainersOnSave": { "alias": "removeEmptyContainersOnSave"; "required": false; }; "reactiveValidation": { "alias": "reactiveValidation"; "required": false; }; "reactiveValidationDebounceMs": { "alias": "reactiveValidationDebounceMs"; "required": false; }; "notifyIfOutdated": { "alias": "notifyIfOutdated"; "required": false; }; "snoozeMs": { "alias": "snoozeMs"; "required": false; }; "autoOpenSettingsOnOutdated": { "alias": "autoOpenSettingsOnOutdated"; "required": false; }; "readonlyModeGlobal": { "alias": "readonlyModeGlobal"; "required": false; }; "disabledModeGlobal": { "alias": "disabledModeGlobal"; "required": false; }; "presentationModeGlobal": { "alias": "presentationModeGlobal"; "required": false; }; "presentation": { "alias": "presentation"; "required": false; }; "visibleGlobal": { "alias": "visibleGlobal"; "required": false; }; "fieldIconPolicy": { "alias": "fieldIconPolicy"; "required": false; }; "domainRules": { "alias": "domainRules"; "required": false; }; "customEndpoints": { "alias": "customEndpoints"; "required": false; }; }, { "formSubmit": "formSubmit"; "formCancel": "formCancel"; "formReset": "formReset"; "configChange": "configChange"; "configPatchChange": "configPatchChange"; "formReady": "formReady"; "valueChange": "valueChange"; "payloadPreviewChange": "payloadPreviewChange"; "syncCompleted": "syncCompleted"; "initializationError": "initializationError"; "loadingStateChange": "loadingStateChange"; "enableCustomizationChange": "enableCustomizationChange"; "customAction": "customAction"; "actionConfirmation": "actionConfirmation"; "schemaStatusChange": "schemaStatusChange"; "fieldRenderError": "fieldRenderError"; "ruleDiagnosticsChange": "ruleDiagnosticsChange"; "reactiveDeterminationExecuted": "reactiveDeterminationExecuted"; "reactiveDeterminationPendingChange": "reactiveDeterminationPendingChange"; }, never, never, true, never>;
 }
 
 declare class FormConfigService {
@@ -1581,6 +1606,10 @@ declare class JsonConfigEditorComponent implements OnInit, OnDestroy {
     getCurrentConfig(): FormConfig | null;
     getCurrentDocument(): DynamicFormAuthoringDocument | null;
     hasChanges(): boolean;
+    diagnosticMessage(diagnostic: {
+        code: string;
+        message: string;
+    }): string;
     private validateJson;
     private updateValidationState;
     insertHooksTemplate(): void;
@@ -1681,6 +1710,7 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     };
     private initialConfig;
     private initialDocument;
+    private appliedDocument?;
     private readonly openedWithCanonicalDocument;
     readonly runtimeContext?: DynamicFormRuntimeContext;
     readonly runtimeContract?: DynamicFormResolvedRuntimeContract;
@@ -1691,7 +1721,26 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     inputMode: 'create' | 'edit' | 'view';
     private includeBindingsBlock;
     private readonly editorMode;
-    isPresentationMode: boolean;
+    get isPresentationMode(): boolean;
+    supportsPresentationSettings: boolean;
+    inputPresentationMode: boolean | null | undefined;
+    inputEmptyState: PraxisDynamicFormEmptyState | null | undefined;
+    private readonly emptyStateIconPicker;
+    readonly emptyStateOptions: {
+        readonly tone: readonly ["neutral", "primary", "secondary"];
+        readonly variant: readonly ["card", "inline", "panel", "transparent"];
+        readonly alignment: readonly ["start", "center"];
+        readonly density: readonly ["compact", "comfortable"];
+        readonly iconContainer: readonly ["none", "circle", "soft"];
+    };
+    setEmptyStateEnabled(enabled: boolean): void;
+    onEmptyStateChange(): void;
+    pickEmptyStateIcon(): Promise<void>;
+    get displayMode(): 'automatic' | 'fields' | 'presentation';
+    onDisplayModeChange(value: 'automatic' | 'fields' | 'presentation'): void;
+    get displayModeHint(): string;
+    useViewMode(): void;
+    openPresentationStyle(): void;
     truncatePreview: boolean;
     previewItems: Array<{
         label: string;
@@ -1732,6 +1781,11 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private globalActionValidationIssues;
     private readonly i18n;
     readonly globalActionCatalog: GlobalActionCatalogEntry[];
+    private readonly invalidSurfaceDrafts;
+    get hasInvalidSurfaceDraft(): boolean;
+    onSurfaceDraftValidity(source: {
+        discardInvalidDrafts(): void;
+    }, valid: boolean): void;
     isDirty$: BehaviorSubject<boolean>;
     isValid$: BehaviorSubject<boolean>;
     isBusy$: BehaviorSubject<boolean>;
@@ -1746,6 +1800,7 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     constructor(storage: AsyncConfigStorage, configService: FormConfigService, settingsPanel: SettingsPanelService, cdr: ChangeDetectorRef, globalActionCatalogSource?: ReadonlyArray<GlobalActionCatalogEntry[]>, injectedData?: any);
     ngOnInit(): void;
     reset(): void;
+    acceptAppliedValue(value: unknown): void;
     updateDirtyState(reason?: string): void;
     getSettingsValue(): any;
     onSave(): any;
@@ -1847,7 +1902,7 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private toPresentationSnapshot;
     private toSchemaPrefsSnapshot;
     private toBackConfigSnapshot;
-    tx(key: string, fallback: string, params?: Record<string, string | number | boolean | null | undefined>): string;
+    tx(key: string, fallback?: string, params?: Record<string, string | number | boolean | null | undefined>): string;
     private resolveI18n;
     private interpolateFallback;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisDynamicFormConfigEditor, [null, null, null, null, { optional: true; }, { optional: true; }]>;
@@ -2016,6 +2071,12 @@ declare class LayoutEditorComponent implements OnInit {
     configChange: EventEmitter<FormConfig>;
     paletteCollapsed: boolean;
     protected readonly prefs: LayoutPrefsService;
+    private readonly dialog;
+    private readonly changeDetector;
+    private readonly host;
+    private readonly injector;
+    private readonly sectionEditors;
+    protected fieldMoveError: string;
     private readonly layoutService;
     private readonly settingsPanel;
     private readonly i18n;
@@ -2053,6 +2114,7 @@ declare class LayoutEditorComponent implements OnInit {
     /**
      * Fields that are not yet placed in any section/column of the layout.
      */
+    get hasEligibleApiFields(): boolean;
     get availableFields(): FieldMetadata[];
     t(key: string, params?: Record<string, string | number | boolean | null | undefined>): string;
     get columnDropListIds(): string[];
@@ -2064,6 +2126,7 @@ declare class LayoutEditorComponent implements OnInit {
     selectSection(sectionIndex: number): void;
     selectRow(sectionIndex: number, rowIndex: number): void;
     selectColumn(sectionIndex: number, rowIndex: number, columnIndex: number): void;
+    openFieldMoveDialog(event: EditFieldEvent): void;
     dropField({ event }: FieldDropEvent): void;
     private getColumnLayoutItemByIndex;
     private getColumnTargetByIndex;
@@ -2089,6 +2152,7 @@ declare class LayoutEditorComponent implements OnInit {
     moveVisualBlock(event: MoveVisualBlockEvent): void;
     moveVisualBlockToColumn(event: MoveVisualBlockToColumnEvent): void;
     removeVisualBlock(event: VisualBlockEvent): void;
+    private focusVisualBlockSelectionAfterRender;
     private emitNewConfig;
     onApplyStyleToAll(patch: Partial<FormSection>): void;
     trackBySection(index: number, s: FormSection & {
@@ -2183,10 +2247,10 @@ declare class RowConfiguratorComponent implements OnChanges {
     trackLayoutItem(_: number, item: FormLayoutItem): string;
     hasColumnContent(column: FormColumn): boolean;
     getVisualBlockLabel(item: FormLayoutItem): string;
-    private findRichContentLabel;
-    private findRichNodeLabel;
+    formatGap(value: number | null | undefined): string;
     t(key: string, params?: Record<string, string | number | boolean | null | undefined>): string;
     getFieldLabel(field: FieldMetadata): string;
+    onVisualBlockKeydown(columnIndex: number, item: FormLayoutItem, event: Event, edit: boolean): void;
     selectVisualBlock(columnIndex: number, item: FormLayoutItem, event: Event): void;
     openVisualBlockEditor(columnIndex: number, item: FormLayoutItem, event: Event): void;
     moveVisualBlockItem(columnIndex: number, item: FormLayoutItem, direction: -1 | 1, event: Event): void;
@@ -2197,8 +2261,13 @@ declare class RowConfiguratorComponent implements OnChanges {
     selectRow(): void;
     openColumnConfig(index: number): void;
     selectColumn(index: number, event: MouseEvent): void;
-    selectField(fieldName: string, columnIndex: number, event: MouseEvent): void;
+    selectField(fieldName: string, columnIndex: number, event: Event): void;
+    selectFieldFromKeyboard(fieldName: string, columnIndex: number, event: Event): void;
     openFieldEditor(fieldName: string, columnIndex: number, event: Event): void;
+    readonly columnPresets: {
+        label: string;
+        spans: number[];
+    }[];
     openRowMenu(): void;
     onMenuClosed(): void;
     onDropEnter(index: number): void;
@@ -2218,7 +2287,7 @@ declare class RowConfiguratorComponent implements OnChanges {
     addFieldToColumn(index: number): void;
     getColumnId(index: number): string;
     private generateId;
-    applyPreset(spansMd: number[]): void;
+    applyPreset(spans: number[]): void;
     getColumnClass(column: any): string;
     getSpanClasses(column: any): string[];
     getColumnClassList(column: any): string;
@@ -2233,6 +2302,9 @@ declare class RowConfiguratorComponent implements OnChanges {
     clearRowGap(): void;
     hasMultipleColumns(): boolean;
     getSpanTotal(bp?: Breakpoint): number;
+    private participatesInRowGuidance;
+    private getOccupiedRowUnits;
+    getRowSpaceGuidance(): string | null;
     getOffsetFor(column: any, bp?: Breakpoint): number;
     setOffset(columnIndex: number, value: number): void;
     adjustOffset(columnIndex: number, delta: number): void;
@@ -2243,6 +2315,8 @@ declare class RowConfiguratorComponent implements OnChanges {
 
 declare class FieldConfiguratorComponent {
     private readonly registry;
+    private readonly i18n;
+    get hiddenLabel(): string;
     field: FieldMetadata;
     private readonly categoryByType;
     private resolveEditorialMeta;
@@ -2258,7 +2332,12 @@ declare class FieldConfiguratorComponent {
 
 interface PraxisDynamicFormWidgetEditorInputs {
     config?: FormConfig | null;
+    layoutPolicy?: DynamicFormLayoutPolicy | null;
+    configPersistenceStrategy?: 'local-first' | 'input-first';
     mode?: DynamicFormMode;
+    emptyState?: PraxisDynamicFormEmptyState | null;
+    presentationModeGlobal?: boolean | null;
+    presentation?: DynamicFormPresentationSnapshot | null;
     formId?: string;
     componentInstanceId?: string;
     backConfig?: BackConfig;
@@ -2273,21 +2352,32 @@ interface PraxisDynamicFormWidgetEditorValue {
 declare class PraxisDynamicFormWidgetConfigEditor implements SettingsValueProvider, AfterViewInit, OnDestroy {
     inputs: PraxisDynamicFormWidgetEditorInputs | null;
     widgetKey?: string;
+    appliedValues$?: Observable<unknown>;
+    private appliedSource?;
+    /** Runtime evidence supplied by the existing component editor context resolver. */
+    context: Record<string, unknown>;
     formEditor?: PraxisDynamicFormConfigEditor;
     readonly isDirty$: BehaviorSubject<boolean>;
     readonly isValid$: BehaviorSubject<boolean>;
     readonly isBusy$: BehaviorSubject<boolean>;
     private readonly subscription;
+    private initialEditorConfig?;
+    private sourceDraft?;
+    get configurationSource(): 'local-first' | 'input-first';
+    changeConfigurationSource(value: string): void;
+    private updateDirtyState;
+    private readonly cdr;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     getSettingsValue(): PraxisDynamicFormWidgetEditorValue;
     onSave(): PraxisDynamicFormWidgetEditorValue;
+    acceptAppliedValue(value: unknown): void;
     reset(): void;
     private initializeChildEditor;
     private buildValue;
     private createDocumentFromInputs;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisDynamicFormWidgetConfigEditor, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisDynamicFormWidgetConfigEditor, "praxis-dynamic-form-widget-config-editor", never, { "inputs": { "alias": "inputs"; "required": false; }; "widgetKey": { "alias": "widgetKey"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisDynamicFormWidgetConfigEditor, "praxis-dynamic-form-widget-config-editor", never, { "inputs": { "alias": "inputs"; "required": false; }; "widgetKey": { "alias": "widgetKey"; "required": false; }; "appliedValues$": { "alias": "appliedValues$"; "required": false; }; "context": { "alias": "context"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 /** Metadata for PraxisDynamicForm component */
@@ -2505,6 +2595,9 @@ declare class SectionEditorComponent implements OnInit, AfterViewInit, OnDestroy
         value: string;
         label: string;
     }>;
+    private readonly invalidSurfaceDrafts;
+    get hasInvalidSurfaceDraft(): boolean;
+    onSurfaceDraftValidity(source: SurfaceOpenActionEditorComponent, valid: boolean): void;
     isDirty$: BehaviorSubject<boolean>;
     isValid$: BehaviorSubject<boolean>;
     isBusy$: BehaviorSubject<boolean>;
@@ -2625,10 +2718,27 @@ declare class RowEditorComponent implements OnInit, OnDestroy, SettingsValueProv
     static ɵcmp: i0.ɵɵComponentDeclaration<RowEditorComponent, "praxis-row-editor", never, {}, {}, never, never, true, never>;
 }
 
+declare const COLUMN_LAYOUT_LIMITS: {
+    readonly span: {
+        readonly min: 1;
+        readonly max: 12;
+    };
+    readonly offset: {
+        readonly min: 0;
+        readonly max: 11;
+    };
+    readonly order: {
+        readonly min: -12;
+        readonly max: 12;
+    };
+};
+type ColumnLayoutNumber = keyof typeof COLUMN_LAYOUT_LIMITS;
+
 declare class ColumnEditorComponent implements OnInit, OnDestroy, SettingsValueProvider {
     private fb;
     private data;
     form: FormGroup;
+    readonly gridParts: number[];
     breakpoints: Breakpoint[];
     previewBreakpoint: Breakpoint;
     column: FormColumn;
@@ -2641,7 +2751,24 @@ declare class ColumnEditorComponent implements OnInit, OnDestroy, SettingsValueP
     private readonly i18n;
     constructor(fb: FormBuilder, data: {
         column: FormColumn;
+        fieldMetadata?: FieldMetadata[];
     });
+    readonly alignmentOptions: readonly [{
+        readonly value: "start";
+        readonly icon: "vertical_align_top";
+    }, {
+        readonly value: "center";
+        readonly icon: "vertical_align_center";
+    }, {
+        readonly value: "end";
+        readonly icon: "vertical_align_bottom";
+    }, {
+        readonly value: "stretch";
+        readonly icon: "height";
+    }];
+    alignmentLabel(value: string): string;
+    get fieldLabels(): string[];
+    breakpointLabel(bp: Breakpoint): string;
     ngOnInit(): void;
     ngOnDestroy(): void;
     private applyChanges;
@@ -2656,6 +2783,8 @@ declare class ColumnEditorComponent implements OnInit, OnDestroy, SettingsValueP
     adjustOffset(delta: number): void;
     getOrder(bp: Breakpoint): number;
     setOrder(value: number | string): void;
+    layoutControl(property: ColumnLayoutNumber): FormControl;
+    get invalidLayoutLocations(): string;
     isHidden(bp: Breakpoint): boolean;
     toggleHidden(): void;
     copyToLarger(): void;