@hubstr/kit 0.1.5 → 0.1.6

package/ui/es/hooks/useEventCallback.mjs

@@ -0,0 +1,15 @@
+import { useCallback, useLayoutEffect, useRef } from "react";
+//#region src/hooks/useEventCallback.ts
+function useEventCallback(fn) {
+	const ref = useRef(fn);
+	useLayoutEffect(() => {
+		ref.current = fn;
+	});
+	return useCallback((...args) => {
+		return ref.current(...args);
+	}, []);
+}
+//#endregion
+export { useEventCallback };
+
+//# sourceMappingURL=useEventCallback.mjs.map

package/ui/es/hooks/useEventCallback.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEventCallback.mjs","names":[],"sources":["../../src/hooks/useEventCallback.ts"],"sourcesContent":["import { useCallback, useLayoutEffect, useRef } from 'react';\r\n\r\nexport function useEventCallback<T extends (...args: any[]) => any>(fn: T): T {\r\n  const ref = useRef(fn);\r\n\r\n  useLayoutEffect(() => {\r\n    ref.current = fn;\r\n  });\r\n\r\n  return useCallback((...args: Parameters<T>) => {\r\n    return ref.current(...args);\r\n  }, []) as T;\r\n}\r\n"],"mappings":";;AAEA,SAAgB,iBAAoD,IAAU;CAC5E,MAAM,MAAM,OAAO,GAAG;AAEtB,uBAAsB;AACpB,MAAI,UAAU;GACd;AAEF,QAAO,aAAa,GAAG,SAAwB;AAC7C,SAAO,IAAI,QAAQ,GAAG,KAAK;IAC1B,EAAE,CAAC"}

package/ui/es/hooks/useFloatingLayer.mjs

@@ -0,0 +1,25 @@
+"use client";
+import { createContext, use } from "react";
+//#region src/hooks/useFloatingLayer.tsx
+/**
+* Context for managing floating layer stacking.
+* When a component like Popover opens, it can provide its container
+* so that nested floating elements (like Tooltip) can render into it,
+* avoiding z-index stacking context issues.
+*/
+const FloatingLayerContext = createContext(null);
+/**
+* Hook to get the current floating layer container.
+* Returns the nearest floating layer container from context, or null if none exists.
+*/
+const useFloatingLayer = () => {
+	return use(FloatingLayerContext);
+};
+/**
+* Provider component for floating layer context.
+*/
+const FloatingLayerProvider = FloatingLayerContext.Provider;
+//#endregion
+export { FloatingLayerProvider, useFloatingLayer };
+
+//# sourceMappingURL=useFloatingLayer.mjs.map

package/ui/es/hooks/useFloatingLayer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFloatingLayer.mjs","names":[],"sources":["../../src/hooks/useFloatingLayer.tsx"],"sourcesContent":["'use client';\r\n\r\nimport { createContext, use } from 'react';\r\n\r\n/**\r\n * Context for managing floating layer stacking.\r\n * When a component like Popover opens, it can provide its container\r\n * so that nested floating elements (like Tooltip) can render into it,\r\n * avoiding z-index stacking context issues.\r\n */\r\nexport const FloatingLayerContext = createContext<HTMLElement | null>(null);\r\n\r\n/**\r\n * Hook to get the current floating layer container.\r\n * Returns the nearest floating layer container from context, or null if none exists.\r\n */\r\nexport const useFloatingLayer = (): HTMLElement | null => {\r\n  return use(FloatingLayerContext);\r\n};\r\n\r\n/**\r\n * Provider component for floating layer context.\r\n */\r\nexport const FloatingLayerProvider = FloatingLayerContext.Provider;\r\n"],"mappings":";;;;;;;;;AAUA,MAAa,uBAAuB,cAAkC,KAAK;;;;;AAM3E,MAAa,yBAA6C;AACxD,QAAO,IAAI,qBAAqB;;;;;AAMlC,MAAa,wBAAwB,qBAAqB"}

package/ui/es/hooks/useHighlight.mjs

@@ -0,0 +1,128 @@
+"use client";
+import hubstr_theme_default from "../Highlighter/theme/hubstr-theme.mjs";
+import { getCodeLanguageByInput } from "../Highlighter/const.mjs";
+import { useEffect, useMemo, useState } from "react";
+import { transformerNotationDiff, transformerNotationErrorLevel, transformerNotationFocus, transformerNotationHighlight, transformerNotationWordHighlight } from "@shikijs/transformers";
+import { Md5 } from "ts-md5";
+const highlightCache = /* @__PURE__ */ new Map();
+const MAX_CACHE_SIZE = 1e3;
+const cleanupCache = () => {
+	if (highlightCache.size > MAX_CACHE_SIZE) {
+		const entriesToRemove = Math.floor(MAX_CACHE_SIZE * .2);
+		const keysToRemove = Array.from(highlightCache.keys()).slice(0, entriesToRemove);
+		for (const key of keysToRemove) highlightCache.delete(key);
+	}
+};
+let codeToHtmlPromise = null;
+const loadCodeToHtml = () => {
+	if (typeof window === "undefined") return Promise.resolve(null);
+	if (!codeToHtmlPromise) codeToHtmlPromise = import("shiki").then((mod) => mod.codeToHtml ?? null);
+	return codeToHtmlPromise;
+};
+const loadShikiModule = () => {
+	if (typeof window === "undefined") return Promise.resolve(null);
+	return import("shiki");
+};
+const shikiModulePromise = loadShikiModule();
+const escapeHtml = (str) => {
+	return str.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#039;");
+};
+const customThemes = { "hubstr-theme": hubstr_theme_default };
+const useHighlight = (text, { language, enableTransformer, theme: builtinTheme, streaming }) => {
+	const safeText = text ?? "";
+	const lang = (language ?? "plaintext").toLowerCase();
+	const matchedLanguage = useMemo(() => getCodeLanguageByInput(lang), [lang]);
+	const transformers = useMemo(() => {
+		if (!enableTransformer) return;
+		return [
+			transformerNotationDiff(),
+			transformerNotationHighlight(),
+			transformerNotationWordHighlight(),
+			transformerNotationFocus(),
+			transformerNotationErrorLevel()
+		];
+	}, [enableTransformer]);
+	const cacheKey = useMemo(() => {
+		if (streaming) return null;
+		return [
+			matchedLanguage,
+			builtinTheme,
+			safeText.length < 1e4 ? safeText : Md5.hashStr(safeText)
+		].filter(Boolean).join("-");
+	}, [
+		safeText,
+		matchedLanguage,
+		builtinTheme,
+		streaming
+	]);
+	const [data, setData] = useState();
+	useEffect(() => {
+		if (!cacheKey) {
+			setData(void 0);
+			return;
+		}
+		const cachedPromise = highlightCache.get(cacheKey);
+		if (cachedPromise) {
+			cachedPromise.then((html) => {
+				setData(html);
+			}).catch(() => {});
+			return;
+		}
+		const highlightPromise = (async () => {
+			try {
+				const shikiModule = await shikiModulePromise;
+				if (!shikiModule) return safeText;
+				const effectiveTheme = builtinTheme || "hubstr-theme";
+				if (!builtinTheme && effectiveTheme === "hubstr-theme") {
+					const customTheme = customThemes[effectiveTheme];
+					if (customTheme) return await (await shikiModule.getSingletonHighlighter({
+						langs: [matchedLanguage],
+						themes: [customTheme]
+					})).codeToHtml(safeText, {
+						lang: matchedLanguage,
+						theme: effectiveTheme,
+						transformers
+					});
+				}
+				const codeToHtml = await loadCodeToHtml();
+				if (!codeToHtml) return safeText;
+				return await codeToHtml(safeText, {
+					lang: matchedLanguage,
+					theme: effectiveTheme,
+					transformers
+				});
+			} catch (error_) {
+				console.error("Advanced rendering failed:", error_);
+				try {
+					const codeToHtml = await loadCodeToHtml();
+					if (!codeToHtml) return safeText;
+					return await codeToHtml(safeText, {
+						lang: matchedLanguage,
+						theme: "hubstr-theme"
+					});
+				} catch {
+					return `<pre class="fallback"><code>${escapeHtml(safeText)}</code></pre>`;
+				}
+			}
+		})();
+		highlightCache.set(cacheKey, highlightPromise);
+		cleanupCache();
+		highlightPromise.then((html) => {
+			if (highlightCache.get(cacheKey) === highlightPromise) setData(html);
+		}).catch(() => {
+			if (highlightCache.get(cacheKey) === highlightPromise) highlightCache.delete(cacheKey);
+		});
+	}, [
+		cacheKey,
+		safeText,
+		matchedLanguage,
+		builtinTheme,
+		transformers,
+		customThemes
+	]);
+	return data || "";
+};
+//#endregion
+export { shikiModulePromise, useHighlight };
+
+//# sourceMappingURL=useHighlight.mjs.map

