fletcher.flexigrid()

A “flexible” coordinate system to be placed in CeTZ canvas which adapts to nodes contained therein.

Objects drawn inside a flexigrid have access to a $𝑢𝑣$ coordinate system, which is a nonlinear grid of rows and columns which stretch to fit nodes, like a table. Only content placed in node() can affect the $𝑢𝑣$ grid; edge()s and plain CeTZ objects in a flexigrid never affect the layout.

By default, nodes and edges use $𝑢𝑣$ coordinates while CeTZ objects use the default $𝑥𝑦$ coordinates. Use the coordinate expressions (uv: ..) and (xy: ..) to specify the system. Both systems can be mixed in coordinate expressions like ((uv: (1,2)), 50%, (xy: (0,0))).

#cetz.canvas({
  import cetz.draw: *
  fletcher.flexigrid(debug: "grid", {
    set-style(node: (fill: yellow))
    node((0,0))[Nodes...]
    node((2,1))[...in $u v$ system]
    circle((uv: (2,0)), radius: 5pt, fill: blue)
    content((3,2))[Content in $x y$ system]
  })
})

The main diagram() function is essentially equivalent to flexigrid() wrapped in cetz.canvas().

fletcher.flexigrid(
  ..args,
  spacing: number length pair,
  axes: array,
  max-layout-iterations: int,
  debug,
)