- Add .prettierignore to exclude vendor packages, lock files, markdown, and YAML - Update .prettierrc: printWidth 100, singleQuote, trailingComma "all" - Run Prettier across all source files for consistent formatting - Fix unused imports (UserRequirements, setTTSProvider) - Fix eslint-disable comment placement after Prettier reformat Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
161 lines
4.9 KiB
TypeScript
161 lines
4.9 KiB
TypeScript
/**
|
|
* Interactive HTML Post-Processor
|
|
*
|
|
* Ported from Python's PostProcessor class (learn-your-way/concept_to_html.py:287-385)
|
|
*
|
|
* Handles:
|
|
* - LaTeX delimiter conversion ($$...$$ -> \[...\], $...$ -> \(...\))
|
|
* - KaTeX CSS/JS injection with auto-render and MutationObserver
|
|
* - Script tag protection during LaTeX conversion
|
|
*/
|
|
|
|
/**
|
|
* Main entry point: post-process generated interactive HTML
|
|
* Converts LaTeX delimiters and injects KaTeX rendering resources.
|
|
*/
|
|
export function postProcessInteractiveHtml(html: string): string {
|
|
// Convert LaTeX delimiters while protecting script tags
|
|
let processed = convertLatexDelimiters(html);
|
|
|
|
// Inject KaTeX resources if not already present
|
|
if (!processed.toLowerCase().includes('katex')) {
|
|
processed = injectKatex(processed);
|
|
}
|
|
|
|
return processed;
|
|
}
|
|
|
|
/**
|
|
* Convert LaTeX delimiters while protecting <script> tags.
|
|
*
|
|
* - Protects script blocks from modification
|
|
* - Converts $$...$$ to \[...\] (display math)
|
|
* - Converts $...$ to \(...\) (inline math)
|
|
* - Restores script blocks after conversion
|
|
*/
|
|
function convertLatexDelimiters(html: string): string {
|
|
const scriptBlocks: string[] = [];
|
|
|
|
// Protect script tags by replacing them with placeholders
|
|
let processed = html.replace(/<script[^>]*>[\s\S]*?<\/script>/gi, (match) => {
|
|
scriptBlocks.push(match);
|
|
return `__SCRIPT_BLOCK_${scriptBlocks.length - 1}__`;
|
|
});
|
|
|
|
// Convert display math: $$...$$ -> \[...\]
|
|
processed = processed.replace(/\$\$([^$]+)\$\$/g, '\\[$1\\]');
|
|
|
|
// Convert inline math: $...$ -> \(...\)
|
|
// Use non-greedy match and exclude newlines to avoid false positives
|
|
processed = processed.replace(/\$([^$\n]+?)\$/g, '\\($1\\)');
|
|
|
|
// Restore script blocks using indexOf + substring (not .replace())
|
|
// because script content may contain $ characters that .replace()
|
|
// would interpret as special substitution patterns.
|
|
for (let i = 0; i < scriptBlocks.length; i++) {
|
|
const placeholder = `__SCRIPT_BLOCK_${i}__`;
|
|
const idx = processed.indexOf(placeholder);
|
|
if (idx !== -1) {
|
|
processed =
|
|
processed.substring(0, idx) +
|
|
scriptBlocks[i] +
|
|
processed.substring(idx + placeholder.length);
|
|
}
|
|
}
|
|
|
|
return processed;
|
|
}
|
|
|
|
/**
|
|
* Inject KaTeX CSS, JS, auto-render, and MutationObserver before </head>.
|
|
* Falls back to appending at end if </head> is not found.
|
|
*/
|
|
function injectKatex(html: string): string {
|
|
const katexInjection = `
|
|
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/katex.min.css">
|
|
<script src="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/katex.min.js"></script>
|
|
<script src="https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/contrib/auto-render.min.js"></script>
|
|
<script>
|
|
document.addEventListener("DOMContentLoaded", function() {
|
|
const katexOptions = {
|
|
delimiters: [
|
|
{left: '\\\\[', right: '\\\\]', display: true},
|
|
{left: '\\\\(', right: '\\\\)', display: false},
|
|
{left: '$$', right: '$$', display: true},
|
|
{left: '$', right: '$', display: false}
|
|
],
|
|
throwOnError: false,
|
|
strict: false,
|
|
trust: true
|
|
};
|
|
|
|
let renderTimeout;
|
|
function safeRender() {
|
|
if (renderTimeout) clearTimeout(renderTimeout);
|
|
renderTimeout = setTimeout(() => {
|
|
renderMathInElement(document.body, katexOptions);
|
|
}, 100);
|
|
}
|
|
|
|
renderMathInElement(document.body, katexOptions);
|
|
|
|
const observer = new MutationObserver((mutations) => {
|
|
let shouldRender = false;
|
|
mutations.forEach((mutation) => {
|
|
if (mutation.target &&
|
|
mutation.target.className &&
|
|
typeof mutation.target.className === 'string' &&
|
|
mutation.target.className.includes('katex')) {
|
|
return;
|
|
}
|
|
shouldRender = true;
|
|
});
|
|
|
|
if (shouldRender) {
|
|
safeRender();
|
|
}
|
|
});
|
|
|
|
observer.observe(document.body, {
|
|
childList: true,
|
|
subtree: true,
|
|
characterData: true
|
|
});
|
|
|
|
setInterval(() => {
|
|
const text = document.body.innerText;
|
|
if (text.includes('\\\\(') || text.includes('$$')) {
|
|
safeRender();
|
|
}
|
|
}, 2000);
|
|
});
|
|
</script>`;
|
|
|
|
// Use indexOf + substring instead of String.replace() because the
|
|
// katexInjection string contains '$' characters that .replace() would
|
|
// interpret as special substitution patterns ($$ → $, $' → post-match text).
|
|
const headCloseIdx = html.indexOf('</head>');
|
|
if (headCloseIdx !== -1) {
|
|
return (
|
|
html.substring(0, headCloseIdx) +
|
|
katexInjection +
|
|
'\n</head>' +
|
|
html.substring(headCloseIdx + 7)
|
|
);
|
|
}
|
|
|
|
// Fallback: inject before </body> if </head> is missing
|
|
const bodyCloseIdx = html.indexOf('</body>');
|
|
if (bodyCloseIdx !== -1) {
|
|
return (
|
|
html.substring(0, bodyCloseIdx) +
|
|
katexInjection +
|
|
'\n</body>' +
|
|
html.substring(bodyCloseIdx + 7)
|
|
);
|
|
}
|
|
|
|
// Last resort: append at end
|
|
return html + katexInjection;
|
|
}
|