stream-markdown-parser 0.0.58 → 0.0.59-beta.0

package/README.md

@@ -254,6 +254,10 @@ interface ParseOptions {
   preTransformTokens?: (tokens: Token[]) => Token[]
   postTransformTokens?: (tokens: Token[]) => Token[]
   postTransformNodes?: (nodes: ParsedNode[]) => ParsedNode[]
+  // Custom HTML-like tags to emit as custom nodes (e.g. ['thinking'])
+  customHtmlTags?: string[]
+  // Force specific tags to render as literal text (e.g. ['question', 'answer'])
+  escapeHtmlTags?: string[]
 }
 ```
 
@@ -273,6 +277,21 @@ const parseOptions = {
 
 Use the metadata in your renderer to show custom UI without mangling the original Markdown.
 
+Example — escape placeholder tags as literal text:
+
+```ts
+// If upstream content contains placeholder tags like <question> or <analysis>
+// that should be displayed as plain text instead of being interpreted as HTML:
+const nodes = parseMarkdownToStructure('<question>What is 2+2?</question>', md, {
+  escapeHtmlTags: ['question', 'answer']
+})
+// Renders as literal text: "<question>What is 2+2?</question>"
+```
+
+Notes:
+- If a tag name is present in both `customHtmlTags` and `escapeHtmlTags`, `escapeHtmlTags` takes precedence
+- Tag names are case-insensitive (normalized to lowercase)
+
 ### Utility Functions
 
 #### `isMathLike(content)`

package/README.zh-CN.md

@@ -253,10 +253,14 @@ interface ParseOptions {
   preTransformTokens?: (tokens: Token[]) => Token[]
   postTransformTokens?: (tokens: Token[]) => Token[]
   postTransformNodes?: (nodes: ParsedNode[]) => ParsedNode[]
+  // 自定义 HTML 类标签，作为自定义节点输出（如 ['thinking']）
+  customHtmlTags?: string[]
+  // 强制指定标签渲染为纯文本（如 ['question', 'answer']）
+  escapeHtmlTags?: string[]
 }
 ```
 
