@praxisui/page-builder 8.0.0-beta.92 → 8.0.0-beta.93

package/fesm2022/praxisui-page-builder.mjs

@@ -14307,13 +14307,14 @@ class PageBuilderAgenticAuthoringTurnFlow {
                 };
             }
             const status = this.decorateDashboardReviewStatus(this.context.describePreviewStatus(preview), intentResolution, preview);
+            const reviewCanApply = this.reviewCanApply(intentResolution, preview);
             return {
                 state: 'review',
                 phase: 'review',
                 assistantMessage: status,
-                quickReplies: this.dashboardQualityQuickReplies(intentResolution, preview),
-                canApply: true,
-                statusText: this.reviewStatusText(status, true),
+                quickReplies: this.reviewQuickReplies([], intentResolution, preview),
+                canApply: reviewCanApply,
+                statusText: this.reviewStatusText(status, reviewCanApply),
                 errorText: '',
                 preview,
                 diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
@@ -14445,8 +14446,848 @@ class PageBuilderAgenticAuthoringTurnFlow {
             currentPageSummary: {},
             contextHints,
         };
+        const localDashboardRepair = this.buildLocalDashboardRepairPreview(prompt, contextHints, intentResolution);
+        if (localDashboardRepair) {
+            return this.applyDashboardRepairPreview(localDashboardRepair, intentResolution);
+        }
         return this.completeExecutableStreamPreview(request, prompt, intentResolution, undefined);
     }
