@asteby/metacore-runtime-react 37.0.4 → 37.1.0

package/src/branch-create-gate.tsx

@@ -0,0 +1,40 @@
+/**
+ * Optional host gate for stamping `branch_id` on creates when the sidebar is
+ * on "all branches" (no active scope).
+ *
+ * Ops (and other hosts) provide a provider that opens a confirm + branch
+ * picker. The SDK's DynamicRecordDialog / ActionModalDispatcher call
+ * `ensureBranchForCreate` right before POST — custom federated modals can use
+ * the same hook so POS-style flows stay consistent.
+ *
+ * Return contract for `ensureBranchForCreate`:
+ *   - `undefined` — model has no branch_id / gate not needed / already scoped
+ *   - `string`    — branch id to stamp onto the payload
+ *   - `null`      — user cancelled the picker (abort submit)
+ */
+import { createContext, useContext, type ReactNode } from 'react'
+
+export type BranchCreateGateApi = {
+  ensureBranchForCreate: (model: string) => Promise<string | null | undefined>
+}
+
+const BranchCreateGateContext = createContext<BranchCreateGateApi | null>(null)
+
+export function BranchCreateGateProvider({
+  value,
+  children,
+}: {
+  value: BranchCreateGateApi
+  children: ReactNode
+}) {
+  return (
+    <BranchCreateGateContext.Provider value={value}>
+      {children}
+    </BranchCreateGateContext.Provider>
+  )
+}
+
+/** Hook for custom / federated create modals. Returns null when no host gate. */
+export function useBranchCreateGate(): BranchCreateGateApi | null {
+  return useContext(BranchCreateGateContext)
+}

package/src/dialogs/dynamic-record.tsx

@@ -53,6 +53,7 @@ import { es } from 'date-fns/locale'
 import { ExternalLink, Loader2, CalendarIcon, ChevronDown, Check, Upload, X as XIcon, ScanLine } from 'lucide-react'
 import { BarcodeScanner } from '../barcode-scanner'
 import { useApi } from '../api-context'
+import { useBranchCreateGate } from '../branch-create-gate'
 import { toastServerError, extractFieldErrors, localizeFieldIssue, localizeFieldErrorMap } from '../server-error'
 import { DynamicSelectField, OptionLead, OptionThumb } from '../dynamic-select-field'
 import { DynamicRelations } from '../dynamic-relations'
