@khanacademy/perseus 48.0.0 → 48.2.0

package/dist/index.js

@@ -368,6 +368,8 @@ const mockStrings = {
   addPoint: "Add Point",
   removePoint: "Remove Point",
   graphKeyboardPrompt: "Press Shift + Enter to interact with the graph",
+  selectAnAnswer: "Select an answer",
+  // The following strings are used for interactive graph SR descriptions.
   closePolygon: "Close shape",
   openPolygon: "Re-open shape",
   srPointAtCoordinates: _ref27 => {
@@ -385,7 +387,41 @@ const mockStrings = {
     return `Interactive elements: ${elements}`;
   },
   srNoInteractiveElements: "No interactive elements",
-  selectAnAnswer: "Select an answer"
+  circleGraphAriaLabel: "A circle on a coordinate plane.",
+  circleShapeAriaLabel: _ref29 => {
+    let {
+      centerX,
+      centerY
+    } = _ref29;
+    return `Circle. The center point is at ${centerX} comma ${centerY}.`;
+  },
+  circleRadiusPointAriaLabel: _ref30 => {
+    let {
+      radiusPointX,
+      radiusPointY
+    } = _ref30;
+    return `Radius point at ${radiusPointX} comma ${radiusPointY}.`;
+  },
+  circleRadiusDescription: _ref31 => {
+    let {
+      radius
+    } = _ref31;
+    return `Circle radius is ${radius}.`;
+  },
+  circleOuterPointsDescription: _ref32 => {
+    let {
+      point1X,
+      point1Y,
+      point2X,
+      point2Y,
+      point3X,
+      point3Y,
+      point4X,
+      point4Y
+    } = _ref32;
+    return `Points on the circle at ${point1X} comma ${point1Y}, ${point2X} comma ${point2Y}, ${point3X} comma ${point3Y}, ${point4X} comma ${point4Y}.`;
+  }
+  // The above strings are used for interactive graph SR descriptions.
 };
 
 /**
@@ -3494,6 +3530,163 @@ const Util = {
   deepClone
 };
 
+// For offline exercises in the mobile app, we download the graphie data
+// (svgs and localized data files) and serve them from the local file
+// system (with file://). We replace urls that start with `web+graphie`
+// in the perseus json with this `file+graphie` prefix to indicate that
+// they should have the `file://` protocol instead of `https://`.
+const svgLocalLabelsRegex = /^file\+graphie:/;
+const hashRegex = /\/([^/]+)$/;
+
+/**
+ * A Graphie axis range.
+ */
+
+/**
+ * A Graphie label.
+ */
+
+/**
+ * The Graphie data (labels, etc.)
+ */
+
+function getLocale() {
+  const {
+    JIPT,
+    kaLocale
+  } = getDependencies();
+  return JIPT.useJIPT ? "en-pt" : kaLocale;
+}
+function shouldUseLocalizedData() {
+  return getLocale() !== "en";
+}
+
+// A regex to split at the last / of a URL, separating the base part from the
+// hash. This is used to create the localized label data URLs.
+const splitHashRegex = /\/(?=[^/]+$)/;
+function getLocalizedDataUrl(url) {
+  // For local (cached) graphie images, they are already localized.
+  if (svgLocalLabelsRegex.test(url)) {
+    return Util.getDataUrl(url);
+  }
+  const [base, hash] = Util.getBaseUrl(url).split(splitHashRegex);
+  return `${base}/${getLocale()}/${hash}-data.json`;
+}
+
+// Get the hash from the url, which is just the filename
+function getUrlHash(url) {
+  const match = url.match(hashRegex);
+  if (match == null) {
+    throw new perseusCore.PerseusError("not a valid URL", perseusCore.Errors.InvalidInput);
+  }
+  return match && match[1];
+}
+
+/**
+ * Parse JSONP for a web+graphie://... hash to extract Graphie data, or throw
+ * an error if invalid JSONP.
+ */
+function parseDataFromJSONP(graphieHash, graphieJSONP, errorCallback) {
+  // The JSONP is expected to be in the form of `svgDataHASH(...)` or `svgOtherDataHASH(...)`
+  const match = graphieJSONP.match(new RegExp(`^(?:svgData|svgOtherData)${graphieHash}\\((.+)\\);$`));
+
+  // It is also possible that the JSONP is simply a JSON object,
+  //  in which case we can parse it directly.
+  const jsonToParse = match ? match[1] : graphieJSONP;
+
+  // Try to parse the JSONP, and if it fails, call the error callback
+  try {
+    return JSON.parse(jsonToParse);
+  } catch (error) {
+    errorCallback(error);
+    return null;
+  }
+}
+// The global cache of label data. Its format is:
+// {
+//   hash (e.g. "c21435944d2cf0c8f39d9059cb35836aa701d04a"): {
+//     loaded: a boolean of whether the data has been loaded or not
+//     dataCallbacks: a list of callbacks to call with the data when the data
+//                    is loaded
+//     data: the other data for this hash
+//   },
+//   ...
+// }
+const labelDataCache = {};
+function loadGraphie(url, onDataLoaded) {
+  const hash = getUrlHash(url);
+
+  // We can't make multiple jsonp calls to the same file because their
+  // callbacks will collide with each other. Instead, we cache the data
+  // and only make the jsonp calls once.
+  const entry = labelDataCache[hash];
+  if (entry != null) {
+    if (entry.loaded) {
+      const {
+        data,
+        localized
+      } = entry;
+      onDataLoaded(data, localized);
+    } else {
+      entry.dataCallbacks.push(onDataLoaded);
+    }
+  } else {
+    const cacheData = {
+      loaded: false,
+      dataCallbacks: [onDataLoaded],
+      localized: shouldUseLocalizedData()
+    };
+    labelDataCache[hash] = cacheData;
+    const retrieveData = async (url, errorCallback) => {
+      const response = await fetch(url);
+      if (!response?.ok) {
+        errorCallback();
+        return;
+      }
+      const jsonp = await response.text();
+      const data = parseDataFromJSONP(hash, jsonp, error => {
+        Log.error("Failed to parse JSONP for svg-image", perseusCore.Errors.Service, {
+          cause: error,
+          loggedMetadata: {
+            dataUrl: Util.getDataUrl(url),
+            jsonp
+          }
+        });
+      });
+
+      // If the data is null, then we failed to parse the JSONP
+      if (!data) {
+        return;
+      }
+      const newCacheEntry = labelDataCache[hash] = {
+        ...labelDataCache[hash],
+        loaded: true,
+        data
+      };
+      newCacheEntry.dataCallbacks.forEach(callback => {
+        callback(newCacheEntry.data, cacheData.localized);
+      });
+    };
+    const dataLoadErrorHandler = (x, status, error) => {
+      Log.error("Data load failed for svg-image", perseusCore.Errors.Service, {
+        cause: error,
+        loggedMetadata: {
+          dataUrl: Util.getDataUrl(url),
+          status
+        }
+      });
+    };
+    if (shouldUseLocalizedData()) {
+      cacheData.localized = false;
+      // If there is isn't any localized data, use the error callback to try to
+      // load the non-localized data. If that fails too, then we will throw an error.
+      retrieveData(getLocalizedDataUrl(url), () => retrieveData(Util.getDataUrl(url), dataLoadErrorHandler));
+    } else {
+      retrieveData(Util.getDataUrl(url), dataLoadErrorHandler);
+    }
+  }
+}
+
 // Derived from the MIT-licensed:
 
 /*jshint browser:true, node:true */
@@ -8925,6 +9118,9 @@ class Graphie$1 {
     $__default["default"](el).css("position", "relative");
     this.raphael = Raphael$1(el);
 
+    // Hide the Raphael canvas from screen readers
+    $__default["default"](el).attr("aria-hidden", "true");
+
     // For a sometimes-reproducible IE8 bug; doesn't affect SVG browsers at all
     $__default["default"](el).children("div").css("position", "absolute");
   }
@@ -17002,106 +17198,11 @@ class ImageLoader extends React__namespace.Component {
 /* eslint-disable @khanacademy/ts-no-error-suppressions */
 // Minimum image width to make an image appear as zoomable.
 const ZOOMABLE_THRESHOLD = 700;
-
-// The global cache of label data. Its format is:
-// {
-//   hash (e.g. "c21435944d2cf0c8f39d9059cb35836aa701d04a"): {
-//     loaded: a boolean of whether the data has been loaded or not
-//     dataCallbacks: a list of callbacks to call with the data when the data
-//                    is loaded
-//     data: the other data for this hash
-//   },
-//   ...
-// }
-const labelDataCache = {};
-
-// Write our own JSONP handler because all the other ones don't do things we
-// need.
-const doJSONP = function (url, options) {
-  options = {
-    callbackName: "callback",
-    success: $__default["default"].noop,
-    error: $__default["default"].noop,
-    ...options
-  };
-
-  // Create the script
-  const script = document.createElement("script");
-  script.setAttribute("async", "");
-  script.setAttribute("src", url);
-
-  // A cleanup function to run when we're done.
-  function cleanup() {
-    document.head?.removeChild(script);
-    delete window[options.callbackName];
-  }
-
-  // Add the global callback.
-  // @ts-expect-error - TS2740 - Type '() => void' is missing the following properties from type 'Window': clientInformation, closed, customElements, devicePixelRatio, and 206 more.
-  window[options.callbackName] = function () {
-    cleanup();
-    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-      args[_key] = arguments[_key];
-    }
-    options.success.apply(null, args);
-  };
-
-  // Add the error handler.
-  script.addEventListener("error", function () {
-    cleanup();
-    for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
-      args[_key2] = arguments[_key2];
-    }
-    options.error.apply(null, args);
-  });
-
-  // Insert the script to start the download.
-  document.head?.appendChild(script);
-};
-
-// For offline exercises in the mobile app, we download the graphie data
-// (svgs and localized data files) and serve them from the local file
-// system (with file://). We replace urls that start with `web+graphie`
-// in the perseus json with this `file+graphie` prefix to indicate that
-// they should have the `file://` protocol instead of `https://`.
-const svgLocalLabelsRegex = /^file\+graphie:/;
-const hashRegex = /\/([^/]+)$/;
 function isImageProbablyPhotograph(imageUrl) {
   // TODO(david): Do an inventory to refine this heuristic. For example, what
   //     % of .png images are illustrations?
   return /\.(jpg|jpeg)$/i.test(imageUrl);
 }
