@khanacademy/math-input 4.1.1 → 4.2.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @khanacademy/math-input
 
+## 4.2.0
+
+### Minor Changes
+
+-   d497118e: MathInput exports tools for generating MathFields, replacing the need for direct MathQuill access
+
+### Patch Changes
+
+-   e7d21b67: Add keypress logic from MathInput to key translator
+-   eceb4510: Updated aria-labels to be more descriptive and tests that used aria-labels.
+
 ## 4.1.1
 
 ### Patch Changes

package/dist/components/input/math-wrapper.d.ts

@@ -9,7 +9,7 @@ import { MathFieldInterface, MathFieldCursor } from "./mathquill-types";
 declare class MathWrapper {
     mathField: MathFieldInterface;
     callbacks: any;
-    constructor(element: any, options?: {}, callbacks?: {});
+    constructor(element: any, callbacks?: {});
     focus(): void;
     blur(): void;
     /**

package/dist/components/input/math-wrapper.js.flow

@@ -17,7 +17,7 @@ import { MathFieldInterface, MathFieldCursor } from "./mathquill-types";
 declare class MathWrapper {
   mathField: MathFieldInterface;
   callbacks: any;
-  constructor(element: any, options?: {||}, callbacks?: {||}): this;
+  constructor(element: any, callbacks?: {||}): this;
   focus(): void;
   blur(): void;
 

package/dist/components/input/mathquill-instance.d.ts

@@ -1,3 +1,14 @@
-import { MathQuillInterface } from "./mathquill-types";
-declare const _default: MathQuillInterface;
-export default _default;
+import { MathQuillInterface, MathFieldConfig } from "./mathquill-types";
+export declare const mathQuillInstance: MathQuillInterface;
+/**
+ * Creates a new [MathField](http://docs.mathquill.com/en/latest/Api_Methods/#mqmathfieldhtml_element-config)
+ * instance within the given `container`.
+ *
+ * An optional configuration callback can be provided to customize
+ * the created MathField. A default configuration is passed to this
+ * callback which can then be adjusted as needed. The configuration
+ * returned from this callback is used to create the MathField.
+ * This allows callers to do minimal configuration as only configs
+ * that vary from the default need to be provided.
+ */
+export declare function createMathField(container: HTMLDivElement | HTMLSpanElement, configCallback?: (baseConfig: MathFieldConfig) => MathFieldConfig): import("./mathquill-types").MathFieldInterface;

package/dist/components/input/mathquill-instance.js.flow

@@ -4,6 +4,21 @@
  * Flowgen v1.21.0
  * @flow
  */
-import { MathQuillInterface } from "./mathquill-types";
-declare var _default: MathQuillInterface;
-declare export default typeof _default;
+import * as $Flowgen$Import$_2e__2f_mathquill_2d_types from "./mathquill-types";
+import { MathQuillInterface, MathFieldConfig } from "./mathquill-types";
+declare export var mathQuillInstance: MathQuillInterface;
+/**
+ * Creates a new [MathField](http://docs.mathquill.com/en/latest/Api_Methods/#mqmathfieldhtml_element-config)
+ * instance within the given `container`.
+ *
+ * An optional configuration callback can be provided to customize
+ * the created MathField. A default configuration is passed to this
+ * callback which can then be adjusted as needed. The configuration
+ * returned from this callback is used to create the MathField.
+ * This allows callers to do minimal configuration as only configs
+ * that vary from the default need to be provided.
+ */
+declare export function createMathField(
+  container: HTMLDivElement | HTMLSpanElement,
+  configCallback?: (baseConfig: MathFieldConfig) => MathFieldConfig
+): $Flowgen$Import$_2e__2f_mathquill_2d_types.MathFieldInterface;

package/dist/components/input/mathquill-types.d.ts

@@ -2,13 +2,34 @@ import Key from "../../data/keys";
 export interface MathQuillInterface {
     L: "L";
     R: "R";
-    MathField: (mount: HTMLDivElement, options: any) => MathFieldInterface;
+    MathField: (mount: HTMLDivElement | HTMLSpanElement, config: MathFieldConfig) => MathFieldInterface;
 }
+type MathQuillDir = "L" | "R";
+export type MathFieldConfig = {
+    spaceBehavesLikeTab?: boolean;
+    leftRightIntoCmdGoes?: string;
+    restrictMismatchedBrackets?: boolean;
+    sumStartsWithNEquals?: boolean;
+    supSubsRequireOperand?: boolean;
+    charsThatBreakOutOfSupSub?: string;
+    autoSubscriptNumerals?: boolean;
+    autoCommands?: string;
+    autoOperatorNames?: string;
+    maxDepth?: number;
+    substituteTextarea?: () => HTMLElement;
+    handlers?: {
+        edit?: (mathField: MathFieldInterface) => void;
+        upOutOf?: (mathField: MathFieldInterface) => void;
+        moveOutOf?: (dir: MathQuillDir, mathField: MathFieldInterface) => void;
+    };
+};
 export interface MathFieldInterface {
-    write: (input: string) => void;
-    cmd: (input: string) => void;
-    keystroke: (input: string) => void;
-    typedText: (input: string) => void;
+    focus: () => MathFieldInterface;
+    blur: () => MathFieldInterface;
+    write: (input: string) => MathFieldInterface;
+    cmd: (input: string) => MathFieldInterface;
+    keystroke: (input: string) => MathFieldInterface;
+    typedText: (input: string) => MathFieldInterface;
     latex: (input?: string) => string;
     moveToDirEnd: (direction: "L" | "R") => void;
     select: () => void;
@@ -22,4 +43,5 @@ export declare enum MathFieldActionType {
     MQ_END = 0
 }
 export type MathFieldCursor = any;
-export type MathQuillUpdaterCallback = (mathQuill: MathFieldInterface, key: Key) => void;
+export type MathFieldUpdaterCallback = (mathField: MathFieldInterface, key: Key) => void;
+export {};

package/dist/components/input/mathquill-types.js.flow

@@ -8,13 +8,37 @@ import Key from "../../data/keys";
 export interface MathQuillInterface {
   L: "L";
   R: "R";
-  MathField: (mount: HTMLDivElement, options: any) => MathFieldInterface;
+  MathField: (
+    mount: HTMLDivElement | HTMLSpanElement,
+    config: MathFieldConfig
+  ) => MathFieldInterface;
 }
+declare type MathQuillDir = "L" | "R";
+export type MathFieldConfig = {|
+  spaceBehavesLikeTab?: boolean,
+  leftRightIntoCmdGoes?: string,
+  restrictMismatchedBrackets?: boolean,
+  sumStartsWithNEquals?: boolean,
+  supSubsRequireOperand?: boolean,
+  charsThatBreakOutOfSupSub?: string,
+  autoSubscriptNumerals?: boolean,
+  autoCommands?: string,
+  autoOperatorNames?: string,
+  maxDepth?: number,
+  substituteTextarea?: () => HTMLElement,
+  handlers?: {|
+    edit?: (mathField: MathFieldInterface) => void,
+    upOutOf?: (mathField: MathFieldInterface) => void,
+    moveOutOf?: (dir: MathQuillDir, mathField: MathFieldInterface) => void,
+  |},
+|};
 export interface MathFieldInterface {
-  write: (input: string) => void;
-  cmd: (input: string) => void;
-  keystroke: (input: string) => void;
-  typedText: (input: string) => void;
+  focus: () => MathFieldInterface;
+  blur: () => MathFieldInterface;
+  write: (input: string) => MathFieldInterface;
+  cmd: (input: string) => MathFieldInterface;
+  keystroke: (input: string) => MathFieldInterface;
+  typedText: (input: string) => MathFieldInterface;
   latex: (input?: string) => string;
   moveToDirEnd: (direction: "L" | "R") => void;
   select: () => void;
@@ -28,7 +52,7 @@ declare export var MathFieldActionType: {|
   +MQ_END: 0, // 0
 |};
 export type MathFieldCursor = any;
-export type MathQuillUpdaterCallback = (
-  mathQuill: MathFieldInterface,
+export type MathFieldUpdaterCallback = (
+  mathField: MathFieldInterface,
   key: Key
 ) => void;

package/dist/components/key-handlers/handle-arrow.d.ts

@@ -0,0 +1,3 @@
+import Key from "../../data/keys";
+import { MathFieldInterface } from "../input/mathquill-types";
+export default function handleArrow(mathField: MathFieldInterface, key: Key): void;

package/dist/components/{input/key-handlers → key-handlers}/handle-arrow.js.flow

@@ -4,8 +4,8 @@
  * Flowgen v1.21.0
  * @flow
  */
-import Key from "../../../data/keys";
-import { MathFieldInterface } from "../mathquill-types";
+import Key from "../../data/keys";
+import { MathFieldInterface } from "../input/mathquill-types";
 declare export default function handleArrow(
   mathField: MathFieldInterface,
   key: Key

package/dist/components/{input/key-handlers → key-handlers}/handle-backspace.d.ts

@@ -1,4 +1,4 @@
-import { MathFieldInterface } from "../mathquill-types";
+import { MathFieldInterface } from "../input/mathquill-types";
 /**
  * Selects and deletes part of the expression based on the cursor location.
  * See inline comments for precise behavior of different cases.

package/dist/components/{input/key-handlers → key-handlers}/handle-backspace.js.flow

@@ -4,7 +4,7 @@
  * Flowgen v1.21.0
  * @flow
  */
-import { MathFieldInterface } from "../mathquill-types";
+import { MathFieldInterface } from "../input/mathquill-types";
 
 /**
  * Selects and deletes part of the expression based on the cursor location.

package/dist/components/key-handlers/handle-exponent.d.ts

@@ -0,0 +1,3 @@
+import Key from "../../data/keys";
+import { MathFieldInterface } from "../input/mathquill-types";
+export default function handleExponent(mathField: MathFieldInterface, key: Key): void;

package/dist/components/{input/key-handlers → key-handlers}/handle-exponent.js.flow

@@ -4,8 +4,8 @@
  * Flowgen v1.21.0
  * @flow
  */
-import Key from "../../../data/keys";
-import { MathFieldInterface } from "../mathquill-types";
+import Key from "../../data/keys";
+import { MathFieldInterface } from "../input/mathquill-types";
 declare export default function handleExponent(
   mathField: MathFieldInterface,
   key: Key

package/dist/components/{input/key-handlers → key-handlers}/handle-jump-out.d.ts

@@ -1,5 +1,5 @@
-import Key from "../../../data/keys";
-import { MathFieldInterface } from "../mathquill-types";
+import Key from "../../data/keys";
+import { MathFieldInterface } from "../input/mathquill-types";
 /**
  * Advances the cursor to the next logical position.
  */

package/dist/components/{input/key-handlers → key-handlers}/handle-jump-out.js.flow

@@ -4,8 +4,8 @@
  * Flowgen v1.21.0
  * @flow
  */
-import Key from "../../../data/keys";
-import { MathFieldInterface } from "../mathquill-types";
+import Key from "../../data/keys";
+import { MathFieldInterface } from "../input/mathquill-types";
 
 /**
  * Advances the cursor to the next logical position.

package/dist/components/key-handlers/key-translator.d.ts

@@ -0,0 +1,4 @@
+import Key from "../../data/keys";
+import { MathFieldUpdaterCallback } from "../input/mathquill-types";
+declare const keyToMathquillMap: Record<Key, MathFieldUpdaterCallback>;
+export default keyToMathquillMap;

package/dist/components/{key-translator.js.flow → key-handlers/key-translator.js.flow}

@@ -4,7 +4,7 @@
  * Flowgen v1.21.0
  * @flow
  */
-import Key from "../data/keys";
-import { MathQuillUpdaterCallback } from "./input/mathquill-types";
-declare var keyToMathquillMap: { [key: Key]: MathQuillUpdaterCallback };
+import Key from "../../data/keys";
+import { MathFieldUpdaterCallback } from "../input/mathquill-types";
+declare var keyToMathquillMap: { [key: Key]: MathFieldUpdaterCallback };
 declare export default typeof keyToMathquillMap;