katex 0.17.0 → 0.18.0

package/src/functions/symbolsSpacing.ts

@@ -4,35 +4,34 @@ import {MathNode, TextNode} from "../mathMLTree";
 import ParseError from "../ParseError";
 
 // A map of CSS-based spacing functions to their CSS class.
-const cssSpace: Record<string, string> = {
-    "\\nobreak": "nobreak",
-    "\\allowbreak": "allowbreak",
-};
+const cssSpace = new Map<string, string>([
+    ["\\nobreak", "nobreak"],
+    ["\\allowbreak", "allowbreak"],
+]);
 
 // A lookup table to determine whether a spacing function/symbol should be
 // treated like a regular space character.  If a symbol or command is a key
 // in this table, then it should be a regular space character.  Furthermore,
 // the associated value may have a `className` specifying an extra CSS class
 // to add to the created `span`.
-const regularSpace: Record<string, {className?: string}> = {
-    " ": {},
-    "\\ ": {},
-    "~": {
-        className: "nobreak",
-    },
-    "\\space": {},
-    "\\nobreakspace": {
-        className: "nobreak",
-    },
-};
+const regularSpace = new Map<string, {className?: string}>([
+    [" ", {}],
+    ["\\ ", {}],
+    ["~", {className: "nobreak"}],
+    ["\\space", {}],
+    ["\\nobreakspace", {className: "nobreak"}],
+]);
 
 // ParseNode<"spacing"> created in Parser.js from the "spacing" symbol Groups in
 // src/symbols.js.
 defineFunctionBuilders({
     type: "spacing",
     htmlBuilder(group, options) {
-        if (regularSpace.hasOwnProperty(group.text)) {
-            const className = regularSpace[group.text].className || "";
+        const regularSpaceItem = regularSpace.get(group.text);
+        const cssSpaceClass = cssSpace.get(group.text);
+
+        if (regularSpaceItem) {
+            const className = regularSpaceItem.className || "";
             // Spaces are generated by adding an actual space. Each of these
             // things has an entry in the symbols table, so these will be turned
             // into appropriate outputs.
@@ -45,10 +44,10 @@ defineFunctionBuilders({
                     [mathsym(group.text, group.mode, options)],
                     options);
             }
-        } else if (cssSpace.hasOwnProperty(group.text)) {
+        } else if (cssSpaceClass) {
             // Spaces based on just a CSS class.
             return makeSpan(
-                ["mspace", cssSpace[group.text]],
+                ["mspace", cssSpaceClass],
                 [], options);
         } else {
             throw new ParseError(`Unknown type of space "${group.text}"`);
@@ -57,10 +56,10 @@ defineFunctionBuilders({
     mathmlBuilder(group, options) {
         let node;
 
-        if (regularSpace.hasOwnProperty(group.text)) {
+        if (regularSpace.has(group.text)) {
             node = new MathNode(
                 "mtext", [new TextNode("\u00a0")]);
-        } else if (cssSpace.hasOwnProperty(group.text)) {
+        } else if (cssSpace.has(group.text)) {
             // CSS-based MathML spaces (\nobreak, \allowbreak) are ignored
             return new MathNode("mspace");
         } else {

package/src/functions/underline.ts

@@ -40,7 +40,7 @@ defineFunction({
             ],
         }, options);
 
-        return makeSpan(["mord", "underline"], [vlist], options);
+        return makeSpan(["mord", "katex-underline"], [vlist], options);
     },
     mathmlBuilder(group, options) {
         const operator = new MathNode(

package/src/macros.ts

@@ -14,7 +14,7 @@ import symbols from "./symbols";
 import {makeEm} from "./units";
 import ParseError from "./ParseError";
 
-import type {MacroContextInterface} from "./defineMacro";
+import type {MacroContextInterface, MacroExpansion} from "./defineMacro";
 
 //////////////////////////////////////////////////////////////////////
 // macro tools
@@ -916,7 +916,7 @@ defineMacro("\\ket", "\\mathinner{|{#1}\\rangle}");
 defineMacro("\\braket", "\\mathinner{\\langle{#1}\\rangle}");
 defineMacro("\\Bra", "\\left\\langle#1\\right|");
 defineMacro("\\Ket", "\\left|#1\\right\\rangle");
-const braketHelper = (one: boolean) => (context: MacroContextInterface) => {
+const braketHelper = (one: boolean) => (context: MacroContextInterface): MacroExpansion => {
     const left = context.consumeArg().tokens;
     const middle = context.consumeArg().tokens;
     const middleDouble = context.consumeArg().tokens;
@@ -924,7 +924,7 @@ const braketHelper = (one: boolean) => (context: MacroContextInterface) => {
     const oldMiddle = context.macros.get("|");
     const oldMiddleDouble = context.macros.get("\\|");
     context.macros.beginGroup();
-    const midMacro = (double: boolean) => (context: MacroContextInterface) => {
+    const midMacro = (double: boolean) => (context: MacroContextInterface): MacroExpansion => {
         if (one) {
             // Only modify the first instance of | or \|
             context.macros.set("|", oldMiddle);

package/src/mathMLTree.ts

@@ -83,10 +83,8 @@ export class MathNode implements MathDomNode {
         const node = document.createElementNS(
             "http://www.w3.org/1998/Math/MathML", this.type);
 
-        for (const attr in this.attributes) {
-            if (Object.prototype.hasOwnProperty.call(this.attributes, attr)) {
-                node.setAttribute(attr, this.attributes[attr]);
-            }
+        for (const [attr, value] of Object.entries(this.attributes)) {
+            node.setAttribute(attr, value);
         }
 
         if (this.classes.length > 0) {
@@ -118,12 +116,10 @@ export class MathNode implements MathDomNode {
         let markup = "<" + this.type;
 
         // Add the attributes
-        for (const attr in this.attributes) {
-            if (Object.prototype.hasOwnProperty.call(this.attributes, attr)) {
-                markup += " " + attr + "=\"";
-                markup += escape(this.attributes[attr]);
-                markup += "\"";
-            }
+        for (const [attr, value] of Object.entries(this.attributes)) {
+            markup += " " + attr + "=\"";
+            markup += escape(value);
+            markup += "\"";
         }
 
         if (this.classes.length > 0) {

package/src/parseNode.ts

@@ -1,4 +1,4 @@
-import {NON_ATOMS} from "./atoms";
+import {NonAtoms} from "./atoms";
 import type {AnyParseNode, NodeType, ParseNode, SymbolParseNode} from "./types/nodes";
 
 /**
@@ -22,7 +22,7 @@ export function assertNodeType<NODETYPE extends NodeType>(
  * Returns the node more strictly typed iff it is of the given type. Otherwise,
  * returns null.
  */
-export function assertSymbolNodeType(node: AnyParseNode | null | undefined): SymbolParseNode {
+export function assertSymbolNodeType(node: AnyParseNode): SymbolParseNode {
     const typedNode = checkSymbolNodeType(node);
     if (!typedNode) {
         throw new Error(
@@ -36,8 +36,8 @@ export function assertSymbolNodeType(node: AnyParseNode | null | undefined): Sym
  * Returns the node more strictly typed if it is of the given type. Otherwise,
  * returns null.
  */
-export function checkSymbolNodeType(node: AnyParseNode | null | undefined): SymbolParseNode | null | undefined {
-    if (node && (node.type === "atom" || NON_ATOMS.hasOwnProperty(node.type))) {
+export function checkSymbolNodeType(node: AnyParseNode): SymbolParseNode | null {
+    if (node.type === "atom" || NonAtoms.has(node.type)) {
         return node as SymbolParseNode;
     }
     return null;

package/src/stretchy.ts

@@ -277,7 +277,7 @@ export const stretchySvg = function(
             }
 
             return {
-                span: makeSpan(["stretchy"], spans, options),
+                span: makeSpan(["katex-stretchy"], spans, options),
                 minWidth,
                 height,
             };
@@ -308,7 +308,7 @@ export const stretchyEnclose = function(
     const totalHeight = inner.height + inner.depth + topPad + bottomPad;
 
     if (/fbox|color|angl/.test(label)) {
-        img = makeSpan(["stretchy", label], [], options);
+        img = makeSpan(["katex-stretchy", label], [], options);
 
         if (label === "fbox") {
             const color = options.color && options.getColor();

package/src/styles/katex.scss

@@ -58,13 +58,13 @@ $display-margin: 1em 0 !default;
     }
 
     .katex-html {
-        /* \newline is an empty block at top level, between .base elements */
-        > .newline {
+        /* \newline is an empty block at top level, between .katex-base elements */
+        > .katex-newline {
             display: block;
         }
     }
 
-    .base {
+    .katex-base {
         position: relative;
         display: inline-block;
         white-space: nowrap;
@@ -73,7 +73,7 @@ $display-margin: 1em 0 !default;
         width: min-content;
     }
 
-    .strut {
+    .katex-strut {
         display: inline-block;
     }
 
@@ -242,19 +242,13 @@ $display-margin: 1em 0 !default;
         min-width: 2px;
     }
 
-    .vbox {
+    .katex-vbox {
         display: inline-flex;
         flex-direction: column;
         align-items: baseline;
     }
 
-    .hbox {
-        display: inline-flex;
-        flex-direction: row;
-        width: 100%;
-    }
-
-    .thinbox {
+    .katex-thinbox {
         display: inline-flex;
         flex-direction: row;
         width: 0;
@@ -279,11 +273,11 @@ $display-margin: 1em 0 !default;
 
     // Prevent Chrome from disappearing frac-lines, rules, etc.
     .mfrac .frac-line,
-    .overline .overline-line,
-    .underline .underline-line,
-    .hline,
-    .hdashline,
-    .rule {
+    .katex-overline .overline-line,
+    .katex-underline .underline-line,
+    .katex-hline,
+    .katex-hdashline,
+    .katex-rule {
         min-height: 1px;
     }
 
@@ -291,7 +285,7 @@ $display-margin: 1em 0 !default;
         display: inline-block;
     }
 
-    .smash {
+    .katex-smash {
         display: inline;
         line-height: 0;
     }
@@ -302,51 +296,51 @@ $display-margin: 1em 0 !default;
         width: 0;
         position: relative;
 
-        > .inner {
+        > .katex-inner {
             position: absolute;
         }
 
-        > .fix {
+        > .katex-fix {
             display: inline-block;
         }
     }
 
-    .llap > .inner {
+    .llap > .katex-inner {
         right: 0;
     }
 
-    .rlap > .inner,
-    .clap > .inner {
+    .rlap > .katex-inner,
+    .clap > .katex-inner {
         left: 0;
     }
 
-    .clap > .inner > span {
+    .clap > .katex-inner > span {
         margin-left: -50%;
         margin-right: 50%;
     }
 
-    .rule {
+    .katex-rule {
         display: inline-block;
         border: solid 0;
         position: relative;
     }
 
-    .overline .overline-line,
-    .underline .underline-line,
-    .hline {
+    .katex-overline .overline-line,
+    .katex-underline .underline-line,
+    .katex-hline {
         display: inline-block;
         width: 100%;
         border-bottom-style: solid;
     }
 
-    .hdashline {
+    .katex-hdashline {
         display: inline-block;
         width: 100%;
         border-bottom-style: dashed;
     }
 
     .sqrt {
-        > .root {
+        > .katex-root {
             /* These values are taken from the definition of `\r@@t`,
              `\mkern 5mu` and `\mkern -10mu`. */
             /* stylelint-disable-next-line declaration-property-value-no-unknown */
@@ -356,7 +350,7 @@ $display-margin: 1em 0 !default;
         }
     }
 
-    .sizing,
+    .katex-sizing,
     .fontsize-ensurer {
         $sizes: 0.5, 0.6, 0.7, 0.8, 0.9, 1, 1.2, 1.44, 1.728, 2.074, 2.488;
 
@@ -414,7 +408,7 @@ $display-margin: 1em 0 !default;
         }
     }
 
-    .accent {
+    .katex-accent {
         > .vlist-t {
             text-align: center;
         }
@@ -430,7 +424,7 @@ $display-margin: 1em 0 !default;
         }
     }
 
-    .overlay {
+    .katex-overlay {
         display: block;
     }
 
@@ -503,7 +497,7 @@ $display-margin: 1em 0 !default;
     }
 
     // Define CSS for image whose width will match its span width.
-    .stretchy {
+    .katex-stretchy {
         width: 100%;
         display: block;
         position: relative;
@@ -591,7 +585,7 @@ $display-margin: 1em 0 !default;
         margin-right: -0.2em;   // Apply negative margin to correct for 0.2em padding
     }                           // inside the \cancel group.
 
-    .sout {
+    .katex-sout {
         border-bottom-style: solid;
         border-bottom-width: 0.08em;
     }
@@ -656,7 +650,7 @@ $display-margin: 1em 0 !default;
             display: block;
             position: relative;
 
-            > .tag {
+            > .katex-tag {
                 position: absolute;
                 right: 0;
             }
@@ -665,7 +659,7 @@ $display-margin: 1em 0 !default;
 }
 
 // Left-justified tags (default is right-justified)
-.katex-display.leqno > .katex > .katex-html > .tag {
+.katex-display.leqno > .katex > .katex-html > .katex-tag {
     left: 0;
     right: auto;
 }

package/src/wide-character.ts

@@ -110,7 +110,7 @@ const wideLatinLetterData = [
     italicSansSerif, italicSansSerif, // A-Z, a-z
     noFont, noFont,           // A-Z bold italic sans, a-z bold italic sans - no font
     monospace, monospace,     // A-Z, a-z
-] as const;
+] as const satisfies readonly WideChar[];
 
 const wideNumeralData = [
     boldUpright,      // 0-9
@@ -118,7 +118,7 @@ const wideNumeralData = [
     sansSerif,        // 0-9
     boldSansSerif,   // 0-9
     monospace,       // 0-9
-] as const;
+] as const satisfies readonly WideChar[];
 
 export const wideCharacterFont = (
     wideChar: string,