@asteby/metacore-runtime-react 24.0.0 → 24.0.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @asteby/metacore-runtime-react
 
+## 24.0.1
+
+### Patch Changes
+
+- 4a62c3c: Preview automático del registro en el modal de confirmación de acciones de fila.
+
+  Al confirmar una row-action con `confirm` (p. ej. aceptar/rechazar un traspaso), el
+  `ConfirmActionDialog` ahora muestra un resumen compacto y de solo lectura del registro
+  que va a afectar, para no confirmar a ciegas. Es 100% del SDK y genérico: se apoya en la
+  metadata de tabla del modelo (labels + display hints, leída del cache o con un único fetch
+  a `/metadata/table/<model>`) y en los siblings de relación que la tabla ya resolvió sobre
+  la fila. La heurística surface relaciones resueltas a su label, campos line-items (jsonb,
+  como `Transfer.items`, renderizados producto × cantidad) y un puñado de escalares de
+  identidad; omite `id`, `organization_id`, timestamps y los `*_id` crudos sin label. Se
+  degrada solo: si no hay nada útil que mostrar, no renderiza la sección.
+
 ## 24.0.0
 
 ### Patch Changes

package/dist/action-modal-dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-modal-dispatcher.d.ts","sourceRoot":"","sources":["../src/action-modal-dispatcher.tsx"],"names":[],"mappings":"AAgDA,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAExB,MAAM,sBAAsB,CAAA;AAE7B,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAA;AA0FhD,wBAAgB,qBAAqB,CAAC,EAClC,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,KAAK,EACL,MAAM,EACN,QAAQ,EACR,SAAS,GACZ,EAAE,gBAAgB,sCA+DlB"}
+{"version":3,"file":"action-modal-dispatcher.d.ts","sourceRoot":"","sources":["../src/action-modal-dispatcher.tsx"],"names":[],"mappings":"AAwDA,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAExB,MAAM,sBAAsB,CAAA;AAE7B,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAA;AA0FhD,wBAAgB,qBAAqB,CAAC,EAClC,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,KAAK,EACL,MAAM,EACN,QAAQ,EACR,SAAS,GACZ,EAAE,gBAAgB,sCA+DlB"}

package/dist/action-modal-dispatcher.js

@@ -19,8 +19,10 @@ import { DynamicRelations } from './dynamic-relations';
 import { DynamicSelectField } from './dynamic-select-field';
 import { DynamicDateField } from './dynamic-date-field';
 import { UploadField } from './upload-field';
-import { isLineItemsField, resolveWidget, resolveDependsValue, getDependsOn } from './dynamic-form-schema';
+import { isLineItemsField, resolveWidget, resolveDependsValue, getDependsOn, getFieldRef } from './dynamic-form-schema';
 import { FieldGrid, FieldCell, FieldLabel } from './field-grid';
+import { useMetadataCache } from './metadata-cache';
+import { ViewValue, objectLabel, relationSiblingValue, isLineItemsField as isRecordLineItemsField, } from './dialogs/dynamic-record';
 // Canonical registry lives in @asteby/metacore-sdk
 import { getActionComponent, } from '@asteby/metacore-sdk';
 function isPrefillSpec(v) {
@@ -110,6 +112,143 @@ function buildActionUrl(endpoint, model, recordId, actionKey) {
     }
     return hasRecord ? `/data/${model}/me/${recordId}/action/${actionKey}` : `/data/${model}/me/action/${actionKey}`;
 }
