Getting Started

atelier/layout solves geometry before rendering. You describe boxes, tracks, text, padding, and constraints; it returns frames that any renderer can consume.

Install

composer require atelier/layout

Solve A Grid

use Atelier\Layout\Alignment;
use Atelier\Layout\Element\Frame;
use Atelier\Layout\Element\Grid;
use Atelier\Layout\Geometry\Rect;
use Atelier\Layout\Grid\TrackSize;
use Atelier\Layout\LayoutContext;

$layout = Grid::tracks('row', [
    TrackSize::fixed(48),
    TrackSize::fr(),
    TrackSize::fixed(48),
])
    ->gap(8)
    ->align(Alignment::Center, Alignment::Center)
    ->add(Frame::fixed('left', 32, 32))
    ->add(Frame::stretch('middle'), alignX: Alignment::Stretch)
    ->add(Frame::fixed('right', 32, 32));

$result = $layout->solve(new LayoutContext(), Rect::fromSize(240, 48));

$result->frameOf('middle');

Solve Text

use Atelier\Layout\Alignment;
use Atelier\Layout\Element\TextBlock;
use Atelier\Layout\Geometry\Rect;
use Atelier\Layout\LayoutContext;

$text = TextBlock::of('caption', 'Wrapped bottom label', 12)
    ->align(Alignment::Center, Alignment::End)
    ->layout(new LayoutContext(), new Rect(0, 0, 90, 48));

$text->lines;
$text->hasOverflow();

Use Geometry Helpers

use Atelier\Layout\Geometry\Bounds;
use Atelier\Layout\Geometry\Insets;
use Atelier\Layout\Connection\OrthogonalConnector;

$bounds = Bounds::expand(Bounds::of($a, $b, $c), Insets::all(12));
$connection = (new OrthogonalConnector())->connect($a, $b);

Geometry helpers are pure values: they do not render, mutate, or depend on SVG.

Where To Go Next

If you need to	Read
place things along one axis	Stacks And Spacing
place things on two axes	Grid
position a child inside its box	Alignment
share leftover space	Distribution
attach a badge to a corner	Overlays And Badges
fit an image or a ratio	Fit
draw an arrow between two boxes	Connections
wrap and measure a label	Text And Inline Runs
build lanes, an axis strip, or a key	Tracks, Bands And Legends