feat(iOS): custom style

[kacperzolkiewski]

Summary

Add custom style for foreground and background colors handling

Test Plan

Run the example app and experiment with applying foreground and background colors through the toolbar across different text styles.

Screenshots / Videos

Screen.Recording.2026-06-17.at.13.38.30.mov

Compatibility

OS	Implemented
iOS	✅
Android	❌

Checklist

• E2E tests are passing
• Required E2E tests have been added (if applicable)

[Copilot]

Pull request overview

Adds an iOS-only “custom style” layer to support per-range foreground/background colors, including native commands/state events and HTML span parsing/serialization.

Changes:

• Exposes a new setStyle imperative command and emits customStyle in state/context-menu events.
• Implements iOS CustomStyle/CustomStyleData to apply per-range colors and integrates it into style application priority.
• Parses <span style="color: ...; background-color: ..."> into native style data and serializes custom styles back to HTML.

Reviewed changes

Copilot reviewed 23 out of 23 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
src/web/useOnChangeState.ts	Adds default customStyle fields to the web state shape.
src/web/EnrichedTextInput.tsx	Adds a setStyle no-op to the web imperative handle.
src/types.ts	Extends public TS types with customStyle and setStyle(...).
src/spec/EnrichedTextInputNativeComponent.ts	Adds customStyle to events and introduces the setStyle native command in the codegen spec.
src/native/EnrichedTextInput.tsx	Implements setStyle command payload creation (processColor + JSON).
ios/utils/StyleUtils.mm	Registers CustomStyle in conflict/blocking maps and style registries.
ios/textHtmlParser/TextHtmlParser.mm	Applies CustomStyle when processing styles from HTML (viewer path).
ios/styles/EnrichedTextStyles.mm	Adds EnrichedTextCustomStyle implementation hook.
ios/styles/CustomStyle.mm	New iOS style implementation applying fg/bg colors via attributed text.
ios/interfaces/StyleTypeEnum.h	Adds Custom style type.
ios/interfaces/StyleHeaders.h	Declares CustomStyle interface in shared style headers.
ios/interfaces/StyleBase.mm	Introduces stylePriority default implementation.
ios/interfaces/StyleBase.h	Exposes stylePriority on the base style protocol.
ios/interfaces/EnrichedTextStyleHeaders.h	Adds EnrichedTextCustomStyle header.
ios/inputHtmlParser/InputHtmlParser.mm	Applies CustomStyle when processing styles from HTML (input path).
ios/inputAttributesManager/InputAttributesManager.mm	Changes style application ordering to use stylePriority.
ios/htmlParser/HtmlParser.mm	Parses/serializes custom styles as <span style="..."> and splits spans when data changes.
ios/extensions/ColorExtension.mm	Adds rgba string conversion + rgba parsing helpers.
ios/extensions/ColorExtension.h	Declares rgba helpers in the UIColor category.
ios/EnrichedTextInputView.mm	Implements setStyle command handling and emits customStyle in events.
ios/customStyleData/CustomStyleData.mm	New data object storing fg/bg UIColors with merge/equality/copy.
ios/customStyleData/CustomStyleData.h	Declares CustomStyleData API.
apps/example/src/constants/editorConfig.ts	Extends example default editor state with customStyle.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 24 out of 24 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 28 out of 31 changed files in this pull request and generated 6 comments.

[hejsztynx]

Currently you can't see the selection when background color is set

Screen.Recording.2026-07-29.at.10.39.38.mov

The background and foreground colors are dimmed up in a codeblock, it doesn't happen on other platforms

Probably not in this PR's scope, but when text alignment is set and the text wraps, the background color fills up the whole line. This also applies to mentions.

Screen.Recording.2026-07-29.at.10.42.28.mov

[kacperzolkiewski]

@hejsztynx,

1. I applied the same behavior we use for other editor colors (e.g. inside code blocks): if the user doesn't provide an opacity value, one is added automatically.
2. I would leave it like this in first iteration. Android behaves similar to iOS:

The problem is not straightforward to resolve. On iOS, custom style backgrounds are applied via NSBackgroundColorAttributeName on the text storage, while code block backgrounds are drawn manually as UIBezierPath filled rects in LayoutManagerExtension one per line, stretched to the full container width. These two layers are completely independent, so making them work together would require splitting the code block rects around the custom-colored ranges.

3. Yes there is a bug but it should be fix in separate PR the same issue occur with inline code:

[hejsztynx]

Functionally looks great!

[szydlovsky]

why do images conflict with the fg/bg color? I think there's nothing stopping these working together.

[kacperzolkiewski]

Wait, but images don't have a CustomStyle set as conflicting/blocking?

[szydlovsky]

Here as well, I don't see why image can't be used within fg/bg color.

[kacperzolkiewski]

As above