Text to be laid out as a single paragraph.

May be divided into any number of neighbouring spans, each of which will be represented as a separate SpanLayout in the resulting layout.

The input text must be encoded as UTF-8 in a contiguous byte array.

You may need to use Data.Text.Internal in order to determine the byte array and the necessary offsets to construct the paragraph without copying data.

For simple use cases, it may be sufficient to construct paragraphs using ParagraphConstruction.

Determines the preferred line height of text in the resulting layout.

Defines options relevant to the entire paragraph.

This record type is likely to be extended in the future. Use defaultParagraphOptions and update it with specific record selectors instead of constructing ParagraphOptions directly.

In order to get CSS defaults, use:

defaultParagraphOptions { paragraphAlignment = AlignStart }

ParagraphOptions with backwards-compatible values.

Note that this sets paragraphAlignment to AlignLeft, whereas the CSS default should be AlignStart.

Font to be used for shaping and measurement. Make sure to set its scale (see optionScale) using the same units that you want in the output.

Preferred line height of the resulting fragments.

Line width at which line breaking should occur. Lines will be broken at language-appropriate boundaries. If a line still exceeds this limit then, it will be broken at character boundaries, and if it already consists of a single cluster that cannot be further broken down, it will overflow.

A paragraph is broken into spans by the caller.

Each span could have a different font family, size, style, text decoration, colour, language, etc.

Defines options relevant to the layout of a single span of text.

This record type is likely to be extended in the future. Use defaultSpanOptions and update it with specific record selectors instead of constructing SpanOptions directly.

SpanOptions with default values.

IETF BCP 47 language tag, such as the value expected to be found in the HTML lang attribute, specifying the primary language for the span's text content. An empty string explicitly means "language unknown".

Used for selecting the appropriate glyphs and line breaking rules, primarily in East Asian languages.

Calculate the offsets into the Paragraph's underlying Array where each span starts and ends, in ascending order. The resulting list will be one larger than the list of input spans.

You can use this function to verify that Balkón will slice the input text correctly.

Turn each span of the input Paragraph into a Text.

You can use this function to verify that Balkón will slice the input text correctly.

Turn all spans of the input Paragraph into one combined Text.

You can use this function to verify that Balkón will slice the input text correctly.

Lay out a paragraph of plain text using a single font.

The resulting layout of the whole paragraph.

The resulting layout of each span, which may include multiple fragments as required by line breaking, text writing direction, and changes of script.

A unit of text laid out in a rectangular area.

Roughly equivalent to the term text fragment as used in CSS Display Module Level 3.

An input span (or text sequence in CSS terms) can be broken into multiple fragments because of line breaking, because of bidirectional ordering, or because it contains glyphs from multiple scripts.

Describes the relationship of a fragment to an inline box that contains it.

A box can have many fragments, and a fragment contained by a box is also contained by all ancestors of that box.

The root inline box, which forms the basis of each paragraph, is implied and not described by this type of record.

Describes either the absence, or the presence and size, of a box edge at a given position.