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

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

@@ -2,7 +2,7 @@ import { MatDialogRef, MatDialog } from '@angular/material/dialog';
 import * as _angular_core from '@angular/core';
 import { EventEmitter, OnInit, WritableSignal, InjectionToken, Provider, OnChanges, OnDestroy, Type, SimpleChanges } from '@angular/core';
 import * as _praxisui_core from '@praxisui/core';
-import { ComponentDocMeta, WidgetShellConfig, ComponentMetadataRegistry, PraxisI18nService, SettingsEditorSection, EndpointRef, PraxisTextValue, WidgetShellPresetCategory, CompositionLink, WidgetShellAction, WidgetPageAuthoringCapabilities, PortContract, ComponentPortPathSegment, LinkIntent, WidgetPageDefinition, SurfaceOpenActionEditorComponent, TransformKind, TransformPipeline, SurfaceOpenPayload, WidgetPageDeviceKind, SettingsValueProvider as SettingsValueProvider$1, WidgetShellPresetDefinition, WidgetPageCanvasLayout, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, TransformOutputHint, TransformSemanticKind, ConfigAuthoringSource, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, PraxisRuntimeComponentObservationEnvelope, ComponentContextPack, ComponentAuthoringManifest, DiagnosticRecord, NestedPortCatalogRegistry, CompositionValidatorService, ApiUrlEntry, DynamicWidgetPageComponent, ConfigDocument, WidgetEventEnvelope, ObservabilityAgenticTurnMetrics, SettingsPanelBridge, ObservabilityAgenticTurnMetricBucket, RichTimelineItem } from '@praxisui/core';
+import { ComponentDocMeta, WidgetShellConfig, ComponentMetadataRegistry, PraxisI18nService, SettingsEditorSection, EndpointRef, PraxisTextValue, WidgetShellPresetCategory, CompositionLink, WidgetShellAction, WidgetPageAuthoringCapabilities, PortContract, ComponentPortPathSegment, LinkIntent, WidgetPageDefinition, SurfaceOpenActionEditorComponent, TransformKind, TransformPipeline, SurfaceOpenPayload, WidgetPageDeviceKind, SettingsValueProvider as SettingsValueProvider$1, WidgetShellPresetDefinition, WidgetPageCanvasLayout, DiscoveredResourceOption, FieldDefinition, WidgetPageGroupingDefinition, WidgetPageDataSourceDefinition, WidgetPageDataSourceKind, WidgetPageDataSourceMethod, WidgetPageDataSourceErrorPolicy, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, TransformOutputHint, TransformSemanticKind, ConfigAuthoringSource, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, PraxisRuntimeComponentObservationEnvelope, ComponentContextPack, ComponentAuthoringManifest, DiagnosticRecord, NestedPortCatalogRegistry, CompositionValidatorService, ApiUrlEntry, DynamicWidgetPageComponent, ConfigDocument, WidgetPagePersistenceState, WidgetEventEnvelope, ObservabilityAgenticTurnMetrics, SettingsPanelBridge, ObservabilityAgenticTurnMetricBucket, RichTimelineItem, PageAuthoringDocument, UiLayoutLayerClass, UiLayoutAssignmentSelector, PageDocumentDiagnostic, PageSourceReference, UiLayoutPageChildSource, UiLayoutTarget, PageCatalogEntry, NavigationGroupsAuthoringDocument, RuntimeNavigationMenuNode, PageCreationCommand, UiLayoutLifecycleHttpReceipt, PageCreationReceipt, PageCatalogReadOptions, PageCatalogResponse, UiLayoutLifecycleNotModifiedReceipt, PublishedPageReadResponse, UiLayoutDraftReceipt, UiLayoutDraftWorkspaceReceipt, UiLayoutReleaseReviewReceipt, UiLayoutReleaseHeadReceipt, UiLayoutRevisionCommand, UiLayoutRevisionCommandResult, UiLayoutAssignmentCommand, UiLayoutAssignmentCommandResult, UiLayoutFreezeReleaseCommand, UiLayoutFreezeReleaseCommandResult, UiLayoutReasonCommand, UiLayoutHeadWriteCondition, UiLayoutReleaseReferenceCommand, GovernedPagePreviewMaterialization, PageChildDocumentValidators, GovernedPagePreviewWidgetAdapters, UiLayoutLifecycleService, NavigationGroupAuthoringEntry, EffectiveUiLayoutService, PageNavigationBinding, PageNavigationBindingUpdateOptions } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
 import { FormGroup, FormControl, FormArray, AbstractControl } from '@angular/forms';
@@ -66,23 +66,58 @@ declare class FloatingToolbarComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<FloatingToolbarComponent, "praxis-floating-toolbar", never, { "visible": { "alias": "visible"; "required": false; }; "canUndo": { "alias": "canUndo"; "required": false; }; "canRedo": { "alias": "canRedo"; "required": false; }; "showSave": { "alias": "showSave"; "required": false; }; "showPreview": { "alias": "showPreview"; "required": false; }; "showAdd": { "alias": "showAdd"; "required": false; }; "showSettings": { "alias": "showSettings"; "required": false; }; "editingEnabled": { "alias": "editingEnabled"; "required": false; }; "previewActive": { "alias": "previewActive"; "required": false; }; "connectionMode": { "alias": "connectionMode"; "required": false; }; "modeLabel": { "alias": "modeLabel"; "required": false; }; "addLabel": { "alias": "addLabel"; "required": false; }; "saveLabel": { "alias": "saveLabel"; "required": false; }; "undoLabel": { "alias": "undoLabel"; "required": false; }; "redoLabel": { "alias": "redoLabel"; "required": false; }; "settingsLabel": { "alias": "settingsLabel"; "required": false; }; "previewLabel": { "alias": "previewLabel"; "required": false; }; "exitPreviewLabel": { "alias": "exitPreviewLabel"; "required": false; }; }, { "add": "add"; "undo": "undo"; "redo": "redo"; "settings": "settings"; "preview": "preview"; "save": "save"; }, never, ["[pdx-toolbar-extra]"], true, never>;
 }
 
+/**
+ * Canonical payload emitted when a component or preset is selected from the Page Builder palette.
+ */
 interface ComponentPaletteSelection {
     componentId: string;
     presetId?: string;
     inputs?: Record<string, unknown>;
     shell?: WidgetShellConfig;
+    colSpan?: number;
+}
+/**
+ * Staged item inside the batch composition tray with live grid coordinate simulation.
+ */
+interface QueuedPaletteItem {
+    queueId: string;
+    entryKey: string;
+    title: string;
+    icon: string;
+    selection: ComponentPaletteSelection;
+    effectiveCols: number;
+    effectiveRows: number;
+    rowPreview: number;
+    colStartPreview: number;
+    colEndPreview: number;
+}
+interface PaletteExistingCanvasItem {
+    row: number;
+    col: number;
+    colSpan: number;
+    rowSpan: number;
 }
+/**
+ * Dialog input contract for `ComponentPaletteDialogComponent`.
+ * Supports single insertion, continuous (`keepOpen`) insertion, and atomic batch (`onInsertBatch`) composition.
+ */
 interface ComponentPaletteData {
     title?: string;
     allowedWidgetIds?: string[];
     allowedWidgetTags?: string[];
     allowedPresetIds?: string[];
     predicate?: (m: ComponentDocMeta) => boolean;
+    canvasColumns?: number;
+    existingCanvasItems?: PaletteExistingCanvasItem[];
+    onInsert?: (selection: ComponentPaletteSelection) => void;
+    onInsertBatch?: (selections: ComponentPaletteSelection[]) => void;
 }
