editor

ADR-0032 — The rectangle is a free shape, stretched by its width and height ​

Status: Accepted (Product Owner's decision, 2026-10-11, F09: the rectangle is a free shape, stretchable without loss; the model of stored points in their own box is the agent's, shown at VAL-006) — partly superseded by ADR-0033 (corners, fractional points and size) and ADR-0035 (a free shape is drawn at its position)

Context ​

F01 stored a rectangle as { width, height, radii } and derived its four vertices. F08 lets the user move, add and delete vertices, which a rectangle cannot hold. The Product Owner decided that the rectangle is a free shape from the start: underneath, a rectangle is always a free shape; the rectangle tool only creates it. Width and height of any free shape stay editable and stretch it, without loss: growing a shape and bringing it back must give exactly the same points.

Options for the model of a free shape:

OptionWidth 0, then backA typed point
Drawn points only; resizing rewrites themlost (all on one line)stored as typed
Stored points in their own box, plus width and heightexact (DERIV-free-shape-stretch)decided with F08

Decision ​

A free shape stores its points in its own box, its width and height (integers ≥ 0), and one radius per point (ADR-0029). The points drawn are the stored points stretched from the top-left of their box to the width and height (DERIV-free-shape-stretch). The rectangle tool stores the unit square, top-left first, clockwise (Q11), so that it draws exactly the rectangle of F01.

Consequences ​

  • Rectangle stops being a stored shape: the rectangle tool's width, height and radii make a free shape. A regular polygon stays a shape of its own, with its corners and anchor, until it is converted (F08).
  • Resizing never rewrites the stored points; a shape of width 0 comes back as it was.
  • Moving, adding and deleting points, and whether stored points stay integers, are decided with F08 (paused on its own branch, with ADR-0031). F09 stores only the rectangle tool's unit square, integers, as ADR-0003 asks.
  • The stored points must span a box of positive width and height, otherwise no size can be drawn (DERIV-free-shape-stretch step 2); such a shape is refused.
  • The eight handles of the box, the opposite side fixed, come with E02.

References ​

ADR-0003, ADR-0029, DERIV-free-shape-stretch, REF-SVG2-COORDS, REF-CSS-TRANSFORMS