@praxisui/dynamic-form 10.0.0-rc.37 → 10.0.0-rc.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "10.0.0-rc.37",
+  "version": "10.0.0-rc.38",
   "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": "^10.0.0-rc.37",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.37",
-    "@praxisui/metadata-editor": "^10.0.0-rc.37",
-    "@praxisui/rich-content": "^10.0.0-rc.37",
-    "@praxisui/settings-panel": "^10.0.0-rc.37",
-    "@praxisui/visual-builder": "^10.0.0-rc.37",
-    "@praxisui/core": "^10.0.0-rc.37",
+    "@praxisui/ai": "^10.0.0-rc.38",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.38",
+    "@praxisui/metadata-editor": "^10.0.0-rc.38",
+    "@praxisui/rich-content": "^10.0.0-rc.38",
+    "@praxisui/settings-panel": "^10.0.0-rc.38",
+    "@praxisui/visual-builder": "^10.0.0-rc.38",
+    "@praxisui/core": "^10.0.0-rc.38",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

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

@@ -57,7 +57,7 @@ Este documento e a referencia canonica da API JSON de praxis-dynamic-form-config
 
 - 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`.
+- Em replace-all, omitir a preferência remove o override anterior; `false` deve ser preservado. A UI prefere os três modos de operação; documentos nativos também aceitam e preservam `presentation` e `dossier`, já suportados pelo runtime.
 - 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.
 
@@ -287,7 +287,7 @@ A entrada operacional vem via `SETTINGS_PANEL_DATA` (injetado pelo settings pane
 | `backConfig` | `BackConfig` | Nao | Active | Configuracao de retorno do CRUD; fallback local quando ausente. |
 | `formId` | `string` | Nao | Active | Identidade para persistencia auxiliar e chave de painel. |
 | `componentKeyId` | `string` | Nao | Active | Prioridade para chave de persistencia quando informado. |
-| `mode` | `'create' \| 'edit' \| 'view'` | Nao | Active | Inicializa `inputMode`; invalido cai para `create`. |
+| `mode` | `'create' \| 'edit' \| 'view' \| 'presentation' \| 'dossier'` | Nao | Active | Inicializa `inputMode`; invalido cai para `create`. |
 | `presentationMode` | `boolean` | Nao | Active | Controla exibicao da aba "Modo Apresentacao". |
 | `runtimeContext` | `DynamicFormRuntimeContext` | Nao | Active | Contexto operacional somente leitura; pode expor `resolvedContract.schemaUrl/submitUrl/submitMethod` para diagnosticos visuais, sem persistencia no documento autoral. |
 
@@ -318,7 +318,7 @@ A entrada operacional vem via `SETTINGS_PANEL_DATA` (injetado pelo settings pane
     labelAlign?: 'start' | 'center' | 'end';
     valueAlign?: 'start' | 'center' | 'end';
   };
-  inputsPatch: { mode: 'create' | 'edit' | 'view' };
+  inputsPatch: { mode: 'create' | 'edit' | 'view' | 'presentation' | 'dossier' };
   schemaPrefs: {
     notifyIfOutdated: 'inline' | 'snackbar' | 'both' | 'none';
     snoozeMs: number;

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

@@ -38,7 +38,7 @@ source_of_truth:
   - "projects/praxis-core/src/lib/models/form/rule-property.schema.ts"
   - "projects/praxis-dynamic-form/docs/layout-items-visual-blocks.md"
 source_of_truth_last_verified: "2026-08-12"
-last_updated: "2026-08-12"
+last_updated: "2026-10-22"
 toc: true
 sidebar: true
 tags:
@@ -59,6 +59,10 @@ related_components: []
 
 Este documento e a referencia canonica da API JSON de praxis-dynamic-form.
 
+## Form runtime ownership (breaking beta correction)
+
+Every mounted form owns its mutable `GenericCrudService` and editor field/rule context. Replacing a service in an ancestor injector no longer changes the form's client. Configure the form through `resourcePath`, `apiEndpointKey`, `apiUrlEntry`, and `customEndpoints` for a directly mounted form. Shared `HttpClient` interceptors, `API_URL` and infrastructure remain inherited. No new JSON/config field is introduced by this correction. In component tests, replace the local client with `TestBed.overrideComponent(PraxisDynamicForm, { add: { providers: [{ provide: GenericCrudService, useValue: crudMock }] } })` so the i18n provider is retained.
+
 ## Summary
 
 - Tipo documental: API reference canonica de contrato JSON.
@@ -70,7 +74,7 @@ Este documento e a referencia canonica da API JSON de praxis-dynamic-form.
 
 - 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`.