+type PaletteCategory = 'all' | 'widget' | 'preset' | 'field';
 interface ComponentPaletteEntry {
     key: string;
     componentId: string;
     presetId?: string;
+    category: Exclude<PaletteCategory, 'all'>;
     title: string;
     description: string;
     icon: string;
@@ -97,21 +132,67 @@ interface ComponentPaletteBadge {
     tone: 'ready' | 'info' | 'warning' | 'neutral';
     description: string;
 }
+/**
+ * Studio Component Palette Dialog for the Praxis Page Builder.
+ *
+ * Provides three enterprise authoring modes:
+ * 1. **Single Insertion**: Immediate selection and dialog dismissal (`Enter` or card click).
+ * 2. **Continuous Multi-Insert (`keepOpen`)**: Inserts directly onto the canvas without closing the dialog.
+ * 3. **Batch Staging (`batchMode`)**: Stages multiple components with live grid coordinate preview (`L·C`)
+ *    and commits them atomically via `onInsertBatch`.
+ *
+ * Automatically prioritizes governed page-level widgets and presets ahead of primitive form field controls
+ * and exposes quick category filter pills for large enterprise catalogs.
+ */
 declare class ComponentPaletteDialogComponent implements OnInit {
     private dialogRef;
     private registry;
     private i18n;
     data?: ComponentPaletteData | undefined;
     private readonly hostElement;
+    private queueSeq;
     query: _angular_core.WritableSignal<string>;
+    readonly selectedCategory: _angular_core.WritableSignal<PaletteCategory>;
+    readonly selectedColSpan: _angular_core.WritableSignal<number | undefined>;
+    readonly batchMode: _angular_core.WritableSignal<boolean>;
+    readonly keepOpen: _angular_core.WritableSignal<boolean>;
+    readonly insertedCount: _angular_core.WritableSignal<number>;
+    readonly queuedItems: _angular_core.WritableSignal<QueuedPaletteItem[]>;
+    readonly canvasColumns: _angular_core.Signal<number>;
+    readonly stagedRowCount: _angular_core.Signal<number>;
+    readonly spanOptions: _angular_core.Signal<readonly {
+        label: string;
+        value: number | undefined;
+    }[]>;
+    private readonly cycleSpans;
     private all;
+    private allowedCatalog;
+    readonly categoryOptions: _angular_core.Signal<readonly {
+        id: PaletteCategory;
+        label: string;
+        count: number;
+    }[]>;
+    readonly hasMultipleCategories: _angular_core.Signal<boolean>;
     filtered: _angular_core.Signal<ComponentPaletteEntry[]>;
     density: _angular_core.Signal<"roomy" | "dense" | "normal">;
     constructor(dialogRef: MatDialogRef<ComponentPaletteDialogComponent, ComponentPaletteSelection>, registry: ComponentMetadataRegistry, i18n: PraxisI18nService, data?: ComponentPaletteData | undefined);
     ngOnInit(): void;
+    toggleBatchMode(): void;
+    toggleKeepOpen(): void;
+    private buildPayload;
+    private resolveEffectiveCols;
+    private resolveEffectiveRows;
+    private recomputeQueueCoordinates;
+    enqueue(entry: ComponentPaletteEntry, event?: Event): void;
+    cycleQueuedItemColSpan(queueId: string): void;
+    removeQueuedItem(queueId: string): void;
+    clearQueue(): void;
+    commitBatch(): void;
     select(entry: ComponentPaletteEntry): void;
     handleSearchKeydown(event: KeyboardEvent): void;
-    handleCardKeydown(event: KeyboardEvent, index: number): void;
+    clearSearch(): void;
+    resetFilters(): void;
+    handleCardKeydown(event: KeyboardEvent, index: number, entry?: ComponentPaletteEntry): void;
     trackById: (_: number, entry: ComponentPaletteEntry) => string;
     getPreview(entry: ComponentPaletteEntry): string;
     tx(key: string, fallback: string): string;
@@ -119,7 +200,9 @@ declare class ComponentPaletteDialogComponent implements OnInit {
     private paletteCards;
     private searchInput;
     private _adjustSizeEffect;
+    private applyStructuralConstraints;
     private applyFilters;
+    private isFieldMetadata;
     private buildEntries;
     private buildBadges;
     private buildBadgeSearchText;
@@ -214,6 +297,7 @@ declare class WidgetShellEditorComponent implements SettingsValueProvider {
         cardBorderStyle: FormControl<string>;
         cardRadius: FormControl<string>;
         cardShadow: FormControl<string>;
+        interactionHighlight: FormControl<"" | "standard" | "gradient">;
         cardFilter: FormControl<string>;
         cardFallbackBg: FormControl<string>;
         headerBg: FormControl<string>;
@@ -344,7 +428,7 @@ interface ConnectionEditorNode {
     states: ConnectionEditorPort[];
 }
 type ConnectionEditorDiagnosticSeverity = 'error' | 'warning';
-type ConnectionEditorDiagnosticCode = 'endpoint-widget-missing' | 'endpoint-unresolved' | 'endpoint-not-declared' | 'nested-path-terminal-missing' | 'nested-path-not-declared' | 'state-path-not-declared' | 'feedback-cycle-unguarded' | 'feedback-cycle-guarded';
+type ConnectionEditorDiagnosticCode = 'endpoint-widget-missing' | 'endpoint-unresolved' | 'endpoint-not-declared' | 'nested-path-terminal-missing' | 'nested-path-not-declared' | 'state-path-not-declared' | 'feedback-cycle-unguarded' | 'feedback-cycle-guarded' | 'competing-query-owner';
 interface ConnectionEditorDiagnostic {
     code: ConnectionEditorDiagnosticCode;
     severity: ConnectionEditorDiagnosticSeverity;
@@ -1091,8 +1175,68 @@ declare class CanvasConstraintEditorModel {
         width: number;
         height: number;
     };
+    private resolveFriendlyWidgetTitle;
+}
+/**
+ * Canonical presentation model for identifying a widget instance across authoring surfaces
+ * (State/Measure Binder, Quick Geometry, Arrangement Review, Canvas Limits, and Filter Ownership).
+ */
+interface WidgetEditorPresentation {
+    /** Unique technical key of the widget instance in the page draft. */
+    key: string;
+    /** Human-readable title resolved from authored shell, inputs, rich-content AST, or disambiguated type. */
+    title: string;
+    /** Contextual subtitle, structural summary, resource path, or component type label. */
+    description: string;
+    /** Material icon identifier representing the widget instance or its component family. */
+    icon: string;
+    /** Localized or friendly label of the widget's component type. */
+    typeLabel: string;
+    /** Canonical component identifier (e.g. `praxis-rich-content`, `praxis-table`). */
+    componentId: string;
 }
 
+interface GuidedDataSourceQueryConfig {
+    mode: 'group-by' | 'timeseries' | 'collection';
+    groupByField?: string;
+    metricField?: string;
+    metricOp?: 'count' | 'sum' | 'avg' | 'min' | 'max';
+    period?: 'day' | 'week' | 'month' | 'year';
+    pageSize?: number;
+}
+interface GuidedDataSourceTransformConfig {
+    kind: 'group-by-map' | 'timeseries-last' | 'path';
+    path?: string;
+    mappingsText?: string;
+    totalField?: string;
+    weightedAverageField?: string;
+    weightedAverageDecimals?: number;
+    ratioTargetField?: string;
+    ratioNumeratorField?: string;
+    ratioDenominatorField?: string;
+    ratioScale?: number;
+    ratioDecimals?: number;
+}
+interface GuidedDerivedMeasureConfig {
+    targetPath: string;
+    kind: 'ratio-percent' | 'weighted-average' | 'format-value' | 'template';
+    numeratorPath?: string;
+    denominatorPath?: string;
+    sourcePath?: string;
+    decimals?: number;
+    format?: 'percent' | 'number' | 'currency';
+    templateExpression?: string;
+}
+interface CollectionScreenComposerConfig {
+    resourcePath: string;
+    title: string;
+    groupByField: string;
+    includeHeader: boolean;
+    includeIndicators: boolean;
+    filterMode: 'table-integrated' | 'external-filter-bar';
+    collectionKind: 'table' | 'list';
+    detailSurface: 'none' | 'drawer' | 'modal';
+}
 type EditorTabId$1 = 'canvas' | 'grouping' | 'devices' | 'context' | 'state' | 'limits';
 type DeviceKey = 'desktop' | 'tablet' | 'mobile';
 type GroupingNodeGroup$1 = FormGroup<{
@@ -1105,6 +1249,21 @@ type GroupingNodeGroup$1 = FormGroup<{
     side: FormControl<string>;
     tabsJson: FormControl<string>;
 }>;
+type DataSourceNodeGroup$1 = FormGroup<{
+    id: FormControl<string>;
+    kind: FormControl<string>;
+    resourcePath: FormControl<string>;
+    endpointKey: FormControl<string>;
+    method: FormControl<string>;
+    targetStatePath: FormControl<string>;
+    errorPolicy: FormControl<string>;
+    refreshIntervalMs: FormControl<number | null>;
+    autoFetch: FormControl<string>;
+    description: FormControl<string>;
+    queryJson: FormControl<string>;
+    transformJson: FormControl<string>;
+    fallbackJson: FormControl<string>;
+}>;
 type DeviceVariantForm = FormGroup<{
     columns: FormControl<number | null>;
     rowUnit: FormControl<string>;
@@ -1186,6 +1345,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
         key: string;
         number: number;
         label: string;
+        widgetKey?: string;
         col: number;
         row: number;
         colSpan: number;
@@ -1228,6 +1388,8 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     readonly shellPresetControl: FormControl<string>;
     readonly contextControl: FormControl<string>;
     readonly stateControl: FormControl<string>;
+    readonly dataSourcesControl: FormControl<string>;
+    readonly dataSourceNodes: FormArray<DataSourceNodeGroup$1>;
     readonly groupingNodes: FormArray<GroupingNodeGroup$1>;
     readonly deviceForms: Record<DeviceKey, DeviceVariantForm>;
     readonly isDirty$: BehaviorSubject<boolean>;
@@ -1242,22 +1404,63 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     readonly canvasLimits: CanvasConstraintEditorModel;
     readonly limitsTargetControl: FormControl<number>;
     readonly limitsError: WritableSignal<string | null>;
+    readonly previousAdjustableHeights: WritableSignal<{
+        key: string;
+        title: string;
+        scope: string;
+        scopeLabel: string;
+        heightPx: number;
+    }[]>;
     readonly limitsErrorMatcher: {
         isErrorState: (control: FormControl | null) => boolean;
     };
     private readonly injectedData;
     readonly isHostedInSettingsPanel: boolean;
+    private readonly destroyRef;
     private readonly i18n;
+    private readonly componentRegistry;
+    private readonly resourceDiscovery;
+    private readonly dataSourceRuntime;
+    private readonly stateRuntime;
     private pageInput;
     private snapshot;
     readonly stackedDevices: Set<DeviceKey>;
     readonly activeDevice: WritableSignal<DeviceKey>;
     private hydrating;
+    private syncingDataSources;
+    private guidedDataSourcesInvalid;
     private renderedCandidate;
     private renderedValidationFingerprint;
+    private stagedWidgets;
+    private stagedComposition;
+    readonly composerResourcePathControl: FormControl<string>;
+    readonly composerTitleControl: FormControl<string>;
+    readonly composerGroupFieldControl: FormControl<string>;
+    readonly composerIncludeHeaderControl: FormControl<boolean>;
+    readonly composerIncludeIndicatorsControl: FormControl<boolean>;
+    readonly composerFilterModeControl: FormControl<"table-integrated" | "external-filter-bar">;
+    readonly composerCollectionKindControl: FormControl<"table" | "list">;
+    readonly composerDetailSurfaceControl: FormControl<"none" | "modal" | "drawer">;
+    readonly composerMessage: WritableSignal<string>;
+    readonly composerSelectedResource: WritableSignal<DiscoveredResourceOption | null>;
+    readonly composerSchemaFields: WritableSignal<FieldDefinition[]>;
+    private composerSchemaPath;
+    private composerSchemaSub?;
+    private lastAutoComposerTitle;
+    readonly binderTokenControl: FormControl<string>;
+    readonly binderWidgetControl: FormControl<string>;
+    readonly binderInputPathControl: FormControl<string>;
+    readonly binderMessage: WritableSignal<string>;
+    readonly derivedPathControl: FormControl<string>;
+    readonly derivedKindControl: FormControl<"template" | "format-value" | "ratio-percent" | "weighted-average">;
+    readonly derivedNumeratorControl: FormControl<string>;
+    readonly derivedDenominatorControl: FormControl<string>;
+    readonly derivedFormatControl: FormControl<"number" | "boolean" | "integer" | "percent" | "currency">;
+    readonly derivedDecimalsControl: FormControl<number>;
     private readonly tabOrder;
     constructor();
     ngOnInit(): void;
+    ngOnDestroy(): void;
     get selectedTabIndex(): number;
     get isConfigurationValid(): boolean;
     get hasPendingChanges(): boolean;
@@ -1265,6 +1468,17 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     get dirtyStateLabel(): string;
     get nonLimitError(): string | null;
     get limitsSummaryError(): string | null;
+    get blockedGeometryWidgets(): Array<{
+        targetIndex: number;
+        key: string;
+        title: string;
+        scope: string;
+        scopeLabel: string;
+        heightPx: number | null;
+        message: string;
+    }>;
+    navigateToBlockedLimit(targetIndex?: number): void;
+    switchBlockedWidgetsToAutoHeight(): void;
     get selectedLayoutPresetLabel(): string;
     get selectedThemePresetLabel(): string;
     get selectedLayoutPresetEntry(): LayoutPresetEntry | null;
@@ -1285,6 +1499,112 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private stackedCanvas;
     addGroupingNode(seed?: WidgetPageGroupingDefinition): void;
     removeGroupingNode(index: number): void;
+    private readonly groupingSelectedKeysCache;
+    groupingSelectedWidgetKeys(index: number): string[];
+    groupingSelectedWidgetsLabel(index: number): string;
+    groupingSelectedWidgetIcon(index: number): string;
+    onGroupingWidgetSelectionChange(index: number, selectedKeys: readonly string[]): void;
+    addDataSourceNode(seed?: Partial<WidgetPageDataSourceDefinition>): void;
+    removeDataSourceNode(index: number): void;
+    dataSourceLabel(index: number): string;
+    applyGuidedDataSourceQuery(index: number, config: GuidedDataSourceQueryConfig): void;
+    applyGuidedDataSourceTransform(index: number, config: GuidedDataSourceTransformConfig): void;
+    getDataSourcePreview(index: number): {
+        status: 'ok' | 'error';
+        sourceKind: 'live' | 'sample';
+        value?: unknown;
+        formattedJson?: string;
+        error?: string;
+        tokens: string[];
+    };
+    resolveEndpointKey(rawKey?: string | null): any;
+    addGuidedDerivedMeasure(config?: Partial<GuidedDerivedMeasureConfig>): boolean;
+    getDerivedStatePreview(): {
+        entries: Array<{
+            key: string;
+            value: unknown;
+            formattedValue: string;
+            token: string;
+        }>;
+        diagnostics: string[];
+    };
+    availableStateBindingTokens(): string[];
+    bindablePageWidgets(): WidgetEditorPresentation[];
+    selectedBinderWidget(): WidgetEditorPresentation | null;
+    selectedBinderWidgetInputSuggestions(): string[];
+    readonly binderDeclarativePipes: readonly ["| number", "| round:1", "| percent:1", "| currency:\"BRL\"", "| currencyCompact:\"BRL\"", "| dateTime", "| default:0", "| uppercase"];
+    private static readonly ALLOWED_DECLARATIVE_PIPES;
+    selectBinderInputPathSuggestion(path: string): void;
+    selectBinderTokenSuggestion(token: string): void;
+    appendBinderTokenPipe(pipeSegment: string): void;
+    hasInvalidDeclarativePipe(rawExpression?: string | null): boolean;
+    binderTokenPipeError(): string | null;
+    binderTokenLivePreview(): string | null;
+    invalidWidgetStateBindingPipes(): Array<{
+        widgetKey: string;
+        widgetTitle: string;
+        inputPath: string;
+        expression: string;
+    }>;
+    loadStateBindingIntoForm(binding: {
+        widgetKey: string;
+        inputPath: string;
+        token?: string;
+        expression?: string;
+    }): void;
+    widgetIconForKey(widgetKey: string): string;
+    bindStateTokenToWidget(widgetKey?: string, inputPath?: string, stateToken?: string): boolean;
+    currentWidgetStateBindings(): Array<{
+        widgetKey: string;
+        widgetTitle: string;
+        inputPath: string;
+        token: string;
+    }>;
+    resolveStateTokenPreview(rawToken: string): string | null;
+    private resolveStateTokenMatch;
+    unboundWidgetStatePlaceholders(): Array<{
+        widgetKey: string;
+        widgetTitle: string;
+        placeholder: string;
+        suggestedInputPath: string;
+    }>;
+    selectUnboundPlaceholder(item: {
+        widgetKey: string;
+        placeholder: string;
+        suggestedInputPath: string;
+    }): void;
+    unbindStateTokenFromWidget(widgetKey: string, inputPath: string): boolean;
+    autoBindWidgetStatePlaceholders(): number;
+    onComposerResourceSelected(entry: DiscoveredResourceOption | null): void;
+    private syncDefaultComposerGroupField;
+    filteredComposerGroupFieldOptions(): FieldDefinition[];
+    getComposerFieldTypeBadge(field: FieldDefinition | null | undefined): string;
+    getComposerFieldDescription(field: FieldDefinition | null | undefined): string;
+    private loadComposerSchemaFields;
+    private resolveGroupByMappings;
+    composeCollectionScreen(overrides?: Partial<CollectionScreenComposerConfig>): WidgetPageDefinition | null;
+    quickCanvasWidgets(): Array<{
+        key: string;
+        label: string;
+        icon: string;
+        description: string;
+        col: number;
+        row: number;
+        colSpan: number;
+        rowSpan: number;
+    }>;
+    setWidgetCanvasSpan(widgetKey: string, colSpan: number, rowSpan?: number): void;
+    duplicateFilterOwners(): Array<{
+        tableKey: string;
+        tableTitle: string;
+        externalSourceKeys: string[];
+        externalSourceLabels: string[];
+        linkIds: string[];
+    }>;
+    consolidateFilterOwnership(tableKey: string, mode: 'keep-table-toolbar' | 'keep-external-link'): void;
+    private resolveWidgetPresentation;
+    private resolveWidgetTitle;
+    private isFilterLinkTargetingWidget;
     layoutPresetSummary(preset: LayoutPresetEntry): string;
     slotsSummary(preset: LayoutPresetEntry): string;
     requiredSlotsSummary(preset: LayoutPresetEntry): string;
@@ -1294,6 +1614,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     tx(key: string, fallback: string): string;
     shellPresetLabel(preset: WidgetShellPresetDefinition): string;
     limitsTargetLabel(index: number): string;
+    limitsTargetIcon(index: number): string;
     limitFieldError(control: FormControl<number | null>): string;
     private draftFingerprint;
     limitsGeometryLabel(): string;
@@ -1304,6 +1625,14 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     protected refreshRenderedValidation(): void;
     private createDeviceVariantForm;
     private createGroupingNodeGroup;
+    private createDataSourceNodeGroup;
+    private replaceDataSourceNodes;
+    private buildDataSourcesFromNodes;
+    syncStateValuesFromDataSources(): number;
+    private ensureDataSourceTargetPathsInStateValues;
+    private syncDataSourcesJsonFromNodes;
+    private syncDataSourceNodesFromJson;
+    private inferPageResourcePath;
     private hydrate;
     private replaceGroupingNodes;
     private buildCurrentPage;
@@ -1316,13 +1645,20 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private invalidate;
     private refreshPanelState;
     get layoutPresetOptions(): WidgetPageDefinition['layoutPresetOptions'];
+    private effectivePageInput;
+    private readEffectiveWidgets;
     private currentPageInput;
     private parsePage;
     private parseJson;
     private parseRecordJson;
+    private parseDataSourcesJson;
+    private isValidDataSourceTransform;
+    private validateDataSourceEntry;
+    private isValidDataSourcesPayload;
     private parseGroupingTabs;
     private parseGroupingOverrides;
     private parseWidgetOverrides;
+    private validateWidgetOverrides;
     private isGroupingTab;
     private isGroupingOverride;
     private isWidgetOverride;
@@ -1337,6 +1673,17 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private applyShellPresetToContext;
     private lookupPresetLabel;
     private defaultCanvas;
+    private parseKeyValuePairs;
+    private buildSamplePayloadForDataSource;
+    private collectStateTokensForValue;
+    private assignNestedValue;
+    private readNestedValue;
+    private deleteNestedValue;
+    private isPlaceholderBoundInContext;
+    private collectTemplatePlaceholdersRecursive;
+    private collectWidgetBindingsRecursive;
+    private collectInvalidWidgetPipesRecursive;
+    private humanizeResourceTitle;
     private clone;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DynamicPageConfigEditorComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicPageConfigEditorComponent, "praxis-dynamic-page-config-editor", never, { "page": { "alias": "page"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "presets": { "alias": "presets"; "required": false; }; "pagePreset": { "alias": "pagePreset"; "required": false; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
@@ -1408,11 +1755,29 @@ type GroupingNodeGroup = FormGroup<{
     side: FormControl<string>;
     tabsJson: FormControl<string>;
 }>;
+type DataSourceNodeGroup = FormGroup<{
+    id: FormControl<string>;
+    kind: FormControl<string>;
+    resourcePath: FormControl<string>;
+    endpointKey: FormControl<string>;
+    method: FormControl<string>;
+    targetStatePath: FormControl<string>;
+    errorPolicy: FormControl<string>;
+    refreshIntervalMs: FormControl<number | null>;
+    autoFetch: FormControl<string>;
+    queryJson: FormControl<string>;
+    transformJson: FormControl<string>;
+    fallbackJson: FormControl<string>;
+    description: FormControl<string>;
+}>;
 declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
     protected readonly derivedOperators: readonly ["merge-objects", "pick", "omit"];
     protected readonly mergeStrategies: readonly ["replace", "merge", "append", "remove-keys"];
     protected readonly valueModes: readonly ["json", "string", "number", "boolean", "null"];
     protected readonly groupingKinds: readonly ["section", "tabs", "hero", "rail"];
+    protected readonly dataSourceKinds: WidgetPageDataSourceKind[];
+    protected readonly dataSourceMethods: WidgetPageDataSourceMethod[];
+    protected readonly dataSourceErrorPolicies: WidgetPageDataSourceErrorPolicy[];
     protected readonly layoutPresetEntries: Array<(typeof BUILTIN_PAGE_LAYOUT_PRESETS)[string]>;
     protected readonly themePresetEntries: Array<(typeof BUILTIN_PAGE_THEME_PRESETS)[string]>;
     readonly page: _angular_core.InputSignal<string | PageDefinition | null>;
@@ -1432,9 +1797,11 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
     readonly groupingControl: FormControl<string>;
     readonly deviceLayoutsControl: FormControl<string>;
     readonly stateValuesControl: FormControl<string>;
+    readonly dataSourcesControl: FormControl<string>;
     readonly groupingNodes: FormArray<GroupingNodeGroup>;
     readonly schemaNodes: FormArray<SchemaNodeGroup>;
     readonly derivedNodes: FormArray<DerivedNodeGroup>;
+    readonly dataSourceNodes: FormArray<DataSourceNodeGroup>;
     readonly deviceDesktopForm: FormGroup<{
         orientation: FormControl<string>;
         columns: FormControl<number | null>;
@@ -1471,6 +1838,8 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
     private lastGrouping;
     private lastDeviceLayouts;
     private lastStateValues;
+    private lastDataSources;
+    private dataSourcesEditSource;
     private readonly dirtySubject;
     private readonly validSubject;
     private readonly busySubject;
@@ -1492,6 +1861,7 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
     protected get selectedShellPresetLabel(): string;
     protected get contextExample(): string;
     protected get stateValuesExample(): string;
+    protected get dataSourcesExample(): string;
     protected get layoutPresetHint(): string;
     protected get themePresetHint(): string;
     protected get shellPresetHint(): string;
@@ -1515,6 +1885,8 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
         config?: WidgetDerivedStateNode;
     }): void;
     removeDerivedNode(index: number): void;
+    addDataSourceNode(seed?: WidgetPageDataSourceDefinition): void;
+    removeDataSourceNode(index: number): void;
     addGroupingNode(seed?: WidgetPageGroupingDefinition): void;
     removeGroupingNode(index: number): void;
     setActiveTab(tab: EditorTabId): void;
@@ -1526,11 +1898,24 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
     private stringifyGroupingWidgetKeys;
     private buildGrouping;
     private hydrateDeviceLayoutControls;
+    private deviceOverridesError;
     private buildDeviceLayouts;
     private createDeviceLayoutForm;
     private patchDeviceLayoutForm;
     private buildDeviceLayoutVariant;
     private hydrateStateEditor;
+    private hydrateDataSourcesEditor;
+    private normalizeDataSourcesArray;
+    private replaceDataSourceNodes;
+    private createDataSourceNodeGroup;
+    private syncDataSourceNodesFromControl;
+    private syncDataSourcesControlFromNodes;
+    private isPlainRecord;
+    private isValidDataSourceTransform;
+    private validateDataSourceEntry;
+    private isValidDataSourcesPayload;
+    private buildDataSourcesFromNodes;
+    private buildDataSources;
     private replaceSchemaNodes;
     private replaceDerivedNodes;
     private createSchemaNodeGroup;
@@ -2153,7 +2538,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'> & {
@@ -2267,20 +2652,6 @@ interface AgenticAuthoringQuickReply extends PraxisAssistantShellQuickReply {
     kind: string;
 }
 type AgenticAuthoringPanelLayout = PraxisAssistantShellLayout;
-type PageBuilderPremiumReadinessSeverity = 'info' | 'warning' | 'error';
-type PageBuilderPremiumReadinessActionKind = 'open-page-settings' | 'open-connections' | 'open-widget-config' | 'focus-widget';
-interface PageBuilderPremiumReadinessAction {
-    kind: PageBuilderPremiumReadinessActionKind;
-    label: string;
-    widgetKey?: string;
-}
-interface PageBuilderPremiumReadinessIssue {
-    id: string;
-    severity: PageBuilderPremiumReadinessSeverity;
-    title: string;
-    description: string;
-    action?: PageBuilderPremiumReadinessAction;
-}
 type SharedRuleCockpitAction = 'definition' | 'simulation' | 'approve' | 'activate' | 'publication' | 'materializations' | 'timeline' | 'enforcement';
 type ProjectKnowledgeCockpitAction = 'change-set' | 'validate' | 'approve' | 'reject' | 'apply' | 'readback';
 interface SharedRuleEnforcementSummary {
@@ -2333,14 +2704,18 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private readonly observabilityDashboard;
     private readonly runtimeObservationRegistry;
     private readonly agenticAuthoringOptions;
+    private readonly customizationMode;
     runtime?: DynamicWidgetPageComponent;
     page?: WidgetPageDefinition | string;
     context?: Record<string, unknown> | null;
     strictValidation: boolean;
+    /** Opt in to Core persistence; hosts managing their own documents leave this disabled. */
     autoPersist: boolean;
     enableCustomization: boolean;
     authoringCapabilities?: PageBuilderAuthoringCapabilities | null;
     showSettingsButton: boolean;
+    showGovernanceToolbar: boolean;
+    governanceToolbarTitle?: string;
     pageIdentity?: PageIdentity;
     componentInstanceId?: string;
     pageEditorComponent: Type<any> | undefined;
@@ -2364,6 +2739,8 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     canDeleteSavedPage: boolean;
     pageLifecycleBusy: boolean;
     pageLifecycleResetRevision: number | string | null;
+    readonly persistenceChange: _angular_core.OutputEmitterRef<WidgetPagePersistenceState>;
+    private runtimePersistenceStatus;
     pageChange: EventEmitter<WidgetPageDefinition>;
     /** Emits only explicit visual authoring operations, never runtime state changes. */
     readonly pageAuthoringChange: _angular_core.OutputEmitterRef<WidgetPageDefinition>;
@@ -2373,10 +2750,16 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     agenticAuthoringSharedRuleHandoff: EventEmitter<PageBuilderAgenticAuthoringSharedRuleHandoff>;
     pageRestart: EventEmitter<void>;
     savedPageDeleteRequested: EventEmitter<void>;
+    customizationChange: EventEmitter<boolean>;
     readonly currentPage: _angular_core.WritableSignal<WidgetPageDefinition>;
+    readonly isCustomizing: _angular_core.WritableSignal<boolean>;
+    readonly governancePersistence: _angular_core.WritableSignal<WidgetPagePersistenceState>;
+    readonly isLayoutCustomized: _angular_core.Signal<boolean>;
+    readonly isGovernanceBusy: _angular_core.Signal<boolean>;
+    readonly governancePersistenceLabel: _angular_core.Signal<string>;
+    readonly governanceLastSavedAt: _angular_core.Signal<string | null>;
     readonly hasPageWidgets: _angular_core.Signal<boolean>;
     readonly hasRecommendedConnectionSuggestion: _angular_core.Signal<boolean>;
-    readonly premiumReadinessIssues: _angular_core.Signal<PageBuilderPremiumReadinessIssue[]>;
     readonly connectionsViewerOpen: _angular_core.WritableSignal<boolean>;
     readonly agenticAuthoringOpen: _angular_core.WritableSignal<boolean>;
     readonly agenticAuthoringPrompt: _angular_core.WritableSignal<string>;
@@ -2439,19 +2822,28 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     constructor(dialog: MatDialog, settingsPanel: SettingsPanelBridge | null);
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
+    toggleGovernanceCustomization(): void;
+    isCustomizationEnabled(): boolean;
     showSettings(): boolean;
     canInsertWidgets(): boolean;
     canOpenPageSettings(): boolean;
     canEditConnections(): boolean;
     canPreviewPage(): boolean;
     canUseAgenticAuthoring(): boolean;
-    canRunPremiumReadinessAction(action: PageBuilderPremiumReadinessAction): boolean;
     canUsePageLifecycle(): boolean;
     private isAuthoringCapabilityEnabled;
     isPreviewMode(): boolean;
     runtimePage(): WidgetPageDefinition;
     runtimeAuthoringCapabilities(): PageBuilderAuthoringCapabilities;
     builderModeLabel(): string;
+    /** Governed documents and agentic previews retain their explicit host/apply lifecycle. */
+    runtimeAutoPersist(): boolean;
+    /** Explicitly discard the local draft and reload the current identity's saved page. */
+    reloadPersistedPage(defaultPage?: WidgetPageDefinition): void;
+    /** Clear the current identity's saved document after storage acknowledgement. */
+    resetPersistedPage(defaultPage?: WidgetPageDefinition): void;
+    onRuntimePersistenceChange(state: WidgetPagePersistenceState): void;
+    private syncShellPageGovernance;
     onRuntimePageChange(next: WidgetPageDefinition): void;
     onRuntimePageAuthoringChange(next: WidgetPageDefinition): void;
     onRuntimeWidgetEvent(event: WidgetEventEnvelope): void;
@@ -2474,17 +2866,14 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     connectionsToggleLabel(): string;
     onAddComponent(): void;
     addWidget(selection: string | ComponentPaletteSelection): void;
+    addWidgets(selections: ReadonlyArray<string | ComponentPaletteSelection>): string[];
+    private appendWidgetToDraft;
     private layoutHintsFor;
     openPageSettings(): void;
+    /** Retries the current persisted draft, including an intentionally empty page. */
+    retryPersistedPage(): void;
     saveCurrentPage(): void;
     canSaveCurrentPage(): boolean;
-    private evaluatePremiumReadiness;
-    runPremiumReadinessAction(issue: PageBuilderPremiumReadinessIssue): void;
-    private isPremiumReadinessCandidate;
-    private hasDisconnectedOperationalWidgets;
-    private latePrimaryChartKey;
-    private usesLocalAnalyticData;
-    private isAnalyticWidget;
     applyConfigFromAdapter(config: PageBuilderConfig): void;
     private createAdapterHost;
     toggleAgenticAuthoring(): void;
@@ -2718,7 +3107,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     authoringSourceDiagnosticText(diagnostic: UiCompositionAuthoringSourceDiagnostic): string;
     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; }; "authoringCapabilities": { "alias": "authoringCapabilities"; "required": false; }; "showSettingsButton": { "alias": "showSettingsButton"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; "componentPaletteAllowedWidgetIds": { "alias": "componentPaletteAllowedWidgetIds"; "required": false; }; "componentPaletteAllowedWidgetTags": { "alias": "componentPaletteAllowedWidgetTags"; "required": false; }; "componentPaletteAllowedPresetIds": { "alias": "componentPaletteAllowedPresetIds"; "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; }; "agenticAuthoringVoiceInputMode": { "alias": "agenticAuthoringVoiceInputMode"; "required": false; }; "agenticAuthoringContextHints": { "alias": "agenticAuthoringContextHints"; "required": false; }; "authoringDocument": { "alias": "authoringDocument"; "required": false; }; "showPageLifecycleActions": { "alias": "showPageLifecycleActions"; "required": false; }; "canDeleteSavedPage": { "alias": "canDeleteSavedPage"; "required": false; }; "pageLifecycleBusy": { "alias": "pageLifecycleBusy"; "required": false; }; "pageLifecycleResetRevision": { "alias": "pageLifecycleResetRevision"; "required": false; }; }, { "pageChange": "pageChange"; "pageAuthoringChange": "pageAuthoringChange"; "widgetEvent": "widgetEvent"; "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; }; "authoringCapabilities": { "alias": "authoringCapabilities"; "required": false; }; "showSettingsButton": { "alias": "showSettingsButton"; "required": false; }; "showGovernanceToolbar": { "alias": "showGovernanceToolbar"; "required": false; }; "governanceToolbarTitle": { "alias": "governanceToolbarTitle"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; "componentPaletteAllowedWidgetIds": { "alias": "componentPaletteAllowedWidgetIds"; "required": false; }; "componentPaletteAllowedWidgetTags": { "alias": "componentPaletteAllowedWidgetTags"; "required": false; }; "componentPaletteAllowedPresetIds": { "alias": "componentPaletteAllowedPresetIds"; "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; }; "agenticAuthoringVoiceInputMode": { "alias": "agenticAuthoringVoiceInputMode"; "required": false; }; "agenticAuthoringContextHints": { "alias": "agenticAuthoringContextHints"; "required": false; }; "authoringDocument": { "alias": "authoringDocument"; "required": false; }; "showPageLifecycleActions": { "alias": "showPageLifecycleActions"; "required": false; }; "canDeleteSavedPage": { "alias": "canDeleteSavedPage"; "required": false; }; "pageLifecycleBusy": { "alias": "pageLifecycleBusy"; "required": false; }; "pageLifecycleResetRevision": { "alias": "pageLifecycleResetRevision"; "required": false; }; }, { "persistenceChange": "persistenceChange"; "pageChange": "pageChange"; "pageAuthoringChange": "pageAuthoringChange"; "widgetEvent": "widgetEvent"; "pageSaveRequested": "pageSaveRequested"; "agenticAuthoringApplied": "agenticAuthoringApplied"; "agenticAuthoringSharedRuleHandoff": "agenticAuthoringSharedRuleHandoff"; "pageRestart": "pageRestart"; "savedPageDeleteRequested": "savedPageDeleteRequested"; "customizationChange": "customizationChange"; }, never, never, true, never>;
 }
 
 /** Metadata for Praxis Page Builder component */
@@ -2726,5 +3115,402 @@ 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 };
-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 };
+/**
+ * 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[];
+
+/** Transient UI intent, not the Config POST /pages DTO or a publication document. */
+interface PageSaveAsRequest {
+    readonly creationKey: string;
+    readonly definition: WidgetPageDefinition;
+    readonly presentation: PageAuthoringDocument['config']['presentation'];
+    readonly menuLabel: string;
+}
+/** Returned only after the adapter confirms the page/menu and an openable host route. */
+interface PageSaveAsResult {
+    readonly pageId: string;
+    readonly routePath: string;
+}
+/** No default storage. The adapter owns admission, identity allocation, persistence and routing. */
+interface PageSaveAsAdapter {
+    save(request: PageSaveAsRequest): Promise<PageSaveAsResult>;
+}
+
+/** Reusable save-as journey. Feed save() only from the builder's pageSaveRequested event. */
+declare class PraxisPageSaveAsComponent {
+    readonly adapter: _angular_core.InputSignal<PageSaveAsAdapter>;
+    /** Monotonic host view/session identity; UI invalidation only, never an authorization grant. */
+    readonly contextKey: _angular_core.InputSignal<string>;
+    readonly canSave: _angular_core.InputSignal<boolean>;
+    readonly initialTitle: _angular_core.InputSignal<string>;
+    readonly initialMenuLabel: _angular_core.InputSignal<string>;
+    readonly initialIcon: _angular_core.InputSignal<string>;
+    readonly titleMaxLength: _angular_core.InputSignal<number>;
+    readonly menuMaxLength: _angular_core.InputSignal<number>;
+    readonly saveRequested: _angular_core.OutputEmitterRef<void>;
+    readonly saved: _angular_core.OutputEmitterRef<PageSaveAsResult>;
+    readonly saveFailed: _angular_core.OutputEmitterRef<unknown>;
+    readonly busy: _angular_core.WritableSignal<boolean>;
+    readonly choosingIcon: _angular_core.WritableSignal<boolean>;
+    readonly result: _angular_core.WritableSignal<PageSaveAsResult | null>;
+    readonly error: _angular_core.WritableSignal<boolean>;
+    readonly iconError: _angular_core.WritableSignal<boolean>;
+    readonly title: FormControl<string>;
+    readonly menu: FormControl<string>;
+    readonly icon: _angular_core.WritableSignal<string>;
+    private readonly i18n;
+    private readonly picker;
+    private generation;
+    private attempt?;
+    private destroyed;
+    constructor();
+    text(key: string): string;
+    destination(): {
+        label: string;
+        icon: string;
+    };
+    clearResult(): void;
+    requestSave(): void;
+    chooseIcon(): Promise<void>;
+    save(definition: WidgetPageDefinition): Promise<void>;
+    private available;
+    private current;
+    private limit;
+    private validIcon;
+    private localRoute;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PraxisPageSaveAsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisPageSaveAsComponent, "praxis-page-save-as", never, { "adapter": { "alias": "adapter"; "required": true; "isSignal": true; }; "contextKey": { "alias": "contextKey"; "required": true; "isSignal": true; }; "canSave": { "alias": "canSave"; "required": false; "isSignal": true; }; "initialTitle": { "alias": "initialTitle"; "required": false; "isSignal": true; }; "initialMenuLabel": { "alias": "initialMenuLabel"; "required": false; "isSignal": true; }; "initialIcon": { "alias": "initialIcon"; "required": false; "isSignal": true; }; "titleMaxLength": { "alias": "titleMaxLength"; "required": false; "isSignal": true; }; "menuMaxLength": { "alias": "menuMaxLength"; "required": false; "isSignal": true; }; }, { "saveRequested": "saveRequested"; "saved": "saved"; "saveFailed": "saveFailed"; }, never, never, true, never>;
+}
+
+/** Copies the current local authoring snapshot. Allocation/provenance belongs to the destination adapter. */
+declare class PraxisPageCopyActionComponent {
+    readonly page: _angular_core.InputSignal<WidgetPageDefinition | undefined>;
+    readonly canCopy: _angular_core.InputSignal<boolean>;
+    readonly copyRequested: _angular_core.OutputEmitterRef<WidgetPageDefinition>;
+    readonly error: _angular_core.WritableSignal<boolean>;
+    private readonly i18n;
+    text(key: string): string;
+    copy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PraxisPageCopyActionComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisPageCopyActionComponent, "praxis-page-copy-action", never, { "page": { "alias": "page"; "required": false; "isSignal": true; }; "canCopy": { "alias": "canCopy"; "required": false; "isSignal": true; }; }, { "copyRequested": "copyRequested"; }, never, never, true, never>;
+}
+
+interface GovernedPageCapabilities {
+    readonly canAuthorPages: boolean;
+    readonly canSubmitForReview: boolean;
+    readonly canApproveReleases: boolean;
+    readonly canPublishReleases: boolean;
+    readonly canManageNavigationGroups: boolean;
+}
+declare const GOVERNED_PAGE_CAPABILITY_KEYS: Readonly<{
+    authorPages: "praxis.config.pages.author";
+    submitForReview: "praxis.config.pages.submit";
+    approveReleases: "praxis.config.pages.approve";
+    publishReleases: "praxis.config.pages.publish";
+    manageNavigationGroups: "praxis.config.navigation.manage";
+}>;
+/**
+ * Derives governed page capabilities from canonical server-issued capability keys.
+ * Never fabricates approval or publication authority when a capability is absent.
+ */
+declare function deriveGovernedPageCapabilities(grantedCapabilities: Iterable<string> | null | undefined): GovernedPageCapabilities;
+type GovernedPageReadResult<T> = UiLayoutLifecycleHttpReceipt<T> | UiLayoutLifecycleNotModifiedReceipt;
+interface GovernedPagePersistenceAdapter {
+    readonly mode: 'corporate';
+    createPage(command: PageCreationCommand): Promise<UiLayoutLifecycleHttpReceipt<PageCreationReceipt>>;
+    readPageByCreationKey(creationKey: string): Promise<UiLayoutLifecycleHttpReceipt<PageCreationReceipt>>;
+    readPageCatalog(options?: PageCatalogReadOptions): Promise<PageCatalogResponse>;
+    readPublishedPage(pageId: string, ifNoneMatch?: string): Promise<GovernedPageReadResult<PublishedPageReadResponse>>;
+    readDraftByCreationKey(target: UiLayoutTarget, creationKey: string): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutDraftReceipt>>;
+    readDraft(target: UiLayoutTarget, draftId: string, ifNoneMatch?: string): Promise<GovernedPageReadResult<UiLayoutDraftWorkspaceReceipt>>;
+    readReview(target: UiLayoutTarget, releaseId: string, ifNoneMatch?: string): Promise<GovernedPageReadResult<UiLayoutReleaseReviewReceipt>>;
+    readHead(target: UiLayoutTarget, ifNoneMatch?: string): Promise<GovernedPageReadResult<UiLayoutReleaseHeadReceipt>>;
+    createDraft(target: UiLayoutTarget, idempotencyKey: string): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutDraftWorkspaceReceipt>>;
+    createRevision(target: UiLayoutTarget, draftId: string, draftEtag: string, command: UiLayoutRevisionCommand): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutRevisionCommandResult>>;
+    createAssignment(target: UiLayoutTarget, draftId: string, draftEtag: string, command: UiLayoutAssignmentCommand): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutAssignmentCommandResult>>;
+    freezeRelease(target: UiLayoutTarget, draftId: string, draftEtag: string, command: UiLayoutFreezeReleaseCommand): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutFreezeReleaseCommandResult>>;
+    submit(target: UiLayoutTarget, releaseId: string, reviewEtag: string): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutReleaseReviewReceipt>>;
+    approve(target: UiLayoutTarget, releaseId: string, reviewEtag: string, command: UiLayoutReasonCommand): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutReleaseReviewReceipt>>;
+    publish(target: UiLayoutTarget, condition: UiLayoutHeadWriteCondition, command: UiLayoutReleaseReferenceCommand): Promise<UiLayoutLifecycleHttpReceipt<UiLayoutReleaseHeadReceipt>>;
+}
+declare function createCorporateGovernedPagePersistenceAdapter(lifecycle: Pick<UiLayoutLifecycleService, 'createPage' | 'readPageByCreationKey' | 'readPageCatalog' | 'readPublishedPage' | 'readDraftByCreationKey' | 'readDraft' | 'readReview' | 'readHead' | 'createDraft' | 'createRevision' | 'createAssignment' | 'freezeRelease' | 'submit' | 'approve' | 'publish'>): GovernedPagePersistenceAdapter;
+/**
+ * Explicit local/sandbox Save-As adapter contract.
+ * Never simulates corporate review/approval/release states in the browser.
+ */
+interface GovernedPageLocalSaveAdapter extends PageSaveAsAdapter {
+    readonly mode: 'local';
+}
+declare function createLocalPageSaveAsAdapter(handler: (request: PageSaveAsRequest) => Promise<PageSaveAsResult>): GovernedPageLocalSaveAdapter;
+type GovernedPageOperationKind = 'create-page' | 'import-legacy-page' | 'save-revision' | 'assign-scope' | 'freeze-release' | 'submit-review' | 'approve-release' | 'publish-release';
+declare const LEGACY_PUBLISHED_PAGE_STORAGE_PREFIX: "published-page:";
+interface GovernedPageLegacyExportArtifact {
+    readonly schemaVersion: '1.0.0';
+    readonly kind: 'legacy-published-page-export';
+    readonly storageKey: string;
+    readonly pageId: string;
+    readonly routePath: `/pages/${string}`;
+    readonly compatible: boolean;
+    readonly diagnostics: readonly PageDocumentDiagnostic[];
+    readonly rawPayload: unknown;
+}
+interface GovernedPageLegacyInspectionResult {
+    readonly storageKey: string;
+    readonly pageId: string;
+    readonly routePath: `/pages/${string}`;
+    readonly target: UiLayoutTarget;
+    readonly compatible: boolean;
+    readonly source: PageSourceReference | null;
+    readonly childSources: readonly UiLayoutPageChildSource[];
+    readonly authoringDocument: PageAuthoringDocument | null;
+    readonly diagnostics: readonly PageDocumentDiagnostic[];
+    readonly exportableArtifact: GovernedPageLegacyExportArtifact;
+}
+interface GovernedPageLegacyImportRequest {
+    readonly pageId: string;
+    readonly rawPayload: unknown;
+    readonly source?: PageSourceReference;
+    readonly childSources?: readonly UiLayoutPageChildSource[];
+    readonly reason?: string;
+    readonly idempotencyKey?: string;
+}
+interface GovernedPageUncertainOperation {
+    readonly operation: GovernedPageOperationKind;
+    readonly attemptKey: string;
+    readonly creationKey?: string;
+    readonly commandRef?: string;
+    readonly draftId?: string;
+    readonly releaseId?: string;
+    readonly source?: PageSourceReference | null;
+    readonly childSources?: readonly UiLayoutPageChildSource[];
+    readonly occurredAt: string;
+}
+interface GovernedPageWorkflowError {
+    readonly code: 'CAPABILITY_DENIED' | 'CONTEXT_OBSOLETE' | 'COMMAND_OUTCOME_UNCERTAIN' | 'OPERATION_FENCED' | 'PRECONDITION_FAILED' | 'CONFLICT' | 'VALIDATION_FAILED' | 'PREVIEW_UNCERTIFIED' | 'ETAG_NOT_PROGRESSED' | 'DRAFT_NOT_LOADED' | 'RELEASE_NOT_FROZEN' | 'TRANSPORT_ERROR';
+    readonly message: string;
+    readonly diagnostics?: readonly PageDocumentDiagnostic[];
+    readonly status?: number;
+}
+interface GovernedPageWorkflowSnapshot {
+    readonly contextGeneration: number;
+    readonly contextKey: string;
+    readonly pageId: string | null;
+    readonly rootTarget: UiLayoutTarget | null;
+    readonly source: PageSourceReference | null;
+    readonly draftWorkspace: UiLayoutDraftWorkspaceReceipt | null;
+    readonly draftEtag: string | null;
+    readonly workingDocument: PageAuthoringDocument | null;
+    readonly baselineDocument: PageAuthoringDocument | null;
+    readonly publishedSnapshot: PublishedPageReadResponse | null;
+    readonly publishedEtag: string | null;
+    readonly childSources: readonly UiLayoutPageChildSource[];
+    readonly reviewReceipt: UiLayoutReleaseReviewReceipt | null;
+    readonly reviewEtag: string | null;
+    readonly headReceipt: UiLayoutReleaseHeadReceipt | null;
+    readonly headEtag: string | null;
+    readonly preview: GovernedPagePreviewMaterialization | null;
+    readonly dirty: boolean;
+    readonly busy: boolean;
+    readonly capabilities: GovernedPageCapabilities;
+    readonly fencedOperations: Readonly<Record<string, GovernedPageUncertainOperation>>;
+    readonly lastError: GovernedPageWorkflowError | null;
+}
+interface GovernedPageWorkflowControllerConfig {
+    readonly persistence: GovernedPagePersistenceAdapter;
+    readonly childValidators?: PageChildDocumentValidators;
+    readonly previewAdapters?: GovernedPagePreviewWidgetAdapters;
+    readonly initialCapabilities?: GovernedPageCapabilities;
+    readonly initialContextKey?: string;
+    readonly idGenerator?: () => string;
+}
+interface GovernedPageCreateNativeRequest {
+    readonly creationKey?: string;
+    readonly title: string;
+    readonly sourceId: string;
+    readonly revision: string;
+}
+interface GovernedPageCopyPublishedRequest {
+    readonly creationKey?: string;
+    readonly title: string;
+    readonly sourcePageId: string;
+}
+interface GovernedPageAssignmentInput {
+    readonly layerClass: UiLayoutLayerClass;
+    readonly selector: UiLayoutAssignmentSelector;
+    readonly priority?: number;
+    readonly contributionKey?: string;
+}
+interface GovernedPageSubmitOptions {
+    readonly reason?: string;
+    readonly assignment?: GovernedPageAssignmentInput;
+}
+interface GovernedPageNavigationSnapshot {
+    readonly epoch: number;
+    readonly contextKey: string;
+    readonly catalogEntries: readonly PageCatalogEntry[];
+    readonly groupsDocument: NavigationGroupsAuthoringDocument;
+    readonly menuNodes: readonly RuntimeNavigationMenuNode[];
+    readonly expandedGroupIds: readonly string[];
+    readonly loading: boolean;
+    readonly diagnostics: readonly PageDocumentDiagnostic[];
+    readonly fencedAttempts: Readonly<Record<string, string>>;
+    readonly lastError: string | null;
+}
+
+declare const DEFAULT_CORPORATE_NAVIGATION_GROUPS_TARGET: UiLayoutTarget;
+interface GovernedPageNavigationControllerConfig {
+    readonly persistence: GovernedPagePersistenceAdapter;
+    readonly effectiveLayoutService?: Pick<EffectiveUiLayoutService, 'resolve'> | null;
+    readonly observeTargetDocument?: (target: UiLayoutTarget) => Observable<Record<string, unknown> | null>;
+    readonly navigationGroupsTarget?: UiLayoutTarget;
+    readonly registeredNamespace?: string;
+    readonly allowedIcons?: Iterable<string>;
+    readonly pageSize?: number;
+    readonly maxItemsPerLevel?: number;
+    readonly initialContextKey?: string;
+    readonly idGenerator?: () => string;
+}
+interface GovernedNavigationGroupPublishInput {
+    readonly entry: NavigationGroupAuthoringEntry;
+    readonly draftCreationKey?: string;
+    readonly revisionCommandRef?: string;
+    readonly assignmentCommandRef?: string;
+    readonly freezeCommandRef?: string;
+    readonly reason?: string;
+    readonly layerClass?: UiLayoutLayerClass;
+    readonly selector: UiLayoutAssignmentSelector;
+    readonly priority?: number;
+    readonly contributionKey?: string;
+}
+declare class GovernedPageNavigationController {
+    private readonly persistence;
+    private readonly observeTargetDoc?;
+    private readonly navigationGroupsTarget;
+    private readonly registeredNamespace;
+    private readonly allowedIcons;
+    private readonly pageSize;
+    private readonly maxItemsPerLevel;
+    private readonly idGenerator;
+    private epoch;
+    private contextKey;
+    private groupsSub;
+    private readonly pageSubs;
+    private readonly pageDocuments;
+    private readonly expandedGroups;
+    private readonly fencedAttempts;
+    private latestGroupsDoc;
+    private latestCatalogEntries;
+    private readonly stateSubject;
+    readonly snapshot$: Observable<GovernedPageNavigationSnapshot>;
+    constructor(config: GovernedPageNavigationControllerConfig);
+    get snapshot(): GovernedPageNavigationSnapshot;
+    setContextKey(nextContextKey: string): void;
+    invalidate(): void;
+    destroy(): void;
+    refresh(): Promise<GovernedPageNavigationSnapshot>;
+    toggleGroupExpanded(groupId: string): void;
+    clearFencedAttempt(attemptKey: string): void;
+    upsertAndPublishNavigationGroup(input: GovernedNavigationGroupPublishInput): Promise<NavigationGroupsAuthoringDocument>;
+    private readAllCatalogEntries;
+    private hydrateCatalogPages;
+    private bindGroupsObservation;
+    private bindPageObservation;
+    private reobserveGroupChildren;
+    private recomputeProjection;
+    private isStale;
+    private teardownSubscriptions;
+    private publishSnapshot;
+}
+
+declare const DEFAULT_GOVERNED_PAGE_CHILD_VALIDATORS: PageChildDocumentValidators;
+declare const DEFAULT_GOVERNED_PAGE_PREVIEW_ADAPTERS: GovernedPagePreviewWidgetAdapters;
+/**
+ * Inspects a legacy `published-page:<uuid>` payload against the closed P0 governed page profile.
+ * Validates page source, authoring document structure, and child widget sources while preserving
+ * an exportable artifact for incompatible legacy records.
+ */
+declare function inspectLegacyPublishedPagePayload(request: GovernedPageLegacyImportRequest, childValidators?: PageChildDocumentValidators): GovernedPageLegacyInspectionResult;
+declare class GovernedPageWorkflowController {
+    private readonly persistence;
+    private readonly childValidators;
+    private readonly previewAdapters;
+    private readonly idGenerator;
+    private contextGeneration;
+    private contextKey;
+    private readonly fencedOperations;
+    private readonly childSourcesByWidgetId;
+    private readonly stateSubject;
+    readonly snapshot$: Observable<GovernedPageWorkflowSnapshot>;
+    constructor(config: GovernedPageWorkflowControllerConfig);
+    get snapshot(): GovernedPageWorkflowSnapshot;
+    setCapabilities(capabilities: GovernedPageCapabilities): void;
+    /**
+     * Advances monotonic context generation on context switch (including A -> B -> A),
+     * invalidating any in-flight callbacks from previous generations.
+     */
+    setContextKey(nextContextKey: string): void;
+    destroy(): void;
+    createNativePage(request: GovernedPageCreateNativeRequest): Promise<PageCreationReceipt>;
+    copyPublishedPage(request: GovernedPageCopyPublishedRequest): Promise<PageCreationReceipt>;
+    /**
+     * Explicitly imports a compatible legacy `published-page:<uuid>` record into a governed draft
+     * preserving the `/pages/<uuid>` address (`{ componentType: 'praxis-dynamic-page', componentId: pageId }`).
+     * Never fabricates approval or publication state and never deletes legacy storage keys.
+     */
+    importLegacyPublishedPage(request: GovernedPageLegacyImportRequest): Promise<GovernedPageWorkflowSnapshot>;
+    openDraftWorkspace(pageId: string, draftId: string, options?: {
+        source?: PageSourceReference | null;
+    }): Promise<GovernedPageWorkflowSnapshot>;
+    updateWorkingDocument(nextDocument: PageAuthoringDocument): PageAuthoringDocument;
+    updatePresentation(presentation: PageAuthoringDocument['config']['presentation']): PageAuthoringDocument;
+    upsertNavigationBinding(binding: PageNavigationBinding, options?: PageNavigationBindingUpdateOptions): PageAuthoringDocument;
+    /**
+     * Updates a child widget's inputs inside the page's authoring document and
+     * records its governed child source so child widgets remain under page authorship.
+     */
+    updateChildWidgetInputs(widgetKey: string, inputs: Record<string, unknown>, childSource?: UiLayoutPageChildSource): PageAuthoringDocument;
+    buildInteractivePreview(baseContext?: Record<string, unknown>): GovernedPagePreviewMaterialization;
+    saveDraftRevision(reason?: string): Promise<GovernedPageWorkflowSnapshot>;
+    assignScope(input: GovernedPageAssignmentInput): Promise<GovernedPageWorkflowSnapshot>;
+    saveAndSubmitForReview(options?: GovernedPageSubmitOptions): Promise<GovernedPageWorkflowSnapshot>;
+    approveRelease(reason?: string): Promise<GovernedPageWorkflowSnapshot>;
+    publishRelease(reason?: string): Promise<GovernedPageWorkflowSnapshot>;
+    approveAndPublish(reason?: string): Promise<GovernedPageWorkflowSnapshot>;
+    /**
+     * Reconciles a fenced operation after an ambiguous network failure (`COMMAND_OUTCOME_UNCERTAIN`)
+     * using the canonical read endpoints before unlocking retries.
+     */
+    reconcileUncertainOperation(attemptKey: string): Promise<GovernedPageWorkflowSnapshot>;
+    /**
+     * Reloads server state after a 409 Conflict or 412 Precondition Failed response.
+     */
+    reloadAfterConflict(): Promise<GovernedPageWorkflowSnapshot>;
+    private executePageCreation;
+    private applyDraftWorkspaceReceipt;
+    private refreshPublishedAndLifecycleMetadata;
+    private requireCapability;
+    private requireWorkingDocument;
+    private requireLoadedDraft;
+    private assertNotFenced;
+    private isStale;
+    private assertActiveContext;
+    private handleOperationError;
+    private fail;
+    private isLifecycleContractErrorLike;
+    private isWorkflowError;
+    private setBusy;
+    private publishSnapshot;
+}
+
+export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionEditorComponent, DEFAULT_CORPORATE_NAVIGATION_GROUPS_TARGET, DEFAULT_GOVERNED_PAGE_CHILD_VALIDATORS, DEFAULT_GOVERNED_PAGE_PREVIEW_ADAPTERS, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, GOVERNED_PAGE_CAPABILITY_KEYS, GovernedPageNavigationController, GovernedPageWorkflowController, LEGACY_PUBLISHED_PAGE_STORAGE_PREFIX, 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, PraxisPageCopyActionComponent, PraxisPageSaveAsComponent, TileToolbarComponent, UiCompositionResourcePreflightService, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, createCorporateGovernedPagePersistenceAdapter, createLocalPageSaveAsAdapter, deriveGovernedPageCapabilities, getPageAiCatalog, getWidgetAiCapabilities, inspectLegacyPublishedPagePayload, isComponentDocMeta, preflightUiCompositionPlan, preflightUiCompositionPlanResources, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, providePraxisPageBuilderWidgets, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan, verifyUiCompositionAuthoringSource };
+export type { Capability, CapabilityCatalog, CapabilityCategory, CollectionScreenComposerConfig, ComponentPaletteData, ComponentPaletteSelection, ConfirmDialogData, GovernedNavigationGroupPublishInput, GovernedPageAssignmentInput, GovernedPageCapabilities, GovernedPageCopyPublishedRequest, GovernedPageCreateNativeRequest, GovernedPageLegacyExportArtifact, GovernedPageLegacyImportRequest, GovernedPageLegacyInspectionResult, GovernedPageLocalSaveAdapter, GovernedPageNavigationControllerConfig, GovernedPageNavigationSnapshot, GovernedPageOperationKind, GovernedPagePersistenceAdapter, GovernedPageReadResult, GovernedPageSubmitOptions, GovernedPageUncertainOperation, GovernedPageWorkflowControllerConfig, GovernedPageWorkflowError, GovernedPageWorkflowSnapshot, GuidedDataSourceQueryConfig, GuidedDataSourceTransformConfig, GuidedDerivedMeasureConfig, 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, PageSaveAsAdapter, PageSaveAsRequest, PageSaveAsResult, PaletteCategory, PaletteExistingCanvasItem, QueuedPaletteItem, 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 };