[m-mdy-m]

Summary

Documents a candidate production text architecture for GUI-SDL:

• strict UTF-8 source-byte mapping (the separate implementation step is in PR feat(gui-sdl): add reversible UTF-8 display mapping #30);
• UAX feat(gui-sdl): add nested splitter hit targets #29 grapheme segmentation and UAX fix(tui): diagnose rejected flush groups and requests #9 paragraph bidi;
• candidate SDL3_ttf + HarfBuzz/FreeType and FriBidi integration;
• font fallback, directional runs, wrapping and byte-to-cluster mapping;
• cursor/selection/hit-test projection, bounded layout caches and conformance tests;
• cross-platform native builds, license notices and installed-consumer requirements.

Governance / scope

This is an engineering proposal only. It does not pin dependencies, add a font stack, enable capabilities or claim that the Unicode renderer is implemented. The candidate must pass an actual cross-platform build/prototype and license/package review before use.

Related: Frontend #15 Phase 6; Spec #14 and #21 remain separate protocol gates.

[chatgpt-codex-connector]

Codex Review Summary: ❌ Failed

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	❌ Failed 2026-11-07T20:10:36.495937Z We couldn’t complete this review. Comment @codex review to try again.	565822f	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.