@asteby/metacore-runtime-react 28.3.7 → 28.4.1

package/dist/types.d.ts

@@ -271,6 +271,17 @@ export interface ColumnDefinition {
     itemFields?: ColumnItemField[];
     /** snake_case alias served by the kernel for `itemFields`. */
     item_fields?: ColumnItemField[];
+    /**
+     * Conditional visibility in the create/edit modal: render this field only
+     * when a sibling field's current value matches the predicate. Mirrors the
+     * kernel v3 `Column.visible_when` (projected onto the served ColumnDef).
+     * Tolerates the camelCase alias. Absent = always visible; a hidden field is
+     * skipped by the required-gate so it never blocks submit. See
+     * `evaluateVisibleWhen`.
+     */
+    visible_when?: VisibleWhen;
+    /** camelCase alias for `visible_when`. */
+    visibleWhen?: VisibleWhen;
 }
 /**
  * One declared sub-field of a jsonb line-items column (see
@@ -290,6 +301,20 @@ export interface ActionCondition {
     operator: 'eq' | 'neq' | 'in' | 'not_in';
     value: string | string[];
 }
+/**
+ * Conditional-visibility predicate for a create/edit form field. Mirrors the
+ * kernel v3 `visible_when` block (json `visible_when`): the owning field is
+ * rendered only when the SIBLING field named by `field` holds a value that
+ * matches — either equal to `equals` (exact string) OR a member of `in`
+ * (any-of). When both are set `in` wins. Absent = the field is always visible
+ * (retrocompat). Evaluated by `evaluateVisibleWhen` against the live form
+ * values; a hidden field never gates submit (its required-check is skipped).
+ */
+export interface VisibleWhen {
+    field: string;
+    equals?: string;
+    in?: string[];
+}
 export interface FieldValidation {
     regex?: string;
     min?: number;
@@ -442,6 +467,16 @@ export interface ActionFieldDef {
     storagePath?: string;
     /** snake_case alias served by the kernel manifest for `storagePath`. */
     storage_path?: string;
+    /**
+     * Conditional visibility: render this field only when a sibling field's
+     * current value matches the predicate. Mirrors the kernel v3
+     * `ActionField.visible_when`. Tolerates the camelCase alias. Absent = always
+     * visible; a hidden field is skipped by the required-gate so it never blocks
+     * submit. See `evaluateVisibleWhen`.
+     */
+    visible_when?: VisibleWhen;
+    /** camelCase alias for `visible_when`. */
+    visibleWhen?: VisibleWhen;
 }
 /**
  * Declarative reconciliation constraint on a line-items field: the summed value

package/dist/types.d.ts.map

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

package/package.json

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

package/src/__tests__/dynamic-relation-subtable-context.test.tsx

@@ -0,0 +1,74 @@
+// @vitest-environment happy-dom
+//
+// `lineSubtable` scopes the audit/system-column hiding to the view-modal
+// line-subtable context. On a standalone detail page (default, lineSubtable
+// omitted) the relation panel keeps the previous behaviour and still renders
+// audit columns (created_at, created_by, …). Inside the view modal the host
+// passes `lineSubtable` and those redundant columns are dropped.
+//
+// Guards against the regression CodeRabbit flagged on SDK #659: the audit
+// filter was applied unconditionally to every DynamicRelation, hiding those
+// columns on full detail pages too.
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { cleanup, render, screen, waitFor } from '@testing-library/react'
+import { DynamicRelation } from '../dynamic-relation'
+import { ApiProvider, type ApiClient } from '../api-context'
+
+afterEach(cleanup)
+
+const META = {
+    name: 'line_item',
+    columns: [
+        { key: 'id', label: 'ID', type: 'text', sortable: true, filterable: false, hidden: true },
+        { key: 'invoice_id', label: 'Factura', type: 'text', sortable: false, filterable: false },
+        { key: 'sku', label: 'SKU', type: 'text', sortable: true, filterable: true },
+        { key: 'created_at', label: 'Creado', type: 'datetime', sortable: true, filterable: false },
+    ],
+    actions: [],
+    hasActions: false,
+    enableCRUDActions: false,
+}
+
+const DATA = [{ id: 'li_1', invoice_id: 'inv_42', sku: 'A-1', created_at: '2026-01-01T00:00:00Z' }]
+
+function mockApi(): ApiClient {
+    return {
+        get: vi.fn((url: string) => {
+            if (url.startsWith('/metadata/table/')) {
+                return Promise.resolve({ data: { success: true, data: META } })
+            }
+            return Promise.resolve({ data: { success: true, data: DATA } })
+        }),
+        post: vi.fn(() => Promise.resolve({ data: { success: true, data: {} } })),
+        put: vi.fn(() => Promise.resolve({ data: { success: true, data: {} } })),
+        delete: vi.fn(() => Promise.resolve({ data: { success: true, data: {} } })),
+    }
+}
+
+function renderPanel(extra: Record<string, unknown>) {
+    return render(
+        <ApiProvider client={mockApi()}>
+            <DynamicRelation
+                kind="one_to_many"
+                model="line_item"
+                foreignKey="invoice_id"
+                parentId="inv_42"
+                {...extra}
+            />
+        </ApiProvider>,
+    )
+}
+
+describe('DynamicRelation — lineSubtable context', () => {
+    it('página de detalle (default): conserva la columna de auditoría created_at', async () => {
+        renderPanel({})
+        await waitFor(() => expect(screen.getByText('A-1')).toBeTruthy())
+        expect(screen.getByText('Creado')).toBeTruthy()
+    })
+
+    it('sub-tabla del modal de vista (lineSubtable): oculta created_at', async () => {
+        renderPanel({ lineSubtable: true })
+        await waitFor(() => expect(screen.getByText('A-1')).toBeTruthy())
+        expect(screen.queryByText('Creado')).toBeNull()
+    })
+})

package/src/__tests__/visible-when.test.ts

@@ -0,0 +1,63 @@
+import { describe, it, expect } from 'vitest'
+import { evaluateVisibleWhen, getVisibleWhen } from '../dynamic-form-schema'
+import type { VisibleWhen } from '../types'
+
+// The discount_rules use case: a `rule_scope` field decides which picker shows.
+const equalsProduct: VisibleWhen = { field: 'rule_scope', equals: 'product' }
+const inCategory: VisibleWhen = { field: 'rule_scope', in: ['category'] }
+const inMulti: VisibleWhen = { field: 'scope', in: ['a', 'b'] }
+
+describe('evaluateVisibleWhen', () => {
+    it('no predicate → always visible', () => {
+        expect(evaluateVisibleWhen(undefined, { rule_scope: 'all' })).toBe(true)
+        expect(evaluateVisibleWhen(null, {})).toBe(true)
+    })
+
+    it('empty field → always visible (no-op)', () => {
+        expect(evaluateVisibleWhen({ field: '' } as VisibleWhen, { rule_scope: 'x' })).toBe(true)
+    })
+
+    it('`equals` matches the sibling value exactly', () => {
+        expect(evaluateVisibleWhen(equalsProduct, { rule_scope: 'product' })).toBe(true)
+        expect(evaluateVisibleWhen(equalsProduct, { rule_scope: 'category' })).toBe(false)
+        expect(evaluateVisibleWhen(equalsProduct, { rule_scope: 'all' })).toBe(false)
+    })
+
+    it('`in` matches membership; wins over `equals` when both present', () => {
+        expect(evaluateVisibleWhen(inCategory, { rule_scope: 'category' })).toBe(true)
+        expect(evaluateVisibleWhen(inCategory, { rule_scope: 'product' })).toBe(false)
+        expect(evaluateVisibleWhen(inMulti, { scope: 'b' })).toBe(true)
+        const both: VisibleWhen = { field: 'rule_scope', equals: 'product', in: ['category'] }
+        // `in` wins: category matches, product does not.
+        expect(evaluateVisibleWhen(both, { rule_scope: 'category' })).toBe(true)
+        expect(evaluateVisibleWhen(both, { rule_scope: 'product' })).toBe(false)
+    })
+
+    it('missing / null sibling value compares as empty string', () => {
+        expect(evaluateVisibleWhen(equalsProduct, {})).toBe(false)
+        expect(evaluateVisibleWhen(equalsProduct, { rule_scope: null })).toBe(false)
+        expect(evaluateVisibleWhen({ field: 'x', equals: '' } as VisibleWhen, {})).toBe(true)
+    })
+
+    it('coerces non-string sibling values before comparison', () => {
+        expect(evaluateVisibleWhen({ field: 'n', equals: '5' } as VisibleWhen, { n: 5 })).toBe(true)
+        expect(evaluateVisibleWhen({ field: 'b', in: ['true'] } as VisibleWhen, { b: true })).toBe(true)
+    })
+
+    it('predicate naming a field but no comparison → visible', () => {
+        expect(evaluateVisibleWhen({ field: 'rule_scope' } as VisibleWhen, { rule_scope: 'all' })).toBe(true)
+    })
+})
+
+describe('getVisibleWhen', () => {
+    it('reads snake_case and camelCase aliases', () => {
+        expect(getVisibleWhen({ visible_when: equalsProduct })).toEqual(equalsProduct)
+        expect(getVisibleWhen({ visibleWhen: inCategory })).toEqual(inCategory)
+    })
+
+    it('returns undefined for none / malformed', () => {
+        expect(getVisibleWhen(undefined)).toBeUndefined()
+        expect(getVisibleWhen({})).toBeUndefined()
+        expect(getVisibleWhen({ visible_when: { equals: 'x' } as unknown as VisibleWhen })).toBeUndefined()
+    })
+})

package/src/action-modal-dispatcher.tsx

@@ -686,7 +686,7 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
                         })}
                         {relations.length > 0 && (
                             <FieldCell fullWidth>
-                                <DynamicRelations record={record} relations={relations} />
+                                <DynamicRelations record={record} relations={relations} lineSubtable />
                             </FieldCell>
                         )}
                     </FieldGrid>

package/src/dashboard-grid.tsx

@@ -164,7 +164,11 @@ export function DashboardGrid({
                     // box auto-height and the tiles collapse into a strip — so we own
                     // the height here instead of hoping the dashboard layout supplies
                     // one.
-                    'h-[clamp(420px,60vh,720px)] w-full rounded-xl border border-dashed border-border/60 p-4',
+                    // No dashed border / padding wrapper: the skeleton tiles ARE
+                    // cards (same anatomy as the real widgets), so the mockup
+                    // should float exactly like the loaded dashboard, not sit
+                    // inside a boxed placeholder. Keep only the definite height.
+                    'h-[clamp(420px,60vh,720px)] w-full',
                     className,
                 )}
             >

package/src/dialogs/dynamic-record.tsx

@@ -52,7 +52,8 @@ import { toastServerError, extractFieldErrors, localizeFieldIssue } from '../ser
 import { DynamicSelectField, OptionLead, OptionThumb } from '../dynamic-select-field'
 import { DynamicRelations } from '../dynamic-relations'
 import { useOptionsResolver, type ResolvedOption } from '../use-options-resolver'
-import { getFieldRef } from '../dynamic-form-schema'
+import { getFieldRef, getVisibleWhen, evaluateVisibleWhen } from '../dynamic-form-schema'
+import type { VisibleWhen } from '../types'
 import { FieldCell } from '../field-grid'
 import { isNilUuid, normalizeNilUuid } from '../nil-uuid'
 import { normalizeRefFieldsForSubmit } from './normalize-submit'
@@ -146,6 +147,17 @@ export interface FieldDef {
     itemFields?: ItemField[]
     /** snake_case alias served by the kernel for `itemFields`. */
     item_fields?: ItemField[]
+    /**
+     * Conditional visibility: render — and required-check — this field only
+     * while a sibling field's current value matches the predicate. Mirrors the
+     * kernel v3 `visible_when` (projected onto the served modal FieldDef).
+     * Tolerates the camelCase alias. Absent = always visible; a hidden field is
+     * dropped from the required-gate so it never blocks submit. Evaluated by
+     * `evaluateVisibleWhen` against the live form values.
+     */
+    visible_when?: VisibleWhen
+    /** camelCase alias for `visible_when`. */
+    visibleWhen?: VisibleWhen
 }
 
 // Permissive shape: the wire payload may omit some fields (e.g. `title` is
