@asteby/metacore-runtime-react 18.22.0 → 18.23.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @asteby/metacore-runtime-react
 
+## 18.23.0
+
+### Minor Changes
+
+- dc5e552: Polish the generic record EDIT dialog (`DynamicRecordDialog` mode='edit'),
+  fixing two prod issues that affected every module using it (transfers, orders,
+  customers):
+  - **jsonb line-items render read-only instead of "[object Object]".** A field
+    that is a jsonb line-items column (declares `item_fields`, or its value is an
+    array/plain object) is no longer rendered as a broken text input. The edit
+    form now renders it read-only with the same inline `CollectionCell` table the
+    detail view uses — localized headers + resolved ref labels — plus a
+    translatable "Solo lectura" hint (`datatable.readOnly`). These are
+    action-built documents; field-by-field array editing stays out of scope.
+  - **FK selects show the related record's name, not the raw uuid.** A
+    `dynamic_select` / `ref` field in edit mode now seeds its trigger from the
+    backend-injected relation sibling (`source_warehouse_id` →
+    `source_warehouse: { value, label }`, the key without `_id`) via the existing
+    `DynamicSelectField` `seedOption` prop, so an existing selection displays the
+    label immediately without waiting for a lookup. Falls back to the raw value
+    (today's behaviour) when no sibling is present; creating/changing the
+    selection is unchanged.
+
+  `EditField`, `isLineItemsField`, and `fkSeedOption` are exported from the
+  dialogs module.
+
 ## 18.22.0
 
 ### Minor Changes

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

@@ -1,4 +1,5 @@
 import type { ModelSchema } from './types';
+import { type ResolvedOption } from '../use-options-resolver';
 import { type ItemField } from '../collection-cell';
 import { type GetImageUrl } from '../image-url-context';
 export type { GetImageUrl };
@@ -158,6 +159,8 @@ export interface DynamicRecordDialogProps {
      */
     onChange?: () => void;
 }
+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 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 ViewValue({ field, value: rawValue, record, getImageUrl: getImageUrlProp, timeZone: timeZoneProp, currency: currencyProp, }: {
@@ -171,4 +174,11 @@ export declare function ViewValue({ field, value: rawValue, record, getImageUrl:
     /** Optional override; when omitted falls back to the nearest provider. */
     currency?: string;
 }): import("react").JSX.Element;
+export declare function EditField({ field, value, onChange, record }: {
+    field: FieldDef;
+    value: any;
+    onChange: (val: any) => void;
+    /** The full record being edited — supplies FK relation siblings + line-items. */
+    record?: any;
+}): import("react").JSX.Element;
 //# sourceMappingURL=dynamic-record.d.ts.map

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":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AA6C1C,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEnE,OAAO,EAAqC,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAK1F,YAAY,EAAE,WAAW,EAAE,CAAA;AAE3B,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,QAAQ;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;IACpH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB,YAAY,CAAC,EAAE,GAAG,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACjC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;IACxB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,SAAS,EAAE,CAAA;CAC5B;AAiCD,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;2DAEuD;IACvD,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAClF;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IACpG;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;IAC3B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;IAC1C;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB;AAwID,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAUjE;AAED,wBAAgB,mBAAmB,CAAC,EAChC,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,MAAM,EACN,cAAc,EACd,aAAa,EACb,WAA8B,EAC9B,QAAQ,EACR,QAAQ,EACR,QAAQ,GACX,EAAE,wBAAwB,+BAuY1B;AAgGD,wBAAgB,SAAS,CAAC,EACtB,KAAK,EACL,KAAK,EAAE,QAAQ,EACf,MAAM,EACN,WAAW,EAAE,eAAe,EAC5B,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,YAAY,GACzB,EAAE;IACC,KAAK,EAAE,QAAQ,CAAA;IACf,KAAK,EAAE,GAAG,CAAA;IACV,MAAM,EAAE,GAAG,CAAA;IACX,mFAAmF;IACnF,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB,+BAqLA"}
+{"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

@@ -85,6 +85,51 @@ function relationSiblingValue(field, record) {
     }
     return undefined;
 }
+// fieldItemFields reads the declared jsonb line-items schema off a field,
+// tolerating the snake_case `item_fields` alias the kernel serves.
+function fieldItemFields(field) {
+    return field.itemFields ?? field.item_fields;
+}
+// isLineItemsField — a jsonb line-items column (e.g. Transfer.items): it either
+// declares an `item_fields` schema, or its value is a structured array/object.
+// These are action-built documents; field-by-field editing of the array is out
+// of scope, so the edit dialog renders them read-only (the inline table) rather
+// than an input that would stringify to "[object Object]". Scalars and known
+// editable widgets (media/upload, color, dates) are NOT line-items.
+export function isLineItemsField(field, value) {
+    if (field.type === 'image' || field.widget === 'upload')
+        return false;
+    if (fieldItemFields(field)?.length)
+        return true;
+    if (Array.isArray(value))
+        return true;
+    return (value !== null &&
+        typeof value === 'object' &&
+        !(value instanceof Date));
+}
+// fkSeedOption builds the pre-resolved option for a FK select's CURRENT value
+// from the relation sibling the backend injected alongside the column
+// (`source_warehouse_id` → `source_warehouse = {value,label,image?}`, the key
+// without `_id`; same convention as the jsonb refs). Lets the edit picker show
+// the related record's NAME instead of the raw uuid without waiting for a
+// network lookup. Returns null when there is no usable sibling (the picker then
+// falls back to its existing typeahead/lookup behaviour).
+export function fkSeedOption(field, value, record) {
+    if (value === undefined || value === null || value === '')
+        return null;
+    const sib = relationSiblingValue(field, record);
+    const label = typeof sib === 'string' ? sib : objectLabel(sib);
+    if (!label)
+        return null;
+    const id = String(value);
+    return {
+        id,
+        value: id,
+        label,
+        name: label,
+        image: pickImage(sib) ?? null,
+    };
+}
 // servedOption matches a field's served option list (enum/select with
 // {value,label,color,icon,image}) against the current value.
 function servedOption(field, value) {
@@ -454,7 +499,7 @@ function LoadingSkeleton() {
 }
 function FieldRow({ field, record, value, mode, onChange }) {
     const isReadonly = field.readonly || mode === 'view';
-    return (_jsxs("div", { className: "flex flex-col gap-1.5", children: [_jsxs(Label, { className: "text-xs font-medium text-muted-foreground uppercase tracking-wide", children: [field.label, field.required && mode !== 'view' && (_jsx("span", { className: "text-destructive ml-0.5", children: "*" }))] }), isReadonly ? (_jsx(ViewValue, { field: field, value: value, record: record })) : (_jsx(EditField, { field: field, value: value, onChange: onChange }))] }));
+    return (_jsxs("div", { className: "flex flex-col gap-1.5", children: [_jsxs(Label, { className: "text-xs font-medium text-muted-foreground uppercase tracking-wide", children: [field.label, field.required && mode !== 'view' && (_jsx("span", { className: "text-destructive ml-0.5", children: "*" }))] }), isReadonly ? (_jsx(ViewValue, { field: field, value: value, record: record })) : (_jsx(EditField, { field: field, value: value, onChange: onChange, record: record }))] }));
 }
 // RelationViewValue — read-only FK lead. Resolves the relation's label + image
 // from (1) the sibling object the table served, then (2) the canonical options
@@ -628,7 +673,15 @@ function StructuredViewValue({ value, field, locale, t, }) {
     }
     return (_jsx("div", { className: "text-sm py-1", children: _jsx(CollectionCell, { value: value, itemFields: field?.itemFields ?? field?.item_fields, variant: "inline", locale: locale, t: t }) }));
 }
-function EditField({ field, value, onChange }) {
+export function EditField({ field, value, onChange, record }) {
+    const { t, i18n } = useTranslation();
+    // Jsonb line-items columns (e.g. Transfer.items) are action-built documents:
+    // editing the array field-by-field is out of scope. Render them READ-ONLY
+    // with the same inline table the detail view uses — a localized, ref-resolved
+    // mini-table — instead of an input that stringifies to "[object Object]".
+    if (isLineItemsField(field, value)) {
+        return (_jsxs("div", { className: "space-y-1", children: [_jsx("div", { className: "rounded-md border bg-muted/30 p-2", children: _jsx(CollectionCell, { value: value, itemFields: fieldItemFields(field), variant: "inline", locale: i18n.language, t: t }) }), _jsx("p", { className: "text-[11px] text-muted-foreground", children: t('datatable.readOnly', { defaultValue: 'Solo lectura' }) })] }));
+    }
     if (field.type === 'boolean') {
         return (_jsxs("div", { className: "flex items-center gap-2 py-1", children: [_jsx(Switch, { checked: !!value, onCheckedChange: onChange }), _jsx("span", { className: "text-sm text-muted-foreground", children: value ? 'Sí' : 'No' })] }));
     }
@@ -645,7 +698,12 @@ function EditField({ field, value, onChange }) {
     // option thumbnails and the inline-create "+" — against /api/options/<ref>.
     // Static inline `options` are handled by the enum <Select> branch below.
     if ((getFieldRef(field) || field.widget === 'dynamic_select') && !field.options?.length) {
-        return _jsx(DynamicSelectField, { field: field, value: value, onChange: onChange });
+        return (_jsx(DynamicSelectField, { field: field, value: value, onChange: onChange, 
+            // Seed the trigger with the related record's NAME (from the
+            // backend-injected FK sibling, key without `_id`) so an existing
+            // selection shows the label, not the raw uuid — without waiting
+            // for the popover to open and fetch a page.
+            seedOption: fkSeedOption(field, value, record) }));
     }
     if (field.type === 'search' && field.searchEndpoint) {
         return _jsx(SearchField, { field: field, value: value, onChange: onChange });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "18.22.0",
+  "version": "18.23.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",
@@ -64,8 +64,8 @@
     "typescript": "^6.0.0",
     "vitest": "^4.0.0",
     "zustand": "^5.0.0",
-    "@asteby/metacore-ui": "2.5.2",
-    "@asteby/metacore-sdk": "3.2.0"
+    "@asteby/metacore-sdk": "3.2.0",
+    "@asteby/metacore-ui": "2.5.2"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/src/__tests__/edit-field-polish.test.tsx

@@ -0,0 +1,170 @@
+// @vitest-environment happy-dom
+//
+// Record EDIT dialog polish (mode='edit'), affecting every module that uses the
+// generic dialog (transfers, orders, customers):
+//   PART 1 — a jsonb line-items field renders READ-ONLY as the inline table
+//            (the detail-view renderer), never an input that stringifies to
+//            "[object Object]".
+//   PART 2 — a FK select seeds its trigger from the backend-injected relation
+//            sibling (`source_warehouse_id` → `source_warehouse: {value,label}`)
+//            so an existing selection shows the related record's NAME, not the
+//            raw uuid.
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { cleanup, render, screen } from '@testing-library/react'
+
+// Identity translator (so `defaultValue` surfaces) + Spanish locale.
+vi.mock('react-i18next', () => ({
+    useTranslation: () => ({
+        t: (k: string, o?: any) => o?.defaultValue ?? k,
+        i18n: { language: 'es' },
+    }),
+}))
+
+import { EditField, isLineItemsField, fkSeedOption } from '../dialogs/dynamic-record'
+import { ApiProvider, type ApiClient } from '../api-context'
+
+afterEach(cleanup)
+
+const noopApi = { get: vi.fn(async () => ({ data: { data: [] } })) } as unknown as ApiClient
+
+describe('isLineItemsField', () => {
+    it('matches a field with a declared item_fields schema', () => {
+        expect(
+            isLineItemsField(
+                { key: 'items', label: 'Items', type: 'json', itemFields: [{ key: 'q', label: 'Q' }] },
+                null,
+            ),
+        ).toBe(true)
+        // snake_case alias
+        expect(
+            isLineItemsField(
+                { key: 'items', label: 'Items', type: 'json', item_fields: [{ key: 'q', label: 'Q' }] },
+                null,
+            ),
+        ).toBe(true)
+    })
+
+    it('matches any array / plain-object value (would stringify to [object Object])', () => {
+        expect(isLineItemsField({ key: 'items', label: 'Items', type: 'json' }, [{ a: 1 }])).toBe(true)
+        expect(isLineItemsField({ key: 'data', label: 'Data', type: 'json' }, { a: 1 })).toBe(true)
+    })
+
+    it('does NOT match scalars or dedicated editable widgets', () => {
+        expect(isLineItemsField({ key: 'name', label: 'Name', type: 'text' }, 'hi')).toBe(false)
+        expect(isLineItemsField({ key: 'n', label: 'N', type: 'number' }, 5)).toBe(false)
+        expect(isLineItemsField({ key: 'photo', label: 'Photo', type: 'image' }, { url: 'x' })).toBe(false)
+        expect(isLineItemsField({ key: 'f', label: 'F', type: 'text', widget: 'upload' }, {})).toBe(false)
+        expect(isLineItemsField({ key: 'when', label: 'When', type: 'date' }, new Date())).toBe(false)
+    })
+})
+
+describe('fkSeedOption', () => {
+    const field = { key: 'source_warehouse_id', label: 'Origen', type: 'text', ref: 'warehouses' }
+
+    it('builds a seed option from the injected {value,label} sibling', () => {
+        const seed = fkSeedOption(field, 'wh-1', {
+            source_warehouse_id: 'wh-1',
+            source_warehouse: { value: 'wh-1', label: 'Test2', image: 'logo.png' },
+        })
+        expect(seed).toEqual({ id: 'wh-1', value: 'wh-1', label: 'Test2', name: 'Test2', image: 'logo.png' })
+    })
+
+    it('returns null when there is no usable sibling', () => {
+        expect(fkSeedOption(field, 'wh-1', { source_warehouse_id: 'wh-1' })).toBeNull()
+        expect(fkSeedOption(field, '', {})).toBeNull()
+        expect(fkSeedOption(field, null, { source_warehouse: { label: 'x' } })).toBeNull()
+    })
+})
+
+describe('EditField — PART 1: jsonb line-items read-only', () => {
+    it('renders the inline table (read-only), not an input or [object Object]', () => {
+        const onChange = vi.fn()
+        const { container } = render(
+            <ApiProvider client={noopApi}>
+                <EditField
+                    field={{
+                        key: 'items',
+                        label: 'Items',
+                        type: 'json',
+                        itemFields: [
+                            { key: 'product_id', label: 'Producto', ref: 'Product' },
+                            { key: 'quantity', label: 'Cantidad' },
+                        ],
+                    }}
+                    value={[
+                        {
+                            product_id: '550e8400-e29b-41d4-a716-446655440000',
+                            product: { value: 'x', label: 'Test' },
+                            quantity: 10,
+                        },
+                    ]}
+                    onChange={onChange}
+                    record={{}}
+                />
+            </ApiProvider>,
+        )
+        // Localized headers + resolved ref label from the inline CollectionCell.
+        expect(screen.getByRole('columnheader', { name: 'Producto' })).toBeTruthy()
+        expect(screen.getByRole('cell', { name: 'Test' })).toBeTruthy()
+        expect(screen.getByRole('cell', { name: '10' })).toBeTruthy()
+        // No editable input, no [object Object], no leaked uuid, read-only hint.
+        expect(container.querySelector('input')).toBeNull()
+        expect(container.querySelector('textarea')).toBeNull()
+        expect(container.textContent).not.toContain('[object Object]')
+        expect(container.textContent).not.toContain('550e8400-e29b')
+        expect(screen.getByText('Solo lectura')).toBeTruthy()
+    })
+
+    it('renders a bare jsonb object read-only (no schema) instead of [object Object]', () => {
+        const { container } = render(
+            <ApiProvider client={noopApi}>
+                <EditField
+                    field={{ key: 'fiscal_data', label: 'Fiscal', type: 'json' }}
+                    value={{ price: 10, quantity: 20 }}
+                    onChange={vi.fn()}
+                    record={{}}
+                />
+            </ApiProvider>,
+        )
+        expect(container.querySelector('input')).toBeNull()
+        expect(container.textContent).not.toContain('[object Object]')
+        expect(screen.getByText('Precio:')).toBeTruthy()
+    })
+})
+
+describe('EditField — PART 2: FK select shows the resolved label', () => {
+    it('seeds the trigger with the sibling label, not the raw uuid', () => {
+        render(
+            <ApiProvider client={noopApi}>
+                <EditField
+                    field={{ key: 'source_warehouse_id', label: 'Origen', type: 'text', ref: 'warehouses' }}
+                    value={'550e8400-e29b-41d4-a716-446655440000'}
+                    onChange={vi.fn()}
+                    record={{
+                        source_warehouse_id: '550e8400-e29b-41d4-a716-446655440000',
+                        source_warehouse: { value: '550e8400-e29b-41d4-a716-446655440000', label: 'Test2' },
+                    }}
+                />
+            </ApiProvider>,
+        )
+        // The combobox trigger shows the resolved label.
+        expect(screen.getByText('Test2')).toBeTruthy()
+        // The raw uuid is not shown.
+        expect(screen.queryByText('550e8400-e29b-41d4-a716-446655440000')).toBeNull()
+    })
+
+    it('keeps the raw value as fallback when no sibling was injected', () => {
+        render(
+            <ApiProvider client={noopApi}>
+                <EditField
+                    field={{ key: 'source_warehouse_id', label: 'Origen', type: 'text', ref: 'warehouses' }}
+                    value={'wh-xyz'}
+                    onChange={vi.fn()}
+                    record={{ source_warehouse_id: 'wh-xyz' }}
+                />
+            </ApiProvider>,
+        )
+        // No sibling → existing behaviour: the raw value is shown on the trigger.
+        expect(screen.getByText('wh-xyz')).toBeTruthy()
+    })
+})

package/src/dialogs/dynamic-record.tsx

@@ -294,6 +294,51 @@ function relationSiblingValue(field: FieldDef, record: any): any {
     return undefined
 }
 
+// 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 {
+    return field.itemFields ?? field.item_fields
+}
+
+// isLineItemsField — a jsonb line-items column (e.g. Transfer.items): it either
+// declares an `item_fields` schema, or its value is a structured array/object.
+// These are action-built documents; field-by-field editing of the array is out
+// of scope, so the edit dialog renders them read-only (the inline table) rather
+// than an input that would stringify to "[object Object]". Scalars and known
+// editable widgets (media/upload, color, dates) are NOT line-items.
+export function isLineItemsField(field: FieldDef, value: any): boolean {
+    if (field.type === 'image' || field.widget === 'upload') return false
+    if (fieldItemFields(field)?.length) return true
+    if (Array.isArray(value)) return true
+    return (
+        value !== null &&
+        typeof value === 'object' &&
+        !(value instanceof Date)
+    )
+}
+
+// fkSeedOption builds the pre-resolved option for a FK select's CURRENT value
+// from the relation sibling the backend injected alongside the column
+// (`source_warehouse_id` → `source_warehouse = {value,label,image?}`, the key
+// without `_id`; same convention as the jsonb refs). Lets the edit picker show
+// the related record's NAME instead of the raw uuid without waiting for a
+// network lookup. Returns null when there is no usable sibling (the picker then
+// falls back to its existing typeahead/lookup behaviour).
+export function fkSeedOption(field: FieldDef, value: any, record: any): ResolvedOption | null {
+    if (value === undefined || value === null || value === '') return null
+    const sib = relationSiblingValue(field, record)
+    const label = typeof sib === 'string' ? sib : objectLabel(sib)
+    if (!label) return null
+    const id = String(value)
+    return {
+        id,
+        value: id,
+        label,
+        name: label,
+        image: pickImage(sib) ?? null,
+    }
+}
+
 // servedOption matches a field's served option list (enum/select with
 // {value,label,color,icon,image}) against the current value.
 function servedOption(field: FieldDef, value: any): FieldOption | undefined {
@@ -846,7 +891,7 @@ function FieldRow({ field, record, value, mode, onChange }: FieldRowProps) {
             {isReadonly ? (
                 <ViewValue field={field} value={value} record={record} />
             ) : (
-                <EditField field={field} value={value} onChange={onChange} />
+                <EditField field={field} value={value} onChange={onChange} record={record} />
             )}
         </div>
     )
@@ -1161,11 +1206,38 @@ function StructuredViewValue({
     )
 }
 
-function EditField({ field, value, onChange }: {
+export function EditField({ field, value, onChange, record }: {
     field: FieldDef
     value: any
     onChange: (val: any) => void
+    /** The full record being edited — supplies FK relation siblings + line-items. */
+    record?: any
 }) {
+    const { t, i18n } = useTranslation()
+
+    // Jsonb line-items columns (e.g. Transfer.items) are action-built documents:
+    // editing the array field-by-field is out of scope. Render them READ-ONLY
+    // with the same inline table the detail view uses — a localized, ref-resolved
+    // mini-table — instead of an input that stringifies to "[object Object]".
+    if (isLineItemsField(field, value)) {
+        return (
+            <div className="space-y-1">
+                <div className="rounded-md border bg-muted/30 p-2">
+                    <CollectionCell
+                        value={value}
+                        itemFields={fieldItemFields(field)}
+                        variant="inline"
+                        locale={i18n.language}
+                        t={t}
+                    />
+                </div>
+                <p className="text-[11px] text-muted-foreground">
+                    {t('datatable.readOnly', { defaultValue: 'Solo lectura' })}
+                </p>
+            </div>
+        )
+    }
+
     if (field.type === 'boolean') {
         return (
             <div className="flex items-center gap-2 py-1">
@@ -1202,7 +1274,18 @@ function EditField({ field, value, onChange }: {
     // option thumbnails and the inline-create "+" — against /api/options/<ref>.
     // Static inline `options` are handled by the enum <Select> branch below.
     if ((getFieldRef(field as ActionFieldDef) || field.widget === 'dynamic_select') && !field.options?.length) {
-        return <DynamicSelectField field={field as ActionFieldDef} value={value} onChange={onChange} />
+        return (
+            <DynamicSelectField
+                field={field as ActionFieldDef}
+                value={value}
+                onChange={onChange}
+                // Seed the trigger with the related record's NAME (from the
+                // backend-injected FK sibling, key without `_id`) so an existing
+                // selection shows the label, not the raw uuid — without waiting
+                // for the popover to open and fetch a page.
+                seedOption={fkSeedOption(field, value, record)}
+            />
+        )
     }
 
     if (field.type === 'search' && field.searchEndpoint) {