@khanacademy/perseus-core 3.1.0 → 3.2.0

package/dist/es/index.js

@@ -40,395 +40,103 @@ const addLibraryVersionToPerseusDebug = (libraryName, libraryVersion) => {
   }
 };
 
-// This file is processed by a Rollup plugin (replace) to inject the production
-const libName = "@khanacademy/perseus-core";
-const libVersion = "3.1.0";
-addLibraryVersionToPerseusDebug(libName, libVersion);
+// Current version.
+var VERSION = '1.13.3';
 
-/**
- * @typedef {Object} Errors utility for referencing the Perseus error taxonomy.
- */
-const Errors = Object.freeze({
-  /**
-   * @property {ErrorKind} Unknown The kind of error is not known.
-   */
-  Unknown: "Unknown",
-  /**
-   * @property {ErrorKind} Internal The error is internal to the executing code.
-   */
-  Internal: "Internal",
-  /**
-   * @property {ErrorKind} InvalidInput There was a problem with the provided
-   * input, such as the wrong format or a null value.
-   */
-  InvalidInput: "InvalidInput",
-  /**
-   * @property {ErrorKind} NotAllowed There was a problem due to the state of
-   * the system not matching the requested operation or input. For example,
-   * trying to create a username that is valid, but is already taken by
-   * another user. Use {@link InvalidInput} instead when the input isn't
-   * valid regardless of the state of the system. Use {@link NotFound} when
-   * the failure is due to not being able to find a resource.
-   */
-  NotAllowed: "NotAllowed",
-  /**
-   * @property {ErrorKind} TransientService There was a problem when making a
-   * request to a service.
-   */
-  TransientService: "TransientService",
-  /**
-   * @property {ErrorKind} Service There was a non-transient problem when
-   * making a request to service.
-   */
-  Service: "Service"
-});
+// Establish the root object, `window` (`self`) in the browser, `global`
+// on the server, or `this` in some virtual machines. We use `self`
+// instead of `window` for `WebWorker` support.
+var root = (typeof self == 'object' && self.self === self && self) ||
+          (typeof global == 'object' && global.global === global && global) ||
+          Function('return this')() ||
+          {};
 
-/**
- * @type {ErrorKind} The kind of error being reported
- */
+// Save bytes in the minified (but not gzipped) version:
+var ArrayProto = Array.prototype, ObjProto = Object.prototype;
+var SymbolProto = typeof Symbol !== 'undefined' ? Symbol.prototype : null;
 
-class PerseusError extends Error {
-  constructor(message, kind, options) {
-    super(message);
-    this.kind = void 0;
-    this.metadata = void 0;
-    this.kind = kind;
-    this.metadata = options == null ? void 0 : options.metadata;
-  }
-}
+// Create quick reference variables for speed access to core prototypes.
+var push = ArrayProto.push,
+    slice = ArrayProto.slice,
+    toString = ObjProto.toString,
+    hasOwnProperty = ObjProto.hasOwnProperty;
 
-/**
- * The Perseus "data schema" file.
- *
- * This file, and the types in it, represents the "data schema" that Perseus
- * uses. The @khanacademy/perseus-editor package edits and produces objects
- * that conform to the types in this file. Similarly, the top-level renderers
- * in @khanacademy/perseus, consume objects that conform to these types.
- *
- * WARNING: This file should not import any types from elsewhere so that it is
- * easy to reason about changes that alter the Perseus schema. This helps
- * ensure that it is not changed accidentally when upgrading a dependant
- * package or other part of Perseus code. Note that TypeScript does type
- * checking via something called "structural typing". This means that as long
- * as the shape of a type matches, the name it goes by doesn't matter. As a
- * result, a `Coord` type that looks like this `[x: number, y: number]` is
- * _identical_, in TypeScript's eyes, to this `Vector2` type `[x: number, y:
- * number]`. Also, with tuples, the labels for each entry is ignored, so `[x:
- * number, y: number]` is compatible with `[min: number, max: number]`. The
- * labels are for humans, not TypeScript. :)
- *
- * If you make changes to types in this file, be very sure that:
- *
- *   a) the changes are backwards compatible. If they are not, old data from
- *      previous versions of the "schema" could become unrenderable, or worse,
- *      introduce hard-to-diagnose bugs.
- *   b) the parsing code (`util/parse-perseus-json/`) is updated to handle
- *      the new format _as well as_ the old format.
- */
+// Modern feature detection.
+var supportsArrayBuffer = typeof ArrayBuffer !== 'undefined',
+    supportsDataView = typeof DataView !== 'undefined';
 
-// TODO(FEI-4010): Remove `Perseus` prefix for all types here
+// All **ECMAScript 5+** native function implementations that we hope to use
+// are declared here.
+var nativeIsArray = Array.isArray,
+    nativeKeys = Object.keys,
+    nativeCreate = Object.create,
+    nativeIsView = supportsArrayBuffer && ArrayBuffer.isView;
 
-// Same name as Mafs
+// Create references to these builtin functions because we override them.
+var _isNaN = isNaN,
+    _isFinite = isFinite;
 
