Improve gauge grid layout

docs/API_REFERENCE.md

@@ -24,7 +24,10 @@ Creation functions are context managers and accept common options such as `tag`,
 ## Layout Helpers
 
 - `gauge_panel(**config)`: child-window panel for grouped gauges.
-- `gauge_grid(**config)`: lightweight horizontal gauge group.
+- `gauge_grid(columns=1, min_column_width=180, fit_gauges=True, **config)`: table-backed
+  wrapping gauge grid. `columns` is the maximum number of columns. If the parent is narrower than
+  `columns * min_column_width`, the grid uses fewer columns and wraps gauges onto later rows to
+  avoid horizontal scrolling. Gauges without an explicit positive width fill their grid cell.
 
 ## Runtime API
 

docs/EXAMPLES.md

@@ -15,6 +15,7 @@ Run examples with `uv run python examples/<name>.py`.
 - `thresholds_markers.py`
 - `animations.py`
 - `dashboard.py`
+- `layout_grid.py`
 - `sizing.py`
 - `live_high_rate.py`
 - `live_worst_case.py`