package/ui/es/hooks/useHighlight.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHighlight.mjs","names":["hubstrTheme"],"sources":["../../src/hooks/useHighlight.ts"],"sourcesContent":["'use client';\r\n\r\nimport {\r\n  transformerNotationDiff,\r\n  transformerNotationErrorLevel,\r\n  transformerNotationFocus,\r\n  transformerNotationHighlight,\r\n  transformerNotationWordHighlight,\r\n} from '@shikijs/transformers';\r\nimport { type CSSProperties, useEffect, useMemo, useState } from 'react';\r\nimport type { BuiltinTheme, CodeToHastOptions, ThemedToken } from 'shiki';\r\nimport { Md5 } from 'ts-md5';\r\n\r\nimport { getCodeLanguageByInput } from '../Highlighter/const';\r\nimport hubstrTheme from '../Highlighter/theme/hubstr-theme';\r\n\r\n// Application-level cache to avoid repeated calculations\r\nexport const MD5_LENGTH_THRESHOLD = 10_000; // Use async MD5 for text exceeding this length\r\n\r\nexport type StreamingHighlightResult = {\r\n  lines: ThemedToken[][];\r\n  preStyle?: CSSProperties;\r\n};\r\n\r\n// Application-level cache for highlighted HTML\r\n// Key: cacheKey string, Value: Promise<string>\r\nconst highlightCache = new Map<string, Promise<string>>();\r\n\r\n// Maximum cache size to prevent memory leaks\r\nconst MAX_CACHE_SIZE = 1000;\r\n\r\n// Clean up old cache entries when limit is reached\r\nconst cleanupCache = () => {\r\n  if (highlightCache.size > MAX_CACHE_SIZE) {\r\n    // Remove oldest 20% of entries\r\n    const entriesToRemove = Math.floor(MAX_CACHE_SIZE * 0.2);\r\n    const keysToRemove = Array.from(highlightCache.keys()).slice(0, entriesToRemove);\r\n    for (const key of keysToRemove) {\r\n      highlightCache.delete(key);\r\n    }\r\n  }\r\n};\r\n\r\nexport type ICodeToHtml = (code: string, options: CodeToHastOptions) => Promise<string>;\r\nexport type ShikiModule = typeof import('shiki');\r\n\r\n// Use codeToHtml shorthand for better performance\r\n// It automatically manages highlighter instances and loads themes/languages on-demand\r\nlet codeToHtmlPromise: Promise<ICodeToHtml | null> | null = null;\r\n\r\nconst loadCodeToHtml = (): Promise<ICodeToHtml | null> => {\r\n  if (typeof window === 'undefined') return Promise.resolve(null);\r\n\r\n  if (!codeToHtmlPromise) {\r\n    codeToHtmlPromise = import('shiki').then((mod) => mod.codeToHtml ?? null);\r\n  }\r\n\r\n  return codeToHtmlPromise;\r\n};\r\n\r\n// Export shikiModulePromise for useStreamHighlight compatibility\r\nconst loadShikiModule = (): Promise<ShikiModule | null> => {\r\n  if (typeof window === 'undefined') return Promise.resolve(null);\r\n  return import('shiki');\r\n};\r\nexport const shikiModulePromise = loadShikiModule();\r\n\r\n// Helper function: Safe HTML escaping\r\nexport const escapeHtml = (str: string): string => {\r\n  return str\r\n    .replaceAll('&', '&amp;')\r\n    .replaceAll('<', '&lt;')\r\n    .replaceAll('>', '&gt;')\r\n    .replaceAll('\"', '&quot;')\r\n    .replaceAll(\"'\", '&#039;');\r\n};\r\n\r\n// Main highlight component - optimized version without SWR\r\nconst customThemes = {\r\n  'hubstr-theme': hubstrTheme,\r\n};\r\n\r\nexport const useHighlight = (\r\n  text: string,\r\n  {\r\n    language,\r\n    enableTransformer,\r\n    theme: builtinTheme,\r\n    streaming,\r\n  }: { enableTransformer?: boolean; language: string; streaming?: boolean; theme?: BuiltinTheme },\r\n): string => {\r\n  // Safely handle language and text with boundary checks\r\n  const safeText = text ?? '';\r\n  const lang = (language ?? 'plaintext').toLowerCase();\r\n\r\n  // Match supported languages\r\n  const matchedLanguage = useMemo(() => getCodeLanguageByInput(lang), [lang]);\r\n\r\n  // Optimize transformer creation\r\n  const transformers = useMemo(() => {\r\n    if (!enableTransformer) return;\r\n    return [\r\n      transformerNotationDiff(),\r\n      transformerNotationHighlight(),\r\n      transformerNotationWordHighlight(),\r\n      transformerNotationFocus(),\r\n      transformerNotationErrorLevel(),\r\n    ];\r\n  }, [enableTransformer]);\r\n\r\n  // Build cache key\r\n  const cacheKey = useMemo((): string | null => {\r\n    if (streaming) return null;\r\n    // Use hash for long text\r\n    const hash = safeText.length < MD5_LENGTH_THRESHOLD ? safeText : Md5.hashStr(safeText);\r\n    return [matchedLanguage, builtinTheme, hash].filter(Boolean).join('-');\r\n  }, [safeText, matchedLanguage, builtinTheme, streaming]);\r\n\r\n  const [data, setData] = useState<string | undefined>();\r\n\r\n  useEffect(() => {\r\n    if (!cacheKey) {\r\n      setData(undefined);\r\n      return;\r\n    }\r\n\r\n    // Check cache first\r\n    const cachedPromise = highlightCache.get(cacheKey);\r\n    if (cachedPromise) {\r\n      cachedPromise\r\n        .then((html) => {\r\n          setData(html);\r\n        })\r\n        .catch(() => {\r\n          // Silently handle errors, fallback will be handled in the promise\r\n        });\r\n      return;\r\n    }\r\n\r\n    // Create new promise for highlighting\r\n    // Using codeToHtml shorthand: automatically loads themes/languages on-demand\r\n    const highlightPromise = (async (): Promise<string> => {\r\n      try {\r\n        // Try full rendering with transformers\r\n        const shikiModule = await shikiModulePromise;\r\n        if (!shikiModule) return safeText;\r\n\r\n        const effectiveTheme = builtinTheme || 'hubstr-theme';\r\n\r\n        // Load custom theme if using slack-dark or slack-ochin\r\n        if (!builtinTheme && effectiveTheme === 'hubstr-theme') {\r\n          const customTheme = customThemes[effectiveTheme];\r\n          if (customTheme) {\r\n            // Use getSingletonHighlighter to load custom theme\r\n            const highlighter = await shikiModule.getSingletonHighlighter({\r\n              langs: [matchedLanguage],\r\n              themes: [customTheme as any],\r\n            });\r\n\r\n            const html = await highlighter.codeToHtml(safeText, {\r\n              lang: matchedLanguage,\r\n              theme: effectiveTheme,\r\n              transformers,\r\n            });\r\n\r\n            return html;\r\n          }\r\n        }\r\n\r\n        // Fallback to codeToHtml for builtin themes\r\n        const codeToHtml = await loadCodeToHtml();\r\n        if (!codeToHtml) return safeText;\r\n\r\n        const html = await codeToHtml(safeText, {\r\n          lang: matchedLanguage,\r\n          theme: effectiveTheme,\r\n          transformers,\r\n        });\r\n\r\n        return html;\r\n      } catch (error_) {\r\n        console.error('Advanced rendering failed:', error_);\r\n\r\n        try {\r\n          // Try simple rendering (without transformers)\r\n          const codeToHtml = await loadCodeToHtml();\r\n          if (!codeToHtml) return safeText;\r\n          const html = await codeToHtml(safeText, {\r\n            lang: matchedLanguage,\r\n            theme: 'hubstr-theme',\r\n          });\r\n          return html;\r\n        } catch {\r\n          // Fallback to plain text\r\n          const fallbackHtml = `<pre class=\"fallback\"><code>${escapeHtml(safeText)}</code></pre>`;\r\n          return fallbackHtml;\r\n        }\r\n      }\r\n    })();\r\n\r\n    // Cache the promise\r\n    highlightCache.set(cacheKey, highlightPromise);\r\n    cleanupCache();\r\n\r\n    // Handle promise result\r\n    highlightPromise\r\n      .then((html) => {\r\n        // Only update if this is still the current cache key\r\n        if (highlightCache.get(cacheKey) === highlightPromise) {\r\n          setData(html);\r\n        }\r\n      })\r\n      .catch(() => {\r\n        // Remove failed promise from cache\r\n        if (highlightCache.get(cacheKey) === highlightPromise) {\r\n          highlightCache.delete(cacheKey);\r\n        }\r\n      });\r\n  }, [cacheKey, safeText, matchedLanguage, builtinTheme, transformers, customThemes]);\r\n\r\n  return data || '';\r\n};\r\n"],"mappings":"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"}