+// ── Preview automático del registro en el modal de confirmación ─────────────
+//
+// Antes de confirmar una row-action (aceptar/rechazar un traspaso, etc.) el
+// usuario ve un resumen compacto y read-only de QUÉ registro va a afectar, para
+// no confirmar a ciegas. Es 100% del SDK y genérico: se apoya en la metadata de
+// tabla del modelo (labels + display hints) y en los siblings de relación que la
+// tabla ya resolvió sobre el `record`. Se degrada solo — si no hay ni un campo
+// ni líneas útiles que mostrar, no renderiza nada (ni una caja vacía).
+// Claves de sistema/infra que nunca aportan contexto al preview.
+const PREVIEW_SKIP_KEYS = new Set([
+    'id',
+    'organization_id',
+    'org_id',
+    'created_at',
+    'updated_at',
+    'deleted_at',
+    'created_by',
+    'created_by_id',
+    'updated_by',
+    'updated_by_id',
+]);
+// Campos escalares "de identidad" que sí vale la pena anclar en el preview
+// aunque no sean relación ni line-items (nombre, folio, estado, etc.).
+const PREVIEW_INTEREST_KEYS = new Set([
+    'name',
+    'title',
+    'code',
+    'reference',
+    'folio',
+    'number',
+    'status',
+    'stage',
+    'state',
+]);
+const PREVIEW_INTEREST_STYLES = new Set(['status', 'badge', 'currency']);
+const MAX_PREVIEW_FIELD_ROWS = 6;
+function isEmptyPreviewValue(value) {
+    if (value === null || value === undefined || value === '')
+        return true;
+    if (Array.isArray(value))
+        return value.length === 0;
+    if (typeof value === 'object' && !(value instanceof Date))
+        return Object.keys(value).length === 0;
+    return false;
+}
+// selectPreviewColumns aplica la heurística compacta sobre las columnas del
+// modelo: relaciones resueltas a su label, campos line-items (jsonb) y un puñado
+// de escalares de identidad. Omite id/org/timestamps y los *_id crudos cuya
+// relación no resolvió a un label legible.
+function selectPreviewColumns(columns, record) {
+    if (!columns || !record)
+        return [];
+    const lineItemRows = [];
+    const fieldRows = [];
+    for (const col of columns) {
+        if (!col || !col.key)
+            continue;
+        if (col.hidden)
+            continue;
+        if (PREVIEW_SKIP_KEYS.has(col.key))
+            continue;
+        const value = record[col.key];
+        // Line-items (jsonb array como Transfer.items) → mini-tabla producto×cantidad.
+        if (isRecordLineItemsField(col, value)) {
+            if (isEmptyPreviewValue(value))
+                continue;
+            lineItemRows.push({ col, value, lineItems: true });
+            continue;
+        }
+        // Relación (ref / search / dynamic_select / *_id): solo si el sibling
+        // resolvió a un label legible; si es un *_id crudo sin resolver, se omite.
+        const isRelation = !!getFieldRef(col) ||
+            col.type === 'search' ||
+            col.type === 'relation' ||
+            col.widget === 'dynamic_select' ||
+            (typeof col.key === 'string' && col.key.endsWith('_id'));
+        if (isRelation) {
+            const sib = relationSiblingValue(col, record);
+            const label = typeof sib === 'string' ? sib : objectLabel(sib);
+            if (!label)
+                continue;
+            fieldRows.push({ col, value, lineItems: false });
+            continue;
+        }
+        // Escalar de identidad (nombre/folio/estado/moneda…) con valor.
+        const styleKey = col.cellStyle ?? col.type;
+        const interesting = PREVIEW_INTEREST_KEYS.has(col.key) || PREVIEW_INTEREST_STYLES.has(String(styleKey));
+        if (interesting && !isEmptyPreviewValue(value)) {
+            fieldRows.push({ col, value, lineItems: false });
+        }
+    }
+    return [...fieldRows.slice(0, MAX_PREVIEW_FIELD_ROWS), ...lineItemRows];
+}
+function RecordPreview({ model, record }) {
+    const { t } = useTranslation();
+    const api = useApi();
+    const cached = useMetadataCache((s) => s.getMetadata(model));
+    const setMetadata = useMetadataCache((s) => s.setMetadata);
+    const [fetched, setFetched] = useState(null);
+    // Sin metadata cacheada → UN fetch a /metadata/table/<model> (mismo patrón
+    // que model-action-toolbar). Se guarda en el store para próximos usos.
+    useEffect(() => {
+        if (cached || !model)
+            return;
+        let cancelled = false;
+        api
+            .get(`/metadata/table/${model}`)
+            .then((res) => {
+            if (cancelled)
+                return;
+            const meta = (res.data?.data ?? res.data);
+            if (meta && Array.isArray(meta.columns)) {
+                setFetched(meta);
+                setMetadata(model, meta);
+            }
+        })
+            .catch(() => {
+            if (!cancelled)
+                setFetched(null);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [cached, model, api, setMetadata]);
+    const meta = cached ?? fetched;
+    const rows = useMemo(() => selectPreviewColumns(meta?.columns, record), [meta, record]);
+    // Degradación: nada útil que mostrar → no renderiza la sección.
+    if (rows.length === 0)
+        return null;
+    return (_jsx("div", { className: "mt-1 overflow-hidden rounded-md border bg-muted/30 text-sm", children: rows.map(({ col, value, lineItems }) => {
+            const label = t(col.label, { defaultValue: col.label });
+            if (lineItems) {
+                return (_jsxs("div", { className: "border-t px-3 py-2 first:border-t-0", children: [_jsx("div", { className: "mb-1 text-xs font-medium uppercase tracking-wide text-muted-foreground", children: label }), _jsx(ViewValue, { field: col, value: value, record: record })] }, col.key));
+            }
+            return (_jsxs("div", { className: "flex items-baseline gap-3 border-t px-3 py-1.5 first:border-t-0", children: [_jsx("span", { className: "w-1/3 shrink-0 truncate text-muted-foreground", children: label }), _jsx("div", { className: "min-w-0 flex-1 [&_p]:py-0", children: _jsx(ViewValue, { field: col, value: value, record: record }) })] }, col.key));
+        }) }));
+}
 function ConfirmActionDialog({ open, onOpenChange, action, model, record, endpoint, onSuccess }) {
     const { t } = useTranslation();
     const api = useApi();
@@ -139,7 +278,7 @@ function ConfirmActionDialog({ open, onOpenChange, action, model, record, endpoi
             setExecuting(false);
         }
     };
-    return (_jsx(AlertDialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(AlertDialogContent, { children: [_jsxs(AlertDialogHeader, { children: [_jsxs(AlertDialogTitle, { className: "flex items-center gap-2", children: [_jsx(DynamicIcon, { name: action.icon, className: "h-5 w-5" }), label] }), _jsx(AlertDialogDescription, { children: action.confirmMessage || `${label}?` })] }), _jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { disabled: executing, children: t('common.cancel') }), _jsxs(AlertDialogAction, { onClick: (e) => { e.preventDefault(); execute(); }, disabled: executing, style: action.color ? { backgroundColor: action.color } : undefined, children: [executing ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : _jsx(DynamicIcon, { name: action.icon, className: "mr-2 h-4 w-4" }), label] })] })] }) }));
+    return (_jsx(AlertDialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(AlertDialogContent, { children: [_jsxs(AlertDialogHeader, { children: [_jsxs(AlertDialogTitle, { className: "flex items-center gap-2", children: [_jsx(DynamicIcon, { name: action.icon, className: "h-5 w-5" }), label] }), _jsx(AlertDialogDescription, { children: action.confirmMessage || `${label}?` })] }), record ? _jsx(RecordPreview, { model: model, record: record }) : null, _jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { disabled: executing, children: t('common.cancel') }), _jsxs(AlertDialogAction, { onClick: (e) => { e.preventDefault(); execute(); }, disabled: executing, style: action.color ? { backgroundColor: action.color } : undefined, children: [executing ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : _jsx(DynamicIcon, { name: action.icon, className: "mr-2 h-4 w-4" }), label] })] })] }) }));
 }
 function GenericActionModal({ open, onOpenChange, action, model, record, endpoint, onSuccess }) {
     const { t } = useTranslation();

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

@@ -159,6 +159,9 @@ export interface DynamicRecordDialogProps {
      */
     onChange?: () => void;
 }
+export declare function objectLabel(value: any): string | undefined;
+export declare function relationSiblingValue(field: FieldDef, record: any): any;
+export declare function fieldItemFields(field: FieldDef): ItemField[] | undefined;
 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;

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

@@ -47,7 +47,7 @@ function resolvePath(obj, path) {
 // objectLabel pulls a human label off a resolved relation/user object the
 // backend serves: `{value,label}` (FK sibling), `{name,...}` (user object such
 // as created_by), or `{title}`. Returns undefined for plain/empty objects.
-function objectLabel(value) {
+export function objectLabel(value) {
     if (!value || typeof value !== 'object' || Array.isArray(value))
         return undefined;
     const label = value.label ?? value.name ?? value.title;
@@ -66,7 +66,7 @@ function pickImage(value) {
 // FK column. A field `category_id` (search/dynamic_select/ref) ships a sibling
 // `record.category = {value,label,image?}` (or a bare string/{name}); returns
 // the raw sibling (object or string) so the caller can extract label + image.
-function relationSiblingValue(field, record) {
+export function relationSiblingValue(field, record) {
     if (!record)
         return undefined;
     const candidates = [];
@@ -91,7 +91,7 @@ function relationSiblingValue(field, record) {
 }
 // fieldItemFields reads the declared jsonb line-items schema off a field,
 // tolerating the snake_case `item_fields` alias the kernel serves.
-function fieldItemFields(field) {
+export function fieldItemFields(field) {
     return field.itemFields ?? field.item_fields;
 }
 // isLineItemsField — a jsonb line-items column (e.g. Transfer.items): it either

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "24.0.0",
+  "version": "24.0.1",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",

package/src/action-modal-dispatcher.tsx

@@ -42,9 +42,17 @@ import { DynamicRelations } from './dynamic-relations'
 import { DynamicSelectField } from './dynamic-select-field'
 import { DynamicDateField } from './dynamic-date-field'
 import { UploadField } from './upload-field'
-import { isLineItemsField, resolveWidget, resolveDependsValue, getDependsOn } from './dynamic-form-schema'
+import { isLineItemsField, resolveWidget, resolveDependsValue, getDependsOn, getFieldRef } from './dynamic-form-schema'
 import { FieldGrid, FieldCell, FieldLabel } from './field-grid'
-import type { ActionFieldDef } from './types'
+import { useMetadataCache } from './metadata-cache'
+import {
+    ViewValue,
+    objectLabel,
+    relationSiblingValue,
+    fieldItemFields,
+    isLineItemsField as isRecordLineItemsField,
+} from './dialogs/dynamic-record'
+import type { ActionFieldDef, TableMetadata, ColumnDefinition } from './types'
 // Canonical registry lives in @asteby/metacore-sdk
 import {
     type ActionMetadata,
@@ -228,6 +236,172 @@ function buildActionUrl(endpoint: string | undefined, model: string, recordId: s
     return hasRecord ? `/data/${model}/me/${recordId}/action/${actionKey}` : `/data/${model}/me/action/${actionKey}`
 }
 
+// ── Preview automático del registro en el modal de confirmación ─────────────
+//
+// Antes de confirmar una row-action (aceptar/rechazar un traspaso, etc.) el
+// usuario ve un resumen compacto y read-only de QUÉ registro va a afectar, para
+// no confirmar a ciegas. Es 100% del SDK y genérico: se apoya en la metadata de
+// tabla del modelo (labels + display hints) y en los siblings de relación que la
+// tabla ya resolvió sobre el `record`. Se degrada solo — si no hay ni un campo
+// ni líneas útiles que mostrar, no renderiza nada (ni una caja vacía).
+
+// Claves de sistema/infra que nunca aportan contexto al preview.
+const PREVIEW_SKIP_KEYS = new Set([
+    'id',
+    'organization_id',
+    'org_id',
+    'created_at',
+    'updated_at',
+    'deleted_at',
+    'created_by',
+    'created_by_id',
+    'updated_by',
+    'updated_by_id',
+])
+
+// Campos escalares "de identidad" que sí vale la pena anclar en el preview
+// aunque no sean relación ni line-items (nombre, folio, estado, etc.).
+const PREVIEW_INTEREST_KEYS = new Set([
+    'name',
+    'title',
+    'code',
+    'reference',
+    'folio',
+    'number',
+    'status',
+    'stage',
+    'state',
+])
+const PREVIEW_INTEREST_STYLES = new Set(['status', 'badge', 'currency'])
+
+const MAX_PREVIEW_FIELD_ROWS = 6
+
+function isEmptyPreviewValue(value: any): boolean {
+    if (value === null || value === undefined || value === '') return true
+    if (Array.isArray(value)) return value.length === 0
+    if (typeof value === 'object' && !(value instanceof Date)) return Object.keys(value).length === 0
+    return false
+}
+
+interface PreviewRow {
+    col: ColumnDefinition
+    value: any
+    lineItems: boolean
+}
+
+// selectPreviewColumns aplica la heurística compacta sobre las columnas del
+// modelo: relaciones resueltas a su label, campos line-items (jsonb) y un puñado
+// de escalares de identidad. Omite id/org/timestamps y los *_id crudos cuya
+// relación no resolvió a un label legible.
+function selectPreviewColumns(columns: ColumnDefinition[] | undefined, record: any): PreviewRow[] {
+    if (!columns || !record) return []
+    const lineItemRows: PreviewRow[] = []
+    const fieldRows: PreviewRow[] = []
+
+    for (const col of columns) {
+        if (!col || !col.key) continue
+        if (col.hidden) continue
+        if (PREVIEW_SKIP_KEYS.has(col.key)) continue
+        const value = record[col.key]
+
+        // Line-items (jsonb array como Transfer.items) → mini-tabla producto×cantidad.
+        if (isRecordLineItemsField(col as any, value)) {
+            if (isEmptyPreviewValue(value)) continue
+            lineItemRows.push({ col, value, lineItems: true })
+            continue
+        }
+
+        // Relación (ref / search / dynamic_select / *_id): solo si el sibling
+        // resolvió a un label legible; si es un *_id crudo sin resolver, se omite.
+        const isRelation =
+            !!getFieldRef(col as ActionFieldDef) ||
+            col.type === 'search' ||
+            col.type === 'relation' ||
+            (col as { widget?: string }).widget === 'dynamic_select' ||
+            (typeof col.key === 'string' && col.key.endsWith('_id'))
+        if (isRelation) {
+            const sib = relationSiblingValue(col as any, record)
+            const label = typeof sib === 'string' ? sib : objectLabel(sib)
+            if (!label) continue
+            fieldRows.push({ col, value, lineItems: false })
+            continue
+        }
+
+        // Escalar de identidad (nombre/folio/estado/moneda…) con valor.
+        const styleKey = col.cellStyle ?? col.type
+        const interesting =
+            PREVIEW_INTEREST_KEYS.has(col.key) || PREVIEW_INTEREST_STYLES.has(String(styleKey))
+        if (interesting && !isEmptyPreviewValue(value)) {
+            fieldRows.push({ col, value, lineItems: false })
+        }
+    }
+
+    return [...fieldRows.slice(0, MAX_PREVIEW_FIELD_ROWS), ...lineItemRows]
+}
+
+function RecordPreview({ model, record }: { model: string; record: any }) {
+    const { t } = useTranslation()
+    const api = useApi()
+    const cached = useMetadataCache((s) => s.getMetadata(model))
+    const setMetadata = useMetadataCache((s) => s.setMetadata)
+    const [fetched, setFetched] = useState<TableMetadata | null>(null)
+
+    // Sin metadata cacheada → UN fetch a /metadata/table/<model> (mismo patrón
+    // que model-action-toolbar). Se guarda en el store para próximos usos.
+    useEffect(() => {
+        if (cached || !model) return
+        let cancelled = false
+        api
+            .get(`/metadata/table/${model}`)
+            .then((res) => {
+                if (cancelled) return
+                const meta = (res.data?.data ?? res.data) as TableMetadata
+                if (meta && Array.isArray(meta.columns)) {
+                    setFetched(meta)
+                    setMetadata(model, meta)
+                }
+            })
+            .catch(() => {
+                if (!cancelled) setFetched(null)
+            })
+        return () => {
+            cancelled = true
+        }
+    }, [cached, model, api, setMetadata])
+
+    const meta = cached ?? fetched
+    const rows = useMemo(() => selectPreviewColumns(meta?.columns, record), [meta, record])
+
+    // Degradación: nada útil que mostrar → no renderiza la sección.
+    if (rows.length === 0) return null
+
+    return (
+        <div className="mt-1 overflow-hidden rounded-md border bg-muted/30 text-sm">
+            {rows.map(({ col, value, lineItems }) => {
+                const label = t(col.label, { defaultValue: col.label })
+                if (lineItems) {
+                    return (
+                        <div key={col.key} className="border-t px-3 py-2 first:border-t-0">
+                            <div className="mb-1 text-xs font-medium uppercase tracking-wide text-muted-foreground">
+                                {label}
+                            </div>
+                            <ViewValue field={col as any} value={value} record={record} />
+                        </div>
+                    )
+                }
+                return (
+                    <div key={col.key} className="flex items-baseline gap-3 border-t px-3 py-1.5 first:border-t-0">
+                        <span className="w-1/3 shrink-0 truncate text-muted-foreground">{label}</span>
+                        <div className="min-w-0 flex-1 [&_p]:py-0">
+                            <ViewValue field={col as any} value={value} record={record} />
+                        </div>
+                    </div>
+                )
+            })}
+        </div>
+    )
+}
+
 function ConfirmActionDialog({ open, onOpenChange, action, model, record, endpoint, onSuccess }: ActionModalProps) {
     const { t } = useTranslation()
     const api = useApi()
@@ -268,6 +442,7 @@ function ConfirmActionDialog({ open, onOpenChange, action, model, record, endpoi
                         {action.confirmMessage || `${label}?`}
                     </AlertDialogDescription>
                 </AlertDialogHeader>
+                {record ? <RecordPreview model={model} record={record} /> : null}
                 <AlertDialogFooter>
                     <AlertDialogCancel disabled={executing}>{t('common.cancel')}</AlertDialogCancel>
                     <AlertDialogAction

package/src/dialogs/dynamic-record.tsx

@@ -267,7 +267,7 @@ function resolvePath(obj: any, path: string): any {
 // objectLabel pulls a human label off a resolved relation/user object the
 // backend serves: `{value,label}` (FK sibling), `{name,...}` (user object such
 // as created_by), or `{title}`. Returns undefined for plain/empty objects.
-function objectLabel(value: any): string | undefined {
+export function objectLabel(value: any): string | undefined {
     if (!value || typeof value !== 'object' || Array.isArray(value)) return undefined
     const label = value.label ?? value.name ?? value.title
     if (label != null && label !== '') return String(label)
@@ -285,7 +285,7 @@ function pickImage(value: any): string | undefined {
 // FK column. A field `category_id` (search/dynamic_select/ref) ships a sibling
 // `record.category = {value,label,image?}` (or a bare string/{name}); returns
 // the raw sibling (object or string) so the caller can extract label + image.
-function relationSiblingValue(field: FieldDef, record: any): any {
+export function relationSiblingValue(field: FieldDef, record: any): any {
     if (!record) return undefined
     const candidates: string[] = []
     const ref = getFieldRef(field as ActionFieldDef)
@@ -305,7 +305,7 @@ function relationSiblingValue(field: FieldDef, record: any): any {
 
 // fieldItemFields reads the declared jsonb line-items schema off a field,
 // tolerating the snake_case `item_fields` alias the kernel serves.
-function fieldItemFields(field: FieldDef): ItemField[] | undefined {
+export function fieldItemFields(field: FieldDef): ItemField[] | undefined {
     return field.itemFields ?? field.item_fields
 }