@asteby/metacore-runtime-react 28.4.1 → 28.6.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @asteby/metacore-runtime-react
 
+## 28.6.0
+
+### Minor Changes
+
+- 21c5268: Soporta `visible_when` a nivel de SECCIÓN en `form_layout` (kernel v0.84.0). Cuando una sección declara un predicado `visible_when` que evalúa falso contra los valores actuales del formulario, la sección se oculta por completo junto con sus campos; en modo wizard (steps) ese paso desaparece de la secuencia de navegación sin romper Anterior/Siguiente ni el submit del último paso. Reutiliza el mismo evaluador (`getVisibleWhen`/`evaluateVisibleWhen`) que ya usan los campos, tolerando snake_case y camelCase. El `visible_when` de cada campo se sigue respetando dentro de una sección visible, y sin `visible_when` de sección el comportamiento es idéntico al actual.
+
+## 28.5.0
+
+### Minor Changes
+
+- 47f6543: Los renderers de formulario (`DynamicForm` y `DynamicRecordDialog`) ahora consumen el primitivo `form_layout` del modelo (kernel PR #230): agrupan los campos por su `section` respetando el orden de `sections`. En `mode: "sections"` cada grupo se dibuja como una sección con `title`/`description` y soporte de `collapsed` (colapsable); en `mode: "steps"` se dibuja un wizard multi-paso con navegación Anterior/Siguiente y submit en el último paso. Los campos sin `section` (o con sección desconocida) caen en un grupo por defecto al inicio, y una sección sin campos visibles se oculta. Sin `form_layout` el comportamiento (lista plana) queda idéntico; `visible_when`, el gate de required y el strip de ocultos en el submit se respetan.
+
+### Patch Changes
+
+- b05aded: DynamicRecordDialog ya no envía en el submit los campos ocultos por `visible_when`, en paridad con DynamicForm.
+
 ## 28.4.1
 
 ### Patch Changes

package/dist/dialogs/dynamic-record.d.ts

@@ -83,6 +83,12 @@ export interface FieldDef {
     visible_when?: VisibleWhen;
     /** camelCase alias for `visible_when`. */
     visibleWhen?: VisibleWhen;
+    /**
+     * Form-layout membership: the key of the `form_layout` section this field
+     * belongs to (kernel PR #230). Absent → the default group. See
+     * `groupFieldsBySection`.
+     */
+    section?: string;
 }
 export interface DynamicRecordDialogProps {
     open: boolean;
@@ -178,6 +184,7 @@ export declare function isLineItemsField(field: FieldDef, value: any): boolean;
 export declare function fkSeedOption(field: FieldDef, value: any, record: any): ResolvedOption | null;
 export declare function isMoneyField(field: FieldDef, value: any): boolean;
 export declare function filterVisibleFields(fields: FieldDef[] | undefined, mode: 'view' | 'edit' | 'create', formValues?: Record<string, any>): FieldDef[];
+export declare function stripHiddenFieldValues(values: Record<string, any>, fields: FieldDef[] | undefined, mode: 'view' | 'edit' | 'create'): Record<string, any>;
 export declare function DynamicRecordDialog({ open, onOpenChange, mode, model, recordId, endpoint, onSaved, onCreate, onUpdate, defaults, schema, onDelete, onEdit, onOpenFullPage, initialRecord, getImageUrl, timeZone, currency, onChange, }: DynamicRecordDialogProps): import("react").JSX.Element;
 export declare function ReadonlyEditField({ field, value }: {
     field: FieldDef;

package/dist/dialogs/dynamic-record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-record.d.ts","sourceRoot":"","sources":["../../src/dialogs/dynamic-record.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"dynamic-record.d.ts","sourceRoot":"","sources":["../../src/dialogs/dynamic-record.tsx"],"names":[],"mappings":"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"}

package/dist/dialogs/dynamic-record.js

@@ -24,6 +24,8 @@ import { DynamicSelectField, OptionLead, OptionThumb } from '../dynamic-select-f
 import { DynamicRelations } from '../dynamic-relations';
 import { useOptionsResolver } from '../use-options-resolver';
 import { getFieldRef, getVisibleWhen, evaluateVisibleWhen } from '../dynamic-form-schema';
+import { groupFieldsBySection } from '../form-layout';
+import { FieldSection, WizardProgress } from '../form-layout-ui';
 import { FieldCell } from '../field-grid';
 import { isNilUuid, normalizeNilUuid } from '../nil-uuid';
 import { normalizeRefFieldsForSubmit } from './normalize-submit';
@@ -257,6 +259,25 @@ export function filterVisibleFields(fields, mode, formValues) {
         return true;
     });
 }
+// stripHiddenFieldValues drops from a flat form-values object the keys of any
+// declared field currently hidden by its `visible_when` predicate, so the
+// submit never POSTs a value the form isn't showing (e.g. a DiscountRule with
+// rule_scope=category must not send the product_id / customer_id it hides).
+// This mirrors dynamic-form.tsx, which builds its Zod schema only over the
+// visible fields — hidden fields are dropped from BOTH the render/required-gate
+// AND the submitted values. Keys with no matching declared field, or whose
+// field carries no `visible_when`, always pass through (retrocompat).
+export function stripHiddenFieldValues(values, fields, mode) {
+    const visibleKeys = new Set(filterVisibleFields(fields, mode, values).map(f => f.key));
+    const out = {};
+    for (const [key, value] of Object.entries(values)) {
+        const field = (fields ?? []).find(f => f.key === key);
+        if (field && !visibleKeys.has(key) && getVisibleWhen(field))
+            continue;
+        out[key] = value;
+    }
+    return out;
+}
 export function DynamicRecordDialog({ open, onOpenChange, mode, model, recordId, endpoint, onSaved, onCreate, onUpdate, defaults, schema, onDelete, onEdit, onOpenFullPage, initialRecord, getImageUrl = identityImageUrl, timeZone, currency, onChange, }) {
     const api = useApi();
     const { t } = useTranslation();
@@ -271,6 +292,8 @@ export function DynamicRecordDialog({ open, onOpenChange, mode, model, recordId,
     const [loading, setLoading] = useState(false);
     const [saving, setSaving] = useState(false);
     const [deleting, setDeleting] = useState(false);
+    // Wizard step cursor (form_layout mode:"steps" only).
+    const [stepIndex, setStepIndex] = useState(0);
     const isCreate = mode === 'create';
     const isView = mode === 'view';
     const isEditable = mode === 'create' || mode === 'edit';
@@ -281,8 +304,10 @@ export function DynamicRecordDialog({ open, onOpenChange, mode, model, recordId,
             return;
         if (!isCreate && !recordId)
             return;
-        // Fresh open → drop any validation errors from a prior submit.
+        // Fresh open → drop any validation errors from a prior submit and reset
+        // the wizard to its first step.
         setFieldErrors({});
+        setStepIndex(0);
         let cancelled = false;
         // Seed instantly from the row the table already has so view/edit render
         // without a spinner. The list row carries the pro siblings (resolved
@@ -489,9 +514,15 @@ export function DynamicRecordDialog({ open, onOpenChange, mode, model, recordId,
         }
         // Required check passed → clear any prior validation errors.
         setFieldErrors({});
+        // Fields hidden by their `visible_when` predicate must not be POSTed:
+        // the render, the required-gate and the payload all drive off the same
+        // filter, so a DiscountRule with scope=category never submits the
+        // product_id / customer_id it isn't showing. Mirrors dynamic-form.tsx,
+        // which builds its Zod only over visibleFields.
+        const submittedValues = stripHiddenFieldValues(formValues, modalMeta.fields, mode);
         // Empty reference pickers → null (not "" / nil-UUID) so nullable FK
         // columns accept them instead of raising a 23503 FK violation.
-        const payload = normalizeRefFieldsForSubmit(formValues, modalMeta.fields);
+        const payload = normalizeRefFieldsForSubmit(submittedValues, modalMeta.fields);
         setSaving(true);
         try {
             if (isCreate && onCreate) {
@@ -563,22 +594,51 @@ export function DynamicRecordDialog({ open, onOpenChange, mode, model, recordId,
     };
     const title = modalMeta ? config.getTitle(modalMeta, t) : '';
     const visibleFields = filterVisibleFields(modalMeta?.fields, mode, formValues);
-    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { className: "sm:max-w-2xl max-h-[90vh] flex flex-col p-0 gap-0 overflow-hidden", children: [_jsxs(DialogHeader, { className: "p-6 pb-4 border-b shrink-0", children: [_jsx(DialogTitle, { children: title }), _jsx(DialogDescription, { children: config.description })] }), _jsx("div", { className: "flex-1 overflow-y-auto p-6", children: loading ? (_jsx(LoadingSkeleton, {})) : modalMeta ? (_jsx(ModelContext.Provider, { value: model, children: _jsx(ImageUrlContext.Provider, { value: getImageUrl, children: _jsx(TimeZoneContext.Provider, { value: timeZone, children: _jsxs(CurrencyContext.Provider, { value: currency, children: [_jsxs("form", { id: "dynamic-record-form", onSubmit: handleSubmit, className: "grid grid-cols-1 gap-x-6 gap-y-4 sm:grid-cols-2", children: [visibleFields.map(field => {
-                                                    const isFullWidth = field.type === 'textarea' ||
-                                                        field.widget === 'textarea' ||
-                                                        field.widget === 'richtext';
-                                                    return (_jsx(FieldCell, { fullWidth: isFullWidth, children: _jsx(FieldRow, { field: field, record: record, value: formValues[field.key] ?? '', mode: mode, error: fieldErrors[field.key], onChange: val => {
-                                                                setFormValues((prev) => ({ ...prev, [field.key]: val }));
-                                                                // Clear this field's error as soon as the user edits it.
-                                                                setFieldErrors(prev => {
-                                                                    if (!prev[field.key])
-                                                                        return prev;
-                                                                    const next = { ...prev };
-                                                                    delete next[field.key];
-                                                                    return next;
-                                                                });
-                                                            } }) }, field.key));
-                                                }), record?.external_url && (_jsx("div", { className: "sm:col-span-2 min-w-0", children: _jsxs("a", { href: record.external_url, target: "_blank", rel: "noreferrer", className: "inline-flex items-center gap-1.5 text-sm text-primary hover:underline mt-1", children: [_jsx(ExternalLink, { className: "h-3.5 w-3.5" }), "Ver en ", record.external_provider ?? 'proveedor externo'] }) }))] }), !isCreate && record && relations.length > 0 && (_jsx("div", { className: "mt-6", children: _jsx(DynamicRelations, { record: record, relations: relations, lineSubtable: true, canCreate: mode === 'edit', canEdit: mode === 'edit', canDelete: mode === 'edit', onChange: handleChildChange }) }))] }) }) }) })) : null }), _jsxs(DialogFooter, { className: "p-4 border-t shrink-0 sm:justify-between", children: [isView && onOpenFullPage ? (_jsxs(Button, { variant: "ghost", size: "sm", className: "text-muted-foreground", onClick: () => { onOpenChange(false); onOpenFullPage(); }, children: [_jsx(ExternalLink, { className: "mr-1.5 h-3.5 w-3.5" }), "Ver p\u00E1gina completa"] })) : _jsx("span", {}), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Button, { variant: "outline", onClick: () => onOpenChange(false), disabled: saving || deleting, children: config.cancelLabel }), isView && onDelete && (_jsxs(Button, { variant: "destructive", onClick: handleDelete, disabled: deleting || loading, children: [deleting && _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }), deleting ? 'Eliminando...' : 'Eliminar'] })), isView && onEdit && (_jsx(Button, { onClick: onEdit, disabled: deleting || loading, children: "Editar" })), isEditable && (_jsxs(Button, { type: "submit", form: "dynamic-record-form", disabled: saving || loading, children: [saving && _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }), saving ? config.submittingLabel : config.submitLabel] }))] })] })] }) }));
+    // Declarative form layout: group the (already visibility-filtered) fields by
+    // their section. Empty sections drop out for free. Steps mode only drives a
+    // wizard in editable modes — view mode always stacks the sections.
+    const formLayout = modalMeta?.form_layout ?? modalMeta?.formLayout;
+    const groups = groupFieldsBySection(visibleFields, formLayout, formValues);
+    const isSteps = isEditable && formLayout?.mode === 'steps' && groups.length > 1;
+    const clampedStep = Math.min(stepIndex, Math.max(groups.length - 1, 0));
+    const isLastStep = clampedStep === groups.length - 1;
+    // Renders a list of fields into the shared two-column grid (each FieldCell
+    // gives min-w-0 so long values can't blow the columns past the dialog).
+    const renderFields = (groupFields) => groupFields.map(field => {
+        const isFullWidth = field.type === 'textarea' ||
+            field.widget === 'textarea' ||
+            field.widget === 'richtext';
+        return (_jsx(FieldCell, { fullWidth: isFullWidth, children: _jsx(FieldRow, { field: field, record: record, value: formValues[field.key] ?? '', mode: mode, error: fieldErrors[field.key], onChange: val => {
+                    setFormValues((prev) => ({ ...prev, [field.key]: val }));
+                    setFieldErrors(prev => {
+                        if (!prev[field.key])
+                            return prev;
+                        const next = { ...prev };
+                        delete next[field.key];
+                        return next;
+                    });
+                } }) }, field.key));
+    });
+    // Wizard "Siguiente": gate only the CURRENT step's required (visible) fields,
+    // then advance. Mirrors handleSubmit's required check but scoped to the step.
+    const goNextStep = () => {
+        const step = groups[clampedStep];
+        const missing = {};
+        for (const field of step?.fields ?? []) {
+            if (field.required && !formValues[field.key] && formValues[field.key] !== 0 && formValues[field.key] !== false) {
+                missing[field.key] = localizeFieldIssue({ code: 'required' }, field.label, t);
+            }
+        }
+        if (Object.keys(missing).length) {
+            setFieldErrors(missing);
+            toast.error(t('dynamic.validation_failed', { defaultValue: 'Revisa los campos marcados' }));
+            return;
+        }
+        setFieldErrors({});
+        setStepIndex(Math.min(clampedStep + 1, groups.length - 1));
+    };
+    const goBackStep = () => setStepIndex(Math.max(clampedStep - 1, 0));
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { className: "sm:max-w-2xl max-h-[90vh] flex flex-col p-0 gap-0 overflow-hidden", children: [_jsxs(DialogHeader, { className: "p-6 pb-4 border-b shrink-0", children: [_jsx(DialogTitle, { children: title }), _jsx(DialogDescription, { children: config.description })] }), _jsx("div", { className: "flex-1 overflow-y-auto p-6", children: loading ? (_jsx(LoadingSkeleton, {})) : modalMeta ? (_jsx(ModelContext.Provider, { value: model, children: _jsx(ImageUrlContext.Provider, { value: getImageUrl, children: _jsx(TimeZoneContext.Provider, { value: timeZone, children: _jsxs(CurrencyContext.Provider, { value: currency, children: [_jsxs("form", { id: "dynamic-record-form", onSubmit: handleSubmit, className: "grid gap-y-4", children: [isSteps && (_jsx(WizardProgress, { groups: groups, stepIndex: clampedStep })), (isSteps ? [groups[clampedStep]] : groups).map(group => (_jsx(FieldSection, { group: group, children: _jsx("div", { className: "grid grid-cols-1 gap-x-6 gap-y-4 sm:grid-cols-2", children: renderFields(group.fields) }) }, group.key))), record?.external_url && (_jsx("div", { className: "grid grid-cols-1 sm:grid-cols-2", children: _jsx("div", { className: "sm:col-span-2 min-w-0", children: _jsxs("a", { href: record.external_url, target: "_blank", rel: "noreferrer", className: "inline-flex items-center gap-1.5 text-sm text-primary hover:underline mt-1", children: [_jsx(ExternalLink, { className: "h-3.5 w-3.5" }), "Ver en ", record.external_provider ?? 'proveedor externo'] }) }) }))] }), !isCreate && record && relations.length > 0 && (_jsx("div", { className: "mt-6", children: _jsx(DynamicRelations, { record: record, relations: relations, lineSubtable: true, canCreate: mode === 'edit', canEdit: mode === 'edit', canDelete: mode === 'edit', onChange: handleChildChange }) }))] }) }) }) })) : null }), _jsxs(DialogFooter, { className: "p-4 border-t shrink-0 sm:justify-between", children: [isView && onOpenFullPage ? (_jsxs(Button, { variant: "ghost", size: "sm", className: "text-muted-foreground", onClick: () => { onOpenChange(false); onOpenFullPage(); }, children: [_jsx(ExternalLink, { className: "mr-1.5 h-3.5 w-3.5" }), "Ver p\u00E1gina completa"] })) : _jsx("span", {}), _jsxs("div", { className: "flex items-center gap-2", children: [isSteps && clampedStep > 0 ? (_jsx(Button, { variant: "outline", onClick: goBackStep, disabled: saving || deleting, children: "Anterior" })) : (_jsx(Button, { variant: "outline", onClick: () => onOpenChange(false), disabled: saving || deleting, children: config.cancelLabel })), isView && onDelete && (_jsxs(Button, { variant: "destructive", onClick: handleDelete, disabled: deleting || loading, children: [deleting && _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }), deleting ? 'Eliminando...' : 'Eliminar'] })), isView && onEdit && (_jsx(Button, { onClick: onEdit, disabled: deleting || loading, children: "Editar" })), isEditable && isSteps && !isLastStep && (_jsx(Button, { type: "button", onClick: goNextStep, disabled: saving || loading, children: "Siguiente" })), isEditable && (!isSteps || isLastStep) && (_jsxs(Button, { type: "submit", form: "dynamic-record-form", disabled: saving || loading, children: [saving && _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }), saving ? config.submittingLabel : config.submitLabel] }))] })] })] }) }));
 }
 function LoadingSkeleton() {
     return (_jsx("div", { className: "grid grid-cols-1 sm:grid-cols-2 gap-x-6 gap-y-4", children: Array.from({ length: 6 }).map((_, i) => (_jsxs("div", { className: "flex flex-col gap-1.5", children: [_jsx(Skeleton, { className: "h-3.5 w-24" }), _jsx(Skeleton, { className: "h-9 w-full" })] }, i))) }));

package/dist/dynamic-form.d.ts

@@ -1,3 +1,4 @@
+import { type FormLayout } from './form-layout';
 import type { ActionFieldDef } from './types';
 import { buildZodSchema, resolveWidget } from './dynamic-form-schema';
 export { buildZodSchema, resolveWidget };
@@ -14,6 +15,14 @@ export interface DynamicFormProps {
     submitLabel?: string;
     cancelLabel?: string;
     disabled?: boolean;
+    /**
+     * Declarative form layout served on the model metadata (kernel PR #230).
+     * When present the visible fields are grouped by their `section` respecting
+     * `sections` order: `mode:"sections"` stacks (optionally collapsible)
+     * sections; `mode:"steps"` renders a Anterior/Siguiente wizard. Absent → the
+     * legacy flat list (unchanged).
+     */
+    formLayout?: FormLayout;
 }
-export declare function DynamicForm({ fields, initialValues, onSubmit, onCancel, submitLabel, cancelLabel, disabled, }: DynamicFormProps): import("react").JSX.Element;
+export declare function DynamicForm({ fields, initialValues, onSubmit, onCancel, submitLabel, cancelLabel, disabled, formLayout, }: DynamicFormProps): import("react").JSX.Element;
 //# sourceMappingURL=dynamic-form.d.ts.map

package/dist/dynamic-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-form.d.ts","sourceRoot":"","sources":["../src/dynamic-form.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EACH,cAAc,EACd,aAAa,EAOhB,MAAM,uBAAuB,CAAA;AAQ9B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,WAAW,CAAC,EACxB,MAAM,EACN,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,WAAuB,EACvB,WAAwB,EACxB,QAAgB,GACnB,EAAE,gBAAgB,+BAyGlB"}
+{"version":3,"file":"dynamic-form.d.ts","sourceRoot":"","sources":["../src/dynamic-form.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAwB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAA;AAcrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EACH,cAAc,EACd,aAAa,EAOhB,MAAM,uBAAuB,CAAA;AAQ9B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,UAAU,CAAA;CAC1B;AAED,wBAAgB,WAAW,CAAC,EACxB,MAAM,EACN,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,WAAuB,EACvB,WAAwB,EACxB,QAAgB,EAChB,UAAU,GACb,EAAE,gBAAgB,+BA8LlB"}

package/dist/dynamic-form.js

@@ -3,6 +3,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // pattern + ActionFieldDef renderer so callers can reuse the form layout
 // outside the full record-edit modal.
 import { useEffect, useMemo, useState } from 'react';
+import { groupFieldsBySection } from './form-layout';
+import { FieldSection, WizardProgress } from './form-layout-ui';
 import { Input, Textarea, Label, Switch, Button, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from '@asteby/metacore-ui/primitives';
 import { buildZodSchema, resolveWidget, isLineItemsField, evaluateBalance, applyOptionWhen, getDependsOn, getVisibleWhen, evaluateVisibleWhen, } from './dynamic-form-schema';
 import { useOptionsResolver } from './use-options-resolver';
@@ -17,7 +19,7 @@ export { DynamicSelectField } from './dynamic-select-field';
 export { DynamicDateField } from './dynamic-date-field';
 export { UploadField } from './upload-field';
 export { IconPickerField } from './icon-picker-field';
-export function DynamicForm({ fields, initialValues, onSubmit, onCancel, submitLabel = 'Guardar', cancelLabel = 'Cancelar', disabled = false, }) {
+export function DynamicForm({ fields, initialValues, onSubmit, onCancel, submitLabel = 'Guardar', cancelLabel = 'Cancelar', disabled = false, formLayout, }) {
     const [values, setValues] = useState({});
     const [errors, setErrors] = useState({});
     const [submitting, setSubmitting] = useState(false);
@@ -47,6 +49,18 @@ export function DynamicForm({ fields, initialValues, onSubmit, onCancel, submitL
         }
         return false;
     }, [visibleFields, values]);
+    // Group visible fields by their form_layout section (empty sections drop out
+    // because visibleFields is already visibility-filtered). Without a layout
+    // this is a single default group → the render below collapses to the legacy
+    // flat grid, byte-for-byte.
+    const groups = useMemo(() => groupFieldsBySection(visibleFields, formLayout, values), [visibleFields, formLayout, values]);
+    const isSteps = formLayout?.mode === 'steps' && groups.length > 1;
+    // Wizard step cursor (steps mode only). Clamped whenever the group count
+    // shrinks (a visible_when flip can empty a trailing step's section).
+    const [stepIndex, setStepIndex] = useState(0);
+    useEffect(() => {
+        setStepIndex((i) => Math.min(i, Math.max(groups.length - 1, 0)));
+    }, [groups.length]);
     useEffect(() => {
         const defaults = {};
         for (const f of editableFields) {
@@ -84,11 +98,43 @@ export function DynamicForm({ fields, initialValues, onSubmit, onCancel, submitL
             setSubmitting(false);
         }
     };
+    // Renders one group's fields into the responsive 2-column grid: scalar
+    // header fields flow through it; line-items grids (and textareas) span full
+    // width so the row table / memo gets room. Shared by every layout mode.
+    const renderGrid = (groupFields) => (_jsx("div", { className: "grid gap-4 sm:grid-cols-2", children: groupFields.map((field) => (_jsx(FieldRow, { field: field, value: values[field.key], onChange: (v) => update(field.key, v), values: values, error: errors[field.key], initialValues: initialValues }, field.key))) }));
+    // ── Steps (wizard) mode ────────────────────────────────────────────────
+    // One step per section; Anterior/Siguiente navigate, submit only on the
+    // last step. Advancing validates just the current step's fields so a later
+    // step can't be blocked by an earlier untouched one and vice-versa.
+    if (isSteps) {
+        const step = groups[stepIndex];
+        const isLast = stepIndex === groups.length - 1;
+        const goNext = () => {
+            const stepSchema = buildZodSchema(step.fields);
+            const result = stepSchema.safeParse(values);
+            if (!result.success) {
+                const next = {};
+                for (const issue of result.error.issues) {
+                    const key = issue.path[0];
+                    if (typeof key === 'string' && !next[key])
+                        next[key] = issue.message;
+                }
+                setErrors(next);
+                return;
+            }
+            setErrors({});
+            setStepIndex((i) => Math.min(i + 1, groups.length - 1));
+        };
+        const goBack = () => setStepIndex((i) => Math.max(i - 1, 0));
+        return (_jsxs("form", { onSubmit: handleSubmit, className: "grid gap-4", children: [_jsx(WizardProgress, { groups: groups, stepIndex: stepIndex }), renderGrid(step.fields), _jsxs("div", { className: "flex justify-between gap-2 pt-2", children: [stepIndex > 0 ? (_jsx(Button, { type: "button", variant: "outline", onClick: goBack, disabled: submitting || disabled, children: "Anterior" })) : onCancel ? (_jsx(Button, { type: "button", variant: "outline", onClick: onCancel, disabled: submitting || disabled, children: cancelLabel })) : (_jsx("span", {})), isLast ? (_jsx(Button, { type: "submit", disabled: submitting || disabled || balanceBlocked, children: submitLabel })) : (_jsx(Button, { type: "button", onClick: goNext, disabled: submitting || disabled, children: "Siguiente" }))] })] }));
+    }
+    // ── Sections / flat mode ───────────────────────────────────────────────
     // Layout: scalar header fields flow through a responsive 2-column grid;
     // line-items grids (and textareas) span the full width so the row table /
     // memo gets room. Mirrors the pro look of the federated journal modal but
-    // stays fully declarative — driven only by field shape.
-    return (_jsxs("form", { onSubmit: handleSubmit, className: "grid gap-4", children: [_jsx("div", { className: "grid gap-4 sm:grid-cols-2", children: visibleFields.map((field) => (_jsx(FieldRow, { field: field, value: values[field.key], onChange: (v) => update(field.key, v), values: values, error: errors[field.key], initialValues: initialValues }, field.key))) }), _jsxs("div", { className: "flex justify-end gap-2 pt-2", children: [onCancel && (_jsx(Button, { type: "button", variant: "outline", onClick: onCancel, disabled: submitting || disabled, children: cancelLabel })), _jsx(Button, { type: "submit", disabled: submitting || disabled || balanceBlocked, children: submitLabel })] })] }));
+    // stays fully declarative — driven only by field shape. With no layout this
+    // is a single default group rendered without section chrome (unchanged).
+    return (_jsxs("form", { onSubmit: handleSubmit, className: "grid gap-4", children: [groups.map((group) => (_jsx(FieldSection, { group: group, children: renderGrid(group.fields) }, group.key))), _jsxs("div", { className: "flex justify-end gap-2 pt-2", children: [onCancel && (_jsx(Button, { type: "button", variant: "outline", onClick: onCancel, disabled: submitting || disabled, children: cancelLabel })), _jsx(Button, { type: "submit", disabled: submitting || disabled || balanceBlocked, children: submitLabel })] })] }));
 }
 // One form field row: label + renderer + inline error. Encapsulated as its own
 // component so a STATIC enum select whose options are all gated out by a sibling

package/dist/form-layout-ui.d.ts

@@ -0,0 +1,25 @@
+import type { FieldGroup } from './form-layout';
+/**
+ * Section chrome for `mode: "sections"`. Wraps a group's (already gridded)
+ * fields in a titled block.
+ *  - The default/orphan group renders with NO chrome, so a layout-less form (one
+ *    default group) is visually identical to the legacy flat list.
+ *  - A section whose `collapsed` is defined (true/false) is rendered COLLAPSIBLE,
+ *    starting collapsed when `collapsed === true`. A section with no `collapsed`
+ *    flag renders as a plain, always-open titled block.
+ */
+export declare function FieldSection({ group, children, }: {
+    group: FieldGroup<unknown>;
+    children: React.ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Progress bar for `mode: "steps"`: one filled segment per completed/current
+ * step plus a "Paso i/n · <title>" caption. Mirrors the WizardActionModal look
+ * so a model wizard and an action wizard read the same.
+ */
+export declare function WizardProgress({ groups, stepIndex, stepLabel, }: {
+    groups: FieldGroup<unknown>[];
+    stepIndex: number;
+    stepLabel?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=form-layout-ui.d.ts.map

package/dist/form-layout-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-layout-ui.d.ts","sourceRoot":"","sources":["../src/form-layout-ui.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EACzB,KAAK,EACL,QAAQ,GACX,EAAE;IACC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC5B,+BA6CA;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAC3B,MAAM,EACN,SAAS,EACT,SAAkB,GACrB,EAAE;IACC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,+BA2BA"}

package/dist/form-layout-ui.js

@@ -0,0 +1,39 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// Presentational chrome for declarative form layouts (see `form-layout.ts`).
+// Kept apart from the grouping logic so the pure helper stays React-free and the
+// two renderers (`dynamic-form.tsx`, `dialogs/dynamic-record.tsx`) share one
+// look for sections and the wizard progress bar.
+import { useState } from 'react';
+import { Collapsible, CollapsibleContent, CollapsibleTrigger, Button, } from '@asteby/metacore-ui/primitives';
+import { ChevronDown } from 'lucide-react';
+/**
+ * Section chrome for `mode: "sections"`. Wraps a group's (already gridded)
+ * fields in a titled block.
+ *  - The default/orphan group renders with NO chrome, so a layout-less form (one
+ *    default group) is visually identical to the legacy flat list.
+ *  - A section whose `collapsed` is defined (true/false) is rendered COLLAPSIBLE,
+ *    starting collapsed when `collapsed === true`. A section with no `collapsed`
+ *    flag renders as a plain, always-open titled block.
+ */
+export function FieldSection({ group, children, }) {
+    const collapsible = group.collapsed !== undefined;
+    const [open, setOpen] = useState(!group.collapsed);
+    if (group.isDefault)
+        return _jsx(_Fragment, { children: children });
+    const header = (_jsxs("div", { className: "min-w-0 text-left", children: [group.title && (_jsx("h3", { className: "text-sm font-semibold leading-none", children: group.title })), group.description && (_jsx("p", { className: "pt-1 text-sm text-muted-foreground", children: group.description }))] }));
+    if (!collapsible) {
+        return (_jsxs("section", { className: "grid gap-3", children: [(group.title || group.description) && header, children] }));
+    }
+    return (_jsxs(Collapsible, { open: open, onOpenChange: setOpen, className: "grid gap-3", children: [_jsx(CollapsibleTrigger, { asChild: true, children: _jsxs(Button, { type: "button", variant: "ghost", className: "h-auto w-full justify-between px-0 py-1 hover:bg-transparent", children: [header, _jsx(ChevronDown, { className: 'h-4 w-4 shrink-0 transition-transform ' + (open ? 'rotate-180' : '') })] }) }), _jsx(CollapsibleContent, { className: "grid gap-3", children: children })] }));
+}
+/**
+ * Progress bar for `mode: "steps"`: one filled segment per completed/current
+ * step plus a "Paso i/n · <title>" caption. Mirrors the WizardActionModal look
+ * so a model wizard and an action wizard read the same.
+ */
+export function WizardProgress({ groups, stepIndex, stepLabel = 'Paso', }) {
+    const current = groups[stepIndex];
+    return (_jsxs("div", { className: "pt-2", children: [_jsx("div", { className: "flex items-center gap-1.5", role: "list", "aria-label": "progress", children: groups.map((g, i) => (_jsx("div", { role: "listitem", "aria-current": i === stepIndex ? 'step' : undefined, className: "h-1.5 flex-1 rounded-full", style: {
+                        backgroundColor: i <= stepIndex ? 'hsl(var(--primary))' : 'hsl(var(--muted))',
+                    } }, g.key))) }), _jsxs("p", { className: "pt-2 text-sm text-muted-foreground", children: [stepLabel, " ", stepIndex + 1, "/", groups.length, current?.title ? ` · ${current.title}` : ''] }), current?.description && (_jsx("p", { className: "pt-1 text-sm text-muted-foreground", children: current.description }))] }));
+}

package/dist/form-layout.d.ts

@@ -0,0 +1,68 @@
+import type { VisibleWhen } from './types';
+/** One declared section of a model form. `title`/`description` arrive already
+ * localized from the kernel and are rendered verbatim. */
+export interface FormSection {
+    key: string;
+    title?: string;
+    description?: string;
+    /** Sections mode only: render this section collapsed on first paint. */
+    collapsed?: boolean;
+    /** Section-level visibility gate (kernel v0.84.0). When present and its
+     * predicate evaluates false against the live form values, the whole section
+     * is omitted (and in steps mode its wizard step drops from the sequence).
+     * Tolerates the camelCase alias, same as fields. */
+    visible_when?: VisibleWhen;
+    visibleWhen?: VisibleWhen;
+}
+/** Model-level layout directive. `mode` defaults to `"sections"`. */
+export interface FormLayout {
+    mode?: 'sections' | 'steps';
+    sections?: FormSection[];
+}
+/** A resolved group of fields ready to render: a section plus the (already
+ * visibility-filtered) fields that belong to it. */
+export interface FieldGroup<F> {
+    /** Section key, or `__default__` for the orphan group. */
+    key: string;
+    title?: string;
+    description?: string;
+    collapsed?: boolean;
+    /** True for the synthetic group holding section-less / unknown-section fields. */
+    isDefault: boolean;
+    fields: F[];
+}
+/** The synthetic key of the orphan group (fields with no / unknown `section`). */
+export declare const DEFAULT_SECTION_KEY = "__default__";
+/** Reads a field's `section` reference, tolerating a camelCase alias. */
+export declare function getFieldSection(field: {
+    section?: string;
+    Section?: string;
+} | null | undefined): string | undefined;
+/**
+ * Groups already-filtered (visible) fields by their `section`, honoring the
+ * order of `layout.sections`.
+ *
+ * Contract:
+ *  - No `layout` (or no `sections`) → a single default group carrying every
+ *    field in its original order. Callers render this exactly like the legacy
+ *    flat list, so the layout-less path is byte-for-byte the current behaviour.
+ *  - Fields whose `section` is empty or references an UNKNOWN section key are
+ *    collected into ONE default group placed FIRST (before any declared
+ *    section) — the consistent, documented choice: general/uncategorized fields
+ *    lead, declared sections follow in their authored order.
+ *  - A declared section with zero visible fields is OMITTED entirely, so a
+ *    section whose only members are hidden by `visible_when` never renders an
+ *    empty shell (and never yields an empty wizard step). Because the caller
+ *    passes the already visibility-filtered list, this falls out for free.
+ *  - A section declaring its OWN `visible_when` is dropped whole (before its
+ *    fields are even collected) whenever the predicate evaluates false against
+ *    `values`, reusing the SAME evaluator the fields use. In steps mode the
+ *    caller derives the wizard sequence from these groups, so a hidden section
+ *    simply never becomes a step. Section-less / unknown-section fields are
+ *    never gated by any section predicate. Without a section `visible_when`
+ *    (or without `values`), behaviour is byte-for-byte the legacy path.
+ */
+export declare function groupFieldsBySection<F extends {
+    section?: string;
+}>(fields: F[], layout: FormLayout | undefined, values?: Record<string, any> | null): FieldGroup<F>[];
+//# sourceMappingURL=form-layout.d.ts.map

package/dist/form-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-layout.d.ts","sourceRoot":"","sources":["../src/form-layout.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAG1C;0DAC0D;AAC1D,MAAM,WAAW,WAAW;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;wDAGoD;IACpD,YAAY,CAAC,EAAE,WAAW,CAAA;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAA;CAC5B;AAED,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACvB,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;CAC3B;AAED;oDACoD;AACpD,MAAM,WAAW,UAAU,CAAC,CAAC;IACzB,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,kFAAkF;IAClF,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,CAAC,EAAE,CAAA;CACd;AAED,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,gBAAgB,CAAA;AAEhD,yEAAyE;AACzE,wBAAgB,eAAe,CAC3B,KAAK,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GACjE,MAAM,GAAG,SAAS,CAIpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/D,MAAM,EAAE,CAAC,EAAE,EACX,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GACpC,UAAU,CAAC,CAAC,CAAC,EAAE,CAoDjB"}

package/dist/form-layout.js

@@ -0,0 +1,101 @@
+// Declarative form layout (kernel PR #230): a model's create/edit form can
+// declare `form_layout` to group its fields into named sections, rendered either
+// as stacked (optionally collapsible) SECTIONS or as a multi-step WIZARD.
+//
+// Wire shape served on the table/modal metadata:
+//   form_layout: {
+//     mode: "sections" | "steps",              // default "sections"
+//     sections: [{ key, title?, description?, collapsed? }]
+//   }
+// and, per field/column: `section: "<key>"` referencing a section key.
+//
+// This module owns the PURE grouping logic (no React), so the two renderers
+// (`dynamic-form.tsx`, `dialogs/dynamic-record.tsx`) share one tested
+// implementation and the modal-render machinery never has to be booted under
+// happy-dom just to assert the grouping (same approach as PR #673).
+import { evaluateVisibleWhen, getVisibleWhen } from './dynamic-form-schema';
+/** The synthetic key of the orphan group (fields with no / unknown `section`). */
+export const DEFAULT_SECTION_KEY = '__default__';
+/** Reads a field's `section` reference, tolerating a camelCase alias. */
+export function getFieldSection(field) {
+    if (!field)
+        return undefined;
+    const s = field.section ?? field.Section;
+    return typeof s === 'string' && s !== '' ? s : undefined;
+}
+/**
+ * Groups already-filtered (visible) fields by their `section`, honoring the
+ * order of `layout.sections`.
+ *
+ * Contract:
+ *  - No `layout` (or no `sections`) → a single default group carrying every
+ *    field in its original order. Callers render this exactly like the legacy
+ *    flat list, so the layout-less path is byte-for-byte the current behaviour.
+ *  - Fields whose `section` is empty or references an UNKNOWN section key are
+ *    collected into ONE default group placed FIRST (before any declared
+ *    section) — the consistent, documented choice: general/uncategorized fields
+ *    lead, declared sections follow in their authored order.
+ *  - A declared section with zero visible fields is OMITTED entirely, so a
+ *    section whose only members are hidden by `visible_when` never renders an
+ *    empty shell (and never yields an empty wizard step). Because the caller
+ *    passes the already visibility-filtered list, this falls out for free.
+ *  - A section declaring its OWN `visible_when` is dropped whole (before its
+ *    fields are even collected) whenever the predicate evaluates false against
+ *    `values`, reusing the SAME evaluator the fields use. In steps mode the
+ *    caller derives the wizard sequence from these groups, so a hidden section
+ *    simply never becomes a step. Section-less / unknown-section fields are
+ *    never gated by any section predicate. Without a section `visible_when`
+ *    (or without `values`), behaviour is byte-for-byte the legacy path.
+ */
+export function groupFieldsBySection(fields, layout, values) {
+    if (!layout?.sections?.length) {
+        return [{ key: DEFAULT_SECTION_KEY, isDefault: true, fields }];
+    }
+    // Sections whose own `visible_when` predicate evaluates false are hidden
+    // WHOLESALE: the section never emits a group/step AND its member fields are
+    // dropped (they must not leak into the default group). Reuses the same
+    // field-level evaluator — no duplicated logic. A `declared` set keeps a
+    // field targeting a hidden section from being treated as "unknown section"
+    // and orphaned.
+    const declared = new Set(layout.sections.map((s) => s.key));
+    const visibleSections = layout.sections.filter((s) => evaluateVisibleWhen(getVisibleWhen(s), values));
+    const known = new Set(visibleSections.map((s) => s.key));
+    const bySection = new Map();
+    const orphans = [];
+    for (const f of fields) {
+        const sec = getFieldSection(f);
+        if (sec && known.has(sec)) {
+            const arr = bySection.get(sec);
+            if (arr)
+                arr.push(f);
+            else
+                bySection.set(sec, [f]);
+        }
+        else if (sec && declared.has(sec)) {
+            // Belongs to a declared-but-hidden section → drop the field.
+            continue;
+        }
+        else {
+            orphans.push(f);
+        }
+    }
+    const groups = [];
+    // Orphan/default group leads (fields with no / unknown section).
+    if (orphans.length) {
+        groups.push({ key: DEFAULT_SECTION_KEY, isDefault: true, fields: orphans });
+    }
+    for (const s of visibleSections) {
+        const secFields = bySection.get(s.key);
+        if (!secFields || secFields.length === 0)
+            continue; // hide empty section
+        groups.push({
+            key: s.key,
+            title: s.title,
+            description: s.description,
+            collapsed: s.collapsed,
+            isDefault: false,
+            fields: secFields,
+        });
+    }
+    return groups;
+}

package/dist/index.d.ts

@@ -11,6 +11,8 @@ export { useStageOverrides, type StageOverridePatch, type UseStageOverridesResul
 export { DynamicView, resolveViewRenderer, readViewFromSearch, resolveActiveView, type DynamicViewProps, } from './dynamic-view';
 export { useDynamicFilters, type UseDynamicFiltersOptions, type UseDynamicFiltersResult, } from './use-dynamic-filters';
 export * from './dynamic-form';
+export * from './form-layout';
+export * from './form-layout-ui';
 export { FieldGrid, FieldCell, FieldLabel } from './field-grid';
 export { ActionModalDispatcher, type ActionModalProps, } from './action-modal-dispatcher';
 export { ModelActionToolbar, useModelActions, type ModelActionToolbarProps, type ActionPlacement, } from './model-action-toolbar';