NestedTableConfig

NestedTableConfig<TTable, TAs> = object

Defined in: packages/forms/src/types.ts:260

Configuration for a nested child table rendered as a dynamic field array under an AutoForm.

This is the successor to the deprecated ChildTableConfig record shape. Pass an array of these via the AutoForm nested prop:

<AutoForm
  table={recipes}
  nested={[
    {
      table: ingredients,
      foreignKey: "recipeId",
      min: 1,
      max: 50,
      reorderable: true,
      fields: { name: { placeholder: "Flour" } },
    },
  ]}
  onSubmit={async (values) => {
    // values.ingredients is fully typed — no casts needed.
  }}
/>

The array shape (as opposed to Record<string, ChildTableConfig>) avoids the JSX-reserved children attribute collision and enables the whole form value type to be inferred via InferAutoFormValues.

The key the nested array appears under in the submitted values is either:

as (explicit override), or
the table’s runtime name from getTableName(table) (e.g. sqliteTable("ingredients", ...) → ingredients).

Type Parameters

TTable

TTable extends Table = SQLiteTable

TAs

TAs extends string | undefined = string | undefined

Properties

addLabel?

optional addLabel: string

Defined in: packages/forms/src/types.ts:293

Override the “Add row” button label.

as?

optional as: TAs

Defined in: packages/forms/src/types.ts:279

Override the key the nested array appears under in submitted form values.

Defaults to the table’s runtime name (e.g. sqliteTable("ingredients", …) → "ingredients"). Pass as when two nested tables would otherwise collide, or when you want the form key to differ from the table name.

exclude?

optional exclude: keyof InferTableRow<TTable> & string[]

Defined in: packages/forms/src/types.ts:289

Additional column names to omit from the rendered nested rows.

fields?

optional fields: Partial<Record<keyof InferTableRow<TTable> & string, FieldConfig>>

Defined in: packages/forms/src/types.ts:287

Per-column overrides for the nested table fields, identical in shape to the parent FieldConfig.

foreignKey

foreignKey: keyof InferTableRow<TTable> & string

Defined in: packages/forms/src/types.ts:271

Foreign key column on the nested table that points back at the parent. The column is automatically excluded from the rendered nested fields and stamped onto each row at submit time.