Mixed formatting runs within a single text box (#40)

[leogdion]

Part of #40. Render verification passed (2026-07-31 human pass). Note on merge order: this PR renames the public DSL surface (Text→TextBox), so it should now merge before the v0.1.0 tag — otherwise v0.1.0 ships an API that is renamed immediately after.

Summary

• DSL — the drawable is now TextBox (renamed from Text); a styled span inside it is Text (renamed from TextRun): TextBox { Text("Bold").bold(); Text(" plain") }. Builders never accept a bare String — every span is an explicit Text. Item-level modifiers on TextBox still style the whole item.
• Lowering — AuthoredSlide.TextItem.Run spans alongside the item-wide fields; hasRunFormatting gates the new path.
• Surgery — one TSWP.CharacterStyleArchive (registry type 2021) minted per span onto tableCharStyle, keyed by UTF-16 start offset. Plain spans get override-free styles so no entry ever carries a zero-identifier reference. Every minted style gets the full edge set the Text formatting on authored Text items #37 render fix established: stylesheet styles list, storage record header objectReferences, slide-component externalReferences, uuid-map entries in both components, and color via charProperties.tsdFill. The item-wide paragraph-style variation is unchanged and composes with run overrides.
• Acceptance — new text_runs deck (9th in the catalog) as the render probe; AcceptanceDecks checklist extended.
• Docs — research/findings/text_formatting.md rewritten: it still described the abandoned pre-fix char-style spec; now covers both shipped mechanisms and the open render risk.

Test plan

• swift test — all targets green, incl. new TextRunTests (entries/offsets, override bags, registration edges, plain-runs fallback, item+run composition) and the structural gate over the new deck (full decode + UUID-map invariants)
• LINT_MODE=STRICT ./Scripts/lint.sh
• Render verification in Keynote 15.3 (2026-07-31 human pass: mixed formatting renders correctly in one box) — text_runs.key: "Bold red" large bold red, "italic" italic, spans between plain, all in ONE box. Must be render-level (AppleScript slide-image export), not open-level: this mechanism previously opened cleanly but rendered plain (pre-edge-fix attempt). If it renders plain, diff against a Keynote-scripted reference per the findings doc.

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: f3ce3258-f829-44e7-8cb8-f1c2522ac895

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}