+- Em replace-all, omitir a preferência remove o override anterior; `false` deve ser preservado. A UI prefere os três modos de operação; documentos nativos preservam também `presentation` e `dossier` suportados pelo runtime.
 - 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.
 - `presentationPreset` (`'corporate-dossier' | 'editorial-card' | 'compact-presentation' | 'default'`) define o preset visual nativo em modo apresentação (`view`). Pode ser configurado via `@Input() presentationPreset`, em `FormPresentationConfig.preset` / `FormPresentationConfig.presentationPreset`, em `FormConfigMetadata.presentationPreset`, ou por seção via `FormSection.presentationPreset` para sobrescrever o estilo de uma seção específica sem recorrer a regras CSS ad hoc com `::ng-deep`.
@@ -278,7 +282,7 @@ of initial values: a contextual `resourceId` never triggers entity hydration.
 | `config` | `FormConfig` | Conditional | component-input | `normalizeFormConfig(config)` | Contrato principal quando fornecido diretamente pelo host. |
 | `resourcePath` | `string \| undefined` | Conditional | component-input | `crud.configure(resourcePath)` | Endpoint base para schema e dados remotos. Alternativa canônica: `schemaUrl` explícito. |
 | `resourceId` | `string \| number \| undefined` | No | component-input | update `pendingEntityId`; hydrate only in `edit/view` | Carrega entidade em modo `edit/view`. Em `create`, pode identificar o item dono de um comando sem iniciar leitura nem bloquear os campos. |
-| `mode` | `'create' \| 'edit' \| 'view'` | No | component-input/storage | persistido em `formInputsKey` | Preferência de modo pode ser hidratada do storage. |
+| `mode` | `'create' \| 'edit' \| 'view' \| 'presentation' \| 'dossier'` | No | component-input/storage | persistido em `formInputsKey` | Preferência de modo pode ser hidratada do storage. |
 | `schemaSource` | `'resource' \| 'filter'` | No | component-input | runtime branch | Seleciona caminho de obtenção de schema quando `schemaUrl` não é informado. |
 | `schemaUrl` | `string \| null \| undefined` | Conditional | component-input | parsed as `/schemas/filtered` contract | Fonte canônica explícita para inicialização schema-backed sem depender de `resourcePath`. |
 | `readUrl` | `string \| null \| undefined` | No | component-input | resolved via API origin and `{id}` placeholders | URL concreta de leitura publicada por surface `VIEW`/`READ_PROJECTION`; quando presente, substitui `crud.getById` na hidratação da entidade. |
@@ -623,7 +627,7 @@ No ecossistema Praxis, ele funciona tanto como runtime final quanto como superfi
 | `config` | `FormConfig` | `{ sections: [] }` | Active | Contrato principal consumido no ciclo inteiro. `sections` é opcional somente para forms schema-driven com grounding explícito (`metadata.source='schema'`, schema metadata ou fonte runtime como `schemaUrl`/`resourcePath`); ausência de layout manual é normalizada internamente como array vazio e permite que `layoutPolicy`/schema materializem agrupamentos. |
 | `resourcePath` | `string \| undefined` | `undefined` | Active | Habilita carga de schema/dados remotos. Opcional quando `schemaUrl` explícito é fornecido. |
 | `resourceId` | `string \| number \| undefined` | `undefined` | Active | Carrega entidade no modo `edit/view`; em `create`, funciona apenas como contexto do item e não dispara hidratação. |
