@praxisui/dynamic-form 10.0.0-rc.18 → 10.0.0-rc.19

package/README.md

@@ -29,6 +29,14 @@ Peer dependencies:
 - `@praxisui/ai`, `@praxisui/core`, `@praxisui/dynamic-fields`, `@praxisui/metadata-editor`, `@praxisui/rich-content`, `@praxisui/settings-panel`, `@praxisui/visual-builder` `^9.0.0-beta.12`
 - `rxjs` `^7.8.0`
 
+## Original item revision on submit
+
+In edit mode, the form keeps a single strong `ETag` together with the item representation returned by its hydration GET (`readUrl`, custom `getById` endpoint or ordinary resource GET). Automatic PUT/PATCH sends that exact tag as `If-Match`; it never performs another GET during submit to acquire a newer revision. A successful response that contains the corresponding item representation replaces both cached data and revision from that same response, including server normalization. A command acknowledgment or incomplete representation cannot rotate the original item snapshot. A shared CRUD cache read by another consumer cannot replace the form's original revision.
+
+The snapshot is transient and belongs to the resource identity, read/write target and API context. Preparation, reads and writes share a generation: switching away and back, reloading or destroying the surface cannot make an old callback current again. Obsolete automatic responses do not emit submit result events, run result hooks, publish field errors or reset a newer submit's loading state. If an obsolete preparation hook retained the reused form group, the draft requires explicit reload before another write. Changing those bindings requires hydration again. Missing or weak read ETags are not converted into versions; unversioned endpoints remain usable, while a versioned host can reject a missing precondition with `428`. After `412`/`428`, or a successful versioned write without its next ETag, automatic submission requires an explicit reload. Closing and reopening a surface or retrying its initialization loads the new representation; retrying submit alone cannot silently refresh the revision.
+
+Explicit `submitResourceVersion` and the existing cross-resource version target inputs retain their command semantics and precedence. They remain host-owned inputs; same-resource editing needs no additional authoring fields. Backend authorization, concurrency and lifecycle policy remain authoritative.
+
 ## Reactive backend determinations
 
 When the exact request schema from `/schemas/filtered` publishes root-level `x-ui.reactiveDeterminations`, the form executes the Metadata-compiled backend capability after a valid source changes and applies server-derived draft values. After edit/create hydration, an already populated source is also validated before the draft can be reported as stable; an empty initial source settles as not applicable without an HTTP call. The projection is one closed graph: if any definition is malformed, the complete projection is rejected instead of partially executing. It remains backend-owned, tenant-neutral and transient: it is never copied to `FormConfig` and cannot be authored as a callback, URL or local write policy.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-14T22:59:57.823Z",
+  "generatedAt": "2026-10-15T00:20:34.117Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "10.0.0-rc.18",
+  "packageVersion": "10.0.0-rc.19",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,

package/fesm2022/praxisui-dynamic-form.mjs

