Wrapping, line breaks & spacing

Branching inside EnhancedTextRenderer.renderText:

1. If textOnCurve is set → curved renderer (auto word-wrap is skipped — use \\n only for stacked arcs).
2. Else if layout.maxWidth (or legacy maxWidth) is set → computeWrappedTextLines + renderWrappedText.
3. Else renderSingleLine — still splits on \\n for manual multi-line blocks.

Prefer layout; nested keys override flat lineHeight, letterSpacing, wordSpacing, maxWidth, maxHeight (resolveTextLayout).

#Word wrap (layout.maxWidth)

• Words come from explicitLine.split(' '); ctx.measureText(testLine) decides overflow.
• Hard \\n in text starts a new paragraph segment; empty segments between newlines can yield blank lines when multiple \\n groups exist (same trimming rules as computeWrappedTextLines in text-layout.ts).
• When adding the next word would exceed maxWidth, the current line commits and the word starts a new line.

#Height cap (layout.maxHeight)

maxLines = floor(maxHeight / lineHeightPx) where lineHeightPx = (layout.lineHeight || 1.4) * fontSize.

When maxLines is exceeded mid-wrap, the remainder collapses to '...' on that line (computeWrappedTextLines).

#Line height multiplier (layout.lineHeight)

Unitless multiplier × font.size for vertical stride between wrapped lines and explicit \\n rows (defaults 1.4 when omitted).

#Letter & word spacing

Spacing participates in measureText — including arc layout (grapheme centres use cumulative widths with the same context settings).

#Examples

Manual lines (no auto wrap)

1await painter.createText(2  {3    text: 'Line one\nLine two',4    x: 40,5    y: 60,6    font: { size: 28, family: 'Arial' },7    layout: { lineHeight: 1.35 },8  },9  buffer10);

Auto wrap + tall box clamp

1await painter.createText(2  {3    text: longParagraph,4    x: 40,5    y: 80,6    layout: {7      maxWidth: 520,8      maxHeight: 220,9      lineHeight: 1.45,10      letterSpacing: 0.5,11      wordSpacing: 2,12    },13  },14  buffer15);