-| `mode` | `'create' \| 'edit' \| 'view'` | `'create'` | Active | Governa submit, leitura e apresentacao. |
+| `mode` | `'create' \| 'edit' \| 'view' \| 'presentation' \| 'dossier'` | `'create'` | Active | Governa submit, leitura e apresentacao. |
 | `schemaSource` | `'resource' \| 'filter'` | `'resource'` | Active | Seleciona origem do schema remoto. |
 | `schemaUrl` | `string \| undefined` | `undefined` | Active | Permite usar schema canonico publicado pelo backend sem heuristica local de path e pode iniciar o fluxo corporativo sem `resourcePath`. |
 | `readUrl` | `string \| undefined` | `undefined` | Active | Hidrata dados de surfaces de leitura/projecao pelo endpoint publicado, preservando `resourcePath` como recurso dono. |
@@ -641,7 +645,7 @@ No ecossistema Praxis, ele funciona tanto como runtime final quanto como superfi
 | `enableCustomization` | `boolean` | `false` | Active | Habilita UX de customizacao do layout. |
 | `formId` | `string \| undefined` | `undefined` | Active | Chave de persistencia e identidade logica. |
 | `componentInstanceId` | `string \| undefined` | `undefined` | Active | Isola instancias com mesmo `formId`. |
-| `configPersistenceStrategy` | `'local-first' \| 'input-first'` | `'local-first'` | Active | Em `input-first`, os inputs fornecidos pelo host, inclusive `mode`, permanecem autoritativos sobre preferencias persistidas da mesma instancia. Combine com `layoutPolicy.persistence='transient'` em commands efemeros para nao carregar nem gravar layout local. |
+| `configPersistenceStrategy` | `'local-first' \| 'input-first' \| 'volatile'` | `'local-first'` | Active | Em `input-first`, os inputs fornecidos pelo host, inclusive `mode`, permanecem autoritativos sobre preferencias persistidas da mesma instancia. Use `volatile` para filhos controlados pela página: não lê, grava nem limpa preferências próprias ou conexão persistida. `layoutPolicy.persistence='transient'` continua governando a persistência do layout gerado. |
 | `layout` | `FormLayout \| undefined` | `undefined` | Partial | Funciona como override estrutural em parte dos fluxos de layout/editor. |
 | `generatedLayoutPreset` | `'default' \| 'compactPresentation'` | `'default'` | Active | Usado apenas ao criar a configuracao inicial a partir de schema/metadata; nao reprocessa layouts persistidos ou authorados. |
 | `layoutPolicy` | `DynamicFormLayoutPolicy \| null` | `null` | Active | Politica opt-in para materializar layout a partir do schema atual. Use `source: 'schema'` com `persistence: 'transient'` para detalhe/read-only e command forms schema-driven sem persistir `sections` geradas nem reabrir configuracao local salva; politicas de host em `config`, como `helpPresentation`, continuam sendo aplicadas ao layout materializado. Em `mode='view'`, `intent: 'detail'` ou `preset: 'compactPresentation'` ativa apresentacao quando `presentationModeGlobal` nao foi informado; use `[presentationModeGlobal]=false` para controles read-only tradicionais. No preset `compactPresentation`, `x-ui.width` explicito empacota campos em linhas de 12 colunas e tem precedencia sobre `detailSummary.columns` por default; campos sem width permanecem full-width, a menos que `detailSummary.columns`/`responsiveColumns` declare a densidade do resumo. Use `detailSummary.widthPrecedence='summary'` quando a densidade do resumo read-only deve sobrescrever `x-ui.width` apenas nessa surface compacta. No preset `groupedCommand`, `groupedCommand.orphanFieldExpansion` controla linhas logicas com um unico campo: `medium-and-wide` (default) expande spans 6/8, `preserve` mantem o width publicado e `all` tambem expande campos compactos. `groupedCommand.partialRowStrategy` usa `preserve` por default; `fill-compatible` particiona o grupo nas linhas visuais depois de resolver visibilidade responsiva, CSS `order` e wrap em cada breakpoint/container, projeta cada linha parcial elegivel em spans canônicos que completam 12 colunas e mapeia o resultado de volta as colunas authoradas apenas para renderizacao, sem alterar `x-ui.width`, `sections` ou o documento de authoring. Um singleton elegivel criado por wrap pode preencher sua linha visual; controles compactos, uploads e tipos desconhecidos preservam seus spans. `groupedCommand.contextFields` identifica campos schema-backed já hidratados pela surface: eles permanecem no `FormGroup` e no payload, mas não renderizam controles redundantes. Use `responsiveColumns`, por exemplo `{ lg: 3, md: 2, sm: 1 }`, para drawers, side sheets e painéis corporativos estreitos sem copiar `FormConfig.sections` locais. `schemaType` e `schemaOperation` sao validados contra `schemaUrl` quando a URL declara esses parametros. |

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

