Add text wrapping function

[lawreka]

Resolves #5081
Addresses #4652
Follow-up to #5108

Changes:

Adds textWrap function to specify how lines of text are wrapped within a text box. This requires a max-width set on the text area, specified in text() as parameter x2.

• WORD wrap style only breaks lines at spaces. A single string without spaces that exceeds the boundaries of the canvas or text area is not truncated, and will overflow the desired area, disappearing at the canvas edge.
• CHAR wrap style breaks lines wherever needed to stay within the text box.

WORD is the default wrap style, and both styles will still break lines at any line breaks (\n) specified in the original text. The text area max-height parameter (y2) also still applies to wrapped text in both styles, lines of text that do not fit within the text area will not be drawn to the screen.

I may have gone a little overboard adding documentation and examples, specifically the last one with the little screaming stick-man demonstrating the current lack of truncation. He should be removed if additional functionality is added in the future to deal with truncation and hyphenation, but for now I think he shows kind of a fun way to work with #4652.

I also added an example using Chinese characters, since as @dhowe mentioned in discussion, textWrap(CHAR) is essential for displaying text in character-based languages nicely.

Screenshots of the change:

PR Checklist

• npm run lint passes
• [Inline documentation] is included / updated
• [Unit tests] are included / updated

[outofambit]

I may have gone a little overboard adding documentation and examples

there's no such thing! :) thanks again @lawreka.

@dhowe @lmccart thoughts on this approach?

[dhowe]

Looks good to me, thanks @lawreka !

[limzykenneth]

Loved the examples and code looks nice and clean as well! Happy to have this merged when ready.