@@ -3,7 +3,7 @@ import { Injectable, EventEmitter, inject, HostListener, Output, Input, Componen
 import * as i1$2 from '@angular/common';
 import { CommonModule } from '@angular/common';
 import * as i2 from '@angular/common/http';
-import { HttpHeaders, HttpContext } from '@angular/common/http';
+import { HttpHeaders, HttpErrorResponse, HttpContext } from '@angular/common/http';
 import * as i1$3 from '@angular/forms';
 import { ReactiveFormsModule, FormsModule, FormGroup, Validators } from '@angular/forms';
 import * as i4 from '@angular/material/icon';
@@ -23,7 +23,7 @@ import { MatBadgeModule } from '@angular/material/badge';
 import { map, Subscription, merge, of, timer, NEVER, EMPTY, defer, TimeoutError, Subject, firstValueFrom, BehaviorSubject, throwError, combineLatest, Observable, race, from, debounceTime as debounceTime$1, takeUntil as takeUntil$1 } from 'rxjs';
 import { filter, map as map$1, switchMap, take, timeout, throwIfEmpty, tap, catchError, ignoreElements, finalize, takeUntil, skip, debounceTime, startWith } from 'rxjs/operators';
 import * as i1 from '@praxisui/core';
-import { serializeEntityLookupValueForPayload, PraxisI18nService, PraxisIconButtonComponent, PraxisIconDirective, providePraxisI18nConfig, RULE_PROPERTY_SCHEMA, FIELD_METADATA_CAPABILITIES, migrateFormLayoutRule, PraxisJsonLogicService, normalizeFormLayoutItems, deepMerge, createDefaultFormConfig, normalizeFormConfig as normalizeFormConfig$1, ensureIds, createEmptyRichContentDocument, formIdentityIssues, resolveHidden, resolveOrder, resolveSpan, projectGroupedCommandPartialRows, isPraxisRuntimeGlobalActionEffect, ASYNC_CONFIG_STORAGE, withFormConfigSections, createFieldLayoutItem, getFormLayoutFieldNames, LoggerService, createCorporateLoggerConfig, ConsoleLoggerSink, ResourceDiscoveryService, GlobalActionService, SCHEMA_METADATA_CLIENT_OPTIONS, ResourceQuickConnectComponent, composeHeadersWithVersion, buildApiUrl, mapFieldDefinitionsToMetadata, reconcileFormConfig, applyLocalFormCustomizations, materializeFormLayoutFromMetadata, syncWithServerMetadata, PRAXIS_LOADING_CTX, evaluateFieldAccess, normalizeControlTypeKey, normalizePraxisEffectPolicy, buildPraxisEffectDistinctKey, getFormColumnFieldNames, resolveGroupedCommandPartialRowSpans, resolveOffset, buildSchemaIdStorageKeySegment, buildSchemaId, fetchWithETag, resolveControlTypeAlias, getTextTransformer, MemoryCacheAdapter, LocalStorageCacheAdapter, SchemaMetadataClient, DEFAULT_SCHEMA_REQUEST_TIMEOUT_MS, normalizeReactiveDeterminations, CONNECTION_STORAGE, API_URL, PRAXIS_LOADING_RENDERER, FORM_HOOKS_PRESETS, EmptyStateCardComponent, isValidFormConfig, ComponentMetadataRegistry, FieldControlType, isRequiredGlobalActionPayloadMissing, GLOBAL_ACTION_CATALOG, PRAXIS_GLOBAL_ACTION_CATALOG, getGlobalActionCatalog, SURFACE_OPEN_I18N_NAMESPACE, getGlobalActionUiSchema, getRequiredGlobalActionPayloadKeys, hasMeaningfulGlobalActionPayloadValue, SurfaceOpenActionEditorComponent, SURFACE_OPEN_I18N_CONFIG, IconPickerService, validateGlobalActionRefs, normalizeFormMetadata, DynamicFormService, projectComponentAuthoringManifest } from '@praxisui/core';
+import { serializeEntityLookupValueForPayload, PraxisI18nService, PraxisIconButtonComponent, PraxisIconDirective, providePraxisI18nConfig, RULE_PROPERTY_SCHEMA, FIELD_METADATA_CAPABILITIES, migrateFormLayoutRule, PraxisJsonLogicService, normalizeFormLayoutItems, deepMerge, createDefaultFormConfig, normalizeFormConfig as normalizeFormConfig$1, ensureIds, createEmptyRichContentDocument, formIdentityIssues, resolveHidden, resolveOrder, resolveSpan, projectGroupedCommandPartialRows, isPraxisRuntimeGlobalActionEffect, ASYNC_CONFIG_STORAGE, withFormConfigSections, createFieldLayoutItem, getFormLayoutFieldNames, LoggerService, createCorporateLoggerConfig, ConsoleLoggerSink, ResourceDiscoveryService, GlobalActionService, SCHEMA_METADATA_CLIENT_OPTIONS, ResourceQuickConnectComponent, composeHeadersWithVersion, buildApiUrl, readStrongResourceEtag, ApiEndpoint, mapFieldDefinitionsToMetadata, reconcileFormConfig, applyLocalFormCustomizations, materializeFormLayoutFromMetadata, syncWithServerMetadata, PRAXIS_LOADING_CTX, evaluateFieldAccess, normalizeControlTypeKey, normalizePraxisEffectPolicy, buildPraxisEffectDistinctKey, getFormColumnFieldNames, resolveGroupedCommandPartialRowSpans, resolveOffset, buildSchemaIdStorageKeySegment, buildSchemaId, fetchWithETag, resolveControlTypeAlias, getTextTransformer, MemoryCacheAdapter, LocalStorageCacheAdapter, SchemaMetadataClient, DEFAULT_SCHEMA_REQUEST_TIMEOUT_MS, normalizeReactiveDeterminations, CONNECTION_STORAGE, API_URL, PRAXIS_LOADING_RENDERER, FORM_HOOKS_PRESETS, EmptyStateCardComponent, isValidFormConfig, ComponentMetadataRegistry, FieldControlType, isRequiredGlobalActionPayloadMissing, GLOBAL_ACTION_CATALOG, PRAXIS_GLOBAL_ACTION_CATALOG, getGlobalActionCatalog, SURFACE_OPEN_I18N_NAMESPACE, getGlobalActionUiSchema, getRequiredGlobalActionPayloadKeys, hasMeaningfulGlobalActionPayloadValue, SurfaceOpenActionEditorComponent, SURFACE_OPEN_I18N_CONFIG, IconPickerService, validateGlobalActionRefs, normalizeFormMetadata, DynamicFormService, projectComponentAuthoringManifest } from '@praxisui/core';
 import * as i1$1 from '@praxisui/dynamic-fields';
 import { getControlTypeCatalog, SelectOptionRegistry, ConfirmDialogComponent, DynamicFieldLoaderDirective } from '@praxisui/dynamic-fields';
 import { BaseAiAdapter, AgenticAuthoringTurnClientService, PraxisAssistantSessionRegistryService, PraxisAssistantTurnOrchestratorService, createPraxisAssistantViewportLayout, PraxisAiAssistantShellComponent } from '@praxisui/ai';
@@ -114,6 +114,7 @@ const PRAXIS_DYNAMIC_FORM_I18N_CONFIG = {
                 'actions.invalidRequired': 'Preencha os campos obrigatórios para continuar.',
                 'actions.invalidRequiredWithFields': 'Preencha: {{fields}}.',
                 'actions.submitErrorTitle': 'Erro ao salvar',
+                'runtime.resourceVersion.reload': 'Recarregue os dados antes de salvar novamente.',
                 'runtime.reactiveDetermination.error': 'Não foi possível atualizar os campos relacionados. Revise os dados ou tente novamente.',
                 'runtime.reactiveDetermination.submitPending': 'Aguarde a atualização dos campos relacionados antes de salvar.',
                 'runtime.reactiveDetermination.submitTimeout': 'Os campos relacionados não estabilizaram a tempo. Revise os dados e tente salvar novamente.',
@@ -704,6 +705,7 @@ const PRAXIS_DYNAMIC_FORM_I18N_CONFIG = {
                 'actions.invalidRequired': 'Complete the required fields to continue.',
                 'actions.invalidRequiredWithFields': 'Complete: {{fields}}.',
                 'actions.submitErrorTitle': 'Save error',
+                'runtime.resourceVersion.reload': 'Reload the data before saving again.',
                 'config.tabs.mobileLabel': 'Editor section',
                 'config.tabs.general': 'General',
                 'config.tabs.schema': 'Schema Verification',
@@ -11442,6 +11444,8 @@ class PraxisDynamicFormDestroyedError extends Error {
         this.name = 'PraxisDynamicFormDestroyedError';
     }
 }
+class PraxisDynamicFormResourceRevisionReloadError extends Error {
+}
 const FORM_CONFIG_LOAD_TIMEOUT_MS = 1200;
 const FORM_INPUT_PREFS_LOAD_TIMEOUT_MS = 1200;
 const SCHEMA_GLOBAL_CONFIG_READY_TIMEOUT_MS = 1200;
@@ -11931,10 +11935,13 @@ class PraxisDynamicForm {
         return this._customEndpoints;
     }
     set customEndpoints(value) {
-        this._customEndpoints = value;
-        if (value && Object.keys(value).length > 0) {
-            this.crud.configureEndpoints(value);
+        // This input is a replacement snapshot. CRUD's public configureEndpoints remains a merge API.
+        const removed = {};
+        for (const key of Object.keys(this._customEndpoints)) {
+            removed[key] = undefined;
         }
+        this._customEndpoints = value ?? {};
+        this.crud.configureEndpoints({ ...removed, ...this._customEndpoints });
     }
     formSubmit = new EventEmitter();
     formCancel = new EventEmitter();
@@ -11971,6 +11978,9 @@ class PraxisDynamicForm {
     isLoading = false;
     submitting = false;
     submitPreparationInProgress = false;
+    submitLifecycleSequence = 0;
+    activeSubmitLifecycle = null;
+    activeSubmitAutomatic = false;
     submitError = null;
     initializationStatus = 'idle';
     currentErrorMessage = '';
@@ -12023,8 +12033,9 @@ class PraxisDynamicForm {
     entitySelectionCleared = false;
     hydratedEntityId = null;
     loadedEntityData = null;
-    loadedEntityResourceVersion = null;
-    entityVersionInvalidated = false;
+    loadedResourceRevision = null;
+    resourceRevisionInvalidated = false;
+    entityReadAttempt = 0;
     entityHydrationPending = false;
     entityReadFailed = false;
     entityReadText(key) {
@@ -12552,16 +12563,25 @@ class PraxisDynamicForm {
         const method = this.normalizeSubmitMethod(this.submitMethod);
         const configuredSubmitUrl = String(this.submitUrl || '').trim();
         if (!method && !configuredSubmitUrl) {
-            return (operation === 'update'
-                ? this.crud.update(this.resourceId, formData)
-                : this.crud.create(formData)).pipe(map$1((response) => this.unwrapAndCaptureSubmitResponse(response, operation === 'update')), catchError((err) => this.handleVersionedSubmitError(err)));
+            if (operation !== 'update')
+                return this.crud.create(formData);
+            const binding = this.resourceRevisionBinding();
+            const revisionEpoch = this.entityReadAttempt;
+            if (this.resourceRevisionNeedsReload(binding))
+                return this.resourceRevisionReloadError();
+            const originalVersion = this.loadedResourceRevision?.etag ?? null;
+            return this.crud.updateHttpResponse(this.resourceId, formData, { resourceVersion: originalVersion }).pipe(filter(() => this.isResourceRevisionCurrent(binding, revisionEpoch)), tap((response) => this.captureSavedResourceRevision(response, binding, originalVersion != null, revisionEpoch)), map$1((response) => this.unwrapRestApiResponse(response.body)), catchError((error) => this.isResourceRevisionCurrent(binding, revisionEpoch)
+                ? this.rejectResourceRevision(error, binding, revisionEpoch) : EMPTY));
         }
         if (!method || !configuredSubmitUrl) {
             return throwError(() => new Error('PraxisDynamicForm requires submitMethod and submitUrl together for canonical submit execution.'));
         }
         const resolvedUrl = this.resolveSubmitHref(configuredSubmitUrl);
+        const automaticItemRevision = this.usesAutomaticItemRevision();
+        const binding = this.resourceRevisionBinding();
+        const revisionEpoch = this.entityReadAttempt;
         return this.resolveSubmitResourceVersion(formData).pipe(switchMap((resolvedResourceVersion) => {
-            let headers = composeHeadersWithVersion(this.resolveApiEntry()) ?? new HttpHeaders();
+            let headers = (composeHeadersWithVersion(this.resolveApiEntry()) ?? new HttpHeaders()).delete('If-Match');
             const idempotencyKey = String(this.submitIdempotencyKey || '').trim();
             if (idempotencyKey) {
                 headers = headers.set('Idempotency-Key', idempotencyKey);
@@ -12573,28 +12593,15 @@ class PraxisDynamicForm {
             if (resolvedResourceVersion) {
                 headers = headers.set('If-Match', this.formatResourceVersion(resolvedResourceVersion));
             }
-            if (method === 'patch') {
-                return this.http
-                    .patch(resolvedUrl, formData, {
-                    headers,
-                    observe: 'response',
-                })
-                    .pipe(map$1((response) => this.unwrapAndCaptureSubmitResponse(response, true)), catchError((err) => this.handleVersionedSubmitError(err)));
-            }
-            if (method === 'put') {
-                return this.http
-                    .put(resolvedUrl, formData, {
-                    headers,
-                    observe: 'response',
-                })
-                    .pipe(map$1((response) => this.unwrapAndCaptureSubmitResponse(response, true)), catchError((err) => this.handleVersionedSubmitError(err)));
-            }
-            return this.http
-                .post(resolvedUrl, formData, {
-                headers,
-                observe: 'response',
-            })
-                .pipe(map$1((response) => this.unwrapAndCaptureSubmitResponse(response, this.mode === 'edit' || this.resourceId != null)), catchError((err) => this.handleVersionedSubmitError(err)));
+            return this.http.request(method.toUpperCase(), resolvedUrl, {
+                body: formData, headers, observe: 'response',
+            }).pipe(filter(() => !automaticItemRevision || this.isResourceRevisionCurrent(binding, revisionEpoch)), tap((response) => {
+                if (automaticItemRevision)
+                    this.captureSavedResourceRevision(response, binding, resolvedResourceVersion != null, revisionEpoch);
+            }), map$1((response) => this.unwrapRestApiResponse(response.body)), catchError((error) => automaticItemRevision
+                ? this.isResourceRevisionCurrent(binding, revisionEpoch)
+                    ? this.rejectResourceRevision(error, binding, revisionEpoch) : EMPTY
+                : throwError(() => error)));
         }));
     }
     resolveSubmitResourceVersion(formData) {
@@ -12605,7 +12612,13 @@ class PraxisDynamicForm {
         const targetResourceKey = String(this.submitResourceVersionTargetResourceKey ?? '').trim();
         const targetIdField = String(this.submitResourceVersionTargetIdField ?? '').trim();
         if (!targetResourceKey && !targetIdField) {
-            return of(this.resolveCurrentEntityResourceVersion(formData));
+            const method = this.normalizeSubmitMethod(this.submitMethod);
+            if (method !== 'put' && method !== 'patch')
+                return of(null);
+            const binding = this.resourceRevisionBinding();
+            if (this.resourceRevisionNeedsReload(binding))
+                return this.resourceRevisionReloadError();
+            return of(this.loadedResourceRevision?.etag ?? null);
         }
         if (!targetResourceKey || !targetIdField) {
             return throwError(() => new Error('PraxisDynamicForm requires both submitResourceVersionTargetResourceKey and submitResourceVersionTargetIdField.'));
@@ -12653,91 +12666,91 @@ class PraxisDynamicForm {
                 : throwError(() => new Error(`PraxisDynamicForm did not receive an ETag for cross-resource target "${targetResourceKey}".`));
         }));
     }
-    resolveCurrentEntityResourceVersion(formData) {
-        const method = this.normalizeSubmitMethod(this.submitMethod);
-        const isEntityUpdate = this.mode === 'edit' || method === 'put' || method === 'patch';
-        if (!isEntityUpdate) {
-            return null;
-        }
-        const entityId = this.resourceId ?? this.pendingEntityId ?? this.loadedEntityId ?? null;
-        const crudCachedVersion = entityId != null
-            ? this.normalizeResourceVersionToken(this.crud?.getResourceVersion?.(entityId))
-            : null;
-        if (this.entityVersionInvalidated) {
-            return this.loadedEntityResourceVersion || crudCachedVersion || null;
-        }
-        return (this.loadedEntityResourceVersion ||
-            crudCachedVersion ||
-            this.extractResourceVersionCandidate(this.loadedEntityData) ||
-            this.extractResourceVersionCandidate(formData) ||
-            this.extractResourceVersionCandidate(this.initialValue) ||
-            null);
-    }
-    unwrapAndCaptureSubmitResponse(response, isEntityMutation) {
-        const isHttpResponse = response &&
-            typeof response === 'object' &&
-            'body' in response &&
-            'headers' in response;
-        const etagHeader = isHttpResponse
-            ? this.normalizeResourceVersionToken(response.headers?.get?.('ETag'))
-            : null;
-        const unwrapped = this.unwrapRestApiResponse(isHttpResponse ? response.body : response);
-        this.captureUpdatedEntityResourceVersion(unwrapped, etagHeader, isEntityMutation);
-        return unwrapped;
+    /** Identity and server context are captured with the representation, never reconstructed at submit by GET. */
+    resourceRevisionBinding() {
+        const entry = this.resolveApiEntry();
+        const headers = composeHeadersWithVersion(entry);
+        const context = this.enterpriseRuntimeContext?.snapshot;
+        return JSON.stringify({
+            id: this.resourceId ?? this.pendingEntityId ?? null,
+            resourcePath: this.resourcePath ?? null,
+            readUrl: this.readUrl ?? null,
+            customEndpoints: this.customEndpoints ?? null,
+            submitUrl: this.submitUrl ?? null,
+            submitMethod: this.normalizeSubmitMethod(this.submitMethod),
+            origin: buildApiUrl(entry),
+            headers: headers?.keys().sort().map((name) => [name, headers?.getAll(name)]),
+            user: context?.user.userId ?? null,
+            state: context?.state ?? null,
+            selectionVersion: context?.selectionVersion ?? null,
+            contextVersion: context?.effectiveContext?.contextVersion ?? null,
+            organization: context?.effectiveContext?.activeOrganizationId ?? null,
+            tenant: context?.effectiveContext?.activeTenant.tenantId ?? null,
+            environment: context?.effectiveContext?.environment ?? null,
+            profile: context?.effectiveContext?.activeProfileId ?? null,
+            module: context?.effectiveContext?.activeModuleKey ?? null,
+        });
     }
-    captureUpdatedEntityResourceVersion(payload, etagHeader = null, isEntityMutation = true) {
-        const payloadId = payload && typeof payload === 'object' && !Array.isArray(payload)
-            ? payload['id'] ?? null
-            : null;
-        const entityId = this.resourceId ??
-            this.pendingEntityId ??
-            this.loadedEntityId ??
-            payloadId ??
-            null;
-        const nextVersion = etagHeader ??
-            this.extractResourceVersionCandidate(payload) ??
-            (isEntityMutation && entityId != null
-                ? this.normalizeResourceVersionToken(this.crud?.getResourceVersion?.(entityId))
-                : null);
-        if (!nextVersion) {
+    usesAutomaticItemRevision() {
+        return this.mode !== 'create' && this.resolveSubmitOperation() !== 'create'
+            && !String(this.submitResourceVersion ?? '').trim()
+            && !String(this.submitResourceVersionTargetResourceKey ?? '').trim()
+            && !String(this.submitResourceVersionTargetIdField ?? '').trim();
+    }
+    isResourceRevisionCurrent(binding, epoch) {
+        return !this.isDestroyed && epoch === this.entityReadAttempt && binding === this.resourceRevisionBinding();
+    }
+    invalidateAutomaticSubmitUi() {
+        if (!this.activeSubmitAutomatic)
             return;
+        this.activeSubmitLifecycle = null;
+        this.activeSubmitAutomatic = false;
+        this.submitting = false;
+        this.submitPreparationInProgress = false;
+        try {
+            this._activeSnack?.dismiss();
         }
-        this.entityVersionInvalidated = false;
-        if (isEntityMutation || entityId != null) {
-            this.loadedEntityResourceVersion = nextVersion;
-        }
-        if (this.submitResourceVersion != null &&
-            !this.submitResourceVersionTargetResourceKey &&
-            !this.submitResourceVersionTargetIdField) {
-            this.submitResourceVersion = nextVersion;
-        }
-        if (this.loadedEntityData &&
-            typeof this.loadedEntityData === 'object' &&
-            !Array.isArray(this.loadedEntityData) &&
-            'resourceVersion' in this.loadedEntityData) {
-            this.loadedEntityData = {
-                ...this.loadedEntityData,
-                resourceVersion: nextVersion,
-            };
-        }
-        if (entityId != null) {
-            this.crud?.setResourceVersion?.(entityId, nextVersion);
+        catch { }
+        this._activeSnack = null;
+    }
+    resourceRevisionNeedsReload(binding) {
+        return this.resourceRevisionInvalidated
+            || this.loadedResourceRevision != null && this.loadedResourceRevision.binding !== binding;
+    }
+    resourceRevisionReloadError() {
+        return throwError(() => new PraxisDynamicFormResourceRevisionReloadError(this.i18n.t('runtime.resourceVersion.reload', undefined, 'Recarregue os dados antes de salvar novamente.', PRAXIS_DYNAMIC_FORM_I18N_NAMESPACE)));
+    }
+    captureSavedResourceRevision(response, binding, required, epoch) {
+        if (epoch !== this.entityReadAttempt || binding !== this.resourceRevisionBinding())
+            return;
+        const data = this.unwrapRestApiResponse(response.body);
+        const representsOriginal = data != null && typeof data === 'object' && !Array.isArray(data)
+            && Object.keys(this.loadedEntityData ?? {}).every((key) => Object.prototype.hasOwnProperty.call(data, key))
+            && (!Object.prototype.hasOwnProperty.call(data, 'id') || this.resourceId == null
+                || String(data['id']) === String(this.resourceId));
+        if (!representsOriginal) {
+            // A command acknowledgment/partial response is not a new item representation.
+            this.loadedResourceRevision = null;
+            this.loadedEntityId = null;
+            this.loadedEntityData = null;
+            this.resourceRevisionInvalidated = required;
+            return;
         }
+        const normalized = this.normalizeFormPatchValue(data);
+        this.loadedEntityData = normalized;
+        this.loadedEntityId = this.resourceId ?? this.pendingEntityId;
+        this.form.patchValue(normalized);
+        const etag = readStrongResourceEtag(response.headers.get('ETag'));
+        this.loadedResourceRevision = { binding, etag };
+        this.resourceRevisionInvalidated = required && etag == null;
     }
-    handleVersionedSubmitError(err) {
-        if (err?.status === 412 || err?.status === 428) {
-            if (!this.submitResourceVersionTargetResourceKey &&
-                !this.submitResourceVersionTargetIdField) {
-                this.entityVersionInvalidated = true;
-                this.loadedEntityResourceVersion = null;
-                this.submitResourceVersion = null;
-                const entityId = this.resourceId ?? this.pendingEntityId ?? this.loadedEntityId ?? null;
-                if (entityId != null) {
-                    this.crud?.setResourceVersion?.(entityId, null);
-                }
-            }
+    rejectResourceRevision(error, binding, epoch) {
+        if (error instanceof HttpErrorResponse && (error.status === 412 || error.status === 428)
+            && epoch === this.entityReadAttempt && binding === this.resourceRevisionBinding()) {
+            this.loadedResourceRevision = null;
+            this.resourceRevisionInvalidated = true;
         }
-        return throwError(() => err);
+        return throwError(() => error);
     }
     normalizeResourceVersionToken(raw) {
         if (typeof raw !== 'string' && typeof raw !== 'number') {
@@ -12846,7 +12859,7 @@ class PraxisDynamicForm {
             return;
         }
         this.crud.configure(this.resourcePath, {
-            endpointKey: this.apiEndpointKey ?? undefined,
+            endpointKey: this.apiEndpointKey || ApiEndpoint.Default,
             apiUrlEntry: this.apiUrlEntry ?? null,
         });
     }
@@ -13024,19 +13037,29 @@ class PraxisDynamicForm {
         }
         this.retryInitialization();
     }
-    ngOnInit() {
-        this.debugLog('[PDF] ngOnInit gating', {
-            formId: this.formId,
-            resourcePath: this.resourcePath,
-        });
-        this.inputsLoaded = !this.formId;
-        if (!this.formId && !this.resourcePath && this.hasRenderableConfig()) {
-            this.initializeStandaloneConfig();
-        }
-        this.ensureActiveTabValid();
+    resourceRevisionContextScope() {
+        const context = this.enterpriseRuntimeContext?.snapshot;
+        return JSON.stringify([context?.state, context?.selectionVersion, context?.effectiveContext?.contextVersion,
+            context?.effectiveContext?.activeOrganizationId, context?.user.userId, context?.effectiveContext?.activeTenant.tenantId,
+            context?.effectiveContext?.environment, context?.effectiveContext?.activeProfileId, context?.effectiveContext?.activeModuleKey]);
+    }
+    subscribeToRuntimeContextChanges() {
+        let lastScope = this.resourceRevisionContextScope();
         this.enterpriseRuntimeContext?.contextChanges$
             .pipe(takeUntil(this.destroy$), skip(1))
             .subscribe(() => {
+            const scope = this.resourceRevisionContextScope();
+            if (scope !== lastScope) {
+                lastScope = scope;
+                this.invalidateAutomaticSubmitUi();
+                this.entityReadAttempt++;
+                this.loadedResourceRevision = null;
+                this.resourceRevisionInvalidated = this.mode !== 'create';
+                this.loadedEntityId = null;
+                this.loadedEntityData = null;
+                this.hydratedEntityId = null;
+                this.entityHydrationPending = false;
+            }
             this.runtimeFieldMetadata = null;
             if (this.hasBuiltFormFromConfig && this.hasRenderableConfig()) {
                 this.buildFormFromConfig({
@@ -13048,6 +13071,18 @@ class PraxisDynamicForm {
                 this.cdr.markForCheck();
             }
         });
+    }
+    ngOnInit() {
+        this.debugLog('[PDF] ngOnInit gating', {
+            formId: this.formId,
+            resourcePath: this.resourcePath,
+        });
+        this.inputsLoaded = !this.formId;
+        if (!this.formId && !this.resourcePath && this.hasRenderableConfig()) {
+            this.initializeStandaloneConfig();
+        }
+        this.ensureActiveTabValid();
+        this.subscribeToRuntimeContextChanges();
         // Load persisted connection if not provided via input
         const connKey = this.connectionKey();
         if (!this.resourcePath && connKey) {
@@ -13163,6 +13198,18 @@ class PraxisDynamicForm {
         }
     }
     ngOnChanges(changes) {
+        const revisionIdentityChanged = ['resourceId', 'resourcePath', 'readUrl', 'customEndpoints',
+            'apiEndpointKey', 'apiUrlEntry', 'submitUrl', 'submitMethod', 'mode']
+            .some((key) => changes[key] && !changes[key].firstChange);
+        if (revisionIdentityChanged) {
+            this.invalidateAutomaticSubmitUi();
+            this.entityReadAttempt++;
+            this.loadedResourceRevision = null;
+            this.resourceRevisionInvalidated = this.mode !== 'create';
+            this.loadedEntityId = null;
+            this.loadedEntityData = null;
+            this.hydratedEntityId = null;
+        }
         // Assert invalid combos: presentationModeGlobal=true is only effective in view mode
         if ((changes['mode'] || changes['presentationModeGlobal']) &&
             this.mode !== 'view' &&
@@ -13180,12 +13227,12 @@ class PraxisDynamicForm {
             this.canvasState.setSelectedElement(null);
             this.cdr.detectChanges();
         }
-        if (changes['resourcePath'] && this.resourcePath) {
+        if ((changes['resourcePath'] || changes['apiEndpointKey'] || changes['apiUrlEntry'] || changes['customEndpoints']) && this.resourcePath) {
             this.debugLog('[PDF] ngOnChanges resourcePath=', this.resourcePath, ' -> configure()');
             this.saveConnection('input');
             this.configureCrudRuntime();
             // A new resource supersedes schema work for the previous resource.
-            if (!changes['resourcePath'].firstChange && this.formId) {
+            if (changes['resourcePath'] && !changes['resourcePath'].firstChange && this.formId) {
                 this.retryInitialization();
             }
             else if (!this.isInitialized && !this.isLoading && this.formId) {
@@ -13211,8 +13258,6 @@ class PraxisDynamicForm {
                 this.entityReadCancel$.next();
                 this.loadedEntityId = null;
                 this.loadedEntityData = null;
-                this.loadedEntityResourceVersion = null;
-                this.entityVersionInvalidated = false;
                 this.hydratedEntityId = null;
                 this.entityHydrationPending = false;
             }
@@ -13232,9 +13277,6 @@ class PraxisDynamicForm {
                 this.loadEntity();
             }
         }
-        if (changes['submitResourceVersion']) {
-            this.entityVersionInvalidated = false;
-        }
         if (changes['initialValue'] &&
             !changes['initialValue'].firstChange &&
             this.usesInitialValueAsAuthoritativeSnapshot() &&
@@ -13247,9 +13289,7 @@ class PraxisDynamicForm {
             this.form.markAsPristine();
             this.form.markAsUntouched();
             this.loadedEntityData = normalized;
-            this.loadedEntityResourceVersion =
-                this.extractResourceVersionCandidate(this.initialValue);
-            this.entityVersionInvalidated = false;
+            this.loadedResourceRevision = null;
             this.hydratedEntityId = this.pendingEntityId;
             this.flushEntityHydrationState();
             this.emitPayloadPreview('entity-hydrated');
@@ -13266,13 +13306,15 @@ class PraxisDynamicForm {
             this.debugLog('[PDF] ngOnChanges readUrl=', this.readUrl);
             this.loadedEntityId = null;
             this.loadedEntityData = null;
-            this.loadedEntityResourceVersion = null;
-            this.entityVersionInvalidated = false;
             this.hydratedEntityId = null;
             if (this.config.fieldMetadata?.length && this.pendingEntityId != null) {
                 this.loadEntity();
             }
         }
+        if (revisionIdentityChanged && this.config.fieldMetadata?.length && this.pendingEntityId != null
+            && !changes['resourceId'] && !changes['mode'] && !changes['readUrl']) {
+            this.loadEntity();
+        }
         if (changes['config'] || changes['presentationModeGlobal'] || changes['domainRules']) {
             let shouldRebuildFromExternalConfig = false;
             let externalConfigChanged = false;
@@ -13869,7 +13911,8 @@ class PraxisDynamicForm {
             return;
         }
         // Avoid duplicate network requests but allow re-patching after form build
-        if (this.loadedEntityId === this.pendingEntityId) {
+        if (this.loadedEntityId === this.pendingEntityId && !this.resourceRevisionInvalidated
+            && (this.loadedResourceRevision == null || this.loadedResourceRevision.binding === this.resourceRevisionBinding())) {
             if (this.loadedEntityData && Object.keys(this.form.controls).length) {
                 this.entityHydrationPending = false;
                 this.form.patchValue(this.normalizeFormPatchValue(this.loadedEntityData));
@@ -13899,9 +13942,11 @@ class PraxisDynamicForm {
         // A new identity or read projection supersedes any in-flight entity read.
         this.entityReadCancel$.next();
         this.loadedEntityData = null;
-        this.loadedEntityResourceVersion = null;
-        this.entityVersionInvalidated = false;
         this.loadedEntityId = this.pendingEntityId;
+        const binding = this.resourceRevisionBinding();
+        const attempt = ++this.entityReadAttempt;
+        this.loadedResourceRevision = null;
+        this.resourceRevisionInvalidated = true;
         this.entityHydrationPending = true;
         this.entityReadFailed = false;
         this.flushEntityHydrationState();
@@ -13914,39 +13959,18 @@ class PraxisDynamicForm {
                 headers: composeHeadersWithVersion(this.resolveApiEntry()),
                 observe: 'response',
             })
-                .pipe(map$1((response) => {
-                const isHttpResponse = response &&
-                    typeof response === 'object' &&
-                    'body' in response &&
-                    'headers' in response;
-                const etagHeader = isHttpResponse
-                    ? this.normalizeResourceVersionToken(response.headers?.get?.('ETag'))
-                    : null;
-                if (etagHeader) {
-                    this.loadedEntityResourceVersion = etagHeader;
-                    if (this.pendingEntityId != null) {
-                        this.crud?.setResourceVersion?.(this.pendingEntityId, etagHeader);
-                    }
-                }
-                return this.unwrapRestApiResponse(isHttpResponse ? response.body : response);
-            }))
-            : this.crud.getById(this.pendingEntityId, { httpContext });
+            : this.crud.getByIdHttpResponse(this.pendingEntityId, { httpContext });
         request$
             .pipe(takeUntil(this.entityReadCancel$), takeUntil(this.destroy$))
             .subscribe({
-            next: (data) => {
+            next: (response) => {
+                if (attempt !== this.entityReadAttempt || binding !== this.resourceRevisionBinding())
+                    return;
+                const data = this.unwrapRestApiResponse(response.body);
                 this.entityHydrationPending = false;
                 if (data && typeof data === 'object' && !Array.isArray(data)) {
-                    const capturedVersion = this.loadedEntityResourceVersion ??
-                        this.extractResourceVersionCandidate(data) ??
-                        (this.pendingEntityId != null
-                            ? this.normalizeResourceVersionToken(this.crud?.getResourceVersion?.(this.pendingEntityId))
-                            : null);
-                    this.loadedEntityResourceVersion = capturedVersion;
-                    this.entityVersionInvalidated = false;
-                    if (capturedVersion && this.pendingEntityId != null) {
-                        this.crud?.setResourceVersion?.(this.pendingEntityId, capturedVersion);
-                    }
+                    this.loadedResourceRevision = { binding, etag: readStrongResourceEtag(response.headers.get('ETag')) };
+                    this.resourceRevisionInvalidated = false;
                     const normalized = this.normalizeFormPatchValue(data);
                     this.loadedEntityData = normalized;
                     if (Object.keys(this.form.controls).length) {
@@ -13965,17 +13989,21 @@ class PraxisDynamicForm {
                 else {
                     this.entityReadFailed = true;
                     this.loadedEntityId = null;
-                    this.loadedEntityResourceVersion = null;
+                    this.loadedResourceRevision = null;
+                    this.resourceRevisionInvalidated = true;
                     this.warnLog('Invalid entity data received:', data, { actionId: 'entity.load', throttleKey: 'praxis-dynamic-form:invalid-entity-data' });
                     this.emitLoadingState('data', 'error', 'Dados inválidos recebidos.');
                     this.flushEntityHydrationState();
                 }
             },
             error: (err) => {
+                if (attempt !== this.entityReadAttempt || binding !== this.resourceRevisionBinding())
+                    return;
                 this.entityHydrationPending = false;
                 this.entityReadFailed = true;
                 this.loadedEntityId = null;
-                this.loadedEntityResourceVersion = null;
+                this.loadedResourceRevision = null;
+                this.resourceRevisionInvalidated = true;
                 this.flushEntityHydrationState();
                 this.emitLoadingState('data', 'error', 'Erro ao carregar dados.', err);
             },
@@ -13986,15 +14014,8 @@ class PraxisDynamicForm {
         if (!normalized) {
             return false;
         }
-        const capturedVersion = this.extractResourceVersionCandidate(this.initialValue) ??
-            (this.pendingEntityId != null
-                ? this.normalizeResourceVersionToken(this.crud?.getResourceVersion?.(this.pendingEntityId))
-                : null);
-        this.loadedEntityResourceVersion = capturedVersion;
-        this.entityVersionInvalidated = false;
-        if (capturedVersion && this.pendingEntityId != null) {
-            this.crud?.setResourceVersion?.(this.pendingEntityId, capturedVersion);
-        }
+        // An externally supplied DTO is not a paired HTTP read revision.
+        this.loadedResourceRevision = null;
         this.loadedEntityId = this.pendingEntityId;
         this.loadedEntityData = normalized;
         this.entityHydrationPending = false;
@@ -14159,7 +14180,7 @@ class PraxisDynamicForm {
             connection.add(this.reactiveDeterminationRuntime.connect(this.form, this.schemaRootReactiveDeterminations.filter((definition) => definition.scope.formMode === this.mode
                 && (!this.schemaRootOperationId
                     || definition.scope.schemaOperationId === this.schemaRootOperationId)), (definition, requestBody, correlationId) => {
-                let headers = composeHeadersWithVersion(this.resolveApiEntry()) ?? new HttpHeaders();
+                let headers = (composeHeadersWithVersion(this.resolveApiEntry()) ?? new HttpHeaders()).delete('If-Match');
                 headers = headers.set('X-Correlation-Id', correlationId);
                 return this.http
                     .post(resolveReactiveDeterminationHref(definition.capability.href, this.resolveApiOrigin()), requestBody, { headers })
@@ -16658,30 +16679,59 @@ class PraxisDynamicForm {
     async onSubmit() {
         if (this.effectiveReadonly || this.effectivePresentation)
             return;
-        if (this.submitting || this.submitPreparationInProgress)
+        if (this.isDestroyed || this.submitting || this.submitPreparationInProgress)
             return;
         if (this.entityHydrationPending || this.entityReadFailed) {
             return;
         }
+        const lifecycle = ++this.submitLifecycleSequence;
+        this.activeSubmitLifecycle = lifecycle;
+        this.activeSubmitAutomatic = this.usesAutomaticItemRevision();
         this.submitPreparationInProgress = true;
         try {
-            await this.prepareAndSubmit();
+            await this.prepareAndSubmit(lifecycle);
         }
         finally {
-            this.submitPreparationInProgress = false;
+            if (this.activeSubmitLifecycle === lifecycle)
+                this.submitPreparationInProgress = false;
         }
     }
-    async prepareAndSubmit() {
+    async prepareAndSubmit(lifecycle) {
         const submittingEntityId = this.resourceId;
+        const binding = this.resourceRevisionBinding();
+        const epoch = this.entityReadAttempt;
+        const automatic = this.usesAutomaticItemRevision();
+        const preparationForm = this.form;
+        const preparationIsCurrent = () => {
+            if (this.isDestroyed)
+                return false;
+            if (!automatic || this.isResourceRevisionCurrent(binding, epoch))
+                return true;
+            // A previously started hook can still hold the reused group. Its draft is no longer authoritative.
+            if (preparationForm === this.form) {
+                this.invalidateAutomaticSubmitUi();
+                this.entityReadAttempt++;
+                this.loadedResourceRevision = null;
+                this.resourceRevisionInvalidated = true;
+            }
+            return false;
+        };
+        const waitForCurrentPreparation = async () => {
+            const stable = await this.waitForReactiveDeterminationsBeforeSubmit(() => !this.isDestroyed && (!automatic || this.isResourceRevisionCurrent(binding, epoch)));
+            const current = preparationIsCurrent();
+            return current && stable;
+        };
         this.clearSubmitFieldErrors();
-        if (!(await this.waitForReactiveDeterminationsBeforeSubmit()))
+        if (!(await waitForCurrentPreparation()))
             return;
         // Hooks: beforeValidate
         try {
             await this.runHooks('beforeValidate');
         }
         catch { }
-        if (!(await this.waitForReactiveDeterminationsBeforeSubmit()))
+        if (!preparationIsCurrent())
+            return;
+        if (!(await waitForCurrentPreparation()))
             return;
         if (this.form.invalid) {
             // UX: marcar todos como touched para exibir erros
@@ -16723,6 +16773,8 @@ class PraxisDynamicForm {
                 await this.runHooks('afterValidate');
             }
             catch { }
+            if (!preparationIsCurrent())
+                return;
             return;
         }
         // Hooks: afterValidate (valid)
@@ -16730,11 +16782,15 @@ class PraxisDynamicForm {
             await this.runHooks('afterValidate');
         }
         catch { }
-        if (!(await this.waitForReactiveDeterminationsBeforeSubmit()))
+        if (!preparationIsCurrent())
+            return;
+        if (!(await waitForCurrentPreparation()))
             return;
         // Hooks: beforeSubmit (cancelable) — must run BEFORE snapshotting form value
         try {
             const res = await this.runHooks('beforeSubmit');
+            if (!preparationIsCurrent())
+                return;
             if (res && res.stopped && res.stopped.outcome?.status === 'cancel') {
                 // Cancel submission path — focus field if provided
                 const field = res.stopped.outcome?.field;
@@ -16760,7 +16816,9 @@ class PraxisDynamicForm {
             }
         }
         catch { }
-        if (!(await this.waitForReactiveDeterminationsBeforeSubmit()))
+        if (!preparationIsCurrent())
+            return;
+        if (!(await waitForCurrentPreparation()))
             return;
         if (this.form.invalid) {
             this.form.markAllAsTouched();
@@ -16773,6 +16831,8 @@ class PraxisDynamicForm {
         const rawFormData = this.form.getRawValue();
         const formData = this.prepareCurrentSubmitPayload(rawFormData);
         const operation = this.resolveSubmitOperation();
+        if (!preparationIsCurrent())
+            return;
         this.formSubmit.emit({
             stage: 'before',
             formData,
@@ -16782,6 +16842,8 @@ class PraxisDynamicForm {
             entityId: this.resourceId ?? undefined,
         });
         // Extra: pass snapshot to after hooks via extras when relevant
+        if (!preparationIsCurrent())
+            return;
         const req$ = this.buildSubmitRequest(formData, operation);
         // Mensagem de loading configurável durante o submit
         try {
@@ -16791,17 +16853,30 @@ class PraxisDynamicForm {
             }
         }
         catch { }
+        const operationSnack = this._activeSnack;
         this.submitting = true;
         this.cdr.detectChanges();
         req$
             .pipe(takeUntil(this.destroy$), finalize(() => {
+            try {
+                operationSnack?.dismiss();
+            }
+            catch { }
+            if (this._activeSnack === operationSnack)
+                this._activeSnack = null;
             setTimeout(() => {
+                if (this.activeSubmitLifecycle !== lifecycle)
+                    return;
                 this.submitting = false;
+                this.activeSubmitLifecycle = null;
+                this.activeSubmitAutomatic = false;
                 this.cdr.detectChanges();
             });
         }))
             .subscribe({
             next: (result) => {
+                if (this.activeSubmitLifecycle !== lifecycle || automatic && !this.isResourceRevisionCurrent(binding, epoch))
+                    return;
                 this.clearSubmitFieldErrors();
                 try {
                     const rp = (this.resourcePath || '').trim();
@@ -16812,8 +16887,9 @@ class PraxisDynamicForm {
                 catch { }
                 // Encerrar loading
                 try {
-                    this._activeSnack?.dismiss();
-                    this._activeSnack = null;
+                    operationSnack?.dismiss();
+                    if (this._activeSnack === operationSnack)
+                        this._activeSnack = null;
                 }
                 catch { }
                 this.formSubmit.emit({
@@ -16855,10 +16931,13 @@ class PraxisDynamicForm {
                 }
             },
             error: (error) => {
+                if (this.activeSubmitLifecycle !== lifecycle || automatic && !this.isResourceRevisionCurrent(binding, epoch))
+                    return;
                 // Encerrar loading
                 try {
-                    this._activeSnack?.dismiss();
-                    this._activeSnack = null;
+                    operationSnack?.dismiss();
+                    if (this._activeSnack === operationSnack)
+                        this._activeSnack = null;
                 }
                 catch { }
                 this.formSubmit.emit({
@@ -16882,7 +16961,8 @@ class PraxisDynamicForm {
                         ...detail,
                     }));
                     this.applySubmitFieldErrors(normalizedError.details);
-                    const errorMsg = this.resolveSubmitErrorMessage(normalizedError, operation);
+                    const errorMsg = error instanceof PraxisDynamicFormResourceRevisionReloadError
+                        ? error.message : this.resolveSubmitErrorMessage(normalizedError, operation);
                     this.submitError = errorMsg;
                     this.snackBar.open(errorMsg, undefined, {
                         duration: 4000,
@@ -16893,7 +16973,9 @@ class PraxisDynamicForm {
             },
         });
     }
-    async waitForReactiveDeterminationsBeforeSubmit() {
+    async waitForReactiveDeterminationsBeforeSubmit(stillCurrent = () => true) {
+        if (!stillCurrent())
+            return false;
         const pendingNotice = this.reactiveDeterminationRuntime.hasPending(this.form)
             ? this.snackBar.open(this.i18n.t('runtime.reactiveDetermination.submitPending', undefined, 'Aguarde a atualização dos campos relacionados antes de salvar.', PRAXIS_DYNAMIC_FORM_I18N_NAMESPACE), this.i18n.t('common.dismiss', undefined, 'Fechar', PRAXIS_DYNAMIC_FORM_I18N_NAMESPACE), { duration: 5000 })
             : null;
@@ -16902,6 +16984,8 @@ class PraxisDynamicForm {
             pendingNotice?.dismiss();
         }
         catch { }
+        if (!stillCurrent())
+            return false;
         if (stable)
             return true;
         this.snackBar.open(this.i18n.t('runtime.reactiveDetermination.submitUnsatisfied', undefined, 'Os campos relacionados não foram atualizados com sucesso. Revise os dados e tente novamente.', PRAXIS_DYNAMIC_FORM_I18N_NAMESPACE), this.i18n.t('common.dismiss', undefined, 'Fechar', PRAXIS_DYNAMIC_FORM_I18N_NAMESPACE), { duration: 7000 });
@@ -20691,6 +20775,9 @@ class PraxisDynamicForm {
     ngOnDestroy() {
         this.isDestroyed = true;
         this.cancelSchemaReads();
+        this.entityReadAttempt++;
+        this.invalidateAutomaticSubmitUi();
+        this.activeSubmitLifecycle = null;
         this.resetSubmitErrorState();
         this.assistantSessions.removeContextSession(this.buildAiAssistantContextSnapshot());
         this.aiAssistantStateSubscription?.unsubscribe();
@@ -21099,6 +21186,10 @@ class PraxisDynamicForm {
         this.cancelSchemaReads();
         this.entityReadCancel$.next();
         this.isLoading = false;
+        // Reset state for retry; only a successful new read clears a rejected revision.
+        this.invalidateAutomaticSubmitUi();
+        this.entityReadAttempt++;
+        this.loadedResourceRevision = null;
         this.isInitialized = false;
         this.schemaCache = null;
         this.loadedEntityId = null;

package/package.json

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

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

@@ -1148,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

@@ -982,6 +982,9 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     isLoading: boolean;
     submitting: boolean;
     private submitPreparationInProgress;
+    private submitLifecycleSequence;
+    private activeSubmitLifecycle;
+    private activeSubmitAutomatic;
     submitError: string | null;
     initializationStatus: 'idle' | 'loading' | 'success' | 'error';
     currentErrorMessage: string;
@@ -1016,8 +1019,9 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private entitySelectionCleared;
     private hydratedEntityId;
     private loadedEntityData;
-    private loadedEntityResourceVersion;
-    private entityVersionInvalidated;
+    private loadedResourceRevision;
+    private resourceRevisionInvalidated;
+    private entityReadAttempt;
     protected entityHydrationPending: boolean;
     protected entityReadFailed: boolean;
     protected entityReadText(key: 'loading' | 'error' | 'retry' | 'region' | 'success'): string;
@@ -1138,10 +1142,15 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private resolveSubmitOperation;
     private buildSubmitRequest;
     private resolveSubmitResourceVersion;
-    private resolveCurrentEntityResourceVersion;
-    private unwrapAndCaptureSubmitResponse;
-    private captureUpdatedEntityResourceVersion;
-    private handleVersionedSubmitError;
+    /** 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;
@@ -1170,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;