@praxisui/core 9.0.41 → 9.0.43

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-30T07:54:09.799Z",
+  "generatedAt": "2026-08-30T14:33:21.224Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.41",
+  "packageVersion": "9.0.43",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 4,
@@ -4584,9 +4584,9 @@
         {
           "chunkIndex": 159,
           "chunkKind": "recipe",
-          "content": "{\"_comment\":\"Recipe para agentes criarem uma Praxis Dynamic Page com tabela rica sobre o quickstart publicado.\",\"_comment2\":\"Use quando a meta for demonstrar renderers, formatters e configuracao de coluna em praxis-table sem mudar o backend.\",\"templateMeta\":{\"registryKey\":\"praxis-dynamic-page\",\"variantId\":\"rich-table-surface\",\"status\":\"public-example\",\"useWhen\":\"Create a metadata-driven page that turns one resource table into a rich operational surface with explicit renderers and formatters.\",\"examplePrompts\":[\"crie uma tabela rica de funcionarios com avatar, badges, salario e datas\",\"gere um exemplo de praxis-table mostrando renderers e formatters\",\"monte uma dynamic page com tabela operacional usando o quickstart publicado\"]},\"platformValue\":{\"canonicalContract\":\"praxis-metadata-starter publishes the structural funcionarios schema through /schemas/filtered.\",\"referenceApi\":\"praxis-api-quickstart serves funcionarios data and options on Render.\",\"angularRuntime\":\"@praxisui/core resolves praxis-dynamic-page and @praxisui/table renders the configured table.\",\"publicExamples\":\"praxis-ui-landing-page exposes the JSON envelope, live runtime preview and capability coverage map.\",\"agentCorpus\":\"praxisui-http-examples provides executable metadata and filter evidence.\"},\"operationalEvidence\":{\"baseUrl\":\"https://praxis-api-quickstart.onrender.com\",\"safeFirstIds\":[\"filtered-schema-response-funcionarios\",\"funcionarios-filter-basic\"],\"httpExamples\":[\"praxisui-http-examples/http/metadata/filtered_schema_response_funcionarios.http\",\"praxisui-http-examples/http/resources/funcionarios_filter_basic.http\"]},\"authoringGuidance\":[\"Keep resourcePath as the base resource path, without /filter.\",\"Let /schemas/filtered provide the canonical field metadata.\",\"Use host-authored columns only to demonstrate renderers, formatting, width, sticky columns and visual density.\",\"Prefer renderer examples that map to real backend fields; do not invent frontend-only fields for a remote example.\",\"Keep status presentation read-only unless a real backend action is configured.\",\"Treat salary as sensitive demonstration data; real hosts should gate visibility and exports through policy.\",\"Emit rowClick and selectionChange so the page can later compose this table with forms, charts or actions.\"],\"teaches\":[\"table.renderers.avatar\",\"table.renderers.badge\",\"table.renderers.chip\",\"table.conditional-renderers.status-badge\",\"table.formatters.currency\",\"table.formatters.date\",\"table.selection-state\"],\"page\":{\"layout\":{\"orientation\":\"columns\",\"columns\":1,\"gap\":\"16px\"},\"widgets\":[{\"key\":\"funcionariosRichTable\",\"shell\":{\"kind\":\"dashboard-card\",\"icon\":\"table\",\"title\":\"Funcionarios rich surface\",\"subtitle\":\"Renderers, formatters and dense business columns\"},\"definition\":{\"id\":\"praxis-table\",\"bindingOrder\":[\"config\",\"resourcePath\"],\"inputs\":{\"resourcePath\":\"human-resources/funcionarios\",\"tableId\":\"human-resources-funcionarios-rich-surface\",\"config\":{\"toolbar\":{\"visible\":true,\"title\":\"Funcionarios\",\"subtitle\":\"Rich metadata-driven employee surface\"},\"columns\":[{\"field\":\"avatarUrl\",\"header\":\"Avatar\",\"type\":\"string\",\"renderer\":{\"type\":\"avatar\",\"avatar\":{\"srcField\":\"avatarUrl\",\"altField\":\"nomeCompleto\",\"initialsField\":\"nomeCompleto\",\"shape\":\"circle\",\"size\":36}},\"width\":\"88px\",\"sticky\":\"start\"},{\"field\":\"nomeCompleto\",\"header\":\"Nome Completo\",\"type\":\"string\",\"sticky\":\"start\",\"width\":\"220px\"},{\"field\":\"email\",\"header\":\"Email\",\"type\":\"string\",\"width\":\"260px\"},{\"field\":\"telefone\",\"header\":\"Telefone\",\"type\":\"string\",\"width\":\"160px\"},{\"field\":\"salario\",\"header\":\"Salario\",\"type\":\"currency\",\"align\":\"end\",\"format\":\"BRL|symbol|2\",\"width\":\"150px\"},{\"field\":\"cargoNome\",\"header\":\"Cargo\",\"type\":\"string\",\"renderer\":{\"type\":\"chip\",\"chip\":{\"textField\":\"cargoNome\",\"variant\":\"outlined\",\"color\":\"primary\"}},\"width\":\"190px\"},{\"field\":\"departamentoNome\",\"header\":\"Departamento\",\"type\":\"string\",\"renderer\":{\"type\":\"badge\",\"badge\":{\"textField\":\"departamentoNome\",\"variant\":\"soft\",\"color\":\"accent\"}},\"width\":\"180px\"},{\"field\":\"estadoCivil\",\"header\":\"Estado Civil\",\"type\":\"string\",\"renderer\":{\"type\":\"badge\",\"badge\":{\"textField\":\"estadoCivil\",\"variant\":\"outlined\",\"color\":\"primary\"}},\"width\":\"150px\"},{\"field\":\"dataAdmissao\",\"header\":\"Data de Admissao\",\"type\":\"date\",\"format\":\"dd/MM/yyyy\",\"width\":\"170px\"},{\"field\":\"dataNascimento\",\"header\":\"Data de Nascimento\",\"type\":\"date\",\"format\":\"dd/MM/yyyy\",\"width\":\"190px\"},{\"field\":\"ativo\",\"header\":\"Status\",\"type\":\"boolean\",\"align\":\"center\",\"format\":\"active-inactive\",\"width\":\"130px\",\"conditionalRenderers\":[{\"condition\":{\"==\":[{\"var\":\"ativo\"},true]},\"renderer\":{\"type\":\"badge\",\"badge\":{\"text\":\"Ativo\",\"color\":\"success\",\"variant\":\"filled\",\"icon\":\"check_circle\"}}},{\"condition\":{\"==\":[{\"var\":\"ativo\"},false]},\"renderer\":{\"type\":\"badge\",\"badge\":{\"text\":\"Inativo\",\"color\":\"warn\",\"variant\":\"outlined\",\"icon\":\"block\"}}}]}],\"behavior\":{\"selection\":{\"enabled\":true,\"type\":\"multiple\"},\"density\":\"compact\"}}},\"outputs\":{\"rowClick\":\"emit\",\"selectionChange\":\"emit\"}}}]}}",
+          "content": "{\"_comment\":\"Recipe para agentes criarem uma Praxis Dynamic Page com tabela rica sobre o quickstart publicado.\",\"_comment2\":\"Use quando a meta for demonstrar renderers, formatters e configuracao de coluna em praxis-table sem mudar o backend.\",\"templateMeta\":{\"registryKey\":\"praxis-dynamic-page\",\"variantId\":\"rich-table-surface\",\"status\":\"public-example\",\"useWhen\":\"Create a metadata-driven page that turns one resource table into a rich operational surface with explicit renderers and formatters.\",\"examplePrompts\":[\"crie uma tabela rica de funcionarios com avatar, badges, salario e datas\",\"gere um exemplo de praxis-table mostrando renderers e formatters\",\"monte uma dynamic page com tabela operacional usando o quickstart publicado\"]},\"platformValue\":{\"canonicalContract\":\"praxis-metadata-starter publishes the structural funcionarios schema through /schemas/filtered.\",\"referenceApi\":\"praxis-api-quickstart serves funcionarios data and options on Render.\",\"angularRuntime\":\"@praxisui/core resolves praxis-dynamic-page and @praxisui/table renders the configured table.\",\"publicExamples\":\"praxis-ui-landing-page exposes the JSON envelope, live runtime preview and capability coverage map.\",\"agentCorpus\":\"praxisui-http-examples provides executable metadata and filter evidence.\"},\"operationalEvidence\":{\"baseUrl\":\"https://praxis-api-quickstart.onrender.com\",\"safeFirstIds\":[\"filtered-schema-response-funcionarios\",\"funcionarios-filter-basic\"],\"httpExamples\":[\"praxisui-http-examples/http/metadata/filtered_schema_response_funcionarios.http\",\"praxisui-http-examples/http/resources/funcionarios_filter_basic.http\"]},\"authoringGuidance\":[\"Keep resourcePath as the base resource path, without /filter.\",\"Let /schemas/filtered provide the canonical field metadata.\",\"Keep columns empty and use columnProjection overrides for renderers, formatting, width, sticky columns and visual density.\",\"Prefer renderer examples that map to real backend fields; do not invent frontend-only fields for a remote example.\",\"Keep status presentation read-only unless a real backend action is configured.\",\"Treat salary as sensitive demonstration data; real hosts should gate visibility and exports through policy.\",\"Emit rowClick and selectionChange so the page can later compose this table with forms, charts or actions.\"],\"teaches\":[\"table.renderers.avatar\",\"table.renderers.compose\",\"table.renderers.badge\",\"table.renderers.chip\",\"table.conditional-renderers.status-badge\",\"table.formatters.currency\",\"table.formatters.date\",\"table.selection-state\"],\"page\":{\"layout\":{\"orientation\":\"columns\",\"columns\":1,\"gap\":\"16px\"},\"widgets\":[{\"key\":\"funcionariosRichTable\",\"shell\":{\"kind\":\"dashboard-card\",\"icon\":\"table\",\"title\":\"Funcionarios rich surface\",\"subtitle\":\"Renderers, formatters and dense business columns\"},\"definition\":{\"id\":\"praxis-table\",\"bindingOrder\":[\"config\",\"resourcePath\"],\"inputs\":{\"resourcePath\":\"human-resources/funcionarios\",\"tableId\":\"human-resources-funcionarios-rich-surface\",\"config\":{\"toolbar\":{\"visible\":true,\"title\":\"Funcionarios\",\"subtitle\":\"Rich metadata-driven employee surface\"},\"columns\":[],\"columnProjection\":{\"source\":\"schema\",\"include\":[\"nomeCompleto\",\"email\",\"telefone\",\"salario\",\"cargoNome\",\"departamentoNome\",\"estadoCivil\",\"dataAdmissao\",\"dataNascimento\",\"ativo\"],\"overrides\":{\"nomeCompleto\":{\"header\":\"Nome Completo\",\"sticky\":\"start\",\"width\":\"260px\",\"renderer\":{\"type\":\"compose\",\"compose\":{\"items\":[{\"type\":\"avatar\",\"avatar\":{\"srcField\":\"avatarUrl\",\"altField\":\"nomeCompleto\",\"initialsField\":\"nomeCompleto\",\"shape\":\"circle\",\"size\":36}},{\"type\":\"value\",\"field\":\"nomeCompleto\"}],\"layout\":{\"direction\":\"row\",\"align\":\"center\",\"gap\":10}}}},\"email\":{\"header\":\"Email\",\"width\":\"260px\"},\"telefone\":{\"header\":\"Telefone\",\"width\":\"160px\"},\"salario\":{\"header\":\"Salario\",\"type\":\"currency\",\"align\":\"end\",\"format\":\"BRL|symbol|2\",\"width\":\"150px\"},\"cargoNome\":{\"header\":\"Cargo\",\"renderer\":{\"type\":\"chip\",\"chip\":{\"textField\":\"cargoNome\",\"variant\":\"outlined\",\"color\":\"primary\"}},\"width\":\"190px\"},\"departamentoNome\":{\"header\":\"Departamento\",\"renderer\":{\"type\":\"badge\",\"badge\":{\"textField\":\"departamentoNome\",\"variant\":\"soft\",\"color\":\"accent\"}},\"width\":\"180px\"},\"estadoCivil\":{\"header\":\"Estado Civil\",\"renderer\":{\"type\":\"badge\",\"badge\":{\"textField\":\"estadoCivil\",\"variant\":\"outlined\",\"color\":\"primary\"}},\"width\":\"150px\"},\"dataAdmissao\":{\"header\":\"Data de Admissao\",\"format\":\"dd/MM/yyyy\",\"width\":\"170px\"},\"dataNascimento\":{\"header\":\"Data de Nascimento\",\"format\":\"dd/MM/yyyy\",\"width\":\"190px\"},\"ativo\":{\"header\":\"Status\",\"align\":\"center\",\"format\":\"active-inactive\",\"width\":\"130px\",\"conditionalRenderers\":[{\"id\":\"status-ativo\",\"condition\":{\"==\":[{\"var\":\"ativo\"},true]},\"renderer\":{\"type\":\"badge\",\"badge\":{\"text\":\"Ativo\",\"color\":\"success\",\"variant\":\"filled\",\"icon\":\"check_circle\"}}},{\"id\":\"status-inativo\",\"condition\":{\"==\":[{\"var\":\"ativo\"},false]},\"renderer\":{\"type\":\"badge\",\"badge\":{\"text\":\"Inativo\",\"color\":\"warn\",\"variant\":\"outlined\",\"icon\":\"block\"}}}]}}},\"behavior\":{\"selection\":{\"enabled\":true,\"type\":\"multiple\"},\"density\":\"compact\"}}},\"outputs\":{\"rowClick\":\"emit\",\"selectionChange\":\"emit\"}}}]}}",
           "sourcePointer": "examples/ai-recipes/praxis-dynamic-page.rich-table-surface.json",
-          "contentHash": "ade4a16667fe5bab42d528c14be11994ea993405d0caa62558e4a7e5b7076cd3",
+          "contentHash": "aa3ab19cc0da083075076d3efa34a947b4ec087f09aba04260d6af8ee53282b6",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-page",
           "corpusVersion": "1.0.0"

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.43",
   "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;