@@ -7,7 +7,7 @@ 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, DynamicFormMode, AiCapability, DynamicFormLayoutScope, BackConfig, FormPresentationConfig, EmptyStateTone, EmptyStateVariant, EmptyStateAlignment, EmptyStateDensity, EmptyStateIconContainer, FormPresentationPreset, RichBlockHostCapabilities, ApiEndpoint, ApiUrlEntry, FormLayoutMode, FormLayoutOptions, DynamicFormLayoutPolicy, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, FormPayloadPreviewEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, FormLayoutTabItem, RichContentDocument, JsonLogicRecord, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, ApiUrlConfig, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, EnterpriseRuntimeContextService, FormLayoutTabsAppearance, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, JsonLogicExpression, FormHelpPresentationConfig, GlobalActionCatalogEntry, PraxisRuntimeConditionalEffectRule, PraxisRuntimeGlobalActionEffect, SurfaceOpenPayload, GlobalActionField, PraxisEffectPolicy, FieldDefinition, ComponentDocMeta, Breakpoint, DomainRuleRequestOptions, DomainRuleService, DomainRuleMaterialization, SchemaIdParams, CompiledDynamicFormSchema, TableConfig, SurfaceOpenActionEditorComponent, 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, DynamicFormMode, AiCapability, DynamicFormLayoutScope, BackConfig, FormPresentationConfig, EmptyStateTone, EmptyStateVariant, EmptyStateAlignment, EmptyStateDensity, EmptyStateIconContainer, FormPresentationPreset, RichBlockHostCapabilities, ApiEndpoint, ApiUrlEntry, FormLayoutMode, FormLayoutOptions, DynamicFormLayoutPolicy, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, FormPayloadPreviewEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, FormLayoutTabItem, RichContentDocument, JsonLogicRecord, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, ApiUrlConfig, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, EnterpriseRuntimeContextService, FormLayoutTabsAppearance, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, JsonLogicExpression, FormHelpPresentationConfig, GlobalActionCatalogEntry, PraxisRuntimeConditionalEffectRule, PraxisRuntimeGlobalActionEffect, SurfaceOpenPayload, GlobalActionField, PraxisEffectPolicy, FieldDefinition, ComponentDocMeta, DiscoveredResourceOption, Breakpoint, DomainRuleRequestOptions, DomainRuleService, DomainRuleMaterialization, SchemaIdParams, CompiledDynamicFormSchema, TableConfig, SurfaceOpenActionEditorComponent, IconPickerService, GlobalActionRef, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest, WidgetInstance } from '@praxisui/core';
 export { CompiledDynamicFormSchema, DynamicFormLayoutScope, DynamicFormMode } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { Observable, Subscription, BehaviorSubject } from 'rxjs';
