@praxisui/dynamic-form 9.0.0-beta.41 → 9.0.0-beta.43

package/docs/schema-driven-layout-materialization-rfc.md

@@ -113,6 +113,7 @@ export interface DynamicFormDetailSummaryPolicy {
   groupPriority?: Record<string, number>;
   columns?: number;
   responsiveColumns?: Partial<Record<'xs' | 'sm' | 'md' | 'lg' | 'xl', number>>;
+  widthPrecedence?: 'schema' | 'summary';
 }
 
 export interface DynamicFormLayoutPolicy {
@@ -160,7 +161,9 @@ Expected behavior:
 - Avoid card grids and decorative section containers as the default for operational detail screens.
 - Preserve stable section ids derived from deterministic group keys.
 - In `mode="view"`, activate presentation rendering when the host does not explicitly provide `presentationModeGlobal`; an explicit `false` keeps the same schema in traditional read-only controls.
-- Honor explicit schema `x-ui.width` as 12-column spans so migrated operational detail screens can use dense fieldset rows. Preserve full-width rows when width is absent.
+- Honor explicit schema `x-ui.width` as 12-column spans by default so migrated operational detail screens can use dense fieldset rows. Preserve full-width rows when width is absent.
+- Let `layoutPolicy.detailSummary.widthPrecedence: 'summary'` make `detailSummary.columns`/`responsiveColumns` override explicit `x-ui.width` only for the compact read-only summary surface.
+- Treat `widthPrecedence: 'summary'` as a curated-summary density tool: long narrative, legal, multiline or audit-heavy values should stay schema-width owned or be moved out of the compact summary through include/exclude policies.
 - Derive compact section header icons from semantic group roles (`identity`, `rules`, `markers`) while keeping field-level icons owned by existing schema metadata.
 - Allow `layoutPolicy.detailSummary` to select/exclude fields and groups, cap the first compact panel with `maxFields`, and sort with field/group priority when the schema publishes summary/detail roles or priorities.
 - Keep excluded summary fields out of generated rows and mark them hidden in generated field metadata for that transient compact surface, without mutating backend schema semantics.
@@ -192,6 +195,9 @@ const detailLayoutPolicy: DynamicFormLayoutPolicy = {
       mnemonico: 1,
       ativo: 2,
     },
+    columns: 3,
+    responsiveColumns: { xs: 1, sm: 1, md: 2, lg: 3, xl: 3 },
+    widthPrecedence: 'summary',
   },
 };
 ```

package/fesm2022/praxisui-dynamic-form.mjs

@@ -5952,7 +5952,7 @@ const PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST = {
         { name: 'readUrl', type: 'string', description: 'Endpoint canonico de leitura para surfaces VIEW/READ_PROJECTION' },
         { name: 'mode', type: 'string', allowedValues: ['create', 'edit', 'view'], description: 'Modo de operação' },
         { name: 'generatedLayoutPreset', type: 'string', allowedValues: ['default', 'compactPresentation'], description: 'Preset usado apenas ao gerar a configuracao inicial a partir de metadata/schema; nao reprocessa layouts persistidos ou autorados.' },
-        { name: 'layoutPolicy', type: 'DynamicFormLayoutPolicy', description: 'Politica opt-in para layout schema-driven transient. Use source=schema apenas quando o backend schema for a fonte canonica do agrupamento; use detailSummary para seleção de campos e densidade responsiva do resumo read-only compacto sem FormConfig.sections locais.' },
+        { name: 'layoutPolicy', type: 'DynamicFormLayoutPolicy', description: 'Politica opt-in para layout schema-driven transient. Use source=schema apenas quando o backend schema for a fonte canonica do agrupamento; use detailSummary para seleção de campos e densidade responsiva do resumo read-only compacto sem FormConfig.sections locais. Quando o resumo precisar vencer x-ui.width publicado para outras surfaces, use detailSummary.widthPrecedence=summary.' },
         { name: 'fieldIconPolicy', type: 'string', allowedValues: ['all', 'presentation-only', 'none'], description: 'Politica visual do host para icones prefix/suffix de campos vindos da metadata. Use presentation-only para manter icones decorativos em apresentacao e ocultar em controles tradicionais.' },
         { name: 'enableCustomization', type: 'boolean', description: 'Habilita edição visual' }
     ],
@@ -12207,11 +12207,19 @@ class PraxisDynamicForm {
             }
             return;
         }
+        const configuredReadUrl = String(this.readUrl || '').trim();
+        if (!configuredReadUrl && !String(this.resourcePath || '').trim()) {
+            if (this.hydrateEntityFromInitialValue()) {
+                return;
+            }
+            this.entityHydrationPending = false;
+            this.warnLog('Skipping entity load because no readUrl or resourcePath is configured.', { id: this.pendingEntityId, formId: this.formId }, { actionId: 'entity.load.skip', throttleKey: 'praxis-dynamic-form:entity-load-without-resource' });
+            return;
+        }
         this.loadedEntityId = this.pendingEntityId;
         this.entityHydrationPending = true;
         const httpContext = new HttpContext().set(PRAXIS_LOADING_CTX, this.buildLoadingContext('data', 'Carregando dados...', false));
         this.emitLoadingState('data', 'loading', 'Carregando dados do formulário...');
-        const configuredReadUrl = String(this.readUrl || '').trim();
         const request$ = configuredReadUrl
             ? this.http
                 .get(this.resolveReadHref(configuredReadUrl), {
@@ -12248,6 +12256,22 @@ class PraxisDynamicForm {
             },
         });
     }
+    hydrateEntityFromInitialValue() {
+        const normalized = this.getNormalizedInitialValue();
+        if (!normalized) {
+            return false;
+        }
+        this.loadedEntityId = this.pendingEntityId;
+        this.loadedEntityData = normalized;
+        this.entityHydrationPending = false;
+        if (Object.keys(this.form.controls || {}).length) {
+            this.form.patchValue(normalized, { emitEvent: false });
+        }
+        this.hydratedEntityId = this.pendingEntityId;
+        this.debugLog('[PDF] loadEntity:initialValue', { id: this.pendingEntityId });
+        this.emitLoadingState('data', 'success', 'Dados carregados.');
+        return true;
+    }
     buildFormFromConfig(options = { reason: 'initialization' }) {
         this.runtimeFieldMetadata = null;
         const fieldMetadata = this.getRuntimeFieldMetadata();
@@ -13985,9 +14009,9 @@ class PraxisDynamicForm {
         const byName = new Map(fieldMetadata.map((f) => [f.name, f]));
         const ordered = [];
         for (const name of fieldNames) {
-            if (this.fieldVisibility[name] === false)
-                continue;
             const meta = byName.get(name);
+            if (!this.isFieldRenderableInLayout(name, meta))
+                continue;
             if (meta) {
                 const overrides = this.fieldRuleProps[name] || {};
                 if (Object.keys(overrides).length > 0) {
@@ -14010,6 +14034,18 @@ class PraxisDynamicForm {
         this.columnFieldsCache.set(key, { signature, value: ordered });
         return ordered;
     }
+    isFieldRenderableInLayout(fieldName, field) {
+        const meta = field ??
+            this.getRuntimeFieldMetadata().find((candidate) => candidate.name === fieldName) ??
+            null;
+        if (!meta) {
+            return false;
+        }
+        if (this.fieldVisibility[fieldName] !== undefined) {
+            return this.fieldVisibility[fieldName] === true;
+        }
+        return this.resolveFieldVisibility(meta, this.fieldRuleProps[fieldName] || null);
+    }
     getRichContentLayoutItemDocument(item) {
         return item.kind === 'richContent' && item.document?.kind === 'praxis.rich-content'
             ? item.document
@@ -14029,9 +14065,14 @@ class PraxisDynamicForm {
         return this.resolveRuleVisibility(this.getVisualBlockRuleProps(item.id), true);
     }
     getColumnFieldsSignature(column) {
+        const fieldMetadata = this.getRuntimeFieldMetadata();
+        const byName = new Map(fieldMetadata.map((field) => [field.name, field]));
         return getFormColumnFieldNames(column)
             .map((name) => {
-            const visible = this.fieldVisibility[name] === false ? '0' : '1';
+            const meta = byName.get(name);
+            const visible = this.fieldVisibility[name] !== undefined
+                ? this.fieldVisibility[name] === false ? '0' : '1'
+                : this.resolveFieldVisibility(meta ?? null, this.fieldRuleProps[name] || null) ? '1' : '0';
             const overrides = this.fieldRuleProps[name];
             const overrideState = overrides && Object.keys(overrides).length > 0 ? '1' : '0';
             return `${name}:${visible}:${overrideState}`;
@@ -14253,8 +14294,10 @@ class PraxisDynamicForm {
         if (items.some((item) => item.kind === 'richContent' && this.isRichContentLayoutItemVisible(item))) {
             return true;
         }
-        // A column is visible if at least one of its fields is visible.
-        return getFormLayoutFieldNames(items).some((fieldName) => this.fieldVisibility[fieldName]);
+        // Explicit runtime visibility wins; otherwise resolve metadata/rule visibility directly.
+        return getFormLayoutFieldNames(items).some((fieldName) => {
+            return this.isFieldRenderableInLayout(fieldName);
+        });
     }
     isResponsiveHiddenActive(hidden) {
         if (!hidden || typeof hidden !== 'object' || Array.isArray(hidden)) {
@@ -34611,6 +34654,7 @@ const ENUMS = {
     layoutPolicyIntent: ['detail', 'command'],
     layoutPolicyLifecycle: ['initial', 'live'],
     layoutPolicyPersistence: ['transient', 'authorable'],
+    layoutPolicyWidthPrecedence: ['schema', 'summary'],
     fieldIconPolicy: ['all', 'presentation-only', 'none'],
     notifyIfOutdated: ['inline', 'snackbar', 'both', 'none'],
     labelPosition: ['above', 'left'],
@@ -34875,6 +34919,14 @@ const FORM_COMPONENT_AI_CAPABILITIES = {
             description: 'Mapa de colunas por breakpoint xs/sm/md/lg/xl para detalhes read-only compactos em drawers, side sheets e desktop largo.',
             safetyNotes: 'Prefira valores simples como { lg: 3, md: 2, sm: 1 }; nao copie layout manual para sections.',
         },
+        {
+            path: 'inputs.layoutPolicy.detailSummary.widthPrecedence',
+            category: 'inputs',
+            valueKind: 'enum',
+            allowedValues: ENUMS.layoutPolicyWidthPrecedence,
+            description: 'Define se larguras explicitas do schema ou a densidade do resumo controlam os spans no compactPresentation read-only.',
+            safetyNotes: 'Default schema preserva x-ui.width; use summary apenas quando columns/responsiveColumns devem vencer larguras genericas do schema nessa surface.',
+        },
         {
             path: 'inputs.fieldIconPolicy',
             category: 'inputs',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "9.0.0-beta.41",
+  "version": "9.0.0-beta.43",
   "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.0-beta.41",
-    "@praxisui/dynamic-fields": "^9.0.0-beta.41",
-    "@praxisui/metadata-editor": "^9.0.0-beta.41",
-    "@praxisui/rich-content": "^9.0.0-beta.41",
-    "@praxisui/settings-panel": "^9.0.0-beta.41",
-    "@praxisui/visual-builder": "^9.0.0-beta.41",
-    "@praxisui/core": "^9.0.0-beta.41",
+    "@praxisui/ai": "^9.0.0-beta.43",
+    "@praxisui/dynamic-fields": "^9.0.0-beta.43",
+    "@praxisui/metadata-editor": "^9.0.0-beta.43",
+    "@praxisui/rich-content": "^9.0.0-beta.43",
+    "@praxisui/settings-panel": "^9.0.0-beta.43",
+    "@praxisui/visual-builder": "^9.0.0-beta.43",
+    "@praxisui/core": "^9.0.0-beta.43",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

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

@@ -578,7 +578,7 @@ No ecossistema Praxis, ele funciona tanto como runtime final quanto como superfi
 | `componentInstanceId` | `string \| undefined` | `undefined` | Active | Isola instancias com mesmo `formId`. |
 | `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`; campos sem width permanecem full-width, a menos que `detailSummary.columns`/`responsiveColumns` declare a densidade do resumo. 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. |
+| `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. 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. |
 | `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. |
@@ -594,6 +594,12 @@ No ecossistema Praxis, ele funciona tanto como runtime final quanto como superfi
 | `fieldIconPolicy` | `'all' \| 'presentation-only' \| 'none'` | `'all'` | Active | Controla icones `prefixIcon`/`suffixIcon` vindos da metadata dos campos. `all` preserva o comportamento atual; `presentation-only` mantem icones decorativos no modo apresentacao e oculta os slots de icone em controles input/read-only tradicionais; `none` oculta esses slots em todos os modos. |
 | `visibleGlobal` | `boolean \| null` | `null` | Active | Visibilidade global propagada para loader. |
 
+In `compactPresentation` runtime detail surfaces, rows, columns and sections are visible only when
+they contain at least one field that can be materialized after metadata visibility and field-rule
+overrides are resolved. Boolean values, including `false`, are valid presentation values and must
+not be treated as empty detail content. If no field in a section is materialized, the section is
+hidden instead of rendering an orphan title.
+
 #### Migration baseline for ErgonX-style screens
 
 For enterprise migrations that must become templates for many screens, `layoutPolicy`,

package/types/praxisui-dynamic-form.d.ts

@@ -1017,6 +1017,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private hostConfigHasAuthoredLocalFieldsNotInLocalConfig;
     private syncWithServer;
     private loadEntity;
+    private hydrateEntityFromInitialValue;
     private buildFormFromConfig;
     private resetFormValueChangesSubscription;
     private resetDependencyPolicySubscription;
@@ -1148,6 +1149,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
         items?: FormLayoutItem[];
         id?: string;
     }): FieldMetadata[];
+    private isFieldRenderableInLayout;
     getRichContentLayoutItemDocument(item: FormLayoutItem): RichContentDocument | null;
     getRichContentLayoutItemLayout(item: FormLayoutItem): 'block' | 'inline';
     private getVisualBlockRuleProps;