package/ui/es/hooks/useIsClient.mjs

@@ -0,0 +1,14 @@
+import { useEffect, useState } from "react";
+//#region src/hooks/useIsClient.ts
+const useIsClient = () => {
+	const [isClient, setIsClient] = useState(typeof document !== "undefined");
+	useEffect(() => {
+		if (isClient) return;
+		setIsClient(true);
+	}, []);
+	return isClient;
+};
+//#endregion
+export { useIsClient };
+
+//# sourceMappingURL=useIsClient.mjs.map

package/ui/es/hooks/useIsClient.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsClient.mjs","names":[],"sources":["../../src/hooks/useIsClient.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\r\n\r\nexport const useIsClient = () => {\r\n  const [isClient, setIsClient] = useState(typeof document !== 'undefined');\r\n\r\n  useEffect(() => {\r\n    if (isClient) return;\r\n    setIsClient(true);\r\n  }, []);\r\n\r\n  return isClient;\r\n};\r\n"],"mappings":";;AAEA,MAAa,oBAAoB;CAC/B,MAAM,CAAC,UAAU,eAAe,SAAS,OAAO,aAAa,YAAY;AAEzE,iBAAgB;AACd,MAAI,SAAU;AACd,cAAY,KAAK;IAChB,EAAE,CAAC;AAEN,QAAO"}

package/ui/es/hooks/useMarkdown/latex.mjs

