@praxisui/page-builder 9.0.68-rc.2 → 9.0.68-rc.3

package/README.md

@@ -81,7 +81,7 @@ through its host. Preset selection does not introduce collective repacking or ne
 
 ### Device composition
 
-**Page settings → Responsiveness** opens on Mobile and shows one device at a time.
+**Page settings → Adjustments → Responsiveness** opens on Mobile and shows one device at a time.
 **Stack widgets** prepares a single-column variant in the base canvas's visual reading
 order, with natural content height. It replaces positions and width bounds only for
 that device, preserves hidden widgets and other overrides, and leaves the base and
@@ -97,7 +97,7 @@ precedence over grouping. The editor explains this distinction in the Grouping t
 
 ### Visual widget limits
 
-Open **Page settings → Widget limits** in the default Dynamic Page editor to set
+Open **Page settings → Adjustments → Widget limits** in the default Dynamic Page editor to set
 minimum/maximum width (columns) and height (rows). Choose the base canvas or a
 desktop, tablet or mobile override, without closing the editor. Blank base fields use Core defaults (minimum one,
 maximum grid width/unbounded row span); blank device fields inherit base limits.
@@ -978,7 +978,9 @@ In **Page settings → Arrange**, choose a visual distribution. This is an
 explicit arrangement of a complete existing base canvas, independent of layout preset
 selection. The current geometric reading order assigns columns; no titles or business
 roles are inferred. Heights, content, shell appearance, widget keys and composition links
-are preserved. The last column receives any remainder when the grid is indivisible.
+are preserved. Indivisible columns are distributed by fractional remainder; ties favor
+the larger weight, then the later lane. For example, four equal lanes over seven
+columns produce `1 + 2 + 2 + 2`, not `1 + 1 + 1 + 4`.
 
 Review the numbered before/after maps and widget names, then choose **Use arrangement
 in draft** and the Settings Panel's **Apply**. Preparation does not dirty or emit the page.
@@ -1016,3 +1018,44 @@ Undo restores only `col`, `row`, `colSpan` and `rowSpan`. Additional gap, theme,
 or limit edits remain in the draft. The owner-confirmed Apply receipt retains the undo
 when the reviewed geometry matches, including when unrelated fields were edited before
 Apply. Reset or replacement of the page still invalidates the transaction.
+
+
+### Corporate adoption and validation boundaries
+
+The template studio is a presentation and geometry editor. Its visual templates are
+Core theme presets; its layout templates describe composition roles. Neither gallery
+creates a governed business template, grants resource permissions, generates data
+connections, or implements a master-detail relationship by selecting a card.
+Governed template publication remains owned by Config Starter and its canonical
+references; host authoring eligibility, persistence identity and strong ETag handling
+remain required at their existing boundaries. Geometry locks are editing constraints,
+not an authorization mechanism.
+
+Use the following acceptance scope when adopting the editor in a corporate host:
+
+| Concern | Required evidence |
+| --- | --- |
+| Document integrity | Apply, Save and fresh reopen preserve widget inputs, keys, composition links, context, state, slot assignments and untouched device overrides. |
+| Concurrency and governance | The real host rejects stale ETags and unauthorized writes; local Apply or a passing geometry test does not prove either. |
+| Responsive authoring | Validate each intended device with its own locks, bounds, hidden widgets and child-content height. Base-arrangement admission does not certify every device editing operation. |
+| User experience | Check keyboard, desktop/narrow layout, locale and dark theme with representative business data. Automated accessibility checks do not replace task-based usability testing. |
+| Scale | Measure proposal generation and review rendering with the host's expected widget counts; small fixtures do not establish a performance envelope. |
+| Publication | Validate the actual npm train in the consumer. A local RC build is not a hosted-production smoke or approval to promote the stable channel. |
+
+The public Landing Studio deliberately hides full page settings under its authoring
+policy. Its JSON/Visual compatibility tests do not demonstrate the template gallery;
+use the canonical Dynamic Page laboratory or a host that enables page settings for that
+journey. Enabling that surface is a host policy decision, not a package upgrade effect.
+
+The source corrections following the 9.0.68-rc.2 review reject device stacking
+before changing the draft when it would alter effective position/size locks, including
+content height for size-locked widgets. Hidden untouched items remain unchanged. An
+explicit device override of a lock continues to follow the existing inheritance contract;
+this does not grant permission to change locks.
+
+Context paths `ui` and `ui.shell`, when present, must be objects; `ui.shell.preset`
+must be text when present. Incompatible imported or edited values remain in the draft
+and block value production with a localized diagnostic, allowing correction without
+losing unrelated context. Arrangement choices track their draft baseline even when the
+selected distribution initially produces no changes, so later edits clear stale status.
+These fixes are not part of the already published 9.0.68-rc.2 package.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-09-10T01:25:13.157Z",
+  "generatedAt": "2026-09-10T02:26:52.714Z",
   "packageName": "@praxisui/page-builder",
