katex 0.10.0-rc → 0.10.2

package/contrib/mhchem/mhchem.patch

@@ -0,0 +1,235 @@
+0a1
+> /* eslint-disable */
+5a7,22
+>  *  KaTeX mhchem.js
+>  *
+>  *  This file implements a KaTeX version of mhchem version 3.3.0.
+>  *  It is adapted from MathJax/extensions/TeX/mhchem.js
+>  *  It differs from the MathJax version as follows:
+>  *    1. The interface is changed so that it can be called from KaTeX, not MathJax.
+>  *    2. \rlap and \llap are replaced with \mathrlap and \mathllap.
+>  *    3. Four lines of code are edited in order to use \raisebox instead of \raise.
+>  *    4. The reaction arrow code is simplified. All reaction arrows are rendered
+>  *       using KaTeX extensible arrows instead of building non-extensible arrows.
+>  *    5. \tripledash vertical alignment is slightly adjusted.
+>  *
+>  *    This code, as other KaTeX code, is released under the MIT license.
+>  * 
+>  * /*************************************************************
+>  *
+33a51
+> // version: "3.3.0" for MathJax and KaTeX
+35,37d52
+< MathJax.Extension["TeX/mhchem"] = {
+<   version: "3.3.0"
+< };
+39c54
+< MathJax.Hub.Register.StartupHook("TeX Jax Ready", function () {
+---
+> // Add \ce, \pu, and \tripledash to the KaTeX macros.
+41c56,58
+<   var TEX = MathJax.InputJax.TeX;
+---
+> katex.__defineMacro("\\ce", function(context) {
+>   return chemParse(context.consumeArgs(1)[0], "ce")
+> });
+43,47c60,62
+<   //
+<   //  This is the main class for handing the \ce and related commands.
+<   //  Its main method is Parse() which takes the argument to \ce and
+<   //  returns the corresponding TeX string.
+<   //
+---
+> katex.__defineMacro("\\pu", function(context) {
+>   return chemParse(context.consumeArgs(1)[0], "pu");
+> });
+49,50c64,68
+<   var CE = MathJax.Object.Subclass({
+<     string: "",   // the \ce string being parsed
+---
+> //  Needed for \bond for the ~ forms
+> //  Raise by 2.56mu, not 2mu. We're raising a hyphen-minus, U+002D, not 
+> //  a mathematical minus, U+2212. So we need that extra 0.56.
+> katex.__defineMacro("\\tripledash", "{\\vphantom{-}\\raisebox{2.56mu}{$\\mkern2mu"
+> + "\\tiny\\text{-}\\mkern1mu\\text{-}\\mkern1mu\\text{-}\\mkern2mu$}}");
+52,55c70
+<     //
+<     //  Store the string when a CE object is created
+<     //
+<     Init: function (string) { this.string = string; },
+---
+> import katex from "katex";
+57,64c72,85
+<     //
+<     //  This converts the CE string to a TeX string.
+<     //
+<     Parse: function (stateMachine) {
+<       try {
+<         return texify.go(mhchemParser.go(this.string, stateMachine));
+<       } catch (ex) {
+<         TEX.Error(ex);
+---
+>   //
+>   //  This is the main function for handing the \ce and \pu commands.
+>   //  It takes the argument to \ce or \pu and returns the corresponding TeX string.
+>   //
+> 
+>   var chemParse = function (tokens, stateMachine) {
+>     // Recreate the argument string from KaTeX's array of tokens.
+>     var str = "";
+>     var expectedLoc = tokens[tokens.length - 1].loc.start
+>     for (var i = tokens.length - 1; i >= 0; i--) {
+>       if(tokens[i].loc.start > expectedLoc) {
+>         // context.consumeArgs has eaten a space.
+>         str += " ";
+>         expectedLoc = tokens[i].loc.start;
+65a87,88
+>       str += tokens[i].text;
+>       expectedLoc += tokens[i].text.length;
+67c90,92
+<   });
+---
+>     var tex = texify.go(mhchemParser.go(str, stateMachine));
+>     return tex;
+>   };
+1405,1406c1430,1431
+<             res += "^{\\smash[t]{\\vphantom{2}}\\llap{"+(b5.b||"")+"}}";
+<             res += "_{\\vphantom{2}\\llap{\\smash[t]{"+(b5.p||"")+"}}}";
+---
+>             res += "^{\\smash[t]{\\vphantom{2}}\\mathllap{"+(b5.b||"")+"}}";
+>             res += "_{\\vphantom{2}\\mathllap{\\smash[t]{"+(b5.p||"")+"}}}";
+1508,1520c1533,1536
+<           var arrow = texify._getArrow(buf.r);
+<           if (b6.rd || b6.rq) {
+<             if (buf.r === "<=>"  ||  buf.r === "<=>>"  ||  buf.r === "<<=>"  ||  buf.r === "<-->") {
+<               // arrows that cannot stretch correctly yet, https://github.com/mathjax/MathJax/issues/1491
+<               arrow = "\\long"+arrow;
+<               if (b6.rd) { arrow = "\\overset{"+b6.rd+"}{"+arrow+"}"; }
+<               if (b6.rq) { arrow = "\\underset{\\lower7mu{"+b6.rq+"}}{"+arrow+"}"; }
+<               arrow = " {}\\mathrel{"+arrow+"}{} ";
+<             } else {
+<               if (b6.rq) { arrow += "[{"+b6.rq+"}]"; }
+<               arrow += "{"+b6.rd+"}";
+<               arrow = " {}\\mathrel{\\x"+arrow+"}{} ";
+<             }
+---
+>           var arrow = "\\x" + texify._getArrow(buf.r);
+>           if (b6.rq) { arrow += "[{" + b6.rq + "}]"; }
+>           if (b6.rd) {
+>             arrow += "{" + b6.rd + "}";
+1522c1538
+<             arrow = " {}\\mathrel{\\long"+arrow+"}{} ";
+---
+>             arrow += "{}";
+1615c1631
+<         case "<-->": return "leftrightarrows";
+---
+>         case "<-->": return "rightleftarrows";
+1618,1619c1634,1635
+<         case "<=>>": return "Rightleftharpoons";
+<         case "<<=>": return "Leftrightharpoons";
+---
+>         case "<=>>": return "rightequilibrium";
+>         case "<<=>": return "leftequilibrium";
+1634,1637c1650,1653
+<         case "~-": return "{\\rlap{\\lower.1em{-}}\\raise.1em{\\tripledash}}";
+<         case "~=": return "{\\rlap{\\lower.2em{-}}\\rlap{\\raise.2em{\\tripledash}}-}";
+<         case "~--": return "{\\rlap{\\lower.2em{-}}\\rlap{\\raise.2em{\\tripledash}}-}";
+<         case "-~-": return "{\\rlap{\\lower.2em{-}}\\rlap{\\raise.2em{-}}\\tripledash}";
+---
+>         case "~-": return "{\\mathrlap{\\raisebox{-.1em}{$-$}}\\raisebox{.1em}{$\\tripledash$}}";
+>         case "~=": return "{\\mathrlap{\\raisebox{-.2em}{$-$}}\\mathrlap{\\raisebox{.2em}{$\\tripledash$}}-}";
+>         case "~--": return "{\\mathrlap{\\raisebox{-.2em}{$-$}}\\mathrlap{\\raisebox{.2em}{$\\tripledash$}}-}";
+>         case "-~-": return "{\\mathrlap{\\raisebox{-.2em}{$-$}}\\mathrlap{\\raisebox{.2em}{$-$}}\\tripledash}";
+1680,1770d1695
+< 
+<   //
+<   // MathJax definitions
+<   //
+<   MathJax.Extension["TeX/mhchem"].CE = CE;
+< 
+<   /***************************************************************************/
+< 
+<   TEX.Definitions.Add({
+<     macros: {
+<       //
+<       //  Set up the macros for chemistry
+<       //
+<       ce: "CE",
+<       pu: "PU",
+< 
+<       //
+<       //  Make these load AMSmath package (redefined below when loaded)
+<       //
+<       xleftrightarrow:    ["Extension", "AMSmath"],
+<       xrightleftharpoons: ["Extension", "AMSmath"],
+<       xRightleftharpoons: ["Extension", "AMSmath"],
+<       xLeftrightharpoons: ["Extension", "AMSmath"],
+< 
+<       //  FIXME:  These don't work well in FF NativeMML mode
+<       longrightleftharpoons: ["Macro", "\\stackrel{\\textstyle{-}\\!\\!{\\rightharpoonup}}{\\smash{{\\leftharpoondown}\\!\\!{-}}}"],
+<       longRightleftharpoons: ["Macro", "\\stackrel{\\textstyle{-}\\!\\!{\\rightharpoonup}}{\\smash{\\leftharpoondown}}"],
+<       longLeftrightharpoons: ["Macro", "\\stackrel{\\textstyle\\vphantom{{-}}{\\rightharpoonup}}{\\smash{{\\leftharpoondown}\\!\\!{-}}}"],
+<       longleftrightarrows:   ["Macro", "\\stackrel{\\longrightarrow}{\\smash{\\longleftarrow}\\Rule{0px}{.25em}{0px}}"],
+< 
+<       //
+<       //  Needed for \bond for the ~ forms
+<       //  Not perfectly aligned when zoomed in, but on 100%
+<       //
+<       tripledash: ["Macro", "\\vphantom{-}\\raise2mu{\\kern2mu\\tiny\\text{-}\\kern1mu\\text{-}\\kern1mu\\text{-}\\kern2mu}"]
+<     },
+<   }, null, true);
+< 
+<   if (!MathJax.Extension["TeX/AMSmath"]) {
+<     TEX.Definitions.Add({
+<       macros: {
+<         xrightarrow: ["Extension", "AMSmath"],
+<         xleftarrow:  ["Extension", "AMSmath"]
+<       }
+<     }, null, true);
+<   }
+< 
+<   //
+<   //  These arrows need to wait until AMSmath is loaded
+<   //
+<   MathJax.Hub.Register.StartupHook("TeX AMSmath Ready", function () {
+<     TEX.Definitions.Add({
+<       macros: {
+<         //
+<         //  Some of these are hacks for now
+<         //
+<         xleftrightarrow:    ["xArrow", 0x2194, 6, 6],
+<         xrightleftharpoons: ["xArrow", 0x21CC, 5, 7],  // FIXME:  doesn't stretch in HTML-CSS output
+<         xRightleftharpoons: ["xArrow", 0x21CC, 5, 7],  // FIXME:  how should this be handled?
+<         xLeftrightharpoons: ["xArrow", 0x21CC, 5, 7]
+<       }
+<     }, null, true);
+<   });
+< 
+<   TEX.Parse.Augment({
+< 
+<     //
+<     //  Implements \ce and friends
+<     //
+<     CE: function (name) {
+<       var arg = this.GetArgument(name);
+<       var tex = CE(arg).Parse();
+<       this.string = tex + this.string.substr(this.i); this.i = 0;
+<     },
+< 
+<     PU: function (name) {
+<       var arg = this.GetArgument(name);
+<       var tex = CE(arg).Parse('pu');
+<       this.string = tex + this.string.substr(this.i); this.i = 0;
+<     }
+< 
+<   });
+< 
+<   //
+<   //  Indicate that the extension is ready
+<   //
+<   MathJax.Hub.Startup.signal.Post("TeX mhchem Ready");
+< 
+< });
+< 
+< MathJax.Ajax.loadComplete("[mhchem]/unpacked/mhchem.js");

