position

Sets a single child's min-corner (x, y) offset in the parent's coordinate space. It is a low-level, absolute-offset placement primitive: it draws nothing of its own and contributes no styling, just a translate.

from gofish import layer, position, rect

layer([
    position([rect(w=60, h=40, fill="#9ecae1")], x=20, y=30),
]).render(w=120, h=90)

Signature

position(children, *, x=None, y=None, key=None) -> Mark

position takes exactly one child; passing more is not meaningful (the operator only tracks one child's box).

Parameters

Set a single child's min-corner (x, y) in parent coordinates — an absolute-offset placement primitive, NOT center-anchored. Unlike enclose's convex-hull styling, position draws nothing of its own; it exists for cases (e.g. the Topology story's combinator trees) that need to place one child precisely without enclose's fill/stroke/hull limits.

Option	Type	Default	Description
key	str		Internal per-node key override.
x	int | float | str		Min-corner x offset.
y	int | float | str		Min-corner y offset.

Notes

• Not center-anchored. position's (x, y) moves the child's min corner (its bbox's left edge and the start edge of its y: the top where y reads top-down, the bottom where y is continuous), not its center — unlike, say, spread's point placement. If you want center anchoring, offset by half the child's size yourself, or reach for spread/scatter instead.
• position is a workaround for enclose's styling limits, not a replacement for it: enclose draws a convex-hull rectangle (with its own fill/stroke/rx/ry) around the union of its children's boxes, but it can't style anything other than that hull. When a diagram needs one child placed at a precise absolute offset with its own styling, position is the more direct tool — it's a legitimate low-level primitive on its own, not a hack.
• Omitting x or y leaves that axis unset — the child falls back to its usual baseline-origin placement on that axis, exactly like an unplaced child in layer.