@copilotkit/markdown 2.0.0-rc.19 → 2.0.0-rc.21

package/README.md

@@ -1,25 +1,42 @@
 # @copilotkit/markdown
 
-A zero-dependency streaming Markdown parser with framework renderers for CopilotKit. The root entry point exposes the framework-agnostic parser. The `/react`, `/vue`, and `/react-native` entry points each expose a `StreamingMarkdownRenderer` for incrementally streamed Markdown text.
+A zero-dependency streaming Markdown parser with framework renderers for CopilotKit.
+
+## How it is layered
+
+1. **Parser** (root entry, no framework). `createStreamingMarkdownParserState`, `parseStreamingMarkdownChunk` and `finalizeStreamingMarkdown` turn growing Markdown text into an immutable AST. Unchanged nodes keep their identity between chunks.
+2. **Render tree** (root entry, no framework). `updateStreamingMarkdownParserSession` re-parses only appended text. `buildStreamingMarkdownRenderTree` turns parser state into elements, sanitized attributes, click actions, text segments for the per-token fade-in, and the caret position. `getStreamingMarkdownStyles` returns the stylesheet every renderer injects.
+3. **Backends** (one per entry point). Each one only maps the render tree to its framework:
+   - `@copilotkit/markdown/react` — React elements
+   - `@copilotkit/markdown/vue` — Vue VNodes
+   - `@copilotkit/markdown/dom` — real DOM nodes, with keyed patching (used by Angular, and by anything without a framework)
+   - `@copilotkit/markdown/react-native` — React Native views (renders the AST directly)
+
+Markup and URL sanitization live in the render tree, so a fix there applies to every web renderer.
 
 ## Usage
 
 ```ts
-// Streaming Markdown parser (no framework dependency)
 import {
   createStreamingMarkdownParserState,
   parseStreamingMarkdownChunk,
   finalizeStreamingMarkdown,
 } from "@copilotkit/markdown";
 
-// React renderer
 import { StreamingMarkdownRenderer } from "@copilotkit/markdown/react";
-
-// Vue renderer
 import { StreamingMarkdownRenderer as VueStreamingMarkdownRenderer } from "@copilotkit/markdown/vue";
-
-// React Native renderer
 import { StreamingMarkdownRenderer as NativeStreamingMarkdownRenderer } from "@copilotkit/markdown/react-native";
+
+import { createStreamingMarkdownDomRenderer } from "@copilotkit/markdown/dom";
+
+const renderer = createStreamingMarkdownDomRenderer(element);
+renderer.render({ content: "**Hello**", caret: true });
+renderer.render({ content: "**Hello** world", isComplete: true });
+renderer.destroy();
 ```
 
+## Features
+
+GFM paragraphs, headings, lists, task lists, block quotes, fenced code, tables, strikethrough, autolinks, and footnote-style citations. Raw HTML is shown as text, never parsed. Set the `enableMath` parser option to get `math` nodes for `$…$` and `$$…$$`; render them with a `math` node renderer (for example with KaTeX).
+
 > **Note:** This package is under active development. APIs will be documented once stabilized.

package/dist/dom/index.cjs