package/dist/README.md

@@ -1,23 +1,24 @@
-# [<img src="https://cdn.rawgit.com/Khan/KaTeX/84189cd3adae24d92e766d14eb80d6e54f3c7dca/katex-logo.svg" width="130" alt="KaTeX">](https://khan.github.io/KaTeX/)
+# [<img src="https://katex.org/img/katex-logo-black.svg" width="130" alt="KaTeX">](https://katex.org/)
 [![npm](https://img.shields.io/npm/v/katex.svg)](https://www.npmjs.com/package/katex)
-[![CircleCI](https://circleci.com/gh/Khan/KaTeX.svg?style=shield)](https://circleci.com/gh/Khan/KaTeX)
-[![codecov](https://codecov.io/gh/Khan/KaTeX/branch/master/graph/badge.svg)](https://codecov.io/gh/Khan/KaTeX)
-[![Join the chat at https://gitter.im/Khan/KaTeX](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/Khan/KaTeX?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Greenkeeper badge](https://badges.greenkeeper.io/Khan/KaTeX.svg)](https://greenkeeper.io/)
+[![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/)
 [![jsDelivr](https://data.jsdelivr.com/v1/package/npm/katex/badge?style=rounded)](https://www.jsdelivr.com/package/npm/katex)
-![](https://img.badgesize.io/Khan/KaTeX/v0.10.0-rc/dist/katex.min.js?compression=gzip)
+![](https://img.badgesize.io/KaTeX/KaTeX/v0.10.2/dist/katex.min.js?compression=gzip)
 
 KaTeX is a fast, easy-to-use JavaScript library for TeX math rendering on the web.
 
  * **Fast:** KaTeX renders its math synchronously and doesn't need to reflow the page. See how it compares to a competitor in [this speed test](http://www.intmath.com/cg5/katex-mathjax-comparison.php).
- * **Print quality:** KaTeX’s layout is based on Donald Knuth’s TeX, the gold standard for math typesetting.
+ * **Print quality:** KaTeX's layout is based on Donald Knuth's TeX, the gold standard for math typesetting.
  * **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 supports much (but not all) of LaTeX and many LaTeX packages. See the [list of supported functions](https://khan.github.io/KaTeX/docs/supported.html).
+KaTeX supports much (but not all) of LaTeX and many LaTeX packages. See the [list of supported functions](https://katex.org/docs/supported.html).
 
-Try out KaTeX [on the demo page](https://khan.github.io/KaTeX/#demo)!
+Try out KaTeX [on the demo page](https://katex.org/#demo)!
 
 ## Getting started
 
@@ -28,22 +29,22 @@ Try out KaTeX [on the demo page](https://khan.github.io/KaTeX/#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.0-rc/dist/katex.min.css" integrity="sha384-D+9gmBxUQogRLqvARvNLmA9hS2x//eK1FhVb9PiU86gmcrBrJAQT8okdJ4LMp2uv" crossorigin="anonymous">
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.10.2/dist/katex.min.css" integrity="sha384-yFRtMMDnQtDRO8rLpMIKrtPCD5jdktao2TV19YiZYWMDkUR5GQZR/NOVTdquEx1j" crossorigin="anonymous">
 
     <!-- The loading of KaTeX is deferred to speed up page rendering -->
-    <script defer src="https://cdn.jsdelivr.net/npm/katex@0.10.0-rc/dist/katex.min.js" integrity="sha384-ttOZCNX+557qK00I95MHw9tttcgWn2PjR/bXecuEvENq6nevFtwSSQ6bYEN6AetB" crossorigin="anonymous"></script>
+    <script defer src="https://cdn.jsdelivr.net/npm/katex@0.10.2/dist/katex.min.js" integrity="sha384-9Nhn55MVVN0/4OFx7EE5kpFBPsEMZxKTCnA+4fqDmg12eCTqGi6+BB2LjY8brQxJ" 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.0-rc/dist/contrib/auto-render.min.js" integrity="sha384-yACMu8JWxKzSp/C1YV86pzGiQ/l1YUfE8oPuahJQxzehAjEt2GiQuy/BIvl9KyeF" crossorigin="anonymous"
+    <script defer src="https://cdn.jsdelivr.net/npm/katex@0.10.2/dist/contrib/auto-render.min.js" integrity="sha384-kWPLUVMOks5AQFrykwIup5lo0m3iMkkHrD0uJ4H5cjeGihAutqP0yW0J6dpFiVkI" crossorigin="anonymous"
         onload="renderMathInElement(document.body);"></script>
   </head>
   ...
 </html>
 ```
 
-You can also [download KaTeX](https://github.com/khan/katex/releases) and host it yourself.
+You can also [download KaTeX](https://github.com/KaTeX/KaTeX/releases) and host it yourself.
 
-For details on how to configure auto-render extension, refer to [the documentation](https://khan.github.io/KaTeX/docs/autorender.html).
+For details on how to configure auto-render extension, refer to [the documentation](https://katex.org/docs/autorender.html).
 
 ### API
 
@@ -73,13 +74,13 @@ JavaScript on the client.
 The examples above use the `throwOnError: false` option, which renders invalid
 inputs as the TeX source code in red (by default), with the error message as
 hover text.  For other available options, see the
-[API documentation](https://khan.github.io/KaTeX/docs/api.html),
-[options documentation](https://khan.github.io/KaTeX/docs/options.html), and
-[handling errors documentation](https://khan.github.io/KaTeX/docs/error.html).
+[API documentation](https://katex.org/docs/api.html),
+[options documentation](https://katex.org/docs/options.html), and
+[handling errors documentation](https://katex.org/docs/error.html).
 
 ## Demo and Documentation
 
-Learn more about using KaTeX [on the website](https://khan.github.io/KaTeX)!
+Learn more about using KaTeX [on the website](https://katex.org)!
 
 ## Contributing