@praxisui/page-builder 10.0.0-rc.4 → 10.0.0-rc.6

package/README.md

@@ -523,6 +523,23 @@ Schema-derived table columns already use the canonical `TableConfig.columnProjec
 
 `ComponentDocMeta.insertionPresets` remains the canonical catalog for reusable defaults owned by one component. It is not a page/domain template system: do not publish Employee Operations presets from CRUD, tabs, or related-resource outlet metadata merely to shorten a business recipe.
 
+To streamline host registration of widget providers and component metadata without repetitive manual bootstrap code, `@praxisui/page-builder` exports the `providePraxisPageBuilderWidgets(widgets?: Array<Provider | ComponentDocMeta>)` helper. Hosts can supply a bundle of standard providers or direct `ComponentDocMeta` objects; any `ComponentDocMeta` passed is automatically registered with `ComponentMetadataRegistry` during environment initialization:
+
+```ts
+import { providePraxisPageBuilderWidgets } from '@praxisui/page-builder';
+import { providePraxisListMetadata } from '@praxisui/list';
+import { providePraxisTableMetadata } from '@praxisui/table';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    ...providePraxisPageBuilderWidgets([
+      providePraxisListMetadata(),
+      providePraxisTableMetadata(),
+    ]),
+  ],
+};
+```
+
 For complete governed page templates, the additive `UiCompositionPlanTemplateReference` pins the canonical `ai_registry` key and complete `configJson` SHA-256. The Config Starter resolves the active `SYSTEM/GLOBAL` record, verifies the exact hash, extracts its governed `authoringPlan`, and only then invokes the existing compiler. Angular consumers can use the pure `resolveUiCompositionPlanTemplate` helper only with an explicitly supplied `UiCompositionPlanTemplateMaterialization`; the helper performs no HTTP, search, or implicit selection. The first contract accepts no non-empty overrides, fails closed for missing, inactive, malformed, or stale references, and never persists the unresolved reference. `version` and `etag` are retained as audit evidence, while `configSha256` is the required content pin.
 
 Keep the compact authoring plan, the compiled executable page, and the surrounding recipe metadata as distinct artifacts. `UiCompositionPlan` is the reviewable authoring intent; `WidgetPageDefinition` is the explicit runtime graph; recipe metadata and operational evidence document when and how the example should be used. The server compiler must produce the same executable page as the Page Builder compiler before persistence.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-07T11:07:08.250Z",
+  "generatedAt": "2026-10-12T00:39:17.912Z",
   "packageName": "@praxisui/page-builder",
-  "packageVersion": "10.0.0-rc.4",
+  "packageVersion": "10.0.0-rc.6",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,

package/fesm2022/praxisui-page-builder.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Inject, ChangeDetectionStrategy, Component, EventEmitter, Output, Input, inject, ElementRef, signal, computed, effect, Optional, input, output, Injector, viewChild, afterNextRender, afterEveryRender, ViewChild, InjectionToken, ENVIRONMENT_INITIALIZER, Injectable, isSignal } from '@angular/core';
+import { Inject, ChangeDetectionStrategy, Component, EventEmitter, Output, Input, inject, ElementRef, signal, computed, effect, Optional, input, output, Injector, viewChild, afterNextRender, afterEveryRender, ViewChild, InjectionToken, ENVIRONMENT_INITIALIZER, Injectable, isSignal, ChangeDetectorRef } from '@angular/core';
 import * as i2 from '@angular/material/button';
 import { MatButtonModule } from '@angular/material/button';
 import * as i1 from '@angular/material/dialog';
@@ -7,7 +7,7 @@ import { MAT_DIALOG_DATA, MatDialogModule } from '@angular/material/dialog';
 import * as i2$1 from '@angular/material/icon';
 import { MatIconModule } from '@angular/material/icon';
 import * as i2$2 from '@praxisui/core';
-import { PraxisIconDirective, providePraxisI18n, BUILTIN_WIDGET_SHELL_PRESETS, SETTINGS_EDITOR_SECTIONS_HOSTED, PraxisI18nService, getWidgetShellActionIdError, WidgetShellComponent, SettingsSectionTabsComponent, PraxisIconButtonComponent, GLOBAL_ACTION_CATALOG, ComponentMetadataRegistry, CompositionValidatorService, getGlobalActionCatalog, PRAXIS_GLOBAL_ACTION_CATALOG, SurfaceOpenActionEditorComponent, BUILTIN_PAGE_LAYOUT_PRESETS, resolveWidgetPageLayoutPreset, BUILTIN_PAGE_THEME_PRESETS, prepareCanvasArrangement, SETTINGS_PANEL_DATA as SETTINGS_PANEL_DATA$1, validateCanvasArrangement, PraxisJsonLogicService, NestedWidgetConfigAccessor, canonicalJsonSha256, ResourceDiscoveryService, ComponentRuntimeProfileService, buildApiUrl, deepMerge, generateId, ObservabilityDashboardService, PraxisRuntimeComponentObservationRegistryService, domainKnowledgeTimelineToRichContentDocument, DomainRuleService, DomainKnowledgeService, SETTINGS_PANEL_BRIDGE, DynamicWidgetPageComponent, DYNAMIC_PAGE_SHELL_EDITOR } from '@praxisui/core';
+import { PraxisIconDirective, providePraxisI18n, BUILTIN_WIDGET_SHELL_PRESETS, SETTINGS_EDITOR_SECTIONS_HOSTED, PraxisI18nService, getWidgetShellActionIdError, WidgetShellComponent, SettingsSectionTabsComponent, PraxisIconButtonComponent, GLOBAL_ACTION_CATALOG, ComponentMetadataRegistry, CompositionValidatorService, getGlobalActionCatalog, PRAXIS_GLOBAL_ACTION_CATALOG, SurfaceOpenActionEditorComponent, BUILTIN_PAGE_LAYOUT_PRESETS, resolveWidgetPageLayoutPreset, BUILTIN_PAGE_THEME_PRESETS, prepareCanvasArrangement, SETTINGS_PANEL_DATA as SETTINGS_PANEL_DATA$1, validateCanvasArrangement, PraxisJsonLogicService, NestedWidgetConfigAccessor, canonicalJsonSha256, ResourceDiscoveryService, ComponentRuntimeProfileService, buildApiUrl, deepMerge, generateId, ObservabilityDashboardService, PraxisRuntimeComponentObservationRegistryService, domainKnowledgeTimelineToRichContentDocument, DomainRuleService, DomainKnowledgeService, SETTINGS_PANEL_BRIDGE, DynamicWidgetPageComponent, DYNAMIC_PAGE_SHELL_EDITOR, CONFIG_STORAGE, ASYNC_CONFIG_STORAGE } from '@praxisui/core';
 import * as i3 from '@angular/material/tooltip';
 import { MatTooltipModule } from '@angular/material/tooltip';
 import * as i4 from '@angular/material/form-field';
@@ -32,6 +32,7 @@ import * as i8 from '@angular/material/tabs';
 import { MatTabsModule } from '@angular/material/tabs';
 import { HttpClient, HttpHeaders } from '@angular/common/http';
 import { AgenticAuthoringTurnClientService, withAuthoringScopePolicyContextHints, toPraxisAssistantConversationMessages, PraxisAssistantTurnOrchestratorService, PraxisAssistantSessionRegistryService, createPraxisAssistantViewportLayout, PraxisAiAssistantShellComponent } from '@praxisui/ai';
+import { Router, ActivatedRoute } from '@angular/router';
 
 const PLACEHOLDER = 1;
 
@@ -31328,6 +31329,583 @@ function providePraxisPageBuilderMetadata() {
     };
 }
 
+/**
+ * Type guard that verifies if an item is a canonical ComponentDocMeta.
+ */
+function isComponentDocMeta(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'id' in value &&
+        'selector' in value &&
+        'component' in value);
+}
+/**
+ * Convenient provider factory for registering widgets in the Page Builder host.
+ *
+ * Accepts a list of either Angular `Provider` entries (such as `providePraxisListMetadata()`)
+ * or direct `ComponentDocMeta` definitions (such as `PRAXIS_LIST_COMPONENT_METADATA`).
+ * Any `ComponentDocMeta` passed will be automatically registered with the
+ * `ComponentMetadataRegistry` during environment initialization.
+ */
+function providePraxisPageBuilderWidgets(widgets) {
+    if (!Array.isArray(widgets) || widgets.length === 0) {
+        return [];
+    }
+    const providers = [];
+    for (const item of widgets) {
+        if (isComponentDocMeta(item)) {
+            providers.push({
+                provide: ENVIRONMENT_INITIALIZER,
+                multi: true,
+                useFactory: (registry) => () => {
+                    registry.register(item);
+                },
+                deps: [ComponentMetadataRegistry],
+            });
+        }
+        else if (item) {
+            providers.push(item);
+        }
+    }
+    return providers;
+}
+
+/**
+ * Praxis UI Platform — Zero-Code Canonical Smart Dashboard Page
+ *
+ * Componente governado de página inteira que orquestra automaticamente a experiência
+ * completa de um dashboard corporativo baseado no Praxis Page Builder.
+ *
+ * Suporta nativamente:
+ * - Toolbar executiva de governança e telemetria de layout
+ * - Alternância entre modo de visualização e modo de customização de widgets
+ * - Persistência transparente de layout por persona/usuário (CONFIG_STORAGE / ASYNC_CONFIG_STORAGE)
+ * - Auto-healing entre layout de fábrica e layout salvo
+ * - Restauração segura para layout de fábrica
+ * - Orquestração reativa de eventos de navegação de widgets
+ *
+ * Pode ser utilizado diretamente como alvo de rotas do Angular:
+ * ```typescript
+ * {
+ *   path: '',
+ *   component: PraxisDashboardPage,
+ *   data: {
+ *     pageKey: 'hq-dashboard',
+ *     defaultDefinition: DASHBOARD_PAGE_DEFINITION,
+ *     title: 'HQ TACTICAL OPERATIONAL MATRIX',
+ *     badge: 'Praxis Page Builder · Canvas Governed',
+ *   }
+ * }
+ * ```
+ */
+class PraxisDashboardPage {
+    router = inject(Router, { optional: true });
+    route = inject(ActivatedRoute, { optional: true });
+    configStorage = inject(CONFIG_STORAGE, { optional: true });
+    asyncConfigStorage = inject(ASYNC_CONFIG_STORAGE, { optional: true });
+    cdr = inject(ChangeDetectorRef);
+    /** Chave identificadora do dashboard para fins de persistência (ex: 'hq-dashboard') */
+    pageKey;
+    /** Definição de layout padrão governada de fábrica */
+    defaultDefinition;
+    /** Contexto dinâmico de dados / expressões injetado nos widgets */
+    context;
+    /** Título principal exibido na toolbar de governança */
+    title;
+    /** Subtítulo descritivo */
+    subtitle;
+    /** Texto da badge de governança */
+    badge;
+    /** Habilitar/desabilitar exibição da toolbar superior de governança */
+    showHeader = true;
+    /** Permitir que o usuário acione o modo de customização */
+    enableCustomization;
+    /** Exibir o botão de engrenagem / configurações de widget quando em edição */
+    showSettingsButton;
+    /** Escopar o layout salvo por persona / usuário logado */
+    personaScoped;
+    /** Sobrescrita explícita da chave de armazenamento */
+    storageKey;
+    /** Notificação de alteração no layout da página */
+    pageChange = new EventEmitter();
+    /** Eventos emitidos por ações interativas de widgets */
+    widgetEvent = new EventEmitter();
+    /** Notificação de alteração no status de customização (edição ativa) */
+    customizingChange = new EventEmitter();
+    /** Notificação de layout restaurado para os padrões de fábrica */
+    layoutReset = new EventEmitter();
+    // Sinais de estado interno
+    isCustomizing = signal(false, ...(ngDevMode ? [{ debugName: "isCustomizing" }] : /* istanbul ignore next */ []));
+    isLayoutCustomized = signal(false, ...(ngDevMode ? [{ debugName: "isLayoutCustomized" }] : /* istanbul ignore next */ []));
+    lastSavedAt = signal(null, ...(ngDevMode ? [{ debugName: "lastSavedAt" }] : /* istanbul ignore next */ []));
+    effectivePageDefinition = signal({ widgets: [] }, ...(ngDevMode ? [{ debugName: "effectivePageDefinition" }] : /* istanbul ignore next */ []));
+    // Resolução computada de inputs com fallback para rota Angular
+    effectivePageKey = computed(() => {
+        return this.pageKey || this.route?.snapshot?.data?.['pageKey'] || 'default-dashboard';
+    }, ...(ngDevMode ? [{ debugName: "effectivePageKey" }] : /* istanbul ignore next */ []));
+    effectiveDefaultDefinition = computed(() => {
+        if (this.defaultDefinition)
+            return this.defaultDefinition;
+        const fromRoute = this.route?.snapshot?.data?.['defaultDefinition'];
+        if (fromRoute)
+            return fromRoute;
+        return { widgets: [] };
+    }, ...(ngDevMode ? [{ debugName: "effectiveDefaultDefinition" }] : /* istanbul ignore next */ []));
+    effectiveContext = computed(() => {
+        if (this.context !== undefined)
+            return this.context;
+        return this.route?.snapshot?.data?.['context'] || null;
+    }, ...(ngDevMode ? [{ debugName: "effectiveContext" }] : /* istanbul ignore next */ []));
+    effectiveTitle = computed(() => {
+        return this.title || this.route?.snapshot?.data?.['title'] || 'HQ TACTICAL OPERATIONAL MATRIX';
+    }, ...(ngDevMode ? [{ debugName: "effectiveTitle" }] : /* istanbul ignore next */ []));
+    effectiveBadge = computed(() => {
+        if (this.badge !== undefined)
+            return this.badge;
+        return this.route?.snapshot?.data?.['badge'] ?? 'Praxis Page Builder 10.0 · Canvas Governed';
+    }, ...(ngDevMode ? [{ debugName: "effectiveBadge" }] : /* istanbul ignore next */ []));
+    effectiveEnableCustomization = computed(() => {
+        if (this.enableCustomization !== undefined)
+            return this.enableCustomization;
+        const fromRoute = this.route?.snapshot?.data?.['enableCustomization'];
+        return fromRoute !== undefined ? fromRoute : true;
+    }, ...(ngDevMode ? [{ debugName: "effectiveEnableCustomization" }] : /* istanbul ignore next */ []));
+    effectiveShowSettingsButton = computed(() => {
+        if (this.showSettingsButton !== undefined)
+            return this.showSettingsButton;
+        const fromRoute = this.route?.snapshot?.data?.['showSettingsButton'];
+        return fromRoute !== undefined ? fromRoute : true;
+    }, ...(ngDevMode ? [{ debugName: "effectiveShowSettingsButton" }] : /* istanbul ignore next */ []));
+    effectivePersonaScoped = computed(() => {
+        if (this.personaScoped !== undefined)
+            return this.personaScoped;
+        const fromRoute = this.route?.snapshot?.data?.['personaScoped'];
+        return fromRoute !== undefined ? fromRoute : true;
+    }, ...(ngDevMode ? [{ debugName: "effectivePersonaScoped" }] : /* istanbul ignore next */ []));
+    effectiveStorageKey = computed(() => {
+        if (this.storageKey)
+            return this.storageKey;
+        const fromRoute = this.route?.snapshot?.data?.['storageKey'];
+        if (fromRoute)
+            return fromRoute;
+        return `dynamic-page:${this.effectivePageKey()}`;
+    }, ...(ngDevMode ? [{ debugName: "effectiveStorageKey" }] : /* istanbul ignore next */ []));
+    ngOnInit() {
+        this.effectivePageDefinition.set(this.effectiveDefaultDefinition());
+        this.loadEffectiveLayout();
+        if (typeof window !== 'undefined') {
+            window.addEventListener('praxis:identity-switch', this.onIdentitySwitch);
+            window.PAX_SAVE_DASHBOARD_LAYOUT = (def) => this.onPageChange(def);
+            window.PAX_RELOAD_DASHBOARD_LAYOUT = () => this.loadEffectiveLayout();
+        }
+    }
+    ngOnDestroy() {
+        if (typeof window !== 'undefined') {
+            window.removeEventListener('praxis:identity-switch', this.onIdentitySwitch);
+            delete window.PAX_SAVE_DASHBOARD_LAYOUT;
+            delete window.PAX_RELOAD_DASHBOARD_LAYOUT;
+        }
+    }
+    toggleCustomization() {
+        const nextState = !this.isCustomizing();
+        this.isCustomizing.set(nextState);
+        this.customizingChange.emit(nextState);
+    }
+    resetToFactoryLayout() {
+        const key = this.resolveActiveScopedKey();
+        if (typeof localStorage !== 'undefined') {
+            try {
+                localStorage.removeItem(key);
+            }
+            catch { }
+        }
+        if (this.asyncConfigStorage) {
+            this.asyncConfigStorage.clearConfig(this.effectiveStorageKey()).pipe(take(1)).subscribe({
+                next: () => { },
+                error: () => { },
+            });
+        }
+        const factoryDef = this.effectiveDefaultDefinition();
+        this.effectivePageDefinition.set(factoryDef);
+        this.isLayoutCustomized.set(false);
+        this.lastSavedAt.set(null);
+        this.layoutReset.emit();
+        this.pageChange.emit(factoryDef);
+        this.cdr.markForCheck();
+    }
+    onPageChange(newDef) {
+        if (!newDef?.widgets)
+            return;
+        this.effectivePageDefinition.set(newDef);
+        this.isLayoutCustomized.set(true);
+        const now = new Date();
+        const timeStr = now.toLocaleTimeString('pt-BR', { hour: '2-digit', minute: '2-digit', second: '2-digit' });
+        this.lastSavedAt.set(timeStr);
+        const key = this.resolveActiveScopedKey();
+        if (typeof localStorage !== 'undefined') {
+            try {
+                localStorage.setItem(key, JSON.stringify(newDef));
+            }
+            catch { }
+        }
+        if (this.asyncConfigStorage) {
+            this.asyncConfigStorage.saveConfig(this.effectiveStorageKey(), newDef).pipe(take(1)).subscribe({
+                next: () => { },
+                error: (err) => console.warn('[PraxisDashboardPage] Falha ao persistir layout remoto:', err),
+            });
+        }
+        this.pageChange.emit(newDef);
+        this.cdr.markForCheck();
+    }
+    handleWidgetEvent(envelope) {
+        this.widgetEvent.emit(envelope);
+        // Orquestração automática de navegação se o evento for de navegação
+        const envAny = envelope;
+        const isNavigate = envelope?.output === 'navigate' ||
+            envAny?.['type'] === 'navigate' ||
+            envAny?.['action'] === 'navigate';
+        if (isNavigate) {
+            const payload = envelope.payload;
+            const targetUrl = (payload?.['url'] || payload?.['path'] || payload?.['route']);
+            if (targetUrl && this.router) {
+                this.router.navigateByUrl(targetUrl);
+            }
+        }
+    }
+    onIdentitySwitch = () => {
+        this.isLayoutCustomized.set(false);
+        this.effectivePageDefinition.set(this.effectiveDefaultDefinition());
+        this.loadEffectiveLayout();
+    };
+    resolveActiveScopedKey() {
+        const baseKey = this.effectiveStorageKey();
+        if (!this.effectivePersonaScoped()) {
+            return baseKey;
+        }
+        let personaId = 'default';
+        if (typeof window !== 'undefined') {
+            try {
+                const storedPersona = localStorage.getItem('praxis:auth:current-persona');
+                if (storedPersona) {
+                    const parsed = JSON.parse(storedPersona);
+                    if (parsed?.id)
+                        personaId = parsed.id;
+                }
+                else if (window.__praxis_current_persona_id) {
+                    personaId = window.__praxis_current_persona_id;
+                }
+            }
+            catch { }
+        }
+        return `${baseKey}:${personaId}`;
+    }
+    loadEffectiveLayout() {
+        const scopedKey = this.resolveActiveScopedKey();
+        const factoryDef = this.effectiveDefaultDefinition();
+        // 1. Renderização imediata a partir do cache local da persona
+        let stored = null;
+        if (typeof localStorage !== 'undefined') {
+            try {
+                const raw = localStorage.getItem(scopedKey);
+                if (raw)
+                    stored = JSON.parse(raw);
+            }
+            catch { }
+        }
+        if (stored && stored.widgets && stored.widgets.length > 0) {
+            this.isLayoutCustomized.set(true);
+            this.effectivePageDefinition.set(this.mergeWithFactoryDefaults(stored, factoryDef));
+        }
+        else {
+            this.isLayoutCustomized.set(false);
+            this.effectivePageDefinition.set(factoryDef);
+        }
+        // 2. Sincronização assíncrona com backend (praxis-config-starter)
+        if (this.asyncConfigStorage) {
+            this.asyncConfigStorage
+                .loadConfig(this.effectiveStorageKey())
+                .pipe(take(1))
+                .subscribe({
+                next: (remote) => {
+                    if (remote && remote.widgets && remote.widgets.length > 0) {
+                        this.isLayoutCustomized.set(true);
+                        const healed = this.mergeWithFactoryDefaults(remote, factoryDef);
+                        this.effectivePageDefinition.set(healed);
+                        if (typeof localStorage !== 'undefined') {
+                            try {
+                                localStorage.setItem(scopedKey, JSON.stringify(healed));
+                            }
+                            catch { }
+                        }
+                    }
+                    else {
+                        this.isLayoutCustomized.set(false);
+                        this.effectivePageDefinition.set(factoryDef);
+                        if (typeof localStorage !== 'undefined') {
+                            try {
+                                localStorage.removeItem(scopedKey);
+                            }
+                            catch { }
+                        }
+                    }
+                    this.cdr.markForCheck();
+                },
+                error: (err) => {
+                    console.warn('[PraxisDashboardPage] Não foi possível carregar config remota:', err);
+                },
+            });
+        }
+        this.cdr.markForCheck();
+    }
+    mergeWithFactoryDefaults(stored, factory) {
+        if (!stored?.widgets?.length)
+            return factory;
+        if (!factory?.widgets?.length)
+            return stored;
+        const factoryMap = new Map(factory.widgets.map((w) => [w.key, w]));
+        const mergedWidgets = stored.widgets.map((w) => {
+            const defaultWidget = factoryMap.get(w.key);
+            if (!defaultWidget)
+                return w;
+            const wAny = w;
+            const hasGrid = defaultWidget['grid'] || wAny['grid'];
+            return {
+                ...defaultWidget,
+                ...w,
+                ...(hasGrid ? { grid: { ...(defaultWidget['grid'] || {}), ...(wAny['grid'] || {}) } } : {}),
+            };
+        });
+        // Anexa widgets recém-adicionados na fábrica que a versão customizada ainda não conhecia
+        const storedKeys = new Set(stored.widgets.map((w) => w.key));
+        for (const fw of factory.widgets) {
+            if (!storedKeys.has(fw.key)) {
+                mergedWidgets.push(fw);
+            }
+        }
+        return {
+            ...factory,
+            ...stored,
+            widgets: mergedWidgets,
+        };
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisDashboardPage, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PraxisDashboardPage, isStandalone: true, selector: "praxis-dashboard-page", inputs: { pageKey: "pageKey", defaultDefinition: "defaultDefinition", context: "context", title: "title", subtitle: "subtitle", badge: "badge", showHeader: "showHeader", enableCustomization: "enableCustomization", showSettingsButton: "showSettingsButton", personaScoped: "personaScoped", storageKey: "storageKey" }, outputs: { pageChange: "pageChange", widgetEvent: "widgetEvent", customizingChange: "customizingChange", layoutReset: "layoutReset" }, ngImport: i0, template: `
+    <div class="praxis-dashboard-page dashboard-page-wrapper">
+      <!-- Toolbar de Governança do Dashboard -->
+      @if (showHeader) {
+        <header class="dashboard-toolbar" data-testid="dashboard-governance-toolbar">
+          <div class="toolbar-brand">
+            <div class="status-indicator">
+              <span class="dot-pulse"></span>
+              <span class="status-label">{{ effectiveTitle() }}</span>
+            </div>
+
+            @if (effectiveBadge(); as badgeText) {
+              <span class="governance-badge">
+                <span class="material-symbols-outlined">dashboard_customize</span>
+                {{ badgeText }}
+              </span>
+            }
+
+            <!-- Layout Persistence Status Badge -->
+            @if (isLayoutCustomized()) {
+              <div
+                class="layout-persistence-badge customized"
+                data-testid="dashboard-layout-status"
+                title="Layout customizado persistido para esta persona"
+              >
+                <span class="pulse-indicator-amber"></span>
+                <span>Layout Customizado (Persistido)</span>
+                @if (lastSavedAt(); as saved) {
+                  <span class="saved-time">· salvo às {{ saved }}</span>
+                }
+              </div>
+            } @else {
+              <div
+                class="layout-persistence-badge governed"
+                data-testid="dashboard-layout-status"
+                title="Layout padrão governado de fábrica"
+              >
+                <span class="pulse-indicator-cyan"></span>
+                <span>Layout de Fábrica (Governança)</span>
+              </div>
+            }
+          </div>
+
+          <div class="toolbar-actions">
+            <ng-content select="[dashboard-toolbar-actions]"></ng-content>
+
+            @if (isCustomizing() && isLayoutCustomized()) {
+              <button
+                type="button"
+                class="reset-layout-btn"
+                data-testid="reset-layout-btn"
+                (click)="resetToFactoryLayout()"
+                title="Reverter para o layout padrão de fábrica e descartar customizações desta persona"
+              >
+                <span class="material-symbols-outlined">restart_alt</span>
+                <span>Restaurar Fábrica</span>
+              </button>
+            }
+
+            @if (effectiveEnableCustomization()) {
+              <button
+                type="button"
+                class="customize-toggle-btn"
+                data-testid="toggle-customization-btn"
+                [class.active]="isCustomizing()"
+                (click)="toggleCustomization()"
+                [title]="isCustomizing() ? 'Concluir customização de layout' : 'Alternar modo de customização de layout e widgets'"
+              >
+                <span class="material-symbols-outlined">
+                  {{ isCustomizing() ? 'visibility' : 'dashboard_customize' }}
+                </span>
+                <span>{{ isCustomizing() ? 'Concluir Edição' : 'Customizar Layout' }}</span>
+              </button>
+            }
+          </div>
+        </header>
+      }
+
+      <!-- Canvas Oficial Page Builder -->
+      <main class="dashboard-canvas-container">
+        <praxis-dynamic-page-builder
+          [page]="effectivePageDefinition()"
+          [context]="effectiveContext()"
+          [enableCustomization]="isCustomizing()"
+          [showSettingsButton]="isCustomizing() && effectiveShowSettingsButton()"
+          (pageChange)="onPageChange($event)"
+          (widgetEvent)="handleWidgetEvent($event)"
+        />
+      </main>
+    </div>
+  `, isInline: true, styles: [":host{display:block;width:100%}.praxis-dashboard-page{display:flex;flex-direction:column;gap:16px;max-width:1540px;margin:0 auto;width:100%}.dashboard-toolbar{display:flex;justify-content:space-between;align-items:center;padding:10px 18px;border-radius:14px;background:color-mix(in oklab,var(--card, #161b22) 60%,transparent);backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px);border:1px solid var(--border, rgba(255, 255, 255, .1));gap:16px;flex-wrap:wrap}.toolbar-brand{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.status-indicator{display:inline-flex;align-items:center;gap:8px;padding:3px 10px;border-radius:9999px;background:color-mix(in oklab,var(--ready, #238636) 12%,transparent);border:1px solid color-mix(in oklab,var(--ready, #238636) 28%,transparent);color:var(--ready, #3fb950);font-size:.68rem;font-weight:700;letter-spacing:.08em}.dot-pulse{width:6px;height:6px;border-radius:50%;background-color:var(--ready, #3fb950);box-shadow:0 0 8px var(--ready, #3fb950);animation:praxis-pulse-glow 2s infinite ease-in-out}@keyframes praxis-pulse-glow{0%,to{opacity:1;transform:scale(1)}50%{opacity:.5;transform:scale(.85)}}.governance-badge{display:inline-flex;align-items:center;gap:5px;font-size:.72rem;color:var(--muted-foreground, #8b949e);font-weight:600}.governance-badge span{font-size:15px;color:var(--cobalt, #58a6ff)}.layout-persistence-badge{display:inline-flex;align-items:center;gap:6px;padding:3px 10px;border-radius:9999px;font-size:.7rem;font-weight:600;letter-spacing:.04em}.layout-persistence-badge.customized{background:color-mix(in oklab,var(--warning, #d29922) 15%,transparent);border:1px solid color-mix(in oklab,var(--warning, #d29922) 35%,transparent);color:var(--warning, #e3b341)}.layout-persistence-badge.governed{background:color-mix(in oklab,var(--cobalt, #58a6ff) 12%,transparent);border:1px solid color-mix(in oklab,var(--cobalt, #58a6ff) 30%,transparent);color:var(--cobalt, #58a6ff)}.layout-persistence-badge .saved-time{font-size:.65rem;opacity:.8}.pulse-indicator-amber{width:6px;height:6px;border-radius:50%;background-color:var(--warning, #d29922);box-shadow:0 0 6px var(--warning, #d29922)}.pulse-indicator-cyan{width:6px;height:6px;border-radius:50%;background-color:var(--cobalt, #58a6ff);box-shadow:0 0 6px var(--cobalt, #58a6ff)}.toolbar-actions{display:flex;align-items:center;gap:10px}.reset-layout-btn{display:inline-flex;align-items:center;gap:6px;height:36px;padding:0 14px;border-radius:10px;font-size:.78rem;font-weight:600;cursor:pointer;border:1px solid color-mix(in oklab,var(--destructive, #f85149) 35%,transparent);background:color-mix(in oklab,var(--destructive, #f85149) 10%,transparent);color:var(--destructive, #f85149);transition:all .2s cubic-bezier(.16,1,.3,1)}.reset-layout-btn:hover{background:var(--destructive, #f85149);color:#fff;border-color:var(--destructive, #f85149);transform:translateY(-1px)}.reset-layout-btn span{font-size:16px}.customize-toggle-btn{display:inline-flex;align-items:center;gap:8px;height:36px;padding:0 16px;border-radius:10px;font-size:.8rem;font-weight:600;cursor:pointer;border:1px solid var(--border, rgba(255, 255, 255, .15));background:color-mix(in oklab,var(--card, #161b22) 80%,transparent);color:var(--foreground, #c9d1d9);transition:all .2s cubic-bezier(.16,1,.3,1)}.customize-toggle-btn:hover{border-color:var(--primary, #58a6ff);color:var(--primary, #58a6ff);transform:translateY(-1px)}.customize-toggle-btn.active{background:var(--primary, #1f6feb);color:var(--primary-foreground, #fff);border-color:var(--primary, #1f6feb);box-shadow:0 0 16px color-mix(in oklab,var(--primary, #1f6feb) 40%,transparent)}.customize-toggle-btn span{font-size:18px}.dashboard-canvas-container{width:100%}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "component", type: DynamicPageBuilderComponent, selector: "praxis-dynamic-page-builder", inputs: ["page", "context", "strictValidation", "autoPersist", "enableCustomization", "authoringCapabilities", "showSettingsButton", "pageIdentity", "componentInstanceId", "pageEditorComponent", "componentPaletteAllowedWidgetIds", "componentPaletteAllowedWidgetTags", "componentPaletteAllowedPresetIds", "enableAgenticAuthoring", "agenticAuthoringProvider", "agenticAuthoringModel", "agenticAuthoringApiKey", "agenticAuthoringComponentId", "agenticAuthoringScope", "agenticAuthoringEtag", "agenticAuthoringIncludeLlmDiagnostics", "agenticAuthoringEnableStreaming", "agenticAuthoringVoiceInputMode", "agenticAuthoringContextHints", "authoringDocument", "showPageLifecycleActions", "canDeleteSavedPage", "pageLifecycleBusy", "pageLifecycleResetRevision"], outputs: ["pageChange", "pageAuthoringChange", "widgetEvent", "pageSaveRequested", "agenticAuthoringApplied", "agenticAuthoringSharedRuleHandoff", "pageRestart", "savedPageDeleteRequested"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisDashboardPage, decorators: [{
+            type: Component,
+            args: [{ selector: 'praxis-dashboard-page', standalone: true, imports: [CommonModule, DynamicPageBuilderComponent], changeDetection: ChangeDetectionStrategy.OnPush, template: `
+    <div class="praxis-dashboard-page dashboard-page-wrapper">
+      <!-- Toolbar de Governança do Dashboard -->
+      @if (showHeader) {
+        <header class="dashboard-toolbar" data-testid="dashboard-governance-toolbar">
+          <div class="toolbar-brand">
+            <div class="status-indicator">
+              <span class="dot-pulse"></span>
+              <span class="status-label">{{ effectiveTitle() }}</span>
+            </div>
+
+            @if (effectiveBadge(); as badgeText) {
+              <span class="governance-badge">
+                <span class="material-symbols-outlined">dashboard_customize</span>
+                {{ badgeText }}
+              </span>
+            }
+
+            <!-- Layout Persistence Status Badge -->
+            @if (isLayoutCustomized()) {
+              <div
+                class="layout-persistence-badge customized"
+                data-testid="dashboard-layout-status"
+                title="Layout customizado persistido para esta persona"
+              >
+                <span class="pulse-indicator-amber"></span>
+                <span>Layout Customizado (Persistido)</span>
+                @if (lastSavedAt(); as saved) {
+                  <span class="saved-time">· salvo às {{ saved }}</span>
+                }
+              </div>
+            } @else {
+              <div
+                class="layout-persistence-badge governed"
+                data-testid="dashboard-layout-status"
+                title="Layout padrão governado de fábrica"
+              >
+                <span class="pulse-indicator-cyan"></span>
+                <span>Layout de Fábrica (Governança)</span>
+              </div>
+            }
+          </div>
+
+          <div class="toolbar-actions">
+            <ng-content select="[dashboard-toolbar-actions]"></ng-content>
+
+            @if (isCustomizing() && isLayoutCustomized()) {
+              <button
+                type="button"
+                class="reset-layout-btn"
+                data-testid="reset-layout-btn"
+                (click)="resetToFactoryLayout()"
+                title="Reverter para o layout padrão de fábrica e descartar customizações desta persona"
+              >
+                <span class="material-symbols-outlined">restart_alt</span>
+                <span>Restaurar Fábrica</span>
+              </button>
+            }
+
+            @if (effectiveEnableCustomization()) {
+              <button
+                type="button"
+                class="customize-toggle-btn"
+                data-testid="toggle-customization-btn"
+                [class.active]="isCustomizing()"
+                (click)="toggleCustomization()"
+                [title]="isCustomizing() ? 'Concluir customização de layout' : 'Alternar modo de customização de layout e widgets'"
+              >
+                <span class="material-symbols-outlined">
+                  {{ isCustomizing() ? 'visibility' : 'dashboard_customize' }}
+                </span>
+                <span>{{ isCustomizing() ? 'Concluir Edição' : 'Customizar Layout' }}</span>
+              </button>
+            }
+          </div>
+        </header>
+      }
+
+      <!-- Canvas Oficial Page Builder -->
+      <main class="dashboard-canvas-container">
+        <praxis-dynamic-page-builder
+          [page]="effectivePageDefinition()"
+          [context]="effectiveContext()"
+          [enableCustomization]="isCustomizing()"
+          [showSettingsButton]="isCustomizing() && effectiveShowSettingsButton()"
+          (pageChange)="onPageChange($event)"
+          (widgetEvent)="handleWidgetEvent($event)"
+        />
+      </main>
+    </div>
+  `, styles: [":host{display:block;width:100%}.praxis-dashboard-page{display:flex;flex-direction:column;gap:16px;max-width:1540px;margin:0 auto;width:100%}.dashboard-toolbar{display:flex;justify-content:space-between;align-items:center;padding:10px 18px;border-radius:14px;background:color-mix(in oklab,var(--card, #161b22) 60%,transparent);backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px);border:1px solid var(--border, rgba(255, 255, 255, .1));gap:16px;flex-wrap:wrap}.toolbar-brand{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.status-indicator{display:inline-flex;align-items:center;gap:8px;padding:3px 10px;border-radius:9999px;background:color-mix(in oklab,var(--ready, #238636) 12%,transparent);border:1px solid color-mix(in oklab,var(--ready, #238636) 28%,transparent);color:var(--ready, #3fb950);font-size:.68rem;font-weight:700;letter-spacing:.08em}.dot-pulse{width:6px;height:6px;border-radius:50%;background-color:var(--ready, #3fb950);box-shadow:0 0 8px var(--ready, #3fb950);animation:praxis-pulse-glow 2s infinite ease-in-out}@keyframes praxis-pulse-glow{0%,to{opacity:1;transform:scale(1)}50%{opacity:.5;transform:scale(.85)}}.governance-badge{display:inline-flex;align-items:center;gap:5px;font-size:.72rem;color:var(--muted-foreground, #8b949e);font-weight:600}.governance-badge span{font-size:15px;color:var(--cobalt, #58a6ff)}.layout-persistence-badge{display:inline-flex;align-items:center;gap:6px;padding:3px 10px;border-radius:9999px;font-size:.7rem;font-weight:600;letter-spacing:.04em}.layout-persistence-badge.customized{background:color-mix(in oklab,var(--warning, #d29922) 15%,transparent);border:1px solid color-mix(in oklab,var(--warning, #d29922) 35%,transparent);color:var(--warning, #e3b341)}.layout-persistence-badge.governed{background:color-mix(in oklab,var(--cobalt, #58a6ff) 12%,transparent);border:1px solid color-mix(in oklab,var(--cobalt, #58a6ff) 30%,transparent);color:var(--cobalt, #58a6ff)}.layout-persistence-badge .saved-time{font-size:.65rem;opacity:.8}.pulse-indicator-amber{width:6px;height:6px;border-radius:50%;background-color:var(--warning, #d29922);box-shadow:0 0 6px var(--warning, #d29922)}.pulse-indicator-cyan{width:6px;height:6px;border-radius:50%;background-color:var(--cobalt, #58a6ff);box-shadow:0 0 6px var(--cobalt, #58a6ff)}.toolbar-actions{display:flex;align-items:center;gap:10px}.reset-layout-btn{display:inline-flex;align-items:center;gap:6px;height:36px;padding:0 14px;border-radius:10px;font-size:.78rem;font-weight:600;cursor:pointer;border:1px solid color-mix(in oklab,var(--destructive, #f85149) 35%,transparent);background:color-mix(in oklab,var(--destructive, #f85149) 10%,transparent);color:var(--destructive, #f85149);transition:all .2s cubic-bezier(.16,1,.3,1)}.reset-layout-btn:hover{background:var(--destructive, #f85149);color:#fff;border-color:var(--destructive, #f85149);transform:translateY(-1px)}.reset-layout-btn span{font-size:16px}.customize-toggle-btn{display:inline-flex;align-items:center;gap:8px;height:36px;padding:0 16px;border-radius:10px;font-size:.8rem;font-weight:600;cursor:pointer;border:1px solid var(--border, rgba(255, 255, 255, .15));background:color-mix(in oklab,var(--card, #161b22) 80%,transparent);color:var(--foreground, #c9d1d9);transition:all .2s cubic-bezier(.16,1,.3,1)}.customize-toggle-btn:hover{border-color:var(--primary, #58a6ff);color:var(--primary, #58a6ff);transform:translateY(-1px)}.customize-toggle-btn.active{background:var(--primary, #1f6feb);color:var(--primary-foreground, #fff);border-color:var(--primary, #1f6feb);box-shadow:0 0 16px color-mix(in oklab,var(--primary, #1f6feb) 40%,transparent)}.customize-toggle-btn span{font-size:18px}.dashboard-canvas-container{width:100%}\n"] }]
+        }], propDecorators: { pageKey: [{
+                type: Input
+            }], defaultDefinition: [{
+                type: Input
+            }], context: [{
+                type: Input
+            }], title: [{
+                type: Input
+            }], subtitle: [{
+                type: Input
+            }], badge: [{
+                type: Input
+            }], showHeader: [{
+                type: Input
+            }], enableCustomization: [{
+                type: Input
+            }], showSettingsButton: [{
+                type: Input
+            }], personaScoped: [{
+                type: Input
+            }], storageKey: [{
+                type: Input
+            }], pageChange: [{
+                type: Output
+            }], widgetEvent: [{
+                type: Output
+            }], customizingChange: [{
+                type: Output
+            }], layoutReset: [{
+                type: Output
+            }] } });
+
 /*
  * Public API Surface of @praxisui/page-builder
  */
@@ -31337,4 +31915,4 @@ function providePraxisPageBuilderMetadata() {
  * Generated bundle index. Do not edit.
  */
 
-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, PRAXIS_PAGE_BUILDER_COMPONENT_METADATA, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, UiCompositionResourcePreflightService, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, preflightUiCompositionPlan, preflightUiCompositionPlanResources, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan, verifyUiCompositionAuthoringSource };
+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, PRAXIS_PAGE_BUILDER_COMPONENT_METADATA, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, PraxisDashboardPage, TileToolbarComponent, UiCompositionResourcePreflightService, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, isComponentDocMeta, preflightUiCompositionPlan, preflightUiCompositionPlanResources, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, providePraxisPageBuilderWidgets, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan, verifyUiCompositionAuthoringSource };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "10.0.0-rc.4",
+  "version": "10.0.0-rc.6",
   "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": "^10.0.0-rc.4",
-    "@praxisui/core": "^10.0.0-rc.4",
-    "@praxisui/settings-panel": "^10.0.0-rc.4",
+    "@praxisui/ai": "^10.0.0-rc.6",
+    "@praxisui/core": "^10.0.0-rc.6",
+    "@praxisui/settings-panel": "^10.0.0-rc.6",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

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

@@ -1186,6 +1186,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
         key: string;
         number: number;
         label: string;
+        widgetKey?: string;
         col: number;
         row: number;
         colSpan: number;
@@ -2153,7 +2154,7 @@ type BuilderCanvasLayout = {
     rowUnit?: string;
     gap?: string;
     autoRows?: 'fixed' | 'content';
-    collisionPolicy?: 'block' | 'swap';
+    collisionPolicy?: 'block' | 'swap' | 'push-down';
     items: Record<string, BuilderCanvasItem>;
 };
 type BuilderPageDefinition = Omit<WidgetPageDefinition, 'widgets'> & {
@@ -2726,5 +2727,110 @@ declare const PRAXIS_PAGE_BUILDER_COMPONENT_METADATA: ComponentDocMeta;
 /** Provider para auto-registrar metadados do componente Page Builder. */
 declare function providePraxisPageBuilderMetadata(): Provider;
 
-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, PRAXIS_PAGE_BUILDER_COMPONENT_METADATA, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, UiCompositionResourcePreflightService, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, preflightUiCompositionPlan, preflightUiCompositionPlanResources, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan, verifyUiCompositionAuthoringSource };
+/**
+ * Type guard that verifies if an item is a canonical ComponentDocMeta.
+ */
+declare function isComponentDocMeta(value: unknown): value is ComponentDocMeta;
+/**
+ * Convenient provider factory for registering widgets in the Page Builder host.
+ *
+ * Accepts a list of either Angular `Provider` entries (such as `providePraxisListMetadata()`)
+ * or direct `ComponentDocMeta` definitions (such as `PRAXIS_LIST_COMPONENT_METADATA`).
+ * Any `ComponentDocMeta` passed will be automatically registered with the
+ * `ComponentMetadataRegistry` during environment initialization.
+ */
+declare function providePraxisPageBuilderWidgets(widgets?: Array<Provider | ComponentDocMeta>): Provider[];
+
+/**
+ * Praxis UI Platform — Zero-Code Canonical Smart Dashboard Page
+ *
+ * Componente governado de página inteira que orquestra automaticamente a experiência
+ * completa de um dashboard corporativo baseado no Praxis Page Builder.
+ *
+ * Suporta nativamente:
+ * - Toolbar executiva de governança e telemetria de layout
+ * - Alternância entre modo de visualização e modo de customização de widgets
+ * - Persistência transparente de layout por persona/usuário (CONFIG_STORAGE / ASYNC_CONFIG_STORAGE)
+ * - Auto-healing entre layout de fábrica e layout salvo
+ * - Restauração segura para layout de fábrica
+ * - Orquestração reativa de eventos de navegação de widgets
+ *
+ * Pode ser utilizado diretamente como alvo de rotas do Angular:
+ * ```typescript
+ * {
+ *   path: '',
+ *   component: PraxisDashboardPage,
+ *   data: {
+ *     pageKey: 'hq-dashboard',
+ *     defaultDefinition: DASHBOARD_PAGE_DEFINITION,
+ *     title: 'HQ TACTICAL OPERATIONAL MATRIX',
+ *     badge: 'Praxis Page Builder · Canvas Governed',
+ *   }
+ * }
+ * ```
+ */
+declare class PraxisDashboardPage implements OnInit, OnDestroy {
+    private readonly router;
+    private readonly route;
+    private readonly configStorage;
+    private readonly asyncConfigStorage;
+    private readonly cdr;
+    /** Chave identificadora do dashboard para fins de persistência (ex: 'hq-dashboard') */
+    pageKey?: string;
+    /** Definição de layout padrão governada de fábrica */
+    defaultDefinition?: WidgetPageDefinition;
+    /** Contexto dinâmico de dados / expressões injetado nos widgets */
+    context?: Record<string, unknown> | null;
+    /** Título principal exibido na toolbar de governança */
+    title?: string;
+    /** Subtítulo descritivo */
+    subtitle?: string;
+    /** Texto da badge de governança */
+    badge?: string;
+    /** Habilitar/desabilitar exibição da toolbar superior de governança */
+    showHeader: boolean;
+    /** Permitir que o usuário acione o modo de customização */
+    enableCustomization?: boolean;
+    /** Exibir o botão de engrenagem / configurações de widget quando em edição */
+    showSettingsButton?: boolean;
+    /** Escopar o layout salvo por persona / usuário logado */
+    personaScoped?: boolean;
+    /** Sobrescrita explícita da chave de armazenamento */
+    storageKey?: string;
+    /** Notificação de alteração no layout da página */
+    readonly pageChange: EventEmitter<WidgetPageDefinition>;
+    /** Eventos emitidos por ações interativas de widgets */
+    readonly widgetEvent: EventEmitter<WidgetEventEnvelope>;
+    /** Notificação de alteração no status de customização (edição ativa) */
+    readonly customizingChange: EventEmitter<boolean>;
+    /** Notificação de layout restaurado para os padrões de fábrica */
+    readonly layoutReset: EventEmitter<void>;
+    readonly isCustomizing: _angular_core.WritableSignal<boolean>;
+    readonly isLayoutCustomized: _angular_core.WritableSignal<boolean>;
+    readonly lastSavedAt: _angular_core.WritableSignal<string | null>;
+    readonly effectivePageDefinition: _angular_core.WritableSignal<WidgetPageDefinition>;
+    readonly effectivePageKey: _angular_core.Signal<string>;
+    readonly effectiveDefaultDefinition: _angular_core.Signal<WidgetPageDefinition>;
+    readonly effectiveContext: _angular_core.Signal<Record<string, unknown> | null>;
+    readonly effectiveTitle: _angular_core.Signal<string>;
+    readonly effectiveBadge: _angular_core.Signal<string>;
+    readonly effectiveEnableCustomization: _angular_core.Signal<boolean>;
+    readonly effectiveShowSettingsButton: _angular_core.Signal<boolean>;
+    readonly effectivePersonaScoped: _angular_core.Signal<boolean>;
+    readonly effectiveStorageKey: _angular_core.Signal<string>;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    toggleCustomization(): void;
+    resetToFactoryLayout(): void;
+    onPageChange(newDef: WidgetPageDefinition): void;
+    handleWidgetEvent(envelope: WidgetEventEnvelope): void;
+    private readonly onIdentitySwitch;
+    private resolveActiveScopedKey;
+    private loadEffectiveLayout;
+    private mergeWithFactoryDefaults;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PraxisDashboardPage, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisDashboardPage, "praxis-dashboard-page", never, { "pageKey": { "alias": "pageKey"; "required": false; }; "defaultDefinition": { "alias": "defaultDefinition"; "required": false; }; "context": { "alias": "context"; "required": false; }; "title": { "alias": "title"; "required": false; }; "subtitle": { "alias": "subtitle"; "required": false; }; "badge": { "alias": "badge"; "required": false; }; "showHeader": { "alias": "showHeader"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showSettingsButton": { "alias": "showSettingsButton"; "required": false; }; "personaScoped": { "alias": "personaScoped"; "required": false; }; "storageKey": { "alias": "storageKey"; "required": false; }; }, { "pageChange": "pageChange"; "widgetEvent": "widgetEvent"; "customizingChange": "customizingChange"; "layoutReset": "layoutReset"; }, never, ["[dashboard-toolbar-actions]"], 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, PRAXIS_PAGE_BUILDER_COMPONENT_METADATA, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, PraxisDashboardPage, TileToolbarComponent, UiCompositionResourcePreflightService, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, isComponentDocMeta, preflightUiCompositionPlan, preflightUiCompositionPlanResources, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, providePraxisPageBuilderWidgets, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan, verifyUiCompositionAuthoringSource };
 export type { Capability, CapabilityCatalog, CapabilityCategory, ComponentPaletteData, ComponentPaletteSelection, ConfirmDialogData, PageBuilderAgenticAuthoringAttachmentSummary, PageBuilderAgenticAuthoringCandidate, PageBuilderAgenticAuthoringComponentCapabilitiesResult, PageBuilderAgenticAuthoringComponentCapability, PageBuilderAgenticAuthoringComponentCapabilityCatalog, PageBuilderAgenticAuthoringComponentCapabilityExample, PageBuilderAgenticAuthoringComponentFieldAlias, PageBuilderAgenticAuthoringConversationMessage, PageBuilderAgenticAuthoringGateResult, PageBuilderAgenticAuthoringIntentResolutionRequest, PageBuilderAgenticAuthoringIntentResolutionResult, PageBuilderAgenticAuthoringOptions, PageBuilderAgenticAuthoringPendingClarification, PageBuilderAgenticAuthoringPromptRequest, PageBuilderAgenticAuthoringProvider, PageBuilderAgenticAuthoringQuickReply, PageBuilderAgenticAuthoringResourceCandidatesRequest, PageBuilderAgenticAuthoringResourceCandidatesResult, PageBuilderAgenticAuthoringSharedRuleHandoff, PageBuilderAgenticAuthoringTarget, PageBuilderAgenticAuthoringTurnStreamConnectionError, PageBuilderAgenticAuthoringTurnStreamEvent, PageBuilderAgenticAuthoringTurnStreamRequest, PageBuilderAgenticAuthoringTurnStreamStartResponse, PageBuilderApplyRequest, PageBuilderApplyResult, PageBuilderAuthoringCapabilities, PageBuilderCompiledFormPatch, PageBuilderMinimalFormPlanResult, PageBuilderPreviewDiagnostics, PageBuilderPreviewResult, PageBuilderProjectKnowledgeAudit, UiCompositionAuthoringSourceDiagnostic, UiCompositionAuthoringSourceDiagnosticCode, UiCompositionAuthoringSourceVerification, UiCompositionAuthoringSourceVerificationContext, UiCompositionPlan, UiCompositionPlanAuthoringInput, UiCompositionPlanAuthoringSource, UiCompositionPlanBinding, UiCompositionPlanCompileResult, UiCompositionPlanComponentPortEndpoint, UiCompositionPlanContextScope, UiCompositionPlanContextScopeTarget, UiCompositionPlanContextValue, UiCompositionPlanDiagnostic, UiCompositionPlanEndpoint, UiCompositionPlanGlobalActionEndpoint, UiCompositionPlanGlobalActionSourceEndpoint, UiCompositionPlanInputSource, UiCompositionPlanPreflightResult, UiCompositionPlanSelectCase, UiCompositionPlanSelectionSync, UiCompositionPlanSelectionSyncMapping, UiCompositionPlanSourceEndpoint, UiCompositionPlanStateEndpoint, UiCompositionPlanTargetEndpoint, UiCompositionPlanTemplateMaterialization, UiCompositionPlanTemplateRef, UiCompositionPlanTemplateReference, UiCompositionPlanTemplateResolutionResult, UiCompositionPlanTemplateRevision, UiCompositionPlanTransform, UiCompositionPlanTransformOutput, UiCompositionPlanWidget, UiCompositionResourceSchemaRequest, UiCompositionResourceSchemaResolution, UiCompositionResourceSchemaResolver, ValueKind };