@@ -0,0 +1,255 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _copilotkit_markdown = require("@copilotkit/markdown");
+
+//#region src/dom/streaming-markdown-dom-renderer.ts
+function toKebabCase(property) {
+	return property.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+}
+const CARET_STYLE = Object.entries(_copilotkit_markdown.STREAMING_MARKDOWN_CARET_STYLE).map(([property, value]) => `${toKebabCase(property)}:${value}`).join(";");
+function caretElement(key) {
+	return {
+		kind: "element",
+		key,
+		tag: "span",
+		attrs: {
+			..._copilotkit_markdown.STREAMING_MARKDOWN_CARET_ATTRS,
+			style: CARET_STYLE
+		},
+		children: []
+	};
+}
+function prefixed(prefix, children) {
+	return children.map((child) => ({
+		...child,
+		key: `${prefix}:${child.key}`
+	}));
+}
+function toVChildren(children, context, slot) {
+	return children.flatMap((child) => {
+		switch (child.kind) {
+			case "node": return toVNode(child, context);
+			case "element": {
+				const element = {
+					kind: "element",
+					key: child.key,
+					tag: child.tag,
+					attrs: child.attrs,
+					children: toVChildren(child.children, context, slot)
+				};
+				return child.action ? [{
+					...element,
+					action: child.action
+				}] : [element];
+			}
+			case "text": return [{
+				kind: "text",
+				key: child.key,
+				text: child.text
+			}];
+			case "caret": return [caretElement(child.key)];
+			case "slot": return slot;
+			default: return child;
+		}
+	});
+}
+function renderOverride(renderNode, renderer, context) {
+	const cached = context.overrideCache.get(renderNode.node);
+	if (cached?.renderer === renderer && !renderNode.containsCaret) return cached.dom;
+	const doc = context.document;
+	const materialize = (entries) => entries.map((entry) => createDom(entry, doc));
+	const children = renderNode.children ? materialize(toVChildren(renderNode.children, context, [])) : null;
+	const defaultNodes = materialize(toVChildren(renderNode.output, context, renderNode.children ? toVChildren(renderNode.children, context, []) : []));
+	const defaultNode = defaultNodes.length === 1 ? defaultNodes[0] : wrapInFragment(defaultNodes, doc);
+	const dom = renderer({
+		node: renderNode.node,
+		children,
+		defaultNode,
+		citation: renderNode.citation,
+		document: doc
+	});
+	context.overrideCache.set(renderNode.node, {
+		renderer,
+		dom
+	});
+	return dom;
+}
+function wrapInFragment(nodes, doc) {
+	if (nodes.length === 0) return null;
+	const fragment = doc.createDocumentFragment();
+	for (const node of nodes) fragment.appendChild(node);
+	return fragment;
+}
+function toVNode(renderNode, context) {
+	const renderer = context.nodeRenderers?.[renderNode.rendererKey] ?? context.nodeRenderers?.node;
+	if (renderer) {
+		const dom = renderOverride(renderNode, renderer, context);
+		return dom ? [{
+			kind: "raw",
+			key: renderNode.key,
+			dom
+		}] : [];
+	}
+	const slot = renderNode.children ? toVChildren(renderNode.children, context, []) : [];
+	return prefixed(renderNode.key, toVChildren(renderNode.output, context, slot));
+}
+function setAttributes(element, next, previous) {
+	const previousNames = Object.keys(previous);
+	for (const name of previousNames) if (!(name in next)) element.removeAttribute(name);
+	const entries = Object.entries(next);
+	for (const [name, value] of entries) if (previous[name] !== value) element.setAttribute(name, value === true ? "" : value);
+}
+function createDom(child, doc) {
+	switch (child.kind) {
+		case "raw": return child.dom;
+		case "text":
+			child.dom = doc.createTextNode(child.text);
+			return child.dom;
+		case "element": {
+			const element = doc.createElement(child.tag);
+			setAttributes(element, child.attrs, {});
+			for (const entry of child.children) element.appendChild(createDom(entry, doc));
+			child.dom = element;
+			return element;
+		}
+		default: return child;
+	}
+}
+/** Updates `previous`'s DOM to match `next` and returns it, or `null` if incompatible. */
+function patchDom(previous, next, doc) {
+	if (previous.kind === "text" && next.kind === "text" && previous.dom) {
+		if (previous.text !== next.text) previous.dom.data = next.text;
+		next.dom = previous.dom;
+		return next.dom;
+	}
+	if (previous.kind === "raw" && next.kind === "raw") return previous.dom === next.dom ? next.dom : null;
+	if (!(previous.kind === "element" && next.kind === "element" && previous.tag === next.tag && previous.dom !== void 0)) return null;
+	const element = previous.dom;
+	if (!element) return null;
+	setAttributes(element, next.attrs, previous.attrs);
+	patchChildren(element, previous.children, next.children, doc);
+	next.dom = element;
+	return element;
+}
+function patchChildren(parent, previous, next, doc) {
+	const unused = new Map(previous.map((child) => [child.key, child]));
+	let cursor = parent.firstChild;
+	for (const child of next) {
+		const match = unused.get(child.key);
+		const reused = match ? patchDom(match, child, doc) : null;
+		if (match && reused) unused.delete(child.key);
+		const dom = reused ?? createDom(child, doc);
+		if (dom === cursor) cursor = cursor.nextSibling;
+		else parent.insertBefore(dom, cursor);
+	}
+	const leftovers = Array.from(unused.values());
+	for (const child of leftovers) {
+		const dom = child.dom;
+		if (dom && dom.parentNode === parent) parent.removeChild(dom);
+	}
+}
+function removeAllChildren(parent) {
+	while (parent.firstChild) parent.removeChild(parent.firstChild);
+}
+function collectActions(children, actions) {
+	for (const child of children) {
+		if (child.kind !== "element" || !child.dom) continue;
+		if (child.action) actions.set(child.dom, child.action);
+		collectActions(child.children, actions);
+	}
+}
+/**
+* Creates a framework-free streaming markdown renderer that draws into
+* `container`. It parses incrementally, renders the same render tree as the
+* React and Vue renderers (same markup, URL sanitization, caret, citations,
+* and per-token fade-in), and patches the DOM by key so text that is already
+* on screen keeps its nodes and does not animate again.
+*
+* Creates nodes with `container.ownerDocument`, so it works with server DOMs
+* that have no global `document`.
+*
+* @param container - Element the renderer owns. Its children are replaced.
+* @returns `render(props)` to draw the latest props, and `destroy()` to remove
+* the output and the click listener.
+*
+* @example
+* ```ts
+* const renderer = createStreamingMarkdownDomRenderer(element);
+* renderer.render({ content: "**Hi**", caret: true });
+* renderer.render({ content: "**Hi** there", isComplete: true });
+* renderer.destroy();
+* ```
+* @public
+*/
+function createStreamingMarkdownDomRenderer(container) {
+	const doc = container.ownerDocument;
+	let session = null;
+	let props = { content: "" };
+	let styleElement = null;
+	let rootElement = null;
+	let previousChildren = [];
+	let actions = /* @__PURE__ */ new WeakMap();
+	const overrideCache = /* @__PURE__ */ new WeakMap();
+	const onClick = (event) => {
+		let target = event.target instanceof Node ? event.target : null;
+		while (target && target !== container) {
+			const action = actions.get(target);
+			if (action?.type === "link") {
+				props.onLinkClick?.(event, action.url, action.node);
+				return;
+			}
+			if (action?.type === "citation") {
+				props.onCitationClick?.(event, action.citation, action.node);
+				return;
+			}
+			target = target.parentNode;
+		}
+	};
+	container.addEventListener("click", onClick);
+	function render(nextProps) {
+		props = nextProps;
+		session = (0, _copilotkit_markdown.updateStreamingMarkdownParserSession)(session, nextProps.content, nextProps.options, nextProps.isComplete ?? false);
+		const state = session.parserState;
+		const tree = (0, _copilotkit_markdown.buildStreamingMarkdownRenderTree)(state, {
+			caret: nextProps.caret === true,
+			nodeClassNames: nextProps.nodeClassNames
+		});
+		if (!styleElement || !rootElement || rootElement.parentNode !== container) {
+			styleElement = doc.createElement("style");
+			rootElement = doc.createElement("div");
+			rootElement.setAttribute("data-streaming-markdown-root", "");
+			previousChildren = [];
+			removeAllChildren(container);
+			container.appendChild(styleElement);
+			container.appendChild(rootElement);
+		}
+		const styles = (0, _copilotkit_markdown.getStreamingMarkdownStyles)();
+		if (styleElement.textContent !== styles) styleElement.textContent = styles;
+		const rootClass = nextProps.className ? `${_copilotkit_markdown.STREAMING_MARKDOWN_ROOT_CLASS} ${nextProps.className}` : _copilotkit_markdown.STREAMING_MARKDOWN_ROOT_CLASS;
+		if (rootElement.className !== rootClass) rootElement.className = rootClass;
+		const nextChildren = tree.root ? toVNode(tree.root, {
+			document: doc,
+			nodeRenderers: nextProps.nodeRenderers,
+			overrideCache
+		}) : [];
+		patchChildren(rootElement, previousChildren, nextChildren, doc);
+		previousChildren = nextChildren;
+		actions = /* @__PURE__ */ new WeakMap();
+		collectActions(nextChildren, actions);
+	}
+	function destroy() {
+		container.removeEventListener("click", onClick);
+		removeAllChildren(container);
+		session = null;
+		styleElement = null;
+		rootElement = null;
+		previousChildren = [];
+	}
+	return {
+		render,
+		destroy
+	};
+}
+
+//#endregion
+exports.createStreamingMarkdownDomRenderer = createStreamingMarkdownDomRenderer;
+//# sourceMappingURL=index.cjs.map

