@praxisui/core 10.0.0-rc.15 → 10.0.0-rc.16

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-14T16:04:24.084Z",
+  "generatedAt": "2026-10-14T20:20:10.826Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "10.0.0-rc.15",
+  "packageVersion": "10.0.0-rc.16",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 4,

package/fesm2022/praxisui-core.mjs

@@ -5532,8 +5532,28 @@ class GenericCrudService {
             .post(url, entity, {
             headers: composeHeadersWithVersion(entry),
             context: options?.httpContext,
+            observe: 'response',
         })
-            .pipe(catchError(this.handleError));
+            .pipe(map((response) => {
+            const isHttpResponse = response &&
+                typeof response === 'object' &&
+                'body' in response &&
+                'headers' in response;
+            if (!isHttpResponse) {
+                return response;
+            }
+            const idField = this._lastResourceMeta.idField || 'id';
+            const createdId = response.body?.data?.[idField] ??
+                response.body?.data?.id;
+            if (createdId !== undefined && createdId !== null) {
+                const versionKey = this.resourceVersionKey(createdId, options);
+                return this.captureResourceVersion(versionKey, response);
+            }
+            if (!response.body) {
+                throw new Error('Resource response body is empty.');
+            }
+            return response.body;
+        }), catchError(this.handleError));
     }
     /**
      * Atualiza um registro existente.
@@ -5558,6 +5578,26 @@ class GenericCrudService {
     update(id, entity, options) {
         return this.updateResponse(id, entity, options).pipe(map((r) => r.data));
     }
+    getResourceVersion(id, options) {
+        if (id === undefined || id === null || !this.configured) {
+            return null;
+        }
+        const versionKey = this.resourceVersionKey(id, options);
+        return this._resourceEtags.get(versionKey) ?? null;
+    }
+    setResourceVersion(id, etag, options) {
+        if (id === undefined || id === null || !this.configured) {
+            return;
+        }
+        const versionKey = this.resourceVersionKey(id, options);
+        const formatted = this.normalizeEtagToken(etag);
+        if (formatted) {
+            this._resourceEtags.set(versionKey, formatted);
+        }
+        else {
+            this._resourceEtags.delete(versionKey);
+        }
+    }
     updateResponse(id, entity, options) {
         if (id === undefined || id === null)
             throw new Error(this.errorMessages.emptyId);
@@ -5568,10 +5608,12 @@ class GenericCrudService {
         const url = this.getEndpointUrl('update', id, options?.parentPath, options?.endpointKey);
         const versionKey = this.resourceVersionKey(id, options);
         let headers = composeHeadersWithVersion(entry);
-        const etag = this._resourceEtags.get(versionKey);
+        const etag = this._resourceEtags.get(versionKey) ||
+            this.normalizeEtagToken(entity?.resourceVersion) ||
+            null;
         if (etag) {
             headers = (headers instanceof HttpHeaders ? headers : new HttpHeaders(headers))
-                .set('If-Match', etag);
+                .set('If-Match', this.ensureEtagFormat(etag));
         }
         return this.http
             .put(url, entity, {
@@ -5594,7 +5636,9 @@ class GenericCrudService {
         return [buildApiUrl(entry), tenant, environment, this.resourcePath, options?.parentPath ?? '', String(id)].join('|');
     }
     captureResourceVersion(key, response) {
-        const etag = response.headers.get('ETag');
+        const etag = this.normalizeEtagToken(response.headers?.get('ETag')) ||
+            this.normalizeEtagToken(response.body?.data?.resourceVersion) ||
+            null;
         if (etag) {
             this._resourceEtags.set(key, etag);
         }
@@ -5603,6 +5647,26 @@ class GenericCrudService {
         }
         return response.body;
     }
+    normalizeEtagToken(etag) {
+        if (typeof etag !== 'string' && typeof etag !== 'number') {
+            return null;
+        }
+        const trimmed = String(etag).trim();
+        if (!trimmed) {
+            return null;
+        }
+        const inner = trimmed.replace(/^(?:W\/)?"|"$/g, '').trim();
+        if (!inner) {
+            return null;
+        }
+        return this.ensureEtagFormat(trimmed);
+    }
+    ensureEtagFormat(etag) {
+        if (/^(?:W\/)?".+"$/.test(etag)) {
+            return etag;
+        }
+        return `"${etag.replace(/^"|"$/g, '')}"`;
+    }
     /**
      * Remove um registro pelo ID.
      *
@@ -5631,6 +5695,7 @@ class GenericCrudService {
         this.ensureConfigured();
         const entry = this.resolveEndpointEntry(options?.endpointKey);
         const url = this.getEndpointUrl('delete', id, options?.parentPath, options?.endpointKey);
+        const versionKey = this.resourceVersionKey(id, options);
         debugCrudService('[CRUD:Service] delete:request', {
             url,
             id,
@@ -5642,7 +5707,7 @@ class GenericCrudService {
             headers: composeHeadersWithVersion(entry),
             context: options?.httpContext,
         })
-            .pipe(catchError(this.handleError));
+            .pipe(tap(() => this._resourceEtags.delete(versionKey)), catchError(this.handleError));
     }
     /**
      * Realiza exclusão de múltiplos registros sequencialmente.
@@ -13237,6 +13302,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                     type: Optional
                 }] }] });
 
+const DEFAULT_FRAMEWORK_VERSION_MESSAGES = new Set([
+    'resource version is stale.',
+    'resource version is required.',
+    'the resource changed after it was read. reload it before deciding whether to retry.',
+    'the resource changed after it was read. reload and try again.',
+    'this operation requires a current resource version in if-match.',
+]);
 /**
  * Maps HTTP or network errors to user-friendly messages.
  * This service centralizes error messaging so UI components don't
@@ -13258,14 +13330,19 @@ class ErrorMessageService {
             ? this.normalizeDetails(payload?.['errors'])
             : [];
         if (details.length) {
+            const topMessage = this.textValue(payload?.['message']);
+            const resolvedTopMessage = this.resolveVersionPreconditionCopy(details[0].code, topMessage ?? details[0].message, status);
             return {
-                message: this.textValue(payload?.['message']) ?? details[0].message,
+                message: resolvedTopMessage,
                 details,
             };
         }
         const publicMessage = this.textValue(payload?.['message']);
         if (publicMessage && isPublicClientError) {
-            return { message: publicMessage, details: [] };
+            return {
+                message: this.resolveVersionPreconditionCopy(undefined, publicMessage, status),
+                details: [],
+            };
         }
         return { message: this.fallbackMessage(status), details: [] };
     }
@@ -13283,6 +13360,12 @@ class ErrorMessageService {
         if (status !== undefined && status >= 500) {
             return this.tx('global.submitError.server', 'Erro interno no servidor. Tente novamente mais tarde.');
         }
+        if (status === 412) {
+            return this.staleResourceVersionMessage();
+        }
+        if (status === 428) {
+            return this.resourceVersionRequiredMessage();
+        }
         if (status === 400 || status === 422) {
             return this.tx('global.submitError.invalidData', 'Dados inválidos ou inconsistentes. Verifique os campos e tente novamente.');
         }
@@ -13293,17 +13376,40 @@ class ErrorMessageService {
             return [];
         return value.flatMap((item) => {
             const detail = this.objectValue(item);
-            const message = this.textValue(detail?.['message']) ?? this.textValue(detail?.['detail']);
-            if (!message)
+            const rawMessage = this.textValue(detail?.['message']) ?? this.textValue(detail?.['detail']);
+            if (!rawMessage)
                 return [];
+            const code = this.textValue(detail?.['code']);
+            const message = this.resolveVersionPreconditionCopy(code, rawMessage, undefined);
             return [{
                     message,
-                    code: this.textValue(detail?.['code']),
+                    code,
                     target: this.textValue(detail?.['target']),
                     category: this.textValue(detail?.['category']),
                 }];
         });
     }
+    resolveVersionPreconditionCopy(code, candidateMessage, status) {
+        const normalizedCode = String(code ?? '').trim().toUpperCase();
+        const isDefaultFrameworkCopy = DEFAULT_FRAMEWORK_VERSION_MESSAGES.has(candidateMessage.trim().toLowerCase());
+        if ((normalizedCode === 'STALE_RESOURCE_VERSION' || status === 412) &&
+            isDefaultFrameworkCopy) {
+            return this.staleResourceVersionMessage();
+        }
+        if ((normalizedCode === 'RESOURCE_VERSION_REQUIRED' ||
+            normalizedCode === 'MISSING_IF_MATCH' ||
+            status === 428) &&
+            isDefaultFrameworkCopy) {
+            return this.resourceVersionRequiredMessage();
+        }
+        return candidateMessage;
+    }
+    staleResourceVersionMessage() {
+        return this.tx('global.submitError.staleResourceVersion', 'Este registro foi alterado após a leitura. Recarregue os dados e revise antes de tentar salvar novamente.');
+    }
+    resourceVersionRequiredMessage() {
+        return this.tx('global.submitError.resourceVersionRequired', 'A versão atual do registro é obrigatória para confirmar esta alteração. Recarregue o registro e tente novamente.');
+    }
     objectValue(value) {
         return value !== null && typeof value === 'object' && !Array.isArray(value)
             ? value
@@ -39980,7 +40086,7 @@ class WidgetPageDataSourceRuntimeService {
     /**
      * Constrói a URL canônica completa para o resourcePath declarado no dataSource.
      */