@@ -591,7 +591,7 @@ interface DynamicFormSchemaPrefsSnapshot {
 }
 interface DynamicFormContextSnapshot {
     backConfig?: BackConfig;
-    presentation?: DynamicFormPresentationSnapshot;
+    presentation?: DynamicFormPresentationSnapshot | null;
     schemaPrefs?: DynamicFormSchemaPrefsSnapshot;
 }
 interface DynamicFormAuthoringDocument extends EditorDocument<FormConfig, DynamicFormBindings> {
@@ -854,7 +854,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     /** Identifier for persisting layouts */
     formId?: string;
     componentInstanceId?: string;
-    configPersistenceStrategy: 'local-first' | 'input-first';
+    configPersistenceStrategy: 'local-first' | 'input-first' | 'volatile';
     /** Optional layout to use instead of generated one */
     layout?: FormLayout;
     /**
@@ -1039,6 +1039,10 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private schemaCache;
     private lastSchemaMeta?;
     private readonly schemaMetaPersistenceQueues;
+    private persistenceContextEpoch;
+    private persistenceContextDestroyed;
+    /** Fence delayed work; requests already sent are not retroactively canceled. */
+    private persistenceGuard;
     private readonly formConfigPersistenceQueues;
     private readonly formConfigPersistenceGenerations;
     private readonly formConfigConflictBlockThrough;
@@ -1870,6 +1874,8 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     };
     private destroy$;
     private hasProcessedInitialRuleState;
+    ruleConversionFailed: boolean;
+    private readonly jsonLogic;
     private jsonEditorIsValid;
     private globalActionValidationIssues;
     private readonly i18n;
@@ -1953,6 +1959,7 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     getRuleDiagnosticDetails(diagnostic: FormRuleDiagnostics): string[];
     private getRulePropertyIssueNames;
     private markLlmRuleAccepted;
+    private projectBuilderRules;
     private refreshRuleDiagnostics;
     get jsonDocument(): DynamicFormAuthoringDocument;
     onBackConfigChange(): void;
@@ -2097,6 +2104,7 @@ declare class PraxisFilterFormWidgetConfigEditor implements SettingsValueProvide
     private childBusy;
     private schemaLoading;
     private resourcePathDraft?;
+    private selectedCatalogResource;
     private committedBaselineDocument?;
     private readonly crudService;
     private readonly resourceDiscovery;
@@ -2105,6 +2113,7 @@ declare class PraxisFilterFormWidgetConfigEditor implements SettingsValueProvide
     get effectiveEndpointKey(): ApiEndpoint | undefined;
     get effectiveApiUrlEntry(): ApiUrlEntry | null | undefined;
     onResourceQuickConnect(resourcePath: string): void;
+    onCatalogResourceSelected(entry: DiscoveredResourceOption | null): void;
     onResourceQuickClear(): void;
     private updateDirtyState;
     ngAfterViewInit(): void;
@@ -2117,6 +2126,8 @@ declare class PraxisFilterFormWidgetConfigEditor implements SettingsValueProvide
     private applyBaselineDocumentToChildEditor;
     private applyDraftDocumentToChildEditor;
     private loadFilterSchemaFieldsIfNeeded;
+    private extractCatalogFallbackFields;
+    private applyLoadedFilterFieldMetadata;
     private buildDiscoveryOptions;
     private buildValue;
     private createDocumentFromInputs;
