feat: add TText renderer to override all text nodes, including anonymous text

[keerbee-dev]

Summary

This PR adds support for a new special key TText in the renderers prop to override the rendering of all text nodes, including anonymous text (text without an enclosing HTML tag).

The Problem

Currently, custom renderers are resolved only by tagName. Anonymous text has tagName === null, so it cannot be intercepted. Developers must override every possible tag (p, span, div, …) and still miss anonymous text.

Example

<div>
  This is anonymous text   <!-- ❌ Cannot be overridden -->
  <span>Tagged text</span> <!-- ✅ Can be overridden via "span" key -->
</div>

The Fix

Modify RenderRegistry.getRendererConfigForTNode to check for TText when tnode.type === 'text' and no custom renderer was found by tagName.

Implementation

getRendererConfigForTNode<T extends TNode>(tnode: T): RendererConfig<T> {
  let custom = this.getCustomRendererForTNode(tnode);

  if (!custom && tnode.type === 'text') {
    const textRenderer = this.customRenderers['TText'];
    if (textRenderer) {
      custom = textRenderer as any;
    }
  }

  return {
    Custom: custom,
    Default: this.getDefaultRendererForTNode(tnode)
  };
}

[5ZYSZ3K]

Hi, it is a great idea!
I have a very specific HTML parsing in my project just to be able to mimic this feature
I was thinking of that but unfortunately I had no time

I'll get that reviewed this week

[5ZYSZ3K]

Hi @keerbee-dev
Do you think you would be able to isolate the text renderer to a separate prop?
I don't want to have it mixed with tag renderers, text renderer seems to be a separate thing

[keerbee-dev]

Hi, 5ZYSZ3K
Yes, that makes sense. I initially added TText as a quick working solution for my project, but I agree that a separate textRenderer prop would be cleaner than mixing it with tag renderers.

I’ll update the PR later this week when I have some time.

[jsamr]

Definitely won't allow an any type assertion! That's a well established source of bugs, and it defies the purpose of using TypeScript.

[jsamr]

I also agree with Paweł that it should not be treated as a custom renderer, which are defined for HTML tags, not transient nodes. It's actually a lower level brick that would replace any TText rendering.