@uniformdev/richtext 19.14.1-alpha.1

package/LICENSE.txt

@@ -0,0 +1,2 @@
+© 2023 Uniform Systems, Inc. All Rights Reserved.
+See details of Uniform Systems, Inc. Master Subscription Agreement here: https://uniform.dev/eula

package/README.md

@@ -0,0 +1,3 @@
+RichText parameter functionality for Uniform Platform
+
+part of the [Uniform Platform](https://uniform.app). See our [documentation](https://docs.uniform.app) for more details.

package/dist/index.d.ts

@@ -0,0 +1,123 @@
+import { LinkParamValue } from '@uniformdev/canvas';
+
+declare function purifyText(text: string): string;
+declare function isPureTextAlign(format?: string): format is string;
+declare function isPureDirection(direction?: string): direction is string;
+declare function renderHtmlElement(tag: string, attributes: Map<string, string> | null, children?: string): string;
+
+interface RichTextNode extends Record<string, unknown> {
+    type: string;
+    children?: RichTextNode[];
+}
+type RichTextNodeWithChildren = RichTextNode & {
+    children: RichTextNode[];
+};
+type ResolveStringRenderer = (context: StringRenderContext) => NodeStringRenderer | null | undefined;
+interface StringRenderContext {
+    currentNode: RichTextNode;
+    ancestorNodes: RichTextNode[];
+    resolveRenderer?: ResolveStringRenderer;
+}
+interface NodeStringRendererProps {
+    context: StringRenderContext;
+    renderChildren(children?: RichTextNode[] | unknown): string;
+}
+type NodeStringRenderer = (props: NodeStringRendererProps) => string;
+type ParameterRichTextValue = {
+    root: RichTextNode;
+} | undefined;
+
+interface HeadingNode extends RichTextNode {
+    tag: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+}
+declare const headingHtmlRenderer: NodeStringRenderer;
+
+interface LinkNode extends RichTextNode {
+    link: NonNullable<LinkParamValue>;
+}
+declare const linkHtmlRenderer: NodeStringRenderer;
+declare function linkParamValueToHref(link: LinkParamValue): string | undefined;
+
+interface ListNode extends RichTextNode {
+    tag: 'ul' | 'ol';
+    start: number;
+}
+declare const listHtmlRenderer: NodeStringRenderer;
+
+interface ListItemNode extends RichTextNode {
+    value: number;
+}
+declare const listitemHtmlRenderer: NodeStringRenderer;
+
+interface ParagraphNode extends RichTextNode {
+    format?: 'center' | 'end' | 'justify' | 'left' | 'match-parent' | 'right' | 'start';
+    direction?: 'ltr' | 'rtl';
+}
+declare const paragraphHtmlRenderer: NodeStringRenderer;
+
+declare const rootHtmlRenderer: NodeStringRenderer;
+
+interface TextNode extends RichTextNode {
+    /**
+     * The format is a bitflag value
+     * flags:
+     *  position 1: bold
+     *  position 2: italic
+     *  position 3: strikethrough
+     *  position 4: underline
+     *  position 5: code
+     *  position 6: subscript
+     *  position 7: superscript
+     */
+    format: number;
+    text: string;
+}
+declare const textHtmlRenderer: NodeStringRenderer;
+/**
+ * Convert format bitflag for holding text formats
+ * into relevant tags
+ */
+declare function getRichTextTagsFromTextFormat(format: number): string[];
+
+declare function isArrayWithLength<T>(arr: T[] | unknown | undefined): arr is T[];
+declare function isRichTextNode(node: unknown): node is RichTextNode;
+declare function isRichTextNodeType(node: unknown, type: 'heading'): node is HeadingNode;
+declare function isRichTextNodeType(node: unknown, type: 'paragraph'): node is ParagraphNode;
+declare function isRichTextNodeType(node: unknown, type: 'text'): node is TextNode;
+declare function isRichTextNodeType(node: unknown, type: 'list'): node is ListNode;
+declare function isRichTextNodeType(node: unknown, type: 'listitem'): node is ListItemNode;
+declare function isRichTextNodeType(node: unknown, type: 'link'): node is LinkNode;
+declare function isRichTextNodeType(node: unknown, type: string): node is RichTextNode;
+declare function hasChildren<TRichTextNode extends RichTextNode>(node: TRichTextNode): node is TRichTextNode & {
+    children: RichTextNode[];
+};
+
+/**
+ * When a custom renderer has not been provided we
+ * check to see if there is a renderer for the type
+ * within the map above. These are for any node types
+ * which include extra logic.
+ *
+ * Some node types like quote just map directly to a
+ * HTML tag (ie blockquote). For those there is a simple
+ * type -> tag Map.
+ */
+declare const resolveDefaultRenderer: ResolveStringRenderer;
+/**
+ * Render a node and it's children to HTML
+ *
+ * This could be the root node or a nested node
+ */
+declare function renderToHtml(node: RichTextNode | null | undefined, parentContext?: Partial<StringRenderContext>): string;
+/**
+ * Render an array of RichTextNodes to a string based
+ * on a particular context.
+ *
+ * This will often be called from within a NodeRenderer
+ * using the `renderChildren` prop.
+ */
+declare function renderChildrenToHtml(children: RichTextNode[] | undefined, context: StringRenderContext): string;
+
+declare const walkRichTextTree: (node: RichTextNode, callback: (node: RichTextNode, parent: RichTextNode | undefined) => void, parent?: RichTextNode) => void;
+
+export { HeadingNode, LinkNode, ListItemNode, ListNode, NodeStringRenderer, NodeStringRendererProps, ParagraphNode, ParameterRichTextValue, ResolveStringRenderer, RichTextNode, RichTextNodeWithChildren, StringRenderContext, TextNode, getRichTextTagsFromTextFormat, hasChildren, headingHtmlRenderer, isArrayWithLength, isPureDirection, isPureTextAlign, isRichTextNode, isRichTextNodeType, linkHtmlRenderer, linkParamValueToHref, listHtmlRenderer, listitemHtmlRenderer, paragraphHtmlRenderer, purifyText, renderChildrenToHtml, renderHtmlElement, renderToHtml, resolveDefaultRenderer, rootHtmlRenderer, textHtmlRenderer, walkRichTextTree };

package/dist/index.esm.js

@@ -0,0 +1,257 @@
+// src/elements.ts
+var rendererTypeTagMap = /* @__PURE__ */ new Map([
+  ["linebreak", "br"],
+  ["quote", "blockquote"]
+]);
+function purifyText(text) {
+  return text.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/'/g, "&#39;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function isPureTextAlign(format) {
+  return Boolean(format && ["center", "end", "justify", "left", "right", "start"].includes(format));
+}
+function isPureDirection(direction) {
+  return Boolean(direction && ["ltr", "rtl"].includes(direction));
+}
+var voidElements = /* @__PURE__ */ new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "source",
+  "track",
+  "wbr"
+]);
+function renderHtmlElement(tag, attributes, children) {
+  const attributesString = attributes && attributes.size > 0 ? " " + Array.from(attributes).reduce((result, [key, value]) => [...result, `${key}="${value}"`], []).join(" ") : "";
+  return voidElements.has(tag) ? `<${tag}${attributesString}>` : `<${tag}${attributesString}>${children != null ? children : ""}</${tag}>`;
+}
+
+// src/guards.ts
+function isArrayWithLength(arr) {
+  return Array.isArray(arr) && arr.length > 0;
+}
+function isRichTextNode(node) {
+  return !!node && typeof node === "object" && "type" in node;
+}
+function isRichTextNodeType(node, type) {
+  return isRichTextNode(node) && node.type === type;
+}
+function hasChildren(node) {
+  return "children" in node && isArrayWithLength(node.children);
+}
+
+// src/nodes/heading.ts
+var headingHtmlRenderer = ({ context, renderChildren }) => {
+  var _a;
+  const node = context.currentNode;
+  return renderHtmlElement((_a = node.tag) != null ? _a : "h1", null, renderChildren(context.currentNode.children));
+};
+
+// src/nodes/link.ts
+var linkHtmlRenderer = ({ context, renderChildren }) => {
+  const node = context.currentNode;
+  const attributes = /* @__PURE__ */ new Map();
+  const href = linkParamValueToHref(node.link);
+  if (href) {
+    attributes.set("href", href);
+  }
+  return renderHtmlElement("a", attributes, renderChildren(context.currentNode.children));
+};
+function linkParamValueToHref(link) {
+  switch (link == null ? void 0 : link.type) {
+    case "email":
+      return `mailto:${link.path}`;
+    case "tel":
+      return `tel:${link.path}`;
+    case "url":
+      return link.path;
+    case "projectMapNode":
+      return link.path;
+  }
+}
+
+// src/nodes/list.ts
+var listHtmlRenderer = ({ context, renderChildren }) => {
+  var _a;
+  const node = context.currentNode;
+  const attributes = /* @__PURE__ */ new Map();
+  if (node.start > 1) {
+    attributes.set("start", node.start.toString());
+  }
+  return renderHtmlElement((_a = node.tag) != null ? _a : "ul", attributes, renderChildren(context.currentNode.children));
+};
+
+// src/nodes/listitem.ts
+var listitemHtmlRenderer = ({ context, renderChildren }) => {
+  const node = context.currentNode;
+  const attributes = /* @__PURE__ */ new Map();
+  if (Number.isFinite(node.value)) {
+    attributes.set("value", (node.value + 1).toString());
+  }
+  return renderHtmlElement("li", attributes, renderChildren(context.currentNode.children));
+};
+
+// src/nodes/paragraph.ts
+var paragraphHtmlRenderer = ({ context, renderChildren }) => {
+  const node = context.currentNode;
+  const attributes = /* @__PURE__ */ new Map();
+  if (isPureTextAlign(node.format)) {
+    attributes.set("style", `text-align: ${node.format};`);
+  }
+  if (isPureDirection(node.direction)) {
+    attributes.set("dir", node.direction);
+  }
+  return renderHtmlElement(
+    "p",
+    attributes,
+    hasChildren(context.currentNode) ? renderChildren(context.currentNode.children) : "<br>"
+  );
+};
+
+// src/nodes/root.ts
+var rootHtmlRenderer = ({ context, renderChildren }) => {
+  return hasChildren(context.currentNode) ? renderChildren(context.currentNode.children) : "";
+};
+
+// src/nodes/text.ts
+var textHtmlRenderer = ({ context }) => {
+  const node = context.currentNode;
+  const tags = getRichTextTagsFromTextFormat(node.format);
+  const pureText = purifyText(node.text);
+  return tags.length === 0 ? pureText : tags.reduceRight((children, tag) => {
+    return renderHtmlElement(tag, null, children);
+  }, pureText);
+};
+function getRichTextTagsFromTextFormat(format) {
+  const tags = [];
+  if (format & 1 << 0) {
+    tags.push("strong");
+  }
+  if (format & 1 << 1) {
+    tags.push("em");
+  }
+  if (format & 1 << 2) {
+    tags.push("s");
+  }
+  if (format & 1 << 3) {
+    tags.push("u");
+  }
+  if (format & 1 << 4) {
+    tags.push("code");
+  }
+  if (format & 1 << 5) {
+    tags.push("sub");
+  }
+  if (format & 1 << 6) {
+    tags.push("sup");
+  }
+  return tags;
+}
+
+// src/nodes/tab.ts
+var tabHtmlRenderer = () => {
+  return "	";
+};
+
+// src/renderToHtml.ts
+var rendererTypeMap = /* @__PURE__ */ new Map([
+  ["heading", headingHtmlRenderer],
+  ["link", linkHtmlRenderer],
+  ["list", listHtmlRenderer],
+  ["listitem", listitemHtmlRenderer],
+  ["paragraph", paragraphHtmlRenderer],
+  ["root", rootHtmlRenderer],
+  ["text", textHtmlRenderer],
+  ["tab", tabHtmlRenderer]
+]);
+var resolveDefaultRenderer = (context) => {
+  const renderer = rendererTypeMap.get(context.currentNode.type);
+  if (renderer) {
+    return renderer;
+  }
+  const tag = rendererTypeTagMap.get(context.currentNode.type);
+  if (tag) {
+    return ({ renderChildren }) => renderHtmlElement(
+      tag,
+      null,
+      hasChildren(context.currentNode) ? renderChildren(context.currentNode.children) : void 0
+    );
+  }
+  return () => `<!-- WARNING: No renderer for type ${context.currentNode.type} -->`;
+};
+function initializeRenderContext(node, parentContext) {
+  let ancestorNodes = [];
+  if (parentContext == null ? void 0 : parentContext.ancestorNodes) {
+    ancestorNodes = ancestorNodes.concat(parentContext.ancestorNodes);
+  }
+  if (parentContext == null ? void 0 : parentContext.currentNode) {
+    ancestorNodes.unshift(parentContext.currentNode);
+  }
+  return {
+    ...parentContext != null ? parentContext : {},
+    currentNode: node,
+    ancestorNodes
+  };
+}
+function renderToHtml(node, parentContext) {
+  var _a;
+  if (!isRichTextNode(node))
+    return "";
+  const context = initializeRenderContext(node, parentContext);
+  let renderer = (_a = context.resolveRenderer) == null ? void 0 : _a.call(context, context);
+  if (typeof renderer === "undefined") {
+    renderer = resolveDefaultRenderer(context);
+  } else if (renderer === null) {
+    return "";
+  }
+  const renderChildren = (children) => renderChildrenToHtml(children, context);
+  if (renderer) {
+    return renderer({ context, renderChildren });
+  } else {
+    throw new Error(`There is no renderer for node type: ${context.currentNode.type}`);
+  }
+}
+function renderChildrenToHtml(children, context) {
+  return Array.isArray(children) ? children.map((node) => renderToHtml(node, context)).join("") : "";
+}
+
+// src/utils.ts
+var walkRichTextTree = (node, callback, parent) => {
+  callback(node, parent);
+  if (Array.isArray(node.children)) {
+    let i = 0;
+    while (node.children.length > i) {
+      walkRichTextTree(node.children[i], callback, node);
+      i += 1;
+    }
+  }
+};
+export {
+  getRichTextTagsFromTextFormat,
+  hasChildren,
+  headingHtmlRenderer,
+  isArrayWithLength,
+  isPureDirection,
+  isPureTextAlign,
+  isRichTextNode,
+  isRichTextNodeType,
+  linkHtmlRenderer,
+  linkParamValueToHref,
+  listHtmlRenderer,
+  listitemHtmlRenderer,
+  paragraphHtmlRenderer,
+  purifyText,
+  renderChildrenToHtml,
+  renderHtmlElement,
+  renderToHtml,
+  resolveDefaultRenderer,
+  rootHtmlRenderer,
+  textHtmlRenderer,
+  walkRichTextTree
+};