-/**
- * Our core set of Perseus widgets.
- *
- * This interface is the basis for "registering" all Perseus widget types.
- * There should be one key/value pair for each supported widget. If you create
- * a new widget, an entry should be added to this interface. Note that this
- * only registers the widget options type, you'll also need to register the
- * widget so that it's available at runtime (@see
- * {@link file://./widgets.ts#registerWidget}).
- *
- * Importantly, the key should be the name that is used in widget IDs. For most
- * widgets that is the same as the widget option's `type` field. In cases where
- * a widget has been deprecated and replaced with the deprecated-standin
- * widget, it should be the original widget type!
- *
- * If you define the widget outside of this package, you can still add the new
- * widget to this interface by writing the following in that package that
- * contains the widget. TypeScript will merge that definition of the
- * `PerseusWidgets` with the one defined below.
- *
- * ```typescript
- * declare module "@khanacademy/perseus" {
- *     interface PerseusWidgetTypes {
- *         // A new widget
- *         "new-awesomeness": MyAwesomeNewWidget;
- *
- *         // A deprecated widget
- *         "super-old-widget": DeprecatedStandinWidget;
- *     }
- * }
- *
- * // The new widget's options definition
- * type MyAwesomeNewWidget = WidgetOptions<'new-awesomeness', MyAwesomeNewWidgetOptions>;
- *
- * // The deprecated widget's options definition
- * type SuperOldWidget = WidgetOptions<'super-old-widget', object>;
- * ```
- *
- * This interface can be extended through the magic of TypeScript "Declaration
- * merging". Specifically, we augment this module and extend this interface.
- *
- * @see {@link https://www.typescriptlang.org/docs/handbook/declaration-merging.html#module-augmentation}
- */
+// Keys in IE < 9 that won't be iterated by `for key in ...` and thus missed.
+var hasEnumBug = !{toString: null}.propertyIsEnumerable('toString');
+var nonEnumerableProps = ['valueOf', 'isPrototypeOf', 'toString',
+  'propertyIsEnumerable', 'hasOwnProperty', 'toLocaleString'];
 
-/**
- * A map of widget IDs to widget options. This is most often used as the type
- * for a set of widgets defined in a `PerseusItem` but can also be useful to
- * represent a function parameter where only `widgets` from a `PerseusItem` are
- * needed. Today Widget IDs are made up of the widget type and an incrementing
- * integer (eg. `interactive-graph 1` or `radio 3`). It is suggested to avoid
- * reading/parsing the widget id to derive any information from it, except in
- * the case of this map.
- *
- * @see {@link PerseusWidgetTypes} additional widgets can be added to this map type
- * by augmenting the PerseusWidgetTypes with new widget types!
- */
+// The largest integer that can be represented exactly.
+var MAX_ARRAY_INDEX = Math.pow(2, 53) - 1;
 
-/**
- * A "PerseusItem" is a classic Perseus item. It is rendered by the
- * `ServerItemRenderer` and the layout is pre-set.
- *
- * To render more complex Perseus items, see the `Item` type in the multi item
- * area.
- */
+// Some functions take a variable number of arguments, or a few expected
+// arguments at the beginning and then a variable number of values to operate
+// on. This helper accumulates all remaining arguments past the function’s
+// argument length (or an explicit `startIndex`), into an array that becomes
+// the last argument. Similar to ES6’s "rest parameter".
+function restArguments(func, startIndex) {
+  startIndex = startIndex == null ? func.length - 1 : +startIndex;
+  return function() {
+    var length = Math.max(arguments.length - startIndex, 0),
+        rest = Array(length),
+        index = 0;
+    for (; index < length; index++) {
+      rest[index] = arguments[index + startIndex];
+    }
+    switch (startIndex) {
+      case 0: return func.call(this, rest);
+      case 1: return func.call(this, arguments[0], rest);
+      case 2: return func.call(this, arguments[0], arguments[1], rest);
+    }
+    var args = Array(startIndex + 1);
+    for (index = 0; index < startIndex; index++) {
+      args[index] = arguments[index];
+    }
+    args[startIndex] = rest;
+    return func.apply(this, args);
+  };
+}
 
-/**
- * A "PerseusArticle" is an item that is meant to be rendered as an article.
- * This item is never scored and is rendered by the `ArticleRenderer`.
- */
+// Is a given variable an object?
+function isObject(obj) {
+  var type = typeof obj;
+  return type === 'function' || (type === 'object' && !!obj);
+}
 
-const ItemExtras = [
-// The user might benefit from using a Scientific Calculator.  Provided on Khan Academy when true
-"calculator",
-// The user might benefit from using a statistics Chi Squared Table like https://people.richland.edu/james/lecture/m170/tbl-chi.html
-"chi2Table",
-// The user might benefit from a monthly payments calculator.  Provided on Khan Academy when true
-"financialCalculatorMonthlyPayment",
-// The user might benefit from a total amount calculator.  Provided on Khan Academy when true
-"financialCalculatorTotalAmount",
-// The user might benefit from a time to pay off calculator.  Provided on Khan Academy when true
-"financialCalculatorTimeToPayOff",
-// The user might benefit from using a Periodic Table of Elements.  Provided on Khan Academy when true
-"periodicTable",
-// The user might benefit from using a Periodic Table of Elements with key.  Provided on Khan Academy when true
-"periodicTableWithKey",
-// The user might benefit from using a statistics T Table like https://www.statisticshowto.com/tables/t-distribution-table/
-"tTable",
-// The user might benefit from using a statistics Z Table like https://www.ztable.net/
-"zTable"];
+// Is a given value equal to null?
+function isNull(obj) {
+  return obj === null;
+}
 
-/**
- * The type representing the common structure of all widget's options. The
- * `Options` generic type represents the widget-specific option data.
- */
+// Is a given variable undefined?
+function isUndefined(obj) {
+  return obj === void 0;
+}
 