-    resolveUrl(resourcePath) {
+    resolveUrl(resourcePath, endpointKey) {
         const trimmed = (resourcePath || '').trim();
         if (!trimmed)
             return '';
@@ -39989,7 +40095,10 @@ class WidgetPageDataSourceRuntimeService {
         }
         let base = '';
         if (this.apiUrlConfig) {
-            const entry = this.apiUrlConfig['default'] || Object.values(this.apiUrlConfig)[0];
+            const key = (endpointKey || 'default').trim() || 'default';
+            const entry = this.apiUrlConfig[key] ||
+                this.apiUrlConfig['default'] ||
+                Object.values(this.apiUrlConfig)[0];
             if (entry) {
                 base = buildApiUrl(entry);
             }
@@ -40008,7 +40117,7 @@ class WidgetPageDataSourceRuntimeService {
         if (!this.http) {
             return of(dataSource.fallbackValue ?? null);
         }
-        const url = this.resolveUrl(dataSource.resourcePath);
+        const url = this.resolveUrl(dataSource.resourcePath, dataSource.endpointKey);
         if (!url) {
             return of(dataSource.fallbackValue ?? null);
         }
@@ -40032,7 +40141,8 @@ class WidgetPageDataSourceRuntimeService {
         if (!this.http) {
             return of(dataSource.fallbackValue ?? null);
         }
-        const url = resolvedUrl ?? this.resolveUrl(dataSource.resourcePath);
+        const url = resolvedUrl ??
+            this.resolveUrl(dataSource.resourcePath, dataSource.endpointKey);
         if (!url) {
             return of(dataSource.fallbackValue ?? null);
         }
@@ -40073,6 +40183,7 @@ class WidgetPageDataSourceRuntimeService {
             return () => { };
         }
         const destroy$ = new Subject();
+        const visibilityCallbacks = [];
         for (const ds of dataSources) {
             if (ds.autoFetch === false) {
                 continue;
@@ -40080,12 +40191,14 @@ class WidgetPageDataSourceRuntimeService {
             const targetPath = ds.targetStatePath || ds.id;
             const intervalMs = ds.refreshIntervalMs ?? 0;
             let hasSucceededOnce = false;
+            let skippedWhileHidden = false;
             onDiagnostic?.({
                 dataSourceId: ds.id,
                 status: 'loading',
             });
             const runSingleFetch$ = () => this.executeRawRequest(ds).pipe(map((value) => {
                 hasSucceededOnce = true;
+                skippedWhileHidden = false;
                 const now = new Date().toISOString();
                 onDiagnostic?.({
                     dataSourceId: ds.id,
@@ -40120,16 +40233,43 @@ class WidgetPageDataSourceRuntimeService {
             }));
             const stream$ = intervalMs > 0
                 ? timer(0, intervalMs).pipe(takeUntil(destroy$), switchMap(() => {
-                    if (typeof document !== 'undefined' &&
+                    if (hasSucceededOnce &&
+                        typeof document !== 'undefined' &&
                         document.visibilityState === 'hidden') {
+                        skippedWhileHidden = true;
                         return EMPTY;
                     }
                     return runSingleFetch$();
                 }))
                 : runSingleFetch$().pipe(takeUntil(destroy$));
             stream$.subscribe();
+            if (intervalMs > 0) {
+                visibilityCallbacks.push(() => {
+                    if (skippedWhileHidden) {
+                        skippedWhileHidden = false;
+                        runSingleFetch$().pipe(takeUntil(destroy$)).subscribe();
+                    }
+                });
+            }
+        }
+        const onVisibilityChange = () => {
+            if (typeof document !== 'undefined' && document.visibilityState === 'visible') {
+                for (const cb of visibilityCallbacks) {
+                    cb();
+                }
+            }
+        };
+        if (visibilityCallbacks.length > 0 &&
+            typeof document !== 'undefined' &&
+            typeof document.addEventListener === 'function') {
+            document.addEventListener('visibilitychange', onVisibilityChange);
         }
         return () => {
+            if (visibilityCallbacks.length > 0 &&
+                typeof document !== 'undefined' &&
+                typeof document.removeEventListener === 'function') {
+                document.removeEventListener('visibilitychange', onVisibilityChange);
+            }
             destroy$.next();
             destroy$.complete();
         };
@@ -45716,6 +45856,7 @@ class DynamicWidgetPageComponent {
     pendingDataSourceUpdates = [];
     isCoalescingDataSourceUpdates = false;
     dataSourceRuntimeOverlay = new Map();
+    dataSourceDiagnostics = new Map();
     nestedWidgetAccessor = new NestedWidgetConfigAccessor();
     settingsPanel = inject(SETTINGS_PANEL_BRIDGE, {
         optional: true,
@@ -45807,6 +45948,7 @@ class DynamicWidgetPageComponent {
         this.pendingDataSourceUpdates = [];
         this.isCoalescingDataSourceUpdates = false;
         this.dataSourceRuntimeOverlay.clear();
+        this.dataSourceDiagnostics.clear();
         this.persistenceGeneration++;
         this.persistenceLoad?.unsubscribe();
         this.persistenceMutation?.unsubscribe();
@@ -45891,6 +46033,8 @@ class DynamicWidgetPageComponent {
                 this.getDataSourcesSignature(this.pageDefinition?.dataSources) !==
                     this.currentDataSourcesSignature) {
                 this.dataSourceRuntimeOverlay.clear();
+                this.dataSourceDiagnostics.clear();
+                this.currentDataSourcesSignature = null;
             }
             this.pageRuntime = this.buildStateRuntime(this.pageDefinition?.state, this.pageDefinition?.context);
             this.pageState = this.pageRuntime.state;
@@ -45992,13 +46136,21 @@ class DynamicWidgetPageComponent {
         const state = this.stateFromCompositionSnapshot(pageWithPatchedInputs.state, cycle.snapshot.state.primaryValues);
         const runtimeStatePaths = Array.from(new Set((cycle.snapshot.state.changedPaths || []).filter((path) => typeof path === 'string')));
         const updatedPrimaryStatePaths = runtimeStatePaths.filter((path) => !this.areStateValuesEqual(this.conn.extractByPath(this.stateRuntime.normalizeState(page.state).values || {}, path), this.conn.extractByPath(state.values || {}, path)));
+        for (const changedPath of updatedPrimaryStatePaths) {
+            this.dataSourceRuntimeOverlay.delete(changedPath);
+        }
+        const nextRuntime = this.buildStateRuntime(state, pageWithPatchedInputs.context);
         let widgets = this.cloneWidgets(pageWithPatchedInputs.widgets || []);
         const directDelivery = this.applyCompositionWidgetDeliveries(widgets, cycle);
         widgets = directDelivery.widgets;
-        const projectedWidgets = this.projectPersistentCompositionStateInputs(widgets, cycle.snapshot.state, cycle.snapshot.generatedAt);
+        const effectiveCompositionState = {
+            ...cycle.snapshot.state,
+            primaryValues: this.cloneStateValues(nextRuntime.primaryValues),
+            derivedValues: this.cloneStateValues(nextRuntime.derivedValues),
+        };
+        const projectedWidgets = this.projectPersistentCompositionStateInputs(widgets, effectiveCompositionState, cycle.snapshot.generatedAt);
         const stateProjectionChanged = !this.areStateValuesEqual(widgets, projectedWidgets);
         widgets = projectedWidgets;
-        const nextRuntime = this.buildStateRuntime(state, pageWithPatchedInputs.context);
         if (this.isTransientOnlyCompositionCycle(cycle) &&
             !updatedPrimaryStatePaths.length &&
             !directDelivery.changed &&
@@ -46826,12 +46978,16 @@ class DynamicWidgetPageComponent {
             return { page };
         }
         const state = this.stateFromCompositionSnapshot(page.state, cycle.snapshot.state.primaryValues);
+        const runtime = this.buildStateRuntime(state, page.context);
         let widgets = this.cloneWidgets(page.widgets || []);
         widgets = this.applyCompositionWidgetDeliveries(widgets, cycle).widgets;
         if (this.compositionDefinition) {
-            widgets = this.projectPersistentCompositionStateInputs(widgets, cycle.snapshot.state, cycle.snapshot.generatedAt);
+            widgets = this.projectPersistentCompositionStateInputs(widgets, {
+                ...cycle.snapshot.state,
+                primaryValues: this.cloneStateValues(runtime.primaryValues),
+                derivedValues: this.cloneStateValues(runtime.derivedValues),
+            }, cycle.snapshot.generatedAt);
         }
-        const runtime = this.buildStateRuntime(state, page.context);
         return {
             page: { ...page, widgets, state },
             runtime,
@@ -46948,10 +47104,14 @@ class DynamicWidgetPageComponent {
             return;
         }
         const state = this.stateFromCompositionSnapshot(page.state, cycle.snapshot.state.primaryValues);
+        const runtime = this.buildStateRuntime(state, page.context);
         let widgets = this.cloneWidgets(page.widgets || []);
         widgets = this.applyCompositionWidgetDeliveries(widgets, cycle).widgets;
-        widgets = this.projectPersistentCompositionStateInputs(widgets, cycle.snapshot.state, cycle.snapshot.generatedAt);
-        const runtime = this.buildStateRuntime(state, page.context);
+        widgets = this.projectPersistentCompositionStateInputs(widgets, {
+            ...cycle.snapshot.state,
+            primaryValues: this.cloneStateValues(runtime.primaryValues),
+            derivedValues: this.cloneStateValues(runtime.derivedValues),
+        }, cycle.snapshot.generatedAt);
         this.applyPageUpdate({ ...page, widgets, state }, true, runtime, false, true, false);
     }
     matchesRuntimeSourceRef(endpoint, sourceRef) {
@@ -48646,7 +48806,7 @@ class DynamicWidgetPageComponent {
                         state: {
                             primaryValues: this.cloneStateValues(runtime.primaryValues),
                             derivedValues: this.cloneStateValues(runtime.derivedValues),
-                            transientValues: {},
+                            transientValues: this.cloneStateValues(this.compositionRuntime.getSnapshot().state.transientValues),
                             changedPaths: [],
                             diagnostics: [],
                         },
@@ -48730,7 +48890,7 @@ class DynamicWidgetPageComponent {
                 state: {
                     primaryValues: this.cloneStateValues(nextRuntime.primaryValues),
                     derivedValues: this.cloneStateValues(nextRuntime.derivedValues),
-                    transientValues: {},
+                    transientValues: this.cloneStateValues(this.compositionRuntime.getSnapshot().state.transientValues),
                     changedPaths: updates.map((u) => u.targetStatePath),
                     diagnostics: [],
                 },
@@ -48747,6 +48907,17 @@ class DynamicWidgetPageComponent {
         this.reportStateDiagnostics(nextRuntime.diagnostics);
         this.changeDetector.markForCheck();
     }
+    handleDataSourceDiagnostic(diagnostic) {
+        if (this.destroyed) {
+            return;
+        }
+        this.dataSourceDiagnostics.set(diagnostic.dataSourceId, diagnostic);
+        if (diagnostic.status === 'error') {
+            this.reportStateDiagnostics([
+                `DataSource "${diagnostic.dataSourceId}" failed: ${diagnostic.error || 'unknown error'}`,
+            ]);
+        }
+    }
     restartDataSources(page) {
         const dataSources = page?.dataSources;
         const signature = this.getDataSourcesSignature(dataSources);
@@ -48755,12 +48926,13 @@ class DynamicWidgetPageComponent {
         }
         this.currentDataSourcesSignature = signature;
         this.dataSourceRuntimeOverlay.clear();
+        this.dataSourceDiagnostics.clear();
         this.dataSourceTeardown?.();
         this.dataSourceTeardown = undefined;
         if (!dataSources || dataSources.length === 0) {
             return;
         }
-        this.dataSourceTeardown = this.dataSourceRuntime.startDataSources(dataSources, (update) => this.handleDataSourceUpdate(update));
+        this.dataSourceTeardown = this.dataSourceRuntime.startDataSources(dataSources, (update) => this.handleDataSourceUpdate(update), (diagnostic) => this.handleDataSourceDiagnostic(diagnostic));
     }
     applyLayout(layout, grouping, deviceLayoutColumnsSelected = false) {
         this.layout = layout;
@@ -51240,7 +51412,13 @@ class DynamicWidgetPageComponent {
             cloned.layout = { ...page.layout };
         }
         if (page.grouping) {
-            cloned.grouping = [...page.grouping];
+            cloned.grouping = this.cloneStateValues(page.grouping);
+        }
+        if (page.dataSources) {
+            cloned.dataSources = this.cloneStateValues(page.dataSources);
+        }
+        if (page.composition) {
+            cloned.composition = this.cloneStateValues(page.composition);
         }
         if (page.canvas) {
             cloned.canvas = {
@@ -51251,16 +51429,20 @@ class DynamicWidgetPageComponent {
             };
         }
         if (page.context) {
-            cloned.context = { ...page.context };
+            cloned.context = this.cloneStateValues(page.context);
         }
         if (page.state) {
             const stateObj = {
-                values: page.state.values ? { ...page.state.values } : {},
+                values: page.state.values
+                    ? this.cloneStateValues(page.state.values)
+                    : {},
             };
-            if (page.state.schema !== undefined)
-                stateObj.schema = page.state.schema;
-            if (page.state.derived !== undefined)
-                stateObj.derived = page.state.derived;
+            if (page.state.schema !== undefined) {
+                stateObj.schema = this.cloneStateValues(page.state.schema);
+            }
+            if (page.state.derived !== undefined) {
+                stateObj.derived = this.cloneStateValues(page.state.derived);
+            }
             cloned.state = stateObj;
         }
         return cloned;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/core",
-  "version": "10.0.0-rc.15",
+  "version": "10.0.0-rc.16",
   "description": "Core library for Praxis UI Workspace: types, tokens, services and utilities shared across @praxisui/* packages.",
   "peerDependencies": {
     "@angular/cdk": "^21.0.0",

package/types/praxisui-core.d.ts

@@ -6363,9 +6363,13 @@ declare class GenericCrudService<T, ID extends string | number = string | number
      * @returns Observable com a entidade atualizada.
      */
     update(id: ID, entity: T, options?: CrudOperationOptions): Observable<T>;
+    getResourceVersion(id: ID, options?: CrudOperationOptions): string | null;
+    setResourceVersion(id: ID, etag: string | null | undefined, options?: CrudOperationOptions): void;
     updateResponse(id: ID, entity: T, options?: CrudOperationOptions): Observable<RestApiResponse<T>>;
     private resourceVersionKey;
     private captureResourceVersion;
+    private normalizeEtagToken;
+    private ensureEtagFormat;
     /**
      * Remove um registro pelo ID.
      *
@@ -10840,6 +10844,9 @@ declare class ErrorMessageService {
     getSubmitErrorMessage(error: unknown): string;
     private fallbackMessage;
     private normalizeDetails;
+    private resolveVersionPreconditionCopy;
+    private staleResourceVersionMessage;
+    private resourceVersionRequiredMessage;
     private objectValue;
     private textValue;
     private numberValue;
@@ -16232,6 +16239,8 @@ interface WidgetPageDataSourceDefinition {
     kind?: WidgetPageDataSourceKind;
     /** Caminho do recurso canônico no backend Praxis (ex: 'human-resources/funcionarios/stats/group-by'). */
     resourcePath: string;
+    /** Chave opcional do endpoint configurado em API_URL (padrão: 'default'). */
+    endpointKey?: string;
     /** Método HTTP utilizado (padrão: 'POST' para endpoints /stats, 'GET' para recursos padrão). */
     method?: WidgetPageDataSourceMethod;
     /** Parâmetros de consulta (query params para GET ou corpo da requisição para POST de analytics). */
@@ -18246,7 +18255,7 @@ declare class WidgetPageDataSourceRuntimeService {
     /**
      * Constrói a URL canônica completa para o resourcePath declarado no dataSource.
      */
-    resolveUrl(resourcePath: string): string;
+    resolveUrl(resourcePath: string, endpointKey?: string): string;
     /**
      * Executa uma única consulta para um DataSource e retorna o resultado transformado.
      */
@@ -18776,6 +18785,7 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     private pendingDataSourceUpdates;
     private isCoalescingDataSourceUpdates;
     private readonly dataSourceRuntimeOverlay;
+    private readonly dataSourceDiagnostics;
     private readonly nestedWidgetAccessor;
     private readonly settingsPanel;
     private readonly defaultShellEditor;
@@ -19007,6 +19017,7 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     private applyPageUpdate;
     private handleDataSourceUpdate;
     private flushPendingDataSourceUpdates;
+    private handleDataSourceDiagnostic;
     private restartDataSources;
     private applyLayout;
     private applyCanvasLayout;