package/dist/index.js

@@ -0,0 +1,304 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  getRichTextTagsFromTextFormat: () => getRichTextTagsFromTextFormat,
+  hasChildren: () => hasChildren,
+  headingHtmlRenderer: () => headingHtmlRenderer,
+  isArrayWithLength: () => isArrayWithLength,
+  isPureDirection: () => isPureDirection,
+  isPureTextAlign: () => isPureTextAlign,
+  isRichTextNode: () => isRichTextNode,
+  isRichTextNodeType: () => isRichTextNodeType,
+  linkHtmlRenderer: () => linkHtmlRenderer,
+  linkParamValueToHref: () => linkParamValueToHref,
+  listHtmlRenderer: () => listHtmlRenderer,
+  listitemHtmlRenderer: () => listitemHtmlRenderer,
+  paragraphHtmlRenderer: () => paragraphHtmlRenderer,
+  purifyText: () => purifyText,
+  renderChildrenToHtml: () => renderChildrenToHtml,
+  renderHtmlElement: () => renderHtmlElement,
+  renderToHtml: () => renderToHtml,
+  resolveDefaultRenderer: () => resolveDefaultRenderer,
+  rootHtmlRenderer: () => rootHtmlRenderer,
+  textHtmlRenderer: () => textHtmlRenderer,
+  walkRichTextTree: () => walkRichTextTree
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/elements.ts
+var rendererTypeTagMap = /* @__PURE__ */ new Map([
+  ["linebreak", "br"],
+  ["quote", "blockquote"]
+]);
+function purifyText(text) {
+  return text.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/'/g, "&#39;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function isPureTextAlign(format) {
+  return Boolean(format && ["center", "end", "justify", "left", "right", "start"].includes(format));
+}
+function isPureDirection(direction) {
+  return Boolean(direction && ["ltr", "rtl"].includes(direction));
+}
+var voidElements = /* @__PURE__ */ new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "source",
+  "track",
+  "wbr"
+]);
+function renderHtmlElement(tag, attributes, children) {
+  const attributesString = attributes && attributes.size > 0 ? " " + Array.from(attributes).reduce((result, [key, value]) => [...result, `${key}="${value}"`], []).join(" ") : "";
+  return voidElements.has(tag) ? `<${tag}${attributesString}>` : `<${tag}${attributesString}>${children != null ? children : ""}</${tag}>`;
+}
+
+// src/guards.ts
+function isArrayWithLength(arr) {
+  return Array.isArray(arr) && arr.length > 0;
+}
+function isRichTextNode(node) {
+  return !!node && typeof node === "object" && "type" in node;
+}
+function isRichTextNodeType(node, type) {
+  return isRichTextNode(node) && node.type === type;
+}
+function hasChildren(node) {
+  return "children" in node && isArrayWithLength(node.children);
+}
+
+// src/nodes/heading.ts
+var headingHtmlRenderer = ({ context, renderChildren }) => {
+  var _a;
+  const node = context.currentNode;
+  return renderHtmlElement((_a = node.tag) != null ? _a : "h1", null, renderChildren(context.currentNode.children));
+};
+
+// src/nodes/link.ts
+var linkHtmlRenderer = ({ context, renderChildren }) => {
+  const node = context.currentNode;
+  const attributes = /* @__PURE__ */ new Map();
+  const href = linkParamValueToHref(node.link);
+  if (href) {
+    attributes.set("href", href);
+  }
+  return renderHtmlElement("a", attributes, renderChildren(context.currentNode.children));
+};
+function linkParamValueToHref(link) {
+  switch (link == null ? void 0 : link.type) {
+    case "email":
+      return `mailto:${link.path}`;
+    case "tel":
+      return `tel:${link.path}`;
+    case "url":
+      return link.path;
+    case "projectMapNode":
+      return link.path;
+  }
+}
+
+// src/nodes/list.ts
+var listHtmlRenderer = ({ context, renderChildren }) => {
+  var _a;
+  const node = context.currentNode;
+  const attributes = /* @__PURE__ */ new Map();
+  if (node.start > 1) {
+    attributes.set("start", node.start.toString());
+  }
+  return renderHtmlElement((_a = node.tag) != null ? _a : "ul", attributes, renderChildren(context.currentNode.children));
+};
+
+// src/nodes/listitem.ts
+var listitemHtmlRenderer = ({ context, renderChildren }) => {
+  const node = context.currentNode;
+  const attributes = /* @__PURE__ */ new Map();
+  if (Number.isFinite(node.value)) {
+    attributes.set("value", (node.value + 1).toString());
+  }
+  return renderHtmlElement("li", attributes, renderChildren(context.currentNode.children));
+};
+
+// src/nodes/paragraph.ts
+var paragraphHtmlRenderer = ({ context, renderChildren }) => {
+  const node = context.currentNode;
+  const attributes = /* @__PURE__ */ new Map();
+  if (isPureTextAlign(node.format)) {
+    attributes.set("style", `text-align: ${node.format};`);
+  }
+  if (isPureDirection(node.direction)) {
+    attributes.set("dir", node.direction);
+  }
+  return renderHtmlElement(
+    "p",
+    attributes,
+    hasChildren(context.currentNode) ? renderChildren(context.currentNode.children) : "<br>"
+  );
+};
+
+// src/nodes/root.ts
+var rootHtmlRenderer = ({ context, renderChildren }) => {
+  return hasChildren(context.currentNode) ? renderChildren(context.currentNode.children) : "";
+};
+
+// src/nodes/text.ts
+var textHtmlRenderer = ({ context }) => {
+  const node = context.currentNode;
+  const tags = getRichTextTagsFromTextFormat(node.format);
+  const pureText = purifyText(node.text);
+  return tags.length === 0 ? pureText : tags.reduceRight((children, tag) => {
+    return renderHtmlElement(tag, null, children);
+  }, pureText);
+};
+function getRichTextTagsFromTextFormat(format) {
+  const tags = [];
+  if (format & 1 << 0) {
+    tags.push("strong");
+  }
+  if (format & 1 << 1) {
+    tags.push("em");
+  }
+  if (format & 1 << 2) {
+    tags.push("s");
+  }
+  if (format & 1 << 3) {
+    tags.push("u");
+  }
+  if (format & 1 << 4) {
+    tags.push("code");
+  }
+  if (format & 1 << 5) {
+    tags.push("sub");
+  }
+  if (format & 1 << 6) {
+    tags.push("sup");
+  }
+  return tags;
+}
+
+// src/nodes/tab.ts
+var tabHtmlRenderer = () => {
+  return "	";
+};
+
+// src/renderToHtml.ts
+var rendererTypeMap = /* @__PURE__ */ new Map([
+  ["heading", headingHtmlRenderer],
+  ["link", linkHtmlRenderer],
+  ["list", listHtmlRenderer],
+  ["listitem", listitemHtmlRenderer],
+  ["paragraph", paragraphHtmlRenderer],
+  ["root", rootHtmlRenderer],
+  ["text", textHtmlRenderer],
+  ["tab", tabHtmlRenderer]
+]);
+var resolveDefaultRenderer = (context) => {
+  const renderer = rendererTypeMap.get(context.currentNode.type);
+  if (renderer) {
+    return renderer;
+  }
+  const tag = rendererTypeTagMap.get(context.currentNode.type);
+  if (tag) {
+    return ({ renderChildren }) => renderHtmlElement(
+      tag,
+      null,
+      hasChildren(context.currentNode) ? renderChildren(context.currentNode.children) : void 0
+    );
+  }
+  return () => `<!-- WARNING: No renderer for type ${context.currentNode.type} -->`;
+};
+function initializeRenderContext(node, parentContext) {
+  let ancestorNodes = [];
+  if (parentContext == null ? void 0 : parentContext.ancestorNodes) {
+    ancestorNodes = ancestorNodes.concat(parentContext.ancestorNodes);
+  }
+  if (parentContext == null ? void 0 : parentContext.currentNode) {
+    ancestorNodes.unshift(parentContext.currentNode);
+  }
+  return {
+    ...parentContext != null ? parentContext : {},
+    currentNode: node,
+    ancestorNodes
+  };
+}
+function renderToHtml(node, parentContext) {
+  var _a;
+  if (!isRichTextNode(node))
+    return "";
+  const context = initializeRenderContext(node, parentContext);
+  let renderer = (_a = context.resolveRenderer) == null ? void 0 : _a.call(context, context);
+  if (typeof renderer === "undefined") {
+    renderer = resolveDefaultRenderer(context);
+  } else if (renderer === null) {
+    return "";
+  }
+  const renderChildren = (children) => renderChildrenToHtml(children, context);
+  if (renderer) {
+    return renderer({ context, renderChildren });
+  } else {
+    throw new Error(`There is no renderer for node type: ${context.currentNode.type}`);
+  }
+}
+function renderChildrenToHtml(children, context) {
+  return Array.isArray(children) ? children.map((node) => renderToHtml(node, context)).join("") : "";
+}
+
+// src/utils.ts
+var walkRichTextTree = (node, callback, parent) => {
+  callback(node, parent);
+  if (Array.isArray(node.children)) {
+    let i = 0;
+    while (node.children.length > i) {
+      walkRichTextTree(node.children[i], callback, node);
+      i += 1;
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getRichTextTagsFromTextFormat,
+  hasChildren,
+  headingHtmlRenderer,
+  isArrayWithLength,
+  isPureDirection,
+  isPureTextAlign,
+  isRichTextNode,
+  isRichTextNodeType,
+  linkHtmlRenderer,
+  linkParamValueToHref,
+  listHtmlRenderer,
+  listitemHtmlRenderer,
+  paragraphHtmlRenderer,
+  purifyText,
+  renderChildrenToHtml,
+  renderHtmlElement,
+  renderToHtml,
+  resolveDefaultRenderer,
+  rootHtmlRenderer,
+  textHtmlRenderer,
+  walkRichTextTree
+});

package/dist/index.mjs

@@ -0,0 +1,257 @@
+// src/elements.ts
+var rendererTypeTagMap = /* @__PURE__ */ new Map([
+  ["linebreak", "br"],
+  ["quote", "blockquote"]
+]);
+function purifyText(text) {
+  return text.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/'/g, "&#39;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function isPureTextAlign(format) {
+  return Boolean(format && ["center", "end", "justify", "left", "right", "start"].includes(format));
+}
+function isPureDirection(direction) {
+  return Boolean(direction && ["ltr", "rtl"].includes(direction));
+}
+var voidElements = /* @__PURE__ */ new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "source",
+  "track",
+  "wbr"
+]);
+function renderHtmlElement(tag, attributes, children) {
+  const attributesString = attributes && attributes.size > 0 ? " " + Array.from(attributes).reduce((result, [key, value]) => [...result, `${key}="${value}"`], []).join(" ") : "";
+  return voidElements.has(tag) ? `<${tag}${attributesString}>` : `<${tag}${attributesString}>${children != null ? children : ""}</${tag}>`;
+}
+
+// src/guards.ts
+function isArrayWithLength(arr) {
+  return Array.isArray(arr) && arr.length > 0;
+}
+function isRichTextNode(node) {
+  return !!node && typeof node === "object" && "type" in node;
+}
+function isRichTextNodeType(node, type) {
+  return isRichTextNode(node) && node.type === type;
+}
+function hasChildren(node) {
+  return "children" in node && isArrayWithLength(node.children);
+}
+
+// src/nodes/heading.ts
+var headingHtmlRenderer = ({ context, renderChildren }) => {
+  var _a;
+  const node = context.currentNode;
+  return renderHtmlElement((_a = node.tag) != null ? _a : "h1", null, renderChildren(context.currentNode.children));
+};
+
+// src/nodes/link.ts
+var linkHtmlRenderer = ({ context, renderChildren }) => {
+  const node = context.currentNode;
+  const attributes = /* @__PURE__ */ new Map();
+  const href = linkParamValueToHref(node.link);
+  if (href) {
+    attributes.set("href", href);
+  }
+  return renderHtmlElement("a", attributes, renderChildren(context.currentNode.children));
+};
+function linkParamValueToHref(link) {
+  switch (link == null ? void 0 : link.type) {
+    case "email":
+      return `mailto:${link.path}`;
+    case "tel":
+      return `tel:${link.path}`;
+    case "url":
+      return link.path;
+    case "projectMapNode":
+      return link.path;
+  }
+}
+
+// src/nodes/list.ts
+var listHtmlRenderer = ({ context, renderChildren }) => {
+  var _a;
+  const node = context.currentNode;
+  const attributes = /* @__PURE__ */ new Map();
+  if (node.start > 1) {
+    attributes.set("start", node.start.toString());
+  }
+  return renderHtmlElement((_a = node.tag) != null ? _a : "ul", attributes, renderChildren(context.currentNode.children));
+};
+
+// src/nodes/listitem.ts
+var listitemHtmlRenderer = ({ context, renderChildren }) => {
+  const node = context.currentNode;
+  const attributes = /* @__PURE__ */ new Map();
+  if (Number.isFinite(node.value)) {
+    attributes.set("value", (node.value + 1).toString());
+  }
+  return renderHtmlElement("li", attributes, renderChildren(context.currentNode.children));
+};
+
+// src/nodes/paragraph.ts
+var paragraphHtmlRenderer = ({ context, renderChildren }) => {
+  const node = context.currentNode;
+  const attributes = /* @__PURE__ */ new Map();
+  if (isPureTextAlign(node.format)) {
+    attributes.set("style", `text-align: ${node.format};`);
+  }
+  if (isPureDirection(node.direction)) {
+    attributes.set("dir", node.direction);
+  }
+  return renderHtmlElement(
+    "p",
+    attributes,
+    hasChildren(context.currentNode) ? renderChildren(context.currentNode.children) : "<br>"
+  );
+};
+
+// src/nodes/root.ts
+var rootHtmlRenderer = ({ context, renderChildren }) => {
+  return hasChildren(context.currentNode) ? renderChildren(context.currentNode.children) : "";
+};
+
+// src/nodes/text.ts
+var textHtmlRenderer = ({ context }) => {
+  const node = context.currentNode;
+  const tags = getRichTextTagsFromTextFormat(node.format);
+  const pureText = purifyText(node.text);
+  return tags.length === 0 ? pureText : tags.reduceRight((children, tag) => {
+    return renderHtmlElement(tag, null, children);
+  }, pureText);
+};
+function getRichTextTagsFromTextFormat(format) {
+  const tags = [];
+  if (format & 1 << 0) {
+    tags.push("strong");
+  }
+  if (format & 1 << 1) {
+    tags.push("em");
+  }
+  if (format & 1 << 2) {
+    tags.push("s");
+  }
+  if (format & 1 << 3) {
+    tags.push("u");
+  }
+  if (format & 1 << 4) {
+    tags.push("code");
+  }
+  if (format & 1 << 5) {
+    tags.push("sub");
+  }
+  if (format & 1 << 6) {
+    tags.push("sup");
+  }
+  return tags;
+}
+
+// src/nodes/tab.ts
+var tabHtmlRenderer = () => {
+  return "	";
+};
+
+// src/renderToHtml.ts
+var rendererTypeMap = /* @__PURE__ */ new Map([
+  ["heading", headingHtmlRenderer],
+  ["link", linkHtmlRenderer],
+  ["list", listHtmlRenderer],
+  ["listitem", listitemHtmlRenderer],
+  ["paragraph", paragraphHtmlRenderer],
+  ["root", rootHtmlRenderer],
+  ["text", textHtmlRenderer],
+  ["tab", tabHtmlRenderer]
+]);
+var resolveDefaultRenderer = (context) => {
+  const renderer = rendererTypeMap.get(context.currentNode.type);
+  if (renderer) {
+    return renderer;
+  }
+  const tag = rendererTypeTagMap.get(context.currentNode.type);
+  if (tag) {
+    return ({ renderChildren }) => renderHtmlElement(
+      tag,
+      null,
+      hasChildren(context.currentNode) ? renderChildren(context.currentNode.children) : void 0
+    );
+  }
+  return () => `<!-- WARNING: No renderer for type ${context.currentNode.type} -->`;
+};
+function initializeRenderContext(node, parentContext) {
+  let ancestorNodes = [];
+  if (parentContext == null ? void 0 : parentContext.ancestorNodes) {
+    ancestorNodes = ancestorNodes.concat(parentContext.ancestorNodes);
+  }
+  if (parentContext == null ? void 0 : parentContext.currentNode) {
+    ancestorNodes.unshift(parentContext.currentNode);
+  }
+  return {
+    ...parentContext != null ? parentContext : {},
+    currentNode: node,
+    ancestorNodes
+  };
+}
+function renderToHtml(node, parentContext) {
+  var _a;
+  if (!isRichTextNode(node))
+    return "";
+  const context = initializeRenderContext(node, parentContext);
+  let renderer = (_a = context.resolveRenderer) == null ? void 0 : _a.call(context, context);
+  if (typeof renderer === "undefined") {
+    renderer = resolveDefaultRenderer(context);
+  } else if (renderer === null) {
+    return "";
+  }
+  const renderChildren = (children) => renderChildrenToHtml(children, context);
+  if (renderer) {
+    return renderer({ context, renderChildren });
+  } else {
+    throw new Error(`There is no renderer for node type: ${context.currentNode.type}`);
+  }
+}
+function renderChildrenToHtml(children, context) {
+  return Array.isArray(children) ? children.map((node) => renderToHtml(node, context)).join("") : "";
+}
+
+// src/utils.ts
+var walkRichTextTree = (node, callback, parent) => {
+  callback(node, parent);
+  if (Array.isArray(node.children)) {
+    let i = 0;
+    while (node.children.length > i) {
+      walkRichTextTree(node.children[i], callback, node);
+      i += 1;
+    }
+  }
+};
+export {
+  getRichTextTagsFromTextFormat,
+  hasChildren,
+  headingHtmlRenderer,
+  isArrayWithLength,
+  isPureDirection,
+  isPureTextAlign,
+  isRichTextNode,
+  isRichTextNodeType,
+  linkHtmlRenderer,
+  linkParamValueToHref,
+  listHtmlRenderer,
+  listitemHtmlRenderer,
+  paragraphHtmlRenderer,
+  purifyText,
+  renderChildrenToHtml,
+  renderHtmlElement,
+  renderToHtml,
+  resolveDefaultRenderer,
+  rootHtmlRenderer,
+  textHtmlRenderer,
+  walkRichTextTree
+};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@uniformdev/richtext",
+  "version": "19.14.1-alpha.1+597b21eaa",
+  "description": "Common functionality and types for Uniform Rich Text parameters",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "main": "./dist/index.js",
+  "module": "./dist/index.esm.js",
+  "exports": {
+    "import": {
+      "types": "./dist/index.d.ts",
+      "node": "./dist/index.mjs",
+      "default": "./dist/index.esm.js"
+    },
+    "require": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/index.d.ts"
+      ],
+      "cli": [
+        "./dist/cli/cli.d.ts"
+      ]
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "run-s build:ts",
+    "build:ts": "tsup",
+    "dev": "run-s dev:ts",
+    "dev:ts": "tsup --watch",
+    "clean": "rimraf dist",
+    "test": "jest --maxWorkers=1",
+    "lint": "eslint \"src/**/*.{js,ts,tsx}\"",
+    "format": "prettier --write \"src/**/*.{js,ts,tsx}\"",
+    "document": "api-extractor run --local"
+  },
+  "devDependencies": {
+    "@lexical/headless": "^0.11.0",
+    "@lexical/html": "^0.11.0",
+    "@lexical/link": "^0.11.0",
+    "@lexical/list": "^0.11.0",
+    "@lexical/rich-text": "^0.11.0",
+    "@uniformdev/canvas": "^19.14.1-alpha.1+597b21eaa",
+    "lexical": "^0.11.0"
+  },
+  "files": [
+    "/dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "597b21eaa0a61271b8951de1d443019868f7699c"
+}