package/dist/dom/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["STREAMING_MARKDOWN_CARET_STYLE","STREAMING_MARKDOWN_CARET_ATTRS","STREAMING_MARKDOWN_ROOT_CLASS"],"sources":["../../src/dom/streaming-markdown-dom-renderer.ts"],"sourcesContent":["import {\n  STREAMING_MARKDOWN_CARET_ATTRS,\n  STREAMING_MARKDOWN_CARET_STYLE,\n  STREAMING_MARKDOWN_ROOT_CLASS,\n  buildStreamingMarkdownRenderTree,\n  getStreamingMarkdownStyles,\n  updateStreamingMarkdownParserSession,\n} from \"@copilotkit/markdown\";\nimport type {\n  StreamingMarkdownAstNode,\n  StreamingMarkdownCitationRenderData,\n  StreamingMarkdownNodeClassNames,\n  StreamingMarkdownNodeRendererKey,\n  StreamingMarkdownParserOptions,\n  StreamingMarkdownParserSession,\n  StreamingMarkdownRenderAction,\n  StreamingMarkdownRenderChild,\n  StreamingMarkdownRenderNode,\n} from \"@copilotkit/markdown\";\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * Props supplied to a custom DOM node renderer.\n *\n * @public\n */\nexport interface StreamingMarkdownDomNodeRendererProps {\n  /** The immutable AST node being rendered. */\n  node: StreamingMarkdownAstNode;\n  /** Freshly rendered child content for container nodes; `null` for leaves. */\n  children: Node[] | null;\n  /** Freshly rendered default element for this node. */\n  defaultNode: Node | null;\n  /** Citation metadata when rendering a citation node. */\n  citation?: StreamingMarkdownCitationRenderData;\n  /** Document to create nodes with (the container's owner document). */\n  document: Document;\n}\n\n/**\n * Custom renderer for one node type. Return the node to insert, or `null`\n * to render nothing.\n *\n * @public\n */\nexport type StreamingMarkdownDomNodeRenderer = (\n  props: StreamingMarkdownDomNodeRendererProps,\n) => Node | null;\n\n/**\n * Custom DOM renderers keyed by camelCase node names (`node` is a catch-all).\n *\n * @public\n */\nexport type StreamingMarkdownDomNodeRenderers = Partial<\n  Record<StreamingMarkdownNodeRendererKey, StreamingMarkdownDomNodeRenderer>\n>;\n\n/**\n * Inputs for one render. Pass the full set every time, like component props.\n *\n * @public\n */\nexport interface StreamingMarkdownDomRenderProps {\n  /** Full markdown source that grows over time. */\n  content: string;\n  /** `true` once the source is final; hides the caret. */\n  isComplete?: boolean;\n  /** Parser option overrides. */\n  options?: Partial<StreamingMarkdownParserOptions>;\n  /** Render the default streaming caret inside the deepest open node. */\n  caret?: boolean;\n  /** Extra class on the root element. */\n  className?: string;\n  /** Called when a link or autolink is clicked. */\n  onLinkClick?: (\n    event: MouseEvent,\n    url: string,\n    node: StreamingMarkdownAstNode,\n  ) => void;\n  /** Called when a citation reference with a URL is clicked. */\n  onCitationClick?: (\n    event: MouseEvent,\n    citation: StreamingMarkdownCitationRenderData,\n    node: StreamingMarkdownAstNode,\n  ) => void;\n  /** Custom renderers keyed by node type. */\n  nodeRenderers?: StreamingMarkdownDomNodeRenderers;\n  /** Extra classes for the default element of a node type. */\n  nodeClassNames?: StreamingMarkdownNodeClassNames;\n}\n\n// ---------------------------------------------------------------------------\n// Virtual nodes\n// ---------------------------------------------------------------------------\n\ntype VElement = {\n  kind: \"element\";\n  key: string;\n  tag: string;\n  attrs: Readonly<Record<string, string | true>>;\n  action?: StreamingMarkdownRenderAction;\n  children: VChild[];\n  dom?: Element;\n};\ntype VText = { kind: \"text\"; key: string; text: string; dom?: Text };\ntype VRaw = { kind: \"raw\"; key: string; dom: Node };\ntype VChild = VElement | VText | VRaw;\n\ntype BuildContext = {\n  document: Document;\n  nodeRenderers: StreamingMarkdownDomNodeRenderers | undefined;\n  overrideCache: WeakMap<\n    StreamingMarkdownAstNode,\n    { renderer: StreamingMarkdownDomNodeRenderer; dom: Node | null }\n  >;\n};\n\nfunction toKebabCase(property: string) {\n  return property.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);\n}\n\nconst CARET_STYLE = Object.entries(STREAMING_MARKDOWN_CARET_STYLE)\n  .map(([property, value]) => `${toKebabCase(property)}:${value}`)\n  .join(\";\");\n\nfunction caretElement(key: string): VElement {\n  return {\n    kind: \"element\",\n    key,\n    tag: \"span\",\n    attrs: { ...STREAMING_MARKDOWN_CARET_ATTRS, style: CARET_STYLE },\n    children: [],\n  };\n}\n\nfunction prefixed(prefix: string, children: VChild[]) {\n  return children.map((child) => ({ ...child, key: `${prefix}:${child.key}` }));\n}\n\nfunction toVChildren(\n  children: StreamingMarkdownRenderChild[],\n  context: BuildContext,\n  slot: VChild[],\n): VChild[] {\n  return children.flatMap((child) => {\n    switch (child.kind) {\n      case \"node\":\n        return toVNode(child, context);\n      case \"element\": {\n        const element: VElement = {\n          kind: \"element\",\n          key: child.key,\n          tag: child.tag,\n          attrs: child.attrs,\n          children: toVChildren(child.children, context, slot),\n        };\n        return child.action\n          ? [{ ...element, action: child.action }]\n          : [element];\n      }\n      case \"text\":\n        return [{ kind: \"text\", key: child.key, text: child.text }];\n      case \"caret\":\n        return [caretElement(child.key)];\n      case \"slot\":\n        return slot;\n      default: {\n        const unreachable: never = child;\n        return unreachable;\n      }\n    }\n  });\n}\n\nfunction renderOverride(\n  renderNode: StreamingMarkdownRenderNode,\n  renderer: StreamingMarkdownDomNodeRenderer,\n  context: BuildContext,\n) {\n  // AST nodes keep their identity while unchanged, so an override's output can\n  // be reused unless the caret (which is not part of the node) moves inside it.\n  const cached = context.overrideCache.get(renderNode.node);\n  if (cached?.renderer === renderer && !renderNode.containsCaret) {\n    return cached.dom;\n  }\n\n  const doc = context.document;\n  const materialize = (entries: VChild[]) =>\n    entries.map((entry) => createDom(entry, doc));\n  const children = renderNode.children\n    ? materialize(toVChildren(renderNode.children, context, []))\n    : null;\n  const defaultNodes = materialize(\n    toVChildren(\n      renderNode.output,\n      context,\n      renderNode.children ? toVChildren(renderNode.children, context, []) : [],\n    ),\n  );\n  const defaultNode =\n    defaultNodes.length === 1\n      ? defaultNodes[0]\n      : wrapInFragment(defaultNodes, doc);\n\n  const dom = renderer({\n    node: renderNode.node,\n    children,\n    defaultNode,\n    citation: renderNode.citation,\n    document: doc,\n  });\n  context.overrideCache.set(renderNode.node, { renderer, dom });\n  return dom;\n}\n\nfunction wrapInFragment(nodes: Node[], doc: Document) {\n  if (nodes.length === 0) return null;\n  const fragment = doc.createDocumentFragment();\n  for (const node of nodes) fragment.appendChild(node);\n  return fragment;\n}\n\nfunction toVNode(\n  renderNode: StreamingMarkdownRenderNode,\n  context: BuildContext,\n): VChild[] {\n  const renderer =\n    context.nodeRenderers?.[renderNode.rendererKey] ??\n    context.nodeRenderers?.node;\n  if (renderer) {\n    const dom = renderOverride(renderNode, renderer, context);\n    return dom ? [{ kind: \"raw\", key: renderNode.key, dom }] : [];\n  }\n\n  const slot = renderNode.children\n    ? toVChildren(renderNode.children, context, [])\n    : [];\n  return prefixed(\n    renderNode.key,\n    toVChildren(renderNode.output, context, slot),\n  );\n}\n\n// ---------------------------------------------------------------------------\n// DOM creation and keyed patching\n// ---------------------------------------------------------------------------\n\nfunction setAttributes(\n  element: Element,\n  next: Readonly<Record<string, string | true>>,\n  previous: Readonly<Record<string, string | true>>,\n) {\n  const previousNames = Object.keys(previous);\n  for (const name of previousNames) {\n    if (!(name in next)) element.removeAttribute(name);\n  }\n  const entries = Object.entries(next);\n  for (const [name, value] of entries) {\n    if (previous[name] !== value) {\n      element.setAttribute(name, value === true ? \"\" : value);\n    }\n  }\n}\n\nfunction createDom(child: VChild, doc: Document): Node {\n  switch (child.kind) {\n    case \"raw\":\n      return child.dom;\n    case \"text\": {\n      child.dom = doc.createTextNode(child.text);\n      return child.dom;\n    }\n    case \"element\": {\n      const element = doc.createElement(child.tag);\n      setAttributes(element, child.attrs, {});\n      for (const entry of child.children) {\n        element.appendChild(createDom(entry, doc));\n      }\n      child.dom = element;\n      return element;\n    }\n    default: {\n      const unreachable: never = child;\n      return unreachable;\n    }\n  }\n}\n\n/** Updates `previous`'s DOM to match `next` and returns it, or `null` if incompatible. */\nfunction patchDom(previous: VChild, next: VChild, doc: Document): Node | null {\n  if (previous.kind === \"text\" && next.kind === \"text\" && previous.dom) {\n    if (previous.text !== next.text) previous.dom.data = next.text;\n    next.dom = previous.dom;\n    return next.dom;\n  }\n  if (previous.kind === \"raw\" && next.kind === \"raw\") {\n    return previous.dom === next.dom ? next.dom : null;\n  }\n  const sameElement =\n    previous.kind === \"element\" &&\n    next.kind === \"element\" &&\n    previous.tag === next.tag &&\n    previous.dom !== undefined;\n  if (!sameElement) {\n    return null;\n  }\n  const element = previous.dom;\n  if (!element) return null;\n  setAttributes(element, next.attrs, previous.attrs);\n  patchChildren(element, previous.children, next.children, doc);\n  next.dom = element;\n  return element;\n}\n\nfunction patchChildren(\n  parent: Node,\n  previous: VChild[],\n  next: VChild[],\n  doc: Document,\n) {\n  const unused = new Map(previous.map((child) => [child.key, child]));\n  let cursor: Node | null = parent.firstChild;\n\n  for (const child of next) {\n    const match = unused.get(child.key);\n    const reused = match ? patchDom(match, child, doc) : null;\n    if (match && reused) unused.delete(child.key);\n    const dom = reused ?? createDom(child, doc);\n\n    if (dom === cursor) {\n      cursor = cursor.nextSibling;\n    } else {\n      parent.insertBefore(dom, cursor);\n    }\n  }\n\n  const leftovers = Array.from(unused.values());\n  for (const child of leftovers) {\n    const dom = child.dom;\n    if (dom && dom.parentNode === parent) parent.removeChild(dom);\n  }\n}\n\n// Server DOMs (domino) lack replaceChildren(), so clear by hand.\nfunction removeAllChildren(parent: Node) {\n  while (parent.firstChild) parent.removeChild(parent.firstChild);\n}\n\nfunction collectActions(\n  children: VChild[],\n  actions: WeakMap<Node, StreamingMarkdownRenderAction>,\n) {\n  for (const child of children) {\n    if (child.kind !== \"element\" || !child.dom) continue;\n    if (child.action) actions.set(child.dom, child.action);\n    collectActions(child.children, actions);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Renderer\n// ---------------------------------------------------------------------------\n\n/**\n * Creates a framework-free streaming markdown renderer that draws into\n * `container`. It parses incrementally, renders the same render tree as the\n * React and Vue renderers (same markup, URL sanitization, caret, citations,\n * and per-token fade-in), and patches the DOM by key so text that is already\n * on screen keeps its nodes and does not animate again.\n *\n * Creates nodes with `container.ownerDocument`, so it works with server DOMs\n * that have no global `document`.\n *\n * @param container - Element the renderer owns. Its children are replaced.\n * @returns `render(props)` to draw the latest props, and `destroy()` to remove\n * the output and the click listener.\n *\n * @example\n * ```ts\n * const renderer = createStreamingMarkdownDomRenderer(element);\n * renderer.render({ content: \"**Hi**\", caret: true });\n * renderer.render({ content: \"**Hi** there\", isComplete: true });\n * renderer.destroy();\n * ```\n * @public\n */\nexport function createStreamingMarkdownDomRenderer(container: HTMLElement) {\n  const doc = container.ownerDocument;\n  let session: StreamingMarkdownParserSession | null = null;\n  let props: StreamingMarkdownDomRenderProps = { content: \"\" };\n  let styleElement: HTMLStyleElement | null = null;\n  let rootElement: HTMLDivElement | null = null;\n  let previousChildren: VChild[] = [];\n  let actions = new WeakMap<Node, StreamingMarkdownRenderAction>();\n  const overrideCache: BuildContext[\"overrideCache\"] = new WeakMap();\n\n  // One delegated listener; actions are looked up per click so callbacks and\n  // links always reflect the latest render.\n  const onClick = (event: MouseEvent) => {\n    let target = event.target instanceof Node ? event.target : null;\n    while (target && target !== container) {\n      const action = actions.get(target);\n      if (action?.type === \"link\") {\n        props.onLinkClick?.(event, action.url, action.node);\n        return;\n      }\n      if (action?.type === \"citation\") {\n        props.onCitationClick?.(event, action.citation, action.node);\n        return;\n      }\n      target = target.parentNode;\n    }\n  };\n  container.addEventListener(\"click\", onClick);\n\n  function render(nextProps: StreamingMarkdownDomRenderProps) {\n    props = nextProps;\n    session = updateStreamingMarkdownParserSession(\n      session,\n      nextProps.content,\n      nextProps.options,\n      nextProps.isComplete ?? false,\n    );\n    const state = session.parserState;\n    const tree = buildStreamingMarkdownRenderTree(state, {\n      caret: nextProps.caret === true,\n      nodeClassNames: nextProps.nodeClassNames,\n    });\n\n    if (!styleElement || !rootElement || rootElement.parentNode !== container) {\n      styleElement = doc.createElement(\"style\");\n      rootElement = doc.createElement(\"div\");\n      rootElement.setAttribute(\"data-streaming-markdown-root\", \"\");\n      previousChildren = [];\n      removeAllChildren(container);\n      container.appendChild(styleElement);\n      container.appendChild(rootElement);\n    }\n    const styles = getStreamingMarkdownStyles();\n    if (styleElement.textContent !== styles) styleElement.textContent = styles;\n    const rootClass = nextProps.className\n      ? `${STREAMING_MARKDOWN_ROOT_CLASS} ${nextProps.className}`\n      : STREAMING_MARKDOWN_ROOT_CLASS;\n    if (rootElement.className !== rootClass) rootElement.className = rootClass;\n\n    const nextChildren = tree.root\n      ? toVNode(tree.root, {\n          document: doc,\n          nodeRenderers: nextProps.nodeRenderers,\n          overrideCache,\n        })\n      : [];\n    patchChildren(rootElement, previousChildren, nextChildren, doc);\n    previousChildren = nextChildren;\n    actions = new WeakMap();\n    collectActions(nextChildren, actions);\n  }\n\n  function destroy() {\n    container.removeEventListener(\"click\", onClick);\n    removeAllChildren(container);\n    session = null;\n    styleElement = null;\n    rootElement = null;\n    previousChildren = [];\n  }\n\n  return { render, destroy };\n}\n\n/**\n * Renderer returned by {@link createStreamingMarkdownDomRenderer}.\n * @public\n */\nexport type StreamingMarkdownDomRenderer = ReturnType<\n  typeof createStreamingMarkdownDomRenderer\n>;\n"],"mappings":"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"}

