katex 0.10.1 → 0.12.0

package/contrib/render-a11y-string/test/render-a11y-string-spec.js

@@ -0,0 +1,526 @@
+/* eslint-disable max-len */
+// @flow
+import renderA11yString from "../render-a11y-string";
+
+describe("renderA11yString", () => {
+    describe("basic expressions", () => {
+        test("simple addition", () => {
+            const result = renderA11yString("1 + 2");
+            expect(result).toMatchInlineSnapshot(`"1, plus, 2"`);
+        });
+    });
+
+    describe("accent", () => {
+        test("\\vec", () => {
+            const result = renderA11yString("\\vec{a}");
+            expect(result).toMatchInlineSnapshot(`"a, with, vector, on top"`);
+        });
+
+        test("\\acute{a}", () => {
+            const result = renderA11yString("\\acute{a}");
+            expect(result).toMatchInlineSnapshot(`"a, with, acute, on top"`);
+        });
+
+        test("\\hat{a}", () => {
+            const result = renderA11yString("\\hat{a}");
+            expect(result).toMatchInlineSnapshot(`"a, with, hat, on top"`);
+        });
+    });
+
+    describe("accentUnder", () => {
+        test("\\underleftarrow", () => {
+            const result = renderA11yString("\\underleftarrow{1+2}");
+            expect(result).toMatchInlineSnapshot(
+                `"1, plus, 2, with, left arrow, underneath"`,
+            );
+        });
+
+        test("\\underlinesegment", () => {
+            const result = renderA11yString("\\underlinesegment{1+2}");
+            expect(result).toMatchInlineSnapshot(
+                `"1, plus, 2, with, line segment, underneath"`,
+            );
+        });
+    });
+
+    describe("atom", () => {
+        test("punct", () => {
+            const result = renderA11yString("1, 2, 3");
+            expect(result).toMatchInlineSnapshot(`"1, comma, 2, comma, 3"`);
+        });
+    });
+
+    describe("color", () => {
+        test("\\color{red}", () => {
+            const result = renderA11yString("\\color{red}1+2");
+            expect(result).toMatchInlineSnapshot(
+                `"start color red, 1, plus, 2, end color red"`,
+            );
+        });
+
+        test("\\color{FF0000}", () => {
+            const result = renderA11yString("\\color{FF0000}1+2");
+            expect(result).toMatchInlineSnapshot(
+                `"start color #FF0000, 1, plus, 2, end color #FF0000"`,
+            );
+        });
+
+        // colorIsTextColor is an option added in KaTeX 0.9.0 for backward
+        // compatibility. It makes \color parse like \textcolor. We use it
+        // in the KA webapp, and need it here because the tests are written
+        // assuming it is set.
+        test("\\color{red} with {colorIsTextColor: true}", () => {
+            const result = renderA11yString("\\color{red}1+2", {
+                colorIsTextColor: true,
+            });
+            expect(result).toMatchInlineSnapshot(
+                `"start color red, 1, end color red, plus, 2"`,
+            );
+        });
+
+        test("\\textcolor{red}", () => {
+            const result = renderA11yString("\\textcolor{red}1+2");
+            expect(result).toMatchInlineSnapshot(
+                `"start color red, 1, end color red, plus, 2"`,
+            );
+        });
+    });
+
+    describe("delimiters", () => {
+        test("simple parens", () => {
+            const result = renderA11yString("(1 + 3)");
+            expect(result).toMatchInlineSnapshot(
+                `"left parenthesis, 1, plus, 3, right parenthesis"`,
+            );
+        });
+
+        test("simple brackets", () => {
+            const result = renderA11yString("[1 + 3]");
+            expect(result).toMatchInlineSnapshot(
+                `"open bracket, 1, plus, 3, close bracket"`,
+            );
+        });
+
+        test("nested parens", () => {
+            const result = renderA11yString("(a + (b + c))");
+            expect(result).toMatchInlineSnapshot(
+                `"left parenthesis, a, plus, left parenthesis, b, plus, c, right parenthesis, right parenthesis"`,
+            );
+        });
+
+        test("stretchy parens around fractions", () => {
+            const result = renderA11yString("\\left(\\frac{1}{x}\\right)");
+            expect(result).toMatchInlineSnapshot(
+                `"left parenthesis, start fraction, 1, divided by, x, end fraction, right parenthesis"`,
+            );
+        });
+    });
+
+    describe("delimsizing", () => {
+        test("\\bigl(1+2\\bigr)", () => {
+            const result = renderA11yString("\\bigl(1+2\\bigr)");
+            expect(result).toMatchInlineSnapshot(
+                `"left parenthesis, 1, plus, 2, right parenthesis"`,
+            );
+        });
+    });
+
+    describe("enclose", () => {
+        test("\\cancel", () => {
+            const result = renderA11yString("\\cancel{a}");
+            expect(result).toMatchInlineSnapshot(
+                `"start cancel, a, end cancel"`,
+            );
+        });
+
+        test("\\fbox", () => {
+            const result = renderA11yString("\\fbox{a}");
+            expect(result).toMatchInlineSnapshot(`"start box, a, end box"`);
+        });
+
+        test("\\boxed", () => {
+            const result = renderA11yString("\\boxed{a}");
+            expect(result).toMatchInlineSnapshot(`"start box, a, end box"`);
+        });
+
+        test("\\sout", () => {
+            const result = renderA11yString("\\sout{a}");
+            expect(result).toMatchInlineSnapshot(
+                `"start strikeout, a, end strikeout"`,
+            );
+        });
+    });
+
+    describe("exponents", () => {
+        test("simple exponent", () => {
+            const result = renderA11yString("e^x");
+            expect(result).toMatchInlineSnapshot(
+                `"e, start superscript, x, end superscript"`,
+            );
+        });
+
+        test("^{\\circ} => degrees", () => {
+            const result = renderA11yString("90^{\\circ}");
+            expect(result).toMatchInlineSnapshot(`"90, degrees"`);
+        });
+
+        test("^{\\degree} => degrees", () => {
+            const result = renderA11yString("90^{\\degree}");
+            expect(result).toMatchInlineSnapshot(`"90, degrees"`);
+        });
+
+        test("^{\\prime} => prime", () => {
+            const result = renderA11yString("f^{\\prime}");
+            expect(result).toMatchInlineSnapshot(`"f, prime"`);
+        });
+
+        test("^2 => squared", () => {
+            const result = renderA11yString("x^2");
+            expect(result).toMatchInlineSnapshot(`"x, squared"`);
+        });
+
+        test("^3 => cubed", () => {
+            const result = renderA11yString("x^3");
+            expect(result).toMatchInlineSnapshot(`"x, cubed"`);
+        });
+
+        test("log_2", () => {
+            const result = renderA11yString("\\log_2{x+1}");
+            expect(result).toMatchInlineSnapshot(
+                `"log, start base, 2, end base, x, plus, 1"`,
+            );
+        });
+
+        test("a_{n+1}", () => {
+            const result = renderA11yString("a_{n+1}");
+            expect(result).toMatchInlineSnapshot(
+                `"a, start subscript, n, plus, 1, end subscript"`,
+            );
+        });
+    });
+
+    describe("genfrac", () => {
+        test("simple fractions", () => {
+            const result = renderA11yString("\\frac{2}{3}");
+            expect(result).toMatchInlineSnapshot(
+                `"start fraction, 2, divided by, 3, end fraction"`,
+            );
+        });
+
+        test("nested fractions", () => {
+            const result = renderA11yString("\\frac{1}{1+\\frac{1}{x}}");
+            // TODO: this result is ambiguous, we need to fix this
+            expect(result).toMatchInlineSnapshot(
+                `"start fraction, 1, divided by, 1, plus, start fraction, 1, divided by, x, end fraction, end fraction"`,
+            );
+        });
+
+        test("binomials", () => {
+            const result = renderA11yString("\\binom{n}{k}");
+            // TODO: drop the parenthesis as they're not normally read
+            expect(result).toMatchInlineSnapshot(
+                `"start binomial, left parenthesis, n, over, k, right parenthesis, end binomial"`,
+            );
+        });
+    });
+
+    describe("horizBrace", () => {
+        test("\\overbrace", () => {
+            const result = renderA11yString("\\overbrace{1+2}");
+            expect(result).toMatchInlineSnapshot(
+                `"start overbrace, 1, plus, 2, end overbrace"`,
+            );
+        });
+
+        test("\\underbrace", () => {
+            const result = renderA11yString("\\underbrace{1+2}");
+            expect(result).toMatchInlineSnapshot(
+                `"start underbrace, 1, plus, 2, end underbrace"`,
+            );
+        });
+    });
+
+    describe("infix", () => {
+        test("\\over", () => {
+            const result = renderA11yString("a \\over b");
+            expect(result).toMatchInlineSnapshot(
+                `"start fraction, a, divided by, b, end fraction"`,
+            );
+        });
+
+        test("\\choose", () => {
+            const result = renderA11yString("a \\choose b");
+            expect(result).toMatchInlineSnapshot(
+                `"start binomial, left parenthesis, a, over, b, right parenthesis, end binomial"`,
+            );
+        });
+
+        test("\\above", () => {
+            const result = renderA11yString("a \\above{2pt} b");
+            expect(result).toMatchInlineSnapshot(
+                `"start fraction, a, divided by, b, end fraction"`,
+            );
+        });
+    });
+
+    describe("inner", () => {
+        test("\\ldots", () => {
+            const result = renderA11yString("\\ldots");
+            expect(result).toMatchInlineSnapshot(`"dots"`);
+        });
+    });
+
+    describe("lap", () => {
+        test("\\llap", () => {
+            const result = renderA11yString("a\\llap{b}");
+            expect(result).toMatchInlineSnapshot(
+                `"a, start text, b, end text"`,
+            );
+        });
+
+        test("\\rlap", () => {
+            const result = renderA11yString("a\\rlap{b}");
+            expect(result).toMatchInlineSnapshot(
+                `"a, start text, b, end text"`,
+            );
+        });
+    });
+
+    describe("middle", () => {
+        test("\\middle", () => {
+            const result = renderA11yString("\\left(a\\middle|b\\right)");
+            expect(result).toMatchInlineSnapshot(
+                `"left parenthesis, a, vertical bar, b, right parenthesis"`,
+            );
+        });
+    });
+
+    describe("mod", () => {
+        test("\\mod", () => {
+            const result = renderA11yString("\\mod{23}");
+            // TODO: drop the "space"
+            // TODO: collate m, o, d... we should fix this inside of KaTeX since
+            // this affects the HTML and MathML output as well
+            expect(result).toMatchInlineSnapshot(`"space, m, o, d, 23"`);
+        });
+    });
+
+    describe("op", () => {
+        test("\\lim", () => {
+            const result = renderA11yString("\\lim{x+1}");
+            // TODO: add begin/end to track argument of operators
+            expect(result).toMatchInlineSnapshot(`"limit, x, plus, 1"`);
+        });
+
+        test("\\sin 2\\pi", () => {
+            const result = renderA11yString("\\sin{2\\pi}");
+            // TODO: add begin/end to track argument of operators
+            expect(result).toMatchInlineSnapshot(`"sine, 2, pi"`);
+        });
+
+        test("\\sum_{i=0}", () => {
+            const result = renderA11yString("\\sum_{i=0}");
+            expect(result).toMatchInlineSnapshot(
+                `"sum, start subscript, i, equals, 0, end subscript"`,
+            );
+        });
+
+        test("\u2211_{i=0}", () => {
+            const result = renderA11yString("\u2211_{i=0}");
+            expect(result).toMatchInlineSnapshot(
+                `"sum, start subscript, i, equals, 0, end subscript"`,
+            );
+        });
+    });
+
+    describe("operatorname", () => {
+        test("\\limsup", () => {
+            const result = renderA11yString("\\limsup");
+            // TODO: collate strings so that this is "lim, sup"
+            // NOTE: this also affect HTML and MathML output
+            expect(result).toMatchInlineSnapshot(`"l, i, m, s, u, p"`);
+        });
+
+        test("\\liminf", () => {
+            const result = renderA11yString("\\liminf");
+            expect(result).toMatchInlineSnapshot(`"l, i, m, i, n, f"`);
+        });
+
+        test("\\argmin", () => {
+            const result = renderA11yString("\\argmin");
+            expect(result).toMatchInlineSnapshot(`"a, r, g, m, i, n"`);
+        });
+    });
+
+    describe("overline", () => {
+        test("\\overline", () => {
+            const result = renderA11yString("\\overline{1+2}");
+            expect(result).toMatchInlineSnapshot(
+                `"start overline, 1, plus, 2, end overline"`,
+            );
+        });
+    });
+
+    describe("phantom", () => {
+        test("\\phantom", () => {
+            const result = renderA11yString("1+\\phantom{2}");
+            expect(result).toMatchInlineSnapshot(`"1, plus, empty space"`);
+        });
+    });
+
+    describe("raisebox", () => {
+        test("\\raisebox", () => {
+            const result = renderA11yString("x+\\raisebox{1em}{y}");
+            expect(result).toMatchInlineSnapshot(`"x, plus, y"`);
+        });
+    });
+
+    describe("relations", () => {
+        test("1 \\neq 2", () => {
+            const result = renderA11yString("1 \\neq 2");
+            expect(result).toMatchInlineSnapshot(`"1, does not equal, 2"`);
+        });
+
+        test("1 \\ne 2", () => {
+            const result = renderA11yString("1 \\ne 2");
+            expect(result).toMatchInlineSnapshot(`"1, does not equal, 2"`);
+        });
+
+        test("1 \\geq 2", () => {
+            const result = renderA11yString("1 \\geq 2");
+            expect(result).toMatchInlineSnapshot(
+                `"1, is greater than or equal to, 2"`,
+            );
+        });
+
+        test("1 \\ge 2", () => {
+            const result = renderA11yString("1 \\ge 2");
+            expect(result).toMatchInlineSnapshot(
+                `"1, is greater than or equal to, 2"`,
+            );
+        });
+
+        test("1 \\leq 2", () => {
+            const result = renderA11yString("1 \\leq 3");
+            expect(result).toMatchInlineSnapshot(
+                `"1, is less than or equal to, 3"`,
+            );
+        });
+
+        test("1 \\le 2", () => {
+            const result = renderA11yString("1 \\le 3");
+            expect(result).toMatchInlineSnapshot(
+                `"1, is less than or equal to, 3"`,
+            );
+        });
+    });
+
+    describe("rule", () => {
+        test("\\rule", () => {
+            const result = renderA11yString("\\rule{1em}{1em}");
+            expect(result).toMatchInlineSnapshot(`"rectangle"`);
+        });
+    });
+
+    describe("smash", () => {
+        test("1 + \\smash{2}", () => {
+            const result = renderA11yString("1 + \\smash{2}");
+            expect(result).toMatchInlineSnapshot(`"1, plus, 2"`);
+        });
+    });
+
+    describe("sqrt", () => {
+        test("square root", () => {
+            const result = renderA11yString("\\sqrt{x + 1}");
+            expect(result).toMatchInlineSnapshot(
+                `"square root of, x, plus, 1, end square root"`,
+            );
+        });
+
+        test("nest square root", () => {
+            const result = renderA11yString("\\sqrt{x + \\sqrt{y}}");
+            // TODO: this sounds ambiguous as well... we should probably say "start square root"
+            expect(result).toMatchInlineSnapshot(
+                `"square root of, x, plus, square root of, y, end square root, end square root"`,
+            );
+        });
+
+        test("cube root", () => {
+            const result = renderA11yString("\\sqrt[3]{x + 1}");
+            expect(result).toMatchInlineSnapshot(
+                `"cube root of, x, plus, 1, end cube root"`,
+            );
+        });
+
+        test("nth root", () => {
+            const result = renderA11yString("\\sqrt[n]{x + 1}");
+            expect(result).toMatchInlineSnapshot(
+                `"root, start index, n, end index"`,
+            );
+        });
+    });
+
+    describe("sizing", () => {
+        test("\\Huge is ignored", () => {
+            const result = renderA11yString("\\Huge{a+b}");
+            expect(result).toMatchInlineSnapshot(`"a, plus, b"`);
+        });
+
+        test("\\small is ignored", () => {
+            const result = renderA11yString("\\small{a+b}");
+            expect(result).toMatchInlineSnapshot(`"a, plus, b"`);
+        });
+
+        // We don't need to test all sizing commands since all style
+        // nodes are treated in the same way.
+    });
+
+    describe("styling", () => {
+        test("\\displaystyle is ignored", () => {
+            const result = renderA11yString("\\displaystyle{a+b}");
+            expect(result).toMatchInlineSnapshot(`"a, plus, b"`);
+        });
+
+        test("\\textstyle is ignored", () => {
+            const result = renderA11yString("\\textstyle{a+b}");
+            expect(result).toMatchInlineSnapshot(`"a, plus, b"`);
+        });
+
+        // We don't need to test all styling commands since all style
+        // nodes are treated in the same way.
+    });
+
+    describe("text", () => {
+        test("\\text", () => {
+            const result = renderA11yString("\\text{hello}");
+            expect(result).toMatchInlineSnapshot(
+                `"start text, h, e, l, l, o, end text"`,
+            );
+        });
+
+        test("\\textbf", () => {
+            const result = renderA11yString("\\textbf{hello}");
+            expect(result).toMatchInlineSnapshot(
+                `"start bold text, h, e, l, l, o, end bold text"`,
+            );
+        });
+    });
+
+    describe("underline", () => {
+        test("\\underline", () => {
+            const result = renderA11yString("\\underline{1+2}");
+            expect(result).toMatchInlineSnapshot(
+                `"start underline, 1, plus, 2, end underline"`,
+            );
+        });
+    });
+
+    describe("verb", () => {
+        test("\\verb", () => {
+            const result = renderA11yString("\\verb|hello|");
+            expect(result).toMatchInlineSnapshot(
+                `"start verbatim, hello, end verbatim"`,
+            );
+        });
+    });
+});

