Layout

Backend-neutral layout values for Spectra.

These constructors describe intent. They deliberately contain no measured coordinates or Typst-specific layout state; a Pict is plain data a backend interprets later, which is why building one needs no effects and shows as the constructors it is made of:

fn main() = println(show(column(8, [text("hi")])))

Layout.Column(8, Layout.Left, [Layout.Text(Layout.TextStyle { size = 0, color = "", align = Layout.Left }, [Layout.Plain("hi")])])

Types

`Align`

type Align = Left | Center | Right deriving (Eq, Show)

Horizontal alignment of a picture’s children.

`FitMode`

type FitMode = Contain | Cover deriving (Eq, Show)

How a picture fills the box it is fitted into: letterboxed inside it, or filling it and cropping the overflow.

`Inline`

type Inline
  = Plain(String)
  | Emphasis(List(Inline))
  | Strong(List(Inline))
  | InlineCode(String)
  | Link(String, List(Inline))
  | Colored(String, List(Inline))
  deriving (Eq, Show)

A span of inline text: plain characters, an emphasis or strength wrapper, inline code, a link, or a color role.

`TextStyle`

type TextStyle = TextStyle {
  size: Int,
  color: String,
  align: Align
} deriving (Eq, Show)

The type settings of a text picture. A size of zero and an empty color both mean “whatever the theme says”.

`Pict`

type Pict
  = Empty
  | Text(TextStyle, List(Inline))
  | CodeBlock(String, String)
  | Image(String)
  | Rectangle(String, Int, Int)
  | Row(Int, List(Pict))
  | Column(Int, Align, List(Pict))
  | Overlay(List(Pict))
  | Inset(Int, Int, Int, Int, Pict)
  | Fit(FitMode, Pict)
  | Fragment(Int, Pict)
  | RawTypst(String)
  deriving (Eq, Show)