.table()

Adds a table.

TableOptions

.table({
  preset?: "basic" | "minimal" | "striped",
  columns: Column<T>[],
  data: T[],
  autoWidth?: "all" | "body" | false,
  mergeSameValues?: boolean,
  style?: TableStyle,
  border?: BorderStyle,
  conditionalStyle?: (row: T, col: keyof T) => CellStyle | {},
})

Option	Type	Default	Description
preset	"basic" | "minimal" | "striped"	-	Preset style
columns	Column<T>[]	Required	Column definitions
data	T[]	Required	Data array
autoWidth	"all" | "body" | false	false	Auto column width
mergeSameValues	boolean	false	Merge cells with same values vertically
style	TableStyle	-	Table-wide style
border	BorderStyle	-	Border settings
conditionalStyle	function	-	Conditional styling

Column Definition (Column)

LeafColumn (Regular Column)

{
  key: keyof T & string,     // Data key
  label: string,             // Header text
  style?: CellStyle,         // Default style for this column
  mergeSameValues?: boolean, // Merge same values in this column
}

ParentColumn (Multi-Header)

{
  label: string,             // Parent header text
  children: Column<T>[],     // Child columns (recursive)
}

Multi-header example:

columns: [
  {
    label: "Product Info",
    children: [
      { key: "category", label: "Category" },
      { key: "name", label: "Name" },
    ],
  },
  { key: "price", label: "Price" },
]

Result:

| Product Info       | Price |
| Category | Name    |       |

autoWidth

Auto-adjusts column width.

Value	Description
"all"	Adjust by max width of header and body
"body"	Adjust by body only (ignore header)
false	No auto-adjustment (default)

.table({
  autoWidth: "all",
  columns: [...],
  data: [...],
})

mergeSameValues

Merges cells with same values vertically.

// Merge entire table
.table({
  mergeSameValues: true,
  columns: [...],
  data: [...],
})

// Merge by column
.table({
  columns: [
    { key: "category", label: "Category", mergeSameValues: true },
    { key: "name", label: "Name" },
  ],
  data: [...],
})

conditionalStyle

Applies styles to cells based on conditions.

.table({
  columns: [...],
  data: [...],
  conditionalStyle: (row, col) => {
    if (col === "profit" && row.profit < 0) {
      return { color: "#FF0000" };
    }
    return {};
  },
})

Related

• Style API - CellStyle, TableStyle, BorderStyle details
• Presets - Preset details