@praxisui/page-builder 9.0.45 → 9.0.47

package/fesm2022/praxisui-page-builder.mjs

@@ -13133,7 +13133,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
  * Capabilities catalog for the canonical dynamic page builder/runtime.
  */
 const PAGE_BUILDER_AI_CAPABILITIES = {
-    version: 'v1.4',
+    version: 'v1.5',
     enums: {},
     targets: [
         'page-builder',
@@ -13143,7 +13143,7 @@ const PAGE_BUILDER_AI_CAPABILITIES = {
         'praxis-dynamic-page-builder',
     ],
     notes: [
-        'page segue o modelo canonico WidgetPageDefinition (widgets, composition.links, context e state opcional); composition.links tambem pode despachar actions globais via to.kind = global-action.',
+        'page segue o modelo canonico WidgetPageDefinition (widgets, composition.links, context e state opcional); composition.links pode despachar actions globais via to.kind = global-action e receber continuations exatas via from.kind = global-action.',
         'Conteudo editorial rico deve ser modelado como widget praxis-rich-content com definition.inputs.document: RichContentDocument, nao como DSL local do page-builder.',
         'Quando definition.id = praxis-rich-content em uma pagina dinamica, definition.inputs.document continua sendo o contrato persistido; hostCapabilities e mediado em runtime pelo host praxis-dynamic-page e nao deve ser serializado no JSON da pagina.',
         'Edicao visual de inputs de widget deve usar ComponentDocMeta.configEditor ou ComponentDocMeta.authoringManifestRef publicado pela lib dona do componente; nao criar editor local no page-builder para semantica de outro pacote.',
@@ -13185,7 +13185,8 @@ const PAGE_BUILDER_AI_CAPABILITIES = {
         { path: 'uiCompositionPlan.contextScopes[].targets', category: 'context', valueKind: 'array', description: 'Destinos explicitos do escopo, identificados por widget owner e nestedPath canonico opcional.' },
         { path: 'uiCompositionPlan.bindings', category: 'connections', valueKind: 'array', description: 'Bindings declarativos que serao compilados para page.composition.links.' },
         { path: 'uiCompositionPlan.bindings[].id', category: 'connections', valueKind: 'string', description: 'Identificador estavel do binding planejado.' },
-        { path: 'uiCompositionPlan.bindings[].from', category: 'connections', valueKind: 'object', description: 'Endpoint de origem: component-port ou state.' },
+        { path: 'uiCompositionPlan.bindings[].from', category: 'connections', valueKind: 'object', description: 'Endpoint de origem: component-port, state ou global-action. Uma origem global-action identifica a continuation somente por actionId; o payload vem do dispatch runtime.' },
+        { path: 'uiCompositionPlan.bindings[].from.[actionId]', category: 'connections', valueKind: 'string', description: 'ID exato da continuation quando uiCompositionPlan.bindings[].from.kind = global-action. Campos de payload ou metadata nao sao executaveis na origem.' },
         { path: 'uiCompositionPlan.bindings[].to', category: 'connections', valueKind: 'object', description: 'Endpoint de destino: component-port, state ou global-action.' },
         { path: 'uiCompositionPlan.bindings[].to.[actionId]', category: 'connections', valueKind: 'string', description: 'ID da action global quando uiCompositionPlan.bindings[].to.kind = global-action.' },
         { path: 'uiCompositionPlan.bindings[].to.payload', category: 'connections', valueKind: 'object', description: 'Payload literal opcional para destino global-action planejado.' },
@@ -14146,13 +14147,29 @@ const globalActionEndpointSchema = {
         },
     },
 };
+const globalActionSourceEndpointSchema = {
+    type: 'object',
+    required: ['kind', 'ref'],
+    additionalProperties: false,
+    properties: {
+        kind: { enum: ['global-action'] },
+        ref: {
+            type: 'object',
+            required: ['actionId'],
+            additionalProperties: false,
+            properties: {
+                actionId: { type: 'string' },
+            },
+        },
+    },
+};
 const compositionLinkSchema = {
     type: 'object',
     required: ['id', 'from', 'to', 'intent'],
     additionalProperties: false,
     properties: {
         id: { type: 'string' },
-        from: { oneOf: [componentPortEndpointSchema, stateEndpointSchema] },
+        from: { oneOf: [componentPortEndpointSchema, stateEndpointSchema, globalActionSourceEndpointSchema] },
         to: { oneOf: [componentPortEndpointSchema, stateEndpointSchema, globalActionEndpointSchema] },
         intent: { enum: linkIntentValues },
         condition: { type: 'object' },
@@ -14178,7 +14195,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
     componentId: 'praxis-page-builder',
     ownerPackage: '@praxisui/page-builder',
     configSchemaId: 'WidgetPageDefinition',
-    manifestVersion: '1.2.0',
+    manifestVersion: '1.3.0',
     runtimeInputs: [
         { name: 'page', type: 'WidgetPageDefinition', description: 'Canonical renderable page document consumed by praxis-dynamic-page.' },
         { name: 'pageIdentity', type: 'PageIdentity | null', description: 'Persistence identity for ui_user_config save/apply flows; not persisted inside page.' },
@@ -14514,6 +14531,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
         'UiCompositionPlan.i18n, context and layout compile into the corresponding WidgetPageDefinition fields so a complete page never depends on host-only enrichment. A key-only PraxisTextValue receives text from the fallbackLocale dictionary when available.',
         'UiCompositionPlan.selectionSyncs is an authoring shorthand that compiles into explicit canonical page.composition.links and is never persisted in WidgetPageDefinition.',
         'UiCompositionPlan.contextScopes compiles constants and state.initial into explicit widget inputs, and state context into explicit page.composition.links; runtime inheritance is never ambient.',
+        'UiCompositionPlan global-action sources declare only actionId; dynamicPage.composition.dispatch supplies the runtime payload, and target-only payload fields fail closed on sources.',
         'Widget keys and composition link ids are stable identities; array indexes are never canonical identities.',
         'Persisted wiring uses page.composition.links and must not write legacy connections.',
         'Nested component ports use component-port refs with nestedPath ending in a stable widget key.',
@@ -15210,8 +15228,8 @@ function validateUiCompositionPlan(plan) {
         }
     }
     for (const [index, binding] of (plan.bindings ?? []).entries()) {
-        validateEndpoint(binding.from, widgetKeys, diagnostics, `bindings.${index}.from`, false);
-        validateEndpoint(binding.to, widgetKeys, diagnostics, `bindings.${index}.to`, true);
+        validateEndpoint(binding.from, widgetKeys, diagnostics, `bindings.${index}.from`, 'source');
+        validateEndpoint(binding.to, widgetKeys, diagnostics, `bindings.${index}.to`, 'target');
         if (!binding.id?.trim()) {
             diagnostics.push({
                 code: 'binding-id-required',
@@ -15264,7 +15282,7 @@ function validateSelectionSync(selectionSync, widgetKeys, diagnostics, path) {
         });
     }
     for (const [sourceIndex, source] of (selectionSync.sources ?? []).entries()) {
-        validateEndpoint(source, widgetKeys, diagnostics, `${path}.sources.${sourceIndex}`, false);
+        validateEndpoint(source, widgetKeys, diagnostics, `${path}.sources.${sourceIndex}`, 'source');
         if (source?.kind !== 'component-port') {
             diagnostics.push({
                 code: 'selection-sync-source-component-port-required',
@@ -15288,7 +15306,7 @@ function validateSelectionSync(selectionSync, widgetKeys, diagnostics, path) {
         });
     }
     else {
-        validateEndpoint(selectionSync.target, widgetKeys, diagnostics, `${path}.target`, false);
+        validateEndpoint(selectionSync.target, widgetKeys, diagnostics, `${path}.target`, 'target');
     }
     const mappings = Object.entries(selectionSync.mapping ?? {});
     if (!mappings.length) {
@@ -15523,7 +15541,7 @@ function validateGrouping(grouping, widgetKeys, diagnostics) {
         });
     });
 }
-function validateEndpoint(endpoint, widgetKeys, diagnostics, path, allowGlobalAction) {
+function validateEndpoint(endpoint, widgetKeys, diagnostics, path, role) {
     if (!endpoint || typeof endpoint !== 'object') {
         diagnostics.push({
             code: 'endpoint-required',
@@ -15561,21 +15579,23 @@ function validateEndpoint(endpoint, widgetKeys, diagnostics, path, allowGlobalAc
         return;
     }
     if (endpoint.kind === 'global-action') {
-        if (!allowGlobalAction) {
-            diagnostics.push({
-                code: 'endpoint-global-action-source-unsupported',
-                message: 'Global-action endpoints are supported only as binding targets.',
-                path: `${path}.kind`,
-            });
-            return;
-        }
         if (!endpoint.actionId?.trim()) {
             diagnostics.push({
                 code: 'endpoint-global-action-id-required',
-                message: 'Global-action target must declare an actionId.',
+                message: 'Global-action endpoint must declare an actionId.',
                 path: `${path}.actionId`,
             });
         }
+        if (role === 'source') {
+            for (const field of Object.keys(endpoint).filter((candidate) => candidate !== 'kind' && candidate !== 'actionId')) {
+                diagnostics.push({
+                    code: 'endpoint-global-action-source-field-unsupported',
+                    message: `Global-action source field "${field}" is not executable; runtime dispatch supplies the payload.`,
+                    path: `${path}.${field}`,
+                });
+            }
+            return;
+        }
         if (endpoint.payloadExpr !== undefined && typeof endpoint.payloadExpr !== 'string') {
             diagnostics.push({
                 code: 'endpoint-global-action-payload-expr-invalid',
@@ -15587,9 +15607,7 @@ function validateEndpoint(endpoint, widgetKeys, diagnostics, path, allowGlobalAc
     }
     diagnostics.push({
         code: 'endpoint-kind-unsupported',
-        message: allowGlobalAction
-            ? 'Endpoint kind must be "component-port", "state" or "global-action".'
-            : 'Endpoint kind must be "component-port" or "state".',
+        message: 'Endpoint kind must be "component-port", "state" or "global-action".',
         path: `${path}.kind`,
     });
 }
@@ -15822,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'
@@ -15845,8 +15864,10 @@ function toCompositionTransform(transform) {
                     config: {
                         template,
                     },
+                    ...(output ? { output } : {}),
                 },
             ],
+            ...(output ? { output } : {}),
         };
     }
     if (transform.kind === 'constant') {
@@ -21714,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;
@@ -21815,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;
@@ -21850,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);
             }
@@ -21900,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');
@@ -21942,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()) {
@@ -21977,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;
         }
@@ -22023,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();
         }
     }
@@ -22179,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));
@@ -22284,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':
@@ -22441,7 +22455,7 @@ class DynamicPageBuilderComponent {
         if (this.showSettings()) {
             return true;
         }
-        return this.previewMode && this.hasAgenticAuthoringSession();
+        return this.previewMode() && this.hasAgenticAuthoringSession();
     }
     showAgenticAuthoringDock() {
         return this.showSettings()
@@ -24731,24 +24745,20 @@ 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) {
+    /**
+     * Builds one mode-independent runtime projection for the authored page.
+     * Child authoring chrome is materialized by the embedded dynamic page from
+     * host capabilities, so JSON/Visual mode changes never replace this object.
+     */
+    toRuntimeBasePage(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')) {
@@ -24759,23 +24769,16 @@ class DynamicPageBuilderComponent {
                 definition: {
                     ...widget.definition,
                     inputs: {
-                        ...(widget.definition?.inputs || {}),
-                        enableCustomization: true,
+                        ...(widget.definition.inputs || {}),
+                        enableCustomization: false,
                     },
                 },
             };
         });
         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.
-     */
-    toCanonicalPageFromAuthoringRuntime(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) => {
@@ -24783,43 +24786,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
@@ -25627,7 +25610,7 @@ class DynamicPageBuilderComponent {
         [strictValidation]="strictValidation"
         [autoPersist]="false"
         [enableCustomization]="showSettings()"
-        [authoringCapabilities]="authoringCapabilities"
+        [authoringCapabilities]="runtimeAuthoringCapabilities()"
         [showPageSettingsButton]="false"
         [pageIdentity]="pageIdentity"
         [componentInstanceId]="componentInstanceId"
@@ -26191,7 +26174,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.45",
+  "version": "9.0.47",
   "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.45",
-    "@praxisui/core": "^9.0.45",
-    "@praxisui/settings-panel": "^9.0.45",
+    "@praxisui/ai": "^9.0.47",
+    "@praxisui/core": "^9.0.47",
+    "@praxisui/settings-panel": "^9.0.47",
     "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;
@@ -1551,8 +1554,14 @@ type UiCompositionPlanGlobalActionEndpoint = {
     payloadExpr?: string;
     meta?: Record<string, unknown>;
 };
-type UiCompositionPlanSourceEndpoint = UiCompositionPlanComponentPortEndpoint | UiCompositionPlanStateEndpoint;
-type UiCompositionPlanTargetEndpoint = UiCompositionPlanSourceEndpoint | UiCompositionPlanGlobalActionEndpoint;
+/**
+ * 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';
@@ -1575,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;
@@ -1975,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?;
@@ -2003,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;
@@ -2184,18 +2195,14 @@ 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.
+     * Child authoring chrome is materialized by the embedded dynamic page from
+     * host capabilities, so JSON/Visual mode changes never replace this object.
      */
-    private toCanonicalPageFromAuthoringRuntime;
-    private toPresentationRuntimeWidget;
+    private toRuntimeBasePage;
+    /** Restores authoring-only child inputs from the canonical builder page. */
+    private toCanonicalPageFromRuntime;
     private applyAgenticTurnState;
     private primeSharedRuleHandoff;
     private moveAgenticAuthoringPanelToReviewSidecar;
@@ -2267,4 +2274,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, 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 };