@praxisui/core 9.0.44 → 9.0.45

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-30T15:02:07.421Z",
+  "generatedAt": "2026-08-30T19:03:13.983Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.44",
+  "packageVersion": "9.0.45",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 4,
@@ -528,7 +528,7 @@
           "name": "pageChange",
           "type": "WidgetPageDefinition",
           "required": false,
-          "description": "Emitido ao alterar a definição da página."
+          "description": "Emitido ao alterar a definição authorada da página; projeções transitórias de composição permanecem somente no runtime."
         },
         {
           "name": "widgetEvent",

package/fesm2022/praxisui-core.mjs

@@ -38418,6 +38418,12 @@ class DynamicWidgetPageComponent {
     layoutAnnouncement = '';
     canvasResizeHandles = CANVAS_RESIZE_HANDLES;
     pageDefinition;
+    /**
+     * Last canonical definition accepted from the host or published by the
+     * runtime. Composition deliveries are materialized in `pageDefinition`, but
+     * must never replace this authored source of truth.
+     */
+    authoredPageDefinition;
     pageState = { values: {} };
     pageRuntime = {
         state: { values: {} },
@@ -38505,6 +38511,15 @@ class DynamicWidgetPageComponent {
             changes['pageIdentity']) {
             this.widgetShellRenderCache.clear();
             const parsed = this.parsePage(this.page);
+            if (changes['page'] || !this.authoredPageDefinition) {
+                this.authoredPageDefinition = undefined;
+                this.authoredPageDefinition = parsed
+                    ? this.toPersistedCanonicalPage({
+                        ...parsed,
+                        state: this.stateRuntime.normalizeState(parsed.state),
+                    })
+                    : undefined;
+            }
             const resolvedPage = parsed ? this.resolvePagePresets(parsed) : parsed;
             this.assertNoLegacyConnections(resolvedPage);
             this.widgetDiagnostics = {};
@@ -38600,7 +38615,7 @@ class DynamicWidgetPageComponent {
             !widgetInputPatchResult.changed) {
             return;
         }
-        this.applyPageUpdate({ ...pageWithPatchedInputs, widgets, state }, true, nextRuntime, false);
+        this.applyPageUpdate({ ...pageWithPatchedInputs, widgets, state }, true, nextRuntime, false, false, false);
     }
     isTransientOnlyCompositionCycle(cycle) {
         if (!this.compositionDefinition || !cycle.matchedLinkIds.length) {
@@ -39284,7 +39299,7 @@ class DynamicWidgetPageComponent {
                 },
             },
         };
-        this.applyPageUpdate({ ...page, widgets }, false, stateResult.runtime, false, true);
+        this.applyPageUpdate({ ...page, widgets }, false, stateResult.runtime, false, true, false);
         return true;
     }
     applyRecordSurfaceSourceState(page, fromKey, evt, surface, payload) {
@@ -39446,7 +39461,7 @@ class DynamicWidgetPageComponent {
         widgets = this.applyCompositionWidgetDeliveries(widgets, cycle).widgets;
         widgets = this.projectPersistentCompositionStateInputs(widgets, cycle.snapshot.state, cycle.snapshot.generatedAt);
         const runtime = this.buildStateRuntime(state, page.context);
-        this.applyPageUpdate({ ...page, widgets, state }, true, runtime, false, true);
+        this.applyPageUpdate({ ...page, widgets, state }, true, runtime, false, true, false);
     }
     matchesRuntimeSourceRef(endpoint, sourceRef) {
         return (endpoint.kind === 'component-port' &&
@@ -40628,7 +40643,7 @@ class DynamicWidgetPageComponent {
             themePreset: themePreset || undefined,
         }, persist);
     }
-    applyPageUpdate(next, persist = true, runtime = this.buildStateRuntime(next.state, next.context), syncCompositionAdapter = true, skipStateWidgetProjection = false) {
+    applyPageUpdate(next, persist = true, runtime = this.buildStateRuntime(next.state, next.context), syncCompositionAdapter = true, skipStateWidgetProjection = false, emitUnchangedCanonicalPage = true) {
         this.assertNoLegacyConnections(next);
         const normalized = { ...next, state: runtime.state };
         const normalizedWidgets = this.applyEditShellActions(normalized.widgets || []);
@@ -40660,10 +40675,19 @@ class DynamicWidgetPageComponent {
         this.pageState = runtime.state;
         this.pageRuntime = runtime;
         this.applyResponsivePresentation(hydrated, stateBoundWidgets, runtime);
+        const previousAuthoredPage = this.authoredPageDefinition;
         const canonicalPage = this.toPersistedCanonicalPage(hydrated);
-        this.pageChange.emit(canonicalPage);
+        const authoredPageChanged = !previousAuthoredPage ||
+            !this.sameJsonStructure(previousAuthoredPage, canonicalPage);
+        this.authoredPageDefinition = this.clonePageDefinition(canonicalPage);
+        if (authoredPageChanged || emitUnchangedCanonicalPage) {
+            this.pageChange.emit(canonicalPage);
+        }
         this.reportStateDiagnostics(runtime.diagnostics);
-        if (persist && this.autoPersist && !this.isHydrating) {
+        if (authoredPageChanged &&
+            persist &&
+            this.autoPersist &&
+            !this.isHydrating) {
             this.savePage(canonicalPage);
         }
     }
@@ -41941,9 +41965,99 @@ class DynamicWidgetPageComponent {
     }
     toPersistedCanonicalPage(page) {
         this.assertNoLegacyConnections(page);
-        const canonicalPage = this.stripDerivedPresetDefaults(page);
+        const canonicalPage = this.stripDerivedPresetDefaults(this.restoreAuthoredCompositionTargetInputs(page));
         return writeCompositionLinksToPersistedPage(canonicalPage, canonicalPage.composition?.links || []);
     }
+    /**
+     * Component-port targets are runtime projections. Restore their authored
+     * values before emitting or saving the page so a composition delivery never
+     * becomes an accidental document edit.
+     */
+    restoreAuthoredCompositionTargetInputs(page) {
+        const authored = this.authoredPageDefinition;
+        const links = page.composition?.links || [];
+        if (!authored || !links.length) {
+            return page;
+        }
+        const next = this.clonePageDefinition(page);
+        const authoredByKey = new Map((authored.widgets || []).map((widget) => [widget.key, widget]));
+        for (const link of links) {
+            if (link.to.kind !== 'component-port')
+                continue;
+            const target = link.to.ref;
+            const widgetIndex = (next.widgets || []).findIndex((widget) => widget.key === target.widget);
+            const authoredWidget = authoredByKey.get(target.widget);
+            if (widgetIndex < 0 || !authoredWidget)
+                continue;
+            if (target.nestedPath?.length) {
+                const authoredNested = this.nestedWidgetAccessor.resolveNestedWidget(authoredWidget, target.nestedPath);
+                const authoredInputs = authoredNested?.inputs;
+                const hasAuthoredValue = !!authoredInputs &&
+                    Object.prototype.hasOwnProperty.call(authoredInputs, target.port);
+                const result = hasAuthoredValue
+                    ? this.nestedWidgetAccessor.setNestedWidgetInput(next.widgets[widgetIndex], target.nestedPath, target.port, this.cloneStateValues(authoredInputs?.[target.port]))
+                    : this.nestedWidgetAccessor.removeNestedWidgetInput(next.widgets[widgetIndex], target.nestedPath, target.port);
+                if (result.changed) {
+                    next.widgets[widgetIndex] = result.widget;
+                }
+                continue;
+            }
+            const inputPath = this.resolveComponentBindingPath(target.port, target.bindingPath);
+            if (!inputPath)
+                continue;
+            const authoredInputs = authoredWidget.definition.inputs || {};
+            const authoredValue = this.readOwnValueAtPath(authoredInputs, inputPath);
+            const runtimeInputs = this.cloneStateValues(next.widgets[widgetIndex].definition.inputs || {});
+            const inputs = authoredValue.found
+                ? this.conn.setValueAtPath(runtimeInputs, inputPath, this.cloneStateValues(authoredValue.value))
+                : this.removeOwnValueAtPath(runtimeInputs, inputPath);
+            next.widgets[widgetIndex] = {
+                ...next.widgets[widgetIndex],
+                definition: {
+                    ...next.widgets[widgetIndex].definition,
+                    inputs,
+                },
+            };
+        }
+        return next;
+    }
+    readOwnValueAtPath(source, path) {
+        const tokens = this.tokenizeInputPath(path);
+        let current = source;
+        for (const token of tokens) {
+            if ((typeof current !== 'object' || current === null) ||
+                !Object.prototype.hasOwnProperty.call(current, token)) {
+                return { found: false };
+            }
+            current = current[token];
+        }
+        return { found: tokens.length > 0, value: current };
+    }
+    removeOwnValueAtPath(source, path) {
+        const tokens = this.tokenizeInputPath(path);
+        if (!tokens.length)
+            return source;
+        const clone = this.cloneStateValues(source);
+        let current = clone;
+        for (const token of tokens.slice(0, -1)) {
+            if (typeof current?.[token] !== 'object' || current[token] === null) {
+                return clone;
+            }
+            current[token] = Array.isArray(current[token])
+                ? [...current[token]]
+                : { ...current[token] };
+            current = current[token];
+        }
+        delete current[tokens[tokens.length - 1]];
+        return clone;
+    }
+    tokenizeInputPath(path) {
+        const tokens = [];
+        for (const match of String(path || '').matchAll(/([^.\[\]]+)|\[(\d+)\]/g)) {
+            tokens.push(match[2] === undefined ? match[1] : Number(match[2]));
+        }
+        return tokens;
+    }
     /**
      * Preset defaults are a runtime projection, not authored page state.
      *
@@ -42039,6 +42153,7 @@ class DynamicWidgetPageComponent {
                     if (!stored)
                         return;
                     this.isHydrating = true;
+                    this.authoredPageDefinition = undefined;
                     this.applyPageUpdate(stored, false);
                     this.isHydrating = false;
                 },
@@ -43013,7 +43128,7 @@ const PRAXIS_DYNAMIC_PAGE_COMPONENT_METADATA = {
         {
             name: 'pageChange',
             type: 'WidgetPageDefinition',
-            description: 'Emitido ao alterar a definição da página.',
+            description: 'Emitido ao alterar a definição authorada da página; projeções transitórias de composição permanecem somente no runtime.',
         },
         {
             name: 'widgetEvent',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/core",
-  "version": "9.0.44",
+  "version": "9.0.45",
   "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

@@ -16552,6 +16552,12 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     layoutAnnouncement: string;
     readonly canvasResizeHandles: readonly CanvasResizeHandleDefinition[];
     private pageDefinition?;
+    /**
+     * Last canonical definition accepted from the host or published by the
+     * runtime. Composition deliveries are materialized in `pageDefinition`, but
+     * must never replace this authored source of truth.
+     */
+    private authoredPageDefinition?;
     private pageState;
     private pageRuntime;
     private readonly configEditorContextRequests;
@@ -16835,6 +16841,15 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     private mergeClassNames;
     private resolveRenderedCanvasItem;
     private toPersistedCanonicalPage;
+    /**
+     * Component-port targets are runtime projections. Restore their authored
+     * values before emitting or saving the page so a composition delivery never
+     * becomes an accidental document edit.
+     */
+    private restoreAuthoredCompositionTargetInputs;
+    private readOwnValueAtPath;
+    private removeOwnValueAtPath;
+    private tokenizeInputPath;
     /**
      * Preset defaults are a runtime projection, not authored page state.
      *