@praxisui/page-builder 9.0.46 → 9.0.48

package/README.md

@@ -86,6 +86,11 @@ All omitted `authoringCapabilities` entries remain enabled for backward compatib
 never written to `WidgetPageDefinition` and does not authorize AI operations; manifests, backend
 policy, target resolution and validation remain authoritative.
 
+`childCustomization` is a host grant, not a bulk enable switch. A nested component receives
+`enableCustomization=true` only while the builder is in authoring mode, the host grant is enabled,
+and that widget explicitly declares `definition.inputs.enableCustomization=true`. Widgets with an
+absent or false authored opt-in remain presentation-only.
+
 For example, a host that should expose only canvas and shell-identity authoring can declare:
 
 ```ts
@@ -262,6 +267,8 @@ The package exports `PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST` for governed operat
 
 The visual authoring runtime may project editor-only inputs required by canvas affordances. Page changes emitted by that runtime are normalized back to the canonical `WidgetPageDefinition` before persistence: transient authoring inputs are removed, explicitly authored values are preserved, and a projection-only no-op does not create a new revision.
 
+`saveCurrentPage()` reads the embedded Dynamic Page snapshot only while the editable canvas is active. In presentation mode, composition may hydrate component inputs and derive display layout; those values are runtime projections and must never overwrite the canonical `currentPage` during save. Presentation-mode save therefore emits a clone of the authored page, preserving widgets, links, state, layout and provenance exactly.
+
 `UiCompositionPlan` can carry the complete page-owned envelope required by the runtime: `i18n`, explicit `context`, canonical `layout`, state, presets, responsive variants, governed widget `shell`, component inputs and semantic wiring. The compiler clones these fields into `WidgetPageDefinition`; hosts must not add business copy, tenant context, layout or widget chrome after compilation as an undocumented enrichment step. `context` is page-wide runtime context, while `contextScopes` is an authoring shorthand that expands repeated values into explicit widget inputs and links.
 
 Repeated selection projections can be authored once through `UiCompositionPlan.selectionSyncs`. A sync declares structured component-output sources, a base state target, and a field-to-payload mapping. `compileUiCompositionPlan` expands every source/mapping pair into explicit `page.composition.links` with stable ids, canonical `pick-path` transforms, policy, condition, and `selection-sync` intent. The shorthand is never persisted in `WidgetPageDefinition`, so runtime inspection and audit continue to see the complete executable graph.
@@ -289,6 +296,13 @@ Compiled links may retain `metadata.source: 'ui-composition-plan'` as explicit a
 
 `bindings[].from` accepts `global-action` as the canonical continuation source for results emitted through `dynamicPage.composition.dispatch`. The authored source declares only a stable `actionId`; the runtime dispatch payload is the value delivered to state or component targets. `payload`, `payloadExpr`, `meta`, labels and result-type hints do not participate in endpoint matching and fail closed when placed on a global-action source. Those fields remain valid only for global-action targets, where they configure command dispatch. The compiler persists the source as `{ kind: 'global-action', ref: { actionId } }`, matching Core's existing runtime contract without a host adapter.
 
+When a `template` transform changes the semantic kind of its source, declare
+`transform.output.semanticKind` (and, when applicable, `schemaId`, `schemaRef`
+and `stableShape`). The compiler projects the same output hint onto the canonical
+pipeline and its materializing step, allowing registry-aware preflight to compare
+the transformed contract with the target port. Do not relax target compatibility
+or relabel the source port to hide a transformation.
+
 The official Employee Operations case is an executable regression for this boundary. Its first-class `*.ui-composition-plan.json` artifact expresses 22 persisted links as one `selectionSyncs` declaration, two `contextScopes` declarations and one explicit transformed binding, while compilation preserves the same 22 source/target paths, guards, transforms and policies. This reduces the wiring declarations from 22 to 4 (82%) without hiding the executable graph from runtime inspection, audit or the public JSON viewer. Context scopes are deliberately limited to direct inheritance: a value that must be wrapped or reshaped remains an explicit binding with a canonical transform.
 
 Page-owned copy can remain compact in the authoring plan. When a `PraxisTextValue` descriptor declares only `{ key }` and the key exists in `i18n.dictionaries[fallbackLocale]`, both canonical compilers materialize that message as the descriptor's runtime `text` fallback. The persisted `WidgetPageDefinition` therefore stays portable while authors do not repeat the same fallback beside every key. Explicit `text` still wins and unknown keys remain untouched, so the compiler never invents copy.
@@ -313,11 +327,30 @@ Workspace contributors can exercise this path in the reference host at
 `/dynamic-page-lab`. Its **Certificação do UiCompositionPlan** station displays
 the compact plan, registry-aware preflight, compiled `WidgetPageDefinition`, real
 Dynamic Page, diagnostics, widget-event trail and sanitized runtime observation
-without introducing another compiler or registry. The initial deterministic
-scenario covers Table, shell, page state and a global-action target; an unknown
-component proves fail-closed behavior. The broader certification matrix and the
-known Page Builder limitation for a global action used as a binding source are
-tracked in issues #430 and #431 respectively.
+without introducing another compiler or registry. Its scenario catalog reuses the
+same A1-A5 plan fixtures exercised by focused certification specs—List,
+forms/filters, CRUD lifecycle, parent/related-resource and
+Table/shell/global-action. Seven adversarial scenarios prove fail-closed behavior
+for missing component, missing port, invalid direction, incompatible semantic
+kind, unguarded feedback, incomplete master-detail layout and a stale governed
+template hash. The browser proof for the related-resource scenario requires a real
+parent selection, the relationship filter and visible child columns/data derived
+from the remote schema; request success alone is insufficient. The same route's
+People Operations dashboard is authored as a 9-widget/10-binding plan and proves
+filter and governed decision propagation through the compiled graph. The lab also
+executes deterministic runtime reset, verifies JSON persistence invariants for
+every applicable scenario, and invokes the real Page Builder save output before
+reopening the rich People Operations page. Corrupted executable transforms and
+legacy `page.connections` remain Core/page-ingress adversarials because neither is
+a valid `UiCompositionPlan` input; the lab does not duplicate those boundary
+validators. The governed Config Starter + Quickstart gate remains tracked in
+issue #430; issue #431 closed the former global-action source limitation.
+
+For multi-consumer interaction state, author one `event -> state` binding and
+project `state -> component-port` to each consumer. A direct event delivery is
+transient; it must not become the page's durable semantic source across runtime
+recomposition. The People Operations certification scenario applies this rule to
+`state.activeFilter` and verifies the complete fan-out in the browser.
 
 When a preview contains both `uiCompositionPlan` and `compiledFormPatch`, the semantic plan is the attested source for local preview. Persistence rebuilds `patch.page` from that locally materialized page so a backend patch cannot bypass the registry-aware gate. Provider readiness in this cut means that the target registry contains owner metadata with a materializable Angular component type; uniform certification of the owner providers and bootstrap recipes remains tracked by issue #392 and is not inferred through Page Builder heuristics.
 

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-30T19:35:50.928Z",
+  "generatedAt": "2026-08-30T23:30:05.791Z",
   "packageName": "@praxisui/page-builder",
-  "packageVersion": "9.0.46",
+  "packageVersion": "9.0.48",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,

package/fesm2022/praxisui-page-builder.mjs

@@ -15840,6 +15840,7 @@ function toCompositionTransform(transform) {
     }
     if (transform.kind === 'template') {
         const template = clone(transform.template);
+        const output = transform.output ? clone(transform.output) : undefined;
         const structuredKind = Array.isArray(template)
             ? 'array-template'
             : template !== null && typeof template === 'object'
@@ -15863,8 +15864,10 @@ function toCompositionTransform(transform) {
                     config: {
                         template,
                     },
+                    ...(output ? { output } : {}),
                 },
             ],
+            ...(output ? { output } : {}),
         };
     }
     if (transform.kind === 'constant') {
@@ -21732,6 +21735,7 @@ function projectKnowledgeTarget(changeSet, conceptKey) {
 
 const AGENTIC_AUTHORING_TURN_INACTIVITY_TIMEOUT_MS = 180_000;
 const AGENTIC_LOCAL_PREVIEW_HISTORY_LIMIT = 20;
+const DEFAULT_RUNTIME_AUTHORING_CAPABILITIES = Object.freeze({});
 const AGENTIC_PAGE_COMPOSITION_REQUEST_OUTPUT = 'agenticPageCompositionRequested';
 class DynamicPageBuilderComponent {
     dialog;
@@ -21833,9 +21837,8 @@ class DynamicPageBuilderComponent {
         top: 96,
         margin: 24,
     }), ...(ngDevMode ? [{ debugName: "agenticAuthoringPanelLayout" }] : /* istanbul ignore next */ []));
-    previewMode = false;
-    runtimePreviewPageCache;
-    runtimeAuthoringPageCache;
+    previewMode = signal(false, ...(ngDevMode ? [{ debugName: "previewMode" }] : /* istanbul ignore next */ []));
+    runtimePageCache;
     agenticComponentCapabilities;
     agenticComponentCapabilitiesPromise;
     agenticTurnController;
@@ -21868,7 +21871,6 @@ class DynamicPageBuilderComponent {
             this.currentPage.set(this.parsePage(this.page) || { widgets: [] });
         }
         if (changes['authoringCapabilities']) {
-            this.runtimeAuthoringPageCache = undefined;
             if (!this.isAuthoringCapabilityEnabled('connections')) {
                 this.connectionsViewerOpen.set(false);
             }
@@ -21918,7 +21920,7 @@ class DynamicPageBuilderComponent {
         this.observabilityMetricsSubscription.unsubscribe();
     }
     showSettings() {
-        return !!this.enableCustomization && !this.previewMode;
+        return !!this.enableCustomization && !this.previewMode();
     }
     canInsertWidgets() {
         return this.showSettings() && this.isAuthoringCapabilityEnabled('insertWidgets');
@@ -21960,27 +21962,22 @@ class DynamicPageBuilderComponent {
         return this.authoringCapabilities?.[capability] !== false;
     }
     isPreviewMode() {
-        return this.previewMode;
+        return this.previewMode();
     }
     runtimePage() {
         const page = this.currentPage();
-        if (!this.previewMode && this.showSettings()) {
-            if (this.runtimeAuthoringPageCache?.source === page) {
-                return this.runtimeAuthoringPageCache.value;
-            }
-            const value = this.toAuthoringRuntimePage(page);
-            this.runtimeAuthoringPageCache = { source: page, value };
-            return value;
-        }
-        if (this.runtimePreviewPageCache?.source === page) {
-            return this.runtimePreviewPageCache.value;
+        if (this.runtimePageCache?.source === page) {
+            return this.runtimePageCache.value;
         }
-        const value = this.toPresentationRuntimePage(page);
-        this.runtimePreviewPageCache = { source: page, value };
+        const value = this.toRuntimeBasePage(page);
+        this.runtimePageCache = { source: page, value };
         return value;
     }
+    runtimeAuthoringCapabilities() {
+        return this.authoringCapabilities || DEFAULT_RUNTIME_AUTHORING_CAPABILITIES;
+    }
     builderModeLabel() {
-        if (this.previewMode) {
+        if (this.previewMode()) {
             return this.tx('builderMode.preview', 'Prévia');
         }
         if (this.showSettings() && this.connectionsViewerOpen()) {
@@ -21995,7 +21992,7 @@ class DynamicPageBuilderComponent {
         return this.tx('builderMode.presentation', 'Presentation');
     }
     onRuntimePageChange(next) {
-        const canonical = this.toCanonicalPageFromAuthoringRuntime(next);
+        const canonical = this.toCanonicalPageFromRuntime(next);
         if (JSON.stringify(canonical) === JSON.stringify(this.currentPage())) {
             return;
         }
@@ -22041,8 +22038,8 @@ class DynamicPageBuilderComponent {
     togglePreview() {
         if (!this.canPreviewPage())
             return;
-        this.previewMode = !this.previewMode;
-        if (this.previewMode) {
+        this.previewMode.update((current) => !current);
+        if (this.previewMode()) {
             this.enterPreviewMode();
         }
     }
@@ -22197,8 +22194,7 @@ class DynamicPageBuilderComponent {
             this.agenticAuthoringStatus.set(this.tx('agentic.status.reviewNeedsAttention', 'Complete this review in the assistant before saving.'));
             return;
         }
-        const runtimeSnapshot = this.runtime?.getPageSnapshot();
-        const cloned = this.toCanonicalPageFromAuthoringRuntime(runtimeSnapshot || this.currentPage());
+        const cloned = this.clonePage(this.currentPage());
         this.currentPage.set(cloned);
         this.pageChange.emit(cloned);
         this.pageSaveRequested.emit(this.clonePage(cloned));
@@ -22302,8 +22298,8 @@ class DynamicPageBuilderComponent {
         const action = issue.action;
         if (!action || !this.canRunPremiumReadinessAction(action))
             return;
-        if (this.previewMode) {
-            this.previewMode = false;
+        if (this.previewMode()) {
+            this.previewMode.set(false);
         }
         switch (action.kind) {
             case 'open-page-settings':
@@ -22459,7 +22455,7 @@ class DynamicPageBuilderComponent {
         if (this.showSettings()) {
             return true;
         }
-        return this.previewMode && this.hasAgenticAuthoringSession();
+        return this.previewMode() && this.hasAgenticAuthoringSession();
     }
     showAgenticAuthoringDock() {
         return this.showSettings()
@@ -24749,51 +24745,24 @@ class DynamicPageBuilderComponent {
         return JSON.stringify(this.currentPage());
     }
     enterPreviewMode() {
-        this.previewMode = true;
-        this.runtimePreviewPageCache = undefined;
+        this.previewMode.set(true);
         this.connectionsViewerOpen.set(false);
         this.agenticAuthoringLlmDiagnostics.set(null);
         this.sharedRuleCockpitCollapsed.set(true);
         this.projectKnowledgeCockpitCollapsed.set(true);
         this.selectedWidgetKey.set(null);
     }
-    toPresentationRuntimePage(page) {
-        const cloned = this.clonePage(page);
-        cloned.widgets = (cloned.widgets || []).map((widget) => this.toPresentationRuntimeWidget(widget));
-        return cloned;
-    }
-    toAuthoringRuntimePage(page) {
-        const cloned = this.clonePage(page);
-        if (!this.isAuthoringCapabilityEnabled('childCustomization')) {
-            return cloned;
-        }
-        cloned.widgets = (cloned.widgets || []).map((widget) => {
-            const metadata = this.componentMetadata.get(widget.definition?.id);
-            if (!metadata?.inputs?.some((input) => input.name === 'enableCustomization')) {
-                return widget;
-            }
-            return {
-                ...widget,
-                definition: {
-                    ...widget.definition,
-                    inputs: {
-                        ...(widget.definition?.inputs || {}),
-                        enableCustomization: true,
-                    },
-                },
-            };
-        });
-        return cloned;
-    }
     /**
-     * Removes authoring-only inputs from a page emitted by the embedded runtime.
-     *
-     * The runtime must receive `enableCustomization=true` so nested components can
-     * expose their editors, but that projection is not part of the authored page.
-     * Restore the canonical value by widget key before publishing `pageChange` so
-     * a presentation-only edit cannot accidentally persist authoring chrome.
+     * Builds one mode-independent runtime projection for the authored page.
+     * The authored child opt-in remains in this stable source. The embedded
+     * dynamic page combines it with host mode/capabilities at the loader boundary,
+     * so JSON/Visual changes never replace this object or broaden permissions.
      */
-    toCanonicalPageFromAuthoringRuntime(page) {
+    toRuntimeBasePage(page) {
+        return this.clonePage(page);
+    }
+    /** Restores authoring-only child inputs from the canonical builder page. */
+    toCanonicalPageFromRuntime(page) {
         const canonicalByKey = new Map((this.currentPage().widgets || []).map((widget) => [widget.key, widget]));
         const cloned = this.clonePage(page);
         cloned.widgets = (cloned.widgets || []).map((widget) => {
@@ -24801,43 +24770,23 @@ class DynamicPageBuilderComponent {
             if (!metadata?.inputs?.some((input) => input.name === 'enableCustomization')) {
                 return widget;
             }
-            const canonicalInputs = canonicalByKey.get(widget.key)?.definition?.inputs;
-            const inputs = { ...(widget.definition?.inputs || {}) };
-            if (canonicalInputs && Object.prototype.hasOwnProperty.call(canonicalInputs, 'enableCustomization')) {
-                inputs['enableCustomization'] = canonicalInputs['enableCustomization'];
+            const canonicalInputs = canonicalByKey.get(widget.key)?.definition.inputs;
+            const inputs = { ...(widget.definition.inputs || {}) };
+            if (canonicalInputs &&
+                Object.prototype.hasOwnProperty.call(canonicalInputs, 'enableCustomization')) {
+                inputs['enableCustomization'] =
+                    canonicalInputs['enableCustomization'];
             }
             else {
                 delete inputs['enableCustomization'];
             }
             return {
                 ...widget,
-                definition: {
-                    ...widget.definition,
-                    inputs,
-                },
+                definition: { ...widget.definition, inputs },
             };
         });
         return cloned;
     }
-    toPresentationRuntimeWidget(widget) {
-        const metadata = this.componentMetadata.get(widget.definition?.id);
-        if (!metadata?.inputs?.some((input) => input.name === 'enableCustomization')) {
-            return widget;
-        }
-        const inputs = widget.definition?.inputs || {};
-        if (inputs['enableCustomization'] === false)
-            return widget;
-        return {
-            ...widget,
-            definition: {
-                ...widget.definition,
-                inputs: {
-                    ...inputs,
-                    enableCustomization: false,
-                },
-            },
-        };
-    }
     async applyAgenticTurnState(state) {
         // A terminal turn state is the canonical end of processing. Clear the local
         // interaction flag before projecting preview/review so the shell never
@@ -25645,7 +25594,7 @@ class DynamicPageBuilderComponent {
         [strictValidation]="strictValidation"
         [autoPersist]="false"
         [enableCustomization]="showSettings()"
-        [authoringCapabilities]="authoringCapabilities"
+        [authoringCapabilities]="runtimeAuthoringCapabilities()"
         [showPageSettingsButton]="false"
         [pageIdentity]="pageIdentity"
         [componentInstanceId]="componentInstanceId"
@@ -26209,7 +26158,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
         [strictValidation]="strictValidation"
         [autoPersist]="false"
         [enableCustomization]="showSettings()"
-        [authoringCapabilities]="authoringCapabilities"
+        [authoringCapabilities]="runtimeAuthoringCapabilities()"
         [showPageSettingsButton]="false"
         [pageIdentity]="pageIdentity"
         [componentInstanceId]="componentInstanceId"

package/package.json

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

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

@@ -1,7 +1,7 @@
 import { MatDialogRef, MatDialog } from '@angular/material/dialog';
 import * as _angular_core from '@angular/core';
 import { EventEmitter, OnInit, WritableSignal, InjectionToken, Provider, OnChanges, 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, ComponentContextPack, ComponentAuthoringManifest, DiagnosticRecord, NestedPortCatalogRegistry, CompositionValidatorService, 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, 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, DynamicWidgetPageComponent, 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';
@@ -1532,6 +1532,9 @@ declare class PageBuilderAgenticAuthoringService {
 }
 
 type UiCompositionPlanInputSource = 'event' | 'payload' | 'state' | 'context' | 'constant';
+type UiCompositionPlanTransformOutput = TransformOutputHint & {
+    semanticKind: TransformSemanticKind;
+};
 type UiCompositionPlanComponentPortEndpoint = {
     kind: 'component-port';
     widget: string;
@@ -1581,6 +1584,8 @@ type UiCompositionPlanTransform = {
     id: string;
     template: unknown;
     inputSource?: UiCompositionPlanInputSource;
+    /** Explicit semantic contract produced by the template after materialization. */
+    output?: UiCompositionPlanTransformOutput;
 };
 interface UiCompositionPlanWidget {
     key: string;
@@ -1981,9 +1986,8 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     readonly selectedWidgetKey: _angular_core.WritableSignal<string | null>;
     readonly agenticAuthoringWidgetContextKey: _angular_core.WritableSignal<string | null>;
     readonly agenticAuthoringPanelLayout: _angular_core.WritableSignal<PraxisAssistantShellLayout>;
-    private previewMode;
-    private runtimePreviewPageCache?;
-    private runtimeAuthoringPageCache?;
+    private readonly previewMode;
+    private runtimePageCache?;
     private agenticComponentCapabilities?;
     private agenticComponentCapabilitiesPromise?;
     private agenticTurnController?;
@@ -2009,6 +2013,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private isAuthoringCapabilityEnabled;
     isPreviewMode(): boolean;
     runtimePage(): WidgetPageDefinition;
+    runtimeAuthoringCapabilities(): PageBuilderAuthoringCapabilities;
     builderModeLabel(): string;
     onRuntimePageChange(next: WidgetPageDefinition): void;
     onRuntimeWidgetEvent(event: WidgetEventEnvelope): void;
@@ -2190,18 +2195,15 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private clearAgenticLocalPreviewHistory;
     private agenticCurrentPageFingerprint;
     private enterPreviewMode;
-    private toPresentationRuntimePage;
-    private toAuthoringRuntimePage;
     /**
-     * Removes authoring-only inputs from a page emitted by the embedded runtime.
-     *
-     * The runtime must receive `enableCustomization=true` so nested components can
-     * expose their editors, but that projection is not part of the authored page.
-     * Restore the canonical value by widget key before publishing `pageChange` so
-     * a presentation-only edit cannot accidentally persist authoring chrome.
+     * Builds one mode-independent runtime projection for the authored page.
+     * The authored child opt-in remains in this stable source. The embedded
+     * dynamic page combines it with host mode/capabilities at the loader boundary,
+     * so JSON/Visual changes never replace this object or broaden permissions.
      */
-    private toCanonicalPageFromAuthoringRuntime;
-    private toPresentationRuntimeWidget;
+    private toRuntimeBasePage;
+    /** Restores authoring-only child inputs from the canonical builder page. */
+    private toCanonicalPageFromRuntime;
     private applyAgenticTurnState;
     private primeSharedRuleHandoff;
     private moveAgenticAuthoringPanelToReviewSidecar;
@@ -2273,4 +2275,4 @@ declare const PRAXIS_PAGE_BUILDER_COMPONENT_METADATA: ComponentDocMeta;
 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, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, preflightUiCompositionPlan, 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, UiCompositionPlanWidget, ValueKind };
+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, ValueKind };