@@ -2238,6 +2249,10 @@ declare class LayoutEditorComponent implements OnInit {
     get layoutSections(): FormSection[];
     canApplyAll(): boolean;
     applyGapToAll(): void;
+    canCalibrateFieldsFromSemantics(): boolean;
+    calibrateAllFieldsFromSemantics(): void;
+    canOrganizeSectionsFromSemantics(): boolean;
+    organizeSectionsFromSemantics(): void;
     ngOnInit(): void;
     handleKeydown(event: KeyboardEvent): void;
     /**
@@ -2472,7 +2487,7 @@ interface PraxisDynamicFormWidgetEditorInputs {
     apiUrlEntry?: ApiUrlEntry | null;
     schemaSource?: 'resource' | 'filter';
     layoutPolicy?: DynamicFormLayoutPolicy | null;
-    configPersistenceStrategy?: 'local-first' | 'input-first';
+    configPersistenceStrategy?: 'local-first' | 'input-first' | 'volatile';
     mode?: DynamicFormMode;
     emptyState?: PraxisDynamicFormEmptyState | null;
     presentationModeGlobal?: boolean | null;
@@ -2513,12 +2528,16 @@ declare class PraxisDynamicFormWidgetConfigEditor implements SettingsValueProvid
     private committedBaselineDocument?;
     private sourceDraft?;
     private resourcePathDraft?;
+    selectedCatalogResource: DiscoveredResourceOption | null;
     private optionalInject;
-    get configurationSource(): 'local-first' | 'input-first';
+    get configurationSource(): 'local-first' | 'input-first' | 'volatile';
     get effectiveResourcePath(): string;
     get effectiveEndpointKey(): ApiEndpoint | undefined;
     get effectiveApiUrlEntry(): ApiUrlEntry | null | undefined;
     get effectiveDiscoveryIntent(): 'crud' | 'filter';
+    get hasReadOnlyModeWarning(): boolean;
+    switchToReadOnlyViewMode(): void;
+    onCatalogResourceSelected(resource: DiscoveredResourceOption | null): void;
     changeConfigurationSource(value: string): void;
     onResourceQuickConnect(resourcePath: string): void;
     onResourceQuickClear(): void;
@@ -2535,6 +2554,8 @@ declare class PraxisDynamicFormWidgetConfigEditor implements SettingsValueProvid
     private applyBaselineDocumentToChildEditor;
     private applyDraftDocumentToChildEditor;
     private loadResourceSchemaFieldsIfNeeded;
+    private extractCatalogFallbackFields;
+    private applyFieldMetadataHydration;
     private buildDiscoveryOptions;
     private buildValue;
     private createDocumentFromInputs;
@@ -2649,6 +2670,7 @@ declare function applyVisibilityRules(rules: FormLayoutRule[], data: any): Recor
 /**
  * Converts a RuleBuilderState produced by the visual builder into
  * an array of FormLayoutRule objects understood by the dynamic form.
+ * Throws when a referenced condition graph cannot be serialized without losing semantics.
  */
 declare function ruleBuilderStateToFormLayoutRules(state: RuleBuilderState | null | undefined): FormLayoutRule[];
 /**
@@ -3230,7 +3252,47 @@ declare const PRAXIS_FILTER_FORM_AUTHORING_PROJECTION: {
     readonly operationIds: readonly ["field.label.set", "field.placeholder.set", "field.required.set", "field.readOnly.set", "field.disabled.set", "field.hidden.set", "field.controlType.set", "field.optionSource.set", "field.local.add", "field.local.remove", "layout.section.add", "layout.section.remove", "layout.row.add", "layout.column.add", "layout.field.move"];
     readonly roundTripRequirements: readonly ["strip-undefined", "stable-field-order", "preserve-local-field-source", "preserve-section-row-column-ids"];
 };
-declare const PRAXIS_FILTER_FORM_AUTHORING_MANIFEST: _praxisui_core.ComponentAuthoringManifest;
+declare const PRAXIS_FILTER_FORM_AUTHORING_MANIFEST: {
+    runtimeInputs: _praxisui_core.ManifestInput[];
+    schemaVersion: string;
+    componentId: string;
+    ownerPackage: string;
+    configSchemaId: string;
+    manifestVersion: string;
+    editableTargets: _praxisui_core.ManifestTarget[];
+    operations: _praxisui_core.ManifestOperation[];
+    validators: _praxisui_core.ManifestValidator[];
+    roundTripRequirements?: string[];
+    presentationAffordances?: _praxisui_core.ManifestPresentationAffordanceCatalog;
+    examples: _praxisui_core.ManifestExample[];
+    controlProfiles?: _praxisui_core.ManifestControlProfile[];
+};
+
+/** Reconstruct raw native authorship. Normalized editor/runtime defaults are never the source. */
+declare function decodeDynamicFormPageInputs(value: unknown): {
+    document: DynamicFormAuthoringDocument | null;
+    diagnostics: EditorDiagnostic[];
+};
+/** Owner callback for Core admission; no component loading or second config authority. */
+declare function validateDynamicFormPageWidget(widget: WidgetInstance): readonly {
+    code: string;
+    path: string;
+}[];
+/** Inverse native projection. Explicit unrepresentable authoring blocks fail instead of being filtered. */
+declare function encodeDynamicFormPageInputs(value: unknown): {
+    inputs: Record<string, unknown> | null;
+    diagnostics: EditorDiagnostic[];
+};
+/** Persist only explicit deltas from the mounted native editor; bindings/context stay pinned to the seed. */
+declare function projectDynamicFormPageEditorChanges(authoredInputs: unknown, editorBaseline: unknown, editorValue: unknown): {
+    inputs: Record<string, unknown> | null;
+    diagnostics: EditorDiagnostic[];
+};
+/** Derive execution-only identity and disable independent preferences. Never persist this projection. */
+declare function materializeDynamicFormPageRuntimeInputs(value: unknown, pageId: string, widgetKey: string): {
+    inputs: Record<string, unknown> | null;
+    diagnostics: EditorDiagnostic[];
+};
 
-export { ActionsEditorComponent, CORPORATE_PRESENTATION_FORMAT_GALLERY, CanvasStateService, CanvasToolbarComponent, ColumnEditorComponent, DomainRuleFormRulesService, DynamicFormLayoutService, DynamicFormSchemaCacheService, ERGADM00034_COMPACT_PRESENTATION_EXAMPLE, Ergadm00034CompactPresentationExampleComponent, FORM_AI_CAPABILITIES, FORM_COMPONENT_AI_CAPABILITIES, FieldConfiguratorComponent, FieldEditorComponent, FormConfigService, FormContextService, FormLayoutService, FormRulesService, JsonConfigEditorComponent, LayoutColorToken, LayoutEditorComponent, LayoutPrefsService, PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST, PRAXIS_DYNAMIC_FORM_COMPONENT_METADATA, PRAXIS_FILTER_FORM_AUTHORING_MANIFEST, PRAXIS_FILTER_FORM_AUTHORING_PROJECTION, PRAXIS_FILTER_FORM_COMPONENT_METADATA, PraxisDynamicForm, PraxisDynamicFormConfigEditor, PraxisDynamicFormWidgetConfigEditor, PraxisFilterForm, PraxisFilterFormWidgetConfigEditor, PraxisFormActionsComponent, RowConfiguratorComponent, RowEditorComponent, SETTINGS_PANEL_DYNAMIC_FORM_PROVIDER, SectionEditorComponent, TASK_PRESETS, applyVisibilityRules, buildCorporatePresentationFormatGalleryConfig, buildDynamicFormApplyPlan, buildDynamicFormRuleAuthoringContext, buildErgadm00034CompactPresentationConfig, createDynamicFormAuthoringDocument, formLayoutRulesToBuilderState, getFormAiCatalog, getFormCapabilities, getFormEnum, isRuleSatisfied, normalizeDateArrays, normalizeDynamicFormAuthoringDocument, parseLegacyOrDynamicFormDocument, providePraxisDynamicFormMetadata, providePraxisFilterFormMetadata, provideSettingsPanelDynamicForm, ruleBuilderStateToFormLayoutRules, serializeDynamicFormAuthoringDocument, stripLegacyFieldMetadata, toCanonicalDynamicFormConfig, validateDynamicFormAuthoringDocument, validateDynamicFormAuthoringInput };
+export { ActionsEditorComponent, CORPORATE_PRESENTATION_FORMAT_GALLERY, CanvasStateService, CanvasToolbarComponent, ColumnEditorComponent, DomainRuleFormRulesService, DynamicFormLayoutService, DynamicFormSchemaCacheService, ERGADM00034_COMPACT_PRESENTATION_EXAMPLE, Ergadm00034CompactPresentationExampleComponent, FORM_AI_CAPABILITIES, FORM_COMPONENT_AI_CAPABILITIES, FieldConfiguratorComponent, FieldEditorComponent, FormConfigService, FormContextService, FormLayoutService, FormRulesService, JsonConfigEditorComponent, LayoutColorToken, LayoutEditorComponent, LayoutPrefsService, PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST, PRAXIS_DYNAMIC_FORM_COMPONENT_METADATA, PRAXIS_FILTER_FORM_AUTHORING_MANIFEST, PRAXIS_FILTER_FORM_AUTHORING_PROJECTION, PRAXIS_FILTER_FORM_COMPONENT_METADATA, PraxisDynamicForm, PraxisDynamicFormConfigEditor, PraxisDynamicFormWidgetConfigEditor, PraxisFilterForm, PraxisFilterFormWidgetConfigEditor, PraxisFormActionsComponent, RowConfiguratorComponent, RowEditorComponent, SETTINGS_PANEL_DYNAMIC_FORM_PROVIDER, SectionEditorComponent, TASK_PRESETS, applyVisibilityRules, buildCorporatePresentationFormatGalleryConfig, buildDynamicFormApplyPlan, buildDynamicFormRuleAuthoringContext, buildErgadm00034CompactPresentationConfig, createDynamicFormAuthoringDocument, decodeDynamicFormPageInputs, encodeDynamicFormPageInputs, formLayoutRulesToBuilderState, getFormAiCatalog, getFormCapabilities, getFormEnum, isRuleSatisfied, materializeDynamicFormPageRuntimeInputs, normalizeDateArrays, normalizeDynamicFormAuthoringDocument, parseLegacyOrDynamicFormDocument, projectDynamicFormPageEditorChanges, providePraxisDynamicFormMetadata, providePraxisFilterFormMetadata, provideSettingsPanelDynamicForm, ruleBuilderStateToFormLayoutRules, serializeDynamicFormAuthoringDocument, stripLegacyFieldMetadata, toCanonicalDynamicFormConfig, validateDynamicFormAuthoringDocument, validateDynamicFormAuthoringInput, validateDynamicFormPageWidget };
 export type { CanvasElement, CanvasElementType, CanvasPathPart, Capability$1 as Capability, CapabilityCatalog$1 as CapabilityCatalog, CapabilityCategory$1 as CapabilityCategory, CorporatePresentationExample, DomainRuleFormRulesRequestOptions, DomainRuleMaterializedFormLayoutRule, DynamicFieldRenderErrorEvent, DynamicFormAllowedRuleProperties, DynamicFormApplyPlan, DynamicFormAuthoringDocument, DynamicFormBindings, DynamicFormConfigPatchChangeEvent, DynamicFormContextSnapshot, DynamicFormGeneratedLayoutPreset, DynamicFormPresentationSnapshot, DynamicFormProjectionContext, DynamicFormResolvedRuntimeContract, DynamicFormRuleAuthoringContext, DynamicFormRuleAuthoringField, DynamicFormRuleAuthoringTarget, DynamicFormRuleAuthoringTargetDetails, DynamicFormRuleAuthoringTargets, DynamicFormRuleAuthoringVisualBlockNode, DynamicFormRuleTargetType, DynamicFormRuntimeContext, DynamicFormRuntimeValueSource, DynamicFormSchemaPrefsSnapshot, DynamicFormValidationContext, EditorDiagnostic, EditorDocument, Ergadm00034CompactPresentationExample, Ergadm00034LegacyFrequencyRow, FieldPath, FieldPathContainer, FieldPathWithIndex, Capability as FormComponentCapability, CapabilityCatalog as FormComponentCapabilityCatalog, CapabilityCategory as FormComponentCapabilityCategory, ValueKind as FormComponentValueKind, FormConfigLike, GenerateFormConfigFromMetadataOptions, IdPath, InsertLocalFieldOptions, InsertLocalFieldResult, JsonEditorEvent, JsonValidationResult, LayoutChange, LayoutResult, LocalFieldInsertionDiagnostic, LocalFieldInsertionDiagnosticCode, Operation, Path, PathWithIndex, PraxisDynamicFormDomainRulesOptions, PraxisDynamicFormEmptyState, PraxisDynamicFormWidgetEditorInputs, PraxisDynamicFormWidgetEditorValue, PraxisFilterFormWidgetEditorInputs, PraxisFilterFormWidgetEditorValue, PraxisFormActionEvent, RemovePolicy, RuleApplicationContext, RuleApplicationDiagnostic, RuleApplicationDiagnosticCode, RuleApplicationResult, RuleApplicationTargetIndex, RuleApplicationTargetType, ValidationReport, ValueKind$1 as ValueKind };