@praxisui/core 9.0.41 → 9.0.42

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-30T07:54:09.799Z",
+  "generatedAt": "2026-08-30T12:51:40.847Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.41",
+  "packageVersion": "9.0.42",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 4,

package/fesm2022/praxisui-core.mjs

@@ -40667,12 +40667,14 @@ class DynamicWidgetPageComponent {
             this.savePage(canonicalPage);
         }
     }
-    applyLayout(layout, grouping) {
+    applyLayout(layout, grouping, deviceLayoutColumnsSelected = false) {
         this.layout = layout;
         this.canvas = undefined;
         this.grouping = grouping || [];
         const orientation = layout?.orientation || 'vertical';
-        const columns = orientation === 'columns' ? this.resolveColumns(layout) : 1;
+        const columns = orientation === 'columns'
+            ? this.resolveColumns(layout, deviceLayoutColumnsSelected)
+            : 1;
         this.pageColumnCount = columns;
         this.gridTemplateColumns = `repeat(${columns}, minmax(0, 1fr))`;
         this.pageGap = layout?.gap || '16px';
@@ -40832,14 +40834,16 @@ class DynamicWidgetPageComponent {
         this.layoutAnnouncement = this.blockedCanvasAnnouncement(interaction.kind);
         this.applyTransientPagePreview(interaction.startPage, this.buildStateRuntime(interaction.startPage.state, interaction.startPage.context));
     }
-    resolveColumns(layout) {
+    resolveColumns(layout, deviceLayoutColumnsSelected = false) {
         const base = Math.max(1, Number(layout?.columns) || 2);
-        const defaults = {
-            sm: 1,
-            md: Math.min(2, base),
-            lg: Math.min(3, base),
-            xl: base,
-        };
+        const defaults = deviceLayoutColumnsSelected
+            ? { sm: base, md: base, lg: base, xl: base }
+            : {
+                sm: 1,
+                md: Math.min(2, base),
+                lg: Math.min(3, base),
+                xl: base,
+            };
         const bp = layout?.breakpoints || {};
         const columns = {
             sm: Math.max(1, Number(bp.sm ?? defaults.sm)),
@@ -40928,7 +40932,7 @@ class DynamicWidgetPageComponent {
             this.applyCanvasLayout(effective.canvas, effective.layout, effective.grouping);
         }
         else {
-            this.applyLayout(effective.layout, effective.grouping);
+            this.applyLayout(effective.layout, effective.grouping, effective.deviceLayoutColumnsSelected);
         }
         this.syncActiveTabs(effective.groups);
         this.mergedContext = this.mergeContext(pageDefinition?.context, this.context, runtime, {
@@ -40987,6 +40991,7 @@ class DynamicWidgetPageComponent {
             layout,
             canvas,
             grouping,
+            deviceLayoutColumnsSelected: variant?.layout?.columns !== undefined,
             widgets: renderedWidgets,
             groups,
         };
@@ -41905,9 +41910,10 @@ class DynamicWidgetPageComponent {
         if (canvasItem) {
             return `${canvasItem.col} / span ${canvasItem.colSpan}`;
         }
-        if (!widget.renderSpan || widget.renderSpan <= 1)
+        const renderSpan = Math.min(this.pageColumnCount, Math.max(1, Math.trunc(Number(widget.renderSpan) || 1)));
+        if (renderSpan <= 1)
             return null;
-        return `span ${widget.renderSpan}`;
+        return `span ${renderSpan}`;
     }
     widgetGridRow(widget) {
         const canvasItem = this.resolveRenderedCanvasItem(widget);
@@ -41935,7 +41941,76 @@ class DynamicWidgetPageComponent {
     }
     toPersistedCanonicalPage(page) {
         this.assertNoLegacyConnections(page);
-        return writeCompositionLinksToPersistedPage(page, page.composition?.links || []);
+        const canonicalPage = this.stripDerivedPresetDefaults(page);
+        return writeCompositionLinksToPersistedPage(canonicalPage, canonicalPage.composition?.links || []);
+    }
+    /**
+     * Preset defaults are a runtime projection, not authored page state.
+     *
+     * Keeping an identical derived grouping in the persisted document would turn
+     * semantic slot ids such as `master` and `detail-table` into apparent widget
+     * references. The canonical page therefore keeps the preset id and slot
+     * assignments while omitting defaults that the runtime can deterministically
+     * rehydrate. Explicit overrides remain persisted.
+     */
+    stripDerivedPresetDefaults(page) {
+        const canonical = this.clonePageDefinition(page);
+        const preset = this.resolveLayoutPresetDefinition(canonical);
+        if (!preset)
+            return canonical;
+        const layoutDelta = this.jsonObjectDelta(canonical.layout, preset.defaultLayout);
+        if (layoutDelta) {
+            canonical.layout = layoutDelta;
+        }
+        else {
+            delete canonical.layout;
+        }
+        if (this.sameJsonStructure(canonical.grouping, preset.defaultGrouping)) {
+            delete canonical.grouping;
+        }
+        if (canonical.themePreset === preset.defaultThemePreset) {
+            delete canonical.themePreset;
+        }
+        return canonical;
+    }
+    jsonObjectDelta(value, defaults) {
+        if (!value)
+            return undefined;
+        const delta = {};
+        for (const [key, entry] of Object.entries(value)) {
+            const defaultEntry = defaults?.[key];
+            if (this.isJsonObject(entry) && this.isJsonObject(defaultEntry)) {
+                const nestedDelta = this.jsonObjectDelta(entry, defaultEntry);
+                if (nestedDelta)
+                    delta[key] = nestedDelta;
+                continue;
+            }
+            if (!this.sameJsonStructure(entry, defaultEntry)) {
+                delta[key] = this.stableJsonValue(entry);
+            }
+        }
+        return Object.keys(delta).length ? delta : undefined;
+    }
+    isJsonObject(value) {
+        return !!value && typeof value === 'object' && !Array.isArray(value);
+    }
+    sameJsonStructure(left, right) {
+        return JSON.stringify(this.stableJsonValue(left)) ===
+            JSON.stringify(this.stableJsonValue(right));
+    }
+    stableJsonValue(value) {
+        if (Array.isArray(value)) {
+            return value.map((entry) => this.stableJsonValue(entry));
+        }
+        if (this.isJsonObject(value)) {
+            return Object.keys(value)
+                .sort()
+                .reduce((result, key) => {
+                result[key] = this.stableJsonValue(value[key]);
+                return result;
+            }, {});
+        }
+        return value;
     }
     savePage(page) {
         const key = this.storageKey();

package/package.json

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

@@ -16835,6 +16835,20 @@ declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     private mergeClassNames;
     private resolveRenderedCanvasItem;
     private toPersistedCanonicalPage;
+    /**
+     * Preset defaults are a runtime projection, not authored page state.
+     *
+     * Keeping an identical derived grouping in the persisted document would turn
+     * semantic slot ids such as `master` and `detail-table` into apparent widget
+     * references. The canonical page therefore keeps the preset id and slot
+     * assignments while omitting defaults that the runtime can deterministically
+     * rehydrate. Explicit overrides remain persisted.
+     */
+    private stripDerivedPresetDefaults;
+    private jsonObjectDelta;
+    private isJsonObject;
+    private sameJsonStructure;
+    private stableJsonValue;
     private savePage;
     private loadPersistedPage;
     private storageKey;