@@ -614,6 +615,7 @@ export function DynamicRecordDialog({
     onChange,
 }: DynamicRecordDialogProps) {
     const api = useApi()
+    const branchGate = useBranchCreateGate()
     const { t } = useTranslation()
     const [modalMeta, setModalMeta] = useState<ModalMetadata | null>(
         schema ? (schema as ModalMetadata) : null,
@@ -864,11 +866,14 @@ export function DynamicRecordDialog({
                 for (const f of visible) labels[f.key] = f.label
                 const next = localizeFieldErrorMap(bag, t, { labels })
                 setFieldErrors(next)
-                const visibleKeys = new Set(visible.map(f => f.key))
-                const orphans = Object.entries(next).filter(([k]) => !visibleKeys.has(k))
-                const description = orphans.length
-                    ? orphans.map(([k, msg]) => `${labelForKey(k)}: ${msg}`).join(' · ')
-                    : undefined
+                const description = Object.entries(next)
+                    .map(([k, msg]) => {
+                        const label = labels[k] || labelForKey(k)
+                        return msg.toLowerCase().startsWith(String(label).toLowerCase())
+                            ? msg
+                            : `${label}: ${msg}`
+                    })
+                    .join(' · ')
                 toast.error(
                     t('dynamic.validation_failed', { defaultValue: 'Revisa los campos marcados' }),
                     description ? { description } : undefined,
@@ -889,7 +894,17 @@ export function DynamicRecordDialog({
 
         // Empty reference pickers → null (not "" / nil-UUID) so nullable FK
         // columns accept them instead of raising a 23503 FK violation.
-        const payload = normalizeRefFieldsForSubmit(submittedValues, modalMeta.fields)
+        let payload = normalizeRefFieldsForSubmit(submittedValues, modalMeta.fields)
+
+        if (
+            isCreate &&
+            branchGate &&
+            (payload.branch_id == null || payload.branch_id === '')
+        ) {
+            const branchId = await branchGate.ensureBranchForCreate(model)
+            if (branchId === null) return
+            if (branchId) payload = { ...payload, branch_id: branchId }
+        }
 
         setSaving(true)
         try {

package/src/dynamic-form-schema.ts

@@ -119,6 +119,57 @@ export function computeLineItemTotals(
     return totals
 }
 
+/** Keys that mean "line net amount" across manifests / locales. */
+const LINE_AMOUNT_KEYS = new Set(['subtotal', 'line_total', 'importe', 'amount', 'total'])
+/** Keys that mean quantity on a line row. */
+const LINE_QTY_KEYS = new Set(['qty', 'quantity', 'cantidad'])
+/** Keys that mean unit price. */
+const LINE_PRICE_KEYS = new Set(['unit_price', 'price', 'precio', 'precio_unitario'])
+/** Keys that mean line discount (absolute). */
+const LINE_DISCOUNT_KEYS = new Set(['discount', 'descuento', 'discount_amount'])
+
+function firstKey(rowOrFields: { key?: string }[] | Record<string, unknown>, candidates: Set<string>): string | undefined {
+    if (Array.isArray(rowOrFields)) {
+        for (const f of rowOrFields) {
+            if (f.key && candidates.has(f.key)) return f.key
+        }
+        return undefined
+    }
+    for (const k of Object.keys(rowOrFields)) {
+        if (candidates.has(k)) return k
+    }
+    return undefined
+}
+
+/**
+ * Live line-amount formula for action / form line-items grids:
+ * `(qty|quantity) * (unit_price|…) - (discount|…)` → `subtotal|line_total|importe`.
+ *
+ * Pure + convention-based so create_sales_order (and similar modals) show
+ * Importe as the user types without each manifest declaring a client formula.
+ * No-op when the row has no amount column or no qty/price pair.
+ */
+export function applyLineItemRowFormulas(
+    itemFields: ActionFieldDef[],
+    row: Record<string, any>,
+): Record<string, any> {
+    const amountKey =
+        firstKey(itemFields, LINE_AMOUNT_KEYS) ?? firstKey(row, LINE_AMOUNT_KEYS)
+    const qtyKey = firstKey(itemFields, LINE_QTY_KEYS) ?? firstKey(row, LINE_QTY_KEYS)
+    const priceKey =
+        firstKey(itemFields, LINE_PRICE_KEYS) ?? firstKey(row, LINE_PRICE_KEYS)
+    if (!amountKey || !qtyKey || !priceKey) return row
+
+    const discountKey =
+        firstKey(itemFields, LINE_DISCOUNT_KEYS) ?? firstKey(row, LINE_DISCOUNT_KEYS)
+    const qty = toNumber(row[qtyKey])
+    const price = toNumber(row[priceKey])
+    const discount = discountKey ? toNumber(row[discountKey]) : 0
+    const next = Math.round((qty * price - discount) * 100) / 100
+    if (toNumber(row[amountKey]) === next) return row
+    return { ...row, [amountKey]: next }
+}
+
 export interface BalanceState {
     debit: number
     credit: number

package/src/dynamic-form.tsx

@@ -420,7 +420,10 @@ function FieldRenderer({
         case 'switch':
             return <Switch id={field.key} checked={!!value} onCheckedChange={onChange} />
         case 'number':
-            return <Input id={field.key} type="number" value={value ?? ''} onChange={(e: React.ChangeEvent<HTMLInputElement>) => onChange(e.target.valueAsNumber || '')} placeholder={field.placeholder} />
+            return <Input id={field.key} type="number" value={value ?? ''} onChange={(e: React.ChangeEvent<HTMLInputElement>) => {
+                const n = e.target.valueAsNumber
+                onChange(e.target.value === '' || !Number.isFinite(n) ? '' : n)
+            }} placeholder={field.placeholder} />
         case 'date':
             return <DynamicDateField field={field} value={value} onChange={onChange} />
         default:
@@ -463,9 +466,14 @@ function ScannableInput({
             id={field.key}
             type={type}
             value={value ?? ''}
-            onChange={(e: React.ChangeEvent<HTMLInputElement>) =>
-                onChange(type === 'number' ? e.target.valueAsNumber || '' : e.target.value)
-            }
+            onChange={(e: React.ChangeEvent<HTMLInputElement>) => {
+                if (type !== 'number') {
+                    onChange(e.target.value)
+                    return
+                }
+                const n = e.target.valueAsNumber
+                onChange(e.target.value === '' || !Number.isFinite(n) ? '' : n)
+            }}
             placeholder={field.placeholder}
         />
     )

package/src/dynamic-line-items.tsx

@@ -25,6 +25,7 @@ import {
     resolveWidget,
     getItemFields,
     computeLineItemTotals,
+    applyLineItemRowFormulas,
     evaluateBalance,
     toNumber,
     getDependsOn,
@@ -47,6 +48,11 @@ export interface DynamicLineItemsProps {
      * (e.g. `source_warehouse_id`), not just a sibling cell on the same row.
      */
     formValues?: Record<string, any>
+    /**
+     * Localized validation messages keyed as `rowIndex.columnKey` (e.g.
+     * `0.unit_price`). Painted as destructive borders + under-cell text.
+     */
+    errors?: Record<string, string>
 }
 
 const fmtNumber = (n: number): string =>
@@ -65,9 +71,10 @@ function emptyRow(itemFields: ActionFieldDef[]): Record<string, any> {
     return row
 }
 
-export function DynamicLineItems({ field, value, onChange, disabled = false, formValues }: DynamicLineItemsProps) {
+export function DynamicLineItems({ field, value, onChange, disabled = false, formValues, errors }: DynamicLineItemsProps) {
     const itemFields = getItemFields(field)
     const rows: any[] = Array.isArray(value) ? value : []
+    const errMap = errors ?? {}
 
     // `lock_rows` fixes the row set: no add-row button, no per-row delete. Rows
     // stay editable cell-by-cell. Snake_case is what the kernel serves; tolerate
@@ -81,10 +88,16 @@ export function DynamicLineItems({ field, value, onChange, disabled = false, for
     const hasTotals = totalKeys.length > 0
     const balance = evaluateBalance(field, rows)
 
-    const addRow = () => onChange([...rows, emptyRow(itemFields)])
+    const addRow = () => onChange([...rows, applyLineItemRowFormulas(itemFields, emptyRow(itemFields))])
     const removeRow = (idx: number) => onChange(rows.filter((_, i) => i !== idx))
     const updateCell = (idx: number, key: string, cellValue: any) =>
-        onChange(rows.map((r, i) => (i === idx ? { ...r, [key]: cellValue } : r)))
+        onChange(
+            rows.map((r, i) =>
+                i === idx
+                    ? applyLineItemRowFormulas(itemFields, { ...r, [key]: cellValue })
+                    : r,
+            ),
+        )
 
     // When a balance rule reconciles two columns (e.g. debit ↔ credit), typing
     // into one clears the sibling on the same row — mirrors the federated modal
@@ -105,7 +118,13 @@ export function DynamicLineItems({ field, value, onChange, disabled = false, for
             const hasValue = toNumber(cellValue) > 0
             onChange(
                 rows.map((r, i) =>
-                    i === idx ? { ...r, [key]: cellValue, ...(hasValue ? { [sibling]: '' } : {}) } : r,
+                    i === idx
+                        ? applyLineItemRowFormulas(itemFields, {
+                              ...r,
+                              [key]: cellValue,
+                              ...(hasValue ? { [sibling]: '' } : {}),
+                          })
+                        : r,
                 ),
             )
             return
@@ -149,7 +168,9 @@ export function DynamicLineItems({ field, value, onChange, disabled = false, for
                             )}
                         </div>
                         <div className="grid gap-2.5">
-                            {itemFields.map((col) => (
+                            {itemFields.map((col) => {
+                                const cellErr = errMap[`${idx}.${col.key}`]
+                                return (
                                 <div key={col.key} className="grid gap-1">
                                     <span className="text-xs font-medium">
                                         {col.label}
@@ -164,9 +185,14 @@ export function DynamicLineItems({ field, value, onChange, disabled = false, for
                                         disabled={disabled}
                                         formValues={formValues}
                                         rowValues={row}
+                                        invalid={!!cellErr}
                                     />
+                                    {cellErr && (
+                                        <p className="text-destructive text-xs">{cellErr}</p>
+                                    )}
                                 </div>
-                            ))}
+                                )
+                            })}
                         </div>
                     </div>
                 ))}
@@ -219,7 +245,9 @@ export function DynamicLineItems({ field, value, onChange, disabled = false, for
                         )}
                         {rows.map((row, idx) => (
                             <tr key={idx} className="border-t align-top">
-                                {itemFields.map((col) => (
+                                {itemFields.map((col) => {
+                                    const cellErr = errMap[`${idx}.${col.key}`]
+                                    return (
                                     <td key={col.key} className="px-2 py-1.5">
                                         <CellRenderer
                                             field={col}
@@ -228,9 +256,14 @@ export function DynamicLineItems({ field, value, onChange, disabled = false, for
                                             disabled={disabled}
                                             formValues={formValues}
                                             rowValues={row}
+                                            invalid={!!cellErr}
                                         />
+                                        {cellErr && (
+                                            <p className="text-destructive mt-1 text-xs">{cellErr}</p>
+                                        )}
                                     </td>
-                                ))}
+                                    )
+                                })}
                                 {!lockRows && (
                                     <td className="px-2 py-1.5 text-center">
                                         <Button
@@ -342,14 +375,19 @@ interface CellRendererProps {
     formValues?: Record<string, any>
     /** This row's values — for resolving a cell's `dependsOn` to a sibling cell. */
     rowValues?: Record<string, any>
+    /** Paint the control as invalid (destructive border). */
+    invalid?: boolean
 }
 
 // Per-cell widget. Mirrors the flat FieldRenderer in dynamic-form.tsx but
 // without the per-field Label (the column header is the label) and sized for a
 // table cell. Nested line-items inside a row are not supported (a row column is
 // a scalar widget).
-function CellRenderer({ field, value, onChange, disabled, formValues, rowValues }: CellRendererProps) {
+function CellRenderer({ field, value, onChange, disabled, formValues, rowValues, invalid }: CellRendererProps) {
     const widget = resolveWidget(field)
+    const invalidCls = invalid
+        ? 'border-destructive ring-1 ring-destructive/30 focus-visible:ring-destructive'
+        : ''
     // Per-field read-only: a column locked by a PrefillSpec.lock (e.g. the
     // "ordered" / "already received" progress columns of a receive-goods modal)
     // renders disabled so it shows context without being editable. Tolerates the
@@ -384,7 +422,16 @@ function CellRenderer({ field, value, onChange, disabled, formValues, rowValues
     // Async searchable picker per row cell — e.g. the account_id column of a
     // journal entry's debit/credit lines. Same widget as the flat form.
     if (widget === 'dynamic_select') {
-        return <DynamicSelectField field={field} value={value} onChange={onChange} dependsValue={dependsValue} readonly={ro} />
+        return (
+            <DynamicSelectField
+                field={field}
+                value={value}
+                onChange={onChange}
+                dependsValue={dependsValue}
+                readonly={ro}
+                invalid={invalid}
+            />
+        )
     }
     if (widget === 'select' && (field.ref || getOptionsConfig(field)?.source)) {
         return (
@@ -408,6 +455,8 @@ function CellRenderer({ field, value, onChange, disabled, formValues, rowValues
                     placeholder={field.placeholder}
                     disabled={off}
                     rows={2}
+                    aria-invalid={invalid || undefined}
+                    className={invalidCls || undefined}
                 />
             )
         case 'color':
@@ -417,6 +466,8 @@ function CellRenderer({ field, value, onChange, disabled, formValues, rowValues
                     value={value || '#000000'}
                     onChange={(e: React.ChangeEvent<HTMLInputElement>) => onChange(e.target.value)}
                     disabled={off}
+                    aria-invalid={invalid || undefined}
+                    className={invalidCls || undefined}
                 />
             )
         case 'select': {
@@ -425,7 +476,7 @@ function CellRenderer({ field, value, onChange, disabled, formValues, rowValues
             if (effectiveOptions && effectiveOptions.length === 0) return null
             return (
                 <Select value={value || ''} onValueChange={onChange} disabled={off}>
-                    <SelectTrigger className="w-full">
+                    <SelectTrigger className={'w-full' + (invalidCls ? ` ${invalidCls}` : '')} aria-invalid={invalid || undefined}>
                         <SelectValue placeholder={field.placeholder || 'Seleccionar...'} />
                     </SelectTrigger>
                     <SelectContent>
@@ -445,9 +496,16 @@ function CellRenderer({ field, value, onChange, disabled, formValues, rowValues
                 <Input
                     type="number"
                     value={value ?? ''}
-                    onChange={(e: React.ChangeEvent<HTMLInputElement>) => onChange(e.target.valueAsNumber || '')}
+                    onChange={(e: React.ChangeEvent<HTMLInputElement>) => {
+                        const n = e.target.valueAsNumber
+                        // `0 || ''` would wipe a legitimate zero (unit_price=0)
+                        // and then required-validation fires with nothing marked.
+                        onChange(e.target.value === '' || !Number.isFinite(n) ? '' : n)
+                    }}
                     placeholder={field.placeholder}
                     disabled={off}
+                    aria-invalid={invalid || undefined}
+                    className={invalidCls || undefined}
                 />
             )
         case 'date':
@@ -457,6 +515,8 @@ function CellRenderer({ field, value, onChange, disabled, formValues, rowValues
                     value={value || ''}
                     onChange={(e: React.ChangeEvent<HTMLInputElement>) => onChange(e.target.value)}
                     disabled={off}
+                    aria-invalid={invalid || undefined}
+                    className={invalidCls || undefined}
                 />
             )
         default:
@@ -467,6 +527,8 @@ function CellRenderer({ field, value, onChange, disabled, formValues, rowValues
                     onChange={(e: React.ChangeEvent<HTMLInputElement>) => onChange(e.target.value)}
                     placeholder={field.placeholder}
                     disabled={off}
+                    aria-invalid={invalid || undefined}
+                    className={invalidCls || undefined}
                 />
             )
     }

package/src/dynamic-table.tsx

@@ -367,6 +367,36 @@ export function DynamicTable({
     // been adopted, where `dynamicFilters`/`pagination` already mirror the URL,
     // so the write is a no-op and the filter never gets stripped.
     const [urlSynced, setUrlSynced] = useState(false)
+    // Keys that left `defaultFilters` (e.g. branch_id when switching to
+    // "Todas las sucursales"). The URL write effect used to carry-through every
+    // leftover `f_*` from location — that resurrected the locked branch filter
+    // forever after the host dropped it from defaultFilters.
+    const prevDefaultFilterKeys = useRef<Set<string>>(new Set())
+    const releasedDefaultFilterKeys = useRef<Set<string>>(new Set())
+
+    useEffect(() => {
+        const next = new Set(Object.keys(defaultFilters ?? {}))
+        const prev = prevDefaultFilterKeys.current
+        const released = new Set<string>()
+        prev.forEach((k) => {
+            if (!next.has(k)) released.add(k)
+        })
+        releasedDefaultFilterKeys.current = released
+        if (released.size > 0) {
+            setDynamicFilters((df) => {
+                let changed = false
+                const copy = { ...df }
+                released.forEach((k) => {
+                    if (k in copy) {
+                        delete copy[k]
+                        changed = true
+                    }
+                })
+                return changed ? copy : df
+            })
+        }
+        prevDefaultFilterKeys.current = next
+    }, [defaultFilters])
 
     useEffect(() => {
         if (prevBranchId.current !== currentBranch?.id) {
@@ -513,9 +543,13 @@ export function DynamicTable({
         // Sidebar deep-links (CxC→CxP) push f_party_type=eq:supplier before React
         // re-renders with matching defaultFilters; without this carry-through the
         // write effect races and strips the filter down to bare ?view=list.
+        // Do NOT resurrect keys the host just released from defaultFilters
+        // (branch_id when switching to "all" — otherwise San Felipe sticks).
         current.forEach((value, key) => {
             if (!key.startsWith('f_')) return
             if (params.has(key)) return
+            const filterKey = key.substring(2)
+            if (releasedDefaultFilterKeys.current.has(filterKey)) return
             params.set(key, value)
         })
         const search = params.toString()

package/src/field-validation-ui.ts

@@ -0,0 +1,140 @@
+// Shared helpers for painting + toasting client/server field validation so
+// action modals and DynamicRecordDialog stay in lockstep.
+import type { ActionFieldDef } from './types'
+import type { Translate } from './server-error'
+
+function itemFieldsOf(field: ActionFieldDef): ActionFieldDef[] {
+    const raw = field.itemFields ?? (field as { item_fields?: ActionFieldDef[] }).item_fields
+    return Array.isArray(raw) ? raw : []
+}
+
+function translateLabel(raw: string | undefined, t?: Translate): string {
+    if (!raw) return ''
+    if (!t) return raw
+    return t(raw, { defaultValue: raw })
+}
+
+function humanizeToken(key: string): string {
+    return key.replace(/[._-]+/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase())
+}
+
+/**
+ * Resolve a validation path (`customer_id`, `lines.0.unit_price`) to a
+ * human label using the action/modal field schema. Nested line-item paths
+ * become "Renglones → Precio unitario (fila 1)".
+ */
+export function labelForValidationPath(
+    path: string,
+    fields: readonly ActionFieldDef[] | undefined,
+    t?: Translate,
+): string {
+    if (!path) return ''
+    const parts = path.split('.')
+    if (!fields?.length) return humanizeToken(path)
+
+    let cursor: readonly ActionFieldDef[] | undefined = fields
+    const bits: string[] = []
+    let i = 0
+    while (i < parts.length && cursor) {
+        const seg = parts[i]!
+        if (/^\d+$/.test(seg)) {
+            const row = Number(seg) + 1
+            const nextKey = parts[i + 1]
+            if (nextKey && cursor) {
+                const col = cursor.find((f) => f.key === nextKey)
+                const colLabel = translateLabel(col?.label, t) || humanizeToken(nextKey)
+                bits.push(`${colLabel} (fila ${row})`)
+                i += 2
+                cursor = undefined
+                continue
+            }
+            bits.push(`fila ${row}`)
+            i += 1
+            continue
+        }
+        const field = cursor.find((f) => f.key === seg)
+        if (!field) {
+            bits.push(humanizeToken(parts.slice(i).join('.')))
+            break
+        }
+        bits.push(translateLabel(field.label, t) || humanizeToken(seg))
+        const nested = itemFieldsOf(field)
+        cursor = nested.length ? nested : undefined
+        i += 1
+        if (!cursor && i < parts.length) {
+            bits.push(humanizeToken(parts.slice(i).join('.')))
+            break
+        }
+    }
+    return bits.join(' → ')
+}
+
+/** Build `{path: label}` covering scalar fields and `parent.N.child` templates
+ *  used by localizeFieldErrorMap (exact keys win when present). */
+export function labelsForValidationFields(
+    fields: readonly ActionFieldDef[] | undefined,
+    t?: Translate,
+): Record<string, string> {
+    const out: Record<string, string> = {}
+    if (!fields) return out
+    for (const f of fields) {
+        if (!f.key) continue
+        out[f.key] = translateLabel(f.label, t) || humanizeToken(f.key)
+        for (const child of itemFieldsOf(f)) {
+            if (!child.key) continue
+            out[`${f.key}.${child.key}`] = translateLabel(child.label, t) || humanizeToken(child.key)
+        }
+    }
+    return out
+}
+
+/**
+ * Toast description: one "Label: message" line per error. Re-resolves labels
+ * for dotted line-item paths so operators see e.g.
+ * "Precio unitario (fila 1): es obligatorio" instead of a bare headline.
+ */
+export function formatFieldErrorsDescription(
+    errors: Record<string, string>,
+    fields?: readonly ActionFieldDef[],
+    t?: Translate,
+): string | undefined {
+    const entries = Object.entries(errors)
+    if (!entries.length) return undefined
+    return entries
+        .map(([path, msg]) => {
+            const label = labelForValidationPath(path, fields, t)
+            // localizeFieldIssue already prefixes "{{label}}: …" — avoid
+            // "Label: Label: msg" when the message already starts with the label.
+            if (label && msg.toLowerCase().startsWith(label.toLowerCase())) return msg
+            return label ? `${label}: ${msg}` : msg
+        })
+        .join(' · ')
+}
+
+/** Drop `key` and every `key.*` / `key.N.*` entry after the operator edits that field. */
+export function clearFieldErrorTree(
+    prev: Record<string, string>,
+    key: string,
+): Record<string, string> {
+    if (!prev[key] && !Object.keys(prev).some((k) => k.startsWith(`${key}.`))) return prev
+    const next: Record<string, string> = {}
+    for (const [k, v] of Object.entries(prev)) {
+        if (k === key || k.startsWith(`${key}.`)) continue
+        next[k] = v
+    }
+    return next
+}
+
+/** Slice `parent.0.child` errors into `{ "0.child": msg }` for DynamicLineItems. */
+export function lineItemErrorsFor(
+    parentKey: string,
+    errors: Record<string, string> | undefined,
+): Record<string, string> {
+    if (!errors) return {}
+    const prefix = `${parentKey}.`
+    const out: Record<string, string> = {}
+    for (const [k, v] of Object.entries(errors)) {
+        if (k.startsWith(prefix)) out[k.slice(prefix.length)] = v
+    }
+    return out
+}

package/src/index.ts

@@ -40,6 +40,13 @@ export {
     type ValidationSpec,
 } from './validator'
 export { VALIDATION_CATALOGS, validationCatalog, validationMessageKey } from './validation-catalog'
+export {
+    labelForValidationPath,
+    labelsForValidationFields,
+    formatFieldErrorsDescription,
+    clearFieldErrorTree,
+    lineItemErrorsFor,
+} from './field-validation-ui'
 export * from './dynamic-table'
 export {
     DynamicKanban,
@@ -378,7 +385,15 @@ export {
     scopeValueFromFilterToken,
     buildListScopeValues,
     evaluateVisibleWhenForListScope,
+    applyLineItemRowFormulas,
+    computeLineItemTotals,
+    toNumber,
 } from './dynamic-form-schema'
+export {
+    BranchCreateGateProvider,
+    useBranchCreateGate,
+    type BranchCreateGateApi,
+} from './branch-create-gate'
 export {
     ActivityValueRenderer,
     type ActivityValueRendererProps,