@grom.js/tgx 0.5.2 → 1.0.0

package/README.md

@@ -1,5 +1,8 @@
 ![tgx](tgx.png)
 
+[![npm](https://img.shields.io/npm/v/%40grom.js%2Ftgx?style=flat&logo=npm&logoColor=%23BB443E&logoSize=auto&label=Latest&labelColor=%23fff&color=%23BB443E)](https://www.npmjs.com/package/@grom.js/tgx)
+[![jsr](https://img.shields.io/jsr/v/%40grom/tgx?style=flat&logo=jsr&logoColor=%231B3646&logoSize=auto&label=Latest&labelColor=%23F3E051&color=%231B3646)](https://jsr.io/@grom/tgx)
+
 [JSX](https://facebook.github.io/jsx/) runtime for composing Telegram messages.
 
 ## Installation
@@ -8,7 +11,7 @@
 # Using npm
 npm install @grom.js/tgx
 
-# Using jsr
+# Using JSR
 deno add jsr:@grom/tgx
 ```
 
@@ -18,29 +21,29 @@ Then in your `tsconfig.json`:
 {
   "compilerOptions": {
     "jsx": "react-jsx",
-    "jsxImportSource": "@grom.js/tgx" // "@grom/tgx" for jsr
+    "jsxImportSource": "@grom.js/tgx" // "@grom/tgx" for JSR
     // ...
   }
 }
 ```
 
-## Example
+## Examples
 
 Usage with [grammY](https://grammy.dev):
 
-```tsx
-import { html } from '@grom.js/tgx'
+```jsx
 import { Bot } from 'grammy'
+import { renderHtml } from '@grom.js/tgx'
 
-function Greeting(props: { name: string }) {
-  return <>Hello, <b>{props.name}</b>!</>
-}
+const Greeting = (props) => (
+  <>Hello, <b>{props.name}</b>!</>
+)
 
 const bot = new Bot(/* TOKEN */)
 
 bot.command('start', async (ctx) => {
   await ctx.reply(
-    html(<Greeting name={ctx.from.first_name} />),
+    renderHtml(<Greeting name={ctx.from.first_name} />),
     { parse_mode: 'HTML' }
   )
 })
@@ -48,6 +51,21 @@ bot.command('start', async (ctx) => {
 bot.start()
 ```
 
+Usage with [effect-tg](https://github.com/grom-dev/effect-tg):
+
+```jsx
+import { Content, Dialog, Send, Text } from 'effect-tg'
+
+const Greeting = (props) => (
+  <>Hello, <b>{props.name}</b>!</>
+)
+
+const greet = (id, name) => Send.sendMessage({
+  dialog: Dialog.user(id),
+  content: Content.text(Text.tgx(<Greeting name={name} />))
+})
+```
+
 ## License
 
 [MIT](./LICENSE)

package/dist/index.d.ts

@@ -1 +1,3 @@
-export { html } from './html.ts';
+export * from './jsx.ts';
+export * from './render.ts';
+export * from './types.ts';

package/dist/index.js

@@ -1 +1,4 @@
-export { html } from "./html.js";
+export * from "./jsx.js";
+export * from "./render.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/dist/jsx-runtime.d.ts

@@ -1,17 +1,17 @@
-import type { FunctionComponent, NativeElements, TgxElement } from './types.ts';
+import type * as Tgx from './types.ts';
 import { Fragment } from './jsx.ts';
 declare function jsx(type: any, props: any, key: any): any;
 export { Fragment, jsx, jsx as jsxDEV, jsx as jsxs, };
 export declare namespace JSX {
-    type Element = TgxElement;
-    type ElementType = keyof NativeElements | FunctionComponent;
+    type Element = Tgx.TgxElement;
+    type ElementType = keyof IntrinsicElements | Tgx.Component;
     interface ElementAttributesProperty {
         props: {};
     }
     interface ElementChildrenAttribute {
         children: {};
     }
-    interface IntrinsicElements extends NativeElements {
+    interface IntrinsicElements extends Tgx.IntrinsicElements {
     }
     interface IntrinsicAttributes {
     }

package/dist/jsx-runtime.js

@@ -1,10 +1,11 @@
-import { Fragment, render } from "./jsx.js";
+import { createElement, Fragment } from "./jsx.js";
 function jsx(type, props, key) {
     const { children } = props;
     delete props.children;
     if (arguments.length > 2) {
         props.key = key;
     }
-    return render(type, props, children);
+    return createElement(type, props, children);
 }
 export { Fragment, jsx, jsx as jsxDEV, jsx as jsxs, };
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/jsx-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.js","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAElD,SAAS,GAAG,CAAC,IAAS,EAAE,KAAU,EAAE,GAAQ;IAC1C,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAA;IAC1B,OAAO,KAAK,CAAC,QAAQ,CAAA;IACrB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,GAAG,GAAG,GAAG,CAAA;IACjB,CAAC;IACD,OAAO,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;AAC7C,CAAC;AAED,OAAO,EACL,QAAQ,EACR,GAAG,EACH,GAAG,IAAI,MAAM,EACb,GAAG,IAAI,IAAI,GACZ,CAAA"}

package/dist/jsx.d.ts

@@ -1,6 +1,7 @@
-import type { FunctionComponent, NativeElements, TgxElement, TgxFragmentElement, TgxNode } from './types.ts';
-export declare function render<T extends keyof NativeElements>(type: T, props: NativeElements[T], children: TgxNode): TgxElement;
-export declare function render(type: FunctionComponent, props: any, children: TgxNode): TgxElement;
+import type { Component, IntrinsicElements, TgxElement, TgxElementFragment, TgxNode } from './types.ts';
+export declare function createElement<T extends keyof IntrinsicElements>(type: T, props: IntrinsicElements[T], children: TgxNode): TgxElement;
+export declare function createElement(type: Component, props: any, children: TgxNode): TgxElement;
 export declare function Fragment(props?: {
     children?: TgxNode;
-}): TgxFragmentElement;
+}): TgxElementFragment;
+export declare function isIntrinsicElement(name: string): name is keyof IntrinsicElements;

package/dist/jsx.js

@@ -1,6 +1,6 @@
-export function render(type, props, children) {
-    if (typeof type === 'string' && isNativeTag(type)) {
-        return renderNativeElement({
+export function createElement(type, props, children) {
+    if (typeof type === 'string' && isIntrinsicElement(type)) {
+        return createElementIntrinsic({
             tag: type,
             props: { ...props, children },
         });
@@ -28,21 +28,22 @@ function elementsFromNode(node) {
         return node.flatMap(child => elementsFromNode(child));
     return [node];
 }
-function isNativeTag(tag) {
-    return ([
-        'b',
-        'i',
-        'u',
-        's',
-        'spoiler',
-        'a',
-        'emoji',
-        'code',
-        'codeblock',
-        'blockquote',
-    ]).includes(tag);
+const INTRINSIC_ELEMENTS = new Set([
+    'b',
+    'i',
+    'u',
+    's',
+    'spoiler',
+    'a',
+    'emoji',
+    'code',
+    'codeblock',
+    'blockquote',
+]);
+export function isIntrinsicElement(name) {
+    return INTRINSIC_ELEMENTS.has(name);
 }
-function renderNativeElement(options) {
+function createElementIntrinsic(options) {
     switch (options.tag) {
         case 'b':
             return {
@@ -106,3 +107,4 @@ function renderNativeElement(options) {
             };
     }
 }
+//# sourceMappingURL=jsx.js.map

package/dist/jsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.js","sourceRoot":"","sources":["../src/jsx.ts"],"names":[],"mappings":"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"}

package/dist/render.d.ts

@@ -0,0 +1,6 @@
+import type { TgxElement } from './types.ts';
+/**
+ * Converts {@link TgxElement} to a string formatted for Telegram's
+ * [HTML parse mode](https://core.telegram.org/bots/api#html-style).
+ */
+export declare function renderHtml(tgx: TgxElement | TgxElement[]): string;

package/dist/render.js

@@ -0,0 +1,47 @@
+/**
+ * Converts {@link TgxElement} to a string formatted for Telegram's
+ * [HTML parse mode](https://core.telegram.org/bots/api#html-style).
+ */
+export function renderHtml(tgx) {
+    return (Array.isArray(tgx) ? tgx : [tgx])
+        .map((el) => {
+        switch (el.type) {
+            case 'text': return renderTextElement(el);
+            case 'plain': return renderPlainElement(el);
+            case 'fragment': return renderHtml(el.subelements);
+        }
+        throw new Error(`Unknown element: ${el}.`);
+    })
+        .join('');
+}
+function renderTextElement(el) {
+    switch (el.entity.type) {
+        case 'bold': return `<b>${renderHtml(el.subelements)}</b>`;
+        case 'italic': return `<i>${renderHtml(el.subelements)}</i>`;
+        case 'underline': return `<u>${renderHtml(el.subelements)}</u>`;
+        case 'strikethrough': return `<s>${renderHtml(el.subelements)}</s>`;
+        case 'spoiler': return `<tg-spoiler>${renderHtml(el.subelements)}</tg-spoiler>`;
+        // TODO: Shouldn't we urlencode this?
+        case 'link': return `<a href="${el.entity.url}">${renderHtml(el.subelements)}</a>`;
+        case 'custom-emoji': return `<tg-emoji emoji-id="${el.entity.id}">${el.entity.alt}</tg-emoji>`;
+        case 'code': return `<code>${renderHtml(el.subelements)}</code>`;
+        case 'codeblock': return (el.entity.language
+            ? `<pre><code class="language-${el.entity.language}">${renderHtml(el.subelements)}</code></pre>`
+            : `<pre>${renderHtml(el.subelements)}</pre>`);
+        case 'blockquote': return (el.entity.expandable
+            ? `<blockquote expandable>${renderHtml(el.subelements)}</blockquote>`
+            : `<blockquote>${renderHtml(el.subelements)}</blockquote>`);
+    }
+}
+function renderPlainElement({ value }) {
+    if (value == null || typeof value === 'boolean')
+        return '';
+    return sanitize(String(value));
+}
+function sanitize(unsafe) {
+    return unsafe
+        .replaceAll('&', '&amp;') // must be first
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;');
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,5 +1,4 @@
-import type { PrismLanguage, StringWithSuggestions } from './_utils/types.ts';
-export interface NativeElements {
+export interface IntrinsicElements {
     /**
      * Bold text.
      */
@@ -60,11 +59,9 @@ export interface NativeElements {
         /**
          * Programming or markup language of the block.
          *
-         * Telegram uses libprisma for code highlighting,
-         * so the following languages are supported:
-         * https://github.com/TelegramMessenger/libprisma#supported-languages
+         * @see https://github.com/TelegramMessenger/libprisma#supported-languages
          */
-        lang?: StringWithSuggestions<PrismLanguage>;
+        lang?: (string & {}) | 'markup' | 'html' | 'xml' | 'svg' | 'mathml' | 'ssml' | 'atom' | 'rss' | 'css' | 'clike' | 'regex' | 'javascript' | 'js' | 'abap' | 'abnf' | 'actionscript' | 'ada' | 'agda' | 'al' | 'antlr4' | 'g4' | 'apacheconf' | 'sql' | 'apex' | 'apl' | 'applescript' | 'aql' | 'c' | 'cpp' | 'arduino' | 'ino' | 'arff' | 'armasm' | 'arm-asm' | 'bash' | 'sh' | 'shell' | 'yaml' | 'yml' | 'markdown' | 'md' | 'arturo' | 'art' | 'asciidoc' | 'adoc' | 'csharp' | 'cs' | 'dotnet' | 'aspnet' | 'asm6502' | 'asmatmel' | 'autohotkey' | 'autoit' | 'avisynth' | 'avs' | 'avro-idl' | 'avdl' | 'awk' | 'gawk' | 'basic' | 'batch' | 'bbcode' | 'shortcode' | 'bbj' | 'bicep' | 'birb' | 'bison' | 'bnf' | 'rbnf' | 'bqn' | 'brainfuck' | 'brightscript' | 'bro' | 'cfscript' | 'cfc' | 'chaiscript' | 'cil' | 'cilkc' | 'cilk-c' | 'cilkcpp' | 'cilk-cpp' | 'cilk' | 'clojure' | 'cmake' | 'cobol' | 'coffeescript' | 'coffee' | 'concurnas' | 'conc' | 'csp' | 'cooklang' | 'ruby' | 'rb' | 'crystal' | 'csv' | 'cue' | 'cypher' | 'd' | 'dart' | 'dataweave' | 'dax' | 'dhall' | 'diff' | 'markup-templating' | 'django' | 'jinja2' | 'dns-zone-file' | 'dns-zone' | 'docker' | 'dockerfile' | 'dot' | 'gv' | 'ebnf' | 'editorconfig' | 'eiffel' | 'ejs' | 'eta' | 'elixir' | 'elm' | 'lua' | 'etlua' | 'erb' | 'erlang' | 'excel-formula' | 'xlsx' | 'xls' | 'fsharp' | 'factor' | 'false' | 'fift' | 'firestore-security-rules' | 'flow' | 'fortran' | 'ftl' | 'func' | 'gml' | 'gamemakerlanguage' | 'gap' | 'gcode' | 'gdscript' | 'gedcom' | 'gettext' | 'po' | 'git' | 'glsl' | 'gn' | 'gni' | 'linker-script' | 'ld' | 'go' | 'go-module' | 'go-mod' | 'gradle' | 'graphql' | 'groovy' | 'less' | 'scss' | 'textile' | 'haml' | 'handlebars' | 'hbs' | 'mustache' | 'haskell' | 'hs' | 'haxe' | 'hcl' | 'hlsl' | 'hoon' | 'hpkp' | 'hsts' | 'json' | 'webmanifest' | 'uri' | 'url' | 'http' | 'ichigojam' | 'icon' | 'icu-message-format' | 'idris' | 'idr' | 'ignore' | 'gitignore' | 'hgignore' | 'npmignore' | 'inform7' | 'ini' | 'io' | 'j' | 'java' | 'scala' | 'php' | 'javadoclike' | 'javadoc' | 'javastacktrace' | 'jolie' | 'jq' | 'typescript' | 'ts' | 'jsdoc' | 'n4js' | 'n4jsd' | 'json5' | 'jsonp' | 'jsstacktrace' | 'julia' | 'keepalived' | 'keyman' | 'kotlin' | 'kt' | 'kts' | 'kusto' | 'latex' | 'tex' | 'context' | 'latte' | 'scheme' | 'lilypond' | 'ly' | 'liquid' | 'lisp' | 'emacs' | 'elisp' | 'emacs-lisp' | 'livescript' | 'llvm' | 'log' | 'lolcode' | 'magma' | 'makefile' | 'mata' | 'matlab' | 'maxscript' | 'mel' | 'mermaid' | 'metafont' | 'mizar' | 'mongodb' | 'monkey' | 'moonscript' | 'moon' | 'n1ql' | 'nand2tetris-hdl' | 'naniscript' | 'nani' | 'nasm' | 'neon' | 'nevod' | 'nginx' | 'nim' | 'nix' | 'nsis' | 'objectivec' | 'objc' | 'ocaml' | 'odin' | 'opencl' | 'openqasm' | 'qasm' | 'oz' | 'parigp' | 'parser' | 'pascal' | 'objectpascal' | 'pascaligo' | 'psl' | 'pcaxis' | 'px' | 'peoplecode' | 'pcode' | 'perl' | 'phpdoc' | 'plant-uml' | 'plantuml' | 'plsql' | 'powerquery' | 'pq' | 'mscript' | 'powershell' | 'processing' | 'prolog' | 'promql' | 'properties' | 'protobuf' | 'stylus' | 'twig' | 'pug' | 'puppet' | 'purebasic' | 'pbfasm' | 'python' | 'py' | 'qsharp' | 'qs' | 'q' | 'qml' | 'qore' | 'r' | 'racket' | 'rkt' | 'cshtml' | 'razor' | 'jsx' | 'tsx' | 'reason' | 'rego' | 'renpy' | 'rpy' | 'rescript' | 'res' | 'rest' | 'rip' | 'roboconf' | 'robotframework' | 'robot' | 'rust' | 'sas' | 'sass' | 'shell-session' | 'sh-session' | 'shellsession' | 'smali' | 'smalltalk' | 'smarty' | 'sml' | 'smlnj' | 'solidity' | 'sol' | 'solution-file' | 'sln' | 'soy' | 'splunk-spl' | 'sqf' | 'squirrel' | 'stan' | 'stata' | 'iecst' | 'supercollider' | 'sclang' | 'swift' | 'systemd' | 'tact' | 't4-templating' | 't4-cs' | 't4' | 'vbnet' | 't4-vb' | 'tap' | 'tcl' | 'tt2' | 'toml' | 'ttcn' | 'ttcn3' | 'ttcn-3' | 'turtle' | 'trickle' | 'typescript-jsdoc' | 'typoscript' | 'tsconfig' | 'unrealscript' | 'uscript' | 'uc' | 'uri' | 'v' | 'vala' | 'vba' | 'vbscript' | 'velocity' | 'verilog' | 'vhdl' | 'vim' | 'visual-basic' | 'vb' | 'warpscript' | 'wasm' | 'web-idl' | 'webidl' | 'wgsl' | 'wiki' | 'wolfram' | 'mathematica' | 'nb' | 'wl' | 'xeora' | 'xeoracube' | 'xml-doc' | 'xojo' | 'xquery' | 'yaml' | 'yml' | 'yang' | 'zig';
     }>;
     /**
      * Block quotation. Can be expandable or not.
@@ -74,20 +71,20 @@ export interface NativeElements {
     }>;
 }
 export type TgxNode = TgxNode[] | TgxElement | string | number | boolean | null | undefined;
-export type PropsWithChildren<P = {}> = {
+export type PropsWithChildren<P = {}> = P & {
     children?: TgxNode;
-} & P;
-export type FunctionComponent = (props: any) => TgxElement;
-export type TgxElement = TgxPlainValueElement | TgxFragmentElement | TgxTextElement;
-export interface TgxPlainValueElement {
+};
+export type Component = (props: any) => TgxElement;
+export type TgxElement = TgxElementPlain | TgxElementFragment | TgxElementText;
+export interface TgxElementPlain {
     type: 'plain';
     value: string | number | boolean | null | undefined;
 }
-export interface TgxFragmentElement {
+export interface TgxElementFragment {
     type: 'fragment';
     subelements: TgxElement[];
 }
-export interface TgxTextElement {
+export interface TgxElementText {
     type: 'text';
     entity: TextEntity;
     subelements: TgxElement[];

package/dist/types.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@grom.js/tgx",
   "type": "module",
-  "version": "0.5.2",
+  "version": "1.0.0",
   "description": "JSX runtime for composing Telegram messages",
   "author": {
     "name": "Vladislav Deryabkin",
@@ -21,9 +21,6 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./types": {
-      "types": "./dist/types.d.ts"
-    },
     "./jsx-runtime": {
       "types": "./dist/jsx-runtime.d.ts",
       "import": "./dist/jsx-runtime.js"
@@ -34,7 +31,8 @@
     }
   },
   "files": [
-    "./dist/"
+    "./dist/",
+    "./src/"
   ],
   "engines": {
     "node": "22.x"

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './jsx.ts'
+export * from './render.ts'
+export * from './types.ts'

package/src/jsx-runtime.ts

@@ -0,0 +1,27 @@
+import type * as Tgx from './types.ts'
+import { createElement, Fragment } from './jsx.ts'
+
+function jsx(type: any, props: any, key: any): any {
+  const { children } = props
+  delete props.children
+  if (arguments.length > 2) {
+    props.key = key
+  }
+  return createElement(type, props, children)
+}
+
+export {
+  Fragment,
+  jsx,
+  jsx as jsxDEV,
+  jsx as jsxs,
+}
+
+export namespace JSX {
+  export type Element = Tgx.TgxElement
+  export type ElementType = keyof IntrinsicElements | Tgx.Component
+  export interface ElementAttributesProperty { props: {} }
+  export interface ElementChildrenAttribute { children: {} }
+  export interface IntrinsicElements extends Tgx.IntrinsicElements {}
+  export interface IntrinsicAttributes {}
+}

package/src/jsx.ts

@@ -0,0 +1,148 @@
+import type {
+  Component,
+  IntrinsicElements,
+  TgxElement,
+  TgxElementFragment,
+  TgxNode,
+} from './types.ts'
+
+export function createElement<T extends keyof IntrinsicElements>(
+  type: T,
+  props: IntrinsicElements[T],
+  children: TgxNode,
+): TgxElement
+export function createElement(
+  type: Component,
+  props: any,
+  children: TgxNode,
+): TgxElement
+export function createElement(
+  type: unknown,
+  props: any,
+  children: TgxNode,
+): TgxElement {
+  if (typeof type === 'string' && isIntrinsicElement(type)) {
+    return createElementIntrinsic({
+      tag: type,
+      props: { ...props, children },
+    })
+  }
+
+  if (typeof type === 'function')
+    return type({ ...props, children })
+
+  throw new Error(`Invalid JSX component: ${type}.`)
+}
+
+export function Fragment(props?: { children?: TgxNode }): TgxElementFragment {
+  return {
+    type: 'fragment',
+    subelements: elementsFromNode(props?.children ?? []),
+  }
+}
+
+function elementsFromNode(node: TgxNode): TgxElement[] {
+  switch (typeof node) {
+    case 'string':
+    case 'number':
+    case 'boolean':
+      return [{ type: 'plain', value: node }]
+  }
+
+  if (node == null)
+    return [{ type: 'plain', value: node }]
+
+  if (Array.isArray(node))
+    return node.flatMap(child => elementsFromNode(child))
+
+  return [node]
+}
+
+const INTRINSIC_ELEMENTS = new Set([
+  'b',
+  'i',
+  'u',
+  's',
+  'spoiler',
+  'a',
+  'emoji',
+  'code',
+  'codeblock',
+  'blockquote',
+])
+
+export function isIntrinsicElement(name: string): name is keyof IntrinsicElements {
+  return INTRINSIC_ELEMENTS.has(name as keyof IntrinsicElements)
+}
+
+function createElementIntrinsic(
+  options: {
+    [K in keyof IntrinsicElements]: {
+      tag: K
+      props: IntrinsicElements[K]
+    }
+  }[keyof IntrinsicElements],
+): TgxElement {
+  switch (options.tag) {
+    case 'b':
+      return {
+        type: 'text',
+        entity: { type: 'bold' },
+        subelements: elementsFromNode(options.props.children ?? []),
+      }
+    case 'i':
+      return {
+        type: 'text',
+        entity: { type: 'italic' },
+        subelements: elementsFromNode(options.props.children ?? []),
+      }
+    case 'u':
+      return {
+        type: 'text',
+        entity: { type: 'underline' },
+        subelements: elementsFromNode(options.props.children ?? []),
+      }
+    case 's':
+      return {
+        type: 'text',
+        entity: { type: 'strikethrough' },
+        subelements: elementsFromNode(options.props.children ?? []),
+      }
+    case 'spoiler':
+      return {
+        type: 'text',
+        entity: { type: 'spoiler' },
+        subelements: elementsFromNode(options.props.children ?? []),
+      }
+    case 'a':
+      return {
+        type: 'text',
+        entity: { type: 'link', url: options.props.href },
+        subelements: elementsFromNode(options.props.children ?? []),
+      }
+    case 'emoji':
+      return {
+        type: 'text',
+        entity: { type: 'custom-emoji', id: options.props.id, alt: options.props.alt },
+        subelements: [],
+      }
+    case 'code':
+      return {
+        type: 'text',
+        entity: { type: 'code' },
+        subelements: elementsFromNode(options.props.children ?? []),
+      }
+    case 'codeblock':
+      return {
+        type: 'text',
+        entity: { type: 'codeblock', language: options.props.lang },
+        subelements: elementsFromNode(options.props.children ?? []),
+      }
+    case 'blockquote':
+      return {
+        type: 'text',
+        entity: { type: 'blockquote', expandable: !!options.props.expandable },
+        subelements: elementsFromNode(options.props.children ?? []),
+      }
+  }
+}

package/src/render.ts

@@ -0,0 +1,59 @@
+import type { TgxElement, TgxElementPlain, TgxElementText } from './types.ts'
+
+/**
+ * Converts {@link TgxElement} to a string formatted for Telegram's
+ * [HTML parse mode](https://core.telegram.org/bots/api#html-style).
+ */
+export function renderHtml(tgx: TgxElement | TgxElement[]): string {
+  return (Array.isArray(tgx) ? tgx : [tgx])
+    .map((el) => {
+      switch (el.type) {
+        case 'text': return renderTextElement(el)
+        case 'plain': return renderPlainElement(el)
+        case 'fragment': return renderHtml(el.subelements)
+      }
+      throw new Error(`Unknown element: ${el satisfies never}.`)
+    })
+    .join('')
+}
+
+function renderTextElement(el: TgxElementText): string {
+  switch (el.entity.type) {
+    case 'bold': return `<b>${renderHtml(el.subelements)}</b>`
+    case 'italic': return `<i>${renderHtml(el.subelements)}</i>`
+    case 'underline': return `<u>${renderHtml(el.subelements)}</u>`
+    case 'strikethrough': return `<s>${renderHtml(el.subelements)}</s>`
+    case 'spoiler': return `<tg-spoiler>${renderHtml(el.subelements)}</tg-spoiler>`
+
+    // TODO: Shouldn't we urlencode this?
+    case 'link': return `<a href="${el.entity.url}">${renderHtml(el.subelements)}</a>`
+
+    case 'custom-emoji': return `<tg-emoji emoji-id="${el.entity.id}">${el.entity.alt}</tg-emoji>`
+    case 'code': return `<code>${renderHtml(el.subelements)}</code>`
+
+    case 'codeblock': return (
+      el.entity.language
+        ? `<pre><code class="language-${el.entity.language}">${renderHtml(el.subelements)}</code></pre>`
+        : `<pre>${renderHtml(el.subelements)}</pre>`
+    )
+
+    case 'blockquote': return (
+      el.entity.expandable
+        ? `<blockquote expandable>${renderHtml(el.subelements)}</blockquote>`
+        : `<blockquote>${renderHtml(el.subelements)}</blockquote>`
+    )
+  }
+}
+
+function renderPlainElement({ value }: TgxElementPlain): string {
+  if (value == null || typeof value === 'boolean')
+    return ''
+  return sanitize(String(value))
+}
+
+function sanitize(unsafe: string): string {
+  return unsafe
+    .replaceAll('&', '&amp;') // must be first
+    .replaceAll('<', '&lt;')
+    .replaceAll('>', '&gt;')
+}

package/src/types.ts

@@ -0,0 +1,520 @@
+export interface IntrinsicElements {
+  /**
+   * Bold text.
+   */
+  b: PropsWithChildren
+
+  /**
+   * Italic text.
+   */
+  i: PropsWithChildren
+
+  /**
+   * Underlined text.
+   */
+  u: PropsWithChildren
+
+  /**
+   * Strikethrough text.
+   */
+  s: PropsWithChildren
+
+  /**
+   * Spoiler.
+   */
+  spoiler: PropsWithChildren
+
+  /**
+   * Inline URL or Telegram (deep) link.
+   *
+   * Read more about Telegram deep links:
+   * https://core.telegram.org/api/links
+   */
+  a: PropsWithChildren<{
+    /**
+     * Link to open.
+     *
+     * @example "https://google.com"
+     * @example "tg://resolve?domain=BotFather"
+     */
+    href: string
+  }>
+
+  /**
+   * Custom Telegram emoji.
+   */
+  emoji: {
+    /**
+     * Unique identifier of the custom emoji.
+     */
+    id: string
+
+    /**
+     * Alternative emoji that will be shown instead of the custom emoji in
+     * places where a custom emoji cannot be displayed.
+     */
+    alt: string
+  }
+
+  /**
+   * Inline fixed-width code.
+   */
+  code: PropsWithChildren
+
+  /**
+   * Fixed-width code block with the optional programming language.
+   */
+  codeblock: PropsWithChildren<{
+    /**
+     * Programming or markup language of the block.
+     *
+     * @see https://github.com/TelegramMessenger/libprisma#supported-languages
+     */
+    lang?:
+      | (string & {})
+      | 'markup'
+      | 'html'
+      | 'xml'
+      | 'svg'
+      | 'mathml'
+      | 'ssml'
+      | 'atom'
+      | 'rss'
+      | 'css'
+      | 'clike'
+      | 'regex'
+      | 'javascript'
+      | 'js'
+      | 'abap'
+      | 'abnf'
+      | 'actionscript'
+      | 'ada'
+      | 'agda'
+      | 'al'
+      | 'antlr4'
+      | 'g4'
+      | 'apacheconf'
+      | 'sql'
+      | 'apex'
+      | 'apl'
+      | 'applescript'
+      | 'aql'
+      | 'c'
+      | 'cpp'
+      | 'arduino'
+      | 'ino'
+      | 'arff'
+      | 'armasm'
+      | 'arm-asm'
+      | 'bash'
+      | 'sh'
+      | 'shell'
+      | 'yaml'
+      | 'yml'
+      | 'markdown'
+      | 'md'
+      | 'arturo'
+      | 'art'
+      | 'asciidoc'
+      | 'adoc'
+      | 'csharp'
+      | 'cs'
+      | 'dotnet'
+      | 'aspnet'
+      | 'asm6502'
+      | 'asmatmel'
+      | 'autohotkey'
+      | 'autoit'
+      | 'avisynth'
+      | 'avs'
+      | 'avro-idl'
+      | 'avdl'
+      | 'awk'
+      | 'gawk'
+      | 'basic'
+      | 'batch'
+      | 'bbcode'
+      | 'shortcode'
+      | 'bbj'
+      | 'bicep'
+      | 'birb'
+      | 'bison'
+      | 'bnf'
+      | 'rbnf'
+      | 'bqn'
+      | 'brainfuck'
+      | 'brightscript'
+      | 'bro'
+      | 'cfscript'
+      | 'cfc'
+      | 'chaiscript'
+      | 'cil'
+      | 'cilkc'
+      | 'cilk-c'
+      | 'cilkcpp'
+      | 'cilk-cpp'
+      | 'cilk'
+      | 'clojure'
+      | 'cmake'
+      | 'cobol'
+      | 'coffeescript'
+      | 'coffee'
+      | 'concurnas'
+      | 'conc'
+      | 'csp'
+      | 'cooklang'
+      | 'ruby'
+      | 'rb'
+      | 'crystal'
+      | 'csv'
+      | 'cue'
+      | 'cypher'
+      | 'd'
+      | 'dart'
+      | 'dataweave'
+      | 'dax'
+      | 'dhall'
+      | 'diff'
+      | 'markup-templating'
+      | 'django'
+      | 'jinja2'
+      | 'dns-zone-file'
+      | 'dns-zone'
+      | 'docker'
+      | 'dockerfile'
+      | 'dot'
+      | 'gv'
+      | 'ebnf'
+      | 'editorconfig'
+      | 'eiffel'
+      | 'ejs'
+      | 'eta'
+      | 'elixir'
+      | 'elm'
+      | 'lua'
+      | 'etlua'
+      | 'erb'
+      | 'erlang'
+      | 'excel-formula'
+      | 'xlsx'
+      | 'xls'
+      | 'fsharp'
+      | 'factor'
+      | 'false'
+      | 'fift'
+      | 'firestore-security-rules'
+      | 'flow'
+      | 'fortran'
+      | 'ftl'
+      | 'func'
+      | 'gml'
+      | 'gamemakerlanguage'
+      | 'gap'
+      | 'gcode'
+      | 'gdscript'
+      | 'gedcom'
+      | 'gettext'
+      | 'po'
+      | 'git'
+      | 'glsl'
+      | 'gn'
+      | 'gni'
+      | 'linker-script'
+      | 'ld'
+      | 'go'
+      | 'go-module'
+      | 'go-mod'
+      | 'gradle'
+      | 'graphql'
+      | 'groovy'
+      | 'less'
+      | 'scss'
+      | 'textile'
+      | 'haml'
+      | 'handlebars'
+      | 'hbs'
+      | 'mustache'
+      | 'haskell'
+      | 'hs'
+      | 'haxe'
+      | 'hcl'
+      | 'hlsl'
+      | 'hoon'
+      | 'hpkp'
+      | 'hsts'
+      | 'json'
+      | 'webmanifest'
+      | 'uri'
+      | 'url'
+      | 'http'
+      | 'ichigojam'
+      | 'icon'
+      | 'icu-message-format'
+      | 'idris'
+      | 'idr'
+      | 'ignore'
+      | 'gitignore'
+      | 'hgignore'
+      | 'npmignore'
+      | 'inform7'
+      | 'ini'
+      | 'io'
+      | 'j'
+      | 'java'
+      | 'scala'
+      | 'php'
+      | 'javadoclike'
+      | 'javadoc'
+      | 'javastacktrace'
+      | 'jolie'
+      | 'jq'
+      | 'typescript'
+      | 'ts'
+      | 'jsdoc'
+      | 'n4js'
+      | 'n4jsd'
+      | 'json5'
+      | 'jsonp'
+      | 'jsstacktrace'
+      | 'julia'
+      | 'keepalived'
+      | 'keyman'
+      | 'kotlin'
+      | 'kt'
+      | 'kts'
+      | 'kusto'
+      | 'latex'
+      | 'tex'
+      | 'context'
+      | 'latte'
+      | 'scheme'
+      | 'lilypond'
+      | 'ly'
+      | 'liquid'
+      | 'lisp'
+      | 'emacs'
+      | 'elisp'
+      | 'emacs-lisp'
+      | 'livescript'
+      | 'llvm'
+      | 'log'
+      | 'lolcode'
+      | 'magma'
+      | 'makefile'
+      | 'mata'
+      | 'matlab'
+      | 'maxscript'
+      | 'mel'
+      | 'mermaid'
+      | 'metafont'
+      | 'mizar'
+      | 'mongodb'
+      | 'monkey'
+      | 'moonscript'
+      | 'moon'
+      | 'n1ql'
+      | 'nand2tetris-hdl'
+      | 'naniscript'
+      | 'nani'
+      | 'nasm'
+      | 'neon'
+      | 'nevod'
+      | 'nginx'
+      | 'nim'
+      | 'nix'
+      | 'nsis'
+      | 'objectivec'
+      | 'objc'
+      | 'ocaml'
+      | 'odin'
+      | 'opencl'
+      | 'openqasm'
+      | 'qasm'
+      | 'oz'
+      | 'parigp'
+      | 'parser'
+      | 'pascal'
+      | 'objectpascal'
+      | 'pascaligo'
+      | 'psl'
+      | 'pcaxis'
+      | 'px'
+      | 'peoplecode'
+      | 'pcode'
+      | 'perl'
+      | 'phpdoc'
+      | 'plant-uml'
+      | 'plantuml'
+      | 'plsql'
+      | 'powerquery'
+      | 'pq'
+      | 'mscript'
+      | 'powershell'
+      | 'processing'
+      | 'prolog'
+      | 'promql'
+      | 'properties'
+      | 'protobuf'
+      | 'stylus'
+      | 'twig'
+      | 'pug'
+      | 'puppet'
+      | 'purebasic'
+      | 'pbfasm'
+      | 'python'
+      | 'py'
+      | 'qsharp'
+      | 'qs'
+      | 'q'
+      | 'qml'
+      | 'qore'
+      | 'r'
+      | 'racket'
+      | 'rkt'
+      | 'cshtml'
+      | 'razor'
+      | 'jsx'
+      | 'tsx'
+      | 'reason'
+      | 'rego'
+      | 'renpy'
+      | 'rpy'
+      | 'rescript'
+      | 'res'
+      | 'rest'
+      | 'rip'
+      | 'roboconf'
+      | 'robotframework'
+      | 'robot'
+      | 'rust'
+      | 'sas'
+      | 'sass'
+      | 'shell-session'
+      | 'sh-session'
+      | 'shellsession'
+      | 'smali'
+      | 'smalltalk'
+      | 'smarty'
+      | 'sml'
+      | 'smlnj'
+      | 'solidity'
+      | 'sol'
+      | 'solution-file'
+      | 'sln'
+      | 'soy'
+      | 'splunk-spl'
+      | 'sqf'
+      | 'squirrel'
+      | 'stan'
+      | 'stata'
+      | 'iecst'
+      | 'supercollider'
+      | 'sclang'
+      | 'swift'
+      | 'systemd'
+      | 'tact'
+      | 't4-templating'
+      | 't4-cs'
+      | 't4'
+      | 'vbnet'
+      | 't4-vb'
+      | 'tap'
+      | 'tcl'
+      | 'tt2'
+      | 'toml'
+      | 'ttcn'
+      | 'ttcn3'
+      | 'ttcn-3'
+      | 'turtle'
+      | 'trickle'
+      | 'typescript-jsdoc'
+      | 'typoscript'
+      | 'tsconfig'
+      | 'unrealscript'
+      | 'uscript'
+      | 'uc'
+      | 'uri'
+      | 'v'
+      | 'vala'
+      | 'vba'
+      | 'vbscript'
+      | 'velocity'
+      | 'verilog'
+      | 'vhdl'
+      | 'vim'
+      | 'visual-basic'
+      | 'vb'
+      | 'warpscript'
+      | 'wasm'
+      | 'web-idl'
+      | 'webidl'
+      | 'wgsl'
+      | 'wiki'
+      | 'wolfram'
+      | 'mathematica'
+      | 'nb'
+      | 'wl'
+      | 'xeora'
+      | 'xeoracube'
+      | 'xml-doc'
+      | 'xojo'
+      | 'xquery'
+      | 'yaml'
+      | 'yml'
+      | 'yang'
+      | 'zig'
+  }>
+
+  /**
+   * Block quotation. Can be expandable or not.
+   */
+  blockquote: PropsWithChildren<{
+    expandable?: boolean
+  }>
+}
+
+export type TgxNode
+  = | TgxNode[]
+    | TgxElement
+    | string
+    | number
+    | boolean
+    | null
+    | undefined
+
+export type PropsWithChildren<P = {}> = P & { children?: TgxNode }
+
+export type Component = (props: any) => TgxElement
+
+export type TgxElement
+  = | TgxElementPlain
+    | TgxElementFragment
+    | TgxElementText
+
+export interface TgxElementPlain {
+  type: 'plain'
+  value: string | number | boolean | null | undefined
+}
+
+export interface TgxElementFragment {
+  type: 'fragment'
+  subelements: TgxElement[]
+}
+
+export interface TgxElementText {
+  type: 'text'
+  entity: TextEntity
+  subelements: TgxElement[]
+}
+
+export type TextEntity
+  = | { type: 'bold' }
+    | { type: 'italic' }
+    | { type: 'underline' }
+    | { type: 'strikethrough' }
+    | { type: 'spoiler' }
+    | { type: 'link', url: string }
+    | { type: 'custom-emoji', id: string, alt: string }
+    | { type: 'code' }
+    | { type: 'codeblock', language?: string }
+    | { type: 'blockquote', expandable: boolean }

package/dist/_utils/types.d.ts

@@ -1,6 +0,0 @@
-export type StringWithSuggestions<S extends string> = S | (string & {});
-/**
- * Aliases of all languages that are supported by [libprisma](https://github.com/TelegramMessenger/libprisma)
- * (library that Telegram uses for highlighting syntax of code blocks).
- */
-export type PrismLanguage = 'markup' | 'html' | 'xml' | 'svg' | 'mathml' | 'ssml' | 'atom' | 'rss' | 'css' | 'clike' | 'regex' | 'javascript' | 'js' | 'abap' | 'abnf' | 'actionscript' | 'ada' | 'agda' | 'al' | 'antlr4' | 'g4' | 'apacheconf' | 'sql' | 'apex' | 'apl' | 'applescript' | 'aql' | 'c' | 'cpp' | 'arduino' | 'ino' | 'arff' | 'armasm' | 'arm-asm' | 'bash' | 'sh' | 'shell' | 'yaml' | 'yml' | 'markdown' | 'md' | 'arturo' | 'art' | 'asciidoc' | 'adoc' | 'csharp' | 'cs' | 'dotnet' | 'aspnet' | 'asm6502' | 'asmatmel' | 'autohotkey' | 'autoit' | 'avisynth' | 'avs' | 'avro-idl' | 'avdl' | 'awk' | 'gawk' | 'basic' | 'batch' | 'bbcode' | 'shortcode' | 'bbj' | 'bicep' | 'birb' | 'bison' | 'bnf' | 'rbnf' | 'bqn' | 'brainfuck' | 'brightscript' | 'bro' | 'cfscript' | 'cfc' | 'chaiscript' | 'cil' | 'cilkc' | 'cilk-c' | 'cilkcpp' | 'cilk-cpp' | 'cilk' | 'clojure' | 'cmake' | 'cobol' | 'coffeescript' | 'coffee' | 'concurnas' | 'conc' | 'csp' | 'cooklang' | 'ruby' | 'rb' | 'crystal' | 'csv' | 'cue' | 'cypher' | 'd' | 'dart' | 'dataweave' | 'dax' | 'dhall' | 'diff' | 'markup-templating' | 'django' | 'jinja2' | 'dns-zone-file' | 'dns-zone' | 'docker' | 'dockerfile' | 'dot' | 'gv' | 'ebnf' | 'editorconfig' | 'eiffel' | 'ejs' | 'eta' | 'elixir' | 'elm' | 'lua' | 'etlua' | 'erb' | 'erlang' | 'excel-formula' | 'xlsx' | 'xls' | 'fsharp' | 'factor' | 'false' | 'fift' | 'firestore-security-rules' | 'flow' | 'fortran' | 'ftl' | 'func' | 'gml' | 'gamemakerlanguage' | 'gap' | 'gcode' | 'gdscript' | 'gedcom' | 'gettext' | 'po' | 'git' | 'glsl' | 'gn' | 'gni' | 'linker-script' | 'ld' | 'go' | 'go-module' | 'go-mod' | 'gradle' | 'graphql' | 'groovy' | 'less' | 'scss' | 'textile' | 'haml' | 'handlebars' | 'hbs' | 'mustache' | 'haskell' | 'hs' | 'haxe' | 'hcl' | 'hlsl' | 'hoon' | 'hpkp' | 'hsts' | 'json' | 'webmanifest' | 'uri' | 'url' | 'http' | 'ichigojam' | 'icon' | 'icu-message-format' | 'idris' | 'idr' | 'ignore' | 'gitignore' | 'hgignore' | 'npmignore' | 'inform7' | 'ini' | 'io' | 'j' | 'java' | 'scala' | 'php' | 'javadoclike' | 'javadoc' | 'javastacktrace' | 'jolie' | 'jq' | 'typescript' | 'ts' | 'jsdoc' | 'n4js' | 'n4jsd' | 'json5' | 'jsonp' | 'jsstacktrace' | 'julia' | 'keepalived' | 'keyman' | 'kotlin' | 'kt' | 'kts' | 'kusto' | 'latex' | 'tex' | 'context' | 'latte' | 'scheme' | 'lilypond' | 'ly' | 'liquid' | 'lisp' | 'emacs' | 'elisp' | 'emacs-lisp' | 'livescript' | 'llvm' | 'log' | 'lolcode' | 'magma' | 'makefile' | 'mata' | 'matlab' | 'maxscript' | 'mel' | 'mermaid' | 'metafont' | 'mizar' | 'mongodb' | 'monkey' | 'moonscript' | 'moon' | 'n1ql' | 'nand2tetris-hdl' | 'naniscript' | 'nani' | 'nasm' | 'neon' | 'nevod' | 'nginx' | 'nim' | 'nix' | 'nsis' | 'objectivec' | 'objc' | 'ocaml' | 'odin' | 'opencl' | 'openqasm' | 'qasm' | 'oz' | 'parigp' | 'parser' | 'pascal' | 'objectpascal' | 'pascaligo' | 'psl' | 'pcaxis' | 'px' | 'peoplecode' | 'pcode' | 'perl' | 'phpdoc' | 'plant-uml' | 'plantuml' | 'plsql' | 'powerquery' | 'pq' | 'mscript' | 'powershell' | 'processing' | 'prolog' | 'promql' | 'properties' | 'protobuf' | 'stylus' | 'twig' | 'pug' | 'puppet' | 'purebasic' | 'pbfasm' | 'python' | 'py' | 'qsharp' | 'qs' | 'q' | 'qml' | 'qore' | 'r' | 'racket' | 'rkt' | 'cshtml' | 'razor' | 'jsx' | 'tsx' | 'reason' | 'rego' | 'renpy' | 'rpy' | 'rescript' | 'res' | 'rest' | 'rip' | 'roboconf' | 'robotframework' | 'robot' | 'rust' | 'sas' | 'sass' | 'shell-session' | 'sh-session' | 'shellsession' | 'smali' | 'smalltalk' | 'smarty' | 'sml' | 'smlnj' | 'solidity' | 'sol' | 'solution-file' | 'sln' | 'soy' | 'splunk-spl' | 'sqf' | 'squirrel' | 'stan' | 'stata' | 'iecst' | 'supercollider' | 'sclang' | 'swift' | 'systemd' | 'tact' | 't4-templating' | 't4-cs' | 't4' | 'vbnet' | 't4-vb' | 'tap' | 'tcl' | 'tt2' | 'toml' | 'ttcn' | 'ttcn3' | 'ttcn-3' | 'turtle' | 'trickle' | 'typescript-jsdoc' | 'typoscript' | 'tsconfig' | 'unrealscript' | 'uscript' | 'uc' | 'uri' | 'v' | 'vala' | 'vba' | 'vbscript' | 'velocity' | 'verilog' | 'vhdl' | 'vim' | 'visual-basic' | 'vb' | 'warpscript' | 'wasm' | 'web-idl' | 'webidl' | 'wgsl' | 'wiki' | 'wolfram' | 'mathematica' | 'nb' | 'wl' | 'xeora' | 'xeoracube' | 'xml-doc' | 'xojo' | 'xquery' | 'yaml' | 'yml' | 'yang' | 'zig';

package/dist/_utils/types.js

@@ -1 +0,0 @@
-export {};

package/dist/html.d.ts

@@ -1,6 +0,0 @@
-import type { TgxElement } from './types.ts';
-/**
- * Converts {@link TgxElement} to an HTML string formatted for Telegram's
- * HTML parse mode.
- */
-export declare function html(tgx: TgxElement | TgxElement[]): string;

package/dist/html.js

@@ -1,46 +0,0 @@
-/**
- * Converts {@link TgxElement} to an HTML string formatted for Telegram's
- * HTML parse mode.
- */
-export function html(tgx) {
-    return (Array.isArray(tgx) ? tgx : [tgx])
-        .map((el) => {
-        switch (el.type) {
-            case 'plain': return htmlTgxPlainElement(el);
-            case 'fragment': return html(el.subelements);
-            case 'text': return htmlTgxTextElement(el);
-        }
-        throw new Error(`Unknown element: ${el}.`);
-    })
-        .join('');
-}
-function htmlTgxPlainElement({ value }) {
-    if (value == null || typeof value === 'boolean')
-        return '';
-    return sanitize(String(value));
-}
-function htmlTgxTextElement(el) {
-    switch (el.entity.type) {
-        case 'bold': return `<b>${html(el.subelements)}</b>`;
-        case 'italic': return `<i>${html(el.subelements)}</i>`;
-        case 'underline': return `<u>${html(el.subelements)}</u>`;
-        case 'strikethrough': return `<s>${html(el.subelements)}</s>`;
-        case 'spoiler': return `<tg-spoiler>${html(el.subelements)}</tg-spoiler>`;
-        // TODO: Shouldn't we urlencode this?
-        case 'link': return `<a href="${el.entity.url}">${html(el.subelements)}</a>`;
-        case 'custom-emoji': return `<tg-emoji emoji-id="${el.entity.id}">${el.entity.alt}</tg-emoji>`;
-        case 'code': return `<code>${html(el.subelements)}</code>`;
-        case 'codeblock': return (el.entity.language
-            ? `<pre><code class="language-${el.entity.language}">${html(el.subelements)}</code></pre>`
-            : `<pre>${html(el.subelements)}</pre>`);
-        case 'blockquote': return (el.entity.expandable
-            ? `<blockquote expandable>${html(el.subelements)}</blockquote>`
-            : `<blockquote>${html(el.subelements)}</blockquote>`);
-    }
-}
-function sanitize(unsafe) {
-    return unsafe
-        .replaceAll('&', '&amp;') // must be first
-        .replaceAll('<', '&lt;')
-        .replaceAll('>', '&gt;');
-}