@praxisui/dynamic-form 10.0.0-rc.3 → 10.0.0-rc.31

package/package.json

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

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

@@ -73,6 +73,16 @@ Este documento e a referencia canonica da API JSON de praxis-dynamic-form.
 - 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.
+- `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`.
+- `layout` (`FormLayoutOptions`) governa a organização e navegação estrutural das seções do formulário:
+  - `mode`: `'vertical' | 'tabs' | 'accordion'` (padrão `'vertical'`).
+  - `defaultTabId`: identificador da aba selecionada inicialmente em modo abas.
+  - `tabsAppearance`: estilo visual dos botões de abas (`'pills' | 'underline' | 'buttons'`, padrão `'pills'`).
+  - `tabs`: lista declarativa de abas (`FormLayoutTabItem` com `id`, `label`, `icon`, `sectionIds`, `badge`, `disabled`, `tooltip`). Quando omitido, o runtime auto-deriva deterministicamente 1 aba por seção visível.
+  - `accordionMulti`: quando `mode === 'accordion'`, permite manter múltiplos painéis expandidos simultaneamente (padrão `false`, fechando os outros ao abrir um).
+  - `hideSectionHeaderInTabs`: suprime cabeçalho redundante de seção dentro do painel da aba ativa (padrão `false`).
+  - Entradas `@Input() layoutMode` e `@Input() formLayout` expostas diretamente em `PraxisDynamicForm`.
+  - Saídas `@Output() tabChange` (emite ID) e `@Output() tabSelected` (emite objeto completo) emitidas na alternância de abas.
 
 
 - `DynamicFormAuthoringDocument` e o snapshot canonico completo de autoria de `praxis-dynamic-form`.
@@ -1138,3 +1148,10 @@ O editor nativo, em **Geral → Sem registro selecionado**, materializa o contra
 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.
+### Item revision custody
+
+Automatic edit PUT/PATCH sends the strong ETag from the same hydration GET that supplied the form values, including `readUrl` and custom `getById`. A successful response containing the corresponding item representation replaces both cached data and revision together, including server normalization. A command acknowledgment or incomplete representation cannot rotate that snapshot. Missing/weak ETags are not synthesized; 412/428 requires explicit reload before another automatic submit.
+
+Item/API-context changes, reload and destruction invalidate the transient read generation, including identity or enterprise-scope A→B→A. Automatic preparation captures its original binding/generation before asynchronous hooks or determinations. An obsolete preparation does not submit; if its hook retained the reused form group, another submit requires explicit reload to reconcile any contaminated draft. Obsolete success/error responses cannot publish formSubmit stages, run submit result hooks, change fields/errors, close the new surface or reset a newer submit's loading/snackbar state.
+
+This adds no persisted configuration field. Explicit `submitResourceVersion` and cross-resource version-target inputs retain their command precedence and response/event semantics; their responses do not hydrate or rotate the originating item snapshot.

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