+    async applyDashboardRepairPreview(preview, intentResolution) {
+        const applied = await this.context.applyLocalPreview(preview);
+        if (!applied.success) {
+            const message = applied.error || this.context.tx('agentic.errors.applyLocal', 'Preview could not be applied.');
+            return {
+                state: 'error',
+                phase: 'preview',
+                assistantMessage: message,
+                canApply: false,
+                statusText: '',
+                errorText: message,
+                preview: null,
+                diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
+            };
+        }
+        const status = this.decorateDashboardReviewStatus(this.context.describePreviewStatus(preview), intentResolution, preview);
+        const reviewCanApply = this.reviewCanApply(intentResolution, preview);
+        return {
+            state: 'review',
+            phase: 'review',
+            assistantMessage: status,
+            quickReplies: this.reviewQuickReplies([], intentResolution, preview),
+            canApply: reviewCanApply,
+            statusText: this.reviewStatusText(status, reviewCanApply),
+            errorText: '',
+            preview,
+            diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
+        };
+    }
+    buildLocalDashboardRepairPreview(prompt, contextHints, intentResolution) {
+        const changeKind = intentResolution.changeKind
+            || this.readString(contextHints, 'changeKind')
+            || this.dashboardQualityChangeKindFromActionText(prompt)
+            || '';
+        if (this.readString(contextHints, 'kind') !== 'dashboard-repair-action' && !changeKind) {
+            return null;
+        }
+        if (![
+            'add_dashboard_kpis',
+            'bind_dashboard_kpis',
+            'add_dashboard_chart',
+            'add_dashboard_surfaces',
+            'connect_dashboard_widgets',
+        ].includes(changeKind)) {
+            return null;
+        }
+        const page = this.dashboardRepairBasePage(contextHints);
+        if (!page) {
+            return null;
+        }
+        const repairLog = [];
+        if (changeKind === 'add_dashboard_kpis' || changeKind === 'bind_dashboard_kpis') {
+            this.repairDashboardKpis(page, contextHints, repairLog);
+        }
+        if (changeKind === 'add_dashboard_chart') {
+            this.repairDashboardChart(page, contextHints, repairLog);
+            this.repairDashboardConnections(page, repairLog);
+        }
+        if (changeKind === 'add_dashboard_surfaces') {
+            this.repairDashboardSurfaces(page, contextHints, repairLog);
+        }
+        if (changeKind === 'connect_dashboard_widgets') {
+            this.repairDashboardConnections(page, repairLog);
+        }
+        if (!repairLog.length) {
+            return null;
+        }
+        return {
+            valid: true,
+            failureCodes: [],
+            warnings: [],
+            minimalFormPlan: {},
+            compiledFormPatch: {
+                patch: { page: page },
+                diagnostics: {
+                    dashboardQualityRepair: {
+                        schemaVersion: 'praxis-dashboard-quality-repair.v1',
+                        source: 'dashboard-quality-gate',
+                        mode: 'local-deterministic-repair',
+                        changeKind,
+                        prompt,
+                        actions: repairLog,
+                    },
+                },
+            },
+            diagnostics: {
+                dashboardQualityRepair: {
+                    schemaVersion: 'praxis-dashboard-quality-repair.v1',
+                    source: 'dashboard-quality-gate',
+                    mode: 'local-deterministic-repair',
+                    changeKind,
+                    actions: repairLog,
+                },
+            },
+        };
+    }
+    dashboardRepairBasePage(contextHints) {
+        const materializedPage = this.cloneJsonObject(this.toJsonObject(contextHints['materializedPage']));
+        if (this.hasDashboardSnapshotWidgets(materializedPage)) {
+            return materializedPage;
+        }
+        const currentPage = this.cloneJsonObject(this.toJsonObject(this.context.currentPage()));
+        if (this.hasDashboardSnapshotWidgets(currentPage)) {
+            return currentPage;
+        }
+        const plan = this.toJsonObject(contextHints['uiCompositionPlan']);
+        const pageFromPlan = this.pageFromUiCompositionPlan(plan);
+        return this.hasDashboardSnapshotWidgets(pageFromPlan) ? pageFromPlan : null;
+    }
+    pageFromUiCompositionPlan(plan) {
+        if (!plan) {
+            return null;
+        }
+        const widgets = this.arrayFromUnknown(plan['widgets'])
+            .map((widget) => this.toJsonObject(widget))
+            .filter((widget) => !!widget)
+            .map((widget) => ({
+            key: this.readString(widget, 'key') ?? this.readString(widget, 'id') ?? 'dashboard-widget',
+            ...(this.toJsonObject(widget['shell']) ? { shell: this.cloneJsonObject(this.toJsonObject(widget['shell'])) } : {}),
+            ...(this.readString(widget, 'className') ? { className: this.readString(widget, 'className') } : {}),
+            definition: {
+                id: this.readString(widget, 'componentId') ?? this.readString(widget, 'type') ?? 'praxis-rich-content',
+                bindingOrder: this.arrayFromUnknown(widget['bindingOrder']).map((item) => `${item}`),
+                inputs: this.cloneJsonObject(this.toJsonObject(widget['inputs'])) ?? {},
+            },
+        }));
+        const links = this.arrayFromUnknown(plan['bindings'])
+            .map((binding) => this.toJsonObject(binding))
+            .filter((binding) => !!binding)
+            .map((binding) => this.pageCompositionLinkFromBinding(binding))
+            .filter((link) => !!link);
+        return {
+            title: this.readString(plan, 'title') ?? 'Dashboard',
+            layoutPreset: this.readString(plan, 'layoutPreset'),
+            themePreset: this.readString(plan, 'themePreset'),
+            canvas: this.cloneJsonObject(this.toJsonObject(plan['canvas'])),
+            state: this.cloneJsonObject(this.toJsonObject(plan['state'])),
+            widgets,
+            ...(links.length ? { composition: { version: '1.0.0', links } } : {}),
+        };
+    }
+    pageCompositionLinkFromBinding(binding) {
+        const from = this.pageCompositionEndpointFromPlanEndpoint(this.toJsonObject(binding['from']));
+        const to = this.pageCompositionEndpointFromPlanEndpoint(this.toJsonObject(binding['to']));
+        if (!from || !to) {
+            return null;
+        }
+        return {
+            id: this.readString(binding, 'id') ?? `${JSON.stringify(from)}->${JSON.stringify(to)}`,
+            intent: this.readString(binding, 'intent') ?? 'filter',
+            from,
+            to,
+            ...(this.toJsonObject(binding['transform']) ? { transform: this.cloneJsonObject(this.toJsonObject(binding['transform'])) } : {}),
+        };
+    }
+    pageCompositionEndpointFromPlanEndpoint(endpoint) {
+        if (!endpoint) {
+            return null;
+        }
+        const kind = this.readString(endpoint, 'kind');
+        if (kind === 'component-port') {
+            return {
+                kind,
+                ref: {
+                    widget: this.readString(endpoint, 'widget'),
+                    port: this.readString(endpoint, 'port'),
+                    direction: this.readString(endpoint, 'direction'),
+                    componentType: this.readString(endpoint, 'componentType'),
+                    nestedPath: this.cloneJsonObject(this.toJsonObject(endpoint['nestedPath'])),
+                },
+            };
+        }
+        if (kind === 'global-action') {
+            return {
+                kind,
+                ref: {
+                    actionId: this.readString(endpoint, 'actionId') ?? this.readString(this.toJsonObject(endpoint['ref']) ?? {}, 'actionId'),
+                    payload: this.cloneJsonObject(this.toJsonObject(endpoint['payload'])),
+                },
+            };
+        }
+        if (kind === 'state') {
+            return {
+                kind,
+                ref: {
+                    path: this.readString(endpoint, 'path'),
+                },
+            };
+        }
+        return null;
+    }
+    repairDashboardKpis(page, contextHints, repairLog) {
+        const widgets = this.dashboardPageWidgets(page);
+        const detailKey = this.dashboardDetailWidgetKey(page) ?? this.dashboardDetailWidgetKeyFromRepairContext(contextHints);
+        let repaired = false;
+        for (const widget of widgets) {
+            const componentId = this.dashboardWidgetComponentId(widget);
+            const inputs = this.dashboardWidgetInputs(widget);
+            if (!this.isDashboardKpiWidget(componentId, widget, inputs, this.toJsonObject(widget['shell']))) {
+                continue;
+            }
+            const document = this.toJsonObject(inputs['document']);
+            if (!document) {
+                continue;
+            }
+            const kpiKey = this.dashboardWidgetKey(widget);
+            repaired = this.repairRichContentKpiDocument(document) || repaired;
+            const context = this.dashboardKpiInitialContext(inputs['context']);
+            this.setDashboardWidgetInputs(widget, {
+                ...inputs,
+                context,
+                document,
+            });
+            this.ensureDashboardWidgetBindingOrder(widget, ['document', 'context']);
+            if (detailKey && this.ensureDashboardKpiContextLinks(page, detailKey, kpiKey)) {
+                repaired = true;
+            }
+        }
+        if (!repaired) {
+            const resourcePath = this.dashboardRepairResourcePath(contextHints);
+            const kpiKey = this.uniqueDashboardWidgetKey(page, 'dashboard-kpis');
+            const kpiWidget = {
+                key: kpiKey,
+                shell: {
+                    kind: 'dashboard-card',
+                    title: 'Indicadores',
+                    subtitle: 'Metricas dinamicas do recurso selecionado',
+                },
+                definition: {
+                    id: 'praxis-rich-content',
+                    bindingOrder: ['document', 'context', 'resourcePath', 'queryContext'],
+                    inputs: {
+                        resourcePath,
+                        queryContext: { filters: {} },
+                        context: this.dashboardKpiInitialContext(),
+                        document: this.buildDashboardKpiDocument(),
+                    },
+                },
+            };
+            this.insertDashboardWidget(page, kpiWidget, 1);
+            if (detailKey) {
+                this.ensureDashboardKpiContextLinks(page, detailKey, kpiKey);
+            }
+            repaired = true;
+        }
+        if (repaired) {
+            repairLog.push('dashboard-kpis-bound');
+        }
+    }
+    repairRichContentKpiDocument(document) {
+        let repaired = false;
+        for (const node of this.arrayFromUnknown(document['nodes'])) {
+            repaired = this.repairRichContentKpiNode(this.toJsonObject(node)) || repaired;
+        }
+        return repaired;
+    }
+    repairRichContentKpiNode(node) {
+        if (!node) {
+            return false;
+        }
+        let repaired = false;
+        const type = this.readString(node, 'type')?.toLowerCase();
+        if (type === 'metric' || type === 'stat' || type === 'statitem' || type === 'stat-item') {
+            repaired = this.bindKpiNode(node) || repaired;
+        }
+        if (type === 'statgroup' || type === 'stat-group') {
+            if (this.dashboardKpiStatGroupNeedsCanonicalItems(node)) {
+                node['items'] = this.buildDashboardKpiItems();
+                repaired = true;
+            }
+            for (const item of this.arrayFromUnknown(node['items'])) {
+                repaired = this.bindKpiNode(this.toJsonObject(item)) || repaired;
+            }
+        }
+        for (const key of ['nodes', 'items', 'children', 'content']) {
+            for (const child of this.arrayFromUnknown(node[key])) {
+                repaired = this.repairRichContentKpiNode(this.toJsonObject(child)) || repaired;
+            }
+        }
+        return repaired;
+    }
+    dashboardKpiStatGroupNeedsCanonicalItems(node) {
+        const items = this.arrayFromUnknown(node['items'])
+            .map((item) => this.toJsonObject(item))
+            .filter((item) => !!item);
+        if (!items.length) {
+            return true;
+        }
+        const canonicalLabels = new Set(['total filtrado', 'itens na pagina', 'status da consulta']);
+        const hasOnlyResolvableLabels = items.every((item) => canonicalLabels.has(this.normalizeText(this.readString(item, 'label') ?? this.readString(item, 'title') ?? '')));
+        if (hasOnlyResolvableLabels) {
+            return false;
+        }
+        return items.some((item) => !!this.readString(item, 'valuePath')
+            || !this.readString(item, 'valueExpr')
+            || ['-', '--', 'n/a'].includes((this.readString(item, 'value') || '').toLowerCase()));
+    }
+    bindKpiNode(node) {
+        if (!node) {
+            return false;
+        }
+        const value = this.readString(node, 'value')?.trim() ?? '';
+        const hasRuntimeExpression = !!this.readString(node, 'valueExpr');
+        if (hasRuntimeExpression && value !== '-' && value !== '--' && value.toLowerCase() !== 'n/a') {
+            return false;
+        }
+        if (!hasRuntimeExpression && value && value !== '-' && value !== '--' && value.toLowerCase() !== 'n/a') {
+            return false;
+        }
+        const label = this.readString(node, 'label') ?? this.readString(node, 'title') ?? '';
+        node['valueExpr'] = this.dashboardKpiValueExpression(label);
+        delete node['valuePath'];
+        delete node['valueTemplate'];
+        delete node['value'];
+        node['format'] = node['format'] ?? 'integer';
+        node['captionExpr'] = this.dashboardKpiCaptionExpression(label);
+        delete node['caption'];
+        return true;
+    }
+    dashboardKpiValueExpression(label) {
+        const normalized = this.normalizeText(label);
+        if (normalized.includes('pagina') || normalized.includes('carregad')) {
+            return '${loadedItemsCount}';
+        }
+        if (normalized.includes('status')) {
+            return '${statusLabel}';
+        }
+        return '${totalItems}';
+    }
+    dashboardKpiCaptionExpression(label) {
+        const normalized = this.normalizeText(label);
+        if (normalized.includes('pagina') || normalized.includes('carregad')) {
+            return '${loadedItemsCaption}';
+        }
+        if (normalized.includes('status')) {
+            return '${statusCaption}';
+        }
+        return '${totalCaption}';
+    }
+    hasDynamicKpiBinding(node) {
+        return !!(this.readString(node, 'valueExpr') || this.readString(node, 'valueTemplate'));
+    }
+    buildDashboardKpiDocument() {
+        return {
+            kind: 'praxis.rich-content',
+            version: '1.0.0',
+            nodes: [
+                {
+                    type: 'statGroup',
+                    title: 'Leitura executiva',
+                    layout: 'grid',
+                    items: this.buildDashboardKpiItems(),
+                },
+            ],
+        };
+    }
+    buildDashboardKpiItems() {
+        return [
+            {
+                label: 'Total filtrado',
+                valueExpr: '${totalItems}',
+                format: 'integer',
+                icon: 'monitoring',
+                captionExpr: '${totalCaption}',
+            },
+            {
+                label: 'Itens na pagina',
+                valueExpr: '${loadedItemsCount}',
+                format: 'integer',
+                icon: 'view_list',
+                captionExpr: '${loadedItemsCaption}',
+            },
+            {
+                label: 'Status da consulta',
+                valueExpr: '${statusLabel}',
+                icon: 'sync',
+                captionExpr: '${statusCaption}',
+            },
+        ];
+    }
+    dashboardKpiInitialContext(current) {
+        return {
+            totalItems: 0,
+            loadedItemsCount: 0,
+            statusLabel: this.context.tx('agentic.dashboardQuality.kpiStatus.loading', 'Carregando'),
+            totalCaption: this.context.tx('agentic.dashboardQuality.kpiCaption.total', 'Total retornado pela consulta filtrada'),
+            loadedItemsCaption: this.context.tx('agentic.dashboardQuality.kpiCaption.loaded', 'Itens carregados nesta pagina'),
+            statusCaption: this.context.tx('agentic.dashboardQuality.kpiCaption.status', 'Atualizado pelo runtime da tabela'),
+            ...(this.cloneJsonObject(this.toJsonObject(current)) ?? {}),
+        };
+    }
+    ensureDashboardKpiContextLinks(page, tableKey, kpiKey) {
+        const links = this.dashboardCompositionLinks(page);
+        const writeId = `${tableKey}.loadingStateChange->dashboardKpis`;
+        const readId = `dashboardKpis->${kpiKey}.context`;
+        let changed = false;
+        if (!links.some((link) => this.readString(link, 'id') === writeId)) {
+            links.push({
+                id: writeId,
+                intent: 'state-write',
+                from: {
+                    kind: 'component-port',
+                    ref: { widget: tableKey, port: 'loadingStateChange', direction: 'output' },
+                },
+                to: {
+                    kind: 'state',
+                    ref: { path: 'dashboardKpis', layer: 'values', writable: true },
+                },
+                transform: {
+                    version: '2.0',
+                    phase: 'link-propagation',
+                    mode: 'object-fragment',
+                    sourceBindings: [{ source: 'event' }],
+                    steps: [
+                        {
+                            id: `${writeId}:summary`,
+                            kind: 'object-template',
+                            phase: 'link-propagation',
+                            input: { source: 'event' },
+                            config: {
+                                template: {
+                                    totalItems: '${payload.totalItems}',
+                                    loadedItemsCount: '${payload.loadedItemsCount}',
+                                    statusLabel: '${payload.status}',
+                                    totalCaption: 'Total retornado pela consulta filtrada',
+                                    loadedItemsCaption: 'Itens carregados nesta pagina',
+                                    statusCaption: '${payload.message}',
+                                },
+                            },
+                        },
+                    ],
+                },
+                metadata: { source: 'persisted-composition-link' },
+            });
+            changed = true;
+        }
+        if (!links.some((link) => this.readString(link, 'id') === readId)) {
+            links.push({
+                id: readId,
+                intent: 'state-read',
+                from: {
+                    kind: 'state',
+                    ref: { path: 'dashboardKpis', layer: 'values' },
+                },
+                to: {
+                    kind: 'component-port',
+                    ref: { widget: kpiKey, port: 'context', direction: 'input' },
+                },
+                metadata: { source: 'persisted-composition-link' },
+            });
+            changed = true;
+        }
+        if (changed) {
+            const composition = this.toJsonObject(page['composition']) ?? {};
+            page['composition'] = {
+                ...composition,
+                version: this.readString(composition, 'version') ?? '1.0.0',
+                links,
+            };
+        }
+        return changed;
+    }
+    repairDashboardChart(page, contextHints, repairLog) {
+        const widgets = this.dashboardPageWidgets(page);
+        if (widgets.some((widget) => this.dashboardWidgetComponentId(widget).includes('chart'))) {
+            return;
+        }
+        const resourcePath = this.dashboardRepairResourcePath(contextHints);
+        const categoryField = this.dashboardCategoryField(page);
+        const chartKey = this.uniqueDashboardWidgetKey(page, 'dashboard-chart');
+        const detailKey = this.dashboardDetailWidgetKey(page) ?? this.dashboardDetailWidgetKeyFromRepairContext(contextHints);
+        this.insertDashboardWidget(page, {
+            key: chartKey,
+            shell: {
+                kind: 'dashboard-card',
+                title: `Distribuicao por ${this.humanizeFieldName(categoryField)}`,
+                subtitle: 'Agrupamento analitico do mesmo recurso',
+            },
+            definition: {
+                id: 'praxis-chart',
+                bindingOrder: ['chartDocument', 'queryContext', 'enableCustomization'],
+                inputs: {
+                    queryContext: { filters: {} },
+                    enableCustomization: true,
+                    chartDocument: {
+                        version: '1.0.0',
+                        chartId: chartKey,
+                        kind: 'bar',
+                        preset: 'dashboard-breakdown',
+                        title: `Distribuicao por ${this.humanizeFieldName(categoryField)}`,
+                        subtitle: 'Clique em uma barra para refinar os detalhes',
+                        source: {
+                            kind: 'praxis.stats',
+                            resource: resourcePath,
+                            operation: 'group-by',
+                            options: {
+                                groupBy: categoryField,
+                                metric: 'count',
+                                orderBy: 'value-desc',
+                                limit: 12,
+                            },
+                        },
+                        dimensions: [{ field: categoryField, label: this.humanizeFieldName(categoryField), role: 'category' }],
+                        metrics: [{ field: 'count', label: 'Registros', aggregation: 'count', seriesKind: 'bar' }],
+                        legend: false,
+                        labels: true,
+                        tooltip: true,
+                        events: {
+                            selectionChange: { action: 'emit' },
+                            pointClick: { action: 'emit' },
+                        },
+                    },
+                },
+            },
+        }, Math.max(2, widgets.length - 1));
+        if (detailKey) {
+            this.addDashboardQueryContextLink(page, chartKey, 'selectionChange', detailKey);
+        }
+        repairLog.push('dashboard-chart-added');
+    }
+    repairDashboardSurfaces(page, contextHints, repairLog) {
+        const resourcePath = this.dashboardRepairResourcePath(contextHints);
+        let repaired = false;
+        for (const widget of this.dashboardPageWidgets(page)) {
+            const componentId = this.dashboardWidgetComponentId(widget);
+            if (!componentId.includes('table') && !componentId.includes('list') && !componentId.includes('chart')) {
+                continue;
+            }
+            const inputs = this.dashboardWidgetInputs(widget);
+            const rowActions = this.arrayFromUnknown(inputs['rowActions'])
+                .map((action) => this.cloneJsonObject(this.toJsonObject(action)))
+                .filter((action) => !!action);
+            const surfaces = this.arrayFromUnknown(inputs['surfaces'])
+                .map((action) => this.cloneJsonObject(this.toJsonObject(action)))
+                .filter((action) => !!action);
+            const surfaceAction = {
+                id: `${this.dashboardWidgetKey(widget)}-open-360`,
+                action: 'surface.open',
+                title: 'Abrir 360',
+                icon: 'open_in_new',
+                presentation: 'modal',
+                resourceSurface: {
+                    id: `${this.dashboardWidgetKey(widget)}-record-360`,
+                    title: 'Detalhes 360',
+                    resourcePath,
+                    presentation: 'modal',
+                },
+                widget: {
+                    id: 'praxis-rich-content',
+                    inputs: {
+                        resourcePath,
+                        document: {
+                            kind: 'praxis.rich-content',
+                            version: '1.0.0',
+                            nodes: [
+                                {
+                                    type: 'callout',
+                                    tone: 'info',
+                                    icon: 'badge',
+                                    titleExpr: '${payload.item.nomeCompleto || payload.item.name || payload.label || "Registro"}',
+                                    message: 'Surface 360 gerada pelo dashboard para explorar o registro selecionado.',
+                                },
+                            ],
+                        },
+                    },
+                },
+            };
+            if (!rowActions.some((action) => this.readString(this.toJsonObject(action) ?? {}, 'action') === 'surface.open')) {
+                rowActions.push(surfaceAction);
+                repaired = true;
+            }
+            if (!surfaces.some((action) => this.readString(this.toJsonObject(action) ?? {}, 'action') === 'surface.open')) {
+                surfaces.push(surfaceAction);
+                repaired = true;
+            }
+            this.setDashboardWidgetInputs(widget, { ...inputs, rowActions, surfaces });
+        }
+        if (repaired) {
+            repairLog.push('dashboard-surfaces-added');
+        }
+    }
+    repairDashboardConnections(page, repairLog) {
+        const widgets = this.dashboardPageWidgets(page);
+        const detailWidget = widgets.find((widget) => {
+            const componentId = this.dashboardWidgetComponentId(widget);
+            return componentId.includes('table') || componentId.includes('list');
+        });
+        if (!detailWidget) {
+            return;
+        }
+        const detailKey = this.dashboardWidgetKey(detailWidget);
+        const links = this.dashboardCompositionLinks(page);
+        let repaired = false;
+        for (const widget of widgets) {
+            const componentId = this.dashboardWidgetComponentId(widget);
+            const widgetKey = this.dashboardWidgetKey(widget);
+            if (widgetKey === detailKey) {
+                continue;
+            }
+            const port = componentId.includes('filter')
+                ? 'requestSearch'
+                : componentId.includes('chart')
+                    ? 'selectionChange'
+                    : '';
+            if (!port) {
+                continue;
+            }
+            const exists = links.some((link) => {
+                const from = this.summarizeEndpoint(this.toJsonObject(link)?.['from']);
+                const to = this.summarizeEndpoint(this.toJsonObject(link)?.['to']);
+                const fromEndpoint = this.toJsonObject(from);
+                const toEndpoint = this.toJsonObject(to);
+                return this.readString(fromEndpoint ?? {}, 'widget') === widgetKey
+                    && this.readString(toEndpoint ?? {}, 'widget') === detailKey
+                    && this.readString(toEndpoint ?? {}, 'port') === 'queryContext';
+            });
+            if (exists) {
+                continue;
+            }
+            links.push({
+                ...this.dashboardQueryContextLink(widgetKey, port, detailKey),
+            });
+            repaired = true;
+        }
+        if (repaired) {
+            const composition = this.toJsonObject(page['composition']) ?? {};
+            page['composition'] = {
+                ...composition,
+                version: this.readString(composition, 'version') ?? '1.0.0',
+                links,
+            };
+            repairLog.push('dashboard-widgets-connected');
+        }
+    }
+    dashboardDetailWidgetKey(page) {
+        const detailWidget = this.dashboardPageWidgets(page).find((widget) => {
+            const componentId = this.dashboardWidgetComponentId(widget);
+            return componentId.includes('table') || componentId.includes('list');
+        });
+        return detailWidget ? this.dashboardWidgetKey(detailWidget) : null;
+    }
+    dashboardDetailWidgetKeyFromRepairContext(contextHints) {
+        const dashboardQuality = this.toJsonObject(contextHints['dashboardQuality']);
+        for (const widget of this.arrayFromUnknown(dashboardQuality?.['widgets'])) {
+            const record = this.toJsonObject(widget);
+            const componentId = (this.readString(record, 'componentId') ?? '').toLowerCase();
+            if (componentId.includes('table') || componentId.includes('list')) {
+                return this.readString(record, 'key');
+            }
+        }
+        return null;
+    }
+    addDashboardQueryContextLink(page, fromWidgetKey, fromPort, toWidgetKey) {
+        const links = this.dashboardCompositionLinks(page);
+        const link = this.dashboardQueryContextLink(fromWidgetKey, fromPort, toWidgetKey);
+        if (links.some((candidate) => this.readString(candidate, 'id') === link.id)) {
+            return false;
+        }
+        links.push(link);
+        const composition = this.toJsonObject(page['composition']) ?? {};
+        page['composition'] = {
+            ...composition,
+            version: this.readString(composition, 'version') ?? '1.0.0',
+            links,
+        };
+        return true;
+    }
+    dashboardQueryContextLink(fromWidgetKey, fromPort, toWidgetKey) {
+        return {
+            id: `${fromWidgetKey}.${fromPort}->${toWidgetKey}.queryContext`,
+            intent: 'filter',
+            from: {
+                kind: 'component-port',
+                ref: { widget: fromWidgetKey, port: fromPort, direction: 'output' },
+            },
+            to: {
+                kind: 'component-port',
+                ref: { widget: toWidgetKey, port: 'queryContext', direction: 'input' },
+            },
+            transform: { kind: 'query-context' },
+        };
+    }
+    dashboardPageWidgets(page) {
+        return this.arrayFromUnknown(page['widgets'])
+            .map((widget) => this.toJsonObject(widget))
+            .filter((widget) => !!widget);
+    }
+    dashboardCompositionLinks(page) {
+        const composition = this.toJsonObject(page['composition']) ?? {};
+        const links = this.arrayFromUnknown(composition['links'])
+            .map((link) => this.toJsonObject(link))
+            .filter((link) => !!link);
+        if (!composition['links']) {
+            page['composition'] = { ...composition, version: '1.0.0', links };
+        }
+        return links;
+    }
+    dashboardWidgetComponentId(widget) {
+        return (this.readString(widget, 'componentId')
+            || this.readString(this.toJsonObject(widget['definition']) ?? {}, 'id')
+            || this.readString(widget, 'type')
+            || '').toLowerCase();
+    }
+    dashboardWidgetKey(widget) {
+        return this.readString(widget, 'key') || this.readString(widget, 'id') || 'dashboard-widget';
+    }
+    dashboardWidgetInputs(widget) {
+        return this.cloneJsonObject(this.toJsonObject(widget['inputs'])
+            ?? this.toJsonObject(this.toJsonObject(widget['definition'])?.['inputs'])
+            ?? this.toJsonObject(widget['inputValues'])
+            ?? this.toJsonObject(widget['props'])
+            ?? this.toJsonObject(widget['config'])
+            ?? {}) ?? {};
+    }
+    setDashboardWidgetInputs(widget, inputs) {
+        const definition = this.toJsonObject(widget['definition']);
+        if (definition) {
+            definition['inputs'] = inputs;
+            widget['definition'] = definition;
+            return;
+        }
+        widget['inputs'] = inputs;
+    }
+    ensureDashboardWidgetBindingOrder(widget, required) {
+        const definition = this.toJsonObject(widget['definition']);
+        if (!definition) {
+            return;
+        }
+        const current = this.arrayFromUnknown(definition['bindingOrder'])
+            .map((item) => `${item}`.trim())
+            .filter(Boolean);
+        const next = [...current];
+        for (const item of required) {
+            if (!next.includes(item)) {
+                next.push(item);
+            }
+        }
+        definition['bindingOrder'] = next;
+        widget['definition'] = definition;
+    }
+    insertDashboardWidget(page, widget, index) {
+        const widgets = this.dashboardPageWidgets(page);
+        widgets.splice(Math.max(0, Math.min(index, widgets.length)), 0, widget);
+        page['widgets'] = widgets;
+        this.ensureDashboardCanvasItem(page, this.dashboardWidgetKey(widget), this.dashboardWidgetComponentId(widget));
+    }
+    ensureDashboardCanvasItem(page, widgetKey, componentId) {
+        if (!widgetKey) {
+            return;
+        }
+        const canvas = this.toJsonObject(page['canvas']);
+        if (!canvas) {
+            return;
+        }
+        const items = this.toJsonObject(canvas['items']) ?? {};
+        if (this.toJsonObject(items[widgetKey])) {
+            return;
+        }
+        const columns = Math.max(1, Number(canvas['columns']) || 12);
+        const existingItems = Object.values(items)
+            .map((item) => this.toJsonObject(item))
+            .filter((item) => !!item);
+        const maxRowEnd = existingItems.reduce((max, item) => {
+            const row = Math.max(1, Number(item['row']) || 1);
+            const rowSpan = Math.max(1, Number(item['rowSpan']) || 1);
+            return Math.max(max, row + rowSpan);
+        }, 1);
+        const isChart = componentId.includes('chart') || widgetKey.toLowerCase().includes('chart');
+        const colSpan = Math.min(columns, isChart ? Math.max(6, Math.floor(columns / 2)) : columns);
+        items[widgetKey] = {
+            col: 1,
+            row: maxRowEnd,
+            colSpan,
+            rowSpan: isChart ? 5 : 3,
+        };
+        canvas['items'] = items;
+        page['canvas'] = canvas;
+    }
+    uniqueDashboardWidgetKey(page, baseKey) {
+        const keys = new Set(this.dashboardPageWidgets(page).map((widget) => this.dashboardWidgetKey(widget)));
+        if (!keys.has(baseKey)) {
+            return baseKey;
+        }
+        let index = 2;
+        while (keys.has(`${baseKey}-${index}`)) {
+            index += 1;
+        }
+        return `${baseKey}-${index}`;
+    }
+    dashboardRepairResourcePath(contextHints) {
+        return this.readString(contextHints, 'resourcePath')
+            ?? this.readString(this.toJsonObject(this.toJsonObject(contextHints['dashboardQuality'])?.['dto']) ?? {}, 'resourcePath')
+            ?? this.dashboardFirstResourcePath(this.toJsonObject(contextHints['materializedPage']))
+            ?? '/api/resource';
+    }
+    dashboardFirstResourcePath(page) {
+        if (!page) {
+            return null;
+        }
+        for (const widget of this.dashboardPageWidgets(page)) {
+            const resourcePath = this.readString(this.dashboardWidgetInputs(widget), 'resourcePath');
+            if (resourcePath) {
+                return resourcePath;
+            }
+        }
+        return null;
+    }
+    dashboardCategoryField(page) {
+        const preferred = ['departamentoId', 'departamentoNome', 'cargoId', 'cargoNome', 'status', 'ativo'];
+        const fieldIds = this.dashboardPageWidgets(page)
+            .flatMap((widget) => this.arrayFromUnknown(this.dashboardWidgetInputs(widget)['selectedFieldIds']).map((field) => `${field}`));
+        return preferred.find((field) => fieldIds.includes(field))
+            ?? fieldIds.find((field) => !/(^id$|nome|name|email|data|date)/i.test(field))
+            ?? 'status';
+    }
+    humanizeFieldName(field) {
+        return field
+            .replace(/Id$/i, '')
+            .replace(/Nome$/i, '')
+            .replace(/([a-z])([A-Z])/g, '$1 $2')
+            .replace(/[_-]+/g, ' ')
+            .trim()
+            .replace(/^./, (value) => value.toUpperCase());
+    }
+    normalizeText(value) {
+        return value
+            .normalize('NFD')
+            .replace(/[\u0300-\u036f]/g, '')
+            .toLowerCase();
+    }
+    cloneJsonObject(value) {
+        if (!value) {
+            return null;
+        }
+        return JSON.parse(JSON.stringify(value));
+    }
     async buildTurnStreamRequest(request, prompt) {
         const startedAt = Date.now();
         const capabilitiesStartedAt = Date.now();
@@ -14639,13 +15480,14 @@ class PageBuilderAgenticAuthoringTurnFlow {
             };
         }
         const status = this.decorateDashboardReviewStatus(assistantMessage || this.context.describePreviewStatus(preview), intentResolution, preview);