@@ -458,13 +470,22 @@ export function isMoneyField(field: FieldDef, value: any): boolean {
 // given mode. `hidden` fields never render. A `readonly` (server/system-
 // generated) field is EXCLUDED on create — the user can't set a value the
 // server will overwrite — but stays visible on edit/view (rendered disabled).
+//
+// `formValues`, when provided, additionally applies each field's `visible_when`
+// predicate against the live form values (conditional visibility): a field is
+// dropped while the referenced sibling's value does not match. Driving both the
+// render and the required-gate off this same list means a hidden field never
+// blocks submit. Omitting `formValues` keeps the legacy (always-visible)
+// behaviour for callers that only gate on mode.
 export function filterVisibleFields(
     fields: FieldDef[] | undefined,
     mode: 'view' | 'edit' | 'create',
+    formValues?: Record<string, any>,
 ): FieldDef[] {
     return (fields ?? []).filter(f => {
         if (f.hidden) return false
         if (mode === 'create' && f.readonly) return false
+        if (formValues && !evaluateVisibleWhen(getVisibleWhen(f), formValues)) return false
         return true
     })
 }
@@ -711,9 +732,12 @@ export function DynamicRecordDialog({
 
         if (isEditable) {
             // Collect ALL missing required fields (not just the first) and mark
-            // each inline instead of a single toast.
+            // each inline instead of a single toast. Only CURRENTLY-VISIBLE
+            // fields are gated: a field hidden by its `visible_when` predicate
+            // must not block submit even when it is declared required (matching
+            // the render, which drops it via the same filter).
             const missing: Record<string, string> = {}
-            for (const field of modalMeta.fields ?? []) {
+            for (const field of filterVisibleFields(modalMeta.fields, mode, formValues)) {
                 if (field.required && !formValues[field.key] && formValues[field.key] !== 0 && formValues[field.key] !== false) {
                     missing[field.key] = localizeFieldIssue({ code: 'required' }, field.label, t)
                 }
@@ -803,7 +827,7 @@ export function DynamicRecordDialog({
 
     const title = modalMeta ? config.getTitle(modalMeta, t) : ''
 
-    const visibleFields = filterVisibleFields(modalMeta?.fields, mode)
+    const visibleFields = filterVisibleFields(modalMeta?.fields, mode, formValues)
 
     return (
         <Dialog open={open} onOpenChange={onOpenChange}>
@@ -881,6 +905,7 @@ export function DynamicRecordDialog({
                                     <DynamicRelations
                                         record={record}
                                         relations={relations}
+                                        lineSubtable
                                         canCreate={mode === 'edit'}
                                         canEdit={mode === 'edit'}
                                         canDelete={mode === 'edit'}

package/src/dynamic-form-schema.ts

@@ -2,7 +2,7 @@
 // callers (and unit tests) can use the zod schema without pulling in React or
 // metacore-ui primitives.
 import { z, type ZodTypeAny } from 'zod'
-import type { ActionFieldDef, FieldValidation, FieldOptionsConfig, OptionDef } from './types'
+import type { ActionFieldDef, FieldValidation, FieldOptionsConfig, OptionDef, VisibleWhen } from './types'
 import { resolveValidatorToken } from './use-org-config-bridge'
 
 /**
@@ -335,6 +335,52 @@ export function applyOptionWhen(
     })
 }
 
+/**
+ * Reads a field's `visible_when` predicate, tolerating the camelCase alias
+ * (`visibleWhen`) an app may author and the snake_case (`visible_when`) the
+ * kernel serves. Returns `undefined` when the field declares neither.
+ */
+export function getVisibleWhen(
+    field: { visible_when?: VisibleWhen; visibleWhen?: VisibleWhen } | null | undefined,
+): VisibleWhen | undefined {
+    if (!field) return undefined
+    const vw = field.visible_when ?? field.visibleWhen
+    return vw && typeof vw === 'object' && typeof vw.field === 'string' ? vw : undefined
+}
+
+/**
+ * Evaluates a `visible_when` predicate against the current flat form values.
+ * Pure — no React, no side effects.
+ *
+ * - No predicate → `true` (the field is always visible; retrocompat).
+ * - With a predicate: read the value of the sibling `cond.field` from
+ *   `formValues` (as string, null/undefined → ''). Visible when it is a member
+ *   of `cond.in` (any-of, wins when present) OR equals `cond.equals`. A
+ *   predicate with an empty `field` is a no-op (visible). A predicate that
+ *   names a field but declares neither `in` nor `equals` hides nothing
+ *   (visible) — nothing to gate on.
+ *
+ * `cond` may be the raw block off either the snake_case or camelCase slot; use
+ * `getVisibleWhen` to normalize first.
+ */
+export function evaluateVisibleWhen(
+    cond: VisibleWhen | null | undefined,
+    formValues: Record<string, any> | null | undefined,
+): boolean {
+    if (!cond || typeof cond.field !== 'string' || cond.field.trim() === '') return true
+    const raw = formValues ? formValues[cond.field.trim()] : undefined
+    const current = raw == null ? '' : String(raw)
+    const inList = cond.in
+    if (Array.isArray(inList) && inList.length > 0) {
+        return inList.some((v) => String(v) === current)
+    }
+    if (typeof cond.equals === 'string') {
+        return cond.equals === current
+    }
+    // Named a field but declared no comparison → nothing to gate on.
+    return true
+}
+
 /**
  * Reads a field's enriched options-resolution config, tolerating the camelCase
  * `optionsConfig` (authored SDK shape) and the snake_case `options_config` the

package/src/dynamic-form.tsx

@@ -22,6 +22,8 @@ import {
     evaluateBalance,
     applyOptionWhen,
     getDependsOn,
+    getVisibleWhen,
+    evaluateVisibleWhen,
 } from './dynamic-form-schema'
 import { useOptionsResolver, type ResolvedOption } from './use-options-resolver'
 import { DynamicLineItems } from './dynamic-line-items'
@@ -70,19 +72,30 @@ export function DynamicForm({
         [fields],
     )
 
-    const schema = useMemo(() => buildZodSchema(editableFields), [editableFields])
+    // Conditional visibility: a field carrying `visible_when` is rendered — and
+    // validated — only while the referenced sibling field's current value
+    // matches the predicate. Driving BOTH the schema and the render off the same
+    // filtered list means a hidden field never blocks submit (its required-gate
+    // is dropped with it), matching the primitive's contract. Fields with no
+    // `visible_when` are always kept (retrocompat).
+    const visibleFields = useMemo(
+        () => editableFields.filter((f) => evaluateVisibleWhen(getVisibleWhen(f), values)),
+        [editableFields, values],
+    )
+
+    const schema = useMemo(() => buildZodSchema(visibleFields), [visibleFields])
 
     // Line-items fields carrying a balance rule gate submit: an unbalanced entry
     // (Σdebit ≠ Σcredit, or all-zero when require_nonzero) can't be saved. This
     // is fully declarative — `evaluateBalance` returns undefined for fields with
     // no rule, so non-balanced forms are unaffected.
     const balanceBlocked = useMemo(() => {
-        for (const f of editableFields) {
+        for (const f of visibleFields) {
             const state = evaluateBalance(f, values[f.key])
             if (state && !state.balanced) return true
         }
         return false
-    }, [editableFields, values])
+    }, [visibleFields, values])
 
     useEffect(() => {
         const defaults: Record<string, any> = {}
@@ -125,7 +138,7 @@ export function DynamicForm({
     return (
         <form onSubmit={handleSubmit} className="grid gap-4">
             <div className="grid gap-4 sm:grid-cols-2">
-                {editableFields.map((field) => (
+                {visibleFields.map((field) => (
                     <FieldRow
                         key={field.key}
                         field={field}

package/src/dynamic-relation.tsx

@@ -48,7 +48,7 @@ import { useTimeZone, useCurrency } from './org-runtime-context'
 import { makeDefaultGetDynamicColumns } from './dynamic-columns'
 import { isColumnVisibleInLineSubtable } from './column-visibility'
 import { useOptionsResolver } from './use-options-resolver'
-import type { ApiResponse, TableMetadata } from './types'
+import type { ApiResponse, ColumnDefinition, TableMetadata } from './types'
 import {
     buildCreatePayload,
     buildPivotAttachPayload,
@@ -120,6 +120,18 @@ interface CommonProps {
     filters?: Record<string, string>
     /** Hidden columns; el FK siempre se oculta automáticamente. */
     hiddenColumns?: string[]
+    /**
+     * Contexto de sub-tabla de líneas dentro del MODAL de vista de un registro
+     * padre. Cuando es true se aplican las reglas de {@link isColumnVisibleInLineSubtable}
+     * — se ocultan por defecto las columnas de auditoría/sistema (created_by,
+     * timestamps, organization_id) y las scopeadas a `visibility: "table"`, que
+     * son ruido redundante bajo el registro padre.
+     *
+     * Default false: en una página de detalle autónoma (`/m/<model>/<id>`) el
+     * panel de relación conserva el comportamiento previo (solo oculta FK, scope
+     * y columnas `hidden`), donde esas columnas SÍ son útiles.
+     */
+    lineSubtable?: boolean
     /** Permisos visibles. Default true. */
     canCreate?: boolean
     canDelete?: boolean
@@ -191,6 +203,7 @@ function OneToManyRelation({
     filters,
     endpoint,
     hiddenColumns = [],
+    lineSubtable = false,
     canCreate = true,
     canDelete = true,
     canEdit = true,
@@ -266,13 +279,17 @@ function OneToManyRelation({
         // Hide the FK and every scope column — they're fixed for this parent and
         // would just render the same value on every row.
         const hidden = new Set([foreignKey, ...Object.keys(filters || {}), ...hiddenColumns])
-        // isColumnVisibleInLineSubtable additionally drops `hidden`/table-scoped
-        // columns AND the audit/system noise (created_by, timestamps, org_id)
-        // that's redundant under a parent record — see column-visibility.ts.
-        return metadata.columns.filter(
-            c => !hidden.has(c.key) && isColumnVisibleInLineSubtable(c),
-        )
-    }, [metadata, foreignKey, filtersKey, hiddenColumns])
+        // In the view-modal line-subtable context, isColumnVisibleInLineSubtable
+        // additionally drops `hidden`/table-scoped columns AND the audit/system
+        // noise (created_by, timestamps, org_id) that's redundant under a parent
+        // record — see column-visibility.ts. Outside that context (standalone
+        // detail page) we keep the previous behaviour and only drop `hidden`
+        // columns, so those columns still show where they're useful.
+        const keep = lineSubtable
+            ? (c: ColumnDefinition) => !hidden.has(c.key) && isColumnVisibleInLineSubtable(c)
+            : (c: ColumnDefinition) => !hidden.has(c.key) && !c.hidden
+        return metadata.columns.filter(keep)
+    }, [metadata, foreignKey, filtersKey, hiddenColumns, lineSubtable])
 
     // Reuse the EXACT column factory the main `<DynamicTable>` uses so each cell
     // renders identically — money in the org currency right-aligned, FK chips

package/src/dynamic-relations.tsx

@@ -11,6 +11,7 @@
 //     { owner_model: "Customer" }) into the panel's `filters` so the child list
 //     is scoped by the FK AND every scope column.
 import { useMemo } from 'react'
+import { cn } from '@asteby/metacore-ui/lib'
 import { DynamicRelation, type DynamicRelationStrings } from './dynamic-relation'
 import type { RelationMeta } from './types'
 
@@ -40,6 +41,14 @@ export interface DynamicRelationsProps {
     canEdit?: boolean
     /** Translatable strings forwarded to each DynamicRelation. */
     strings?: Partial<DynamicRelationStrings>
+    /**
+     * True cuando estos paneles se renderizan como sub-tablas de líneas dentro
+     * del MODAL de vista de un registro. Propaga `lineSubtable` a cada
+     * `<DynamicRelation>` para ocultar por defecto las columnas de auditoría/
+     * sistema redundantes bajo el padre. Default false — una página de detalle
+     * autónoma conserva todas las columnas.
+     */
+    lineSubtable?: boolean
     /** Bubble up when any panel's data changes (create/delete/attach/detach). */
     onChange?: (relation: RelationMeta) => void
 }
@@ -96,6 +105,7 @@ export function DynamicRelations({
     canDelete = true,
     canEdit = true,
     strings,
+    lineSubtable = false,
     onChange,
 }: DynamicRelationsProps) {
     const parentId = useMemo(
@@ -108,7 +118,10 @@ export function DynamicRelations({
     }
 
     return (
-        <div className={className} data-dynamic-relations="">
+        // `space-y-6` separates stacked relation panels (e.g. "Líneas del
+        // pedido" and "Facturas" in the view modal) — without it consecutive
+        // panels sat flush against each other with no breathing room.
+        <div className={cn('space-y-6', className)} data-dynamic-relations="">
             {relations.map((rel, idx) => {
                 const filters = buildRelationFilters(rel, parentId)
                 const panelStrings: Partial<DynamicRelationStrings> = {
@@ -135,6 +148,7 @@ export function DynamicRelations({
                             parentId={parentId}
                             filters={filters}
                             className={panelClassName}
+                            lineSubtable={lineSubtable}
                             canCreate={canCreate}
                             canDelete={canDelete}
                             readonly={relReadonly}
@@ -152,6 +166,7 @@ export function DynamicRelations({
                         parentId={parentId}
                         filters={filters}
                         className={panelClassName}
+                        lineSubtable={lineSubtable}
                         canCreate={canCreate}
                         canDelete={canDelete}
                         canEdit={canEdit}

package/src/index.ts

@@ -307,6 +307,8 @@ export {
     resolveDependsValue,
     getOptionsConfig,
     resolveOptionsSource,
+    getVisibleWhen,
+    evaluateVisibleWhen,
 } from './dynamic-form-schema'
 export {
     ActivityValueRenderer,

package/src/types.ts

@@ -295,6 +295,17 @@ export interface ColumnDefinition {
     itemFields?: ColumnItemField[]
     /** snake_case alias served by the kernel for `itemFields`. */
     item_fields?: ColumnItemField[]
+    /**
+     * Conditional visibility in the create/edit modal: render this field only
+     * when a sibling field's current value matches the predicate. Mirrors the
+     * kernel v3 `Column.visible_when` (projected onto the served ColumnDef).
+     * Tolerates the camelCase alias. Absent = always visible; a hidden field is
+     * skipped by the required-gate so it never blocks submit. See
+     * `evaluateVisibleWhen`.
+     */
+    visible_when?: VisibleWhen
+    /** camelCase alias for `visible_when`. */
+    visibleWhen?: VisibleWhen
 }
 
 /**
@@ -317,6 +328,21 @@ export interface ActionCondition {
     value: string | string[]
 }
 
+/**
+ * Conditional-visibility predicate for a create/edit form field. Mirrors the
+ * kernel v3 `visible_when` block (json `visible_when`): the owning field is
+ * rendered only when the SIBLING field named by `field` holds a value that
+ * matches — either equal to `equals` (exact string) OR a member of `in`
+ * (any-of). When both are set `in` wins. Absent = the field is always visible
+ * (retrocompat). Evaluated by `evaluateVisibleWhen` against the live form
+ * values; a hidden field never gates submit (its required-check is skipped).
+ */
+export interface VisibleWhen {
+    field: string
+    equals?: string
+    in?: string[]
+}
+
 // Mirrors `ValidationRule` from packages/sdk/src/generated/manifest.ts. Kept
 // inline here so runtime-react does not import generated kernel types directly
 // — apps and addons author ActionFieldDef literals.
@@ -493,6 +519,16 @@ export interface ActionFieldDef {
     storagePath?: string
     /** snake_case alias served by the kernel manifest for `storagePath`. */
     storage_path?: string
+    /**
+     * Conditional visibility: render this field only when a sibling field's
+     * current value matches the predicate. Mirrors the kernel v3
+     * `ActionField.visible_when`. Tolerates the camelCase alias. Absent = always
+     * visible; a hidden field is skipped by the required-gate so it never blocks
+     * submit. See `evaluateVisibleWhen`.
+     */
+    visible_when?: VisibleWhen
+    /** camelCase alias for `visible_when`. */
+    visibleWhen?: VisibleWhen
 }
 
 /**