@@ -7,7 +7,8 @@ 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, 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 { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, PraxisJsonLogicService, FormSection, FormRow, FormColumn, FormConfig, FormConfigWithSections, FormLayoutItem, ReactiveDeterminationDefinition, ReactiveDeterminationExecutionEvent, FormActionButton, DynamicFormMode, AiCapability, 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';
+export { CompiledDynamicFormSchema, DynamicFormMode } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { Observable, Subscription, BehaviorSubject } from 'rxjs';
 import { SettingsPanelService, SettingsValueProvider } from '@praxisui/settings-panel';
@@ -508,7 +509,7 @@ declare class PraxisFormActionsComponent implements OnChanges, OnDestroy {
 interface FormAiHost {
     config: FormConfig;
     form: FormGroup;
-    mode?: 'create' | 'edit' | 'view';
+    mode?: DynamicFormMode;
     enableCustomization?: boolean;
     readonlyModeGlobal?: boolean | null;
     effectiveReadonly?: boolean;
@@ -572,7 +573,7 @@ interface EditorDiagnostic {
     message: string;
     path?: string;
 }
-type DynamicFormMode = 'create' | 'edit' | 'view';
+
 interface DynamicFormBindings {
     mode?: DynamicFormMode;
     /** Opt-in view placeholder; null explicitly disables it. */
@@ -661,6 +662,7 @@ interface DynamicFormConfigPatchChangeEvent {
         mode?: DynamicFormMode;
         presentationModeGlobal?: boolean | null;
         presentation?: DynamicFormPresentationSnapshot | null;
+        presentationPreset?: FormPresentationPreset;
         emptyState?: PraxisDynamicFormEmptyState | null;
     };
 }
@@ -769,6 +771,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private readonly resourceDiscovery;
     private readonly aiAssistantSessionEffect;
     private readonly globalActions;
+    private readonly optionRegistry;
     private readonly DEBUG;
     private effectiveActionsCache?;
     private effectiveActionsCacheBase?;
@@ -790,7 +793,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
      * merged context snapshot used to avoid re-binding on every change detection pass.
      */
     editorialContext: Record<string, unknown> | null;
-    mode: 'create' | 'edit' | 'view';
+    mode: DynamicFormMode;
     config: FormConfig;
     private hostConfigInputProvided;
     /** Optional host-level overrides for the rendered form action bar. */
@@ -851,6 +854,16 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     configPersistenceStrategy: 'local-first' | 'input-first';
     /** Optional layout to use instead of generated one */
     layout?: FormLayout;
+    /**
+     * Layout mode for organizing form sections: 'vertical' (default), 'tabs' or 'accordion'.
+     * Overrides config.layout.mode when specified.
+     */
+    layoutMode?: FormLayoutMode;
+    /**
+     * Layout configuration options for form sections (mode, tabs, defaultTabId, tabsAppearance, accordionMulti, etc.).
+     * Merged with and takes precedence over config.layout.
+     */
+    formLayout?: FormLayoutOptions;
     /** Metadata-driven layout preset used only when creating an initial config from schema. */
     generatedLayoutPreset: DynamicFormGeneratedLayoutPreset;
     /** Opt-in policy for schema-driven transient layout materialization. */
@@ -876,11 +889,38 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     presentationModeGlobal: boolean | null;
     /** Projection of contextSnapshot.presentation; null clears authored style overrides. */
     presentation?: DynamicFormPresentationSnapshot | null;
+    /**
+     * Optional presentation preset applied when the form is rendered in presentation mode.
+     * Resolves styles for standard patterns: 'corporate-dossier', 'editorial-card', 'compact-presentation' or 'default'.
+     */
+    presentationPreset?: FormPresentationPreset;
+    /**
+     * Default visual appearance preset for sections when not explicitly configured at section level.
+     * Values: 'card' (default), 'plain' (borderless with divider support), 'step' (stepper badge layout).
+     */
+    sectionDefaultAppearance?: 'card' | 'plain' | 'step';
+    /**
+     * Global flag to control divider lines between plain/dossier sections.
+     * When true, renders a subtle separator line below each section (except the last).
+     */
+    sectionDivider?: boolean;
     visibleGlobal: boolean | null;
     fieldIconPolicy: 'all' | 'presentation-only' | 'none';
     /** Opt-in loader for shared domain rule materializations persisted outside FormConfig. */
     domainRules: PraxisDynamicFormDomainRulesOptions | boolean | null;
     get effectivePresentation(): boolean;
+    /** Normalizes presentation preset aliases and casing to canonical values. */
+    normalizePresentationPreset(preset?: string | null): FormPresentationPreset;
+    /** Resolved presentation preset for the form container. */
+    get effectivePresentationPreset(): FormPresentationPreset;
+    /** Resolved presentation preset for a specific section, allowing section-level override. */
+    getSectionPresentationPreset(section?: FormSection | null): FormPresentationPreset;
+    isCorporateDossierPreset(): boolean;
+    isEditorialCardPreset(): boolean;
+    isCompactPresentationPreset(): boolean;
+    isSectionCorporateDossier(section?: FormSection | null): boolean;
+    isSectionEditorialCard(section?: FormSection | null): boolean;
+    isSectionCompactPresentation(section?: FormSection | null): boolean;
     shouldShowContextEmptyState(): boolean;
     private hasResourceContext;
     private hasLocalRecordContext;
@@ -932,10 +972,19 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     reactiveDeterminationExecuted: EventEmitter<ReactiveDeterminationExecutionEvent>;
     /** Emits only aggregate runtime state; no request or response payload is exposed. */
     reactiveDeterminationPendingChange: EventEmitter<boolean>;
+    /** Emitted when active tab changes in 'tabs' layout mode. */
+    tabChange: EventEmitter<string>;
+    /** Emitted when a tab is selected in 'tabs' layout mode. */
+    tabSelected: EventEmitter<FormLayoutTabItem>;
+    /** Active tab ID when effectiveLayoutMode === 'tabs'. */
+    activeTabId: string | null;
     private reactiveDeterminationPending;
     isLoading: boolean;
     submitting: boolean;
     private submitPreparationInProgress;
+    private submitLifecycleSequence;
+    private activeSubmitLifecycle;
+    private activeSubmitAutomatic;
     submitError: string | null;
     initializationStatus: 'idle' | 'loading' | 'success' | 'error';
     currentErrorMessage: string;
@@ -970,6 +1019,9 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private entitySelectionCleared;
     private hydratedEntityId;
     private loadedEntityData;
+    private loadedResourceRevision;
+    private resourceRevisionInvalidated;
+    private entityReadAttempt;
     protected entityHydrationPending: boolean;
     protected entityReadFailed: boolean;
     protected entityReadText(key: 'loading' | 'error' | 'retry' | 'region' | 'success'): string;
@@ -1090,6 +1142,17 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private resolveSubmitOperation;
     private buildSubmitRequest;
     private resolveSubmitResourceVersion;
+    /** Identity and server context are captured with the representation, never reconstructed at submit by GET. */
+    private resourceRevisionBinding;
+    private usesAutomaticItemRevision;
+    private isResourceRevisionCurrent;
+    private invalidateAutomaticSubmitUi;
+    private resourceRevisionNeedsReload;
+    private resourceRevisionReloadError;
+    private captureSavedResourceRevision;
+    private rejectResourceRevision;
+    private normalizeResourceVersionToken;
+    private extractResourceVersionCandidate;
     private normalizeSubmitMethod;
     private formatResourceVersion;
     private resolveSubmitHref;
@@ -1116,6 +1179,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private initializeStandaloneConfig;
     private initializeDisconnectedEmptyState;
     private reloadForModeChange;
+    private resourceRevisionContextScope;
+    private subscribeToRuntimeContextChanges;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     private blurAllInputs;
@@ -1219,6 +1284,18 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private areRuleValuesEqual;
     private buildRuleApplicationTargetIndex;
     private setRuleApplicationDiagnostics;
+    get effectiveLayoutMode(): FormLayoutMode;
+    get effectiveTabsAppearance(): FormLayoutTabsAppearance;
+    get effectiveAccordionMulti(): boolean;
+    get effectiveHideSectionHeaderInTabs(): boolean;
+    get effectiveTabs(): FormLayoutTabItem[];
+    ensureActiveTabValid(): void;
+    selectTab(tabId: string): void;
+    isSectionInActiveTab(section?: FormSection): boolean;
+    getTabErrorCount(tab: FormLayoutTabItem): number;
+    getTabAriaControls(tab: FormLayoutTabItem): string;
+    getTabIdForSection(section?: FormSection): string | null;
+    shouldHideSectionHeader(section?: FormSection): boolean;
     isSectionCollapsed(section?: FormSection): boolean;
     isSectionCollapsible(section?: FormSection): boolean;
     private getSectionRuleProps;
@@ -1230,6 +1307,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     getSectionTitle(section: FormSection): string | undefined;
     getSectionDescription(section: FormSection): string | undefined;
     getSectionAppearance(section: FormSection): 'card' | 'plain' | 'step' | undefined;
+    isSectionDividerEnabled(section: FormSection): boolean;
     getSectionStepLabel(section: FormSection): string | undefined;
     getSectionTitleColor(section: FormSection): string | undefined;
     getSectionDescriptionColor(section: FormSection): string | undefined;
@@ -1527,6 +1605,11 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private tryBuildExplicitSchemaContext;
     private buildSchemaContext;
     private getSchemaWithCache;
+    /**
+     * Invalida o cache de schema compilado para a instância atual e força
+     * novo carregamento na próxima requisição.
+     */
+    invalidateSchemaCache(): void;
     private isReactiveValidationEnabled;
     private getReactiveValidationDebounceMs;
     private waitForGlobalConfigReadyForSchema;
@@ -1535,7 +1618,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; }; "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>;
+    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; }; "layoutMode": { "alias": "layoutMode"; "required": false; }; "formLayout": { "alias": "formLayout"; "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; }; "presentationPreset": { "alias": "presentationPreset"; "required": false; }; "sectionDefaultAppearance": { "alias": "sectionDefaultAppearance"; "required": false; }; "sectionDivider": { "alias": "sectionDivider"; "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"; "tabChange": "tabChange"; "tabSelected": "tabSelected"; }, never, never, true, never>;
 }
 
 declare class FormConfigService {
@@ -1718,7 +1801,7 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private includeBackConfigBlock;
     formId?: string;
     componentKeyId?: string;
-    inputMode: 'create' | 'edit' | 'view';
+    inputMode: DynamicFormMode;
     private includeBindingsBlock;
     private readonly editorMode;
     get isPresentationMode(): boolean;
@@ -2409,6 +2492,30 @@ declare class DomainRuleFormRulesService {
     static ɵprov: i0.ɵɵInjectableDeclaration<DomainRuleFormRulesService>;
 }
 
+/**
+ * DynamicFormSchemaCacheService
+ * ------------------------------
+ * Serviço canônico de conveniência em `@praxisui/dynamic-form` para orquestração
+ * de cache de primeiro nível (L1) de esquemas OpenAPI compilados (Issue #2).
+ *
+ * Delega o ciclo de vida do cache em memória ao DynamicFormService (@praxisui/core),
+ * garantindo consistência referencial entre módulos e transições de abas em 0ms.
+ */
+declare class DynamicFormSchemaCacheService {
+    private readonly dynamicFormService;
+    buildCacheKey(params: SchemaIdParams & {
+        baseUrl?: string;
+    }): string;
+    get(cacheKey: string): CompiledDynamicFormSchema | undefined;
+    set(cacheKey: string, compiled: CompiledDynamicFormSchema, customTtlMs?: number): void;
+    has(cacheKey: string): boolean;
+    invalidate(cacheKey?: string): void;
+    clear(): void;
+    size(): number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DynamicFormSchemaCacheService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DynamicFormSchemaCacheService>;
+}
+
 declare class Ergadm00034CompactPresentationExampleComponent {
     private readonly dynamicLayout;
     readonly legacyFrequencyExample: _praxisui_dynamic_form.Ergadm00034CompactPresentationExample;
@@ -3046,5 +3153,5 @@ declare const PRAXIS_FILTER_FORM_AUTHORING_PROJECTION: {
 };
 declare const PRAXIS_FILTER_FORM_AUTHORING_MANIFEST: _praxisui_core.ComponentAuthoringManifest;
 
-export { ActionsEditorComponent, CORPORATE_PRESENTATION_FORMAT_GALLERY, CanvasStateService, CanvasToolbarComponent, ColumnEditorComponent, DomainRuleFormRulesService, DynamicFormLayoutService, 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 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, DynamicFormMode, 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 };
+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 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 };