feat: new extendRenderer utility

This function allows to extend default renderers' model. This is
especially useful for content one wishes to be rendered inline.

packages/render-html/src/index.ts

@@ -18,3 +18,5 @@ export type { TNodeChildrenRendererProps } from './TNodeChildrenRenderer';
 export { default as TNodeRenderer } from './TNodeRenderer';
 export { default as useTRenderEngine } from './hooks/useTRenderEngine';
 export { default as useTTree } from './hooks/useTTree';
+export { default as defaultRenderers } from './render/defaultRenderers';
+export { default as extendRenderer } from './render/extendRenderer';

packages/render-html/src/render/RenderRegistry.ts

@@ -2,11 +2,9 @@ import { TNode } from '@native-html/transient-render-engine';
 import { ComponentType } from 'react';
 import { RendererProps } from '..';
 import lookupRecord from '../helpers/lookupRecord';
-import AnchorRenderer from '../renderers/AnchorRenderer';
-import ImageRenderer from '../renderers/ImageRenderer';
 import LineBreakRenderer from '../renderers/LineBreakRenderer';
-import ListRenderer from '../renderers/ListRenderer';
 import WordBreakRenderer from '../renderers/WordBreakRenderer';
+import defaultRenderers from './defaultRenderers';
 import {
   InternalTextContentRenderer,
   LiteRendererDeclaration,
@@ -18,13 +16,6 @@ const internalTextRenderers: Record<string, InternalTextContentRenderer> = {
   wbr: WordBreakRenderer
 };
 
-const defaultRenderers: RendererRecord = {
-  img: ImageRenderer,
-  ul: ListRenderer,
-  ol: ListRenderer,
-  a: AnchorRenderer
-};
-
 export default class RenderRegistry {
   private readonly renderers: RendererRecord = defaultRenderers;
 

packages/render-html/src/render/defaultRenderers.ts

@@ -0,0 +1,13 @@
+import AnchorRenderer from '../renderers/AnchorRenderer';
+import ImageRenderer from '../renderers/ImageRenderer';
+import ListRenderer from '../renderers/ListRenderer';
+import { RendererRecord } from './render-types';
+
+const defaultRenderers: RendererRecord = {
+  img: ImageRenderer,
+  ul: ListRenderer,
+  ol: ListRenderer,
+  a: AnchorRenderer
+};
+
+export default defaultRenderers;

packages/render-html/src/render/extendRenderer.ts

@@ -0,0 +1,33 @@
+import React from 'react';
+import { HTMLContentModel } from '@native-html/transient-render-engine';
+import {
+  LiteRendererDeclaration,
+  RendererDeclaration,
+  RendererFromContentModel,
+  RendererSpecs
+} from './render-types';
+
+/**
+ * Extend a default renderer to specialize its element model.
+ *
+ * @param Renderer - The component to extend.
+ * @param model - The new element model.
+ */
+export default function extendRenderer<N extends HTMLContentModel>(
+  Renderer: RendererDeclaration<any>,
+  model: RendererSpecs<N>['model']
+) {
+  if (typeof Renderer === 'function') {
+    const localRenderer = Renderer;
+    const newRenderer: RendererFromContentModel<N> = function () {
+      return React.createElement(localRenderer as any, arguments[0]);
+    } as any;
+    newRenderer.displayName = Renderer.displayName;
+    newRenderer.model = model as any;
+    return newRenderer;
+  }
+  return {
+    ...Renderer,
+    model
+  } as LiteRendererDeclaration<N>;
+}