@praxisui/page-builder 9.0.61 → 9.0.63

package/package.json

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

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

@@ -1,12 +1,13 @@
 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 { ComponentDocMeta, ComponentMetadataRegistry, PraxisI18nService, WidgetShellConfig, WidgetPageAuthoringCapabilities, WidgetShellAction, EndpointRef, ComponentPortPathSegment, LinkIntent, CompositionLink, WidgetPageDefinition, TransformKind, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, PraxisRuntimeComponentObservationEnvelope, WidgetPageCanvasLayout, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, TransformOutputHint, TransformSemanticKind, ComponentContextPack, ComponentAuthoringManifest, DiagnosticRecord, NestedPortCatalogRegistry, CompositionValidatorService, ApiUrlEntry, DynamicWidgetPageComponent, WidgetEventEnvelope, ObservabilityAgenticTurnMetrics, SettingsPanelBridge, ObservabilityAgenticTurnMetricBucket, RichTimelineItem } from '@praxisui/core';
+import { ComponentDocMeta, ComponentMetadataRegistry, PraxisI18nService, WidgetShellConfig, WidgetPageAuthoringCapabilities, WidgetShellAction, EndpointRef, ComponentPortPathSegment, LinkIntent, CompositionLink, WidgetPageDefinition, TransformKind, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, WidgetPageCanvasLayout, 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 * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
 import { FormGroup, FormControl, FormArray } from '@angular/forms';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
 import { AgenticAuthoringAttachmentSummaryContract, AgenticAuthoringCandidateContract, AiJsonValue, AgenticAuthoringComponentCapabilitiesResultContract, AgenticAuthoringComponentCapabilityCatalogContract, AgenticAuthoringComponentCapabilityContract, AgenticAuthoringComponentFieldAliasContract, AgenticAuthoringComponentCapabilityExampleContract, AgenticAuthoringConversationMessageContract, AgenticAuthoringIntentResolutionRequestContract, AiJsonObject, AgenticAuthoringQuickReplyContract, AgenticAuthoringPendingClarificationContract, AiContextHintsContract, AgenticAuthoringSemanticDecisionContract, AgenticAuthoringPlanRequestContract, AgenticAuthoringResourceCandidatesRequestContract, AgenticAuthoringResourceCandidatesResultContract, AgenticAuthoringTurnStreamContextHintsContract, AgenticAuthoringTurnStreamEnvelopeContract, AgenticAuthoringTurnStreamStartResponseContract, PraxisAssistantVoiceInputMode, PraxisAssistantShellMessage, PraxisAssistantShellQuickReply, PraxisAssistantShellAttachment, PraxisAssistantShellLayout, PraxisAssistantSessionSnapshot, PraxisAssistantShellLabels, PraxisAssistantRecommendedIntent, PraxisAssistantShellAction, PraxisAssistantShellState, PraxisAssistantShellContextItem } from '@praxisui/ai';
+import * as _praxisui_page_builder from '@praxisui/page-builder';
 
 declare const PLACEHOLDER = 1;
 
@@ -1240,6 +1241,254 @@ interface CapabilityCatalog extends AiCapabilityCatalog {
 }
 declare const PAGE_BUILDER_AI_CAPABILITIES: CapabilityCatalog;
 
+type UiCompositionPlanInputSource = 'event' | 'payload' | 'state' | 'context' | 'constant';
+type UiCompositionPlanTransformOutput = TransformOutputHint & {
+    semanticKind: TransformSemanticKind;
+};
+type UiCompositionPlanComponentPortEndpoint = {
+    kind: 'component-port';
+    widget: string;
+    port: string;
+    direction: 'input' | 'output';
+    nestedPath?: ComponentPortPathSegment[];
+};
+type UiCompositionPlanStateEndpoint = {
+    kind: 'state';
+    path: string;
+    layer?: 'values' | 'derived' | 'transient';
+};
+type UiCompositionPlanGlobalActionEndpoint = {
+    kind: 'global-action';
+    actionId: string;
+    payload?: unknown;
+    payloadExpr?: string;
+    meta?: Record<string, unknown>;
+};
+/**
+ * A runtime event source emitted through `dynamicPage.composition.dispatch`.
+ * Only actionId participates in canonical endpoint matching; payload is always
+ * supplied by the runtime dispatch event.
+ */
+type UiCompositionPlanGlobalActionSourceEndpoint = Pick<UiCompositionPlanGlobalActionEndpoint, 'kind' | 'actionId'>;
+type UiCompositionPlanSourceEndpoint = UiCompositionPlanComponentPortEndpoint | UiCompositionPlanStateEndpoint | UiCompositionPlanGlobalActionSourceEndpoint;
+type UiCompositionPlanTargetEndpoint = UiCompositionPlanComponentPortEndpoint | UiCompositionPlanStateEndpoint | UiCompositionPlanGlobalActionEndpoint;
+type UiCompositionPlanEndpoint = UiCompositionPlanTargetEndpoint;
+interface UiCompositionPlanSelectCase {
+    /** Canonical Json Logic guard evaluated against event/payload/state/context/source. */
+    when: unknown;
+    /** Total branch value. Structured values may use the normal ${...} template bindings. */
+    value: unknown;
+}
+type UiCompositionPlanTransform = {
+    kind: 'pick-path';
+    id: string;
+    path: string;
+    inputSource?: UiCompositionPlanInputSource;
+    /** Explicit value delivered when the projection resolves to undefined. */
+    fallbackValue?: unknown;
+} | {
+    kind: 'constant';
+    id: string;
+    value: unknown;
+} | {
+    kind: 'query-context';
+    id: string;
+    field: string;
+    operator?: string;
+    valueVar?: string;
+    inputSource?: UiCompositionPlanInputSource;
+    fallbackValue?: unknown;
+} | {
+    kind: 'template';
+    id: string;
+    template: unknown;
+    inputSource?: UiCompositionPlanInputSource;
+    /** Explicit semantic contract produced by the template after materialization. */
+    output?: UiCompositionPlanTransformOutput;
+    fallbackValue?: unknown;
+} | {
+    kind: 'select-case';
+    id: string;
+    cases: UiCompositionPlanSelectCase[];
+    /** Required total fallback when no branch matches. */
+    defaultValue: unknown;
+    inputSource?: UiCompositionPlanInputSource;
+    /** Optional semantic contract overriding the shape inferred from defaultValue. */
+    output?: UiCompositionPlanTransformOutput;
+    fallbackValue?: unknown;
+};
+interface UiCompositionPlanWidget {
+    key: string;
+    componentId: string;
+    role?: string;
+    shell?: WidgetInstance['shell'];
+    inputs?: Record<string, unknown>;
+    outputs?: Record<string, unknown>;
+    bindingOrder?: string[];
+}
+interface UiCompositionPlanBinding {
+    id: string;
+    from: UiCompositionPlanSourceEndpoint;
+    to: UiCompositionPlanTargetEndpoint;
+    intent: CompositionLink['intent'];
+    condition?: unknown;
+    transform?: UiCompositionPlanTransform;
+    policy?: CompositionLink['policy'];
+    metadata?: Record<string, unknown>;
+}
+type UiCompositionPlanSelectionSyncMapping = string | {
+    path: string;
+    inputSource?: UiCompositionPlanInputSource;
+    condition?: unknown;
+};
+/**
+ * Semantic authoring shorthand for projecting the same selection emitted by one
+ * or more component outputs into page state. The compiler expands this shape
+ * into explicit canonical composition links before preview or persistence.
+ */
+interface UiCompositionPlanSelectionSync {
+    id: string;
+    intent: 'selection-sync';
+    sources: UiCompositionPlanComponentPortEndpoint[];
+    target: UiCompositionPlanStateEndpoint;
+    mapping: Record<string, UiCompositionPlanSelectionSyncMapping>;
+    policy?: CompositionLink['policy'];
+    metadata?: Record<string, unknown>;
+}
+type UiCompositionPlanContextValue = {
+    kind: 'constant';
+    value: unknown;
+} | {
+    kind: 'state';
+    path: string;
+    layer?: 'values' | 'derived' | 'transient';
+    condition?: unknown;
+    /** Explicit value materialized before the first state propagation. */
+    initial?: unknown;
+};
+interface UiCompositionPlanContextScopeTarget {
+    widget: string;
+    nestedPath?: ComponentPortPathSegment[];
+    inherit?: string[];
+}
+/**
+ * Groups reusable parent/resource context for one or more component targets.
+ * Constants and explicit state initial values become widget inputs, while
+ * state values become canonical links during compilation. No hidden runtime
+ * inheritance remains in the executable page.
+ */
+interface UiCompositionPlanContextScope {
+    id: string;
+    context: Record<string, UiCompositionPlanContextValue>;
+    targets: UiCompositionPlanContextScopeTarget[];
+    policy?: CompositionLink['policy'];
+    metadata?: Record<string, unknown>;
+}
+interface UiCompositionPlan {
+    version: '1.0';
+    kind: 'praxis.ui-composition-plan';
+    /** Page-owned business copy compiled verbatim into WidgetPageDefinition.i18n. */
+    i18n?: WidgetPageDefinition['i18n'];
+    /** Explicit page-wide context compiled into WidgetPageDefinition.context. */
+    context?: WidgetPageDefinition['context'];
+    /** Canonical responsive grid layout compiled into WidgetPageDefinition.layout. */
+    layout?: WidgetPageDefinition['layout'];
+    layoutPreset?: string;
+    layoutPresetOptions?: Record<string, unknown>;
+    canvas?: WidgetPageCanvasLayout;
+    deviceLayouts?: WidgetPageDeviceLayouts;
+    grouping?: WidgetPageGroupingDefinition[];
+    slotAssignments?: WidgetPageSlotAssignments;
+    state?: WidgetPageStateInput;
+    themePreset?: string;
+    widgets: UiCompositionPlanWidget[];
+    selectionSyncs?: UiCompositionPlanSelectionSync[];
+    contextScopes?: UiCompositionPlanContextScope[];
+    bindings?: UiCompositionPlanBinding[];
+    /** Non-executable authoring and resolution evidence; never copied into WidgetPageDefinition. */
+    diagnostics?: Record<string, unknown>;
+}
+interface UiCompositionPlanTemplateRef {
+    registryKey: string;
+    configSha256: string;
+}
+/** Compact intermediate authoring input. It is never a runtime persistence shape. */
+interface UiCompositionPlanTemplateReference {
+    version: '1.0';
+    kind: 'praxis.ui-composition-plan';
+    templateRef: UiCompositionPlanTemplateRef;
+    overrides?: Readonly<Record<string, never>>;
+}
+interface UiCompositionPlanTemplateRevision {
+    version?: number;
+    etag?: string;
+    configSha256: string;
+}
+/** Exact template body and revision evidence supplied by the governed backend. */
+interface UiCompositionPlanTemplateMaterialization {
+    registryKey: string;
+    revision: UiCompositionPlanTemplateRevision;
+    authoringPlan: UiCompositionPlan;
+}
+type UiCompositionPlanAuthoringInput = UiCompositionPlan | UiCompositionPlanTemplateReference;
+type UiCompositionPlanTemplateResolutionResult = {
+    valid: true;
+    referenced: boolean;
+    plan: UiCompositionPlan;
+    diagnostics: UiCompositionPlanDiagnostic[];
+} | {
+    valid: false;
+    referenced: true;
+    plan: null;
+    diagnostics: UiCompositionPlanDiagnostic[];
+};
+interface UiCompositionPlanDiagnostic {
+    code: string;
+    message: string;
+    path?: string;
+}
+type UiCompositionPlanCompileResult = {
+    valid: true;
+    page: WidgetPageDefinition;
+    diagnostics: UiCompositionPlanDiagnostic[];
+} | {
+    valid: false;
+    page: null;
+    diagnostics: UiCompositionPlanDiagnostic[];
+};
+/**
+ * Pure, fail-closed normalization for an exact template reference.
+ *
+ * The function performs no HTTP, registry search or template selection. The governed backend must
+ * supply the exact materialization and its revision evidence before the existing compiler runs.
+ */
+declare function resolveUiCompositionPlanTemplate(input: UiCompositionPlanAuthoringInput, materialization?: UiCompositionPlanTemplateMaterialization): UiCompositionPlanTemplateResolutionResult;
+declare function compileUiCompositionPlan(plan: UiCompositionPlan): UiCompositionPlanCompileResult;
+declare function validateUiCompositionPlan(plan: UiCompositionPlan): UiCompositionPlanDiagnostic[];
+
+type UiCompositionPlanAuthoringSource = ConfigAuthoringSource<UiCompositionPlan>;
+type UiCompositionAuthoringSourceDiagnosticCode = 'authoring-source-absent' | 'authoring-source-schema-invalid' | 'authoring-source-kind-invalid' | 'authoring-source-plan-invalid' | 'authoring-source-provenance-invalid' | 'authoring-source-materialization-kind-invalid' | 'authoring-source-component-type-mismatch' | 'authoring-source-component-id-mismatch' | 'authoring-source-hash-mismatch' | 'authoring-source-materialization-hash-mismatch';
+interface UiCompositionAuthoringSourceDiagnostic {
+    code: UiCompositionAuthoringSourceDiagnosticCode;
+    message: string;
+    blocking: boolean;
+}
+interface UiCompositionAuthoringSourceVerification {
+    valid: boolean;
+    source: UiCompositionPlanAuthoringSource | null;
+    diagnostics: UiCompositionAuthoringSourceDiagnostic[];
+}
+interface UiCompositionAuthoringSourceVerificationContext {
+    componentId?: string | null;
+    componentType?: string | null;
+}
+/**
+ * Verifies that a persisted semantic source still describes the executable
+ * page opened by the builder. An invalid envelope is never returned as usable
+ * authoring context.
+ */
+declare function verifyUiCompositionAuthoringSource(candidate: unknown, page: WidgetPageDefinition, context?: UiCompositionAuthoringSourceVerificationContext): UiCompositionAuthoringSourceVerification;
+
 type PageBuilderAgenticAuthoringProvider = 'openai' | 'gemini' | string;
 interface PageBuilderAgenticAuthoringOptions {
     baseUrl?: string;
@@ -1497,6 +1746,7 @@ interface PageBuilderApplyResult {
     etag?: string;
     payload: BuilderPageDefinition;
     tags?: Record<string, unknown>;
+    authoringSource?: UiCompositionPlanAuthoringSource | null;
     warnings: string[];
 }
 declare const PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS: InjectionToken<PageBuilderAgenticAuthoringOptions>;
@@ -1531,211 +1781,6 @@ declare class PageBuilderAgenticAuthoringService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<PageBuilderAgenticAuthoringService>;
 }
 
-type UiCompositionPlanInputSource = 'event' | 'payload' | 'state' | 'context' | 'constant';
-type UiCompositionPlanTransformOutput = TransformOutputHint & {
-    semanticKind: TransformSemanticKind;
-};
-type UiCompositionPlanComponentPortEndpoint = {
-    kind: 'component-port';
-    widget: string;
-    port: string;
-    direction: 'input' | 'output';
-    nestedPath?: ComponentPortPathSegment[];
-};
-type UiCompositionPlanStateEndpoint = {
-    kind: 'state';
-    path: string;
-    layer?: 'values' | 'derived' | 'transient';
-};
-type UiCompositionPlanGlobalActionEndpoint = {
-    kind: 'global-action';
-    actionId: string;
-    payload?: unknown;
-    payloadExpr?: string;
-    meta?: Record<string, unknown>;
-};
-/**
- * A runtime event source emitted through `dynamicPage.composition.dispatch`.
- * Only actionId participates in canonical endpoint matching; payload is always
- * supplied by the runtime dispatch event.
- */
-type UiCompositionPlanGlobalActionSourceEndpoint = Pick<UiCompositionPlanGlobalActionEndpoint, 'kind' | 'actionId'>;
-type UiCompositionPlanSourceEndpoint = UiCompositionPlanComponentPortEndpoint | UiCompositionPlanStateEndpoint | UiCompositionPlanGlobalActionSourceEndpoint;
-type UiCompositionPlanTargetEndpoint = UiCompositionPlanComponentPortEndpoint | UiCompositionPlanStateEndpoint | UiCompositionPlanGlobalActionEndpoint;
-type UiCompositionPlanEndpoint = UiCompositionPlanTargetEndpoint;
-type UiCompositionPlanTransform = {
-    kind: 'pick-path';
-    id: string;
-    path: string;
-    inputSource?: UiCompositionPlanInputSource;
-} | {
-    kind: 'constant';
-    id: string;
-    value: unknown;
-} | {
-    kind: 'query-context';
-    id: string;
-    field: string;
-    operator?: string;
-    valueVar?: string;
-    inputSource?: UiCompositionPlanInputSource;
-} | {
-    kind: 'template';
-    id: string;
-    template: unknown;
-    inputSource?: UiCompositionPlanInputSource;
-    /** Explicit semantic contract produced by the template after materialization. */
-    output?: UiCompositionPlanTransformOutput;
-};
-interface UiCompositionPlanWidget {
-    key: string;
-    componentId: string;
-    role?: string;
-    shell?: WidgetInstance['shell'];
-    inputs?: Record<string, unknown>;
-    outputs?: Record<string, unknown>;
-    bindingOrder?: string[];
-}
-interface UiCompositionPlanBinding {
-    id: string;
-    from: UiCompositionPlanSourceEndpoint;
-    to: UiCompositionPlanTargetEndpoint;
-    intent: CompositionLink['intent'];
-    condition?: unknown;
-    transform?: UiCompositionPlanTransform;
-    policy?: CompositionLink['policy'];
-    metadata?: Record<string, unknown>;
-}
-type UiCompositionPlanSelectionSyncMapping = string | {
-    path: string;
-    inputSource?: UiCompositionPlanInputSource;
-    condition?: unknown;
-};
-/**
- * Semantic authoring shorthand for projecting the same selection emitted by one
- * or more component outputs into page state. The compiler expands this shape
- * into explicit canonical composition links before preview or persistence.
- */
-interface UiCompositionPlanSelectionSync {
-    id: string;
-    intent: 'selection-sync';
-    sources: UiCompositionPlanComponentPortEndpoint[];
-    target: UiCompositionPlanStateEndpoint;
-    mapping: Record<string, UiCompositionPlanSelectionSyncMapping>;
-    policy?: CompositionLink['policy'];
-    metadata?: Record<string, unknown>;
-}
-type UiCompositionPlanContextValue = {
-    kind: 'constant';
-    value: unknown;
-} | {
-    kind: 'state';
-    path: string;
-    layer?: 'values' | 'derived' | 'transient';
-    condition?: unknown;
-    /** Explicit value materialized before the first state propagation. */
-    initial?: unknown;
-};
-interface UiCompositionPlanContextScopeTarget {
-    widget: string;
-    nestedPath?: ComponentPortPathSegment[];
-    inherit?: string[];
-}
-/**
- * Groups reusable parent/resource context for one or more component targets.
- * Constants and explicit state initial values become widget inputs, while
- * state values become canonical links during compilation. No hidden runtime
- * inheritance remains in the executable page.
- */
-interface UiCompositionPlanContextScope {
-    id: string;
-    context: Record<string, UiCompositionPlanContextValue>;
-    targets: UiCompositionPlanContextScopeTarget[];
-    policy?: CompositionLink['policy'];
-    metadata?: Record<string, unknown>;
-}
-interface UiCompositionPlan {
-    version: '1.0';
-    kind: 'praxis.ui-composition-plan';
-    /** Page-owned business copy compiled verbatim into WidgetPageDefinition.i18n. */
-    i18n?: WidgetPageDefinition['i18n'];
-    /** Explicit page-wide context compiled into WidgetPageDefinition.context. */
-    context?: WidgetPageDefinition['context'];
-    /** Canonical responsive grid layout compiled into WidgetPageDefinition.layout. */
-    layout?: WidgetPageDefinition['layout'];
-    layoutPreset?: string;
-    layoutPresetOptions?: Record<string, unknown>;
-    canvas?: WidgetPageCanvasLayout;
-    deviceLayouts?: WidgetPageDeviceLayouts;
-    grouping?: WidgetPageGroupingDefinition[];
-    slotAssignments?: WidgetPageSlotAssignments;
-    state?: WidgetPageStateInput;
-    themePreset?: string;
-    widgets: UiCompositionPlanWidget[];
-    selectionSyncs?: UiCompositionPlanSelectionSync[];
-    contextScopes?: UiCompositionPlanContextScope[];
-    bindings?: UiCompositionPlanBinding[];
-    /** Non-executable authoring and resolution evidence; never copied into WidgetPageDefinition. */
-    diagnostics?: Record<string, unknown>;
-}
-interface UiCompositionPlanTemplateRef {
-    registryKey: string;
-    configSha256: string;
-}
-/** Compact intermediate authoring input. It is never a runtime persistence shape. */
-interface UiCompositionPlanTemplateReference {
-    version: '1.0';
-    kind: 'praxis.ui-composition-plan';
-    templateRef: UiCompositionPlanTemplateRef;
-    overrides?: Readonly<Record<string, never>>;
-}
-interface UiCompositionPlanTemplateRevision {
-    version?: number;
-    etag?: string;
-    configSha256: string;
-}
-/** Exact template body and revision evidence supplied by the governed backend. */
-interface UiCompositionPlanTemplateMaterialization {
-    registryKey: string;
-    revision: UiCompositionPlanTemplateRevision;
-    authoringPlan: UiCompositionPlan;
-}
-type UiCompositionPlanAuthoringInput = UiCompositionPlan | UiCompositionPlanTemplateReference;
-type UiCompositionPlanTemplateResolutionResult = {
-    valid: true;
-    referenced: boolean;
-    plan: UiCompositionPlan;
-    diagnostics: UiCompositionPlanDiagnostic[];
-} | {
-    valid: false;
-    referenced: true;
-    plan: null;
-    diagnostics: UiCompositionPlanDiagnostic[];
-};
-interface UiCompositionPlanDiagnostic {
-    code: string;
-    message: string;
-    path?: string;
-}
-type UiCompositionPlanCompileResult = {
-    valid: true;
-    page: WidgetPageDefinition;
-    diagnostics: UiCompositionPlanDiagnostic[];
-} | {
-    valid: false;
-    page: null;
-    diagnostics: UiCompositionPlanDiagnostic[];
-};
-/**
- * Pure, fail-closed normalization for an exact template reference.
- *
- * The function performs no HTTP, registry search or template selection. The governed backend must
- * supply the exact materialization and its revision evidence before the existing compiler runs.
- */
-declare function resolveUiCompositionPlanTemplate(input: UiCompositionPlanAuthoringInput, materialization?: UiCompositionPlanTemplateMaterialization): UiCompositionPlanTemplateResolutionResult;
-declare function compileUiCompositionPlan(plan: UiCompositionPlan): UiCompositionPlanCompileResult;
-declare function validateUiCompositionPlan(plan: UiCompositionPlan): UiCompositionPlanDiagnostic[];
-
 type LegacyLayoutOptions = {
     cols?: number;
     rowHeight?: number;
@@ -1963,6 +2008,8 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     agenticAuthoringEnableStreaming: boolean;
     agenticAuthoringVoiceInputMode: PraxisAssistantVoiceInputMode;
     agenticAuthoringContextHints?: Record<string, unknown> | null;
+    /** Canonical persisted payload, revision and semantic source used to reopen authoring. */
+    authoringDocument?: ConfigDocument<WidgetPageDefinition> | null;
     showPageLifecycleActions: boolean;
     canDeleteSavedPage: boolean;
     pageLifecycleBusy: boolean;
@@ -1996,6 +2043,9 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private readonly agenticAuthoringApplyTarget;
     readonly agenticAuthoringCanApply: _angular_core.WritableSignal<boolean>;
     readonly agenticAuthoringLastEtag: _angular_core.WritableSignal<string | null>;
+    private readonly persistedUiCompositionAuthoringSource;
+    readonly uiCompositionAuthoringSourceVerification: _angular_core.Signal<_praxisui_page_builder.UiCompositionAuthoringSourceVerification>;
+    readonly uiCompositionAuthoringBlockingDiagnostics: _angular_core.Signal<UiCompositionAuthoringSourceDiagnostic[]>;
     readonly agenticAuthoringConversation: _angular_core.WritableSignal<PraxisAssistantShellMessage[]>;
     readonly agenticAuthoringQuickReplies: _angular_core.WritableSignal<AgenticAuthoringQuickReply[]>;
     readonly agenticAuthoringAttachments: _angular_core.WritableSignal<PraxisAssistantShellAttachment[]>;
@@ -2024,6 +2074,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     readonly agenticAuthoringPanelLayout: _angular_core.WritableSignal<PraxisAssistantShellLayout>;
     private readonly previewMode;
     private runtimePageCache?;
+    private lastRuntimePageChangeFingerprint;
     private agenticComponentCapabilities?;
     private agenticComponentCapabilitiesPromise?;
     private agenticTurnController?;
@@ -2302,9 +2353,10 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private describeAgenticError;
     private looksLikeHtmlErrorResponse;
     private cloneValue;
+    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; }; "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; }; "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>;
 }
 
 /** Metadata for Praxis Page Builder component */