-  "packageVersion": "9.0.68-rc.2",
+  "packageVersion": "9.0.68-rc.3",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,

package/fesm2022/praxisui-page-builder.mjs

@@ -816,6 +816,8 @@ const PRAXIS_PAGE_BUILDER_EN_US = {
     'praxis.pageBuilder.editor.apply': 'Apply',
     'praxis.pageBuilder.editor.errors.invalidJson': 'Invalid JSON',
     'praxis.pageBuilder.editor.errors.canvasInvalid': 'Invalid canvas',
+    'praxis.pageBuilder.editor.devices.locked': 'Stacking would change a locked widget. Review its device locks first.',
+    'praxis.pageBuilder.editor.errors.contextStructure': 'Context ui and ui.shell must be objects; shell.preset must be text. Correct these fields without removing other context data.',
     'praxis.pageBuilder.editor.errors.contextInvalid': 'Invalid context',
     'praxis.pageBuilder.editor.errors.stateInvalid': 'Invalid state',
     'praxis.pageBuilder.editor.errors.duplicateGroupIds': 'Duplicate group IDs',
@@ -1879,6 +1881,8 @@ const PRAXIS_PAGE_BUILDER_PT_BR = {
     'praxis.pageBuilder.editor.apply': 'Aplicar',
     'praxis.pageBuilder.editor.errors.invalidJson': 'JSON inválido',
     'praxis.pageBuilder.editor.errors.canvasInvalid': 'Canvas inválido',
+    'praxis.pageBuilder.editor.devices.locked': 'O empilhamento alteraria um widget bloqueado. Revise os bloqueios desse dispositivo primeiro.',
+    'praxis.pageBuilder.editor.errors.contextStructure': 'No contexto, ui e ui.shell devem ser objetos; shell.preset deve ser texto. Corrija esses campos preservando os demais dados.',
     'praxis.pageBuilder.editor.errors.contextInvalid': 'Contexto inválido',
     'praxis.pageBuilder.editor.errors.stateInvalid': 'Estado inválido',
     'praxis.pageBuilder.editor.errors.duplicateGroupIds': 'IDs de grupo duplicados',
@@ -13554,6 +13558,7 @@ class DynamicPageConfigEditorComponent {
     focusArrangementFeedback = false;
     workspaceTab = signal(0, ...(ngDevMode ? [{ debugName: "workspaceTab" }] : /* istanbul ignore next */ []));
     arrangementSelection = signal('', ...(ngDevMode ? [{ debugName: "arrangementSelection" }] : /* istanbul ignore next */ []));
+    arrangementSelectionSource = '';
     // Transient authoring choices, expressed through the existing Core width contract.
     arrangementChoices = [
         { id: 'stack', weights: [1] }, { id: 'compare', weights: [1, 1] },
@@ -13603,6 +13608,8 @@ class DynamicPageConfigEditorComponent {
     previousArrangementItems;
     prepareArrangement(id) {
         this.arrangementPreview.set(null);
+        this.arrangementSelection.set('');
+        this.arrangementSelectionSource = '';
         const page = this.buildCurrentPage(true);
         if (!page)
             return;
@@ -13616,6 +13623,7 @@ class DynamicPageConfigEditorComponent {
             return;
         }
         this.arrangementSelection.set(id);
+        this.arrangementSelectionSource = this.draftFingerprint();
         this.arrangementMessage.set(proposal.changedKeys.length ? '' : this.tx('editor.arrange.unchanged', 'This arrangement already matches the page.'));
         if (proposal.changedKeys.length)
             this.arrangementPreview.set({ source: this.draftFingerprint(), before: page.canvas, canvas: proposal.canvas, keys: proposal.changedKeys });
@@ -13638,6 +13646,7 @@ class DynamicPageConfigEditorComponent {
         this.arrangementSourcePage = this.clone(current);
         this.previousArrangementItems = this.clone(current.canvas.items);
         this.arrangedItems = preview.canvas.items;
+        this.arrangementSelectionSource = this.draftFingerprint();
         this.arrangementGeometry = this.geometryFingerprint(preview.canvas);
         this.arrangementUndoAvailable.set(true);
         this.arrangementPreview.set(null);
@@ -13762,6 +13771,13 @@ class DynamicPageConfigEditorComponent {
         this.themePresetControl.setValue(theme.id); }
     get hasCanvasWidgets() { return !!this.currentPageInput()?.widgets.length; }
     stackDevice(device) {
+        const previous = this.currentPageInput()?.deviceLayouts?.[device]?.canvas || {};
+        if (this.stackViolatesLocks(device, this.stackedCanvas(device, previous))) {
+            this.deviceError.set(this.tx('editor.devices.locked', 'Stacking would change a locked widget. Review its device locks first.'));
+            this.focusEditorTab('devices');
+            return;
+        }
+        this.deviceError.set(null);
         this.hydrating = true;
         this.stackedDevices.add(device);
         this.deviceForms[device].patchValue({ columns: 1, autoRows: 'content' }, { emitEvent: false });
@@ -13776,6 +13792,23 @@ class DynamicPageConfigEditorComponent {
         this.hydrating = false;
         this.refreshPanelState();
     }
+    stackViolatesLocks(device, canvas) {
+        const page = this.currentPageInput();
+        if (!page?.canvas)
+            return false;
+        const overrides = page.deviceLayouts?.[device]?.canvas?.items || {};
+        return Object.entries(canvas.items || {}).some(([key, after]) => {
+            const base = page.canvas.items[key];
+            if (!base)
+                return false;
+            const before = { ...base, ...overrides[key] };
+            after = { ...base, ...after };
+            const locks = { ...base.constraints, ...overrides[key]?.constraints };
+            return !!((locks.lockPosition && (before.col !== after.col || before.row !== after.row))
+                || (locks.lockSize && (before.colSpan !== after.colSpan || before.rowSpan !== after.rowSpan
+                    || JSON.stringify(before.contentSize) !== JSON.stringify(after.contentSize))));
+        });
+    }
     stackedCanvas(device, previous) {
         const page = this.currentPageInput() || { widgets: [] };
         const source = this.completeCanvasItems(page);
@@ -13939,7 +13972,8 @@ class DynamicPageConfigEditorComponent {
     buildCurrentPage(reportErrors) { const next = this.clone(this.currentPageInput() || { widgets: [] }); if (this.canvasColumnsControl.invalid)
         return this.invalidate('canvas', this.canvasError, reportErrors, this.tx('editor.errors.canvasInvalid', 'Invalid canvas')); this.canvasError.set(null); const grouping = this.buildGrouping(reportErrors); if (grouping === null)
         return null; this.groupingError.set(null); const context = this.parseRecordJson(this.contextControl.value, {}); if (context === null)
-        return this.invalidate('context', this.contextError, reportErrors, this.tx('editor.errors.contextInvalid', 'Invalid context')); this.contextError.set(null); const state = this.parseRecordJson(this.stateControl.value, {}); if (state === null)
+        return this.invalidate('context', this.contextError, reportErrors, this.tx('editor.errors.contextInvalid', 'Invalid context')); if (!this.validShellContext(context))
+        return this.invalidate('context', this.contextError, reportErrors, this.tx('editor.errors.contextStructure', 'Context ui and ui.shell must be objects; shell.preset must be text. Correct these fields without removing other context data.')); this.contextError.set(null); const state = this.parseRecordJson(this.stateControl.value, {}); if (state === null)
         return this.invalidate('state', this.stateError, reportErrors, this.tx('editor.errors.stateInvalid', 'Invalid state')); this.stateError.set(null); const deviceLayouts = this.buildDeviceLayouts(reportErrors, next.deviceLayouts); if (deviceLayouts === null)
         return null; next.canvas = this.buildCanvas(next); if (next.canvas && this.arrangedItems)
         next.canvas = { ...next.canvas, items: this.clone(this.arrangedItems) }; next.layout = withPagePaddingInline(next.layout, this.paddingInlineControl.value); next.layoutPreset = this.layoutPresetControl.value.trim() || undefined; next.themePreset = this.themePresetControl.value.trim() || undefined; next.grouping = grouping.length ? grouping : undefined; next.deviceLayouts = Object.keys(deviceLayouts).length ? deviceLayouts : undefined; next.context = this.buildPageContext(next.context, context); next.state = Object.keys(state).length ? state : undefined; return this.applyCanvasLimits(next, reportErrors); }
@@ -14032,6 +14066,8 @@ class DynamicPageConfigEditorComponent {
         delete baseVariant.groupingOverrides;
         delete baseVariant.widgetOverrides;
         const canvas = this.stackedDevices.has(device) ? this.stackedCanvas(device, baseCanvas) : { ...baseCanvas };
+        if (this.stackedDevices.has(device) && this.stackViolatesLocks(device, canvas))
+            return this.invalidate('devices', this.deviceError, reportErrors, this.tx('editor.devices.locked', 'Stacking would change a locked widget. Review its device locks first.'));
         if (form.controls.columns.value != null)
             canvas.columns = form.controls.columns.value;
         else
@@ -14062,7 +14098,7 @@ class DynamicPageConfigEditorComponent {
         const current = this.buildCurrentPage(false);
         this.isValid$.next(!!current);
         const fingerprint = this.draftFingerprint();
-        if (this.arrangementPreview() && this.arrangementPreview().source !== fingerprint) {
+        if (this.arrangementSelection() && this.arrangementSelectionSource !== fingerprint) {
             this.arrangementPreview.set(null);
             this.arrangementSelection.set('');
             this.focusArrangementFeedback = false;
@@ -14113,13 +14149,22 @@ class DynamicPageConfigEditorComponent {
         return ''; return JSON.stringify(value, null, 2); }
     stringifyGroupingWidgetKeys(seed) { if (!seed || seed.kind === 'tabs')
         return ''; return seed.widgetKeys.join(', '); }
-    extractShellPreset(context) { return context?.ui?.shell?.preset || ''; }
-    removeShellPresetFromContext(context) { const next = this.clone(context || {}); if (next.ui?.shell) {
+    extractShellPreset(context) { const preset = context?.ui?.shell?.preset; return typeof preset === 'string' ? preset : ''; }
+    removeShellPresetFromContext(context) { const next = this.clone(context || {}); if (this.isPlainObject(next.ui) && this.isPlainObject(next.ui.shell) && typeof next.ui.shell.preset === 'string') {
         delete next.ui.shell.preset;
         if (!Object.keys(next.ui.shell).length)
             delete next.ui.shell;
-    } if (next.ui && !Object.keys(next.ui).length)
+    } if (this.isPlainObject(next.ui) && !Object.keys(next.ui).length)
         delete next.ui; return next; }
+    validShellContext(context) {
+        if (context['ui'] === undefined)
+            return true;
+        if (!this.isPlainObject(context['ui']))
+            return false;
+        const shell = context['ui']['shell'];
+        return shell === undefined || (this.isPlainObject(shell)
+            && (shell['preset'] === undefined || typeof shell['preset'] === 'string'));
+    }
     applyShellPresetToContext(context, shellPreset) { const next = this.clone(context || {}); if (shellPreset) {
         next.ui = next.ui || {};
         next.ui.shell = next.ui.shell || {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "9.0.68-rc.2",
+  "version": "9.0.68-rc.3",
   "description": "Page and widget builder utilities for Praxis UI (grid, dynamic widgets, editors).",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -8,9 +8,9 @@
     "@angular/forms": "^21.0.0",
     "@angular/cdk": "^21.0.0",
     "@angular/material": "^21.0.0",
-    "@praxisui/ai": "^9.0.68-rc.2",
-    "@praxisui/core": "^9.0.68-rc.2",
-    "@praxisui/settings-panel": "^9.0.68-rc.2",
+    "@praxisui/ai": "^9.0.68-rc.3",
+    "@praxisui/core": "^9.0.68-rc.3",
+    "@praxisui/settings-panel": "^9.0.68-rc.3",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-page-builder.d.ts

@@ -1128,6 +1128,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private focusArrangementFeedback;
     readonly workspaceTab: WritableSignal<number>;
     readonly arrangementSelection: WritableSignal<string>;
+    private arrangementSelectionSource;
     readonly arrangementChoices: readonly [{
         readonly id: "stack";
         readonly weights: readonly [1];
@@ -1261,6 +1262,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     pinRecommendedThemePreset(): void;
     get hasCanvasWidgets(): boolean;
     stackDevice(device: DeviceKey): void;
+    private stackViolatesLocks;
     private stackedCanvas;
     addGroupingNode(seed?: WidgetPageGroupingDefinition): void;
     removeGroupingNode(index: number): void;
@@ -1312,6 +1314,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private stringifyGroupingWidgetKeys;
     private extractShellPreset;
     private removeShellPresetFromContext;
+    private validShellContext;
     private applyShellPresetToContext;
     private lookupPresetLabel;
     private defaultCanvas;