@praxisui/dynamic-form 9.0.0-beta.30 → 9.0.0-beta.31

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

@@ -101,6 +101,18 @@ export type DynamicFormLayoutPersistence = 'transient' | 'authorable';
 
 export type DynamicFormLayoutDetachBehavior = 'none' | 'explicit';
 
+export interface DynamicFormDetailSummaryPolicy {
+  includeFields?: readonly string[];
+  excludeFields?: readonly string[];
+  includeGroups?: readonly string[];
+  excludeGroups?: readonly string[];
+  includeRoles?: readonly string[];
+  excludeRoles?: readonly string[];
+  maxFields?: number;
+  fieldPriority?: Record<string, number>;
+  groupPriority?: Record<string, number>;
+}
+
 export interface DynamicFormLayoutPolicy {
   source: DynamicFormLayoutSource;
   preset?: DynamicFormSchemaLayoutPreset;
@@ -110,6 +122,7 @@ export interface DynamicFormLayoutPolicy {
   detachBehavior?: DynamicFormLayoutDetachBehavior;
   schemaOperation?: 'detail' | 'create' | 'update' | 'view';
   schemaType?: 'request' | 'response';
+  detailSummary?: DynamicFormDetailSummaryPolicy;
 }
 ```
 
@@ -147,11 +160,40 @@ Expected behavior:
 - 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.
 - 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.
 
 This preset is the platform replacement for local read-only detail sections in migrated screens.
 
 This RFC keeps the existing public `compactPresentation` vocabulary. It does not introduce `compactGroupedDetail` as a second public alias during beta.
 
+Example policy for a master-detail read-only summary:
+
+```ts
+const detailLayoutPolicy: DynamicFormLayoutPolicy = {
+  source: 'schema',
+  intent: 'detail',
+  preset: 'compactPresentation',
+  lifecycle: 'live',
+  persistence: 'transient',
+  schemaType: 'response',
+  detailSummary: {
+    includeGroups: [
+      'Identificacao',
+      'Marcadores',
+      'Aplicabilidade/preenchimento',
+    ],
+    excludeGroups: ['Escopo', 'Quantidades', 'Empresa'],
+    maxFields: 8,
+    fieldPriority: {
+      codigo: 0,
+      mnemonico: 1,
+      ativo: 2,
+    },
+  },
+};
+```
+
 ### `groupedCommand`
 
 Use for create/edit command forms.
@@ -377,7 +419,7 @@ Use `layoutPolicy` only when schema metadata is complete enough to generate the
 
 | Surface | Recommended policy | Schema source | Notes |
 | --- | --- | --- | --- |
-| Read-only detail panel | `source: "schema"`, `intent: "detail"`, `preset: "compactPresentation"`, `persistence: "transient"` | response schema | Use for legacy detail blocks such as identification, rules and markers. |
+| Read-only detail panel | `source: "schema"`, `intent: "detail"`, `preset: "compactPresentation"`, `persistence: "transient"`, optional `detailSummary` | response schema | Use for legacy detail blocks such as identification, rules and markers. |
 | Create/edit drawer or dialog | `source: "schema"`, `intent: "command"`, `preset: "groupedCommand"`, `persistence: "transient"` | request schema | Use only after command DTO metadata and write API gates are ready. |
 | Custom visual composition | `source: "authored"` | authored config | Use for genuinely custom content, embedded child resources or non-field visual blocks. |
 | Transitional migration | authored sections plus schema-owned field metadata | response/request schema | Acceptable while DTO grouping is being corrected; document the temporary debt. |