@praxisui/core 9.0.46 → 9.0.48

package/fesm2022/praxisui-core.mjs

@@ -36942,6 +36942,9 @@ class CompositionRuntimeEngine {
         const occurredAt = event.occurredAt ?? this.now();
         const matchedLinks = this.definition.links.filter((link) => matchesEndpoint(link.from, event.source));
         const matchedLinkIds = matchedLinks.map((link) => link.id);
+        const executionQueue = [...matchedLinks];
+        const queuedLinkIds = new Set(matchedLinkIds);
+        const executedLinks = [];
         let workingState = cloneStateSnapshot(this.store.getSnapshot().state);
         const persistentBootstrapDiagnostics = this.store.getSnapshot().diagnostics.filter((diagnostic) => isBlockingDiagnostic(diagnostic)
             && (diagnostic.phase === 'semantic-validation'
@@ -36953,8 +36956,7 @@ class CompositionRuntimeEngine {
         if (this.haltedByLinkId && matchedLinks.length === 0) {
             runtimeDiagnostics.push(this.createPageHaltedDiagnostic(undefined, occurredAt));
         }
-        const blockedFeedbackDiagnostics = this.createFeedbackCycleBlockedDiagnostics(matchedLinks, occurredAt);
-        runtimeDiagnostics.push(...blockedFeedbackDiagnostics.values());
+        const blockedFeedbackDiagnostics = this.createFeedbackCycleBlockedDiagnostics(this.definition.links, occurredAt);
         const linkResults = new Map();
         const trace = [];
         const emittedDiagnosticIds = new Set();
@@ -36970,7 +36972,9 @@ class CompositionRuntimeEngine {
             },
         }));
         sequence = this.appendDiagnosticTraceEntries(trace, emittedDiagnosticIds, event.eventId, sequence, runtimeDiagnostics);
-        for (const link of matchedLinks) {
+        for (let queueIndex = 0; queueIndex < executionQueue.length; queueIndex += 1) {
+            const link = executionQueue[queueIndex];
+            executedLinks.push(link);
             const previousLink = this.store.getSnapshot().links.find((item) => item.linkId === link.id);
             const stateBefore = cloneStateSnapshot(workingState);
             const blockedFeedbackDiagnostic = blockedFeedbackDiagnostics.get(link.id);
@@ -37027,6 +37031,7 @@ class CompositionRuntimeEngine {
                 continue;
             }
             if (blockedFeedbackDiagnostic) {
+                runtimeDiagnostics.push(blockedFeedbackDiagnostic);
                 trace.push(this.traceService.createEntry(event.eventId, sequence++, {
                     timestamp: occurredAt,
                     phase: 'delivery-skipped',
@@ -37113,6 +37118,20 @@ class CompositionRuntimeEngine {
                     outputSnapshot: workingState,
                     diagnostics: result.diagnostics.map((item) => item.code),
                 }));
+                if (result.status === 'delivered' && result.delivery.statePath) {
+                    const deliveredLayer = result.delivery.stateLayer ?? 'values';
+                    for (const candidate of this.definition.links) {
+                        if (queuedLinkIds.has(candidate.id)
+                            || candidate.from.kind !== 'state'
+                            || candidate.from.ref.path !== result.delivery.statePath
+                            || (candidate.from.ref.layer ?? 'values') !== deliveredLayer) {
+                            continue;
+                        }
+                        queuedLinkIds.add(candidate.id);
+                        matchedLinkIds.push(candidate.id);
+                        executionQueue.push(candidate);
+                    }
+                }
             }
             trace.push(this.traceService.createEntry(event.eventId, sequence++, {
                 timestamp: occurredAt,
@@ -37154,7 +37173,7 @@ class CompositionRuntimeEngine {
                     ? 'degraded'
                     : 'ready',
             stateSnapshot: materializedState,
-            linkPatches: matchedLinks.map((link) => ({
+            linkPatches: executedLinks.map((link) => ({
                 linkId: link.id,
                 status: blockedFeedbackDiagnostics.has(link.id)
                     ? 'skipped'
@@ -38510,6 +38529,10 @@ class DynamicWidgetPageComponent {
             changes['authoringCapabilities'] ||
             changes['pageIdentity']) {
             this.widgetShellRenderCache.clear();
+        }
+        if (changes['page'] ||
+            changes['context'] ||
+            changes['pageIdentity']) {
             const parsed = this.parsePage(this.page);
             if (changes['page'] || !this.authoredPageDefinition) {
                 this.authoredPageDefinition = undefined;
@@ -38536,6 +38559,7 @@ class DynamicWidgetPageComponent {
             const rawWidgets = this.pageDefinition?.widgets || [];
             let widgets = this.applyEditShellActions(rawWidgets);
             widgets = this.applyBootstrapCompositionHydration(widgets, bootstrapSnapshot);
+            widgets = this.applyChildCustomizationProjection(widgets);
             this.pageDefinition = this.pageDefinition
                 ? { ...this.pageDefinition, widgets }
                 : this.pageDefinition;
@@ -38543,6 +38567,16 @@ class DynamicWidgetPageComponent {
             this.applyResponsivePresentation(this.pageDefinition, widgets, this.pageRuntime);
             this.reportStateDiagnostics(this.pageRuntime.diagnostics);
         }
+        if (!changes['page'] &&
+            !changes['context'] &&
+            !changes['pageIdentity'] &&
+            (changes['enableCustomization'] || changes['authoringCapabilities']) &&
+            this.pageDefinition) {
+            const widgets = this.applyChildCustomizationProjection(this.pageDefinition.widgets || []);
+            this.pageDefinition = { ...this.pageDefinition, widgets };
+            this.page = this.pageDefinition;
+            this.applyResponsivePresentation(this.pageDefinition, widgets, this.pageRuntime);
+        }
         if (this.autoPersist &&
             (changes['pageIdentity'] || changes['componentInstanceId'])) {
             this.appliedPersisted = false;
@@ -38624,8 +38658,14 @@ class DynamicWidgetPageComponent {
         const linksById = new Map(this.compositionDefinition.links.map((link) => [link.id, link]));
         return cycle.matchedLinkIds.every((linkId) => {
             const link = linksById.get(linkId);
-            return (link?.to.kind === 'state' &&
-                (link.to.ref.layer ?? 'values') === 'transient');
+            if (!link)
+                return false;
+            if (link.to.kind === 'state') {
+                return (link.to.ref.layer ?? 'values') === 'transient';
+            }
+            return link.from.kind === 'state'
+                && (link.from.ref.layer ?? 'values') === 'transient'
+                && link.to.kind === 'component-port';
         });
     }
     applyWidgetInputPatchToPage(page, widgetKey, evt) {
@@ -38782,6 +38822,43 @@ class DynamicWidgetPageComponent {
     applyEditShellActions(widgets) {
         return this.cloneWidgets(widgets);
     }
+    /**
+     * Materializes host-owned child authoring chrome in the active runtime page.
+     * The authored source remains untouched and composition state is not rebuilt.
+     */
+    applyChildCustomizationProjection(widgets) {
+        if (this.authoringCapabilities == null) {
+            return widgets;
+        }
+        const authoredByKey = new Map((this.authoredPageDefinition?.widgets || []).map((widget) => [
+            widget.key,
+            widget,
+        ]));
+        return widgets.map((widget) => {
+            const metadata = this.componentMetadata?.get(widget.definition?.id || '');
+            if (!metadata?.inputs?.some((input) => input.name === 'enableCustomization')) {
+                return widget;
+            }
+            const authoredEnableCustomization = authoredByKey.get(widget.key)?.definition.inputs?.['enableCustomization'] === true;
+            const enableCustomization = this.enableCustomization &&
+                this.isAuthoringCapabilityEnabled('childCustomization') &&
+                authoredEnableCustomization;
+            if (widget.definition.inputs?.['enableCustomization'] ===
+                enableCustomization) {
+                return widget;
+            }
+            return {
+                ...widget,
+                definition: {
+                    ...widget.definition,
+                    inputs: {
+                        ...(widget.definition.inputs || {}),
+                        enableCustomization,
+                    },
+                },
+            };
+        });
+    }
     applyBootstrapCompositionHydration(widgets, bootstrapSnapshot) {
         if (!this.compositionDefinition || !bootstrapSnapshot) {
             return this.cloneWidgets(widgets);
@@ -40668,13 +40745,13 @@ class DynamicWidgetPageComponent {
                     : normalizedWidgets;
         const hydrated = this.resolvePagePresets({
             ...normalized,
-            widgets: this.applyRecordRelatedSurfaceAiContext(stateBoundWidgets),
+            widgets: this.applyChildCustomizationProjection(this.applyRecordRelatedSurfaceAiContext(stateBoundWidgets)),
         });
         this.pageDefinition = hydrated;
         this.page = hydrated;
         this.pageState = runtime.state;
         this.pageRuntime = runtime;
-        this.applyResponsivePresentation(hydrated, stateBoundWidgets, runtime);
+        this.applyResponsivePresentation(hydrated, hydrated?.widgets || stateBoundWidgets, runtime);
         const previousAuthoredPage = this.authoredPageDefinition;
         const canonicalPage = this.toPersistedCanonicalPage(hydrated);
         const authoredPageChanged = !previousAuthoredPage ||
@@ -41119,12 +41196,19 @@ class DynamicWidgetPageComponent {
         return !!this.canvas;
     }
     shouldAutoWireOutputs(widget) {
-        if (this.enableCustomization) {
+        if (this.authoringCapabilities != null &&
+            this.isAuthoringCapabilityEnabled('childCustomization')) {
+            return true;
+        }
+        if (this.authoringCapabilities == null && this.enableCustomization) {
             return true;
         }
         if (this.hasCompositionOutputLinks(widget?.key)) {
             return true;
         }
+        if (this.authoringCapabilities != null) {
+            return false;
+        }
         return widget?.definition?.inputs?.['enableCustomization'] === true;
     }
     hasCompositionOutputLinks(widgetKey) {
@@ -41970,9 +42054,43 @@ class DynamicWidgetPageComponent {
     }
     toPersistedCanonicalPage(page) {
         this.assertNoLegacyConnections(page);
-        const canonicalPage = this.stripDerivedPresetDefaults(this.restoreAuthoredCompositionTargetInputs(page));
+        const canonicalPage = this.stripDerivedPresetDefaults(this.restoreAuthoredChildCustomizationInputs(this.restoreAuthoredCompositionTargetInputs(page)));
         return writeCompositionLinksToPersistedPage(canonicalPage, canonicalPage.composition?.links || []);
     }
+    /** Restores host-projected child authoring inputs from the authored source. */
+    restoreAuthoredChildCustomizationInputs(page) {
+        const authored = this.authoredPageDefinition;
+        if (this.authoringCapabilities == null || !authored) {
+            return page;
+        }
+        const authoredByKey = new Map((authored.widgets || []).map((widget) => [widget.key, widget]));
+        let changed = false;
+        const widgets = (page.widgets || []).map((widget) => {
+            const metadata = this.componentMetadata?.get(widget.definition?.id || '');
+            if (!metadata?.inputs?.some((input) => input.name === 'enableCustomization')) {
+                return widget;
+            }
+            const authoredInputs = authoredByKey.get(widget.key)?.definition.inputs;
+            const inputs = { ...(widget.definition.inputs || {}) };
+            if (authoredInputs &&
+                Object.prototype.hasOwnProperty.call(authoredInputs, 'enableCustomization')) {
+                inputs['enableCustomization'] =
+                    authoredInputs['enableCustomization'];
+            }
+            else {
+                delete inputs['enableCustomization'];
+            }
+            if (this.sameJsonStructure(inputs, widget.definition.inputs || {})) {
+                return widget;
+            }
+            changed = true;
+            return {
+                ...widget,
+                definition: { ...widget.definition, inputs },
+            };
+        });
+        return changed ? { ...page, widgets } : page;
+    }
     /**
      * Component-port targets are runtime projections. Restore their authored
      * values before emitting or saving the page so a composition delivery never

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/core",
-  "version": "9.0.46",
+  "version": "9.0.48",
   "description": "Core library for Praxis UI Workspace: types, tokens, services and utilities shared across @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",

package/types/praxisui-core.d.ts

@@ -14115,7 +14115,7 @@ interface WidgetPageAuthoringCapabilities {
     widgetInputs?: boolean;
     /** Allows removing widgets from the page. */
     widgetRemoval?: boolean;
-    /** Allows nested components to receive authoring-only customization inputs. */
+    /** Grants nested authoring only to widgets that explicitly opt in. */
     childCustomization?: boolean;
 }
 /** Fine-grained shell capabilities used by the canonical shell editor. */
@@ -16617,6 +16617,11 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     private buildStateRuntime;
     private bootstrapCompositionAdapter;
     private applyEditShellActions;
+    /**
+     * Materializes host-owned child authoring chrome in the active runtime page.
+     * The authored source remains untouched and composition state is not rebuilt.
+     */
+    private applyChildCustomizationProjection;
     private applyBootstrapCompositionHydration;
     buildRuntimeComponentObservation(): PraxisRuntimeComponentObservationEnvelope;
     private registerRuntimeComponentObservationProvider;
@@ -16841,6 +16846,8 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     private mergeClassNames;
     private resolveRenderedCanvasItem;
     private toPersistedCanonicalPage;
+    /** Restores host-projected child authoring inputs from the authored source. */
+    private restoreAuthoredChildCustomizationInputs;
     /**
      * Component-port targets are runtime projections. Restore their authored
      * values before emitting or saving the page so a composition delivery never