# ColumnVirtualizationConfig

> _Since v0.1.1_

Configuration for horizontal (column) virtualization.

When enabled, only the columns visible in the viewport (plus an overscan buffer)
are rendered to the DOM. This dramatically improves performance for grids with
many columns (50+), as only a small subset of column cells exist at any time.

By default, virtualization auto-enables when the column count exceeds `threshold`.
Set `autoEnable: false` to control activation manually.

#### Example

```typescript
new ColumnVirtualizationPlugin({
  threshold: 20,   // activate earlier than default
  overscan: 5,     // render 5 extra columns on each side
})
```

## Properties

| Property | Type | Description |
| -------- | ---- | ----------- |
| `autoEnable?` | <code>boolean</code> | Auto-enable when column count exceeds threshold (default: true) |
| `threshold?` | <code>number</code> | Column count threshold for auto-enabling (default: 30) |
| `overscan?` | <code>number</code> | Extra columns to render on each side for smooth scrolling (default: 3) |