@praxisui/page-builder 10.0.0-rc.3 → 10.0.0-rc.30

package/package.json

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

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, 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 } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
 import { FormGroup, FormControl, FormArray, AbstractControl } from '@angular/forms';
@@ -344,7 +344,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 +1091,50 @@ declare class CanvasConstraintEditorModel {
         width: number;
         height: number;
     };
+    private resolveFriendlyWidgetTitle;
 }
 
+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 +1147,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 +1243,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
         key: string;
         number: number;
         label: string;
+        widgetKey?: string;
         col: number;
         row: number;
         colSpan: number;
@@ -1228,6 +1286,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,19 +1302,51 @@ 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 i18n;
+    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 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;
@@ -1265,6 +1357,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 +1388,61 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private stackedCanvas;
     addGroupingNode(seed?: WidgetPageGroupingDefinition): void;
     removeGroupingNode(index: number): 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[];
+    };
+    addGuidedDerivedMeasure(config?: Partial<GuidedDerivedMeasureConfig>): boolean;
+    getDerivedStatePreview(): {
+        entries: Array<{
+            key: string;
+            value: unknown;
+            formattedValue: string;
+            token: string;
+        }>;
+        diagnostics: string[];
+    };
+    availableStateBindingTokens(): string[];
+    bindablePageWidgets(): Array<{
+        key: string;
+        title: string;
+        componentId: string;
+    }>;
+    bindStateTokenToWidget(widgetKey?: string, inputPath?: string, stateToken?: string): boolean;
+    currentWidgetStateBindings(): Array<{
+        widgetKey: string;
+        widgetTitle: string;
+        inputPath: string;
+        token: string;
+    }>;
+    composeCollectionScreen(overrides?: Partial<CollectionScreenComposerConfig>): WidgetPageDefinition | null;
+    quickCanvasWidgets(): Array<{
+        key: string;
+        label: 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[];
+        linkIds: string[];
+    }>;
+    consolidateFilterOwnership(tableKey: string, mode: 'keep-table-toolbar' | 'keep-external-link'): void;
+    private resolveWidgetTitle;
+    private isFilterLinkTargetingWidget;
     layoutPresetSummary(preset: LayoutPresetEntry): string;
     slotsSummary(preset: LayoutPresetEntry): string;
     requiredSlotsSummary(preset: LayoutPresetEntry): string;
@@ -1304,6 +1462,12 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     protected refreshRenderedValidation(): void;
     private createDeviceVariantForm;
     private createGroupingNodeGroup;
+    private createDataSourceNodeGroup;
+    private replaceDataSourceNodes;
+    private buildDataSourcesFromNodes;
+    private syncDataSourcesJsonFromNodes;
+    private syncDataSourceNodesFromJson;
+    private inferPageResourcePath;
     private hydrate;
     private replaceGroupingNodes;
     private buildCurrentPage;
@@ -1316,13 +1480,19 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private invalidate;
     private refreshPanelState;
     get layoutPresetOptions(): WidgetPageDefinition['layoutPresetOptions'];
+    private effectivePageInput;
     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 +1507,12 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private applyShellPresetToContext;
     private lookupPresetLabel;
     private defaultCanvas;
+    private parseKeyValuePairs;
+    private buildSamplePayloadForDataSource;
+    private collectStateTokensForValue;
+    private assignNestedValue;
+    private collectWidgetBindingsRecursive;
+    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 +1584,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 +1626,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 +1667,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 +1690,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 +1714,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 +1727,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 +2367,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 +2481,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 +2533,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 +2568,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 +2579,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 +2651,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;
@@ -2476,15 +2697,10 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     addWidget(selection: string | ComponentPaletteSelection): void;
     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 +2934,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 +2942,19 @@ 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[];
+
+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, isComponentDocMeta, preflightUiCompositionPlan, preflightUiCompositionPlanResources, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, providePraxisPageBuilderWidgets, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, validateUiCompositionPlan, verifyUiCompositionAuthoringSource };
+export type { Capability, CapabilityCatalog, CapabilityCategory, CollectionScreenComposerConfig, ComponentPaletteData, ComponentPaletteSelection, ConfirmDialogData, 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, 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 };