@@ -0,0 +1,294 @@
+import { renderToString } from "katex";
+//#region src/hooks/useMarkdown/latex.ts
+/**
+* PlaceholderManager - Manages temporary replacement and restoration of protected content
+* Used to protect code blocks and LaTeX expressions during preprocessing
+*/
+var PlaceholderManager = class {
+	constructor(prefix = "PROTECTED") {
+		this.placeholders = [];
+		this.prefix = prefix;
+	}
+	add(content) {
+		const index = this.placeholders.length;
+		this.placeholders.push(content);
+		return `<<${this.prefix}_${index}>>`;
+	}
+	restore(text) {
+		return text.replaceAll(new RegExp(`<<${this.prefix}_(\\d+)>>`, "g"), (_, index) => {
+			return this.placeholders[Number.parseInt(index)] || "";
+		});
+	}
+	clear() {
+		this.placeholders = [];
+	}
+};
+const replaceUnescapedPipes = (formula) => formula.replaceAll(/(?<!\\)\|/g, "\\vert{}");
+/**
+* Converts LaTeX bracket delimiters to dollar sign delimiters.
+* Converts \[...\] to $$...$$ and \(...\) to $...$
+* Preserves code blocks during the conversion.
+*
+* @param text The input string containing LaTeX expressions
+* @returns The string with LaTeX bracket delimiters converted to dollar sign delimiters
+*/
+function convertLatexDelimiters(text) {
+	return text.replaceAll(/(```[\s\S]*?```|`.*?`)|\\\[([\s\S]*?[^\\])\\\]|\\\((.*?)\\\)/g, (match, codeBlock, squareBracket, roundBracket) => {
+		if (codeBlock !== void 0) return codeBlock;
+		else if (squareBracket !== void 0) return `$$${squareBracket}$$`;
+		else if (roundBracket !== void 0) return `$${roundBracket}$`;
+		return match;
+	});
+}
+/**
+* Escapes mhchem commands in LaTeX expressions to ensure proper rendering.
+*
+* @param text The input string containing LaTeX expressions with mhchem commands
+* @returns The string with escaped mhchem commands
+*/
+function escapeMhchemCommands(text) {
+	return text.replaceAll("$\\ce{", "$\\\\ce{").replaceAll("$\\pu{", "$\\\\pu{");
+}
+/**
+* Escapes pipe characters within LaTeX expressions to prevent them from being interpreted
+* as table column separators in markdown tables.
+*
+* @param text The input string containing LaTeX expressions
+* @returns The string with pipe characters escaped in LaTeX expressions
+*/
+function escapeLatexPipes(text) {
+	const codeBlocks = [];
+	let content = text.replaceAll(/(```[\s\S]*?```|`[^\n`]*`)/g, (match) => {
+		codeBlocks.push(match);
+		return `<<CODE_${codeBlocks.length - 1}>>`;
+	});
+	content = content.replaceAll(/\$\$([\s\S]*?)\$\$/g, (match, display) => {
+		return `$$${replaceUnescapedPipes(display)}$$`;
+	});
+	content = content.replaceAll(/(?<!\\)\$(?!\$)([^\n$]*)(?<!\\)\$(?!\$)/g, (match, inline) => {
+		return `$${replaceUnescapedPipes(inline)}$`;
+	});
+	content = content.replaceAll(/<<CODE_(\d+)>>/g, (_, index) => {
+		return codeBlocks[Number.parseInt(index)];
+	});
+	return content;
+}
+/**
+* Escapes underscores within \text{...} commands in LaTeX expressions
+* that are not already escaped.
+* For example, \text{node_domain} becomes \text{node\_domain},
+* but \text{node\_domain} remains \text{node\_domain}.
+*
+* @param text The input string potentially containing LaTeX expressions
+* @returns The string with unescaped underscores escaped within \text{...} commands
+*/
+function escapeTextUnderscores(text) {
+	return text.replaceAll(/\\text\{([^}]*)\}/g, (match, textContent) => {
+		return `\\text{${textContent.replaceAll(/(?<!\\)_/g, "\\_")}}`;
+	});
+}
+/**
+* Escapes dollar signs that appear to be currency symbols to prevent them from being
+* interpreted as LaTeX math delimiters.
+*
+* This function identifies currency patterns such as:
+* - $20, $100, $1,000
+* - $20-50, $100+
+* - Patterns within markdown tables
+*
+* @param text The input string containing potential currency symbols
+* @returns The string with currency dollar signs escaped
+*/
+function escapeCurrencyDollars(text) {
+	const manager = new PlaceholderManager("PROTECTED");
+	let content = text.replaceAll(/(```[\s\S]*?```|`[^\n`]*`|\$\$[\s\S]*?\$\$|(?<!\\)\$(?!\$)(?=[\s\S]*?\\)[\s\S]*?(?<!\\)\$(?!\$)|\$\d+\$|\$-?\d+(?:,-?\d+)+\$|\\\[[\s\S]*?\\\]|\\\(.*?\\\))/g, (match) => manager.add(match));
+	content = content.replaceAll(/(?<!\$)\$(\d{1,3}(?:,\d{3})*(?:\.\d+)?(?:-\d{1,3}(?:,\d{3})*(?:\.\d+)?)?\+?)(?!\$)/g, "\\$$$1");
+	content = manager.restore(content);
+	return content;
+}
+/**
+* Extracts the LaTeX formula after the last $$ delimiter if there's an odd number of $$ delimiters.
+*
+* @param text The input string containing LaTeX formulas
+* @returns The content after the last $$ if there's an odd number of $$, otherwise an empty string
+*/
+const extractIncompleteFormula = (text) => {
+	if ((text.match(/\$\$/g) || []).length % 2 === 1) {
+		const match = text.match(/\$\$([\s\S]*)$/);
+		return match ? match[1] : "";
+	}
+	return "";
+};
+/**
+* Checks if the last LaTeX formula in the text is renderable.
+* Only validates the formula after the last $$ if there's an odd number of $$.
+*
+* @param text The input string containing LaTeX formulas
+* @returns True if the last formula is renderable or if there's no incomplete formula
+*/
+const isLastFormulaRenderable = (text) => {
+	const formula = extractIncompleteFormula(text);
+	if (!formula) return true;
+	try {
+		renderToString(formula, {
+			displayMode: true,
+			throwOnError: true
+		});
+		return true;
+	} catch (error) {
+		console.error(`LaTeX formula rendering error: ${error}`);
+		return false;
+	}
+};
+/**
+* Fixes common LaTeX syntax errors automatically
+* - Balances unmatched braces
+* - Balances \left and \right delimiters
+*
+* @param text The input string containing LaTeX expressions
+* @returns The string with fixed LaTeX expressions
+*/
+function fixCommonLaTeXErrors(text) {
+	return text.replaceAll(/(\$\$[\s\S]*?\$\$|\$[\s\S]*?\$)/g, (match) => {
+		let fixed = match;
+		const openBraces = (fixed.match(/(?<!\\)\{/g) || []).length;
+		const closeBraces = (fixed.match(/(?<!\\)\}/g) || []).length;
+		if (openBraces > closeBraces) {
+			const diff = openBraces - closeBraces;
+			const closingBraces = "}".repeat(diff);
+			fixed = fixed.replace(/(\$\$?)$/, closingBraces + "$1");
+		}
+		const leftDelims = (fixed.match(/\\left[(.<[{|]/g) || []).length;
+		const rightDelims = (fixed.match(/\\right[).>\]|}]/g) || []).length;
+		if (leftDelims > rightDelims) {
+			const diff = leftDelims - rightDelims;
+			const rightDots = "\\right.".repeat(diff);
+			fixed = fixed.replace(/(\$\$?)$/, rightDots + "$1");
+		}
+		return fixed;
+	});
+}
+/**
+* Normalizes whitespace in LaTeX expressions
+* - Removes extra spaces around $ delimiters
+* - Normalizes multiple spaces to single space inside formulas
+*
+* @param text The input string containing LaTeX expressions
+* @returns The string with normalized whitespace
+*/
+function normalizeLatexSpacing(text) {
+	let result = text;
+	result = result.replaceAll(/\$\s+/g, "$");
+	result = result.replaceAll(/\s+\$/g, "$");
+	result = result.replaceAll(/\$\$\s+/g, "$$");
+	result = result.replaceAll(/\s+\$\$/g, "$$");
+	result = result.replaceAll(/(\$\$[\s\S]*?\$\$|\$[\s\S]*?\$)/g, (match) => {
+		return match.replaceAll(/\s{2,}/g, " ");
+	});
+	return result;
+}
+/**
+* Validates all LaTeX expressions in the text
+* Returns detailed information about validation results
+*
+* @param text The input string containing LaTeX expressions
+* @returns Validation results with errors if any
+*/
+function validateLatexExpressions(text) {
+	const errors = [];
+	let totalExpressions = 0;
+	const pattern = /\$\$([\s\S]*?)\$\$|(?<!\\)\$(?!\$)([\s\S]*?)(?<!\\)\$(?!\$)/g;
+	let match;
+	while ((match = pattern.exec(text)) !== null) {
+		totalExpressions++;
+		const formula = match[1] || match[2];
+		const isDisplay = match[0].startsWith("$$");
+		try {
+			renderToString(formula, {
+				displayMode: isDisplay,
+				strict: "warn",
+				throwOnError: true,
+				trust: false
+			});
+		} catch (error) {
+			errors.push({
+				formula: formula.slice(0, 50) + (formula.length > 50 ? "..." : ""),
+				message: error instanceof Error ? error.message : String(error),
+				position: match.index,
+				type: isDisplay ? "display" : "inline"
+			});
+		}
+	}
+	return {
+		errors,
+		totalExpressions,
+		valid: errors.length === 0
+	};
+}
+/**
+* Handles CJK (Chinese, Japanese, Korean) characters mixed with LaTeX
+* Optionally adds spaces between CJK characters and LaTeX expressions for better rendering
+*
+* @param text The input string
+* @param addSpaces Whether to add spaces between CJK and LaTeX (default: false)
+* @returns The processed string
+*/
+function handleCJKWithLatex(text, addSpaces = false) {
+	if (!addSpaces) return text;
+	let result = text;
+	result = result.replaceAll(/([\u3040-\u30FF\u4E00-\u9FA5])(\$)/g, "$1 $2");
+	result = result.replaceAll(/(\$)([\u3040-\u30FF\u4E00-\u9FA5])/g, "$1 $2");
+	return result;
+}
+/**
+* Comprehensive LaTeX preprocessing with configurable options
+*
+* This is the main preprocessing function that handles:
+* - Currency symbol escaping (e.g., $20 → \$20)
+* - LaTeX delimiter conversion (\[...\] → $$...$$)
+* - Special character escaping (pipes, underscores, mhchem)
+* - Optional error fixing and validation
+* - Optional CJK character handling
+*
+* @param text The input string containing LaTeX and Markdown
+* @param options Configuration options for fine-grained control
+* @returns The preprocessed string
+*
+* @example
+* ```ts
+* // Default behavior (same as old preprocessLaTeX)
+* preprocessLaTeX('向量$90^\\circ$，非 $0^\\circ$ 和 $180^\\circ$')
+*
+* // With custom options
+* preprocessLaTeX(text, {
+*   fixErrors: true,
+*   validate: true,
+*   handleCJK: true
+* })
+* ```
+*/
+function preprocessLaTeX(text, options = {}) {
+	const { addCJKSpaces = false, convertBrackets = true, escapeCurrency = true, escapeMhchem = true, escapePipes = true, escapeUnderscores = true, fixErrors = false, handleCJK = false, normalizeSpacing = false, throwOnValidationError = false, validate = false } = options;
+	let content = text;
+	if (escapeCurrency) content = escapeCurrencyDollars(content);
+	if (convertBrackets) content = convertLatexDelimiters(content);
+	if (escapeMhchem) content = escapeMhchemCommands(content);
+	if (escapePipes) content = escapeLatexPipes(content);
+	if (escapeUnderscores) content = escapeTextUnderscores(content);
+	if (fixErrors) content = fixCommonLaTeXErrors(content);
+	if (normalizeSpacing) content = normalizeLatexSpacing(content);
+	if (handleCJK) content = handleCJKWithLatex(content, addCJKSpaces);
+	if (validate) {
+		const validation = validateLatexExpressions(content);
+		if (!validation.valid) {
+			const errorMessage = `LaTeX validation failed (${validation.errors.length}/${validation.totalExpressions} expressions have errors):\n${validation.errors.map((e) => `  - [${e.type}] at position ${e.position}: ${e.message}\n    Formula: ${e.formula}`).join("\n")}`;
+			if (throwOnValidationError) throw new Error(errorMessage);
+			else console.warn(errorMessage);
+		}
+	}
+	return content;
+}
+//#endregion
+export { isLastFormulaRenderable, preprocessLaTeX };
+
+//# sourceMappingURL=latex.mjs.map

