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

package/README.md

@@ -140,6 +140,12 @@ fieldsets can render multiple read-only fields per row. Fields without an explic
 full-width to preserve existing layouts. Generated compact sections also receive semantic header
 icons derived from their group role, while field icons continue to come from existing schema
 metadata.
+In runtime rendering, compact detail containers are kept visible only when at least one referenced
+field can actually be materialized after metadata visibility, `visible=false`, `hidden=true` and
+field-rule overrides are applied. Boolean detail fields are valid presentation content, including
+`false` values; marker/flag groups should render their boolean values, not collapse them as empty
+strings. If a section has no materialized fields, the runtime hides the section instead of leaving
+an orphan title.
 When a migrated detail surface needs the summary density to win over generic schema widths, set
 `detailSummary.widthPrecedence: "summary"` together with `columns` or `responsiveColumns`. The
 default is `"schema"`, so existing forms keep honoring `x-ui.width` unless the summary policy

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-07T12:05:35.013Z",
+  "generatedAt": "2026-07-07T19:18:40.145Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "9.0.0-beta.42",
+  "packageVersion": "9.0.0-beta.43",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,

package/fesm2022/praxisui-dynamic-form.mjs

@@ -14009,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) {
@@ -14034,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
@@ -14053,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}`;
@@ -14277,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)) {

package/package.json

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

@@ -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

@@ -1149,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;