-function getLocale() {
-  const {
-    JIPT,
-    kaLocale
-  } = getDependencies();
-  return JIPT.useJIPT ? "en-pt" : kaLocale;
-}
-function shouldUseLocalizedData() {
-  return getLocale() !== "en";
-}
-
-// A regex to split at the last / of a URL, separating the base part from the
-// hash. This is used to create the localized label data URLs.
-const splitHashRegex = /\/(?=[^/]+$)/;
-function getLocalizedDataUrl(url) {
-  // For local (cached) graphie images, they are already localized.
-  if (svgLocalLabelsRegex.test(url)) {
-    return Util.getDataUrl(url);
-  }
-  const [base, hash] = Util.getBaseUrl(url).split(splitHashRegex);
-  return `${base}/${getLocale()}/${hash}-data.json`;
-}
-
-// Get the hash from the url, which is just the filename
-function getUrlHash(url) {
-  const match = url.match(hashRegex);
-  if (match == null) {
-    throw new perseusCore.PerseusError("not a valid URL", perseusCore.Errors.InvalidInput);
-  }
-  return match && match[1];
-}
 function defaultPreloader(dimensions) {
   return /*#__PURE__*/React__namespace.createElement("span", {
     style: {
@@ -17188,90 +17289,22 @@ class SvgImage extends React__namespace.Component {
     return Util.isLabeledSVG(this.props.src) ? state.imageLoaded && state.dataLoaded : state.imageLoaded;
   }
   loadResources() {
-    const hash = getUrlHash(this.props.src);
-
-    // We can't make multiple jsonp calls to the same file because their
-    // callbacks will collide with each other. Instead, we cache the data
-    // and only make the jsonp calls once.
-    if (labelDataCache[hash]) {
-      if (labelDataCache[hash].loaded) {
-        const {
-          data,
-          localized
-        } = labelDataCache[hash];
-        this.onDataLoaded(data, localized);
-      } else {
-        labelDataCache[hash].dataCallbacks.push(this.onDataLoaded);
-      }
-    } else {
-      const cacheData = {
-        loaded: false,
-        dataCallbacks: [this.onDataLoaded],
-        data: null,
-        localized: shouldUseLocalizedData()
-      };
-      labelDataCache[hash] = cacheData;
-      const retrieveData = (url, errorCallback) => {
-        doJSONP(url, {
-          callbackName: "svgData" + hash,
-          success: data => {
-            // @ts-expect-error - TS2540 - Cannot assign to 'data' because it is a read-only property.
-            cacheData.data = data;
-            // @ts-expect-error - TS2540 - Cannot assign to 'loaded' because it is a read-only property.
-            cacheData.loaded = true;
-            ___default["default"].each(cacheData.dataCallbacks, callback => {
-              // @ts-expect-error - TS2345 - Argument of type 'null' is not assignable to parameter of type '{ labels: readonly any[]; range: readonly any[]; }'.
-              callback(cacheData.data, cacheData.localized);
-            });
-          },
-          error: errorCallback
+    loadGraphie(this.props.src, (data, localized) => {
+      if (this._isMounted && data.labels && data.range) {
+        const labelsRendered = {};
+        data.labels.forEach(label => {
+          labelsRendered[label.content] = false;
         });
-      };
-      if (shouldUseLocalizedData()) {
-        retrieveData(getLocalizedDataUrl(this.props.src), (x, status, error) => {
-          // @ts-expect-error - TS2540 - Cannot assign to 'localized' because it is a read-only property.
-          cacheData.localized = false;
-
-          // If there is isn't any localized data, fall back to
-          // the original, unlocalized data
-          retrieveData(Util.getDataUrl(this.props.src), (x, status, error) => {
-            Log.error("Data load failed for svg-image", perseusCore.Errors.Service, {
-              cause: error,
-              loggedMetadata: {
-                dataUrl: Util.getDataUrl(this.props.src),
-                status
-              }
-            });
-          });
-        });
-      } else {
-        retrieveData(Util.getDataUrl(this.props.src), (x, status, error) => {
-          Log.error("Data load failed for svg-image", perseusCore.Errors.Service, {
-            cause: error,
-            loggedMetadata: {
-              dataUrl: Util.getDataUrl(this.props.src),
-              status
-            }
-          });
+        this.setState({
+          dataLoaded: true,
+          labelDataIsLocalized: localized,
+          labelsRendered,
+          labels: data.labels,
+          range: data.range
         });
       }
-    }
+    });
   }
-  onDataLoaded = (data, localized) => {
-    if (this._isMounted && data.labels && data.range) {
-      const labelsRendered = data.labels.reduce((dict, label) => ({
-        ...dict,
-        [label.content]: false
-      }), {});
-      this.setState({
-        dataLoaded: true,
-        labelDataIsLocalized: localized,
-        labelsRendered,
-        labels: data.labels,
-        range: data.range
-      });
-    }
-  };
   sizeProvided() {
     return this.props.width != null && this.props.height != null;
   }
@@ -34464,21 +34497,96 @@ function CircleGraph(props) {
     center,
     radiusPoint
   } = graphState;
-  return /*#__PURE__*/React__namespace.createElement(React__namespace.Fragment, null, /*#__PURE__*/React__namespace.createElement(MovableCircle, {
+  const {
+    strings
+  } = usePerseusI18n();
+  const [radiusPointAriaLive, setRadiusPointAriaLive] = React__namespace.useState("off");
+  const radius = getRadius(graphState);
+  const id = React__namespace.useId();
+  const circleId = id + "-circle";
+  const radiusId = id + "-radius";
+  const outerPointsId = id + "-outer-points";
+
+  // Aria label strings
+  const circleGraphAriaLabel = strings.circleGraphAriaLabel;
+  const circleShapeAriaLabel = strings.circleShapeAriaLabel({
+    centerX: center[0],
+    centerY: center[1]
+  });
+  const circleRadiusPointAriaLabel = strings.circleRadiusPointAriaLabel({
+    radiusPointX: radiusPoint[0],
+    radiusPointY: radiusPoint[1]
+  });
+  const circleRadiusDescription = strings.circleRadiusDescription({
+    radius
+  });
+  const circleOuterPointsDescription = strings.circleOuterPointsDescription({
+    point1X: center[0] + radius,
+    point1Y: center[1],
+    point2X: center[0],
+    point2Y: center[1] + radius,
+    point3X: center[0] - radius,
+    point3Y: center[1],
+    point4X: center[0],
+    point4Y: center[1] - radius
+  });
+  return /*#__PURE__*/React__namespace.createElement("g", {
+    // Outer circle minimal description
+    "aria-label": circleGraphAriaLabel,
+    "aria-describedby": `${circleId} ${radiusId} ${outerPointsId}`
+  }, /*#__PURE__*/React__namespace.createElement(MovableCircle, {
+    id: circleId
+    // Focusable circle aria label reads with every update
+    // because of the aria-live property in the circle <g>.
+    ,
+    ariaLabel: circleShapeAriaLabel
+    // Aria-describedby describes additional info on focus.
+    ,
+    ariaDescribedBy: `${radiusId} ${outerPointsId}`,
     center: center,
-    radius: getRadius(graphState),
-    onMove: c => dispatch(actions.circle.moveCenter(c))
-  }), /*#__PURE__*/React__namespace.createElement(MovablePoint$1, {
+    radius: radius,
+    onMove: c => {
+      setRadiusPointAriaLive("off");
+      dispatch(actions.circle.moveCenter(c));
+    }
+  }), /*#__PURE__*/React__namespace.createElement(MovablePoint$1
+  // Radius point aria label reads with every update.
+  , {
+    ariaLabel: `${circleRadiusPointAriaLabel} ${circleRadiusDescription}`
+    // Aria-describedby describes additional info on focus.
+    ,
+    ariaDescribedBy: `${outerPointsId}`
+    // The radius point's aria-live property is set to "off" when
+    // the circle is moved, so that it doesn't override the circle's
+    // aria-live (since the point is moved along with the circle).
+    // When the radius point is moved, the aria-live is set to
+    // "polite" so that the radius is read out.
+    ,
+    ariaLive: radiusPointAriaLive,
     point: radiusPoint,
     sequenceNumber: 1,
     cursor: "ew-resize",
     onMove: newRadiusPoint => {
+      setRadiusPointAriaLive("polite");
       dispatch(actions.circle.moveRadiusPoint(newRadiusPoint));
     }
-  }));
+  }), /*#__PURE__*/React__namespace.createElement("g", {
+    id: radiusId,
+    style: {
+      display: "hidden"
+    }
+  }, circleRadiusDescription), /*#__PURE__*/React__namespace.createElement("g", {
+    id: outerPointsId,
+    style: {
+      display: "hidden"
+    }
+  }, circleOuterPointsDescription));
 }
 function MovableCircle(props) {
   const {
+    id,
+    ariaLabel,
+    ariaDescribedBy,
     center,
     radius,
     onMove
@@ -34499,7 +34607,11 @@ function MovableCircle(props) {
   const [centerPx] = useTransformVectorsToPixels(center);
   const [radiiPx] = useTransformDimensionsToPixels([radius, radius]);
   return /*#__PURE__*/React__namespace.createElement("g", {
+    "aria-label": ariaLabel,
+    "aria-describedby": ariaDescribedBy,
+    "aria-live": "polite",
     ref: draggableRef,
+    role: "button",
     tabIndex: disableKeyboardInteraction ? -1 : 0,
     className: `movable-circle ${dragging ? "movable-circle--dragging" : ""}`
   }, /*#__PURE__*/React__namespace.createElement("ellipse", {
@@ -34509,6 +34621,7 @@ function MovableCircle(props) {
     rx: radiiPx[X] + 3,
     ry: radiiPx[Y] + 3
   }), /*#__PURE__*/React__namespace.createElement("ellipse", {
+    id: id,
     className: "circle",
     cx: centerPx[X],
     cy: centerPx[Y],
@@ -45530,7 +45643,7 @@ const init = function () {
 
 // This file is processed by a Rollup plugin (replace) to inject the production
 const libName = "@khanacademy/perseus";
-const libVersion = "48.0.0";
+const libVersion = "48.2.0";
 perseusCore.addLibraryVersionToPerseusDebug(libName, libVersion);
 
 const apiVersion = {
@@ -49196,6 +49309,7 @@ exports.lockedFigureFillStyles = lockedFigureFillStyles;
 exports.makeSafeUrl = makeSafeUrl;
 exports.mathOnlyParser = mathOnlyParser;
 exports.mediaQueries = mediaQueries;
+exports.parseDataFromJSONP = parseDataFromJSONP;
 exports.parsePerseusItem = parsePerseusItem;
 exports.plotterPlotTypes = plotterPlotTypes;
 exports.preprocessTex = preprocessTex;