package/dist/dom/index.d.cts

@@ -0,0 +1,93 @@
+import { StreamingMarkdownAstNode, StreamingMarkdownCitationRenderData, StreamingMarkdownNodeClassNames, StreamingMarkdownNodeRendererKey, StreamingMarkdownParserOptions } from "@copilotkit/markdown";
+
+//#region src/dom/streaming-markdown-dom-renderer.d.ts
+/**
+ * Props supplied to a custom DOM node renderer.
+ *
+ * @public
+ */
+interface StreamingMarkdownDomNodeRendererProps {
+  /** The immutable AST node being rendered. */
+  node: StreamingMarkdownAstNode;
+  /** Freshly rendered child content for container nodes; `null` for leaves. */
+  children: Node[] | null;
+  /** Freshly rendered default element for this node. */
+  defaultNode: Node | null;
+  /** Citation metadata when rendering a citation node. */
+  citation?: StreamingMarkdownCitationRenderData;
+  /** Document to create nodes with (the container's owner document). */
+  document: Document;
+}
+/**
+ * Custom renderer for one node type. Return the node to insert, or `null`
+ * to render nothing.
+ *
+ * @public
+ */
+type StreamingMarkdownDomNodeRenderer = (props: StreamingMarkdownDomNodeRendererProps) => Node | null;
+/**
+ * Custom DOM renderers keyed by camelCase node names (`node` is a catch-all).
+ *
+ * @public
+ */
+type StreamingMarkdownDomNodeRenderers = Partial<Record<StreamingMarkdownNodeRendererKey, StreamingMarkdownDomNodeRenderer>>;
+/**
+ * Inputs for one render. Pass the full set every time, like component props.
+ *
+ * @public
+ */
+interface StreamingMarkdownDomRenderProps {
+  /** Full markdown source that grows over time. */
+  content: string;
+  /** `true` once the source is final; hides the caret. */
+  isComplete?: boolean;
+  /** Parser option overrides. */
+  options?: Partial<StreamingMarkdownParserOptions>;
+  /** Render the default streaming caret inside the deepest open node. */
+  caret?: boolean;
+  /** Extra class on the root element. */
+  className?: string;
+  /** Called when a link or autolink is clicked. */
+  onLinkClick?: (event: MouseEvent, url: string, node: StreamingMarkdownAstNode) => void;
+  /** Called when a citation reference with a URL is clicked. */
+  onCitationClick?: (event: MouseEvent, citation: StreamingMarkdownCitationRenderData, node: StreamingMarkdownAstNode) => void;
+  /** Custom renderers keyed by node type. */
+  nodeRenderers?: StreamingMarkdownDomNodeRenderers;
+  /** Extra classes for the default element of a node type. */
+  nodeClassNames?: StreamingMarkdownNodeClassNames;
+}
+/**
+ * Creates a framework-free streaming markdown renderer that draws into
+ * `container`. It parses incrementally, renders the same render tree as the
+ * React and Vue renderers (same markup, URL sanitization, caret, citations,
+ * and per-token fade-in), and patches the DOM by key so text that is already
+ * on screen keeps its nodes and does not animate again.
+ *
+ * Creates nodes with `container.ownerDocument`, so it works with server DOMs
+ * that have no global `document`.
+ *
+ * @param container - Element the renderer owns. Its children are replaced.
+ * @returns `render(props)` to draw the latest props, and `destroy()` to remove
+ * the output and the click listener.
+ *
+ * @example
+ * ```ts
+ * const renderer = createStreamingMarkdownDomRenderer(element);
+ * renderer.render({ content: "**Hi**", caret: true });
+ * renderer.render({ content: "**Hi** there", isComplete: true });
+ * renderer.destroy();
+ * ```
+ * @public
+ */
+declare function createStreamingMarkdownDomRenderer(container: HTMLElement): {
+  render: (nextProps: StreamingMarkdownDomRenderProps) => void;
+  destroy: () => void;
+};
+/**
+ * Renderer returned by {@link createStreamingMarkdownDomRenderer}.
+ * @public
+ */
+type StreamingMarkdownDomRenderer = ReturnType<typeof createStreamingMarkdownDomRenderer>;
+//#endregion
+export { type StreamingMarkdownDomNodeRenderer, type StreamingMarkdownDomNodeRendererProps, type StreamingMarkdownDomNodeRenderers, type StreamingMarkdownDomRenderProps, type StreamingMarkdownDomRenderer, createStreamingMarkdownDomRenderer };
+//# sourceMappingURL=index.d.cts.map