+        const reviewCanApply = this.reviewCanApply(intentResolution, preview);
         return {
             state: 'review',
             phase: 'review',
             assistantMessage: status,
-            quickReplies: this.mergeDashboardQualityQuickReplies(quickReplies, intentResolution, preview),
-            canApply: true,
-            statusText: this.reviewStatusText(status, true),
+            quickReplies: this.reviewQuickReplies(quickReplies, intentResolution, preview),
+            canApply: reviewCanApply,
+            statusText: this.reviewStatusText(status, reviewCanApply),
             errorText: '',
             preview,
             diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
@@ -14713,13 +15555,14 @@ class PageBuilderAgenticAuthoringTurnFlow {
                 };
             }
             const status = this.decorateDashboardReviewStatus(this.context.describePreviewStatus(preview), intentResolution, preview);
+            const reviewCanApply = this.reviewCanApply(intentResolution, preview);
             return {
                 state: 'review',
                 phase: 'review',
                 assistantMessage: status,
-                quickReplies: this.dashboardQualityQuickReplies(intentResolution, preview),
-                canApply: true,
-                statusText: this.reviewStatusText(status, true),
+                quickReplies: this.reviewQuickReplies([], intentResolution, preview),
+                canApply: reviewCanApply,
+                statusText: this.reviewStatusText(status, reviewCanApply),
                 errorText: '',
                 preview,
                 diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
@@ -15014,7 +15857,13 @@ class PageBuilderAgenticAuthoringTurnFlow {
             return true;
         }
         if (componentId === 'praxis-rich-content') {
-            return this.richContentDocumentHasMetrics(this.toJsonObject(inputs['document']));
+            if (this.richContentDocumentHasMetrics(this.toJsonObject(inputs['document']))) {
+                return true;
+            }
+            const serializedDocument = JSON.stringify(inputs['document'] ?? '').toLowerCase();
+            return serializedDocument.includes('statgroup')
+                || serializedDocument.includes('total filtrado')
+                || serializedDocument.includes('leitura executiva');
         }
         return false;
     }
