@khanacademy/kmath 0.4.7 → 2.0.0

package/dist/index.js

@@ -7,26 +7,30 @@ var _ = require('underscore');
 var perseusCore = require('@khanacademy/perseus-core');
 var $ = require('jquery');
 
-function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
 
-var ___default = /*#__PURE__*/_interopDefaultLegacy(_);
-var $__default = /*#__PURE__*/_interopDefaultLegacy($);
+var ___default = /*#__PURE__*/_interopDefaultCompat(_);
+var $__default = /*#__PURE__*/_interopDefaultCompat($);
 
 // This file is processed by a Rollup plugin (replace) to inject the production
+// version number during the release build.
+// In dev, you'll never see the version number.
+
 const libName = "@khanacademy/kmath";
-const libVersion = "0.4.7";
+const libVersion = "2.0.0";
 perseusUtils.addLibraryVersionToPerseusDebug(libName, libVersion);
 
 /**
  * Number Utils
  * A number is a js-number, e.g. 5.12
  */
+
 const DEFAULT_TOLERANCE = 1e-9;
 
 // TODO: Should this just be Number.Epsilon
 const EPSILON = Math.pow(2, -42);
 function is$2(x) {
-  return ___default["default"].isNumber(x) && !___default["default"].isNaN(x);
+  return ___default.default.isNumber(x) && !___default.default.isNaN(x);
 }
 function equal$4(x, y, tolerance) {
   // Checking for undefined makes this function behave nicely
@@ -110,14 +114,14 @@ var number = /*#__PURE__*/Object.freeze({
     __proto__: null,
     DEFAULT_TOLERANCE: DEFAULT_TOLERANCE,
     EPSILON: EPSILON,
-    is: is$2,
+    ceilTo: ceilTo$2,
     equal: equal$4,
-    sign: sign$1,
+    floorTo: floorTo$2,
+    is: is$2,
     isInteger: isInteger,
     round: round$2,
     roundTo: roundTo$2,
-    floorTo: floorTo$2,
-    ceilTo: ceilTo$2,
+    sign: sign$1,
     toFraction: toFraction
 });
 
@@ -125,6 +129,7 @@ var number = /*#__PURE__*/Object.freeze({
  * Vector Utils
  * A vector is an array of numbers e.g. [0, 3, 4].
  */
+
 function arraySum(array) {
   return array.reduce((memo, arg) => memo + arg, 0);
 }
@@ -315,32 +320,32 @@ function ceilTo$1(vec, increment) {
 
 var vector$1 = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    zip: zip,
-    map: map,
-    is: is$1,
-    normalize: normalize,
-    length: length,
-    dot: dot,
     add: add$1,
-    subtract: subtract,
-    negate: negate,
-    scale: scale,
-    equal: equal$3,
+    angleDeg: angleDeg,
+    angleRad: angleRad,
+    cartFromPolarDeg: cartFromPolarDeg$1,
+    cartFromPolarRad: cartFromPolarRad$1,
+    ceilTo: ceilTo$1,
     codirectional: codirectional,
     collinear: collinear$1,
-    polarRadFromCart: polarRadFromCart$1,
+    dot: dot,
+    equal: equal$3,
+    floorTo: floorTo$1,
+    is: is$1,
+    length: length,
+    map: map,
+    negate: negate,
+    normalize: normalize,
     polarDegFromCart: polarDegFromCart$1,
-    cartFromPolarRad: cartFromPolarRad$1,
-    cartFromPolarDeg: cartFromPolarDeg$1,
-    rotateRad: rotateRad$1,
-    rotateDeg: rotateDeg$1,
-    angleRad: angleRad,
-    angleDeg: angleDeg,
+    polarRadFromCart: polarRadFromCart$1,
     projection: projection,
+    rotateDeg: rotateDeg$1,
+    rotateRad: rotateRad$1,
     round: round$1,
     roundTo: roundTo$1,
-    floorTo: floorTo$1,
-    ceilTo: ceilTo$1
+    scale: scale,
+    subtract: subtract,
+    zip: zip
 });
 
 /**
@@ -348,6 +353,7 @@ var vector$1 = /*#__PURE__*/Object.freeze({
  * A point is an array of two numbers e.g. [0, 0].
  */
 
+
 // A point, in 2D, 3D, or nD space.
 
 // Rotate point (around origin unless a center is specified)
@@ -433,31 +439,32 @@ const ceilTo = ceilTo$1;
 
 var point = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    rotateRad: rotateRad,
-    rotateDeg: rotateDeg,
-    distanceToPoint: distanceToPoint$1,
-    distanceToLine: distanceToLine,
-    reflectOverLine: reflectOverLine,
-    compare: compare,
-    is: is,
     addVector: addVector,
     addVectors: addVectors,
-    subtractVector: subtractVector,
+    cartFromPolarDeg: cartFromPolarDeg,
+    cartFromPolarRad: cartFromPolarRad,
+    ceilTo: ceilTo,
+    compare: compare,
+    distanceToLine: distanceToLine,
+    distanceToPoint: distanceToPoint$1,
     equal: equal$2,
-    polarRadFromCart: polarRadFromCart,
+    floorTo: floorTo,
+    is: is,
     polarDegFromCart: polarDegFromCart,
-    cartFromPolarRad: cartFromPolarRad,
-    cartFromPolarDeg: cartFromPolarDeg,
+    polarRadFromCart: polarRadFromCart,
+    reflectOverLine: reflectOverLine,
+    rotateDeg: rotateDeg,
+    rotateRad: rotateRad,
     round: round,
     roundTo: roundTo,
-    floorTo: floorTo,
-    ceilTo: ceilTo
+    subtractVector: subtractVector
 });
 
 /**
  * Line Utils
  * A line is an array of two points e.g. [[-5, 0], [5, 0]].
  */
+
 function distanceToPoint(line, point$1) {
   return distanceToLine(point$1, line);
 }
@@ -489,9 +496,9 @@ function equal$1(line1, line2, tolerance) {
 var line = /*#__PURE__*/Object.freeze({
     __proto__: null,
     distanceToPoint: distanceToPoint,
-    reflectPoint: reflectPoint,
+    equal: equal$1,
     midpoint: midpoint,
-    equal: equal$1
+    reflectPoint: reflectPoint
 });
 
 /**
@@ -500,6 +507,7 @@ var line = /*#__PURE__*/Object.freeze({
  * For example, [[0, 0], [1, 0]] is the ray starting at the origin and
  * traveling along the positive x-axis.
  */
+
 function equal(ray1, ray2, tolerance) {
   // Compare the directions of the rays
   const v1 = subtract(ray1[1], ray1[0]);
@@ -546,6 +554,8 @@ const KhanMath = {
     let mod;
     a = Math.abs(a);
     b = Math.abs(b);
+
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     while (b) {
       mod = a % b;
       a = b;
@@ -569,7 +579,8 @@ const KhanMath = {
       return false;
     }
     if (n < 101) {
-      return !!$__default["default"].grep(KhanMath.primes, function (p, i) {
+      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
+      return !!$__default.default.grep(KhanMath.primes, function (p, i) {
         return Math.abs(p - n) <= 0.5;
       }).length;
     }
@@ -594,7 +605,7 @@ const KhanMath = {
     const maxf = Math.sqrt(number);
     for (let f = 2; f <= maxf; f++) {
       if (number % f === 0) {
-        return $__default["default"].merge(KhanMath.getPrimeFactorization(f), KhanMath.getPrimeFactorization(number / f));
+        return $__default.default.merge(KhanMath.getPrimeFactorization(f), KhanMath.getPrimeFactorization(number / f));
       }
     }
   },
@@ -680,7 +691,7 @@ const KhanMath = {
   // Note: purposively more inclusive than answer-types' predicate.forms
   // That is, it is not necessarily true that interpreted input are numeric
   getNumericFormat: function (text) {
-    text = $__default["default"].trim(text);
+    text = $__default.default.trim(text);
     text = text.replace(/\u2212/, "-").replace(/([+-])\s+/g, "$1");
     if (text.match(/^[+-]?\d+$/)) {
       return "integer";
@@ -721,7 +732,7 @@ const KhanMath = {
         return sign + (numerator === 1 ? "" : numerator) + pi + (denominator === 1 ? "" : "/" + denominator);
       }
     }
-    if (___default["default"](["proper", "improper", "mixed", "fraction"]).contains(format)) {
+    if (___default.default(["proper", "improper", "mixed", "fraction"]).contains(format)) {
       const fraction = toFraction(number$1);
       const numerator = Math.abs(fraction[0]);
       const denominator = fraction[1];
@@ -732,7 +743,9 @@ const KhanMath = {
       if (format === "mixed") {
         const modulus = numerator % denominator;
         const integer = (numerator - modulus) / denominator;
-        return sign + (integer ? integer + " " : "") + modulus + "/" + denominator;
+        return sign + (
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
+        integer ? integer + " " : "") + modulus + "/" + denominator;
       } // otherwise proper, improper, or fraction
       return sign + numerator + "/" + denominator;
     }
@@ -752,6 +765,7 @@ function add(a, b) {
  * A collection of geomtry-related utility functions
  */
 
+
 // This should really be a readonly tuple of [number, number]
 
 // Given a number, return whether it is positive (1), negative (-1), or zero (0)
@@ -780,7 +794,7 @@ function pointInRect(a, b, c) {
 // http://www.geeksforgeeks.org/check-if-two-given-line-segments-intersect/
 function intersects(ab, cd) {
   const triplets = [[ab[0], ab[1], cd[0]], [ab[0], ab[1], cd[1]], [cd[0], cd[1], ab[0]], [cd[0], cd[1], ab[1]]];
-  const orientations = ___default["default"].map(triplets, function (triplet) {
+  const orientations = ___default.default.map(triplets, function (triplet) {
     return sign(ccw(...triplet));
   });
   if (orientations[0] !== orientations[1] && orientations[2] !== orientations[3]) {
@@ -821,7 +835,7 @@ function polygonSidesIntersect(vertices) {
   return false;
 }
 function vector(a, b) {
-  return ___default["default"].map(___default["default"].zip(a, b), function (pair) {
+  return ___default.default.map(___default.default.zip(a, b), function (pair) {
     return pair[0] - pair[1];
   });
 }
@@ -833,8 +847,8 @@ function reverseVector(vector) {
 // path (assuming a closed loop, where the last point connects back to the
 // first).
 function clockwise(points) {
-  const segments = ___default["default"].zip(points, points.slice(1).concat(points.slice(0, 1)));
-  const areas = ___default["default"].map(segments, function (segment) {
+  const segments = ___default.default.zip(points, points.slice(1).concat(points.slice(0, 1)));
+  const areas = ___default.default.map(segments, function (segment) {
     const p1 = segment[0];
     const p2 = segment[1];
     return (p2[0] - p1[0]) * (p2[1] + p1[1]);
@@ -842,18 +856,18 @@ function clockwise(points) {
   return sum(areas) > 0;
 }
 function magnitude(v) {
-  return Math.sqrt(___default["default"].reduce(v, function (memo, el) {
+  return Math.sqrt(___default.default.reduce(v, function (memo, el) {
     // @ts-expect-error - TS2345 - Argument of type 'Coord' is not assignable to parameter of type 'number'.
     return memo + Math.pow(el, 2);
   }, 0));
 }
 function dotProduct(a, b) {
-  return ___default["default"].reduce(___default["default"].zip(a, b), function (memo, pair) {
+  return ___default.default.reduce(___default.default.zip(a, b), function (memo, pair) {
     return memo + pair[0] * pair[1];
   }, 0);
 }
 function sideLengths(coords) {
-  const segments = ___default["default"].zip(coords, rotate(coords));
+  const segments = ___default.default.zip(coords, rotate(coords));
   return segments.map(function (segment) {
     // @ts-expect-error - TS2345 - Argument of type 'number[]' is not assignable to parameter of type 'readonly Coord[]'. | TS2556 - A spread argument must either have a tuple type or be passed to a rest parameter.
     return magnitude(vector(...segment));
@@ -862,8 +876,8 @@ function sideLengths(coords) {
 
 // Based on http://math.stackexchange.com/a/151149
 function angleMeasures(coords) {
-  const triplets = ___default["default"].zip(rotate(coords, -1), coords, rotate(coords, 1));
-  const offsets = ___default["default"].map(triplets, function (triplet) {
+  const triplets = ___default.default.zip(rotate(coords, -1), coords, rotate(coords, 1));
+  const offsets = ___default.default.map(triplets, function (triplet) {
     const p = vector(triplet[1], triplet[0]);
     const q = vector(triplet[2], triplet[1]);
     // @ts-expect-error - TS2345 - Argument of type 'number[]' is not assignable to parameter of type 'Coord'. | TS2345 - Argument of type 'number[]' is not assignable to parameter of type 'readonly Coord[]'. | TS2345 - Argument of type 'number[]' is not assignable to parameter of type 'readonly Coord[]'.
@@ -871,10 +885,10 @@ function angleMeasures(coords) {
     // @ts-expect-error - TS2556 - A spread argument must either have a tuple type or be passed to a rest parameter.
     return sign(ccw(...triplet)) > 0 ? raw : -raw;
   });
-  const sum = ___default["default"].reduce(offsets, function (memo, arg) {
+  const sum = ___default.default.reduce(offsets, function (memo, arg) {
     return memo + arg;
   }, 0);
-  return ___default["default"].map(offsets, function (offset) {
+  return ___default.default.map(offsets, function (offset) {
     return sum > 0 ? Math.PI - offset : Math.PI + offset;
   });
 }
@@ -908,14 +922,14 @@ function similar(coords1, coords2, tolerance) {
     // @ts-expect-error - TS4104 - The type 'readonly number[]' is 'readonly' and cannot be assigned to the mutable type 'number[]'.
     sides = rotate(sides, i);
     if (perseusCore.approximateDeepEqual(angles1, angles)) {
-      const sidePairs = ___default["default"].zip(sides1, sides);
-      const factors = ___default["default"].map(sidePairs, function (pair) {
+      const sidePairs = ___default.default.zip(sides1, sides);
+      const factors = ___default.default.map(sidePairs, function (pair) {
         return pair[0] / pair[1];
       });
-      const same = ___default["default"].all(factors, function (factor) {
+      const same = ___default.default.all(factors, function (factor) {
         return perseusCore.approximateEqual(factors[0], factor);
       });
-      const congruentEnough = ___default["default"].all(sidePairs, function (pair) {
+      const congruentEnough = ___default.default.all(sidePairs, function (pair) {
         return equal$4(pair[0], pair[1], tolerance);
       });
       if (same && congruentEnough) {
@@ -1007,26 +1021,27 @@ function getLineIntersectionString(firstPoints, secondPoints) {
 
 var geometry = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    sign: sign,
+    angleMeasures: angleMeasures,
+    canonicalSineCoefficients: canonicalSineCoefficients,
     ccw: ccw,
+    clockwise: clockwise,
     collinear: collinear,
+    getLineEquation: getLineEquation,
+    getLineIntersection: getLineIntersection,
+    getLineIntersectionString: getLineIntersectionString,
     intersects: intersects,
+    lawOfCosines: lawOfCosines,
+    magnitude: magnitude,
     polygonSidesIntersect: polygonSidesIntersect,
-    vector: vector,
     reverseVector: reverseVector,
-    clockwise: clockwise,
-    magnitude: magnitude,
-    angleMeasures: angleMeasures,
-    similar: similar,
-    lawOfCosines: lawOfCosines,
-    canonicalSineCoefficients: canonicalSineCoefficients,
     rotate: rotate,
-    getLineEquation: getLineEquation,
-    getLineIntersection: getLineIntersection,
-    getLineIntersectionString: getLineIntersectionString
+    sign: sign,
+    similar: similar,
+    vector: vector
 });
 
 // This file contains helper functions for working with angles.
+
 function convertDegreesToRadians(degrees) {
   return degrees / 180 * Math.PI;
 }
@@ -1057,6 +1072,7 @@ function polar(r, th) {
 const getAngleFromVertex = (point, vertex) => {
   const x = point[0] - vertex[0];
   const y = point[1] - vertex[1];
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
   if (!x && !y) {
     return 0;
   }
@@ -1089,12 +1105,12 @@ const getClockwiseAngle = function (coords) {
 
 var angles = /*#__PURE__*/Object.freeze({
     __proto__: null,
+    calculateAngleInDegrees: calculateAngleInDegrees,
     convertDegreesToRadians: convertDegreesToRadians,
     convertRadiansToDegrees: convertRadiansToDegrees,
-    calculateAngleInDegrees: calculateAngleInDegrees,
-    polar: polar,
     getAngleFromVertex: getAngleFromVertex,
-    getClockwiseAngle: getClockwiseAngle
+    getClockwiseAngle: getClockwiseAngle,
+    polar: polar
 });
 
 // TODO: there's another, very similar getSinusoidCoefficients function
@@ -1131,8 +1147,8 @@ function getQuadraticCoefficients(coords) {
 
 var coefficients = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    getSinusoidCoefficients: getSinusoidCoefficients,
-    getQuadraticCoefficients: getQuadraticCoefficients
+    getQuadraticCoefficients: getQuadraticCoefficients,
+    getSinusoidCoefficients: getSinusoidCoefficients
 });
 
 exports.KhanMath = KhanMath;