-示例 —— 标记 AI “思考” 块：
+示例 —— 标记 AI "思考" 块：
 
 ```ts
 const parseOptions = {
@@ -272,6 +276,21 @@ const parseOptions = {
 
 在渲染器中读取 `node.meta` 即可渲染自定义 UI，而无需直接修改 Markdown 文本。
 
+示例 —— 将占位符标签转义为纯文本：
+
+```ts
+// 如果上游内容包含占位符标签如 <question> 或 <analysis>，
+// 希望将它们显示为纯文本而不是被解释为 HTML：
+const nodes = parseMarkdownToStructure('<question>2+2 等于几？</question>', md, {
+  escapeHtmlTags: ['question', 'answer']
+})
+// 渲染为纯文本："<question>2+2 等于几？</question>"
+```
+
+注意：
+- 如果一个标签名同时存在于 `customHtmlTags` 和 `escapeHtmlTags`，`escapeHtmlTags` 优先
+- 标签名不区分大小写（会规范化为小写）
+
 ### 工具函数
 
 #### `isMathLike(content)`

package/dist/index.d.ts

@@ -334,6 +334,19 @@ interface ParseOptions {
    * to enable mid-state suppression for the same tags during streaming.
    */
   customHtmlTags?: string[];
+  /**
+   * HTML-like tag names that should be rendered as literal text instead of
+   * `html_inline`/`html_block` nodes (e.g. ['question', 'analysis']).
+   *
+   * Useful when upstream content may contain placeholder tags like `<question>`
+   * but you want them to display as plain text rather than being interpreted
+   * as HTML.
+   *
+   * Note: this applies to both inline and block HTML tokens. If a tag name is
+   * present in both `customHtmlTags` and `escapeHtmlTags`, `escapeHtmlTags`
+   * takes precedence.
+   */
+  escapeHtmlTags?: string[];
   debug?: boolean;
 }
 type PostTransformNodesHook = (nodes: ParsedNode[]) => ParsedNode[];
@@ -342,6 +355,7 @@ type PostTransformNodesHook = (nodes: ParsedNode[]) => ParsedNode[];
 declare function parseInlineTokens(tokens: MarkdownToken[], raw?: string, pPreToken?: MarkdownToken, options?: {
   requireClosingStrong?: boolean;
   customHtmlTags?: readonly string[];
+  escapeHtmlTags?: readonly string[];
 }): ParsedNode[];
 //#endregion
 //#region src/parser/index.d.ts

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/factory.ts","../src/types.ts","../src/parser/inline-parsers/index.ts","../src/parser/index.ts","../src/config.ts","../src/findMatchingClose.ts","../src/parser/inline-parsers/fence-parser.ts","../src/plugins/containers.ts","../src/plugins/isMathLike.ts","../src/plugins/math.ts","../src/index.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/factory.ts","../src/types.ts","../src/parser/inline-parsers/index.ts","../src/parser/index.ts","../src/config.ts","../src/findMatchingClose.ts","../src/parser/inline-parsers/fence-parser.ts","../src/plugins/containers.ts","../src/plugins/isMathLike.ts","../src/plugins/math.ts","../src/index.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.js

@@ -9128,7 +9128,8 @@ function parseEmphasisToken(tokens, startIndex, options) {
 	}
 	children.push(...parseInlineTokens(innerTokens, void 0, void 0, {
 		requireClosingStrong: options?.requireClosingStrong,
-		customHtmlTags: options?.customHtmlTags
+		customHtmlTags: options?.customHtmlTags,
+		escapeHtmlTags: options?.escapeHtmlTags
 	}));
 	return {
 		node: {
@@ -9239,7 +9240,8 @@ function parseHighlightToken(tokens, startIndex, options) {
 	}
 	children.push(...parseInlineTokens(innerTokens, void 0, void 0, {
 		requireClosingStrong: options?.requireClosingStrong,
-		customHtmlTags: options?.customHtmlTags
+		customHtmlTags: options?.customHtmlTags,
+		escapeHtmlTags: options?.escapeHtmlTags
 	}));
 	return {
 		node: {
@@ -9285,6 +9287,12 @@ function normalizeCustomTag(t) {
 	const m = raw.match(/^[<\s/]*([A-Z][\w-]*)/i);
 	return m ? m[1].toLowerCase() : "";
 }
+function normalizeTagName$1(t) {
+	const raw = String(t ?? "").trim();
+	if (!raw) return "";
+	const m = raw.match(/^[<\s/]*([A-Z][\w-]*)/i);
+	return m ? m[1].toLowerCase() : "";
+}
 function tokenToRaw(token) {
 	const shape = token;
 	const raw = shape.raw ?? shape.content ?? shape.markup ?? "";
@@ -9341,11 +9349,21 @@ function parseHtmlInlineCodeToken(token, tokens, i, parseInlineTokens$1, raw, pP
 	const tag = getTagName(code$1);
 	const customTags = options?.customHtmlTags;
 	const customTagSet = customTags && customTags.length ? new Set(customTags.map(normalizeCustomTag).filter(Boolean)) : null;
+	const escapeTags = options?.escapeHtmlTags;
+	const escapeTagSet = escapeTags && escapeTags.length ? new Set(escapeTags.map(normalizeTagName$1).filter(Boolean)) : null;
 	if (!tag) return [{
 		type: "inline_code",
 		code: code$1,
 		raw: code$1
 	}, i + 1];
+	if (escapeTagSet?.has(tag)) {
+		const content$1 = tokenToRaw(token);
+		return [{
+			type: "text",
+			content: content$1,
+			raw: content$1
+		}, i + 1];
+	}
 	if (tag === "br") return [{
 		type: "hardbreak",
 		raw: code$1
@@ -9495,7 +9513,8 @@ function parseInsertToken(tokens, startIndex, options) {
 	}
 	children.push(...parseInlineTokens(innerTokens, void 0, void 0, {
 		requireClosingStrong: options?.requireClosingStrong,
-		customHtmlTags: options?.customHtmlTags
+		customHtmlTags: options?.customHtmlTags,
+		escapeHtmlTags: options?.escapeHtmlTags
 	}));
 	return {
 		node: {
@@ -9524,7 +9543,8 @@ function parseLinkToken(tokens, startIndex, options) {
 	if (tokens[i]?.type === "link_close") loading = false;
 	const children = parseInlineTokens(linkTokens, void 0, void 0, {
 		requireClosingStrong: options?.requireClosingStrong,
-		customHtmlTags: options?.customHtmlTags
+		customHtmlTags: options?.customHtmlTags,
+		escapeHtmlTags: options?.escapeHtmlTags
 	});
 	const linkText = children.map((node) => {
 		const nodeAny = node;
@@ -9582,7 +9602,8 @@ function parseStrikethroughToken(tokens, startIndex, options) {
 	}
 	children.push(...parseInlineTokens(innerTokens, void 0, void 0, {
 		requireClosingStrong: options?.requireClosingStrong,
-		customHtmlTags: options?.customHtmlTags
+		customHtmlTags: options?.customHtmlTags,
+		escapeHtmlTags: options?.escapeHtmlTags
 	}));
 	return {
 		node: {
@@ -9614,7 +9635,8 @@ function parseStrongToken(tokens, startIndex, raw, options) {
 	}
 	children.push(...parseInlineTokens(innerTokens, raw, void 0, {
 		requireClosingStrong: options?.requireClosingStrong,
-		customHtmlTags: options?.customHtmlTags
+		customHtmlTags: options?.customHtmlTags,
+		escapeHtmlTags: options?.escapeHtmlTags
 	}));
 	return {
 		node: {
@@ -9640,7 +9662,8 @@ function parseSubscriptToken(tokens, startIndex, options) {
 	}
 	children.push(...parseInlineTokens(innerTokens, void 0, void 0, {
 		requireClosingStrong: options?.requireClosingStrong,
-		customHtmlTags: options?.customHtmlTags
+		customHtmlTags: options?.customHtmlTags,
+		escapeHtmlTags: options?.escapeHtmlTags
 	}));
 	const startContent = String(tokens[startIndex].content ?? "");
 	const display = subText || startContent;
@@ -9672,7 +9695,8 @@ function parseSuperscriptToken(tokens, startIndex, options) {
 	}
 	children.push(...parseInlineTokens(innerTokens, void 0, void 0, {
 		requireClosingStrong: options?.requireClosingStrong,
-		customHtmlTags: options?.customHtmlTags
+		customHtmlTags: options?.customHtmlTags,
+		escapeHtmlTags: options?.escapeHtmlTags
 	}));
 	return {
 		node: {
@@ -10475,7 +10499,8 @@ function parseList(tokens, index, options) {
 				type: "paragraph",
 				children: parseInlineTokens(contentToken.children || [], String(contentToken.content ?? ""), preToken, {
 					requireClosingStrong: options?.requireClosingStrong,
-					customHtmlTags: options?.customHtmlTags
+					customHtmlTags: options?.customHtmlTags,
+					escapeHtmlTags: options?.escapeHtmlTags
 				}),
 				raw: String(contentToken.content ?? "")
 			});
@@ -10532,7 +10557,8 @@ function parseAdmonition(tokens, index, match, options) {
 			type: "paragraph",
 			children: parseInlineTokens(contentToken.children || [], String(contentToken.content ?? ""), void 0, {
 				requireClosingStrong: options?.requireClosingStrong,
-				customHtmlTags: options?.customHtmlTags
+				customHtmlTags: options?.customHtmlTags,
+				escapeHtmlTags: options?.escapeHtmlTags
 			}),
 			raw: String(contentToken.content ?? "")
 		});
@@ -10604,7 +10630,8 @@ function parseContainer(tokens, index, options) {
 				type: "paragraph",
 				children: parseInlineTokens(_children || [], void 0, void 0, {
 					requireClosingStrong: options?.requireClosingStrong,
-					customHtmlTags: options?.customHtmlTags
+					customHtmlTags: options?.customHtmlTags,
+					escapeHtmlTags: options?.escapeHtmlTags
 				}),
 				raw: String(contentToken.content ?? "").replace(/\n:+$/, "").replace(/\n\s*:::\s*$/, "")
 			});
@@ -10661,7 +10688,8 @@ function parseBlockquote(tokens, index, options) {
 				type: "paragraph",
 				children: parseInlineTokens(contentToken.children || [], String(contentToken.content ?? ""), void 0, {
 					requireClosingStrong: options?.requireClosingStrong,
-					customHtmlTags: options?.customHtmlTags
+					customHtmlTags: options?.customHtmlTags,
+					escapeHtmlTags: options?.escapeHtmlTags
 				}),
 				raw: String(contentToken.content ?? "")
 			});
@@ -10725,7 +10753,8 @@ function parseDefinitionList(tokens, index, options) {
 		const termToken = tokens[j + 1];
 		termNodes = parseInlineTokens(termToken.children || [], void 0, void 0, {
 			requireClosingStrong: options?.requireClosingStrong,
-			customHtmlTags: options?.customHtmlTags
+			customHtmlTags: options?.customHtmlTags,
+			escapeHtmlTags: options?.escapeHtmlTags
 		});
 		j += 3;
 	} else if (tokens[j].type === "dd_open") {
@@ -10737,7 +10766,8 @@ function parseDefinitionList(tokens, index, options) {
 				type: "paragraph",
 				children: parseInlineTokens(contentToken.children || [], String(contentToken.content ?? ""), void 0, {
 					requireClosingStrong: options?.requireClosingStrong,
-					customHtmlTags: options?.customHtmlTags
+					customHtmlTags: options?.customHtmlTags,
+					escapeHtmlTags: options?.escapeHtmlTags
 				}),
 				raw: String(contentToken.content ?? "")
 			});
@@ -10776,7 +10806,8 @@ function parseFootnote(tokens, index, options) {
 			type: "paragraph",
 			children: parseInlineTokens(contentToken.children || [], String(contentToken.content ?? ""), void 0, {
 				requireClosingStrong: options?.requireClosingStrong,
-				customHtmlTags: options?.customHtmlTags
+				customHtmlTags: options?.customHtmlTags,
+				escapeHtmlTags: options?.escapeHtmlTags
 			}),
 			raw: String(contentToken.content ?? "")
 		});
@@ -10807,7 +10838,8 @@ function parseHeading(tokens, index, options) {
 		...attrsRecord ? { attrs: attrsRecord } : {},
 		children: parseInlineTokens(headingContentToken.children || [], headingContent, void 0, {
 			requireClosingStrong: options?.requireClosingStrong,
-			customHtmlTags: options?.customHtmlTags
+			customHtmlTags: options?.customHtmlTags,
+			escapeHtmlTags: options?.escapeHtmlTags
 		}),
 		raw: headingContent
 	};
@@ -10921,7 +10953,8 @@ function parseTable(tokens, index, options) {
 				header: isHeaderCell || isHeader,
 				children: parseInlineTokens(contentToken.children || [], content, void 0, {
 					requireClosingStrong: options?.requireClosingStrong,
-					customHtmlTags: options?.customHtmlTags
+					customHtmlTags: options?.customHtmlTags,
+					escapeHtmlTags: options?.escapeHtmlTags
 				}),
 				raw: content,
 				align
@@ -10989,7 +11022,8 @@ function parseVmrContainer(tokens, index, options) {
 				type: "paragraph",
 				children: parseInlineTokens(childrenArr || [], void 0, void 0, {
 					requireClosingStrong: options?.requireClosingStrong,
-					customHtmlTags: options?.customHtmlTags
+					customHtmlTags: options?.customHtmlTags,
+					escapeHtmlTags: options?.escapeHtmlTags
 				}),
 				raw: String(contentToken.content ?? "")
 			});
@@ -11143,6 +11177,27 @@ function parseBasicBlockToken(tokens, index, options) {
 		case "math_block": return [parseMathBlock(token), index + 1];
 		case "html_block": {
 			const htmlBlockNode = parseHtmlBlock(token);
+			const escapeTags = options?.escapeHtmlTags;
+			if (escapeTags?.length && htmlBlockNode.tag) {
+				const normalizeTagName$2 = (t) => {
+					const raw = String(t ?? "").trim();
+					if (!raw) return "";
+					const m = raw.match(/^[<\s/]*([A-Z][\w-]*)/i);
+					return m ? m[1].toLowerCase() : "";
+				};
+				if (new Set(escapeTags.map(normalizeTagName$2).filter(Boolean)).has(htmlBlockNode.tag)) {
+					const content = String(token?.content ?? "").replace(/\n+$/, "");
+					return [{
+						type: "paragraph",
+						children: [{
+							type: "text",
+							content,
+							raw: content
+						}],
+						raw: content
+					}, index + 1];
+				}
+			}
 			if (options?.customHtmlTags && htmlBlockNode.tag) {
 				if (new Set(options.customHtmlTags.map((t) => {
 					const m = String(t ?? "").trim().match(/^[<\s/]*([A-Z][\w-]*)/i);
@@ -11244,7 +11299,8 @@ function parseParagraph(tokens, index, options) {
 		type: "paragraph",
 		children: parseInlineTokens(paragraphContentToken.children || [], paragraphContent, void 0, {
 			requireClosingStrong: options?.requireClosingStrong,
-			customHtmlTags: options?.customHtmlTags
+			customHtmlTags: options?.customHtmlTags,
+			escapeHtmlTags: options?.escapeHtmlTags
 		}),
 		raw: paragraphContent
 	};
@@ -11252,6 +11308,85 @@ function parseParagraph(tokens, index, options) {
 
 //#endregion
 //#region src/parser/index.ts
+function normalizeTagName(t) {
+	const raw = String(t ?? "").trim();
+	if (!raw) return "";
+	const m = raw.match(/^[<\s/]*([A-Z][\w-]*)/i);
+	return m ? m[1].toLowerCase() : "";
+}
+function applyEscapeHtmlTags(nodes, options) {
+	const escapeTags = options?.escapeHtmlTags;
+	if (!escapeTags?.length) return nodes;
+	const escapeTagSet = new Set(escapeTags.map(normalizeTagName).filter(Boolean));
+	if (!escapeTagSet.size) return nodes;
+	const INLINE_CHILD_CONTAINERS = new Set([
+		"paragraph",
+		"heading",
+		"inline",
+		"link",
+		"strong",
+		"emphasis",
+		"strikethrough",
+		"highlight",
+		"insert",
+		"subscript",
+		"superscript",
+		"table_cell"
+	]);
+	const toInlineText = (raw) => {
+		const content = raw.replace(/\n+$/, "");
+		return {
+			type: "text",
+			content,
+			raw: content
+		};
+	};
+	const toParagraphText = (raw) => {
+		const content = raw.replace(/\n+$/, "");
+		return {
+			type: "paragraph",
+			raw: content,
+			children: content ? [toInlineText(content)] : []
+		};
+	};
+	const transformNode = (node, context) => {
+		const n = node;
+		const tag = typeof n?.tag === "string" ? String(n.tag).toLowerCase() : "";
+		if (tag && escapeTagSet.has(tag)) {
+			const raw = String(n?.raw ?? n?.content ?? "");
+			return context === "inline" ? toInlineText(raw) : toParagraphText(raw);
+		}
+		if ((n?.type === "html_inline" || n?.type === "html_block") && typeof n?.tag === "string") {
+			const htmlTag = String(n.tag).toLowerCase();
+			if (htmlTag && escapeTagSet.has(htmlTag)) {
+				const raw = String(n?.raw ?? n?.content ?? "");
+				return n.type === "html_inline" ? toInlineText(raw) : toParagraphText(raw);
+			}
+		}
+		const nextContextForChildren = context === "inline" || INLINE_CHILD_CONTAINERS.has(String(n?.type)) ? "inline" : "block";
+		if (Array.isArray(n?.children)) {
+			const nextChildren = n.children.map((child) => transformNode(child, nextContextForChildren));
+			if (nextChildren !== n.children) n.children = nextChildren;
+		}
+		if (n?.type === "list" && Array.isArray(n.items)) n.items = n.items.map((item) => transformNode(item, "block"));
+		else if (n?.type === "list_item" && Array.isArray(n.children)) n.children = n.children.map((child) => transformNode(child, "block"));
+		else if (n?.type === "blockquote" && Array.isArray(n.children)) n.children = n.children.map((child) => transformNode(child, "block"));
+		else if (n?.type === "table") {
+			if (n.header) n.header = transformNode(n.header, "block");
+			if (Array.isArray(n.rows)) n.rows = n.rows.map((row) => transformNode(row, "block"));
+		} else if (n?.type === "table_row" && Array.isArray(n.cells)) n.cells = n.cells.map((cell) => transformNode(cell, "block"));
+		else if (n?.type === "table_cell" && Array.isArray(n.children)) n.children = n.children.map((child) => transformNode(child, "inline"));
+		else if (n?.type === "definition_list" && Array.isArray(n.items)) n.items = n.items.map((item) => transformNode(item, "block"));
+		else if (n?.type === "definition_item") {
+			if (Array.isArray(n.term)) n.term = n.term.map((child) => transformNode(child, "inline"));
+			if (Array.isArray(n.definition)) n.definition = n.definition.map((child) => transformNode(child, "block"));
+		} else if (n?.type === "footnote" && Array.isArray(n.children)) n.children = n.children.map((child) => transformNode(child, "block"));
+		else if (n?.type === "admonition" && Array.isArray(n.children)) n.children = n.children.map((child) => transformNode(child, "block"));
+		else if (n?.type === "vmr_container" && Array.isArray(n.children)) n.children = n.children.map((child) => transformNode(child, "block"));
+		return node;
+	};
+	return nodes.map((node) => transformNode(node, "block"));
+}
 function stripDanglingHtmlLikeTail(markdown) {
 	const isWs = (ch) => ch === " " || ch === "	" || ch === "\n" || ch === "\r";
 	const isLikelyHtmlTagPrefix = (tail$1) => {
@@ -11737,6 +11872,7 @@ function parseMarkdownToStructure(markdown, md, options = {}) {
 			else result = postResult;
 		}
 	}
+	result = applyEscapeHtmlTags(result, options);
 	if (options.debug) console.log("Parsed Markdown Tree Structure:", result);
 	return result;
 }
@@ -11802,7 +11938,8 @@ function processTokens(tokens, options) {
 			case "inline":
 				result.push(...parseInlineTokens(token.children || [], String(token.content ?? ""), void 0, {
 					requireClosingStrong: options?.requireClosingStrong,
-					customHtmlTags: options?.customHtmlTags
+					customHtmlTags: options?.customHtmlTags,
+					escapeHtmlTags: options?.escapeHtmlTags
 				}));
 				i += 1;
 				break;
@@ -11811,7 +11948,7 @@ function processTokens(tokens, options) {
 				break;
 		}
 	}
-	return result;
+	return applyEscapeHtmlTags(result, options);
 }
 
 //#endregion