@@ -2312,5 +2364,5 @@ 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 };
-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, UiCompositionPlan, UiCompositionPlanAuthoringInput, UiCompositionPlanBinding, UiCompositionPlanCompileResult, UiCompositionPlanComponentPortEndpoint, UiCompositionPlanContextScope, UiCompositionPlanContextScopeTarget, UiCompositionPlanContextValue, UiCompositionPlanDiagnostic, UiCompositionPlanEndpoint, UiCompositionPlanGlobalActionEndpoint, UiCompositionPlanGlobalActionSourceEndpoint, UiCompositionPlanInputSource, UiCompositionPlanPreflightResult, UiCompositionPlanSelectionSync, UiCompositionPlanSelectionSyncMapping, UiCompositionPlanSourceEndpoint, UiCompositionPlanStateEndpoint, UiCompositionPlanTargetEndpoint, UiCompositionPlanTemplateMaterialization, UiCompositionPlanTemplateRef, UiCompositionPlanTemplateReference, UiCompositionPlanTemplateResolutionResult, UiCompositionPlanTemplateRevision, UiCompositionPlanTransform, UiCompositionPlanTransformOutput, UiCompositionPlanWidget, UiCompositionResourceSchemaRequest, UiCompositionResourceSchemaResolution, UiCompositionResourceSchemaResolver, ValueKind };
+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 };