FlexibleGridOptions class

Configuration payload for FlexibleGrid.

The options surface mirrors the override hooks exposed by MediasfuUICustomOverrides and is intended for advanced UI composition. In addition to basic row/column sizing it supports:

• Responsive sizing: customWidth / customHeight act as upper bounds. When they are null, non-finite, or non-positive the grid derives sizes from its layout constraints so cells always remain visible.
• Rich spacing controls: per-row and per-column spacing, padding, margin, and decoration at the container, row, and cell levels.
• Builder hooks: inject custom renderers or wrappers via containerBuilder, gridBuilder, rowBuilder, cellBuilder, and emptyCellBuilder without re-implementing grid logic.
• Custom empty-state handling: provide emptyCell content or a builder to handle cells whose index exceeds componentsToRender.length.

Example – render a three-by-three grid that adapts to the available width and decorates empty cells:

FlexibleGridOptions(
  customWidth: null, // allow the grid to derive width from constraints
  customHeight: null,
  rows: 3,
  columns: 3,
  componentsToRender: const [Icon(Icons.person)],
  emptyCellBuilder: (context, suggested) => DecoratedBox(
    decoration: BoxDecoration(
      color: Colors.blueGrey.shade900,
      borderRadius: BorderRadius.circular(12),
    ),
    child: suggested,
  ),
);