@@ -15068,6 +15917,9 @@ class PageBuilderAgenticAuthoringTurnFlow {
         if (!node) {
             return;
         }
+        if (this.hasDynamicKpiBinding(node)) {
+            return;
+        }
         const value = this.readString(node, 'value')?.trim() ?? '';
         if (!value || value === '-' || value === '--' || value.toLowerCase() === 'n/a') {
             const label = this.readString(node, 'label') ?? this.readString(node, 'id') ?? 'metric';
@@ -15228,6 +16080,24 @@ class PageBuilderAgenticAuthoringTurnFlow {
         const normalized = status.trim();
         return normalized ? `${normalized} ${suffix}` : suffix;
     }
+    dashboardReviewCanApply(intentResolution, preview) {
+        const diagnostics = this.buildDashboardAuthoringDiagnostics(intentResolution, preview);
+        const validation = this.toJsonObject(diagnostics?.['validation']);
+        const warnings = Array.isArray(validation?.['warnings'])
+            ? validation?.['warnings'].map((warning) => `${warning}`)
+            : [];
+        return warnings.length === 0;
+    }
+    reviewCanApply(intentResolution, preview) {
+        return intentResolution.artifactKind === 'dashboard'
+            ? this.dashboardReviewCanApply(intentResolution, preview)
+            : true;
+    }
+    reviewQuickReplies(quickReplies, intentResolution, preview) {
+        return intentResolution.artifactKind === 'dashboard'
+            ? this.mergeDashboardQualityQuickReplies(quickReplies, intentResolution, preview)
+            : [...quickReplies];
+    }
     describeDashboardQualityWarning(code) {
         switch (code) {
             case 'dashboard-without-chart-widget':
@@ -15264,7 +16134,9 @@ class PageBuilderAgenticAuthoringTurnFlow {
         ];
     }
     dashboardQualityQuickReplies(intentResolution, preview) {
-        if (!preview.uiCompositionPlan) {
+        const patch = this.toJsonObject(preview.compiledFormPatch)?.['patch'];
+        const materializedPage = this.toJsonObject(this.toJsonObject(patch)?.['page']);
+        if (!preview.uiCompositionPlan && !this.hasDashboardSnapshotWidgets(materializedPage)) {
             return [];
         }
         const diagnostics = this.buildDashboardAuthoringDiagnostics(intentResolution, preview);
@@ -16069,7 +16941,26 @@ class PageBuilderAgenticAuthoringTurnFlow {
         }
         const actionId = request?.action?.id?.trim();
         if (!actionId) {
-            return null;
+            return this.dashboardQualityActionContextFromPrompt(request);
+        }
+        if (actionId.startsWith('dashboard-quality-')) {
+            const changeKind = this.dashboardQualityChangeKindFromActionId(actionId);
+            if (changeKind) {
+                const currentPage = this.cloneJsonObject(this.toJsonObject(this.context.currentPage()));
+                return {
+                    source: 'dashboard-quality-gate',
+                    kind: 'dashboard-repair-action',
+                    operationKind: 'modify',
+                    artifactKind: 'dashboard',
+                    changeKind,
+                    resourcePath: this.dashboardFirstResourcePath(currentPage) ?? '',
+                    ...(currentPage ? { materializedPage: currentPage } : {}),
+                };
+            }
+        }
+        const dashboardQualityContext = this.dashboardQualityActionContextFromPrompt(request);
+        if (dashboardQualityContext) {
+            return dashboardQualityContext;
         }
         const base = {
             source: 'component-capability-catalog',
@@ -16116,6 +17007,90 @@ class PageBuilderAgenticAuthoringTurnFlow {
         }
         return null;
     }
+    dashboardQualityActionContextFromPrompt(request) {
+        const text = [
+            request?.prompt,
+            typeof request?.action?.value === 'string' ? request.action.value : undefined,
+            request?.action?.displayPrompt,
+        ]
+            .map((value) => value?.trim().toLowerCase())
+            .find((value) => !!value) ?? '';
+        const changeKind = this.dashboardQualityChangeKindFromActionText(text);
+        if (!changeKind) {
+            return null;
+        }
+        const currentPage = this.cloneJsonObject(this.toJsonObject(this.context.currentPage()));
+        if (!currentPage || this.dashboardPageWidgets(currentPage).length === 0) {
+            return null;
+        }
+        return {
+            source: 'dashboard-quality-gate',
+            kind: 'dashboard-repair-action',
+            operationKind: 'modify',
+            artifactKind: 'dashboard',
+            changeKind,
+            resourcePath: this.dashboardFirstResourcePath(currentPage) ?? '',
+            materializedPage: currentPage,
+        };
+    }
+    dashboardQualityChangeKindFromActionId(actionId) {
+        switch (actionId) {
+            case 'dashboard-quality-add-kpis':
+                return 'add_dashboard_kpis';
+            case 'dashboard-quality-bind-kpis':
+                return 'bind_dashboard_kpis';
+            case 'dashboard-quality-add-chart':
+                return 'add_dashboard_chart';
+            case 'dashboard-quality-add-surfaces':
+                return 'add_dashboard_surfaces';
+            case 'dashboard-quality-add-details':
+                return 'add_dashboard_detail_widget';
+            case 'dashboard-quality-connect-widgets':
+                return 'connect_dashboard_widgets';
+            default:
+                return '';
+        }
+    }
+    dashboardQualityChangeKindFromActionText(text) {
+        const normalized = text.trim().toLowerCase();
+        if (normalized.includes('placeholder') && normalized.includes('kpi')) {
+            return 'bind_dashboard_kpis';
+        }
+        if (normalized.includes('surface.open')
+            || (normalized.includes('surface') && (normalized.includes('modal') || normalized.includes('drawer')))
+            || (normalized.includes('drill') && (normalized.includes('modal') || normalized.includes('drawer')))) {
+            return 'add_dashboard_surfaces';
+        }
+        if (normalized.includes('analytical chart')
+            || normalized.includes('most relevant') && normalized.includes('chart')
+            || normalized.includes('grafico') && normalized.includes('analitico')
+            || normalized.includes('gráfico') && normalized.includes('analítico')) {
+            return 'add_dashboard_chart';
+        }
+        switch (normalized) {
+            case 'add kpis':
+            case 'bind kpi values':
+            case 'vincular valores dos kpis':
+                return normalized === 'add kpis' ? 'add_dashboard_kpis' : 'bind_dashboard_kpis';
+            case 'add chart':
+            case 'adicionar grafico':
+            case 'adicionar gráfico':
+                return 'add_dashboard_chart';
+            case 'add surfaces':
+            case 'adicionar surfaces':
+            case 'adicionar superficies':
+            case 'adicionar superfícies':
+                return 'add_dashboard_surfaces';
+            case 'add details':
+            case 'adicionar detalhes':
+                return 'add_dashboard_detail_widget';
+            case 'connect widgets':
+            case 'conectar widgets':
+                return 'connect_dashboard_widgets';
+            default:
+                return '';
+        }
+    }
     contextualActionCandidate(contextHints) {
         const resourcePath = this.readString(contextHints, 'resourcePath');
         if (!resourcePath) {
@@ -16975,6 +17950,7 @@ class DynamicPageBuilderComponent {
     pageLifecycleBusy = false;
     pageLifecycleResetRevision = null;
     pageChange = new EventEmitter();
+    widgetEvent = new EventEmitter();
     pageSaveRequested = new EventEmitter();
     agenticAuthoringApplied = new EventEmitter();
     agenticAuthoringSharedRuleHandoff = new EventEmitter();
@@ -17057,6 +18033,7 @@ class DynamicPageBuilderComponent {
         this.pageChange.emit(cloned);
     }
     onRuntimeWidgetEvent(event) {
+        this.widgetEvent.emit(event);
         if (event.output !== AGENTIC_PAGE_COMPOSITION_REQUEST_OUTPUT) {
             return;
         }
@@ -17152,12 +18129,19 @@ class DynamicPageBuilderComponent {
         this.runtime?.openPageSettings();
     }
     saveCurrentPage() {
+        if (!this.canSaveCurrentPage()) {
+            this.agenticAuthoringStatus.set(this.tx('agentic.status.reviewNeedsAttention', 'Review the pending points before saving.'));
+            return;
+        }
         const runtimeSnapshot = this.runtime?.getPageSnapshot();
         const cloned = this.clonePage(runtimeSnapshot || this.currentPage());
         this.currentPage.set(cloned);
         this.pageChange.emit(cloned);
         this.pageSaveRequested.emit(this.clonePage(cloned));
     }
+    canSaveCurrentPage() {
+        return this.hasPageWidgets() && !this.hasBlockingAgenticReview();
+    }
     applyConfigFromAdapter(config) {
         if (!config.page)
             return;
@@ -17349,6 +18333,9 @@ class DynamicPageBuilderComponent {
         const widgets = this.currentPage().widgets;
         return !Array.isArray(widgets) || widgets.length === 0;
     }
+    hasBlockingAgenticReview() {
+        return !!this.agenticAuthoringPreviewResult()?.valid && !this.agenticAuthoringCanApply();
+    }
     agenticAuthoringSubmitAction() {
         const label = this.tx('agentic.preview', 'Generate preview');
         return {
@@ -18102,11 +19089,34 @@ class DynamicPageBuilderComponent {
             ? contextHints['kind'].trim()
             : '';
         const id = (reply.id || '').trim();
+        const actionText = (reply.label || reply.prompt || '').trim().toLowerCase();
         return source === 'component-capability-catalog'
+            || source === 'dashboard-quality-gate'
+            || kind === 'dashboard-repair-action'
             || kind === 'contextual-preview-action'
+            || id.startsWith('dashboard-quality-')
+            || this.isDashboardQualityQuickReplyText(actionText)
             || id.startsWith('chart-')
             || id.startsWith('table-export-');
     }
+    isDashboardQualityQuickReplyText(text) {
+        const normalized = text.trim().toLowerCase();
+        return normalized === 'add kpis'
+            || normalized === 'bind kpi values'
+            || normalized === 'add chart'
+            || normalized === 'add surfaces'
+            || normalized === 'add details'
+            || normalized === 'connect widgets'
+            || normalized === 'adicionar kpis'
+            || normalized === 'vincular valores dos kpis'
+            || normalized === 'adicionar gráfico'
+            || normalized === 'adicionar grafico'
+            || normalized === 'adicionar surfaces'
+            || normalized === 'adicionar superfícies'
+            || normalized === 'adicionar superficies'
+            || normalized === 'adicionar detalhes'
+            || normalized === 'conectar widgets';
+    }
     isGovernedConfirmationQuickReply(reply, contextHints) {
         return this.isConfirmationQuickReply(reply)
             && this.hasResourceContextHint(contextHints);
@@ -19574,7 +20584,7 @@ class DynamicPageBuilderComponent {
         return resolvePraxisPageBuilderText(this.i18n, key, fallback);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: DynamicPageBuilderComponent, deps: [{ token: i1.MatDialog }, { token: SETTINGS_PANEL_BRIDGE, optional: true }], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: DynamicPageBuilderComponent, isStandalone: true, selector: "praxis-dynamic-page-builder", inputs: { page: "page", context: "context", strictValidation: "strictValidation", autoPersist: "autoPersist", enableCustomization: "enableCustomization", showSettingsButton: "showSettingsButton", pageIdentity: "pageIdentity", componentInstanceId: "componentInstanceId", pageEditorComponent: "pageEditorComponent", enableAgenticAuthoring: "enableAgenticAuthoring", agenticAuthoringProvider: "agenticAuthoringProvider", agenticAuthoringModel: "agenticAuthoringModel", agenticAuthoringApiKey: "agenticAuthoringApiKey", agenticAuthoringComponentId: "agenticAuthoringComponentId", agenticAuthoringScope: "agenticAuthoringScope", agenticAuthoringEtag: "agenticAuthoringEtag", agenticAuthoringIncludeLlmDiagnostics: "agenticAuthoringIncludeLlmDiagnostics", agenticAuthoringEnableStreaming: "agenticAuthoringEnableStreaming", agenticAuthoringContextHints: "agenticAuthoringContextHints", showPageLifecycleActions: "showPageLifecycleActions", canDeleteSavedPage: "canDeleteSavedPage", pageLifecycleBusy: "pageLifecycleBusy", pageLifecycleResetRevision: "pageLifecycleResetRevision" }, outputs: { pageChange: "pageChange", pageSaveRequested: "pageSaveRequested", agenticAuthoringApplied: "agenticAuthoringApplied", agenticAuthoringSharedRuleHandoff: "agenticAuthoringSharedRuleHandoff", pageRestart: "pageRestart", savedPageDeleteRequested: "savedPageDeleteRequested" }, providers: [
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: DynamicPageBuilderComponent, isStandalone: true, selector: "praxis-dynamic-page-builder", inputs: { page: "page", context: "context", strictValidation: "strictValidation", autoPersist: "autoPersist", enableCustomization: "enableCustomization", showSettingsButton: "showSettingsButton", pageIdentity: "pageIdentity", componentInstanceId: "componentInstanceId", pageEditorComponent: "pageEditorComponent", enableAgenticAuthoring: "enableAgenticAuthoring", agenticAuthoringProvider: "agenticAuthoringProvider", agenticAuthoringModel: "agenticAuthoringModel", agenticAuthoringApiKey: "agenticAuthoringApiKey", agenticAuthoringComponentId: "agenticAuthoringComponentId", agenticAuthoringScope: "agenticAuthoringScope", agenticAuthoringEtag: "agenticAuthoringEtag", agenticAuthoringIncludeLlmDiagnostics: "agenticAuthoringIncludeLlmDiagnostics", agenticAuthoringEnableStreaming: "agenticAuthoringEnableStreaming", agenticAuthoringContextHints: "agenticAuthoringContextHints", showPageLifecycleActions: "showPageLifecycleActions", canDeleteSavedPage: "canDeleteSavedPage", pageLifecycleBusy: "pageLifecycleBusy", pageLifecycleResetRevision: "pageLifecycleResetRevision" }, outputs: { pageChange: "pageChange", widgetEvent: "widgetEvent", pageSaveRequested: "pageSaveRequested", agenticAuthoringApplied: "agenticAuthoringApplied", agenticAuthoringSharedRuleHandoff: "agenticAuthoringSharedRuleHandoff", pageRestart: "pageRestart", savedPageDeleteRequested: "savedPageDeleteRequested" }, providers: [
             providePraxisPageBuilderI18n(),
             { provide: DYNAMIC_PAGE_SHELL_EDITOR, useValue: WidgetShellEditorComponent },
         ], viewQueries: [{ propertyName: "runtime", first: true, predicate: ["runtime"], descendants: true }], usesOnChanges: true, ngImport: i0, template: `
@@ -19935,7 +20945,7 @@ class DynamicPageBuilderComponent {
         [visible]="showSettings()"
         [canUndo]="false"
         [canRedo]="false"
-        [showSave]="hasPageWidgets()"
+        [showSave]="canSaveCurrentPage()"
         [showPreview]="hasPageWidgets()"
         (add)="onAddComponent()"
         (settings)="openPageSettings()"
@@ -20376,7 +21386,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
         [visible]="showSettings()"
         [canUndo]="false"
         [canRedo]="false"
-        [showSave]="hasPageWidgets()"
+        [showSave]="canSaveCurrentPage()"
         [showPreview]="hasPageWidgets()"
         (add)="onAddComponent()"
         (settings)="openPageSettings()"
@@ -20500,6 +21510,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                 type: Input
             }], pageChange: [{
                 type: Output
+            }], widgetEvent: [{
+                type: Output
             }], pageSaveRequested: [{
                 type: Output
             }], agenticAuthoringApplied: [{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "8.0.0-beta.92",
+  "version": "8.0.0-beta.93",
   "description": "Page and widget builder utilities for Praxis UI (grid, dynamic widgets, editors).",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -8,9 +8,9 @@
     "@angular/forms": "^21.0.0",
     "@angular/cdk": "^21.0.0",
     "@angular/material": "^21.0.0",
-    "@praxisui/ai": "^8.0.0-beta.92",
-    "@praxisui/core": "^8.0.0-beta.92",
-    "@praxisui/settings-panel": "^8.0.0-beta.92",
+    "@praxisui/ai": "^8.0.0-beta.93",
+    "@praxisui/core": "^8.0.0-beta.93",
+    "@praxisui/settings-panel": "^8.0.0-beta.93",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-page-builder.d.ts

@@ -1,7 +1,7 @@
 import { MatDialogRef, MatDialog } from '@angular/material/dialog';
 import * as _angular_core from '@angular/core';
 import { EventEmitter, OnInit, WritableSignal, InjectionToken, Provider, OnChanges, Type, SimpleChanges } from '@angular/core';
-import { ComponentDocMeta, ComponentMetadataRegistry, WidgetShellConfig, WidgetShellAction, EndpointRef, ComponentPortPathSegment, LinkIntent, CompositionLink, WidgetPageDefinition, TransformKind, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, WidgetPageCanvasLayout, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, ComponentContextPack, ComponentAuthoringManifest, DynamicWidgetPageComponent, SettingsPanelBridge, WidgetEventEnvelope, RichTimelineItem } from '@praxisui/core';
+import { ComponentDocMeta, ComponentMetadataRegistry, WidgetShellConfig, WidgetShellAction, EndpointRef, ComponentPortPathSegment, LinkIntent, CompositionLink, WidgetPageDefinition, TransformKind, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, WidgetPageCanvasLayout, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, ComponentContextPack, ComponentAuthoringManifest, DynamicWidgetPageComponent, WidgetEventEnvelope, SettingsPanelBridge, RichTimelineItem } from '@praxisui/core';
 export { WidgetShellComponent } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
@@ -1670,6 +1670,7 @@ declare class DynamicPageBuilderComponent implements OnChanges {
     pageLifecycleBusy: boolean;
     pageLifecycleResetRevision: number | string | null;
     pageChange: EventEmitter<WidgetPageDefinition>;
+    widgetEvent: EventEmitter<WidgetEventEnvelope>;
     pageSaveRequested: EventEmitter<WidgetPageDefinition>;
     agenticAuthoringApplied: EventEmitter<PageBuilderApplyResult>;
     agenticAuthoringSharedRuleHandoff: EventEmitter<PageBuilderAgenticAuthoringSharedRuleHandoff>;
@@ -1734,6 +1735,7 @@ declare class DynamicPageBuilderComponent implements OnChanges {
     addWidget(selection: string | ComponentPaletteSelection): void;
     openPageSettings(): void;
     saveCurrentPage(): void;
+    canSaveCurrentPage(): boolean;
     applyConfigFromAdapter(config: PageBuilderConfig): void;
     private createAdapterHost;
     toggleAgenticAuthoring(): void;
@@ -1753,6 +1755,7 @@ declare class DynamicPageBuilderComponent implements OnChanges {
     private agenticAuthoringEmptyConversationMessage;
     private resolveAgenticAuthoredOpeningMessage;
     private isAgenticAuthoringPageBlank;
+    private hasBlockingAgenticReview;
     agenticAuthoringSubmitAction(): PraxisAssistantShellAction;
     agenticAuthoringDockIcon(): string;
     agenticAuthoringDockBadge(): string;
@@ -1796,6 +1799,7 @@ declare class DynamicPageBuilderComponent implements OnChanges {
     private agenticQuickReplyGovernedConfirmationPrompt;
     private isResourceQuickReply;
     private isContextualPreviewActionQuickReply;
+    private isDashboardQualityQuickReplyText;
     private isGovernedConfirmationQuickReply;
     private isConfirmationQuickReply;
     private hasResourceContextHint;
@@ -1905,7 +1909,7 @@ declare class DynamicPageBuilderComponent implements OnChanges {
     private cloneValue;
     tx(key: string, fallback: string): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DynamicPageBuilderComponent, [null, { optional: true; }]>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicPageBuilderComponent, "praxis-dynamic-page-builder", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "autoPersist": { "alias": "autoPersist"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showSettingsButton": { "alias": "showSettingsButton"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; "enableAgenticAuthoring": { "alias": "enableAgenticAuthoring"; "required": false; }; "agenticAuthoringProvider": { "alias": "agenticAuthoringProvider"; "required": false; }; "agenticAuthoringModel": { "alias": "agenticAuthoringModel"; "required": false; }; "agenticAuthoringApiKey": { "alias": "agenticAuthoringApiKey"; "required": false; }; "agenticAuthoringComponentId": { "alias": "agenticAuthoringComponentId"; "required": false; }; "agenticAuthoringScope": { "alias": "agenticAuthoringScope"; "required": false; }; "agenticAuthoringEtag": { "alias": "agenticAuthoringEtag"; "required": false; }; "agenticAuthoringIncludeLlmDiagnostics": { "alias": "agenticAuthoringIncludeLlmDiagnostics"; "required": false; }; "agenticAuthoringEnableStreaming": { "alias": "agenticAuthoringEnableStreaming"; "required": false; }; "agenticAuthoringContextHints": { "alias": "agenticAuthoringContextHints"; "required": false; }; "showPageLifecycleActions": { "alias": "showPageLifecycleActions"; "required": false; }; "canDeleteSavedPage": { "alias": "canDeleteSavedPage"; "required": false; }; "pageLifecycleBusy": { "alias": "pageLifecycleBusy"; "required": false; }; "pageLifecycleResetRevision": { "alias": "pageLifecycleResetRevision"; "required": false; }; }, { "pageChange": "pageChange"; "pageSaveRequested": "pageSaveRequested"; "agenticAuthoringApplied": "agenticAuthoringApplied"; "agenticAuthoringSharedRuleHandoff": "agenticAuthoringSharedRuleHandoff"; "pageRestart": "pageRestart"; "savedPageDeleteRequested": "savedPageDeleteRequested"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicPageBuilderComponent, "praxis-dynamic-page-builder", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "autoPersist": { "alias": "autoPersist"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showSettingsButton": { "alias": "showSettingsButton"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; "enableAgenticAuthoring": { "alias": "enableAgenticAuthoring"; "required": false; }; "agenticAuthoringProvider": { "alias": "agenticAuthoringProvider"; "required": false; }; "agenticAuthoringModel": { "alias": "agenticAuthoringModel"; "required": false; }; "agenticAuthoringApiKey": { "alias": "agenticAuthoringApiKey"; "required": false; }; "agenticAuthoringComponentId": { "alias": "agenticAuthoringComponentId"; "required": false; }; "agenticAuthoringScope": { "alias": "agenticAuthoringScope"; "required": false; }; "agenticAuthoringEtag": { "alias": "agenticAuthoringEtag"; "required": false; }; "agenticAuthoringIncludeLlmDiagnostics": { "alias": "agenticAuthoringIncludeLlmDiagnostics"; "required": false; }; "agenticAuthoringEnableStreaming": { "alias": "agenticAuthoringEnableStreaming"; "required": false; }; "agenticAuthoringContextHints": { "alias": "agenticAuthoringContextHints"; "required": false; }; "showPageLifecycleActions": { "alias": "showPageLifecycleActions"; "required": false; }; "canDeleteSavedPage": { "alias": "canDeleteSavedPage"; "required": false; }; "pageLifecycleBusy": { "alias": "pageLifecycleBusy"; "required": false; }; "pageLifecycleResetRevision": { "alias": "pageLifecycleResetRevision"; "required": false; }; }, { "pageChange": "pageChange"; "widgetEvent": "widgetEvent"; "pageSaveRequested": "pageSaveRequested"; "agenticAuthoringApplied": "agenticAuthoringApplied"; "agenticAuthoringSharedRuleHandoff": "agenticAuthoringSharedRuleHandoff"; "pageRestart": "pageRestart"; "savedPageDeleteRequested": "savedPageDeleteRequested"; }, never, never, true, never>;
 }
 
 export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionEditorComponent, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_COMPONENT_CONTEXT_PACK, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, providePageBuilderWidgetAiCatalogs, registerWidgetAiCatalog, registerWidgetAiCatalogs, validateUiCompositionPlan };