katex 0.18.6 → 0.18.8

package/dist/katex.mjs

@@ -9491,9 +9491,10 @@ function parseArray(parser, _ref, style) {
       endRow();
       // Arrays terminate newlines with `\crcr` which consumes a `\cr` if
       // the last line is empty.  However, AMS environments keep the
-      // empty row if it's the only one or has a manual tag.
+      // empty row if it's the only one, has a manual tag, or is an
+      // automatically numbered row explicitly ended with `\\`.
       // NOTE: Currently, `cell` is the last item added into `row`.
-      if (row.length === 1 && cell.type === "styling" && cell.body.length === 1 && cell.body[0].type === "ordgroup" && cell.body[0].body.length === 0 && (body.length > 1 || !emptySingleRow) && !Array.isArray(tags == null ? void 0 : tags[tags.length - 1])) {
+      if (row.length === 1 && cell.type === "styling" && cell.body.length === 1 && cell.body[0].type === "ordgroup" && cell.body[0].body.length === 0 && (body.length > 1 || !emptySingleRow) && !Array.isArray(tags == null ? void 0 : tags[tags.length - 1]) && !(autoTag && (tags == null ? void 0 : tags[tags.length - 1]) === true)) {
         body.pop();
       }
       if (hLinesBeforeRow.length < body.length + 1) {
@@ -12207,6 +12208,38 @@ defineFunction({
   }
 });
 
+var handler = (_ref, args) => {
+  var parser = _ref.parser;
+  return {
+    type: "reflectbox",
+    mode: parser.mode,
+    body: args[0]
+  };
+};
+defineFunction({
+  type: "reflectbox",
+  names: ["\\reflectbox"],
+  numArgs: 1,
+  argTypes: ["hbox"],
+  allowedInText: true,
+  handler,
+  htmlBuilder(group, options) {
+    return makeSpan(["mord", "reflectbox"], [buildGroup$1(group.body, options)], options);
+  },
+  mathmlBuilder(group, options) {
+    return buildGroup(group.body, options);
+  }
+});
+// Parse math directly so the shared builders inherit the surrounding style.
+// \reflectbox instead uses an hbox argument for LaTeX's text-box behavior.
+defineFunction({
+  type: "reflectbox",
+  names: ["\\mathreflectbox"],
+  numArgs: 1,
+  argTypes: ["math"],
+  handler
+});
+
 defineFunction({
   type: "internal",
   names: ["\\relax"],
@@ -14086,6 +14119,8 @@ defineMacro("\u27e6", "\\llbracket"); // blackboard bold [
 defineMacro("\u27e7", "\\rrbracket"); // blackboard bold ]
 defineMacro("\\lBrace", "\\html@mathml{" + "\\mathopen{\\{\\mkern-3.2mu[}}" + "{\\mathopen{\\char`\u2983}}");
 defineMacro("\\rBrace", "\\html@mathml{" + "\\mathclose{]\\mkern-3.2mu\\}}}" + "{\\mathclose{\\char`\u2984}}");
+defineMacro("↤", "\\mapsfrom");
+defineMacro("\\mapsfrom", "\\html@mathml{\\mathrel{\\mathreflectbox{\\mapsto}}}{\\mathrel{\\char`↤}}");
 defineMacro("\u2983", "\\lBrace"); // blackboard bold {
 defineMacro("\u2984", "\\rBrace"); // blackboard bold }
 // TODO: Create variable sized versions of the last two items. I believe that
@@ -16275,7 +16310,7 @@ var renderToHTMLTree = function renderToHTMLTree(expression, options) {
     return renderError(error, expression, settings);
   }
 };
-var version = "0.18.6";
+var version = "0.18.8";
 var __domTree = {
   Span,
   Anchor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "katex",
-  "version": "0.18.6",
+  "version": "0.18.8",
   "description": "Fast math typesetting for the web.",
   "main": "dist/katex.js",
   "types": "types/katex.d.ts",

package/src/environments/array.ts

@@ -210,13 +210,15 @@ function parseArray(
             endRow();
             // Arrays terminate newlines with `\crcr` which consumes a `\cr` if
             // the last line is empty.  However, AMS environments keep the
-            // empty row if it's the only one or has a manual tag.
+            // empty row if it's the only one, has a manual tag, or is an
+            // automatically numbered row explicitly ended with `\\`.
             // NOTE: Currently, `cell` is the last item added into `row`.
             if (row.length === 1 && cell.type === "styling" &&
                 cell.body.length === 1 && cell.body[0].type === "ordgroup" &&
                 cell.body[0].body.length === 0 &&
                 (body.length > 1 || !emptySingleRow) &&
-                !Array.isArray(tags?.[tags.length - 1])) {
+                !Array.isArray(tags?.[tags.length - 1]) &&
+                !(autoTag && tags?.[tags.length - 1] === true)) {
                 body.pop();
             }
             if (hLinesBeforeRow.length < body.length + 1) {

package/src/functions/reflectbox.ts

@@ -0,0 +1,43 @@
+import defineFunction from "../defineFunction";
+import type {FunctionHandler} from "../defineFunction";
+import {makeSpan} from "../buildCommon";
+
+import * as html from "../buildHTML";
+import * as mml from "../buildMathML";
+
+const handler: FunctionHandler<"reflectbox"> = ({parser}, args) => ({
+    type: "reflectbox",
+    mode: parser.mode,
+    body: args[0],
+});
+
+defineFunction({
+    type: "reflectbox",
+    names: ["\\reflectbox"],
+    numArgs: 1,
+    argTypes: ["hbox"],
+    allowedInText: true,
+
+    handler,
+
+    htmlBuilder(group, options) {
+        return makeSpan(
+            ["mord", "reflectbox"],
+            [html.buildGroup(group.body, options)],
+            options,
+        );
+    },
+    mathmlBuilder(group, options) {
+        return mml.buildGroup(group.body, options);
+    },
+});
+
+// Parse math directly so the shared builders inherit the surrounding style.
+// \reflectbox instead uses an hbox argument for LaTeX's text-box behavior.
+defineFunction({
+    type: "reflectbox",
+    names: ["\\mathreflectbox"],
+    numArgs: 1,
+    argTypes: ["math"],
+    handler,
+});

package/src/functions.ts

@@ -37,6 +37,7 @@ import "./functions/ordgroup";
 import "./functions/overline";
 import "./functions/phantom";
 import "./functions/raisebox";
+import "./functions/reflectbox";
 import "./functions/relax";
 import "./functions/rule";
 import "./functions/sizing";

package/src/macros.ts

@@ -811,6 +811,12 @@ defineMacro("\\rBrace", "\\html@mathml{" +
     "\\mathclose{]\\mkern-3.2mu\\}}}" +
     "{\\mathclose{\\char`\u2984}}");
 
+defineMacro("↤", "\\mapsfrom");
+defineMacro(
+    "\\mapsfrom",
+    "\\html@mathml{\\mathrel{\\mathreflectbox{\\mapsto}}}{\\mathrel{\\char`↤}}",
+);
+
 defineMacro("\u2983", "\\lBrace"); // blackboard bold {
 defineMacro("\u2984", "\\rBrace"); // blackboard bold }
 

package/src/styles/katex.scss

@@ -602,6 +602,11 @@ $display-margin: 1em 0 !default;
         padding: 0 0.03889em;             // pad 1mu left and right (in scriptstyle)
     }
 
+    .reflectbox {
+        display: inline-block;
+        transform: scaleX(-1);
+    }
+
     .eqn-num::before {
         counter-increment: katexEqnNo;
         content: "(" counter(katexEqnNo) ")";

package/src/types/nodes.ts

@@ -69,7 +69,8 @@ export type AnyParseNode =
     | SmashNode
     | SqrtNode
     | VerticalCenterNode
-    | ExtensibleArrowNode;
+    | ExtensibleArrowNode
+    | ReflectBoxNode;
 
 // ParseNode's corresponding to Symbol `Group`s in symbols.js.
 export type SymbolParseNode =
@@ -454,3 +455,8 @@ type ExtensibleArrowNode = BaseNode & {
     body: AnyParseNode;
     below: AnyParseNode | null;
 }
+
+type ReflectBoxNode = BaseNode & {
+    type: "reflectbox";
+    body: AnyParseNode;
+};