package/dist/dom/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/dom/streaming-markdown-dom-renderer.ts"],"mappings":";;;;;AA6BA;;;UAAiB,qCAAA;EAIL;EAFV,IAAA,EAAM,wBAAA;EAMK;EAJX,QAAA,EAAU,IAAA;EAMQ;EAJlB,WAAA,EAAa,IAAA;EAJb;EAMA,QAAA,GAAW,mCAAA;EAJX;EAMA,QAAA,EAAU,QAAA;AAAA;;;;;;;KASA,gCAAA,IACV,KAAA,EAAO,qCAAA,KACJ,IAAA;AAFL;;;;;AAAA,KASY,iCAAA,GAAoC,OAAA,CAC9C,MAAA,CAAO,gCAAA,EAAkC,gCAAA;;;;AAD3C;;UASiB,+BAAA;EARR;EAUP,OAAA;EAVA;EAYA,UAAA;EAbqD;EAerD,OAAA,GAAU,OAAA,CAAQ,8BAAA;EAf4B;EAiB9C,KAAA;EAhBO;EAkBP,SAAA;EAlByE;EAoBzE,WAAA,IACE,KAAA,EAAO,UAAA,EACP,GAAA,UACA,IAAA,EAAM,wBAAA;EAfO;EAkBf,eAAA,IACE,KAAA,EAAO,UAAA,EACP,QAAA,EAAU,mCAAA,EACV,IAAA,EAAM,wBAAA;;EAGR,aAAA,GAAgB,iCAAA;EAlBN;EAoBV,cAAA,GAAiB,+BAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA0SH,kCAAA,CAAmC,SAAA,EAAW,WAAA;sBA6BjC,+BAAA;;;;;;;KA2DjB,4BAAA,GAA+B,UAAA,QAClC,kCAAA"}