package/ui/es/hooks/useMarkdown/latex.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"latex.mjs","names":[],"sources":["../../../src/hooks/useMarkdown/latex.ts"],"sourcesContent":["import { renderToString } from 'katex';\r\n\r\n// ============================================================================\r\n// Utility Classes\r\n// ============================================================================\r\n\r\n/**\r\n * PlaceholderManager - Manages temporary replacement and restoration of protected content\r\n * Used to protect code blocks and LaTeX expressions during preprocessing\r\n */\r\nclass PlaceholderManager {\r\n  private placeholders: string[] = [];\r\n  private prefix: string;\r\n\r\n  constructor(prefix = 'PROTECTED') {\r\n    this.prefix = prefix;\r\n  }\r\n\r\n  add(content: string): string {\r\n    const index = this.placeholders.length;\r\n    this.placeholders.push(content);\r\n    return `<<${this.prefix}_${index}>>`;\r\n  }\r\n\r\n  restore(text: string): string {\r\n    return text.replaceAll(new RegExp(`<<${this.prefix}_(\\\\d+)>>`, 'g'), (_, index) => {\r\n      return this.placeholders[Number.parseInt(index)] || '';\r\n    });\r\n  }\r\n\r\n  clear(): void {\r\n    this.placeholders = [];\r\n  }\r\n}\r\n\r\n// ============================================================================\r\n// Helper Functions\r\n// ============================================================================\r\n\r\n// Helper: replace unescaped pipes with \\vert within a LaTeX math fragment\r\nconst replaceUnescapedPipes = (formula: string): string =>\r\n  // Use \\vert{} so the control sequence terminates before the next token\r\n  formula.replaceAll(/(?<!\\\\)\\|/g, '\\\\vert{}');\r\n\r\n/**\r\n * Converts LaTeX bracket delimiters to dollar sign delimiters.\r\n * Converts \\[...\\] to $$...$$ and \\(...\\) to $...$\r\n * Preserves code blocks during the conversion.\r\n *\r\n * @param text The input string containing LaTeX expressions\r\n * @returns The string with LaTeX bracket delimiters converted to dollar sign delimiters\r\n */\r\nexport function convertLatexDelimiters(text: string): string {\r\n  const pattern = /(```[\\s\\S]*?```|`.*?`)|\\\\\\[([\\s\\S]*?[^\\\\])\\\\\\]|\\\\\\((.*?)\\\\\\)/g;\r\n  return text.replaceAll(\r\n    pattern,\r\n    (\r\n      match: string,\r\n      codeBlock: string | undefined,\r\n      squareBracket: string | undefined,\r\n      roundBracket: string | undefined,\r\n    ): string => {\r\n      if (codeBlock !== undefined) {\r\n        return codeBlock;\r\n      } else if (squareBracket !== undefined) {\r\n        return `$$${squareBracket}$$`;\r\n      } else if (roundBracket !== undefined) {\r\n        return `$${roundBracket}$`;\r\n      }\r\n      return match;\r\n    },\r\n  );\r\n}\r\n\r\n/**\r\n * Escapes mhchem commands in LaTeX expressions to ensure proper rendering.\r\n *\r\n * @param text The input string containing LaTeX expressions with mhchem commands\r\n * @returns The string with escaped mhchem commands\r\n */\r\nexport function escapeMhchemCommands(text: string) {\r\n  return text.replaceAll('$\\\\ce{', '$\\\\\\\\ce{').replaceAll('$\\\\pu{', '$\\\\\\\\pu{');\r\n}\r\n\r\n/**\r\n * Escapes pipe characters within LaTeX expressions to prevent them from being interpreted\r\n * as table column separators in markdown tables.\r\n *\r\n * @param text The input string containing LaTeX expressions\r\n * @returns The string with pipe characters escaped in LaTeX expressions\r\n */\r\nexport function escapeLatexPipes(text: string): string {\r\n  // Replace unescaped '|' inside LaTeX math spans with '\\vert' so that\r\n  // remark-gfm table parsing won't treat them as column separators.\r\n  // Leave code blocks/inline code untouched.\r\n  // Also ignore escaped dollars (\\$) which are currency symbols\r\n\r\n  // Process code blocks first to protect them\r\n  const codeBlocks: string[] = [];\r\n  let content = text.replaceAll(/(```[\\s\\S]*?```|`[^\\n`]*`)/g, (match) => {\r\n    codeBlocks.push(match);\r\n    return `<<CODE_${codeBlocks.length - 1}>>`;\r\n  });\r\n\r\n  // For display math, allow multiline\r\n  content = content.replaceAll(/\\$\\$([\\s\\S]*?)\\$\\$/g, (match, display) => {\r\n    return `$$${replaceUnescapedPipes(display)}$$`;\r\n  });\r\n\r\n  // For inline math, use non-greedy match that DOES NOT cross newlines\r\n  // This prevents issues in tables where $ might appear in different cells\r\n  content = content.replaceAll(/(?<!\\\\)\\$(?!\\$)([^\\n$]*)(?<!\\\\)\\$(?!\\$)/g, (match, inline) => {\r\n    return `$${replaceUnescapedPipes(inline)}$`;\r\n  });\r\n\r\n  // Restore code blocks\r\n  content = content.replaceAll(/<<CODE_(\\d+)>>/g, (_, index) => {\r\n    return codeBlocks[Number.parseInt(index)];\r\n  });\r\n\r\n  return content;\r\n}\r\n\r\n/**\r\n * Escapes underscores within \\text{...} commands in LaTeX expressions\r\n * that are not already escaped.\r\n * For example, \\text{node_domain} becomes \\text{node\\_domain},\r\n * but \\text{node\\_domain} remains \\text{node\\_domain}.\r\n *\r\n * @param text The input string potentially containing LaTeX expressions\r\n * @returns The string with unescaped underscores escaped within \\text{...} commands\r\n */\r\nexport function escapeTextUnderscores(text: string): string {\r\n  return text.replaceAll(/\\\\text\\{([^}]*)\\}/g, (match, textContent: string) => {\r\n    // textContent is the content within the braces, e.g., \"node_domain\" or \"already\\_escaped\"\r\n    // Replace underscores '_' with '\\_' only if they are NOT preceded by a backslash '\\'.\r\n    // The (?<!\\\\) is a negative lookbehind assertion that ensures the character before '_' is not a '\\'.\r\n    const escapedTextContent = textContent.replaceAll(/(?<!\\\\)_/g, '\\\\_');\r\n    return `\\\\text{${escapedTextContent}}`;\r\n  });\r\n}\r\n\r\n/**\r\n * Escapes dollar signs that appear to be currency symbols to prevent them from being\r\n * interpreted as LaTeX math delimiters.\r\n *\r\n * This function identifies currency patterns such as:\r\n * - $20, $100, $1,000\r\n * - $20-50, $100+\r\n * - Patterns within markdown tables\r\n *\r\n * @param text The input string containing potential currency symbols\r\n * @returns The string with currency dollar signs escaped\r\n */\r\nexport function escapeCurrencyDollars(text: string): string {\r\n  // Protect code blocks and existing LaTeX expressions from processing\r\n  const manager = new PlaceholderManager('PROTECTED');\r\n\r\n  let content = text.replaceAll(\r\n    // Match patterns to protect (in order):\r\n    // 1. Code blocks: ```...```\r\n    // 2. Inline code: `...`\r\n    // 3. Display math: $$...$$\r\n    // 4. Inline math with LaTeX commands: $...\\...$ (must contain backslash to distinguish from currency)\r\n    // 5. Simple number formulas: $1$, $10$, $100$ (pure digits in math mode)\r\n    // 6. Number lists in math mode: $1,-1,0$ or $1,2,3$ (comma-separated numbers, possibly negative)\r\n    // 7. LaTeX bracket notation: \\[...\\]\r\n    // 8. LaTeX parenthesis notation: \\(...\\)\r\n    /(```[\\s\\S]*?```|`[^\\n`]*`|\\$\\$[\\s\\S]*?\\$\\$|(?<!\\\\)\\$(?!\\$)(?=[\\s\\S]*?\\\\)[\\s\\S]*?(?<!\\\\)\\$(?!\\$)|\\$\\d+\\$|\\$-?\\d+(?:,-?\\d+)+\\$|\\\\\\[[\\s\\S]*?\\\\\\]|\\\\\\(.*?\\\\\\))/g,\r\n    (match) => manager.add(match),\r\n  );\r\n\r\n  // Escape dollar signs that are clearly currency:\r\n  // - $ followed by a digit\r\n  // - Not preceded by another $ (to avoid breaking $$)\r\n  // - Not followed immediately by another $ (to avoid breaking $1$ LaTeX)\r\n  // - Followed by number patterns with optional commas, decimals, ranges, or plus signs\r\n  // Match patterns like: $20, $1,000, $19.99, $20-50, $300+, $1,000-2,000+\r\n  // But NOT: $1$, $2$ (these are LaTeX formulas)\r\n  // In the replacement: \\\\ = backslash, $$ = literal $, $1 = capture group 1\r\n  content = content.replaceAll(\r\n    /(?<!\\$)\\$(\\d{1,3}(?:,\\d{3})*(?:\\.\\d+)?(?:-\\d{1,3}(?:,\\d{3})*(?:\\.\\d+)?)?\\+?)(?!\\$)/g,\r\n    '\\\\$$$1',\r\n  );\r\n\r\n  // Restore protected content\r\n  content = manager.restore(content);\r\n\r\n  return content;\r\n}\r\n\r\n// Old simple preprocessLaTeX has been replaced by the comprehensive version below\r\n// The new preprocessLaTeX provides the same default behavior with optional advanced featuresgit\r\n\r\n/**\r\n * Extracts the LaTeX formula after the last $$ delimiter if there's an odd number of $$ delimiters.\r\n *\r\n * @param text The input string containing LaTeX formulas\r\n * @returns The content after the last $$ if there's an odd number of $$, otherwise an empty string\r\n */\r\nconst extractIncompleteFormula = (text: string) => {\r\n  // Count the number of $$ delimiters\r\n  const dollarsCount = (text.match(/\\$\\$/g) || []).length;\r\n\r\n  // If odd number of $$ delimiters, extract content after the last $$\r\n  if (dollarsCount % 2 === 1) {\r\n    const match = text.match(/\\$\\$([\\s\\S]*)$/);\r\n    return match ? match[1] : '';\r\n  }\r\n\r\n  // If even number of $$ delimiters, return empty string\r\n  return '';\r\n};\r\n\r\n/**\r\n * Checks if the last LaTeX formula in the text is renderable.\r\n * Only validates the formula after the last $$ if there's an odd number of $$.\r\n *\r\n * @param text The input string containing LaTeX formulas\r\n * @returns True if the last formula is renderable or if there's no incomplete formula\r\n */\r\nexport const isLastFormulaRenderable = (text: string) => {\r\n  const formula = extractIncompleteFormula(text);\r\n\r\n  // If no incomplete formula, return true\r\n  if (!formula) return true;\r\n\r\n  // Try to render the last formula\r\n  try {\r\n    renderToString(formula, {\r\n      displayMode: true,\r\n      throwOnError: true,\r\n    });\r\n    return true;\r\n  } catch (error) {\r\n    console.error(`LaTeX formula rendering error: ${error}`);\r\n    return false;\r\n  }\r\n};\r\n\r\n// ============================================================================\r\n// Advanced Preprocessing Functions\r\n// ============================================================================\r\n\r\n/**\r\n * Fixes common LaTeX syntax errors automatically\r\n * - Balances unmatched braces\r\n * - Balances \\left and \\right delimiters\r\n *\r\n * @param text The input string containing LaTeX expressions\r\n * @returns The string with fixed LaTeX expressions\r\n */\r\nexport function fixCommonLaTeXErrors(text: string): string {\r\n  return text.replaceAll(/(\\$\\$[\\s\\S]*?\\$\\$|\\$[\\s\\S]*?\\$)/g, (match) => {\r\n    let fixed = match;\r\n\r\n    // Fix unbalanced braces\r\n    const openBraces = (fixed.match(/(?<!\\\\)\\{/g) || []).length;\r\n    const closeBraces = (fixed.match(/(?<!\\\\)\\}/g) || []).length;\r\n    if (openBraces > closeBraces) {\r\n      const diff = openBraces - closeBraces;\r\n      const closingBraces = '}'.repeat(diff);\r\n      // Insert before the closing delimiter\r\n      fixed = fixed.replace(/(\\$\\$?)$/, closingBraces + '$1');\r\n    }\r\n\r\n    // Fix unbalanced \\left and \\right\r\n    const leftDelims = (fixed.match(/\\\\left[(.<[{|]/g) || []).length;\r\n    const rightDelims = (fixed.match(/\\\\right[).>\\]|}]/g) || []).length;\r\n    if (leftDelims > rightDelims) {\r\n      const diff = leftDelims - rightDelims;\r\n      const rightDots = '\\\\right.'.repeat(diff);\r\n      fixed = fixed.replace(/(\\$\\$?)$/, rightDots + '$1');\r\n    }\r\n\r\n    return fixed;\r\n  });\r\n}\r\n\r\n/**\r\n * Normalizes whitespace in LaTeX expressions\r\n * - Removes extra spaces around $ delimiters\r\n * - Normalizes multiple spaces to single space inside formulas\r\n *\r\n * @param text The input string containing LaTeX expressions\r\n * @returns The string with normalized whitespace\r\n */\r\nexport function normalizeLatexSpacing(text: string): string {\r\n  let result = text;\r\n\r\n  // Remove spaces inside $ delimiters (at the edges)\r\n  result = result.replaceAll(/\\$\\s+/g, '$');\r\n  result = result.replaceAll(/\\s+\\$/g, '$');\r\n  result = result.replaceAll(/\\$\\$\\s+/g, '$$');\r\n  result = result.replaceAll(/\\s+\\$\\$/g, '$$');\r\n\r\n  // Normalize multiple spaces inside formulas to single space\r\n  result = result.replaceAll(/(\\$\\$[\\s\\S]*?\\$\\$|\\$[\\s\\S]*?\\$)/g, (match) => {\r\n    return match.replaceAll(/\\s{2,}/g, ' ');\r\n  });\r\n\r\n  return result;\r\n}\r\n\r\n/**\r\n * Validates all LaTeX expressions in the text\r\n * Returns detailed information about validation results\r\n *\r\n * @param text The input string containing LaTeX expressions\r\n * @returns Validation results with errors if any\r\n */\r\nexport function validateLatexExpressions(text: string): {\r\n  errors: Array<{\r\n    formula: string;\r\n    message: string;\r\n    position: number;\r\n    type: 'display' | 'inline';\r\n  }>;\r\n  totalExpressions: number;\r\n  valid: boolean;\r\n} {\r\n  const errors: Array<{\r\n    formula: string;\r\n    message: string;\r\n    position: number;\r\n    type: 'display' | 'inline';\r\n  }> = [];\r\n\r\n  let totalExpressions = 0;\r\n  const pattern = /\\$\\$([\\s\\S]*?)\\$\\$|(?<!\\\\)\\$(?!\\$)([\\s\\S]*?)(?<!\\\\)\\$(?!\\$)/g;\r\n  let match;\r\n\r\n  while ((match = pattern.exec(text)) !== null) {\r\n    totalExpressions++;\r\n    const formula = match[1] || match[2];\r\n    const isDisplay = match[0].startsWith('$$');\r\n\r\n    try {\r\n      renderToString(formula, {\r\n        displayMode: isDisplay,\r\n        strict: 'warn',\r\n        throwOnError: true,\r\n        trust: false,\r\n      });\r\n    } catch (error) {\r\n      errors.push({\r\n        formula: formula.slice(0, 50) + (formula.length > 50 ? '...' : ''),\r\n        message: error instanceof Error ? error.message : String(error),\r\n        position: match.index,\r\n        type: isDisplay ? 'display' : 'inline',\r\n      });\r\n    }\r\n  }\r\n\r\n  return {\r\n    errors,\r\n    totalExpressions,\r\n    valid: errors.length === 0,\r\n  };\r\n}\r\n\r\n/**\r\n * Handles CJK (Chinese, Japanese, Korean) characters mixed with LaTeX\r\n * Optionally adds spaces between CJK characters and LaTeX expressions for better rendering\r\n *\r\n * @param text The input string\r\n * @param addSpaces Whether to add spaces between CJK and LaTeX (default: false)\r\n * @returns The processed string\r\n */\r\nexport function handleCJKWithLatex(text: string, addSpaces = false): string {\r\n  if (!addSpaces) return text;\r\n\r\n  let result = text;\r\n\r\n  // Add space between CJK character and opening $\r\n  result = result.replaceAll(/([\\u3040-\\u30FF\\u4E00-\\u9FA5])(\\$)/g, '$1 $2');\r\n\r\n  // Add space between closing $ and CJK character\r\n  result = result.replaceAll(/(\\$)([\\u3040-\\u30FF\\u4E00-\\u9FA5])/g, '$1 $2');\r\n\r\n  return result;\r\n}\r\n\r\n// ============================================================================\r\n// Advanced Preprocessing Options\r\n// ============================================================================\r\n\r\nexport interface AdvancedPreprocessOptions {\r\n  /** Add spaces between CJK and LaTeX (default: false, requires handleCJK: true) */\r\n  addCJKSpaces?: boolean;\r\n  /** Convert bracket notation \\[...\\] to $$...$$ (default: true) */\r\n  convertBrackets?: boolean;\r\n  /** Enable currency escaping (default: true) */\r\n  escapeCurrency?: boolean;\r\n  /** Escape mhchem commands (default: true) */\r\n  escapeMhchem?: boolean;\r\n  /** Escape pipe symbols in LaTeX (default: true) */\r\n  escapePipes?: boolean;\r\n  /** Escape underscores in \\text{} (default: true) */\r\n  escapeUnderscores?: boolean;\r\n  /** Automatically fix common LaTeX errors (default: false) */\r\n  fixErrors?: boolean;\r\n  /** Handle CJK characters (default: false) */\r\n  handleCJK?: boolean;\r\n  /** Normalize whitespace (default: false) */\r\n  normalizeSpacing?: boolean;\r\n  /** Throw error on validation failure (default: false, requires validate: true) */\r\n  throwOnValidationError?: boolean;\r\n  /** Validate LaTeX syntax (default: false) */\r\n  validate?: boolean;\r\n}\r\n\r\n/**\r\n * Comprehensive LaTeX preprocessing with configurable options\r\n *\r\n * This is the main preprocessing function that handles:\r\n * - Currency symbol escaping (e.g., $20 → \\$20)\r\n * - LaTeX delimiter conversion (\\[...\\] → $$...$$)\r\n * - Special character escaping (pipes, underscores, mhchem)\r\n * - Optional error fixing and validation\r\n * - Optional CJK character handling\r\n *\r\n * @param text The input string containing LaTeX and Markdown\r\n * @param options Configuration options for fine-grained control\r\n * @returns The preprocessed string\r\n *\r\n * @example\r\n * ```ts\r\n * // Default behavior (same as old preprocessLaTeX)\r\n * preprocessLaTeX('向量$90^\\\\circ$，非 $0^\\\\circ$ 和 $180^\\\\circ$')\r\n *\r\n * // With custom options\r\n * preprocessLaTeX(text, {\r\n *   fixErrors: true,\r\n *   validate: true,\r\n *   handleCJK: true\r\n * })\r\n * ```\r\n */\r\nexport function preprocessLaTeX(text: string, options: AdvancedPreprocessOptions = {}): string {\r\n  const {\r\n    addCJKSpaces = false,\r\n    convertBrackets = true,\r\n    escapeCurrency = true,\r\n    escapeMhchem = true,\r\n    escapePipes = true,\r\n    escapeUnderscores = true,\r\n    fixErrors = false,\r\n    handleCJK = false,\r\n    normalizeSpacing = false,\r\n    throwOnValidationError = false,\r\n    validate = false,\r\n  } = options;\r\n\r\n  let content = text;\r\n\r\n  // Phase 1: Currency escaping (if enabled)\r\n  if (escapeCurrency) {\r\n    content = escapeCurrencyDollars(content);\r\n  }\r\n\r\n  // Phase 2: Bracket conversion (if enabled)\r\n  if (convertBrackets) {\r\n    content = convertLatexDelimiters(content);\r\n  }\r\n\r\n  // Phase 3: LaTeX-specific escaping\r\n  if (escapeMhchem) {\r\n    content = escapeMhchemCommands(content);\r\n  }\r\n\r\n  if (escapePipes) {\r\n    content = escapeLatexPipes(content);\r\n  }\r\n\r\n  if (escapeUnderscores) {\r\n    content = escapeTextUnderscores(content);\r\n  }\r\n\r\n  // Phase 4: Error fixing (if enabled)\r\n  if (fixErrors) {\r\n    content = fixCommonLaTeXErrors(content);\r\n  }\r\n\r\n  // Phase 5: Whitespace normalization (if enabled)\r\n  if (normalizeSpacing) {\r\n    content = normalizeLatexSpacing(content);\r\n  }\r\n\r\n  // Phase 6: CJK handling (if enabled)\r\n  if (handleCJK) {\r\n    content = handleCJKWithLatex(content, addCJKSpaces);\r\n  }\r\n\r\n  // Phase 7: Validation (if enabled)\r\n  if (validate) {\r\n    const validation = validateLatexExpressions(content);\r\n    if (!validation.valid) {\r\n      const errorMessage = `LaTeX validation failed (${validation.errors.length}/${validation.totalExpressions} expressions have errors):\\n${validation.errors.map((e) => `  - [${e.type}] at position ${e.position}: ${e.message}\\n    Formula: ${e.formula}`).join('\\n')}`;\r\n\r\n      if (throwOnValidationError) {\r\n        throw new Error(errorMessage);\r\n      } else {\r\n        console.warn(errorMessage);\r\n      }\r\n    }\r\n  }\r\n\r\n  return content;\r\n}\r\n\r\n/**\r\n * Strict preprocessing mode - enables all safety features and validations\r\n * Use this when you want maximum correctness and are willing to accept the performance cost\r\n *\r\n * @param text The input string\r\n * @returns The preprocessed string with all features enabled\r\n *\r\n * @example\r\n * ```ts\r\n * const processed = preprocessLaTeXStrict(userInput)\r\n * // Enables: error fixing, validation, CJK handling, space normalization\r\n * ```\r\n */\r\nexport function preprocessLaTeXStrict(text: string): string {\r\n  return preprocessLaTeX(text, {\r\n    addCJKSpaces: false, // Usually don't want extra spaces\r\n    convertBrackets: true,\r\n    escapeCurrency: true,\r\n    escapeMhchem: true,\r\n    escapePipes: true,\r\n    escapeUnderscores: true,\r\n    fixErrors: true,\r\n    handleCJK: true,\r\n    normalizeSpacing: true,\r\n    throwOnValidationError: false, // Warn but don't throw\r\n    validate: true,\r\n  });\r\n}\r\n\r\n/**\r\n * Minimal preprocessing mode - only essential operations\r\n * Use this for better performance when you control the input\r\n *\r\n * @param text The input string\r\n * @returns The preprocessed string with minimal processing\r\n *\r\n * @example\r\n * ```ts\r\n * const processed = preprocessLaTeXMinimal(trustedInput)\r\n * // Only escapes currency and converts brackets\r\n * ```\r\n */\r\nexport function preprocessLaTeXMinimal(text: string): string {\r\n  return preprocessLaTeX(text, {\r\n    convertBrackets: true,\r\n    escapeCurrency: true,\r\n    escapeMhchem: false,\r\n    escapePipes: false,\r\n    escapeUnderscores: false,\r\n    fixErrors: false,\r\n    handleCJK: false,\r\n    normalizeSpacing: false,\r\n    validate: false,\r\n  });\r\n}\r\n"],"mappings":"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"}