@praxisui/core 10.0.0-rc.25 → 10.0.0-rc.27

package/fesm2022/praxisui-core.mjs

@@ -2,8 +2,8 @@ import * as i0 from '@angular/core';
 import { Component, InjectionToken, Injectable, inject, Inject, Optional, SkipSelf, makeEnvironmentProviders, signal, computed, APP_INITIALIZER, DestroyRef, ENVIRONMENT_INITIALIZER, ErrorHandler, isSignal, Input, Directive, input, booleanAttribute, ChangeDetectionStrategy, EventEmitter, Output, SecurityContext, ViewContainerRef, Injector, effect, SimpleChange, ElementRef, ChangeDetectorRef, afterEveryRender, contentChild, viewChild, HostBinding, output, afterNextRender, ViewChild, ViewEncapsulation, createEnvironmentInjector, EnvironmentInjector, reflectComponentType, HostListener, ViewChildren, TemplateRef, Renderer2 } from '@angular/core';
 import * as i1 from '@angular/common/http';
 import { HttpHeaders, HttpClient, HttpParams, HttpResponse, HttpContextToken, HttpErrorResponse, HTTP_INTERCEPTORS, withInterceptors } from '@angular/common/http';
-import { of, defer, throwError, from, EMPTY, BehaviorSubject, firstValueFrom, Subject, finalize as finalize$1, shareReplay as shareReplay$1, map as map$1, timer, switchMap as switchMap$1, catchError as catchError$1, forkJoin, isObservable, combineLatest, merge, Subscription, defaultIfEmpty, timeout } from 'rxjs';
-import { switchMap, map, take, catchError, concatMap, tap, shareReplay, takeUntil, toArray, finalize, takeWhile, filter } from 'rxjs/operators';
+import { of, defer, throwError, from, EMPTY, BehaviorSubject, firstValueFrom, Subject, finalize as finalize$1, shareReplay as shareReplay$1, map as map$1, Observable, timer, switchMap as switchMap$1, catchError as catchError$1, forkJoin, isObservable, combineLatest, merge, Subscription, defaultIfEmpty, timeout as timeout$1 } from 'rxjs';
+import { switchMap, map, take, catchError, concatMap, tap, shareReplay, takeUntil, toArray, finalize, exhaustMap, filter, timeout } from 'rxjs/operators';
 import * as i1$3 from '@angular/common';
 import { Location, DOCUMENT, NgTemplateOutlet, CommonModule, NgComponentOutlet } from '@angular/common';
 import { Router, ActivatedRoute, RouterLink, RouterLinkActive } from '@angular/router';
@@ -15529,6 +15529,9 @@ class BulkSyncSession {
     }, ...(ngDevMode ? [{ debugName: "current" }] : /* istanbul ignore next */ []));
     confirmationKey = null;
     refreshInFlight = false;
+    refreshGeneration = 0;
+    refreshSignal;
+    resultsGeneration = 0;
     ownedContract;
     options;
     /** Return detached wire data while retaining the original technical error for UX mapping. */
@@ -15607,17 +15610,25 @@ class BulkSyncSession {
             throw error;
         }
     }
