@praxisui/core 9.0.53 → 9.0.54

package/README.md

@@ -206,6 +206,11 @@ host actually supports. Omitted entries preserve full authoring for backward com
 grant controls visible authoring operations only: it is not persisted in `WidgetPageDefinition` and
 does not replace component manifests, backend capabilities, authorization or validation.
 
+Hosts that maintain an authored source separately from runtime state should consume
+`pageAuthoringChange`. It emits only explicit canvas, shell, page, widget-input and removal edits.
+`pageChange` remains the compatibility stream for every canonical page update, including persistent
+runtime state; transient composition projections remain excluded from both outputs.
+
 Page-owned business copy can use `page.i18n` plus explicit `PraxisTextValue`
 descriptors inside widget shells or nested widget inputs. The runtime resolves
 those descriptors only in its render projection, so the authored and persisted

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-31T21:15:24.814Z",
+  "generatedAt": "2026-09-01T03:28:13.726Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.53",
+  "packageVersion": "9.0.54",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 4,
@@ -528,7 +528,13 @@
           "name": "pageChange",
           "type": "WidgetPageDefinition",
           "required": false,
-          "description": "Emitido ao alterar a definição authorada da página; projeções transitórias de composição permanecem somente no runtime."
+          "description": "Emitido quando a página canônica muda por authoring ou por estado runtime persistente; projeções transitórias permanecem somente no runtime."
+        },
+        {
+          "name": "pageAuthoringChange",
+          "type": "WidgetPageDefinition",
+          "required": false,
+          "description": "Emitido somente após operações explícitas de authoring, separado de mudanças de estado e composição do runtime."
         },
         {
           "name": "widgetEvent",
@@ -3000,9 +3006,9 @@
         {
           "chunkIndex": 0,
           "chunkKind": "summary",
-          "content": "Component ID: praxis-dynamic-page\nSelector: praxis-dynamic-page\nFriendly Name: Dynamic Page\nDescription: Página dinâmica com widgets e composition.links em layout responsivo, incluindo mediação runtime para rich-content hospedado.\nCategory: page\nLib/Package: @praxisui/core\nTags: widget, page, dynamic, layout\nInputs:\n  - page (WidgetPageDefinition)\n  - context (Record<string, any>)\n  - strictValidation (boolean)\n  - enableCustomization (boolean)\n  - authoringCapabilities (WidgetPageAuthoringCapabilities)\n  - showPageSettingsButton (boolean)\n  - shellEditorComponent (Type<any>)\n  - pageEditorComponent (Type<any>)\n  - autoPersist (boolean)\n  - pageIdentity (PageIdentity)\n  - componentInstanceId (string)\nOutputs:\n  - pageChange (WidgetPageDefinition)\n  - widgetEvent (WidgetEventEnvelope)\n  - widgetDiagnosticsChange (Record<string, WidgetResolutionDiagnostic>)\n",
+          "content": "Component ID: praxis-dynamic-page\nSelector: praxis-dynamic-page\nFriendly Name: Dynamic Page\nDescription: Página dinâmica com widgets e composition.links em layout responsivo, incluindo mediação runtime para rich-content hospedado.\nCategory: page\nLib/Package: @praxisui/core\nTags: widget, page, dynamic, layout\nInputs:\n  - page (WidgetPageDefinition)\n  - context (Record<string, any>)\n  - strictValidation (boolean)\n  - enableCustomization (boolean)\n  - authoringCapabilities (WidgetPageAuthoringCapabilities)\n  - showPageSettingsButton (boolean)\n  - shellEditorComponent (Type<any>)\n  - pageEditorComponent (Type<any>)\n  - autoPersist (boolean)\n  - pageIdentity (PageIdentity)\n  - componentInstanceId (string)\nOutputs:\n  - pageChange (WidgetPageDefinition)\n  - pageAuthoringChange (WidgetPageDefinition)\n  - widgetEvent (WidgetEventEnvelope)\n  - widgetDiagnosticsChange (Record<string, WidgetResolutionDiagnostic>)\n",
           "sourcePointer": "projects/praxis-core/src/lib/widgets/dynamic-widget-page.metadata.ts",
-          "contentHash": "27a7ae1a0c39ca506ccadd06b095f4370d5e57e34558965fbd40da1d82b3143d",
+          "contentHash": "d3f9a1519379d733fb13af496aff99953cd5a37399555955cbf747457185c2e3",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-page",
           "corpusVersion": "1.0.0"

package/fesm2022/praxisui-core.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Component, InjectionToken, Injectable, inject, Inject, Optional, SkipSelf, makeEnvironmentProviders, APP_INITIALIZER, signal, computed, DestroyRef, ENVIRONMENT_INITIALIZER, ErrorHandler, Input, Directive, input, booleanAttribute, ChangeDetectionStrategy, EventEmitter, Output, SecurityContext, ViewContainerRef, SimpleChange, ContentChild, HostBinding, Injector, ElementRef, ChangeDetectorRef, afterNextRender, HostListener, ViewChildren, ViewChild, output, effect } from '@angular/core';
+import { Component, InjectionToken, Injectable, inject, Inject, Optional, SkipSelf, makeEnvironmentProviders, APP_INITIALIZER, signal, computed, DestroyRef, ENVIRONMENT_INITIALIZER, ErrorHandler, Input, Directive, input, booleanAttribute, ChangeDetectionStrategy, EventEmitter, Output, SecurityContext, ViewContainerRef, SimpleChange, ContentChild, HostBinding, output, Injector, ElementRef, ChangeDetectorRef, afterNextRender, HostListener, ViewChildren, ViewChild, effect } from '@angular/core';
 import * as i1 from '@angular/common/http';
 import { HttpHeaders, HttpClient, HttpParams, HttpResponse, HttpContextToken, HTTP_INTERCEPTORS, withInterceptors } from '@angular/common/http';
 import { of, defer, throwError, from, EMPTY, BehaviorSubject, firstValueFrom, Subject, finalize as finalize$1, shareReplay as shareReplay$1, map as map$1, switchMap as switchMap$1, catchError as catchError$1, forkJoin } from 'rxjs';
@@ -16683,9 +16683,11 @@ class SurfaceOpenMaterializerService {
         const surfaceId = this.stableSurfaceId(payload);
         const relatedResource = this.resolveRelatedResource(payload);
         const schemaResourcePath = this.normalizeResourcePath(relatedResource?.childResourcePath || this.resolveSurfacePath(payload));
-        const resourcePath = this.normalizeResourcePath(readUrl);
-        const tableConfig = this.buildLocalTableConfig(fields, data, payload);
-        const operations = this.resolveRelatedChildOperations(payload);
+        const resourcePath = this.resolveRelatedCommandResourcePath(payload, resourceId);
+        const operations = resourcePath
+            ? this.resolveRelatedChildOperations(payload)
+            : new Set();
+        const tableConfig = this.buildLocalTableConfig(fields, data, payload, operations);
         const actions = this.buildRelatedCrudActions(payload, operations, {
             resourcePath,
             schemaResourcePath,
@@ -16740,7 +16742,8 @@ class SurfaceOpenMaterializerService {
                         materialization: {
                             ...payload.context?.['materialization'],
                             readUrl,
-                            relatedResourceCrud: true,
+                            relatedResourceCrud: operations.size > 0,
+                            relatedResourceCommandPathResolved: !!resourcePath,
                         },
                     },
                     enableCustomization: previousInputs['enableCustomization'] ?? false,
@@ -16870,7 +16873,7 @@ class SurfaceOpenMaterializerService {
         ]);
         return Object.fromEntries(Object.entries(inputs).filter(([key]) => supported.has(key)));
     }
-    buildLocalTableConfig(fields, data, payload) {
+    buildLocalTableConfig(fields, data, payload, childOperations = this.resolveRelatedChildOperations(payload)) {
         const schemaColumns = fields
             .filter((field) => !field.hidden && !field.tableHidden && !!field.name)
             .map((field) => ({
@@ -16883,7 +16886,6 @@ class SurfaceOpenMaterializerService {
         const fallbackColumns = schemaColumns.length
             ? []
             : this.inferColumnsFromData(data);
-        const childOperations = this.resolveRelatedChildOperations(payload);
         const relatedActions = this.buildRelatedCrudActions(payload, childOperations);
         const previousConfig = this.objectRecord(payload.widget?.inputs?.['config']);
         const previousToolbar = this.objectRecord(previousConfig['toolbar']);
@@ -17159,6 +17161,22 @@ class SurfaceOpenMaterializerService {
         const relatedResource = payload.context?.['relatedResource'];
         return relatedResource;
     }
+    resolveRelatedCommandResourcePath(payload, parentResourceId) {
+        const relatedResource = this.resolveRelatedResource(payload);
+        const childResourcePath = this.normalizeResourcePath(relatedResource?.childResourcePath);
+        if (!childResourcePath)
+            return '';
+        const parentIdPathVariable = String(relatedResource?.parentIdPathVariable || '').trim();
+        if (!parentIdPathVariable) {
+            return /[{}]/u.test(childResourcePath) ? '' : childResourcePath;
+        }
+        const placeholder = `{${parentIdPathVariable}}`;
+        if (!childResourcePath.includes(placeholder)) {
+            return /[{}]/u.test(childResourcePath) ? '' : childResourcePath;
+        }
+        const resolvedPath = childResourcePath.replaceAll(placeholder, encodeURIComponent(String(parentResourceId)));
+        return /[{}]/u.test(resolvedPath) ? '' : resolvedPath;
+    }
     buildRelatedParentInitialValue(payload) {
         const parentField = String(this.resolveRelatedResource(payload)?.childParentField || '').trim();
         const resource = payload.context?.['resource'];
@@ -38437,6 +38455,8 @@ class DynamicWidgetPageComponent {
     /** Enables a contextual authoring assistant entrypoint for the selected widget. */
     showWidgetAssistantButton = false;
     pageChange = new EventEmitter();
+    /** Emits only explicit authoring operations, never runtime state projection. */
+    pageAuthoringChange = output();
     widgetEvent = new EventEmitter();
     widgetSelectionChange = new EventEmitter();
     widgetAssistantRequested = new EventEmitter();
@@ -40532,7 +40552,7 @@ class DynamicWidgetPageComponent {
                 },
             }
             : w);
-        this.applyPageUpdate({ ...page, widgets }, persist);
+        this.applyAuthoringPageUpdate({ ...page, widgets }, persist);
     }
     async confirmAndRemoveWidget(widgetKey) {
         if (!this.canRemoveWidgets())
@@ -40553,7 +40573,7 @@ class DynamicWidgetPageComponent {
         if (!confirmation.success || confirmation.data !== true) {
             return;
         }
-        this.applyPageUpdate(this.removeWidgetReferences(page, widgetKey), true);
+        this.applyAuthoringPageUpdate(this.removeWidgetReferences(page, widgetKey), true);
         if (this.selectedWidgetKeyState() === widgetKey) {
             this.selectedWidgetKeyState.set(null);
             this.widgetSelectionChange.emit(null);
@@ -40715,7 +40735,7 @@ class DynamicWidgetPageComponent {
             ui.shell = shell;
             context = { ...context, ui };
         }
-        this.applyPageUpdate({ ...page, widgets, context }, persist);
+        this.applyAuthoringPageUpdate({ ...page, widgets, context }, persist);
     }
     constrainWidgetShellResult(original, proposed) {
         const next = proposed ? { ...proposed } : {};
@@ -40756,12 +40776,12 @@ class DynamicWidgetPageComponent {
         if (!result)
             return;
         if ('widgets' in result) {
-            this.applyPageUpdate(result, persist);
+            this.applyAuthoringPageUpdate(result, persist);
             return;
         }
         const page = this.ensurePageDefinition();
         if (result.fullPage) {
-            this.applyPageUpdate(result.fullPage, persist);
+            this.applyAuthoringPageUpdate(result.fullPage, persist);
             return;
         }
         const layout = result.layout ?? undefined;
@@ -40777,7 +40797,7 @@ class DynamicWidgetPageComponent {
         context = { ...context, ui };
         const layoutPreset = (result.layoutPreset || '').trim();
         const themePreset = (result.themePreset || '').trim();
-        this.applyPageUpdate({
+        this.applyAuthoringPageUpdate({
             ...page,
             layout,
             context,
@@ -40785,6 +40805,12 @@ class DynamicWidgetPageComponent {
             themePreset: themePreset || undefined,
         }, persist);
     }
+    applyAuthoringPageUpdate(next, persist = true, runtime = this.buildStateRuntime(next.state, next.context), syncCompositionAdapter = true, skipStateWidgetProjection = false, emitUnchangedCanonicalPage = true) {
+        this.applyPageUpdate(next, persist, runtime, syncCompositionAdapter, skipStateWidgetProjection, emitUnchangedCanonicalPage);
+        if (this.authoredPageDefinition) {
+            this.pageAuthoringChange.emit(this.clonePageDefinition(this.authoredPageDefinition));
+        }
+    }
     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 };
@@ -41595,7 +41621,7 @@ class DynamicWidgetPageComponent {
             this.transientCanvasItemsState.set({});
             this.canvasPreviewState.set(null);
             this.canvasPreviewInvalidState.set(false);
-            this.applyPageUpdate(page, true);
+            this.applyAuthoringPageUpdate(page, true);
         }
         else {
             this.transientCanvasItemsState.set(changed
@@ -42414,7 +42440,7 @@ class DynamicWidgetPageComponent {
         throw new Error('DynamicWidgetPageComponent no longer accepts `page.connections`. Use `composition.links` only.');
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: DynamicWidgetPageComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: DynamicWidgetPageComponent, isStandalone: true, selector: "praxis-dynamic-page", inputs: { page: "page", context: "context", strictValidation: "strictValidation", enableCustomization: "enableCustomization", authoringCapabilities: "authoringCapabilities", showPageSettingsButton: "showPageSettingsButton", shellEditorComponent: "shellEditorComponent", pageEditorComponent: "pageEditorComponent", autoPersist: "autoPersist", pageIdentity: "pageIdentity", componentInstanceId: "componentInstanceId", showWidgetAssistantButton: "showWidgetAssistantButton" }, outputs: { pageChange: "pageChange", widgetEvent: "widgetEvent", widgetSelectionChange: "widgetSelectionChange", widgetAssistantRequested: "widgetAssistantRequested", widgetDiagnosticsChange: "widgetDiagnosticsChange" }, host: { listeners: { "window:resize": "onWindowResize()", "window:pointermove": "onCanvasPointerMove($event)", "window:pointerup": "onCanvasPointerUp($event)", "window:pointercancel": "onCanvasPointerCancel($event)" } }, providers: [providePraxisI18nConfig(DYNAMIC_WIDGET_PAGE_I18N_CONFIG)], viewQueries: [{ propertyName: "pageCanvasHost", first: true, predicate: ["pageCanvasHost"], descendants: true }, { propertyName: "widgetLoaders", predicate: ["widgetLoader"], descendants: true }], usesOnChanges: true, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: DynamicWidgetPageComponent, isStandalone: true, selector: "praxis-dynamic-page", inputs: { page: "page", context: "context", strictValidation: "strictValidation", enableCustomization: "enableCustomization", authoringCapabilities: "authoringCapabilities", showPageSettingsButton: "showPageSettingsButton", shellEditorComponent: "shellEditorComponent", pageEditorComponent: "pageEditorComponent", autoPersist: "autoPersist", pageIdentity: "pageIdentity", componentInstanceId: "componentInstanceId", showWidgetAssistantButton: "showWidgetAssistantButton" }, outputs: { pageChange: "pageChange", pageAuthoringChange: "pageAuthoringChange", widgetEvent: "widgetEvent", widgetSelectionChange: "widgetSelectionChange", widgetAssistantRequested: "widgetAssistantRequested", widgetDiagnosticsChange: "widgetDiagnosticsChange" }, host: { listeners: { "window:resize": "onWindowResize()", "window:pointermove": "onCanvasPointerMove($event)", "window:pointerup": "onCanvasPointerUp($event)", "window:pointercancel": "onCanvasPointerCancel($event)" } }, providers: [providePraxisI18nConfig(DYNAMIC_WIDGET_PAGE_I18N_CONFIG)], viewQueries: [{ propertyName: "pageCanvasHost", first: true, predicate: ["pageCanvasHost"], descendants: true }, { propertyName: "widgetLoaders", predicate: ["widgetLoader"], descendants: true }], usesOnChanges: true, ngImport: i0, template: `
     <div
       class="pdx-page-wrapper"
       [class.editing]="enableCustomization"
@@ -43246,7 +43272,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                 type: Input
             }], pageChange: [{
                 type: Output
-            }], widgetEvent: [{
+            }], pageAuthoringChange: [{ type: i0.Output, args: ["pageAuthoringChange"] }], widgetEvent: [{
                 type: Output
             }], widgetSelectionChange: [{
                 type: Output
@@ -43340,7 +43366,12 @@ const PRAXIS_DYNAMIC_PAGE_COMPONENT_METADATA = {
         {
             name: 'pageChange',
             type: 'WidgetPageDefinition',
-            description: 'Emitido ao alterar a definição authorada da página; projeções transitórias de composição permanecem somente no runtime.',
+            description: 'Emitido quando a página canônica muda por authoring ou por estado runtime persistente; projeções transitórias permanecem somente no runtime.',
+        },
+        {
+            name: 'pageAuthoringChange',
+            type: 'WidgetPageDefinition',
+            description: 'Emitido somente após operações explícitas de authoring, separado de mudanças de estado e composição do runtime.',
         },
         {
             name: 'widgetEvent',

package/package.json

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

@@ -11029,6 +11029,7 @@ declare class SurfaceOpenMaterializerService {
     private hasRelatedChildWriteOperations;
     private resolveRelatedChildOperations;
     private resolveRelatedResource;
+    private resolveRelatedCommandResourcePath;
     private buildRelatedParentInitialValue;
     private buildRelatedContextFields;
     private resolveRelatedSelectionKeyField;
@@ -16535,6 +16536,8 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     /** Enables a contextual authoring assistant entrypoint for the selected widget. */
     showWidgetAssistantButton: boolean;
     pageChange: EventEmitter<WidgetPageDefinition>;
+    /** Emits only explicit authoring operations, never runtime state projection. */
+    readonly pageAuthoringChange: i0.OutputEmitterRef<WidgetPageDefinition>;
     widgetEvent: EventEmitter<WidgetEventEnvelope>;
     widgetSelectionChange: EventEmitter<string | null>;
     widgetAssistantRequested: EventEmitter<string>;
@@ -16749,6 +16752,7 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     private constrainWidgetShellResult;
     private restoreWidgetShellFields;
     private applyPageLayout;
+    private applyAuthoringPageUpdate;
     private applyPageUpdate;
     private applyLayout;
     private applyCanvasLayout;
@@ -16885,7 +16889,7 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     private sanitizeSegment;
     private assertNoLegacyConnections;
     static ɵfac: i0.ɵɵFactoryDeclaration<DynamicWidgetPageComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicWidgetPageComponent, "praxis-dynamic-page", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "authoringCapabilities": { "alias": "authoringCapabilities"; "required": false; }; "showPageSettingsButton": { "alias": "showPageSettingsButton"; "required": false; }; "shellEditorComponent": { "alias": "shellEditorComponent"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; "autoPersist": { "alias": "autoPersist"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "showWidgetAssistantButton": { "alias": "showWidgetAssistantButton"; "required": false; }; }, { "pageChange": "pageChange"; "widgetEvent": "widgetEvent"; "widgetSelectionChange": "widgetSelectionChange"; "widgetAssistantRequested": "widgetAssistantRequested"; "widgetDiagnosticsChange": "widgetDiagnosticsChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicWidgetPageComponent, "praxis-dynamic-page", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "authoringCapabilities": { "alias": "authoringCapabilities"; "required": false; }; "showPageSettingsButton": { "alias": "showPageSettingsButton"; "required": false; }; "shellEditorComponent": { "alias": "shellEditorComponent"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; "autoPersist": { "alias": "autoPersist"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "showWidgetAssistantButton": { "alias": "showWidgetAssistantButton"; "required": false; }; }, { "pageChange": "pageChange"; "pageAuthoringChange": "pageAuthoringChange"; "widgetEvent": "widgetEvent"; "widgetSelectionChange": "widgetSelectionChange"; "widgetAssistantRequested": "widgetAssistantRequested"; "widgetDiagnosticsChange": "widgetDiagnosticsChange"; }, never, never, true, never>;
 }
 
 /** Metadata for Praxis Dynamic Page component */