package/dist/dom/index.d.mts

@@ -0,0 +1,93 @@
+import { StreamingMarkdownAstNode, StreamingMarkdownCitationRenderData, StreamingMarkdownNodeClassNames, StreamingMarkdownNodeRendererKey, StreamingMarkdownParserOptions } from "@copilotkit/markdown";
+
+//#region src/dom/streaming-markdown-dom-renderer.d.ts
+/**
+ * Props supplied to a custom DOM node renderer.
+ *
+ * @public
+ */
+interface StreamingMarkdownDomNodeRendererProps {
+  /** The immutable AST node being rendered. */
+  node: StreamingMarkdownAstNode;
+  /** Freshly rendered child content for container nodes; `null` for leaves. */
+  children: Node[] | null;
+  /** Freshly rendered default element for this node. */
+  defaultNode: Node | null;
+  /** Citation metadata when rendering a citation node. */
+  citation?: StreamingMarkdownCitationRenderData;
+  /** Document to create nodes with (the container's owner document). */
+  document: Document;
+}
+/**
+ * Custom renderer for one node type. Return the node to insert, or `null`
+ * to render nothing.
+ *
+ * @public
+ */
+type StreamingMarkdownDomNodeRenderer = (props: StreamingMarkdownDomNodeRendererProps) => Node | null;
+/**
+ * Custom DOM renderers keyed by camelCase node names (`node` is a catch-all).
+ *
+ * @public
+ */
+type StreamingMarkdownDomNodeRenderers = Partial<Record<StreamingMarkdownNodeRendererKey, StreamingMarkdownDomNodeRenderer>>;
+/**
+ * Inputs for one render. Pass the full set every time, like component props.
+ *
+ * @public
+ */
+interface StreamingMarkdownDomRenderProps {
+  /** Full markdown source that grows over time. */
+  content: string;
+  /** `true` once the source is final; hides the caret. */
+  isComplete?: boolean;
+  /** Parser option overrides. */
+  options?: Partial<StreamingMarkdownParserOptions>;
+  /** Render the default streaming caret inside the deepest open node. */
+  caret?: boolean;
+  /** Extra class on the root element. */
+  className?: string;
+  /** Called when a link or autolink is clicked. */
+  onLinkClick?: (event: MouseEvent, url: string, node: StreamingMarkdownAstNode) => void;
+  /** Called when a citation reference with a URL is clicked. */
+  onCitationClick?: (event: MouseEvent, citation: StreamingMarkdownCitationRenderData, node: StreamingMarkdownAstNode) => void;
+  /** Custom renderers keyed by node type. */
+  nodeRenderers?: StreamingMarkdownDomNodeRenderers;
+  /** Extra classes for the default element of a node type. */
+  nodeClassNames?: StreamingMarkdownNodeClassNames;
+}
+/**
+ * Creates a framework-free streaming markdown renderer that draws into
+ * `container`. It parses incrementally, renders the same render tree as the
+ * React and Vue renderers (same markup, URL sanitization, caret, citations,
+ * and per-token fade-in), and patches the DOM by key so text that is already
+ * on screen keeps its nodes and does not animate again.
+ *
+ * Creates nodes with `container.ownerDocument`, so it works with server DOMs
+ * that have no global `document`.
+ *
+ * @param container - Element the renderer owns. Its children are replaced.
+ * @returns `render(props)` to draw the latest props, and `destroy()` to remove
+ * the output and the click listener.
+ *
+ * @example
+ * ```ts
+ * const renderer = createStreamingMarkdownDomRenderer(element);
+ * renderer.render({ content: "**Hi**", caret: true });
+ * renderer.render({ content: "**Hi** there", isComplete: true });
+ * renderer.destroy();
+ * ```
+ * @public
+ */
+declare function createStreamingMarkdownDomRenderer(container: HTMLElement): {
+  render: (nextProps: StreamingMarkdownDomRenderProps) => void;
+  destroy: () => void;
+};
+/**
+ * Renderer returned by {@link createStreamingMarkdownDomRenderer}.
+ * @public
+ */
+type StreamingMarkdownDomRenderer = ReturnType<typeof createStreamingMarkdownDomRenderer>;
+//#endregion
+export { type StreamingMarkdownDomNodeRenderer, type StreamingMarkdownDomNodeRendererProps, type StreamingMarkdownDomNodeRenderers, type StreamingMarkdownDomRenderProps, type StreamingMarkdownDomRenderer, createStreamingMarkdownDomRenderer };
+//# sourceMappingURL=index.d.mts.map