-// prettier-ignore
+// Is a given value a boolean?
+function isBoolean(obj) {
+  return obj === true || obj === false || toString.call(obj) === '[object Boolean]';
+}
 
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-// prettier-ignore
-
-//prettier-ignore
-
-/**
- * A background image applied to various widgets.
- */
-
-/**
- * The type of markings to display on the graph.
- * - axes: shows the axes without the gride lines
- * - graph: shows the axes and the grid lines
- * - grid: shows only the grid lines
- * - none: shows no markings
- */
-
-const PerseusExpressionAnswerFormConsidered = ["correct", "wrong", "ungraded"];
-
-// 2D range: xMin, xMax, yMin, yMax
-
-const lockedFigureColorNames = ["blue", "green", "grayH", "purple", "pink", "orange", "red"];
-const lockedFigureColors = {
-  blue: "#3D7586",
-  green: "#447A53",
-  grayH: "#3B3D45",
-  purple: "#594094",
-  pink: "#B25071",
-  red: "#D92916",
-  orange: "#946700"
-};
-const lockedFigureFillStyles = {
-  none: 0,
-  white: 1,
-  translucent: 0.4,
-  solid: 1
-};
-
-// Not associated with a specific figure
-
-const plotterPlotTypes = ["bar", "line", "pic", "histogram", "dotplot"];
-
-// Current version.
-var VERSION = '1.13.3';
-
-// Establish the root object, `window` (`self`) in the browser, `global`
-// on the server, or `this` in some virtual machines. We use `self`
-// instead of `window` for `WebWorker` support.
-var root = (typeof self == 'object' && self.self === self && self) ||
-          (typeof global == 'object' && global.global === global && global) ||
-          Function('return this')() ||
-          {};
-
-// Save bytes in the minified (but not gzipped) version:
-var ArrayProto = Array.prototype, ObjProto = Object.prototype;
-var SymbolProto = typeof Symbol !== 'undefined' ? Symbol.prototype : null;
-
-// Create quick reference variables for speed access to core prototypes.
-var push = ArrayProto.push,
-    slice = ArrayProto.slice,
-    toString = ObjProto.toString,
-    hasOwnProperty = ObjProto.hasOwnProperty;
-
-// Modern feature detection.
-var supportsArrayBuffer = typeof ArrayBuffer !== 'undefined',
-    supportsDataView = typeof DataView !== 'undefined';
-
-// All **ECMAScript 5+** native function implementations that we hope to use
-// are declared here.
-var nativeIsArray = Array.isArray,
-    nativeKeys = Object.keys,
-    nativeCreate = Object.create,
-    nativeIsView = supportsArrayBuffer && ArrayBuffer.isView;
-
-// Create references to these builtin functions because we override them.
-var _isNaN = isNaN,
-    _isFinite = isFinite;
-
-// Keys in IE < 9 that won't be iterated by `for key in ...` and thus missed.
-var hasEnumBug = !{toString: null}.propertyIsEnumerable('toString');
-var nonEnumerableProps = ['valueOf', 'isPrototypeOf', 'toString',
-  'propertyIsEnumerable', 'hasOwnProperty', 'toLocaleString'];
-
-// The largest integer that can be represented exactly.
-var MAX_ARRAY_INDEX = Math.pow(2, 53) - 1;
-
-// Some functions take a variable number of arguments, or a few expected
-// arguments at the beginning and then a variable number of values to operate
-// on. This helper accumulates all remaining arguments past the function’s
-// argument length (or an explicit `startIndex`), into an array that becomes
-// the last argument. Similar to ES6’s "rest parameter".
-function restArguments(func, startIndex) {
-  startIndex = startIndex == null ? func.length - 1 : +startIndex;
-  return function() {
-    var length = Math.max(arguments.length - startIndex, 0),
-        rest = Array(length),
-        index = 0;
-    for (; index < length; index++) {
-      rest[index] = arguments[index + startIndex];
-    }
-    switch (startIndex) {
-      case 0: return func.call(this, rest);
-      case 1: return func.call(this, arguments[0], rest);
-      case 2: return func.call(this, arguments[0], arguments[1], rest);
-    }
-    var args = Array(startIndex + 1);
-    for (index = 0; index < startIndex; index++) {
-      args[index] = arguments[index];
-    }
-    args[startIndex] = rest;
-    return func.apply(this, args);
-  };
-}
-
-// Is a given variable an object?
-function isObject(obj) {
-  var type = typeof obj;
-  return type === 'function' || (type === 'object' && !!obj);
-}
-
-// Is a given value equal to null?
-function isNull(obj) {
-  return obj === null;
-}
-
-// Is a given variable undefined?
-function isUndefined(obj) {
-  return obj === void 0;
-}
-
-// Is a given value a boolean?
-function isBoolean(obj) {
-  return obj === true || obj === false || toString.call(obj) === '[object Boolean]';
-}
-
-// Is a given value a DOM element?
-function isElement(obj) {
-  return !!(obj && obj.nodeType === 1);
-}
+// Is a given value a DOM element?
+function isElement(obj) {
+  return !!(obj && obj.nodeType === 1);
+}
 
 // Internal function for creating a `toString`-based type tester.
 function tagTester(name) {
@@ -2356,6 +2064,812 @@ var _ = mixin(allExports);
 // Legacy Node.js API.
 _._ = _;
 
+function getMatrixSize(matrix) {
+  const matrixSize = [1, 1];
+
+  // We need to find the widest row and tallest column to get the correct
+  // matrix size.
+  _(matrix).each((matrixRow, row) => {
+    let rowWidth = 0;
+    _(matrixRow).each((matrixCol, col) => {
+      if (matrixCol != null && matrixCol.toString().length) {
+        rowWidth = col + 1;
+      }
+    });
+
+    // Matrix width:
+    matrixSize[1] = Math.max(matrixSize[1], rowWidth);
+
+    // Matrix height:
+    if (rowWidth > 0) {
+      matrixSize[0] = Math.max(matrixSize[0], row + 1);
+    }
+  });
+  return matrixSize;
+}
+
+/**
+ *  Get the character used for separating decimals.
+ */
+const getDecimalSeparator = locale => {
+  var _match$;
+  switch (locale) {
+    // TODO(somewhatabstract): Remove this when Chrome supports the `ka`
+    // locale properly.
+    // https://github.com/formatjs/formatjs/issues/1526#issuecomment-559891201
+    //
+    // Supported locales in Chrome:
+    // https://source.chromium.org/chromium/chromium/src/+/master:third_party/icu/scripts/chrome_ui_languages.list
+    case "ka":
+      return ",";
+    default:
+      const numberWithDecimalSeparator = 1.1;
+      // TODO(FEI-3647): Update to use .formatToParts() once we no longer have to
+      // support Safari 12.
+      const match = new Intl.NumberFormat(locale).format(numberWithDecimalSeparator)
+      // 0x661 is ARABIC-INDIC DIGIT ONE
+      // 0x6F1 is EXTENDED ARABIC-INDIC DIGIT ONE
+      .match(/[^\d\u0661\u06F1]/);
+      return (_match$ = match == null ? void 0 : match[0]) != null ? _match$ : ".";
+  }
+};
+
+/**
+ * APPROXIMATE equality on numbers and primitives.
+ */
+function approximateEqual(x, y) {
+  if (typeof x === "number" && typeof y === "number") {
+    return Math.abs(x - y) < 1e-9;
+  }
+  return x === y;
+}
+
+/**
+ * Deep APPROXIMATE equality on primitives, numbers, arrays, and objects.
+ * Recursive.
+ */
+function approximateDeepEqual(x, y) {
+  if (Array.isArray(x) && Array.isArray(y)) {
+    if (x.length !== y.length) {
+      return false;
+    }
+    for (let i = 0; i < x.length; i++) {
+      if (!approximateDeepEqual(x[i], y[i])) {
+        return false;
+      }
+    }
+    return true;
+  }
+  if (Array.isArray(x) || Array.isArray(y)) {
+    return false;
+  }
+  if (typeof x === "function" && typeof y === "function") {
+    return approximateEqual(x, y);
+  }
+  if (typeof x === "function" || typeof y === "function") {
+    return false;
+  }
+  if (typeof x === "object" && typeof y === "object" && !!x && !!y) {
+    return x === y || _.all(x, function (v, k) {
+      // @ts-expect-error - TS2536 - Type 'CollectionKey<T>' cannot be used to index type 'T'.
+      return approximateDeepEqual(y[k], v);
+    }) && _.all(y, function (v, k) {
+      // @ts-expect-error - TS2536 - Type 'CollectionKey<T>' cannot be used to index type 'T'.
+      return approximateDeepEqual(x[k], v);
+    });
+  }
+  if (typeof x === "object" && !!x || typeof y === "object" && !!y) {
+    return false;
+  }
+  return approximateEqual(x, y);
+}
+
+// TODO(benchristel): in the future, we may want to make deepClone work for
+// Record<string, Cloneable> as well. Currently, it only does arrays.
+
+function deepClone(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map(deepClone);
+  }
+  return obj;
+}
+
+const MOVABLES = {
+  PLOT: "PLOT",
+  PARABOLA: "PARABOLA",
+  SINUSOID: "SINUSOID"
+};
+
+// TODO(charlie): These really need to go into a utility file as they're being
+// used by both interactive-graph and now grapher.
+function canonicalSineCoefficients(coeffs) {
+  // For a curve of the form f(x) = a * Sin(b * x - c) + d,
+  // this function ensures that a, b > 0, and c is its
+  // smallest possible positive value.
+  let amplitude = coeffs[0];
+  let angularFrequency = coeffs[1];
+  let phase = coeffs[2];
+  const verticalOffset = coeffs[3];
+
+  // Guarantee a > 0
+  if (amplitude < 0) {
+    amplitude *= -1;
+    angularFrequency *= -1;
+    phase *= -1;
+  }
+  const period = 2 * Math.PI;
+  // Guarantee b > 0
+  if (angularFrequency < 0) {
+    angularFrequency *= -1;
+    phase *= -1;
+    phase += period / 2;
+  }
+
+  // Guarantee c is smallest possible positive value
+  while (phase > 0) {
+    phase -= period;
+  }
+  while (phase < 0) {
+    phase += period;
+  }
+  return [amplitude, angularFrequency, phase, verticalOffset];
+}
+function canonicalTangentCoefficients(coeffs) {
+  // For a curve of the form f(x) = a * Tan(b * x - c) + d,
+  // this function ensures that a, b > 0, and c is its
+  // smallest possible positive value.
+  let amplitude = coeffs[0];
+  let angularFrequency = coeffs[1];
+  let phase = coeffs[2];
+  const verticalOffset = coeffs[3];
+
+  // Guarantee a > 0
+  if (amplitude < 0) {
+    amplitude *= -1;
+    angularFrequency *= -1;
+    phase *= -1;
+  }
+  const period = Math.PI;
+  // Guarantee b > 0
+  if (angularFrequency < 0) {
+    angularFrequency *= -1;
+    phase *= -1;
+    phase += period / 2;
+  }
+
+  // Guarantee c is smallest possible positive value
+  while (phase > 0) {
+    phase -= period;
+  }
+  while (phase < 0) {
+    phase += period;
+  }
+  return [amplitude, angularFrequency, phase, verticalOffset];
+}
+const PlotDefaults = {
+  areEqual: function (coeffs1, coeffs2) {
+    return approximateDeepEqual(coeffs1, coeffs2);
+  },
+  movable: MOVABLES.PLOT,
+  getPropsForCoeffs: function (coeffs) {
+    return {
+      // @ts-expect-error - TS2339 - Property 'getFunctionForCoeffs' does not exist on type '{ readonly areEqual: (coeffs1: any, coeffs2: any) => boolean; readonly Movable: any; readonly getPropsForCoeffs: (coeffs: any) => any; }'.
+      fn: _.partial(this.getFunctionForCoeffs, coeffs)
+    };
+  }
+};
+const Linear = _.extend({}, PlotDefaults, {
+  url: "https://ka-perseus-graphie.s3.amazonaws.com/67aaf581e6d9ef9038c10558a1f70ac21c11c9f8.png",
+  defaultCoords: [[0.25, 0.75], [0.75, 0.75]],
+  getCoefficients: function (coords) {
+    const p1 = coords[0];
+    const p2 = coords[1];
+    const denom = p2[0] - p1[0];
+    const num = p2[1] - p1[1];
+    if (denom === 0) {
+      return;
+    }
+    const m = num / denom;
+    const b = p2[1] - m * p2[0];
+    return [m, b];
+  },
+  getFunctionForCoeffs: function (coeffs, x) {
+    const m = coeffs[0];
+    const b = coeffs[1];
+    return m * x + b;
+  },
+  getEquationString: function (coords) {
+    const coeffs = this.getCoefficients(coords);
+    const m = coeffs[0];
+    const b = coeffs[1];
+    return "y = " + m.toFixed(3) + "x + " + b.toFixed(3);
+  }
+});
+const Quadratic = _.extend({}, PlotDefaults, {
+  url: "https://ka-perseus-graphie.s3.amazonaws.com/e23d36e6fc29ee37174e92c9daba2a66677128ab.png",
+  defaultCoords: [[0.5, 0.5], [0.75, 0.75]],
+  movable: MOVABLES.PARABOLA,
+  getCoefficients: function (coords) {
+    const p1 = coords[0];
+    const p2 = coords[1];
+
+    // Parabola with vertex (h, k) has form: y = a * (h - k)^2 + k
+    const h = p1[0];
+    const k = p1[1];
+
+    // Use these to calculate familiar a, b, c
+    const a = (p2[1] - k) / ((p2[0] - h) * (p2[0] - h));
+    const b = -2 * h * a;
+    const c = a * h * h + k;
+    return [a, b, c];
+  },
+  getFunctionForCoeffs: function (coeffs, x) {
+    const a = coeffs[0];
+    const b = coeffs[1];
+    const c = coeffs[2];
+    return (a * x + b) * x + c;
+  },
+  getPropsForCoeffs: function (coeffs) {
+    return {
+      a: coeffs[0],
+      b: coeffs[1],
+      c: coeffs[2]
+    };
+  },
+  getEquationString: function (coords) {
+    const coeffs = this.getCoefficients(coords);
+    const a = coeffs[0];
+    const b = coeffs[1];
+    const c = coeffs[2];
+    return "y = " + a.toFixed(3) + "x^2 + " + b.toFixed(3) + "x + " + c.toFixed(3);
+  }
+});
+const Sinusoid = _.extend({}, PlotDefaults, {
+  url: "https://ka-perseus-graphie.s3.amazonaws.com/3d68e7718498475f53b206c2ab285626baf8857e.png",
+  defaultCoords: [[0.5, 0.5], [0.6, 0.6]],
+  movable: MOVABLES.SINUSOID,
+  getCoefficients: function (coords) {
+    const p1 = coords[0];
+    const p2 = coords[1];
+    const a = p2[1] - p1[1];
+    const b = Math.PI / (2 * (p2[0] - p1[0]));
+    const c = p1[0] * b;
+    const d = p1[1];
+    return [a, b, c, d];
+  },
+  getFunctionForCoeffs: function (coeffs, x) {
+    const a = coeffs[0];
+    const b = coeffs[1];
+    const c = coeffs[2];
+    const d = coeffs[3];
+    return a * Math.sin(b * x - c) + d;
+  },
+  getPropsForCoeffs: function (coeffs) {
+    return {
+      a: coeffs[0],
+      b: coeffs[1],
+      c: coeffs[2],
+      d: coeffs[3]
+    };
+  },
+  getEquationString: function (coords) {
+    const coeffs = this.getCoefficients(coords);
+    const a = coeffs[0];
+    const b = coeffs[1];
+    const c = coeffs[2];
+    const d = coeffs[3];
+    return "y = " + a.toFixed(3) + " sin(" + b.toFixed(3) + "x - " + c.toFixed(3) + ") + " + d.toFixed(3);
+  },
+  areEqual: function (coeffs1, coeffs2) {
+    return approximateDeepEqual(canonicalSineCoefficients(coeffs1), canonicalSineCoefficients(coeffs2));
+  }
+});
+const Tangent = _.extend({}, PlotDefaults, {
+  url: "https://ka-perseus-graphie.s3.amazonaws.com/7db80d23c35214f98659fe1cf0765811c1bbfbba.png",
+  defaultCoords: [[0.5, 0.5], [0.75, 0.75]],
+  getCoefficients: function (coords) {
+    const p1 = coords[0];
+    const p2 = coords[1];
+    const a = p2[1] - p1[1];
+    const b = Math.PI / (4 * (p2[0] - p1[0]));
+    const c = p1[0] * b;
+    const d = p1[1];
+    return [a, b, c, d];
+  },
+  getFunctionForCoeffs: function (coeffs, x) {
+    const a = coeffs[0];
+    const b = coeffs[1];
+    const c = coeffs[2];
+    const d = coeffs[3];
+    return a * Math.tan(b * x - c) + d;
+  },
+  getEquationString: function (coords) {
+    const coeffs = this.getCoefficients(coords);
+    const a = coeffs[0];
+    const b = coeffs[1];
+    const c = coeffs[2];
+    const d = coeffs[3];
+    return "y = " + a.toFixed(3) + " sin(" + b.toFixed(3) + "x - " + c.toFixed(3) + ") + " + d.toFixed(3);
+  },
+  areEqual: function (coeffs1, coeffs2) {
+    return approximateDeepEqual(canonicalTangentCoefficients(coeffs1), canonicalTangentCoefficients(coeffs2));
+  }
+});
+const Exponential = _.extend({}, PlotDefaults, {
+  url: "https://ka-perseus-graphie.s3.amazonaws.com/9cbfad55525e3ce755a31a631b074670a5dad611.png",
+  defaultCoords: [[0.5, 0.55], [0.75, 0.75]],
+  defaultAsymptote: [[0, 0.5], [1.0, 0.5]],
+  /**
+   * Add extra constraints for movement of the points or asymptote (below):
+   *   newCoord: [x, y]
+   *     The end position of the point or asymptote endpoint
+   *   oldCoord: [x, y]
+   *     The old position of the point or asymptote endpoint
+   *   coords:
+   *     An array of coordinates representing the proposed end configuration
+   *     of the plot coordinates.
+   *   asymptote:
+   *     An array of coordinates representing the proposed end configuration
+   *     of the asymptote.
+   *
+   * Return: either a coordinate (to be used as the resulting coordinate of
+   * the move) or a boolean, where `true` uses newCoord as the resulting
+   * coordinate, and `false` uses oldCoord as the resulting coordinate.
+   */
+  extraCoordConstraint: function (newCoord, oldCoord, coords, asymptote, graph) {
+    const y = asymptote[0][1];
+    return _.all(coords, coord => coord[1] !== y);
+  },
+  extraAsymptoteConstraint: function (newCoord, oldCoord, coords, asymptote, graph) {
+    const y = newCoord[1];
+    const isValid = _.all(coords, coord => coord[1] > y) || _.all(coords, coord => coord[1] < y);
+    if (isValid) {
+      return [oldCoord[0], y];
+    }
+    // Snap the asymptote as close as possible, i.e., if the user moves
+    // the mouse really quickly into an invalid region
+    const oldY = oldCoord[1];
+    const wasBelow = _.all(coords, coord => coord[1] > oldY);
+    if (wasBelow) {
+      const bottomMost = _.min(_.map(coords, coord => coord[1]));
+      return [oldCoord[0], bottomMost - graph.snapStep[1]];
+    }
+    const topMost = _.max(_.map(coords, coord => coord[1]));
+    return [oldCoord[0], topMost + graph.snapStep[1]];
+  },
+  allowReflectOverAsymptote: true,
+  getCoefficients: function (coords, asymptote) {
+    const p1 = coords[0];
+    const p2 = coords[1];
+    const c = asymptote[0][1];
+    const b = Math.log((p1[1] - c) / (p2[1] - c)) / (p1[0] - p2[0]);
+    const a = (p1[1] - c) / Math.exp(b * p1[0]);
+    return [a, b, c];
+  },
+  getFunctionForCoeffs: function (coeffs, x) {
+    const a = coeffs[0];
+    const b = coeffs[1];
+    const c = coeffs[2];
+    return a * Math.exp(b * x) + c;
+  },
+  getEquationString: function (coords, asymptote) {
+    if (!asymptote) {
+      return null;
+    }
+    const coeffs = this.getCoefficients(coords, asymptote);
+    const a = coeffs[0];
+    const b = coeffs[1];
+    const c = coeffs[2];
+    return "y = " + a.toFixed(3) + "e^(" + b.toFixed(3) + "x) + " + c.toFixed(3);
+  }
+});
+const Logarithm = _.extend({}, PlotDefaults, {
+  url: "https://ka-perseus-graphie.s3.amazonaws.com/f6491e99d34af34d924bfe0231728ad912068dc3.png",
+  defaultCoords: [[0.55, 0.5], [0.75, 0.75]],
+  defaultAsymptote: [[0.5, 0], [0.5, 1.0]],
+  extraCoordConstraint: function (newCoord, oldCoord, coords, asymptote, graph) {
+    const x = asymptote[0][0];
+    return _.all(coords, coord => coord[0] !== x) && coords[0][1] !== coords[1][1];
+  },
+  extraAsymptoteConstraint: function (newCoord, oldCoord, coords, asymptote, graph) {
+    const x = newCoord[0];
+    const isValid = _.all(coords, coord => coord[0] > x) || _.all(coords, coord => coord[0] < x);
+    if (isValid) {
+      return [x, oldCoord[1]];
+    }
+    // Snap the asymptote as close as possible, i.e., if the user moves
+    // the mouse really quickly into an invalid region
+    const oldX = oldCoord[0];
+    const wasLeft = _.all(coords, coord => coord[0] > oldX);
+    if (wasLeft) {
+      const leftMost = _.min(_.map(coords, coord => coord[0]));
+      return [leftMost - graph.snapStep[0], oldCoord[1]];
+    }
+    const rightMost = _.max(_.map(coords, coord => coord[0]));
+    return [rightMost + graph.snapStep[0], oldCoord[1]];
+  },
+  allowReflectOverAsymptote: true,
+  getCoefficients: function (coords, asymptote) {
+    // It's easiest to calculate the logarithm's coefficients by thinking
+    // about it as the inverse of the exponential, so we flip x and y and
+    // perform some algebra on the coefficients. This also unifies the
+    // logic between the two 'models'.
+    const flip = coord => [coord[1], coord[0]];
+    const inverseCoeffs = Exponential.getCoefficients(_.map(coords, flip), _.map(asymptote, flip));
+    if (inverseCoeffs) {
+      const c = -inverseCoeffs[2] / inverseCoeffs[0];
+      const b = 1 / inverseCoeffs[0];
+      const a = 1 / inverseCoeffs[1];
+      return [a, b, c];
+    }
+  },
+  getFunctionForCoeffs: function (coeffs, x, asymptote) {
+    const a = coeffs[0];
+    const b = coeffs[1];
+    const c = coeffs[2];
+    return a * Math.log(b * x + c);
+  },
+  getEquationString: function (coords, asymptote) {
+    if (!asymptote) {
+      return null;
+    }
+    const coeffs = this.getCoefficients(coords, asymptote);
+    const a = coeffs[0];
+    const b = coeffs[1];
+    const c = coeffs[2];
+    return "y = ln(" + a.toFixed(3) + "x + " + b.toFixed(3) + ") + " + c.toFixed(3);
+  }
+});
+const AbsoluteValue = _.extend({}, PlotDefaults, {
+  url: "https://ka-perseus-graphie.s3.amazonaws.com/8256a630175a0cb1d11de223d6de0266daf98721.png",
+  defaultCoords: [[0.5, 0.5], [0.75, 0.75]],
+  getCoefficients: function (coords) {
+    const p1 = coords[0];
+    const p2 = coords[1];
+    const denom = p2[0] - p1[0];
+    const num = p2[1] - p1[1];
+    if (denom === 0) {
+      return;
+    }
+    let m = Math.abs(num / denom);
+    if (p2[1] < p1[1]) {
+      m *= -1;
+    }
+    const horizontalOffset = p1[0];
+    const verticalOffset = p1[1];
+    return [m, horizontalOffset, verticalOffset];
+  },
+  getFunctionForCoeffs: function (coeffs, x) {
+    const m = coeffs[0];
+    const horizontalOffset = coeffs[1];
+    const verticalOffset = coeffs[2];
+    return m * Math.abs(x - horizontalOffset) + verticalOffset;
+  },
+  getEquationString: function (coords) {
+    const coeffs = this.getCoefficients(coords);
+    const m = coeffs[0];
+    const horizontalOffset = coeffs[1];
+    const verticalOffset = coeffs[2];
+    return "y = " + m.toFixed(3) + "| x - " + horizontalOffset.toFixed(3) + "| + " + verticalOffset.toFixed(3);
+  }
+});
+
+/* Utility functions for dealing with graphing interfaces. */
+const functionTypeMapping = {
+  linear: Linear,
+  quadratic: Quadratic,
+  sinusoid: Sinusoid,
+  tangent: Tangent,
+  exponential: Exponential,
+  logarithm: Logarithm,
+  absolute_value: AbsoluteValue
+};
+const allTypes = _.keys(functionTypeMapping);
+function functionForType(type) {
+  // @ts-expect-error: TypeScript doesn't know how to use deal with generics
+  // and conditional types in this way.
+  return functionTypeMapping[type];
+}
+
+var grapherUtil = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    MOVABLES: MOVABLES,
+    allTypes: allTypes,
+    functionForType: functionForType
+});
+
+// This file is processed by a Rollup plugin (replace) to inject the production
+const libName = "@khanacademy/perseus-core";
+const libVersion = "3.2.0";
+addLibraryVersionToPerseusDebug(libName, libVersion);
+
+/**
+ * @typedef {Object} Errors utility for referencing the Perseus error taxonomy.
+ */
+const Errors = Object.freeze({
+  /**
+   * @property {ErrorKind} Unknown The kind of error is not known.
+   */
+  Unknown: "Unknown",
+  /**
+   * @property {ErrorKind} Internal The error is internal to the executing code.
+   */
+  Internal: "Internal",
+  /**
+   * @property {ErrorKind} InvalidInput There was a problem with the provided
+   * input, such as the wrong format or a null value.
+   */
+  InvalidInput: "InvalidInput",
+  /**
+   * @property {ErrorKind} NotAllowed There was a problem due to the state of
+   * the system not matching the requested operation or input. For example,
+   * trying to create a username that is valid, but is already taken by
+   * another user. Use {@link InvalidInput} instead when the input isn't
+   * valid regardless of the state of the system. Use {@link NotFound} when
+   * the failure is due to not being able to find a resource.
+   */
+  NotAllowed: "NotAllowed",
+  /**
+   * @property {ErrorKind} TransientService There was a problem when making a
+   * request to a service.
+   */
+  TransientService: "TransientService",
+  /**
+   * @property {ErrorKind} Service There was a non-transient problem when
+   * making a request to service.
+   */
+  Service: "Service"
+});
+
+/**
+ * @type {ErrorKind} The kind of error being reported
+ */
+
+class PerseusError extends Error {
+  constructor(message, kind, options) {
+    super(message);
+    this.kind = void 0;
+    this.metadata = void 0;
+    this.kind = kind;
+    this.metadata = options == null ? void 0 : options.metadata;
+  }
+}
+
+/**
+ * The Perseus "data schema" file.
+ *
+ * This file, and the types in it, represents the "data schema" that Perseus
+ * uses. The @khanacademy/perseus-editor package edits and produces objects
+ * that conform to the types in this file. Similarly, the top-level renderers
+ * in @khanacademy/perseus, consume objects that conform to these types.
+ *
+ * WARNING: This file should not import any types from elsewhere so that it is
+ * easy to reason about changes that alter the Perseus schema. This helps
+ * ensure that it is not changed accidentally when upgrading a dependant
+ * package or other part of Perseus code. Note that TypeScript does type
+ * checking via something called "structural typing". This means that as long
+ * as the shape of a type matches, the name it goes by doesn't matter. As a
+ * result, a `Coord` type that looks like this `[x: number, y: number]` is
+ * _identical_, in TypeScript's eyes, to this `Vector2` type `[x: number, y:
+ * number]`. Also, with tuples, the labels for each entry is ignored, so `[x:
+ * number, y: number]` is compatible with `[min: number, max: number]`. The
+ * labels are for humans, not TypeScript. :)
+ *
+ * If you make changes to types in this file, be very sure that:
+ *
+ *   a) the changes are backwards compatible. If they are not, old data from
+ *      previous versions of the "schema" could become unrenderable, or worse,
+ *      introduce hard-to-diagnose bugs.
+ *   b) the parsing code (`util/parse-perseus-json/`) is updated to handle
+ *      the new format _as well as_ the old format.
+ */
+
+// TODO(FEI-4010): Remove `Perseus` prefix for all types here
+
+// Same name as Mafs
+
+/**
+ * Our core set of Perseus widgets.
+ *
+ * This interface is the basis for "registering" all Perseus widget types.
+ * There should be one key/value pair for each supported widget. If you create
+ * a new widget, an entry should be added to this interface. Note that this
+ * only registers the widget options type, you'll also need to register the
+ * widget so that it's available at runtime (@see
+ * {@link file://./widgets.ts#registerWidget}).
+ *
+ * Importantly, the key should be the name that is used in widget IDs. For most
+ * widgets that is the same as the widget option's `type` field. In cases where
+ * a widget has been deprecated and replaced with the deprecated-standin
+ * widget, it should be the original widget type!
+ *
+ * If you define the widget outside of this package, you can still add the new
+ * widget to this interface by writing the following in that package that
+ * contains the widget. TypeScript will merge that definition of the
+ * `PerseusWidgets` with the one defined below.
+ *
+ * ```typescript
+ * declare module "@khanacademy/perseus" {
+ *     interface PerseusWidgetTypes {
+ *         // A new widget
+ *         "new-awesomeness": MyAwesomeNewWidget;
+ *
+ *         // A deprecated widget
+ *         "super-old-widget": DeprecatedStandinWidget;
+ *     }
+ * }
+ *
+ * // The new widget's options definition
+ * type MyAwesomeNewWidget = WidgetOptions<'new-awesomeness', MyAwesomeNewWidgetOptions>;
+ *
+ * // The deprecated widget's options definition
+ * type SuperOldWidget = WidgetOptions<'super-old-widget', object>;
+ * ```
+ *
+ * This interface can be extended through the magic of TypeScript "Declaration
+ * merging". Specifically, we augment this module and extend this interface.
+ *
+ * @see {@link https://www.typescriptlang.org/docs/handbook/declaration-merging.html#module-augmentation}
+ */
+
+/**
+ * A map of widget IDs to widget options. This is most often used as the type
+ * for a set of widgets defined in a `PerseusItem` but can also be useful to
+ * represent a function parameter where only `widgets` from a `PerseusItem` are
+ * needed. Today Widget IDs are made up of the widget type and an incrementing
+ * integer (eg. `interactive-graph 1` or `radio 3`). It is suggested to avoid
+ * reading/parsing the widget id to derive any information from it, except in
+ * the case of this map.
+ *
+ * @see {@link PerseusWidgetTypes} additional widgets can be added to this map type
+ * by augmenting the PerseusWidgetTypes with new widget types!
+ */
+
+/**
+ * A "PerseusItem" is a classic Perseus item. It is rendered by the
+ * `ServerItemRenderer` and the layout is pre-set.
+ *
+ * To render more complex Perseus items, see the `Item` type in the multi item
+ * area.
+ */
+
+/**
+ * A "PerseusArticle" is an item that is meant to be rendered as an article.
+ * This item is never scored and is rendered by the `ArticleRenderer`.
+ */
+
+const ItemExtras = [
+// The user might benefit from using a Scientific Calculator.  Provided on Khan Academy when true
+"calculator",
+// The user might benefit from using a statistics Chi Squared Table like https://people.richland.edu/james/lecture/m170/tbl-chi.html
+"chi2Table",
+// The user might benefit from a monthly payments calculator.  Provided on Khan Academy when true
+"financialCalculatorMonthlyPayment",
+// The user might benefit from a total amount calculator.  Provided on Khan Academy when true
+"financialCalculatorTotalAmount",
+// The user might benefit from a time to pay off calculator.  Provided on Khan Academy when true
+"financialCalculatorTimeToPayOff",
+// The user might benefit from using a Periodic Table of Elements.  Provided on Khan Academy when true
+"periodicTable",
+// The user might benefit from using a Periodic Table of Elements with key.  Provided on Khan Academy when true
+"periodicTableWithKey",
+// The user might benefit from using a statistics T Table like https://www.statisticshowto.com/tables/t-distribution-table/
+"tTable",
+// The user might benefit from using a statistics Z Table like https://www.ztable.net/
+"zTable"];
+
+/**
+ * The type representing the common structure of all widget's options. The
+ * `Options` generic type represents the widget-specific option data.
+ */
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+// prettier-ignore
+
+//prettier-ignore
+
+/**
+ * A background image applied to various widgets.
+ */
+
+/**
+ * The type of markings to display on the graph.
+ * - axes: shows the axes without the gride lines
+ * - graph: shows the axes and the grid lines
+ * - grid: shows only the grid lines
+ * - none: shows no markings
+ */
+
+const PerseusExpressionAnswerFormConsidered = ["correct", "wrong", "ungraded"];
+
+// 2D range: xMin, xMax, yMin, yMax
+
+const lockedFigureColorNames = ["blue", "green", "grayH", "purple", "pink", "orange", "red"];
+const lockedFigureColors = {
+  blue: "#3D7586",
+  green: "#447A53",
+  grayH: "#3B3D45",
+  purple: "#594094",
+  pink: "#B25071",
+  red: "#D92916",
+  orange: "#946700"
+};
+const lockedFigureFillStyles = {
+  none: 0,
+  white: 1,
+  translucent: 0.4,
+  solid: 1
+};
+
+// Not associated with a specific figure
+
+const plotterPlotTypes = ["bar", "line", "pic", "histogram", "dotplot"];
+
 /**
  * _ utilities for objects
  */
@@ -2400,5 +2914,5 @@ const mapObject = function mapObject(obj, lambda) {
   return result;
 };
 
-export { Errors, ItemExtras, PerseusError, PerseusExpressionAnswerFormConsidered, addLibraryVersionToPerseusDebug, libVersion, lockedFigureColorNames, lockedFigureColors, lockedFigureFillStyles, mapObject, plotterPlotTypes, pluck };
+export { Errors, grapherUtil as GrapherUtil, ItemExtras, PerseusError, PerseusExpressionAnswerFormConsidered, addLibraryVersionToPerseusDebug, approximateDeepEqual, approximateEqual, deepClone, getDecimalSeparator, getMatrixSize, libVersion, lockedFigureColorNames, lockedFigureColors, lockedFigureFillStyles, mapObject, plotterPlotTypes, pluck };
 //# sourceMappingURL=index.js.map