-    async refreshExecution() {
+    /** One cancellable consultation; the caller owns its deadline. POST custody is unchanged. */
+    async refreshExecution(signal) {
+        this.requireReadLifetime(signal);
         const current = this.current();
         if (!current.execution)
             throw new Error('No accepted execution is known to this session.');
         if (isBulkExecutionTerminal(current.execution.status))
             return structuredClone(current.execution);
-        if (this.refreshInFlight)
+        if (this.refreshInFlight && !this.refreshSignal?.aborted) {
             throw new Error('An execution readback is already in flight.');
+        }
+        const generation = ++this.refreshGeneration;
         this.refreshInFlight = true;
+        this.refreshSignal = signal;
         try {
-            const execution = await firstValueFrom(this.client.readExecution(this.ownedContract, current.execution.executionId, this.options));
+            const execution = await this.readValue(() => this.client.readExecution(this.ownedContract, current.execution.executionId, this.options), signal);
+            this.requireReadLifetime(signal);
+            if (generation !== this.refreshGeneration)
+                throw this.readAborted();
             if (execution.proposalId !== current.execution.proposalId) {
                 throw new Error('Execution readback changed the proposal identity.');
             }
@@ -15626,25 +15637,63 @@ class BulkSyncSession {
             return structuredClone(execution);
         }
         catch (error) {
-            this.fail(error);
+            if (generation === this.refreshGeneration && !signal?.aborted)
+                this.fail(error);
             throw error;
         }
         finally {
-            this.refreshInFlight = false;
+            if (generation === this.refreshGeneration) {
+                this.refreshInFlight = false;
+                this.refreshSignal = undefined;
+            }
         }
     }
-    async readResults(size = 200, after) {
+    /** Cancels only this results GET; an abort never discards the accepted execution. */
+    async readResults(size = 200, after, signal) {
+        this.requireReadLifetime(signal);
+        const generation = ++this.resultsGeneration;
         const execution = this.current().execution;
         if (!execution)
             throw new Error('Results require an accepted execution.');
         try {
-            return await firstValueFrom(this.client.readResults(this.ownedContract, execution.executionId, size, after, this.options));
+            return await this.readValue(() => this.client.readResults(this.ownedContract, execution.executionId, size, after, this.options), signal);
         }
         catch (error) {
-            this.current.set({ ...this.current(), error });
+            if (generation === this.resultsGeneration && !signal?.aborted) {
+                this.current.set({ ...this.current(), error });
+            }
             throw error;
         }
     }
+    readAborted() {
+        return new DOMException('Bulk observation was cancelled.', 'AbortError');
+    }
+    requireReadLifetime(signal) {
+        if (signal?.aborted)
+            throw this.readAborted();
+    }
+    /** Cancellation owns the HTTP subscription, not just its Promise observer. */
+    async readValue(read, signal) {
+        this.requireReadLifetime(signal);
+        const value = await firstValueFrom(new Observable(subscriber => {
+            if (signal?.aborted) {
+                subscriber.error(this.readAborted());
+                return;
+            }
+            const abort = () => subscriber.error(this.readAborted());
+            signal?.addEventListener('abort', abort, { once: true });
+            // defer converts a synchronous client failure into an Observable failure,
+            // so the listener is removed by the same teardown on every path.
+            const subscription = defer(read).subscribe(subscriber);
+            return () => {
+                subscription.unsubscribe();
+                signal?.removeEventListener('abort', abort);
+            };
+        }));
+        // Abort may occur after HTTP next but before this Promise continuation.
+        this.requireReadLifetime(signal);
+        return value;
+    }
     fail(error) {
         this.current.set({ ...this.current(), phase: 'error', error });
     }
@@ -15832,21 +15881,18 @@ class PraxisBulkClientService {
      * Polling utilitario para aguardar a conclusao terminal de uma execucao assincrona.
      */
     waitForExecution(executionOp, executionId, pollIntervalMs = 1000, timeoutMs = 60000, options) {
-        const startTime = Date.now();
-        return timer(0, pollIntervalMs).pipe(switchMap(() => this.getExecution(executionOp, executionId, options)), takeWhile((exec) => {
-            const isTerminal = this.isTerminalStatus(exec.status);
-            if (Date.now() - startTime > timeoutMs && !isTerminal) {
-                throw new Error(`Bulk execution ${executionId} timed out after ${timeoutMs}ms.`);
-            }
-            return !isTerminal;
-        }, true), filter((exec) => this.isTerminalStatus(exec.status)), take(1));
+        return timer(0, pollIntervalMs).pipe(
+        // A slow useful GET owns its slot; interval ticks never abort it or queue reads.
+        exhaustMap(() => this.getExecution(executionOp, executionId, options)), filter((exec) => this.isTerminalStatus(exec.status)), take(1), 
+        // Only terminal snapshots cross the filter. This deadline therefore starts
+        // per subscription and cannot be renewed by pending responses or a NEVER GET.
+        timeout({
+            first: timeoutMs,
+            with: () => throwError(() => new Error(`Bulk execution ${executionId} timed out after ${timeoutMs}ms.`)),
+        }));
     }
     isTerminalStatus(status) {
-        return (status === 'COMPLETED' ||
-            status === 'COMPLETED_WITH_ERRORS' ||
-            status === 'CANCELLED' ||
-            status === 'STOPPED' ||
-            status === 'RECONCILIATION_REQUIRED');
+        return isBulkExecutionTerminal(status);
     }
     resolveUrl(path, options) {
         return this.discovery.resolveHref(path, options);
@@ -27007,15 +27053,30 @@ function removeValueAtPath(target, path) {
     if (!segments.length) {
         return;
     }
+    const parents = [];
     let current = target;
     for (const segment of segments.slice(0, -1)) {
         const next = current[segment];
         if (!next || typeof next !== 'object' || Array.isArray(next)) {
             return;
         }
+        parents.push({ parent: current, key: segment });
         current = next;
     }
     delete current[segments[segments.length - 1]];
+    for (let i = parents.length - 1; i >= 0; i -= 1) {
+        const { parent, key } = parents[i];
+        const child = parent[key];
+        if (child &&
+            typeof child === 'object' &&
+            !Array.isArray(child) &&
+            Object.keys(child).length === 0) {
+            delete parent[key];
+        }
+        else {
+            break;
+        }
+    }
 }
 function normalizeEndpoint(endpoint) {
     if (endpoint.kind === 'component-port') {
@@ -37087,6 +37148,9 @@ class DynamicWidgetLoaderDirective {
         if (key && (key === 'expr' || key.endsWith('Expr'))) {
             return true;
         }
+        if (path.includes('componentInputs')) {
+            return true;
+        }
         for (let index = 0; index < path.length - 1; index++) {
             if ((path[index] === 'action' || path[index] === 'globalAction')
                 && path[index + 1] === 'payload') {
@@ -39273,7 +39337,10 @@ class WidgetPageCompositionFactory {
         }
         const isStructured = typeof state === 'object'
             && !Array.isArray(state)
-            && ('values' in state || 'schema' in state || 'derived' in state);
+            && ('values' in state ||
+                'schema' in state ||
+                'derived' in state ||
+                'transientValues' in state);
         if (isStructured) {
             const structured = state;
             return {
@@ -39632,7 +39699,10 @@ class WidgetPageStateRuntimeService {
             return { values: {} };
         const isStructured = typeof state === 'object'
             && !Array.isArray(state)
-            && ('values' in state || 'schema' in state || 'derived' in state);
+            && ('values' in state ||
+                'schema' in state ||
+                'derived' in state ||
+                'transientValues' in state);
         if (isStructured) {
             const structured = state;
             const normalized = {
@@ -39737,6 +39807,13 @@ class WidgetPageStateRuntimeService {
     computeDerivedNode(node, env, diagnostics, key) {
         const compute = node.compute;
         if (!compute) {
+            if (this.isPlainObject(node) &&
+                Object.keys(node).length > 0 &&
+                !('dependsOn' in node) &&
+                !('description' in node) &&
+                !('cache' in node)) {
+                return this.evaluateDerivedJsonLogic(node, env, diagnostics, key);
+            }
             diagnostics.push(`Derived state '${key}' is missing compute definition.`);
             return undefined;
         }
@@ -39995,8 +40072,10 @@ class WidgetPageStateRuntimeService {
     }
     evaluateDerivedJsonLogic(expression, env, diagnostics, key) {
         try {
+            const clonedState = this.clone(env.state) || {};
             return this.jsonLogic.evaluate(expression, {
-                state: this.clone(env.state) || {},
+                ...clonedState,
+                state: clonedState,
                 context: this.clone(env.context) || {},
             }, this.derivedValueRuleOptions);
         }
@@ -40123,24 +40202,54 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
         }], ctorParameters: () => [{ type: PraxisJsonLogicService }] });
 
 const DEFAULT_JSON_LOGIC$2 = new PraxisJsonLogicService(null);
+const CANONICAL_OPERATION_SUFFIXES = {
+    statsGroupBy: 'stats/group-by',
+    'stats/group-by': 'stats/group-by',
+    statsTimeseries: 'stats/timeseries',
+    'stats/timeseries': 'stats/timeseries',
+    statsDistribution: 'stats/distribution',
+    'stats/distribution': 'stats/distribution',
+    statsComparison: 'stats/comparison',
+    'stats/comparison': 'stats/comparison',
+    filter: 'filter',
+};
 class WidgetPageDataSourceRuntimeService {
     http = inject(HttpClient, { optional: true });
     apiUrlConfig = inject(API_URL, { optional: true });
     jsonLogic = inject(PraxisJsonLogicService, { optional: true }) || DEFAULT_JSON_LOGIC$2;
     connections = inject(ConnectionManagerService);
+    latestSnapshots = new Map();
+    getLatestSnapshot(id) {
+        return this.latestSnapshots.get(id);
+    }
     /**
      * Constrói a URL canônica completa para o resourcePath declarado no dataSource.
+     * Quando `endpointKey` identifica uma operação canônica (`statsGroupBy`, `statsTimeseries`,
+     * `statsDistribution`, `statsComparison`, `filter`) e não um host customizado em `API_URL`,
+     * anexa o sufixo da operação ao `resourcePath` caso ainda não esteja presente.
      */
     resolveUrl(resourcePath, endpointKey) {
         const trimmed = (resourcePath || '').trim();
         if (!trimmed)
             return '';
+        const key = (endpointKey || 'default').trim() || 'default';
+        const hasCustomEndpointHost = Boolean(this.apiUrlConfig && key in this.apiUrlConfig);
+        const operationSuffix = !hasCustomEndpointHost ? CANONICAL_OPERATION_SUFFIXES[key] : undefined;
+        const appendOperationSuffix = (target) => {
+            if (!operationSuffix)
+                return target;
+            const normalizedTarget = target.replace(/\/+$/, '');
+            if (normalizedTarget === operationSuffix ||
+                normalizedTarget.endsWith(`/${operationSuffix}`)) {
+                return normalizedTarget;
+            }
+            return `${normalizedTarget}/${operationSuffix}`;
+        };
         if (trimmed.startsWith('http://') || trimmed.startsWith('https://')) {
-            return trimmed;
+            return appendOperationSuffix(trimmed);
         }
         let base = '';
         if (this.apiUrlConfig) {
-            const key = (endpointKey || 'default').trim() || 'default';
             const entry = this.apiUrlConfig[key] ||
                 this.apiUrlConfig['default'] ||
                 Object.values(this.apiUrlConfig)[0];
@@ -40148,11 +40257,11 @@ class WidgetPageDataSourceRuntimeService {
                 base = buildApiUrl(entry);
             }
         }
+        const cleanPath = appendOperationSuffix(trimmed.replace(/^\/+/, ''));
         if (!base) {
-            return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+            return cleanPath.startsWith('/') ? cleanPath : `/${cleanPath}`;
         }
         const cleanBase = base.replace(/\/+$/, '');
-        const cleanPath = trimmed.replace(/^\/+/, '');
         return `${cleanBase}/${cleanPath}`;
     }
     /**
@@ -40192,7 +40301,9 @@ class WidgetPageDataSourceRuntimeService {
             return of(dataSource.fallbackValue ?? null);
         }
         const method = dataSource.method ??
-            (dataSource.kind === 'stats-query' || dataSource.resourcePath.includes('/stats/')
+            (dataSource.kind === 'stats-query' ||
+                dataSource.resourcePath.includes('/stats/') ||
+                url.includes('/stats/')
                 ? 'POST'
                 : 'GET');
         let request$;
@@ -40279,6 +40390,7 @@ class WidgetPageDataSourceRuntimeService {
                 hasSucceededOnce = true;
                 skippedWhileHidden = false;
                 const now = new Date().toISOString();
+                this.latestSnapshots.set(ds.id, { data: this.clone(value), lastUpdated: now });
                 onDiagnostic?.({
                     dataSourceId: ds.id,
                     status: 'success',
@@ -40292,10 +40404,15 @@ class WidgetPageDataSourceRuntimeService {
                 });
                 return value;
             }), catchError((err) => {
+                const errorMsg = err?.message || String(err);
+                this.latestSnapshots.set(ds.id, {
+                    ...(this.latestSnapshots.get(ds.id) || {}),
+                    error: errorMsg,
+                });
                 onDiagnostic?.({
                     dataSourceId: ds.id,
                     status: 'error',
-                    error: err?.message || String(err),
+                    error: errorMsg,
                 });
                 if (!hasSucceededOnce &&
                     ds.errorPolicy !== 'silent' &&
@@ -40353,10 +40470,26 @@ class WidgetPageDataSourceRuntimeService {
             destroy$.complete();
         };
     }
+    /**
+     * Avalia uma transformação declarativa contra uma amostra ou resposta bruta,
+     * preservando `false`, `0` e `null` e reportando erros explícitos sem convertê-los em `0` silencioso.
+     */
+    previewTransform(rawSample, dataSource) {
+        try {
+            const value = this.transformPayload(rawSample, dataSource, true);
+            return { ok: true, value };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                error: error instanceof Error ? error.message : String(error ?? 'Transform evaluation failed'),
+            };
+        }
+    }
     /**
      * Transforma a resposta bruta do backend aplicando envelope canônico ou JsonLogic.
      */
-    transformPayload(raw, dataSource) {
+    transformPayload(raw, dataSource, strictErrors = false) {
         if (raw == null)
             return raw;
         let payload = raw;
@@ -40378,9 +40511,13 @@ class WidgetPageDataSourceRuntimeService {
             const kind = transformObj['kind'];
             if (kind === 'path' && typeof transformObj['path'] === 'string') {
                 const extracted = this.connections.extractByPath(payload, transformObj['path']);
-                return extracted !== undefined
+                const resolved = extracted !== undefined
                     ? extracted
                     : this.connections.extractByPath(raw, transformObj['path']);
+                if (resolved === undefined && strictErrors) {
+                    throw new Error(`Transform path '${transformObj['path']}' resolved to undefined.`);
+                }
+                return resolved;
             }
             if (kind === 'group-by-map') {
                 const rawBuckets = raw?.buckets ??
@@ -40389,6 +40526,14 @@ class WidgetPageDataSourceRuntimeService {
                 const buckets = Array.isArray(rawBuckets) ? rawBuckets : [];
                 const mappings = transformObj['mappings'] || {};
                 const totalField = transformObj['totalField'];
+                const weightedAverageField = transformObj['weightedAverageField'];
+                const weightedAverageDecimals = typeof transformObj['weightedAverageDecimals'] === 'number' &&
+                    Number.isFinite(transformObj['weightedAverageDecimals'])
+                    ? Math.max(0, Math.min(10, Math.trunc(transformObj['weightedAverageDecimals'])))
+                    : 2;
+                const ratios = transformObj['ratios'] && typeof transformObj['ratios'] === 'object'
+                    ? transformObj['ratios']
+                    : undefined;
                 const result = {};
                 for (const targetField of Object.values(mappings)) {
                     if (typeof targetField === 'string' && targetField.trim()) {
@@ -40396,11 +40541,25 @@ class WidgetPageDataSourceRuntimeService {
                     }
                 }
                 let total = 0;
+                let weightedSum = 0;
+                let totalWeight = 0;
                 for (const bucket of buckets) {
-                    const keyStr = String(bucket?.key ?? '');
-                    const val = Number(bucket?.value ?? bucket?.count ?? 0);
+                    const hasExplicitKey = bucket?.key !== undefined;
+                    const keyStr = String(hasExplicitKey ? bucket.key : (bucket?.value ?? ''));
+                    const val = hasExplicitKey
+                        ? Number(bucket?.value ?? bucket?.count ?? 0)
+                        : Number(bucket?.count ?? bucket?.value ?? 0);
                     const safeVal = Number.isFinite(val) ? val : 0;
                     total += safeVal;
+                    const rawWeight = bucket?.count !== undefined ? Number(bucket.count) : 1;
+                    const safeWeight = Number.isFinite(rawWeight) && rawWeight > 0 ? rawWeight : 0;
+                    const bucketMetric = hasExplicitKey
+                        ? Number(bucket?.value ?? bucket?.key ?? 0)
+                        : Number(bucket?.value ?? 0);
+                    if (Number.isFinite(bucketMetric) && safeWeight > 0) {
+                        weightedSum += bucketMetric * safeWeight;
+                        totalWeight += safeWeight;
+                    }
                     const mappedField = mappings[keyStr];
                     if (mappedField) {
                         result[mappedField] = (result[mappedField] || 0) + safeVal;
@@ -40409,6 +40568,48 @@ class WidgetPageDataSourceRuntimeService {
                 if (totalField) {
                     result[totalField] = total;
                 }
+                if (weightedAverageField && weightedAverageField.trim()) {
+                    if (totalWeight > 0) {
+                        const avg = weightedSum / totalWeight;
+                        const factor = Math.pow(10, weightedAverageDecimals);
+                        result[weightedAverageField.trim()] =
+                            Math.round((avg + Number.EPSILON) * factor) / factor;
+                    }
+                    else {
+                        result[weightedAverageField.trim()] = 0;
+                    }
+                }
+                if (ratios) {
+                    for (const [ratioKey, ratioDef] of Object.entries(ratios)) {
+                        if (!ratioKey.trim() || !ratioDef || typeof ratioDef !== 'object')
+                            continue;
+                        const rawNum = ratioDef.numerator ?? ratioDef.numeratorField;
+                        const rawDen = ratioDef.denominator ?? ratioDef.denominatorField;
+                        const numField = typeof rawNum === 'string' ? rawNum.trim() : '';
+                        const denField = typeof rawDen === 'string' ? rawDen.trim() : '';
+                        if (!numField || !denField)
+                            continue;
+                        const numVal = Number(result[numField] ?? 0);
+                        const denVal = Number(result[denField] ?? 0);
+                        const scale = typeof ratioDef.scale === 'number' && Number.isFinite(ratioDef.scale)
+                            ? ratioDef.scale
+                            : 100;
+                        const decimals = typeof ratioDef.decimals === 'number' && Number.isFinite(ratioDef.decimals)
+                            ? Math.max(0, Math.min(10, Math.trunc(ratioDef.decimals)))
+                            : 1;
+                        if (Number.isFinite(numVal) && Number.isFinite(denVal) && denVal > 0) {
+                            const rawRatio = (numVal / denVal) * scale;
+                            const factor = Math.pow(10, decimals);
+                            result[ratioKey.trim()] =
+                                decimals === 0
+                                    ? Math.round(rawRatio)
+                                    : Math.round((rawRatio + Number.EPSILON) * factor) / factor;
+                        }
+                        else {
+                            result[ratioKey.trim()] = 0;
+                        }
+                    }
+                }
                 return result;
             }
             if (kind === 'timeseries-last') {
@@ -40436,6 +40637,9 @@ class WidgetPageDataSourceRuntimeService {
                 }
                 return result;
             }
+            if (strictErrors) {
+                throw new Error(`Unsupported transform kind "${String(kind ?? '')}".`);
+            }
         }
         try {
             return this.jsonLogic.evaluate(transform, {
@@ -40444,7 +40648,10 @@ class WidgetPageDataSourceRuntimeService {
                 result: payload,
             });
         }
-        catch {
+        catch (error) {
+            if (strictErrors) {
+                throw error;
+            }
             return payload;
         }
     }
@@ -43839,6 +44046,8 @@ const DYNAMIC_WIDGET_PAGE_I18N_CONFIG = {
                 'size.widthError': 'Informe um número inteiro entre 1 e {{columns}}. O espaço livre também pode limitar a largura.',
                 'size.heightPixelsHelp': 'Altura do conteúdo em pixels. O cabeçalho e o espaçamento podem aumentar a altura total.',
                 'size.heightRowsHelp': 'Quantidade de linhas que o widget ocupa.',
+                'size.responsiveSummaryContent': 'Grade de {{columns}} colunas com altura em pixels ajustada ao conteúdo. Em telas menores sem layout próprio, os widgets são reorganizados automaticamente em coluna única.',
+                'size.responsiveSummaryRows': 'Grade de {{columns}} colunas com altura em faixas da grade. Em telas menores sem layout próprio, os widgets são reorganizados automaticamente em coluna única.',
                 'size.anchorHelp': 'Ao editar largura ou altura, este canto fica no lugar e o lado oposto se move.',
                 'size.title': 'Tamanho…',
                 'size.fill': 'Preencher espaço livre',
@@ -44001,6 +44210,8 @@ const DYNAMIC_WIDGET_PAGE_I18N_CONFIG = {
                 'size.widthError': 'Enter a whole number between 1 and {{columns}}. Free space may also limit the width.',
                 'size.heightPixelsHelp': 'Content height in pixels. The header and spacing may increase the total height.',
                 'size.heightRowsHelp': 'Number of rows occupied by the widget.',
+                'size.responsiveSummaryContent': '{{columns}}-column grid with content height in pixels. On smaller screens without a dedicated layout, widgets automatically reflow into a single column.',
+                'size.responsiveSummaryRows': '{{columns}}-column grid with row-span height. On smaller screens without a dedicated layout, widgets automatically reflow into a single column.',
                 'size.anchorHelp': 'When editing width or height, this corner stays in place and the opposite side moves.',
                 'size.title': 'Size…',
                 'size.fill': 'Fill free space',
@@ -44194,6 +44405,7 @@ class WidgetSettingsEditorComponent {
             return;
         const changed = id !== this.currentSection();
         this.selectedSection.set(id);
+        this.data.sectionChanged?.(id);
         if (id.startsWith('widget:'))
             this.shellProvider?.selectSettingsSection?.(id.slice('widget:'.length));
         if (changed)
@@ -44204,6 +44416,10 @@ class WidgetSettingsEditorComponent {
                 } }, { injector: this.injector });
     }
     ngAfterViewInit() {
+        this.data.registerTabController?.((tab) => {
+            const targetId = tab === 'size' ? 'size' : (this.sections().find(s => s.id !== 'size')?.id ?? 'widget');
+            this.selectSection(targetId);
+        });
         // Let the eager tab contents initialize before observing their providers.
         queueMicrotask(() => {
             if (this.destroyRef.destroyed)
@@ -44572,7 +44788,13 @@ class CanvasSizeEditorComponent {
                     showDelay: 500, hideDelay: 0, touchendHideDelay: 1500, disableTooltipInteractivity: true,
                 } }], usesOnChanges: true, ngImport: i0, template: `
     <section class="size-editor" [formGroup]="form" [attr.aria-label]="t('size.title')">
-      <div class="context"><strong>{{ widgetLabel() }}</strong><span>{{ scopeLabel() }}</span></div>
+      <div class="context">
+        <strong>{{ widgetLabel() }}</strong>
+        <span>{{ scopeLabel() }}</span>
+        <p class="hint" data-testid="canvas-size-responsive-summary">
+          {{ t(contentRows() ? 'size.responsiveSummaryContent' : 'size.responsiveSummaryRows', { columns: columns() }) }}
+        </p>
+      </div>
       <div class="dimensions">
         <mat-form-field appearance="outline" subscriptSizing="dynamic">
           <mat-label>{{ t('size.width') }}</mat-label>
@@ -44696,7 +44918,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                                 showDelay: 500, hideDelay: 0, touchendHideDelay: 1500, disableTooltipInteractivity: true,
                             } }], changeDetection: ChangeDetectionStrategy.OnPush, imports: [ReactiveFormsModule, MatButtonModule, MatFormFieldModule, MatInputModule, MatRadioModule, MatTooltipModule], template: `
     <section class="size-editor" [formGroup]="form" [attr.aria-label]="t('size.title')">
-      <div class="context"><strong>{{ widgetLabel() }}</strong><span>{{ scopeLabel() }}</span></div>
+      <div class="context">
+        <strong>{{ widgetLabel() }}</strong>
+        <span>{{ scopeLabel() }}</span>
+        <p class="hint" data-testid="canvas-size-responsive-summary">
+          {{ t(contentRows() ? 'size.responsiveSummaryContent' : 'size.responsiveSummaryRows', { columns: columns() }) }}
+        </p>
+      </div>
       <div class="dimensions">
         <mat-form-field appearance="outline" subscriptSizing="dynamic">
           <mat-label>{{ t('size.width') }}</mat-label>
@@ -45911,6 +46139,9 @@ class DynamicWidgetPageComponent {
     injector = inject(Injector);
     settingsSessions = new Map();
     widgetSettingsSession;
+    activeSettingsPanelSession;
+    activeSettingsFocusReturnTarget = null;
+    pendingContextNavigationFocusTarget;
     settingsIdentityRevision = 0;
     acceptedPageIdentity;
     storage = inject(ASYNC_CONFIG_STORAGE);
@@ -46079,13 +46310,15 @@ class DynamicWidgetPageComponent {
         // Controlled hosts return pageChange through [page]. That acknowledgement
         // must not dispose the open settings provider or rebuild its size template.
         // Any other input change or different document still invalidates the editor.
-        if (this.widgetSettingsKey && changes['page'] && Object.keys(changes).length === 1
-            && this.authoredPageDefinition
-            && this.sameJsonStructure(this.parsePage(this.page), this.authoredPageDefinition))
+        if (this.widgetSettingsKey &&
+            changes['page'] &&
+            Object.keys(changes).length === 1 &&
+            this.isAcknowledgedCanonicalPage(incomingPage)) {
             return;
-        const acknowledgedPage = changes['page'] && Object.keys(changes).length === 1
-            && this.authoredPageDefinition
-            && this.sameJsonStructure(this.parsePage(this.page), this.authoredPageDefinition);
+        }
+        const acknowledgedPage = changes['page'] &&
+            Object.keys(changes).length === 1 &&
+            this.isAcknowledgedCanonicalPage(incomingPage);
         if (!acknowledgedPage && (changes['page'] || changes['context'] || changes['pageIdentity']
             || changes['componentInstanceId'] || changes['enableCustomization'] || changes['authoringCapabilities'])) {
             this.settingsIdentityRevision++;
@@ -46112,6 +46345,8 @@ class DynamicWidgetPageComponent {
         if (changes['page'] ||
             changes['context'] ||
             changes['pageIdentity']) {
+            const previousPageDefinition = this.pageDefinition;
+            const previousPageRuntime = this.pageRuntime;
             const parsed = this.parsePage(this.page);
             if (changes['page'] || !this.authoredPageDefinition) {
                 this.authoredPageDefinition = undefined;
@@ -46122,7 +46357,17 @@ class DynamicWidgetPageComponent {
                     })
                     : undefined;
             }
-            const resolvedPage = parsed ? this.resolvePagePresets(parsed) : parsed;
+            const shouldPreserveEphemeralState = !this.isHydrating &&
+                !changes['page']?.isFirstChange() &&
+                !changes['pageIdentity'] &&
+                !changes['componentInstanceId'] &&
+                this.samePageContextIdentity(this.pageDefinition, parsed);
+            const runtimeSeedPage = shouldPreserveEphemeralState && parsed
+                ? this.preserveEphemeralRuntimeState(parsed)
+                : parsed;
+            const resolvedPage = runtimeSeedPage
+                ? this.resolvePagePresets(runtimeSeedPage)
+                : runtimeSeedPage;
             this.assertNoLegacyConnections(resolvedPage);
             this.widgetDiagnostics = {};
             this.widgetDiagnosticsChange.emit({});
@@ -46142,6 +46387,10 @@ class DynamicWidgetPageComponent {
             }
             this.pageRuntime = this.buildStateRuntime(this.pageDefinition?.state, this.pageDefinition?.context);
             this.pageState = this.pageRuntime.state;
+            const resetNonPersistentPaths = this.collectResetNonPersistentStatePaths(previousPageDefinition, previousPageRuntime, this.pageDefinition, this.pageRuntime);
+            if (resetNonPersistentPaths.length > 0) {
+                this.clearMountedSourceSelectionsForNonPersistentState([previousPageDefinition, this.pageDefinition], resetNonPersistentPaths);
+            }
             const bootstrapSnapshot = this.bootstrapCompositionAdapter(this.pageDefinition);
             const rawWidgets = this.pageDefinition?.widgets || [];
             let widgets = this.applyEditShellActions(rawWidgets);
@@ -48093,6 +48342,10 @@ class DynamicWidgetPageComponent {
         return session;
     }
     releaseSettingsSession(session) {
+        if (this.activeSettingsPanelSession === session) {
+            this.activeSettingsPanelSession = undefined;
+            this.activeSettingsFocusReturnTarget = null;
+        }
         this.settingsSessions.delete(session);
         if (!session.destroyed)
             session.destroy();
@@ -48103,6 +48356,7 @@ class DynamicWidgetPageComponent {
                 this.releaseSettingsSession(session);
         }
         if (key === undefined) {
+            this.pendingContextNavigationFocusTarget = undefined;
             this.configEditorContextRequests.clear();
             this.pendingWidgetComponentSettings.set(new Set());
         }
@@ -48111,10 +48365,102 @@ class DynamicWidgetPageComponent {
             this.setWidgetComponentSettingsPending(key, false);
         }
     }
+    widgetSettingsSelectTab;
+    buildWidgetSettingsContextNavigation(key, activeMode) {
+        const page = this.ensurePageDefinition();
+        const targets = (page.widgets || []).map((widget) => ({
+            id: widget.key,
+            label: this.widgetContextLabel(widget),
+        }));
+        const canContent = this.canOpenWidgetComponentSettings(key);
+        const canWidget = this.canOpenWidgetShellSettings();
+        const canSize = !!this.resolveSizeEditorTarget(key) ||
+            (this.canCustomizeCanvas() && this.isCanvasMode() && !!this.currentCanvasItem(key));
+        const nav = {
+            targets,
+            activeTargetId: key,
+            modes: [
+                {
+                    id: 'content',
+                    label: this.componentSettingsLabel(),
+                    icon: 'tune',
+                    disabled: !canContent,
+                },
+                {
+                    id: 'widget',
+                    label: this.widgetSettingsLabel(),
+                    icon: 'settings',
+                    disabled: !canWidget,
+                    editorGroup: 'widget-shell',
+                },
+                {
+                    id: 'size',
+                    label: this.sizeEditorLabel(),
+                    icon: 'straighten',
+                    disabled: !canSize,
+                    editorGroup: 'widget-shell',
+                },
+            ],
+            activeModeId: activeMode,
+            onSelectTarget: (targetKey) => {
+                if (!targetKey || targetKey === key || this.destroyed)
+                    return;
+                const currentMode = nav.activeModeId || activeMode;
+                this.navigateToWidgetSettingsContext(targetKey, currentMode);
+            },
+            onSelectMode: (modeId) => {
+                if (!modeId || modeId === nav.activeModeId || this.destroyed)
+                    return;
+                if ((modeId === 'widget' || modeId === 'size') &&
+                    this.widgetSettingsKey === key &&
+                    this.widgetSettingsSession &&
+                    !this.widgetSettingsSession.destroyed &&
+                    this.widgetSettingsSelectTab) {
+                    nav.activeModeId = modeId;
+                    this.widgetSettingsSelectTab(modeId);
+                    return;
+                }
+                if (modeId === 'content' || modeId === 'widget' || modeId === 'size') {
+                    this.navigateToWidgetSettingsContext(key, modeId);
+                }
+            },
+        };
+        return nav;
+    }
+    navigateToWidgetSettingsContext(targetKey, requestedMode) {
+        const canContent = this.canOpenWidgetComponentSettings(targetKey);
+        const canWidget = this.canOpenWidgetShellSettings();
+        const canSize = !!this.resolveSizeEditorTarget(targetKey) ||
+            (this.canCustomizeCanvas() && this.isCanvasMode() && !!this.currentCanvasItem(targetKey));
+        let mode = requestedMode;
+        if (mode === 'content' && !canContent) {
+            mode = canWidget ? 'widget' : canSize ? 'size' : 'content';
+        }
+        else if (mode === 'widget' && !canWidget) {
+            mode = canSize ? 'size' : canContent ? 'content' : 'widget';
+        }
+        else if (mode === 'size' && !canSize) {
+            mode = canWidget ? 'widget' : canContent ? 'content' : 'size';
+        }
+        this.pendingContextNavigationFocusTarget = {
+            target: this.activeSettingsFocusReturnTarget,
+        };
+        if (mode === 'content') {
+            void this.openWidgetComponentSettings(targetKey);
+        }
+        else {
+            this.openWidgetSettingsPanel(targetKey, mode);
+        }
+    }
+    resolveSettingsFocusReturnTarget() {
+        const pending = this.pendingContextNavigationFocusTarget;
+        this.pendingContextNavigationFocusTarget = undefined;
+        return pending ? pending.target : this.captureFocusReturnTarget();
+    }
     openWidgetSettingsPanel(key, initialTab) {
         if (this.destroyed || !this.settingsPanel)
             return;
-        const focusReturnTarget = this.captureFocusReturnTarget();
+        const focusReturnTarget = this.resolveSettingsFocusReturnTarget();
         const page = this.ensurePageDefinition();
         const widget = page.widgets.find(item => item.key === key);
         if (!widget)
@@ -48124,6 +48470,11 @@ class DynamicWidgetPageComponent {
             return;
         const session = this.createSettingsSession(key);
         const owner = session.get(DestroyRef);
+        const contextNavigation = this.buildWidgetSettingsContextNavigation(key, initialTab);
+        const previousActiveSession = this.activeSettingsPanelSession;
+        const previousFocusTarget = this.activeSettingsFocusReturnTarget;
+        this.activeSettingsPanelSession = session;
+        this.activeSettingsFocusReturnTarget = focusReturnTarget;
         let ref;
         try {
             ref = this.settingsPanel.open({
@@ -48131,14 +48482,19 @@ class DynamicWidgetPageComponent {
                 id: `dynamic-page-widget:${key}`, title: this.t('controls.cardSettings', 'Configurar card'),
                 previewTarget: () => Array.from(this.pageCanvasHost?.nativeElement.children || [])
                     .find(element => element.getAttribute('data-widget-key') === key) ?? null,
+                contextNavigation,
                 content: { component: WidgetSettingsEditorComponent, inputs: () => {
                         const page = this.ensurePageDefinition();
                         const widget = page.widgets.find(item => item.key === key);
                         const uiShell = this.mergedContext['ui']?.shell || {};
+                        this.activeSettingsPanelSession = session;
+                        this.activeSettingsFocusReturnTarget = focusReturnTarget;
                         this.closeSizeEditor(false);
+                        this.selectWidget(key);
                         this.prepareSizeEditor(key);
                         this.widgetSettingsKey = key;
                         this.widgetSettingsSession = session;
+                        this.widgetSettingsSelectTab = undefined;
                         const hasSize = this.sizeEditorSeed()?.key === key;
                         return {
                             shellComponent,
@@ -48153,11 +48509,21 @@ class DynamicWidgetPageComponent {
                             appliedValues$: this.widgetSettingsAppliedValues.asObservable(),
                             widgetChanged: (value, state) => this.previewSettingsShell(key, value, state),
                             validate: (value) => this.validateWidgetSettings(key, value),
+                            sectionChanged: (sectionId) => {
+                                contextNavigation.activeModeId = sectionId === 'size' ? 'size' : 'widget';
+                            },
+                            registerTabController: (selectTab) => {
+                                this.widgetSettingsSelectTab = selectTab;
+                            },
                         };
                     } },
             });
         }
         catch (error) {
+            if (this.activeSettingsPanelSession === session) {
+                this.activeSettingsPanelSession = previousActiveSession;
+                this.activeSettingsFocusReturnTarget = previousFocusTarget;
+            }
             if (this.widgetSettingsSession === session)
                 this.closeSizeEditor(false);
             else
@@ -48167,13 +48533,27 @@ class DynamicWidgetPageComponent {
         ref.applied$.pipe(takeUntilDestroyed(owner)).subscribe(value => this.commitWidgetSettings(key, value, false));
         ref.saved$.pipe(takeUntilDestroyed(owner)).subscribe(value => this.commitWidgetSettings(key, value, true));
         ref.closed$?.pipe(take(1), takeUntilDestroyed(owner)).subscribe(() => {
-            const active = this.widgetSettingsSession === session;
-            if (active)
+            const wasActiveWidgetSettings = this.widgetSettingsSession === session;
+            const wasActivePanelSession = this.activeSettingsPanelSession === session;
+            if (wasActivePanelSession &&
+                !wasActiveWidgetSettings &&
+                previousActiveSession &&
+                !previousActiveSession.destroyed) {
+                this.activeSettingsPanelSession = previousActiveSession;
+                this.activeSettingsFocusReturnTarget = previousFocusTarget;
+                this.releaseSettingsSession(session);
+                return;
+            }
+            if (wasActiveWidgetSettings) {
+                this.widgetSettingsSelectTab = undefined;
                 this.closeSizeEditor(false);
-            else
+            }
+            else {
                 this.releaseSettingsSession(session);
-            if (active)
+            }
+            if (wasActivePanelSession) {
                 this.restoreFocus(focusReturnTarget);
+            }
         });
     }
     sizeEditorLayoutItems() {
@@ -48310,6 +48690,7 @@ class DynamicWidgetPageComponent {
                 } });
     }
     async openWidgetComponentSettings(key) {
+        const focusReturnTarget = this.resolveSettingsFocusReturnTarget();
         if (this.destroyed || !this.canOpenWidgetComponentSettings(key))
             return;
         if (!this.settingsPanel) {
@@ -48331,7 +48712,6 @@ class DynamicWidgetPageComponent {
         const materializedInputs = metadata.configEditor?.contextResolver
             ? this.readMaterializedInputsForWidget(metadata, key)
             : undefined;
-        const focusReturnTarget = this.captureFocusReturnTarget();
         const session = this.createSettingsSession(key);
         const owner = session.get(DestroyRef);
         let opened = false;
@@ -48350,12 +48730,22 @@ class DynamicWidgetPageComponent {
             }
             const appliedValues = new Subject();
             owner.onDestroy(() => appliedValues.complete());
+            const contextNavigation = this.buildWidgetSettingsContextNavigation(key, 'content');
+            const previousActiveSession = this.activeSettingsPanelSession;
+            const previousFocusTarget = this.activeSettingsFocusReturnTarget;
+            const previousSelectedWidgetKey = this.selectedWidgetKeyState();
+            this.activeSettingsPanelSession = session;
+            this.activeSettingsFocusReturnTarget = focusReturnTarget;
+            this.selectWidget(key);
             const ref = this.settingsPanel.open({
                 owner,
                 id: `dynamic-page-component:${key}`,
                 title: metadata.configEditor?.title ||
                     metadata.friendlyName ||
                     this.t('controls.componentSettings', 'Configurar conteudo'),
+                previewTarget: () => Array.from(this.pageCanvasHost?.nativeElement.children || [])
+                    .find(element => element.getAttribute('data-widget-key') === key) ?? null,
+                contextNavigation,
                 content: {
                     component: editor,
                     inputs: {
@@ -48376,8 +48766,22 @@ class DynamicWidgetPageComponent {
             });
             ref.saved$.pipe(takeUntilDestroyed(owner)).subscribe((result) => this.applyWidgetComponentInputs(key, result, true));
             ref.closed$?.pipe(take(1), takeUntilDestroyed(owner)).subscribe(() => {
+                const wasActivePanelSession = this.activeSettingsPanelSession === session;
+                if (wasActivePanelSession &&
+                    previousActiveSession &&
+                    !previousActiveSession.destroyed) {
+                    this.activeSettingsPanelSession = previousActiveSession;
+                    this.activeSettingsFocusReturnTarget = previousFocusTarget;
+                    if (previousSelectedWidgetKey) {
+                        this.selectWidget(previousSelectedWidgetKey);
+                    }
+                    this.releaseSettingsSession(session);
+                    return;
+                }
                 this.releaseSettingsSession(session);
-                this.restoreFocus(focusReturnTarget);
+                if (wasActivePanelSession) {
+                    this.restoreFocus(focusReturnTarget);
+                }
             });
         }
         finally {
@@ -48413,6 +48817,8 @@ class DynamicWidgetPageComponent {
     restoreFocus(target) {
         queueMicrotask(() => {
             if (!this.destroyed
+                && !this.activeSettingsPanelSession
+                && this.pendingWidgetComponentSettings().size === 0
                 && target?.isConnected
                 && !target.hasAttribute('disabled')
                 && target.getAttribute('aria-disabled') !== 'true') {
@@ -48722,6 +49128,7 @@ class DynamicWidgetPageComponent {
         return (endpoint.kind === 'component-port' && endpoint.ref.widget === widgetKey);
     }
     openPageSettings() {
+        const focusReturnTarget = this.resolveSettingsFocusReturnTarget();
         if (this.destroyed || !this.canInvokePageSettings())
             return;
         if (!this.settingsPanel)
@@ -48736,6 +49143,10 @@ class DynamicWidgetPageComponent {
         const owner = session.get(DestroyRef);
         const appliedValues = new Subject();
         owner.onDestroy(() => appliedValues.complete());
+        const previousActiveSession = this.activeSettingsPanelSession;
+        const previousFocusTarget = this.activeSettingsFocusReturnTarget;
+        this.activeSettingsPanelSession = session;
+        this.activeSettingsFocusReturnTarget = focusReturnTarget;
         const ref = this.settingsPanel.open({
             owner,
             id: 'dynamic-page-settings',
@@ -48765,7 +49176,21 @@ class DynamicWidgetPageComponent {
             appliedValues.next(accepted);
         });
         ref.saved$.pipe(takeUntilDestroyed(owner)).subscribe((result) => this.applyPageLayout(result, true));
-        ref.closed$?.pipe(take(1), takeUntilDestroyed(owner)).subscribe(() => this.releaseSettingsSession(session));
+        ref.closed$?.pipe(take(1), takeUntilDestroyed(owner)).subscribe(() => {
+            const wasActivePanelSession = this.activeSettingsPanelSession === session;
+            if (wasActivePanelSession &&
+                previousActiveSession &&
+                !previousActiveSession.destroyed) {
+                this.activeSettingsPanelSession = previousActiveSession;
+                this.activeSettingsFocusReturnTarget = previousFocusTarget;
+                this.releaseSettingsSession(session);
+                return;
+            }
+            this.releaseSettingsSession(session);
+            if (wasActivePanelSession) {
+                this.restoreFocus(focusReturnTarget);
+            }
+        });
     }
     canInvokePageSettings() {
         return this.isAuthoringCapabilityEnabled('pageSettings')
@@ -48898,11 +49323,227 @@ class DynamicWidgetPageComponent {
         }, persist);
     }
     applyAuthoringPageUpdate(next, persist = true, runtime, syncCompositionAdapter = true, skipStateWidgetProjection = false, emitUnchangedCanonicalPage = true) {
-        this.applyPageUpdate(next, persist, runtime, syncCompositionAdapter, skipStateWidgetProjection, emitUnchangedCanonicalPage);
+        const runtimeSeed = !runtime && !this.isHydrating
+            ? (this.preserveEphemeralRuntimeState(next) ?? next)
+            : next;
+        this.applyPageUpdate(runtimeSeed, persist, runtime, syncCompositionAdapter, skipStateWidgetProjection, emitUnchangedCanonicalPage);
         if (this.authoredPageDefinition) {
             this.pageAuthoringChange.emit(this.clonePageDefinition(this.authoredPageDefinition));
         }
     }
+    isAcknowledgedCanonicalPage(incomingPage) {
+        if (!incomingPage || !this.authoredPageDefinition) {
+            return false;
+        }
+        if (this.sameJsonStructure(incomingPage, this.authoredPageDefinition)) {
+            return true;
+        }
+        if (this.hasExplicitNonPersistentStateOverride(incomingPage)) {
+            return false;
+        }
+        const normalizedIncoming = this.toPersistedCanonicalPage({
+            ...incomingPage,
+            state: this.stateRuntime.normalizeState(incomingPage.state),
+        });
+        return this.sameJsonStructure(normalizedIncoming, this.authoredPageDefinition);
+    }
+    hasExplicitNonPersistentStateOverride(page) {
+        const schema = page?.state?.schema || {};
+        const values = page?.state?.values;
+        if (!values || typeof values !== 'object') {
+            return false;
+        }
+        for (const rawPath of Object.keys(schema)) {
+            const entry = schema[rawPath];
+            if (entry?.persist !== false) {
+                continue;
+            }
+            const path = rawPath.trim();
+            if (!path) {
+                continue;
+            }
+            const value = this.conn.extractByPath(values, path);
+            if (value !== undefined && !this.sameJsonStructure(value, entry.initial)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    collectResetNonPersistentStatePaths(previousPage, previousRuntime, nextPage, nextRuntime) {
+        if (!previousPage || !previousRuntime || !nextRuntime) {
+            return [];
+        }
+        const previousSchema = previousPage.state?.schema ?? {};
+        const nextSchema = nextPage?.state?.schema ?? {};
+        const candidatePaths = new Set([
+            ...Object.keys(previousSchema).filter((path) => previousSchema[path]?.persist === false),
+            ...Object.keys(nextSchema).filter((path) => nextSchema[path]?.persist === false),
+        ]);
+        const resetPaths = [];
+        for (const rawPath of candidatePaths) {
+            const path = rawPath.trim();
+            if (!path) {
+                continue;
+            }
+            const prevEntry = previousSchema[rawPath] ?? nextSchema[rawPath];
+            const nextEntry = nextSchema[rawPath] ?? previousSchema[rawPath];
+            const prevValue = this.conn.extractByPath(previousRuntime.primaryValues, path);
+            const hadLiveSelection = prevValue !== undefined &&
+                !this.sameJsonStructure(prevValue, prevEntry?.initial);
+            if (!hadLiveSelection) {
+                continue;
+            }
+            const nextValue = this.conn.extractByPath(nextRuntime.primaryValues, path);
+            const isNowReset = nextValue === undefined ||
+                this.sameJsonStructure(nextValue, nextEntry?.initial);
+            if (isNowReset) {
+                resetPaths.push(path);
+            }
+        }
+        return [...new Set(resetPaths)];
+    }
+    samePageContextIdentity(left, right) {
+        if (!left || !right) {
+            return false;
+        }
+        const leftPageId = left.context?.['pageId'] ?? null;
+        const rightPageId = right.context?.['pageId'] ?? null;
+        if (leftPageId !== rightPageId) {
+            return false;
+        }
+        if (leftPageId !== null) {
+            return true;
+        }
+        const leftKeys = new Set((left.widgets || []).map((w) => w.key));
+        const rightKeys = (right.widgets || []).map((w) => w.key);
+        if (leftKeys.size === 0 && rightKeys.length === 0) {
+            return true;
+        }
+        return rightKeys.some((key) => leftKeys.has(key));
+    }
+    preserveEphemeralRuntimeState(incomingPage) {
+        if (!incomingPage || !this.pageRuntime || this.isHydrating) {
+            return incomingPage;
+        }
+        const schema = incomingPage.state?.schema || {};
+        const nonPersistentPaths = Object.keys(schema)
+            .filter((path) => schema[path]?.persist === false)
+            .map((path) => path.trim())
+            .filter(Boolean);
+        if (!nonPersistentPaths.length) {
+            return incomingPage;
+        }
+        const incomingWidgets = new Set((incomingPage.widgets || []).map((widget) => widget.key));
+        const incomingLinks = incomingPage.composition?.links || [];
+        const previousLinks = this.pageDefinition?.composition?.links || incomingLinks;
+        let mergedValues = this.cloneStateValues(incomingPage.state?.values || {});
+        let preservedAny = false;
+        for (const path of nonPersistentPaths) {
+            const schemaEntry = schema[path];
+            const incomingValue = this.conn.extractByPath(mergedValues, path);
+            const hasExplicitIncomingOverride = incomingValue !== undefined &&
+                !this.sameJsonStructure(incomingValue, schemaEntry?.initial);
+            if (hasExplicitIncomingOverride) {
+                continue;
+            }
+            const previousWriterWidgets = previousLinks.filter((link) => link.from.kind === 'component-port' &&
+                link.to.kind === 'state' &&
+                this.isSameOrNestedStatePath(link.to.ref.path, path));
+            if (previousWriterWidgets.length > 0) {
+                const hasActiveWriter = incomingLinks.some((link) => link.from.kind === 'component-port' &&
+                    link.to.kind === 'state' &&
+                    this.isSameOrNestedStatePath(link.to.ref.path, path) &&
+                    incomingWidgets.has(link.from.ref.widget));
+                if (!hasActiveWriter) {
+                    continue;
+                }
+            }
+            const liveValue = this.conn.extractByPath(this.pageRuntime.primaryValues, path);
+            if (liveValue === undefined) {
+                continue;
+            }
+            mergedValues = this.conn.setValueAtPath(mergedValues, path, this.cloneStateValues(liveValue));
+            preservedAny = true;
+        }
+        if (!preservedAny) {
+            return incomingPage;
+        }
+        return {
+            ...incomingPage,
+            state: {
+                ...(incomingPage.state || {}),
+                values: mergedValues,
+            },
+        };
+    }
+    isSameOrNestedStatePath(candidate, base) {
+        const normalizedCandidate = String(candidate || '').trim();
+        const normalizedBase = String(base || '').trim();
+        if (!normalizedCandidate || !normalizedBase) {
+            return false;
+        }
+        return (normalizedCandidate === normalizedBase ||
+            normalizedCandidate.startsWith(`${normalizedBase}.`) ||
+            normalizedBase.startsWith(`${normalizedCandidate}.`));
+    }
+    clearMountedSourceSelectionsForNonPersistentState(pages, resetPaths) {
+        if (!this.widgetLoaders) {
+            return;
+        }
+        const matchesResetPath = (path) => !resetPaths || resetPaths.some((resetPath) => this.isSameOrNestedStatePath(path, resetPath));
+        const sourceWidgets = new Set();
+        for (const page of pages) {
+            if (!page) {
+                continue;
+            }
+            const schema = page.state?.schema || {};
+            const nonPersistentPaths = Object.keys(schema)
+                .filter((path) => schema[path]?.persist === false)
+                .map((path) => path.trim())
+                .filter((path) => path && matchesResetPath(path));
+            if (!nonPersistentPaths.length) {
+                continue;
+            }
+            const links = page.composition?.links || [];
+            for (const link of links) {
+                const fromRef = link.from?.ref;
+                const toRef = link.to?.ref;
+                const toPath = typeof toRef?.path === 'string' ? toRef.path : '';
+                if (link.from?.kind === 'component-port' &&
+                    link.to?.kind === 'state' &&
+                    typeof fromRef?.widget === 'string' &&
+                    toPath &&
+                    matchesResetPath(toPath) &&
+                    nonPersistentPaths.some((path) => this.isSameOrNestedStatePath(toPath, path))) {
+                    sourceWidgets.add(fromRef.widget);
+                }
+            }
+            for (const widget of page.widgets || []) {
+                const outputs = widget.definition?.outputs;
+                if (!outputs || typeof outputs !== 'object') {
+                    continue;
+                }
+                for (const rawActions of Object.values(outputs)) {
+                    const actions = Array.isArray(rawActions) ? rawActions : [rawActions];
+                    for (const action of actions) {
+                        const candidate = action;
+                        if (candidate?.type === 'setState' &&
+                            typeof candidate.path === 'string' &&
+                            matchesResetPath(candidate.path) &&
+                            nonPersistentPaths.some((path) => this.isSameOrNestedStatePath(candidate.path, path))) {
+                            sourceWidgets.add(widget.key);
+                        }
+                    }
+                }
+            }
+        }
+        for (const widgetKey of sourceWidgets) {
+            const loader = this.findWidgetLoader(widgetKey);
+            if (loader && typeof loader.clearSelection === 'function') {
+                loader.clearSelection();
+            }
+        }
+    }
     applyPageUpdate(next, persist = true, runtime, syncCompositionAdapter = true, skipStateWidgetProjection = false, emitUnchangedCanonicalPage = true) {
         this.assertNoLegacyConnections(next);
         if (this.getDataSourcesSignature(next.dataSources) !==
@@ -48927,7 +49568,7 @@ class DynamicWidgetPageComponent {
                         state: {
                             primaryValues: this.cloneStateValues(effectiveRuntime.primaryValues),
                             derivedValues: this.cloneStateValues(effectiveRuntime.derivedValues),
-                            transientValues: this.cloneStateValues(this.compositionRuntime.getSnapshot().state.transientValues),
+                            transientValues: {},
                             changedPaths: [],
                             diagnostics: [],
                         },
@@ -49011,7 +49652,7 @@ class DynamicWidgetPageComponent {
                 state: {
                     primaryValues: this.cloneStateValues(nextRuntime.primaryValues),
                     derivedValues: this.cloneStateValues(nextRuntime.derivedValues),
-                    transientValues: this.cloneStateValues(this.compositionRuntime.getSnapshot().state.transientValues),
+                    transientValues: {},
                     changedPaths: updates.map((u) => u.targetStatePath),
                     diagnostics: [],
                 },
@@ -52085,6 +52726,7 @@ class DynamicWidgetPageComponent {
                                         dataSources: stored.dataSources ?? baseline.dataSources,
                                     }
                                     : (stored ?? defaultPage);
+                                this.clearMountedSourceSelectionsForNonPersistentState([loaded]);
                                 this.authoredPageDefinition = this.clonePageDefinition(loaded);
                                 this.applyPageUpdate(loaded, false);
                             }
@@ -52159,6 +52801,7 @@ class DynamicWidgetPageComponent {
                         if (mutation.revision === this.persistenceRevision) {
                             this.isHydrating = true;
                             try {
+                                this.clearMountedSourceSelectionsForNonPersistentState([mutation.defaultPage]);
                                 this.authoredPageDefinition = this.clonePageDefinition(mutation.defaultPage);
                                 this.applyPageUpdate(mutation.defaultPage, false);
                             }
@@ -53544,7 +54187,42 @@ class PraxisSurfaceHostComponent {
         loader.renderNow();
     }
     enrichWidget(widget, widgetKey) {
-        if (!widget || widget.id !== 'praxis-rich-content') {
+        if (!widget) {
+            return widget;
+        }
+        if (widget.id === 'praxis-crud') {
+            const explicitContext = widget.inputs?.['context'] &&
+                typeof widget.inputs['context'] === 'object' &&
+                !Array.isArray(widget.inputs['context'])
+                ? widget.inputs['context']
+                : {};
+            const hostContext = this.context &&
+                typeof this.context === 'object' &&
+                !Array.isArray(this.context)
+                ? this.context
+                : {};
+            const mergedContext = {
+                ...hostContext,
+                ...explicitContext,
+            };
+            if ((!mergedContext['surfaceRuntime'] ||
+                typeof mergedContext['surfaceRuntime'] !== 'object') &&
+                hostContext['surfaceRuntime'] &&
+                typeof hostContext['surfaceRuntime'] === 'object') {
+                mergedContext['surfaceRuntime'] = hostContext['surfaceRuntime'];
+            }
+            if (Object.keys(mergedContext).length === 0) {
+                return widget;
+            }
+            return {
+                ...widget,
+                inputs: {
+                    ...(widget.inputs || {}),
+                    context: mergedContext,
+                },
+            };
+        }
+        if (widget.id !== 'praxis-rich-content') {
             return widget;
         }
         return {
@@ -56193,7 +56871,7 @@ class ResourceQuickConnectComponent {
         this.catalogError = false;
         this.cdr?.markForCheck();
         try {
-            const catalog = await firstValueFrom(this.discovery.getSchemaCatalog().pipe(timeout(30000)));
+            const catalog = await firstValueFrom(this.discovery.getSchemaCatalog().pipe(timeout$1(30000)));
             const resources = new Map();
             for (const endpoint of catalog.endpoints ?? []) {
                 // Ground only declared resource-level capability endpoints; never infer user intent.
@@ -56807,12 +57485,13 @@ function reconcileFormConfig(layout, serverDefs) {
         }
     }
     // Orphans: preserve explicit local fields; hide legacy schema fields that no
-    // longer exist on the server.
+    // longer exist on the server. Retain their authored metadata/layout, but do
+    // not submit or validate an invisible control outside the current schema.
     for (const [name, localField] of localByName) {
         if (!serverByName.has(name)) {
             merged.push(isLocalField(localField)
                 ? localField
-                : { ...localField, formHidden: true });
+                : { ...localField, formHidden: true, disabled: true, submitPolicy: 'omit' });
         }
     }
     // Preserve layout (sections/rows/columns) order, only affect fieldMetadata
@@ -57526,6 +58205,7 @@ class PraxisAppShellComponent {
     }
     showSearch = true;
     searchPlaceholder = 'Buscar no sistema ou executar comando...';
+    clearSearchOnBlur = false;
     _footerStatus = signal(undefined, ...(ngDevMode ? [{ debugName: "_footerStatus" }] : /* istanbul ignore next */ []));
     set footerStatus(val) {
         this._footerStatus.set(val);
@@ -57589,11 +58269,15 @@ class PraxisAppShellComponent {
         this.searchQuery.set(value);
         this.searchChange.emit(value);
     }
+    onSearchBlur() {
+        if (this.clearSearchOnBlur) {
+            this.searchQuery.set('');
+        }
+    }
     onSearchEnter() {
         const query = this.searchQuery().trim();
-        if (query) {
-            this.searchSubmit.emit(query);
-        }
+        this.searchSubmit.emit(query);
+        this.searchQuery.set('');
     }
     onUserClick() {
         if (this.user) {
@@ -57615,7 +58299,7 @@ class PraxisAppShellComponent {
         return (parts[0][0] + parts[parts.length - 1][0]).toUpperCase();
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisAppShellComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PraxisAppShellComponent, isStandalone: true, selector: "praxis-app-shell", inputs: { brand: "brand", navigation: "navigation", user: "user", showThemeToggle: "showThemeToggle", showCustomizationToggle: "showCustomizationToggle", isDarkTheme: "isDarkTheme", showSearch: "showSearch", searchPlaceholder: "searchPlaceholder", footerStatus: "footerStatus", isAnyLoading: "isAnyLoading", collapsed: "collapsed" }, outputs: { themeToggle: "themeToggle", customizationToggle: "customizationToggle", searchSubmit: "searchSubmit", searchChange: "searchChange", userProfileClick: "userProfileClick", collapsedChange: "collapsedChange", navItemClick: "navItemClick" }, host: { listeners: { "keydown.escape": "handleEscape()" } }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PraxisAppShellComponent, isStandalone: true, selector: "praxis-app-shell", inputs: { brand: "brand", navigation: "navigation", user: "user", showThemeToggle: "showThemeToggle", showCustomizationToggle: "showCustomizationToggle", isDarkTheme: "isDarkTheme", showSearch: "showSearch", searchPlaceholder: "searchPlaceholder", clearSearchOnBlur: "clearSearchOnBlur", footerStatus: "footerStatus", isAnyLoading: "isAnyLoading", collapsed: "collapsed" }, outputs: { themeToggle: "themeToggle", customizationToggle: "customizationToggle", searchSubmit: "searchSubmit", searchChange: "searchChange", userProfileClick: "userProfileClick", collapsedChange: "collapsedChange", navItemClick: "navItemClick" }, host: { listeners: { "keydown.escape": "handleEscape()" } }, ngImport: i0, template: `
     <div
       class="praxis-shell"
       [class.praxis-shell--dark]="isDarkTheme"
@@ -57812,6 +58496,7 @@ class PraxisAppShellComponent {
                 [value]="searchQuery()"
                 (input)="onSearchInput($any($event.target).value)"
                 (keydown.enter)="onSearchEnter()"
+                (blur)="onSearchBlur()"
                 aria-label="Buscar no sistema"
               />
             </div>
@@ -58154,6 +58839,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                 [value]="searchQuery()"
                 (input)="onSearchInput($any($event.target).value)"
                 (keydown.enter)="onSearchEnter()"
+                (blur)="onSearchBlur()"
                 aria-label="Buscar no sistema"
               />
             </div>
@@ -58312,6 +58998,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                 type: Input
             }], searchPlaceholder: [{
                 type: Input
+            }], clearSearchOnBlur: [{
+                type: Input
             }], footerStatus: [{
                 type: Input
             }], isAnyLoading: [{