Sizing

size($width, $height) defines both the rendered SVG dimensions and the coordinate space used for layout. The renderer recalculates the complete chart for that size.

$model = Chart::bar()
    ->size(480, 320)
    ->series('Revenue', ['Q1' => 18, 'Q2' => 32, 'Q3' => 24])
    ->build();

SVG dimensions

The root SVG receives explicit width and height attributes plus a matching viewBox. CSS can scale that document proportionally, but CSS scaling does not run the PHP layout again.

For a compact layout, render a model with compact dimensions. Do not render a wide chart and expect its legend, ticks, or labels to reflow when CSS makes it narrower.

Minimum sizes

Builders reject smaller canvases because the renderer cannot preserve the chart's essential structure within them. Larger dimensions may still be required for long legends or many entries; the renderer rejects legends that cannot fit. Text fitting uses approximate character widths, so check the result with the fonts used by your application.

Automatic layout

The renderer reserves fixed regions for the title, plot, category labels, and optional legend. Horizontal stacked and diverging bars use additional space for category labels.

Pie and donut charts change layout at 520 pixels: wide charts place the legend beside the plot, while narrower charts place it below. Sparklines hide their endpoint labels below 48 pixels high.

These are size-dependent renderer rules. Margins, breakpoints, and plot alignment do not currently have public setters.