GraphCompose v2.2.0 — right to left

[DemchaAV]

The banner above is itself a GraphCompose document — rendered by the engine from the same DSL you'd use in your app. Its last page sets a word in each of the five bundled scripts; the Hebrew and Arabic on it were laid out by the code this release is about.

GraphCompose v2.2.0 is on Maven Central. The theme: documents that read right to left.

A paragraph — or a table cell — says which way it runs, and Hebrew and Arabic lay out, shape, join and mirror correctly through PDF, PowerPoint and Word. Nothing else moves: a line with no right-to-left character never enters the algorithm, and the layout snapshots and pixel baselines did not shift.

• direction(RTL), LTR, or AUTO on ParagraphBuilder and on DocumentTableStyle — the cell form inherits down the cascade a cell style already follows, so one call turns a whole table round. AUTO reads the direction off the first strong character, per cell.
• Lines resolve through the Unicode Bidirectional Algorithm, so a Latin word or a number inside Hebrew keeps running forwards and paired punctuation faces what it encloses. Arabic is shaped into its contextual forms before the line is measured, so an auto column is sized to the letters the page draws rather than to wider isolated ones.
• Each backend is told what its own text engine needs. A PDF is painted, so the engine resolves the line itself and writes each reordered run with its text as written — a reader copies out the letters an author typed, not the order they were drawn in. Word gets w:bidi and the complex-script twins; PowerPoint gets a declared direction per frame. The differences are recorded per capability in the backend capability matrix.
• Five script families ship with the library — Amiri, David Libre, Noto Sans Georgian, Noto Sans Armenian, Gothic A1 — and a PowerPoint deck now embeds the family it drew with instead of naming a font the reader may not have installed.

A table cell written as a plain string is the case worth calling out: it reached the page through the table's own layout rather than the text pipeline, so the same string that set correctly in a paragraph drew reversed in a cell, with Arabic in isolated letters. That path is fixed, and the scenarios are held by coordinate assertions and pixel baselines across all three formats.

Known limit: Indic reordering is not performed. Devanagari and its relatives render with their code points in logical order.

Install:

<dependency>
    <groupId>io.github.demchaav</groupId>
    <artifactId>graph-compose</artifactId>
    <version>2.2.0</version>
</dependency>

Nothing breaks 2.1 — the direction calls are additive, and a document that never names one renders exactly as before. Bundled fonts live in graph-compose-fonts; add graph-compose-render-pptx or -render-docx for the other two backends.

Release notes: https://github.com/DemchaAV/GraphCompose/releases/tag/v2.2.0
Maven Central: https://central.sonatype.com/artifact/io.github.demchaav/graph-compose/2.2.0
Showcase: https://demchaav.github.io/GraphCompose/

As always — author intent, not coordinates.