package/dist/README.md

@@ -3,9 +3,9 @@
 [![CircleCI](https://circleci.com/gh/KaTeX/KaTeX.svg?style=shield)](https://circleci.com/gh/KaTeX/KaTeX)
 [![codecov](https://codecov.io/gh/KaTeX/KaTeX/branch/master/graph/badge.svg)](https://codecov.io/gh/KaTeX/KaTeX)
 [![Join the chat at https://gitter.im/KaTeX/KaTeX](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/KaTeX/KaTeX?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
-[![Greenkeeper badge](https://badges.greenkeeper.io/KaTeX/KaTeX.svg)](https://greenkeeper.io/)
+[![Dependabot Status](https://api.dependabot.com/badges/status?host=github&repo=KaTeX/KaTeX)](https://dependabot.com)
 [![jsDelivr](https://data.jsdelivr.com/v1/package/npm/katex/badge?style=rounded)](https://www.jsdelivr.com/package/npm/katex)
-![](https://img.badgesize.io/KaTeX/KaTeX/v0.10.1/dist/katex.min.js?compression=gzip)
+![](https://img.badgesize.io/KaTeX/KaTeX/v0.12.0/dist/katex.min.js?compression=gzip)
 
 KaTeX is a fast, easy-to-use JavaScript library for TeX math rendering on the web.
 
@@ -14,7 +14,7 @@ KaTeX is a fast, easy-to-use JavaScript library for TeX math rendering on the we
  * **Self contained:** KaTeX has no dependencies and can easily be bundled with your website resources.
  * **Server side rendering:** KaTeX produces the same output regardless of browser or environment, so you can pre-render expressions using Node.js and send them as plain HTML.
 
-KaTeX is compatible with all major browsers, including Chrome, Safari, Firefox, Opera, Edge, and IE 9–11.
+KaTeX is compatible with all major browsers, including Chrome, Safari, Firefox, Opera, Edge, and IE 11.
 
 KaTeX supports much (but not all) of LaTeX and many LaTeX packages. See the [list of supported functions](https://katex.org/docs/supported.html).
 
@@ -29,13 +29,13 @@ Try out KaTeX [on the demo page](https://katex.org/#demo)!
 <!-- KaTeX requires the use of the HTML5 doctype. Without it, KaTeX may not render properly -->
 <html>
   <head>
-    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.10.1/dist/katex.min.css" integrity="sha384-dbVIfZGuN1Yq7/1Ocstc1lUEm+AT+/rCkibIcC/OmWo5f0EA48Vf8CytHzGrSwbQ" crossorigin="anonymous">
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/katex.min.css" integrity="sha384-AfEj0r4/OFrOo5t7NnNe46zW/tFgW6x/bCJG8FqQCEo3+Aro6EYUG4+cU+KJWu/X" crossorigin="anonymous">
 
     <!-- The loading of KaTeX is deferred to speed up page rendering -->
-    <script defer src="https://cdn.jsdelivr.net/npm/katex@0.10.1/dist/katex.min.js" integrity="sha384-2BKqo+exmr9su6dir+qCw08N2ZKRucY4PrGQPPWU1A7FtlCGjmEGFqXCv5nyM5Ij" crossorigin="anonymous"></script>
+    <script defer src="https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/katex.min.js" integrity="sha384-g7c+Jr9ZivxKLnZTDUhnkOnsh30B4H0rpLUpJ4jAIKs4fnJI+sEnkvrMWph2EDg4" crossorigin="anonymous"></script>
 
     <!-- To automatically render math in text elements, include the auto-render extension: -->
-    <script defer src="https://cdn.jsdelivr.net/npm/katex@0.10.1/dist/contrib/auto-render.min.js" integrity="sha384-kWPLUVMOks5AQFrykwIup5lo0m3iMkkHrD0uJ4H5cjeGihAutqP0yW0J6dpFiVkI" crossorigin="anonymous"
+    <script defer src="https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/contrib/auto-render.min.js" integrity="sha384-mll67QQFJfxn0IYznZYonOWZ644AWYC+Pt2cHqMaRhXVrursRwvLnLaebdGIlYNa" crossorigin="anonymous"
         onload="renderMathInElement(document.body);"></script>
   </head>
   ...

package/dist/contrib/auto-render.js

@@ -229,6 +229,14 @@ var auto_render_splitWithDelimiters = function splitWithDelimiters(text, delimit
 
 var auto_render_renderMathInText = function renderMathInText(text, optionsCopy) {
   var data = auto_render_splitWithDelimiters(text, optionsCopy.delimiters);
+
+  if (data.length === 1 && data[0].type === 'text') {
+    // There is no formula in the text.
+    // Let's return null which means there is no need to replace
+    // the current text node with a new one.
+    return null;
+  }
+
   var fragment = document.createDocumentFragment();
 
   for (var i = 0; i < data.length; i++) {
@@ -271,8 +279,11 @@ var renderElem = function renderElem(elem, optionsCopy) {
     if (childNode.nodeType === 3) {
       // Text node
       var frag = auto_render_renderMathInText(childNode.textContent, optionsCopy);
-      i += frag.childNodes.length - 1;
-      elem.replaceChild(frag, childNode);
+
+      if (frag) {
+        i += frag.childNodes.length - 1;
+        elem.replaceChild(frag, childNode);
+      }
     } else if (childNode.nodeType === 1) {
       (function () {
         // Element node
@@ -323,7 +334,7 @@ var renderMathInElement = function renderMathInElement(elem, options) {
     right: "\\]",
     display: true
   }];
-  optionsCopy.ignoredTags = optionsCopy.ignoredTags || ["script", "noscript", "style", "textarea", "pre", "code"];
+  optionsCopy.ignoredTags = optionsCopy.ignoredTags || ["script", "noscript", "style", "textarea", "pre", "code", "option"];
   optionsCopy.ignoredClasses = optionsCopy.ignoredClasses || [];
   optionsCopy.errorCallback = optionsCopy.errorCallback || console.error; // Enable sharing of global macros defined via `\gdef` between different
   // math elements within a single call to `renderMathInElement`.

package/dist/contrib/auto-render.min.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t(require("katex")):"function"==typeof define&&define.amd?define(["katex"],t):"object"==typeof exports?exports.renderMathInElement=t(require("katex")):e.renderMathInElement=t(e.katex)}("undefined"!=typeof self?self:this,function(e){return function(e){var t={};function r(n){if(t[n])return t[n].exports;var o=t[n]={i:n,l:!1,exports:{}};return e[n].call(o.exports,o,o.exports,r),o.l=!0,o.exports}return r.m=e,r.c=t,r.d=function(e,t,n){r.o(e,t)||Object.defineProperty(e,t,{enumerable:!0,get:n})},r.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.t=function(e,t){if(1&t&&(e=r(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var n=Object.create(null);if(r.r(n),Object.defineProperty(n,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var o in e)r.d(n,o,function(t){return e[t]}.bind(null,o));return n},r.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return r.d(t,"a",t),t},r.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},r.p="",r(r.s=1)}([function(t,r){t.exports=e},function(e,t,r){"use strict";r.r(t);var n=r(0),o=r.n(n),a=function(e,t,r){for(var n=r,o=0,a=e.length;n<t.length;){var i=t[n];if(o<=0&&t.slice(n,n+a)===e)return n;"\\"===i?n++:"{"===i?o++:"}"===i&&o--,n++}return-1},i=function(e,t,r,n){for(var o=[],i=0;i<e.length;i++)if("text"===e[i].type){var l=e[i].data,d=!0,s=0,f=void 0;for(-1!==(f=l.indexOf(t))&&(s=f,o.push({type:"text",data:l.slice(0,s)}),d=!1);;){if(d){if(-1===(f=l.indexOf(t,s)))break;o.push({type:"text",data:l.slice(s,f)}),s=f}else{if(-1===(f=a(r,l,s+t.length)))break;o.push({type:"math",data:l.slice(s+t.length,f),rawData:l.slice(s,f+r.length),display:n}),s=f+r.length}d=!d}o.push({type:"text",data:l.slice(s)})}else o.push(e[i]);return o},l=function(e,t){for(var r=function(e,t){for(var r=[{type:"text",data:e}],n=0;n<t.length;n++){var o=t[n];r=i(r,o.left,o.right,o.display||!1)}return r}(e,t.delimiters),n=document.createDocumentFragment(),a=0;a<r.length;a++)if("text"===r[a].type)n.appendChild(document.createTextNode(r[a].data));else{var l=document.createElement("span"),d=r[a].data;t.displayMode=r[a].display;try{t.preProcess&&(d=t.preProcess(d)),o.a.render(d,l,t)}catch(e){if(!(e instanceof o.a.ParseError))throw e;t.errorCallback("KaTeX auto-render: Failed to parse `"+r[a].data+"` with ",e),n.appendChild(document.createTextNode(r[a].rawData));continue}n.appendChild(l)}return n};t.default=function(e,t){if(!e)throw new Error("No element provided to render");var r={};for(var n in t)t.hasOwnProperty(n)&&(r[n]=t[n]);r.delimiters=r.delimiters||[{left:"$$",right:"$$",display:!0},{left:"\\(",right:"\\)",display:!1},{left:"\\[",right:"\\]",display:!0}],r.ignoredTags=r.ignoredTags||["script","noscript","style","textarea","pre","code"],r.ignoredClasses=r.ignoredClasses||[],r.errorCallback=r.errorCallback||console.error,r.macros=r.macros||{},function e(t,r){for(var n=0;n<t.childNodes.length;n++){var o=t.childNodes[n];if(3===o.nodeType){var a=l(o.textContent,r);n+=a.childNodes.length-1,t.replaceChild(a,o)}else 1===o.nodeType&&function(){var t=" "+o.className+" ";-1===r.ignoredTags.indexOf(o.nodeName.toLowerCase())&&r.ignoredClasses.every(function(e){return-1===t.indexOf(" "+e+" ")})&&e(o,r)}()}}(e,r)}}]).default});
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t(require("katex")):"function"==typeof define&&define.amd?define(["katex"],t):"object"==typeof exports?exports.renderMathInElement=t(require("katex")):e.renderMathInElement=t(e.katex)}("undefined"!=typeof self?self:this,function(e){return function(e){var t={};function r(n){if(t[n])return t[n].exports;var o=t[n]={i:n,l:!1,exports:{}};return e[n].call(o.exports,o,o.exports,r),o.l=!0,o.exports}return r.m=e,r.c=t,r.d=function(e,t,n){r.o(e,t)||Object.defineProperty(e,t,{enumerable:!0,get:n})},r.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.t=function(e,t){if(1&t&&(e=r(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var n=Object.create(null);if(r.r(n),Object.defineProperty(n,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var o in e)r.d(n,o,function(t){return e[t]}.bind(null,o));return n},r.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return r.d(t,"a",t),t},r.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},r.p="",r(r.s=1)}([function(t,r){t.exports=e},function(e,t,r){"use strict";r.r(t);var n=r(0),o=r.n(n),a=function(e,t,r){for(var n=r,o=0,a=e.length;n<t.length;){var i=t[n];if(o<=0&&t.slice(n,n+a)===e)return n;"\\"===i?n++:"{"===i?o++:"}"===i&&o--,n++}return-1},i=function(e,t,r,n){for(var o=[],i=0;i<e.length;i++)if("text"===e[i].type){var l=e[i].data,d=!0,s=0,f=void 0;for(-1!==(f=l.indexOf(t))&&(s=f,o.push({type:"text",data:l.slice(0,s)}),d=!1);;){if(d){if(-1===(f=l.indexOf(t,s)))break;o.push({type:"text",data:l.slice(s,f)}),s=f}else{if(-1===(f=a(r,l,s+t.length)))break;o.push({type:"math",data:l.slice(s+t.length,f),rawData:l.slice(s,f+r.length),display:n}),s=f+r.length}d=!d}o.push({type:"text",data:l.slice(s)})}else o.push(e[i]);return o},l=function(e,t){var r=function(e,t){for(var r=[{type:"text",data:e}],n=0;n<t.length;n++){var o=t[n];r=i(r,o.left,o.right,o.display||!1)}return r}(e,t.delimiters);if(1===r.length&&"text"===r[0].type)return null;for(var n=document.createDocumentFragment(),a=0;a<r.length;a++)if("text"===r[a].type)n.appendChild(document.createTextNode(r[a].data));else{var l=document.createElement("span"),d=r[a].data;t.displayMode=r[a].display;try{t.preProcess&&(d=t.preProcess(d)),o.a.render(d,l,t)}catch(e){if(!(e instanceof o.a.ParseError))throw e;t.errorCallback("KaTeX auto-render: Failed to parse `"+r[a].data+"` with ",e),n.appendChild(document.createTextNode(r[a].rawData));continue}n.appendChild(l)}return n};t.default=function(e,t){if(!e)throw new Error("No element provided to render");var r={};for(var n in t)t.hasOwnProperty(n)&&(r[n]=t[n]);r.delimiters=r.delimiters||[{left:"$$",right:"$$",display:!0},{left:"\\(",right:"\\)",display:!1},{left:"\\[",right:"\\]",display:!0}],r.ignoredTags=r.ignoredTags||["script","noscript","style","textarea","pre","code","option"],r.ignoredClasses=r.ignoredClasses||[],r.errorCallback=r.errorCallback||console.error,r.macros=r.macros||{},function e(t,r){for(var n=0;n<t.childNodes.length;n++){var o=t.childNodes[n];if(3===o.nodeType){var a=l(o.textContent,r);a&&(n+=a.childNodes.length-1,t.replaceChild(a,o))}else 1===o.nodeType&&function(){var t=" "+o.className+" ";-1===r.ignoredTags.indexOf(o.nodeName.toLowerCase())&&r.ignoredClasses.every(function(e){return-1===t.indexOf(" "+e+" ")})&&e(o,r)}()}}(e,r)}}]).default});

package/dist/contrib/auto-render.mjs

@@ -113,6 +113,14 @@ const splitWithDelimiters = function splitWithDelimiters(text, delimiters) {
 
 const renderMathInText = function renderMathInText(text, optionsCopy) {
   const data = splitWithDelimiters(text, optionsCopy.delimiters);
+
+  if (data.length === 1 && data[0].type === 'text') {
+    // There is no formula in the text.
+    // Let's return null which means there is no need to replace
+    // the current text node with a new one.
+    return null;
+  }
+
   const fragment = document.createDocumentFragment();
 
   for (let i = 0; i < data.length; i++) {
@@ -155,8 +163,11 @@ const renderElem = function renderElem(elem, optionsCopy) {
     if (childNode.nodeType === 3) {
       // Text node
       const frag = renderMathInText(childNode.textContent, optionsCopy);
-      i += frag.childNodes.length - 1;
-      elem.replaceChild(frag, childNode);
+
+      if (frag) {
+        i += frag.childNodes.length - 1;
+        elem.replaceChild(frag, childNode);
+      }
     } else if (childNode.nodeType === 1) {
       // Element node
       const className = ' ' + childNode.className + ' ';
@@ -203,7 +214,7 @@ const renderMathInElement = function renderMathInElement(elem, options) {
     right: "\\]",
     display: true
   }];
-  optionsCopy.ignoredTags = optionsCopy.ignoredTags || ["script", "noscript", "style", "textarea", "pre", "code"];
+  optionsCopy.ignoredTags = optionsCopy.ignoredTags || ["script", "noscript", "style", "textarea", "pre", "code", "option"];
   optionsCopy.ignoredClasses = optionsCopy.ignoredClasses || [];
   optionsCopy.errorCallback = optionsCopy.errorCallback || console.error; // Enable sharing of global macros defined via `\gdef` between different
   // math elements within a single call to `renderMathInElement`.