katex 0.16.47 → 0.18.0

package/src/functions/accentunder.ts

@@ -7,7 +7,7 @@ import {stretchyMathML, stretchySvg} from "../stretchy";
 import * as html from "../buildHTML";
 import * as mml from "../buildMathML";
 
-import type {ParseNode} from "../parseNode";
+import type {ParseNode} from "../types/nodes";
 
 defineFunction({
     type: "accentUnder",
@@ -15,9 +15,8 @@ defineFunction({
         "\\underleftarrow", "\\underrightarrow", "\\underleftrightarrow",
         "\\undergroup", "\\underlinesegment", "\\utilde",
     ],
-    props: {
-        numArgs: 1,
-    },
+    numArgs: 1,
+
     handler: ({parser, funcName}, args) => {
         const base = args[0];
         return {
@@ -27,6 +26,7 @@ defineFunction({
             base: base,
         };
     },
+
     htmlBuilder: (group: ParseNode<"accentUnder">, options) => {
         // Treat under accents much like underlines.
         const innerGroup = html.buildGroup(group.base, options);

package/src/functions/arrow.ts

@@ -6,7 +6,7 @@ import {stretchyMathML, stretchySvg} from "../stretchy";
 import * as html from "../buildHTML";
 import * as mml from "../buildMathML";
 
-import type {ParseNode} from "../parseNode";
+import type {ParseNode} from "../types/nodes";
 import type {MathDomNode} from "../mathMLTree";
 
 // Helper function
@@ -33,10 +33,9 @@ defineFunction({
         // The next 3 functions are here only to support the {CD} environment.
         "\\\\cdrightarrow", "\\\\cdleftarrow", "\\\\cdlongequal",
     ],
-    props: {
-        numArgs: 1,
-        numOptionalArgs: 1,
-    },
+    numArgs: 1,
+    numOptionalArgs: 1,
+
     handler({parser, funcName}, args, optArgs) {
         return {
             type: "xArrow",
@@ -46,6 +45,7 @@ defineFunction({
             below: optArgs[0],
         };
     },
+
     htmlBuilder(group: ParseNode<"xArrow">, options) {
         const style = options.style;
 

package/src/functions/char.ts

@@ -8,10 +8,9 @@ import {assertNodeType} from "../parseNode";
 defineFunction({
     type: "textord",
     names: ["\\@char"],
-    props: {
-        numArgs: 1,
-        allowedInText: true,
-    },
+    numArgs: 1,
+    allowedInText: true,
+
     handler({parser}, args) {
         const arg = assertNodeType(args[0], "ordgroup");
         const group = arg.body;

package/src/functions/color.ts

@@ -2,7 +2,7 @@ import defineFunction, {ordargument} from "../defineFunction";
 import {makeFragment} from "../buildCommon";
 import {MathNode} from "../mathMLTree";
 import {assertNodeType} from "../parseNode";
-import type {AnyParseNode} from "../parseNode";
+import type {AnyParseNode} from "../types/nodes";
 import type {HtmlBuilder, MathMLBuilder} from "../defineFunction";
 
 import * as html from "../buildHTML";
@@ -36,11 +36,10 @@ const mathmlBuilder: MathMLBuilder<"color"> = (group, options) => {
 defineFunction({
     type: "color",
     names: ["\\textcolor"],
-    props: {
-        numArgs: 2,
-        allowedInText: true,
-        argTypes: ["color", "original"],
-    },
+    numArgs: 2,
+    allowedInText: true,
+    argTypes: ["color", "original"],
+
     handler({parser}, args) {
         const color = assertNodeType(args[0], "color-token").color;
         const body = args[1];
@@ -51,6 +50,7 @@ defineFunction({
             body: (ordargument(body) as AnyParseNode[]),
         };
     },
+
     htmlBuilder,
     mathmlBuilder,
 });
@@ -58,11 +58,10 @@ defineFunction({
 defineFunction({
     type: "color",
     names: ["\\color"],
-    props: {
-        numArgs: 1,
-        allowedInText: true,
-        argTypes: ["color"],
-    },
+    numArgs: 1,
+    allowedInText: true,
+    argTypes: ["color"],
+
     handler({parser, breakOnTokenText}, args) {
         const color = assertNodeType(args[0], "color-token").color;
 
@@ -82,6 +81,4 @@ defineFunction({
             body,
         };
     },
-    htmlBuilder,
-    mathmlBuilder,
 });

package/src/functions/cr.ts

@@ -10,11 +10,9 @@ import {assertNodeType} from "../parseNode";
 defineFunction({
     type: "cr",
     names: ["\\\\"],
-    props: {
-        numArgs: 0,
-        numOptionalArgs: 0,
-        allowedInText: true,
-    },
+    numArgs: 0,
+    numOptionalArgs: 0,
+    allowedInText: true,
 
     handler({parser}, args, optArgs) {
         const size = parser.gullet.future().text === "[" ?
@@ -37,7 +35,7 @@ defineFunction({
     htmlBuilder(group, options) {
         const span = makeSpan(["mspace"], [], options);
         if (group.newLine) {
-            span.classes.push("newline");
+            span.classes.push("katex-newline");
             if (group.size) {
                 span.style.marginTop =
                     makeEm(calculateSize(group.size, options));

package/src/functions/def.ts

@@ -62,10 +62,9 @@ defineFunction({
         "\\global", "\\long",
         "\\\\globallong", // can’t be entered directly
     ],
-    props: {
-        numArgs: 0,
-        allowedInText: true,
-    },
+    numArgs: 0,
+    allowedInText: true,
+
     handler({parser, funcName}) {
         parser.consumeSpaces();
         const token = parser.fetch();
@@ -87,11 +86,10 @@ defineFunction({
 defineFunction({
     type: "internal",
     names: ["\\def", "\\gdef", "\\edef", "\\xdef"],
-    props: {
-        numArgs: 0,
-        allowedInText: true,
-        primitive: true,
-    },
+    numArgs: 0,
+    allowedInText: true,
+    primitive: true,
+
     handler({parser, funcName}) {
         let tok = parser.gullet.popToken();
         const name = tok.text;
@@ -168,11 +166,10 @@ defineFunction({
         "\\let",
         "\\\\globallet", // can’t be entered directly
     ],
-    props: {
-        numArgs: 0,
-        allowedInText: true,
-        primitive: true,
-    },
+    numArgs: 0,
+    allowedInText: true,
+    primitive: true,
+
     handler({parser, funcName}) {
         const name = checkControlSequence(parser.gullet.popToken());
         parser.gullet.consumeSpaces();
@@ -192,11 +189,10 @@ defineFunction({
         "\\futurelet",
         "\\\\globalfuture", // can’t be entered directly
     ],
-    props: {
-        numArgs: 0,
-        allowedInText: true,
-        primitive: true,
-    },
+    numArgs: 0,
+    allowedInText: true,
+    primitive: true,
+
     handler({parser, funcName}) {
         const name = checkControlSequence(parser.gullet.popToken());
         const middle = parser.gullet.popToken();

package/src/functions/delimsizing.ts

@@ -10,15 +10,13 @@ import * as html from "../buildHTML";
 import * as mml from "../buildMathML";
 
 import type Options from "../Options";
-import type {AnyParseNode, ParseNode, SymbolParseNode} from "../parseNode";
 import type {FunctionContext} from "../defineFunction";
 import type {HtmlDomNode} from "../domTree";
+import type {DelimiterSize, MathClass} from "../types";
+import type {AnyParseNode, ParseNode, SymbolParseNode} from "../types/nodes";
 
 // Extra data needed for the delimiter handler down below
-const delimiterSizes: Record<string, {
-    mclass: "mopen" | "mclose" | "mrel" | "mord";
-    size: 1 | 2 | 3 | 4;
-}> = {
+const delimiterSizes = {
     "\\bigl" : {mclass: "mopen",    size: 1},
     "\\Bigl" : {mclass: "mopen",    size: 2},
     "\\biggl": {mclass: "mopen",    size: 3},
@@ -35,7 +33,10 @@ const delimiterSizes: Record<string, {
     "\\Big"  : {mclass: "mord",     size: 2},
     "\\bigg" : {mclass: "mord",     size: 3},
     "\\Bigg" : {mclass: "mord",     size: 4},
-};
+} as const satisfies Record<string, {
+    mclass: MathClass;
+    size: DelimiterSize;
+}>;
 
 const delimiters = new Set([
     "(", "\\lparen", ")", "\\rparen",
@@ -92,10 +93,9 @@ defineFunction({
         "\\bigm", "\\Bigm", "\\biggm", "\\Biggm",
         "\\big",  "\\Big",  "\\bigg",  "\\Bigg",
     ],
-    props: {
-        numArgs: 1,
-        argTypes: ["primitive"],
-    },
+    numArgs: 1,
+    argTypes: ["primitive"],
+
     handler: (context, args) => {
         const delim = checkDelimiter(args[0], context);
 
@@ -107,6 +107,7 @@ defineFunction({
             delim: delim.text,
         };
     },
+
     htmlBuilder: (group, options) => {
         if (group.delim === ".") {
             // Empty delimiters still count as elements, even though they don't
@@ -157,10 +158,9 @@ function assertParsed(group: ParseNode<"leftright">) {
 defineFunction({
     type: "leftright-right",
     names: ["\\right"],
-    props: {
-        numArgs: 1,
-        primitive: true,
-    },
+    numArgs: 1,
+    primitive: true,
+
     handler: (context, args) => {
         // \left case below triggers parsing of \right in
         //   `const right = parser.parseFunction();`
@@ -174,7 +174,7 @@ defineFunction({
             type: "leftright-right",
             mode: context.parser.mode,
             delim: checkDelimiter(args[0], context).text,
-            color: color as string | null | undefined, // undefined if not set via \color
+            color, // undefined if not set via \color
         };
     },
 });
@@ -183,10 +183,9 @@ defineFunction({
 defineFunction({
     type: "leftright",
     names: ["\\left"],
-    props: {
-        numArgs: 1,
-        primitive: true,
-    },
+    numArgs: 1,
+    primitive: true,
+
     handler: (context, args) => {
         const delim = checkDelimiter(args[0], context);
 
@@ -208,6 +207,7 @@ defineFunction({
             rightColor: right.color,
         };
     },
+
     htmlBuilder: (group, options) => {
         assertParsed(group);
         // Build the inner expression
@@ -312,10 +312,9 @@ defineFunction({
 defineFunction({
     type: "middle",
     names: ["\\middle"],
-    props: {
-        numArgs: 1,
-        primitive: true,
-    },
+    numArgs: 1,
+    primitive: true,
+
     handler: (context, args) => {
         const delim = checkDelimiter(args[0], context);
         if (!context.parser.leftrightDepth) {
@@ -328,6 +327,7 @@ defineFunction({
             delim: delim.text,
         };
     },
+
     htmlBuilder: (group, options) => {
         let middleDelim;
         if (group.delim === ".") {

package/src/functions/enclose.ts

@@ -32,7 +32,7 @@ const htmlBuilder: HtmlBuilder<"enclose"> = (group, options) => {
     const isSingleChar = isCharacterBox(group.body);
 
     if (label === "sout") {
-        img = makeSpan(["stretchy", "sout"]);
+        img = makeSpan(["katex-stretchy", "katex-sout"]);
         img.height = options.fontMetrics().defaultRuleThickness / scale;
         imgShift = -0.5 * options.fontMetrics().xHeight;
 
@@ -220,11 +220,10 @@ const mathmlBuilder: MathMLBuilder<"enclose"> = (group, options) => {
 defineFunction({
     type: "enclose",
     names: ["\\colorbox"],
-    props: {
-        numArgs: 2,
-        allowedInText: true,
-        argTypes: ["color", "hbox"],
-    },
+    numArgs: 2,
+    allowedInText: true,
+    argTypes: ["color", "hbox"],
+
     handler({parser, funcName}, args, optArgs) {
         const color = assertNodeType(args[0], "color-token").color;
         const body = args[1];
@@ -236,6 +235,7 @@ defineFunction({
             body,
         };
     },
+
     htmlBuilder,
     mathmlBuilder,
 });
@@ -243,11 +243,10 @@ defineFunction({
 defineFunction({
     type: "enclose",
     names: ["\\fcolorbox"],
-    props: {
-        numArgs: 3,
-        allowedInText: true,
-        argTypes: ["color", "color", "hbox"],
-    },
+    numArgs: 3,
+    allowedInText: true,
+    argTypes: ["color", "color", "hbox"],
+
     handler({parser, funcName}, args, optArgs) {
         const borderColor = assertNodeType(args[0], "color-token").color;
         const backgroundColor = assertNodeType(args[1], "color-token").color;
@@ -261,18 +260,15 @@ defineFunction({
             body,
         };
     },
-    htmlBuilder,
-    mathmlBuilder,
 });
 
 defineFunction({
     type: "enclose",
     names: ["\\fbox"],
-    props: {
-        numArgs: 1,
-        argTypes: ["hbox"],
-        allowedInText: true,
-    },
+    numArgs: 1,
+    argTypes: ["hbox"],
+    allowedInText: true,
+
     handler({parser}, args) {
         return {
             type: "enclose",
@@ -286,9 +282,8 @@ defineFunction({
 defineFunction({
     type: "enclose",
     names: ["\\cancel", "\\bcancel", "\\xcancel", "\\phase"],
-    props: {
-        numArgs: 1,
-    },
+    numArgs: 1,
+
     handler({parser, funcName}, args) {
         const body = args[0];
         return {
@@ -298,17 +293,14 @@ defineFunction({
             body,
         };
     },
-    htmlBuilder,
-    mathmlBuilder,
 });
 
 defineFunction({
     type: "enclose",
     names: ["\\sout"],
-    props: {
-        numArgs: 1,
-        allowedInText: true,
-    },
+    numArgs: 1,
+    allowedInText: true,
+
     handler({parser, funcName}, args) {
         if (parser.mode === "math") {
             parser.settings.reportNonstrict("mathVsSout",
@@ -322,18 +314,15 @@ defineFunction({
             body,
         };
     },
-    htmlBuilder,
-    mathmlBuilder,
 });
 
 defineFunction({
     type: "enclose",
     names: ["\\angl"],
-    props: {
-        numArgs: 1,
-        argTypes: ["hbox"],
-        allowedInText: false,
-    },
+    numArgs: 1,
+    argTypes: ["hbox"],
+    allowedInText: false,
+
     handler({parser}, args) {
         return {
             type: "enclose",

package/src/functions/environment.ts

@@ -3,17 +3,16 @@ import ParseError from "../ParseError";
 import {assertNodeType} from "../parseNode";
 import environments from "../environments";
 
-import type {ParseNode} from "../parseNode";
+import type {ParseNode} from "../types/nodes";
 
 // Environment delimiters. HTML/MathML rendering is defined in the corresponding
 // defineEnvironment definitions.
 defineFunction({
     type: "environment",
     names: ["\\begin", "\\end"],
-    props: {
-        numArgs: 1,
-        argTypes: ["text"],
-    },
+    numArgs: 1,
+    argTypes: ["text"],
+
     handler({parser, funcName}, args) {
         const nameGroup = args[0];
         if (nameGroup.type !== "ordgroup") {
@@ -26,7 +25,7 @@ defineFunction({
 
         if (funcName === "\\begin") {
             // begin...end is similar to left...right
-            if (!environments.hasOwnProperty(envName)) {
+            if (!Object.prototype.hasOwnProperty.call(environments, envName)) {
                 throw new ParseError(
                     "No such environment: " + envName, nameGroup);
             }

package/src/functions/font.ts

@@ -8,7 +8,7 @@ import * as html from "../buildHTML";
 import * as mml from "../buildMathML";
 
 import type Options from "../Options";
-import type {ParseNode} from "../parseNode";
+import type {ParseNode} from "../types/nodes";
 import type {Slice1} from "../types";
 
 const htmlBuilder = (group: ParseNode<"font">, options: Options) => {
@@ -29,12 +29,6 @@ const fontAliases = {
     "\\frak": "\\mathfrak",
 } as const;
 
-type OldFontCommands = "\\rm" | "\\sf" | "\\tt" | "\\bf" | "\\it" | "\\cal";
-type FontCommands =
-    "\\mathrm" | "\\mathit" | "\\mathbf" | "\\mathnormal" | "\\mathsfit" |
-    "\\mathbb" | "\\mathcal" | "\\mathfrak" | "\\mathscr" | "\\mathsf" |
-    "\\mathtt";
-
 defineFunction({
     type: "font",
     names: [
@@ -47,24 +41,23 @@ defineFunction({
 
         // aliases, except \bm defined below
         "\\Bbb", "\\bold", "\\frak",
-    ] satisfies (FontCommands | keyof typeof fontAliases)[],
-    props: {
-        numArgs: 1,
-        allowedInArgument: true,
-    },
+    ],
+    numArgs: 1,
+    allowedInArgument: true,
+
     handler: ({parser, funcName}, args) => {
         const body = normalizeArgument(args[0]);
-        let func = funcName;
-        if (func in fontAliases) {
-            func = fontAliases[func as keyof typeof fontAliases];
-        }
+        const func = funcName in fontAliases
+            ? fontAliases[funcName as keyof typeof fontAliases]
+            : funcName as Exclude<typeof funcName, keyof typeof fontAliases>;
         return {
             type: "font",
             mode: parser.mode,
-            font: func.slice(1) as Slice1<FontCommands>,
+            font: func.slice(1) as Slice1<typeof func>,
             body,
         };
     },
+
     htmlBuilder,
     mathmlBuilder,
 });
@@ -72,9 +65,8 @@ defineFunction({
 defineFunction({
     type: "mclass",
     names: ["\\boldsymbol", "\\bm"],
-    props: {
-        numArgs: 1,
-    },
+    numArgs: 1,
+
     handler: ({parser}, args) => {
         const body = args[0];
         // amsbsy.sty's \boldsymbol uses \binrel spacing to inherit the
@@ -100,10 +92,8 @@ defineFunction({
 defineFunction({
     type: "font",
     names: ["\\rm", "\\sf", "\\tt", "\\bf", "\\it", "\\cal"],
-    props: {
-        numArgs: 0,
-        allowedInText: true,
-    },
+    numArgs: 0,
+    allowedInText: true,
     handler: ({parser, funcName, breakOnTokenText}, args) => {
         const {mode} = parser;
         const body = parser.parseExpression(true, breakOnTokenText);
@@ -111,7 +101,7 @@ defineFunction({
         return {
             type: "font",
             mode: mode,
-            font: `math${funcName.slice(1) as Slice1<OldFontCommands>}`,
+            font: `math${funcName.slice(1) as Slice1<typeof funcName>}` as const,
             body: {
                 type: "ordgroup",
                 mode: parser.mode,
@@ -119,6 +109,4 @@ defineFunction({
             },
         };
     },
-    htmlBuilder,
-    mathmlBuilder,
 });

package/src/functions/genfrac.ts

@@ -2,7 +2,7 @@ import defineFunction, {normalizeArgument} from "../defineFunction";
 import {makeLineSpan, makeSpan, makeVList} from "../buildCommon";
 import {makeCustomSizedDelim} from "../delimiter";
 import {MathNode, TextNode} from "../mathMLTree";
-import type {ParseNode} from "../parseNode";
+import type {ParseNode} from "../types/nodes";
 import Style from "../Style";
 import {assertNodeType} from "../parseNode";
 import * as html from "../buildHTML";
@@ -239,10 +239,9 @@ defineFunction({
         "\\\\atopfrac", // can’t be entered directly
         "\\\\bracefrac", "\\\\brackfrac",   // ditto
     ],
-    props: {
-        numArgs: 2,
-        allowedInArgument: true,
-    },
+    numArgs: 2,
+    allowedInArgument: true,
+
     handler: ({parser, funcName}, args) => {
         const numer = args[0];
         const denom = args[1];
@@ -302,6 +301,7 @@ defineFunction({
         }, style);
     },
 
+
     htmlBuilder,
     mathmlBuilder,
 });
@@ -311,10 +311,9 @@ defineFunction({
 defineFunction({
     type: "infix",
     names: ["\\over", "\\choose", "\\atop", "\\brace", "\\brack"],
-    props: {
-        numArgs: 0,
-        infix: true,
-    },
+    numArgs: 0,
+    infix: true,
+
     handler({parser, funcName, token}) {
         let replaceWith;
         switch (funcName) {
@@ -359,11 +358,10 @@ const delimFromValue = function(delimString: string): string | null {
 defineFunction({
     type: "genfrac",
     names: ["\\genfrac"],
-    props: {
-        numArgs: 6,
-        allowedInArgument: true,
-        argTypes: ["math", "math", "size", "text", "math", "math"],
-    },
+    numArgs: 6,
+    allowedInArgument: true,
+    argTypes: ["math", "math", "size", "text", "math", "math"],
+
     handler({parser}, args) {
         const numer = args[4];
         const denom = args[5];
@@ -420,11 +418,10 @@ defineFunction({
 defineFunction({
     type: "infix",
     names: ["\\above"],
-    props: {
-        numArgs: 1,
-        argTypes: ["size"],
-        infix: true,
-    },
+    numArgs: 1,
+    argTypes: ["size"],
+    infix: true,
+
     handler({parser, funcName, token}, args) {
         return {
             type: "infix",
@@ -439,10 +436,9 @@ defineFunction({
 defineFunction({
     type: "genfrac",
     names: ["\\\\abovefrac"],
-    props: {
-        numArgs: 3,
-        argTypes: ["math", "size", "math"],
-    },
+    numArgs: 3,
+    argTypes: ["math", "size", "math"],
+
     handler: ({parser, funcName}, args) => {
         const numer = args[0];
         const barSize = assertNodeType(args[1], "infix").size;