package/dist/dom/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/dom/streaming-markdown-dom-renderer.ts"],"mappings":";;;;;AA6BA;;;UAAiB,qCAAA;EAIL;EAFV,IAAA,EAAM,wBAAA;EAMK;EAJX,QAAA,EAAU,IAAA;EAMQ;EAJlB,WAAA,EAAa,IAAA;EAJb;EAMA,QAAA,GAAW,mCAAA;EAJX;EAMA,QAAA,EAAU,QAAA;AAAA;;;;;;;KASA,gCAAA,IACV,KAAA,EAAO,qCAAA,KACJ,IAAA;AAFL;;;;;AAAA,KASY,iCAAA,GAAoC,OAAA,CAC9C,MAAA,CAAO,gCAAA,EAAkC,gCAAA;;;;AAD3C;;UASiB,+BAAA;EARR;EAUP,OAAA;EAVA;EAYA,UAAA;EAbqD;EAerD,OAAA,GAAU,OAAA,CAAQ,8BAAA;EAf4B;EAiB9C,KAAA;EAhBO;EAkBP,SAAA;EAlByE;EAoBzE,WAAA,IACE,KAAA,EAAO,UAAA,EACP,GAAA,UACA,IAAA,EAAM,wBAAA;EAfO;EAkBf,eAAA,IACE,KAAA,EAAO,UAAA,EACP,QAAA,EAAU,mCAAA,EACV,IAAA,EAAM,wBAAA;;EAGR,aAAA,GAAgB,iCAAA;EAlBN;EAoBV,cAAA,GAAiB,+BAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA0SH,kCAAA,CAAmC,SAAA,EAAW,WAAA;sBA6BjC,+BAAA;;;;;;;KA2DjB,4BAAA,GAA+B,UAAA,QAClC,kCAAA"}