@praxisui/dynamic-form 9.0.4-rc.43 → 9.0.4-rc.44

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-10T20:23:53.082Z",
+  "generatedAt": "2026-08-11T03:13:34.466Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "9.0.4-rc.43",
+  "packageVersion": "9.0.4-rc.44",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,

package/fesm2022/praxisui-dynamic-form.mjs

@@ -8200,6 +8200,7 @@ function validateDynamicFormAuthoringInput(raw, context) {
     return dedupeDiagnostics(diagnostics);
 }
 function validateNormalizedDynamicFormAuthoringDocument(normalized, diagnostics, context) {
+    diagnoseIncompleteGroupedCommandRows(normalized.config, diagnostics);
     if (context?.server?.schemaHash) {
         const configHash = trimString(normalized.config?.metadata?.serverHash);
         if (!configHash) {
@@ -8210,6 +8211,27 @@ function validateNormalizedDynamicFormAuthoringDocument(normalized, diagnostics,
         }
     }
 }
+function diagnoseIncompleteGroupedCommandRows(config, diagnostics) {
+    if (config.metadata?.generatedLayoutPreset !== 'groupedCommand')
+        return;
+    (config.sections || []).forEach((section, sectionIndex) => {
+        (section.rows || []).forEach((row, rowIndex) => {
+            if (!Array.isArray(row.columns) || row.columns.length < 2)
+                return;
+            const occupiedColumns = row.columns.reduce((total, column) => total + resolveDesktopColumnSpan(column?.span), 0);
+            if (occupiedColumns >= 12)
+                return;
+            diagnostics.push(warnDiagnostic('dynamicForm.config.layout.groupedCommand.row.incomplete', `Grouped command row occupies ${occupiedColumns} of 12 desktop columns. Declare compatible x-ui.width values or intentionally author the row layout to avoid visual misalignment.`, `config.sections[${sectionIndex}].rows[${rowIndex}].columns`));
+        });
+    });
+}
+function resolveDesktopColumnSpan(span) {
+    const value = asRecord(span);
+    const candidates = [value.md, value.lg, value.xl].filter((candidate) => typeof candidate === 'number' && Number.isFinite(candidate));
+    if (!candidates.length)
+        return 12;
+    return Math.max(...candidates.map((candidate) => Math.max(1, Math.min(12, candidate))));
+}
 function toCanonicalDynamicFormConfig(doc, _context) {
     const normalized = normalizeDynamicFormAuthoringDocument(doc);
     const canonical = cloneJson(normalized.config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "9.0.4-rc.43",
+  "version": "9.0.4-rc.44",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -9,13 +9,13 @@
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.4-rc.43",
-    "@praxisui/dynamic-fields": "^9.0.4-rc.43",
-    "@praxisui/metadata-editor": "^9.0.4-rc.43",
-    "@praxisui/rich-content": "^9.0.4-rc.43",
-    "@praxisui/settings-panel": "^9.0.4-rc.43",
-    "@praxisui/visual-builder": "^9.0.4-rc.43",
-    "@praxisui/core": "^9.0.4-rc.43",
+    "@praxisui/ai": "^9.0.4-rc.44",
+    "@praxisui/dynamic-fields": "^9.0.4-rc.44",
+    "@praxisui/metadata-editor": "^9.0.4-rc.44",
+    "@praxisui/rich-content": "^9.0.4-rc.44",
+    "@praxisui/settings-panel": "^9.0.4-rc.44",
+    "@praxisui/visual-builder": "^9.0.4-rc.44",
+    "@praxisui/core": "^9.0.4-rc.44",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

package/src/lib/praxis-dynamic-form.json-api.md

@@ -592,6 +592,8 @@ No ecossistema Praxis, ele funciona tanto como runtime final quanto como superfi
 | `layout` | `FormLayout \| undefined` | `undefined` | Partial | Funciona como override estrutural em parte dos fluxos de layout/editor. |
 | `generatedLayoutPreset` | `'default' \| 'compactPresentation'` | `'default'` | Active | Usado apenas ao criar a configuracao inicial a partir de schema/metadata; nao reprocessa layouts persistidos ou authorados. |
 | `layoutPolicy` | `DynamicFormLayoutPolicy \| null` | `null` | Active | Politica opt-in para materializar layout a partir do schema atual. Use `source: 'schema'` com `persistence: 'transient'` para detalhe/read-only e command forms schema-driven sem persistir `sections` geradas nem reabrir configuracao local salva; politicas de host em `config`, como `helpPresentation`, continuam sendo aplicadas ao layout materializado. Em `mode='view'`, `intent: 'detail'` ou `preset: 'compactPresentation'` ativa apresentacao quando `presentationModeGlobal` nao foi informado; use `[presentationModeGlobal]=false` para controles read-only tradicionais. No preset `compactPresentation`, `x-ui.width` explicito empacota campos em linhas de 12 colunas e tem precedencia sobre `detailSummary.columns` por default; campos sem width permanecem full-width, a menos que `detailSummary.columns`/`responsiveColumns` declare a densidade do resumo. Use `detailSummary.widthPrecedence='summary'` quando a densidade do resumo read-only deve sobrescrever `x-ui.width` apenas nessa surface compacta. No preset `groupedCommand`, `groupedCommand.orphanFieldExpansion` controla linhas com um unico campo: `medium-and-wide` (default) expande spans 6/8, `preserve` mantem o width publicado e `all` tambem expande campos compactos. `groupedCommand.contextFields` identifica campos schema-backed já hidratados pela surface: eles permanecem no `FormGroup` e no payload, mas não renderizam controles redundantes. Use `responsiveColumns`, por exemplo `{ lg: 3, md: 2, sm: 1 }`, para drawers, side sheets e painéis corporativos estreitos sem copiar `FormConfig.sections` locais. `schemaType` e `schemaOperation` sao validados contra `schemaUrl` quando a URL declara esses parametros. |
+
+O authoring emite o warning `dynamicForm.config.layout.groupedCommand.row.incomplete` quando uma linha gerada com dois ou mais campos ocupa menos de 12 colunas no desktop. A correção preferencial é declarar larguras `x-ui.width` compatíveis na fonte canônica do schema; o runtime não redistribui silenciosamente campos compactos porque o espaço pode ser intencional.
 | `backConfig` | `BackConfig \| undefined` | `undefined` | Active | Integra retorno/navegacao no painel de configuracao; `confirmOnDirty` tem precedencia sobre `behavior.confirmOnUnsavedChanges` no cancel. |
 | `hooks` | `FormHooksLayout \| undefined` | `undefined` | Active | Override direto de hooks sobre `config.hooks`. |
 | `customEndpoints` | `EndpointConfig` | `{}` | Active | Override de endpoints no CRUD service interno. |