@khanacademy/perseus 48.0.0 → 48.1.0

package/dist/components/svg-image.d.ts

@@ -92,10 +92,6 @@ declare class SvgImage extends React.Component<Props, State> {
     componentWillUnmount(): void;
     isLoadedInState(state: State): boolean;
     loadResources(): void;
-    onDataLoaded: (data: {
-        labels: ReadonlyArray<any>;
-        range: [Coord, Coord];
-    }, localized: boolean) => void;
     sizeProvided(): boolean;
     onImageLoad: () => void;
     setupGraphie: (graphie?: any, options?: any) => void;

package/dist/es/index.js

@@ -3373,6 +3373,162 @@ 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 PerseusError("not a valid URL", 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 != null && response.ok)) {
+        errorCallback();
+        return;
+      }
+      const jsonp = await response.text();
+      const data = parseDataFromJSONP(hash, jsonp, error => {
+        Log.error("Failed to parse JSONP for svg-image", 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] = _extends({}, 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", Errors.Service, {
+        cause: error,
+        loggedMetadata: {
+          dataUrl: Util.getDataUrl(url),
+          status
+        }
+      });
+    };
+    if (shouldUseLocalizedData()) {
+      cacheData.localized = false;
+      // If there is isn't any localized data, fall back to
+      // the original, unlocalized data
+      retrieveData(getLocalizedDataUrl(url), dataLoadErrorHandler);
+    } else {
+      retrieveData(Util.getDataUrl(url), dataLoadErrorHandler);
+    }
+  }
+}
+
 // Derived from the MIT-licensed:
 
 /*jshint browser:true, node:true */
@@ -8959,6 +9115,9 @@ class Graphie$1 {
     $(el).css("position", "relative");
     this.raphael = Raphael$1(el);
 
+    // Hide the Raphael canvas from screen readers
+    $(el).attr("aria-hidden", "true");
+
     // For a sometimes-reproducible IE8 bug; doesn't affect SVG browsers at all
     $(el).children("div").css("position", "absolute");
   }
@@ -16832,101 +16991,11 @@ class ImageLoader extends React.Component {
 
 // 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 doJSONP(url, options) {
-  var _document$head2;
-  options = _extends({
-    callbackName: "callback",
-    success: $.noop,
-    error: $.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() {
-    var _document$head;
-    (_document$head = document.head) == null || _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 (...args) {
-    cleanup();
-    options.success.apply(null, args);
-  };
-
-  // Add the error handler.
-  script.addEventListener("error", function (...args) {
-    cleanup();
-    options.error.apply(null, args);
-  });
-
-  // Insert the script to start the download.
-  (_document$head2 = document.head) == null || _document$head2.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 PerseusError("not a valid URL", Errors.InvalidInput);
-  }
-  return match && match[1];
-}
 function defaultPreloader(dimensions) {
   return /*#__PURE__*/React.createElement("span", {
     style: {
@@ -16948,20 +17017,6 @@ class SvgImage extends React.Component {
   constructor(props) {
     super(props);
     this._isMounted = void 0;
-    this.onDataLoaded = (data, localized) => {
-      if (this._isMounted && data.labels && data.range) {
-        const labelsRendered = data.labels.reduce((dict, label) => _extends({}, dict, {
-          [label.content]: false
-        }), {});
-        this.setState({
-          dataLoaded: true,
-          labelDataIsLocalized: localized,
-          labelsRendered,
-          labels: data.labels,
-          range: data.range
-        });
-      }
-    };
     this.onImageLoad = () => {
       // Only need to do this if rendering a Graphie
       if (this.sizeProvided()) {
@@ -17137,74 +17192,21 @@ class SvgImage extends React.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;
-            _.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
-        });
-      };
-      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", Errors.Service, {
-              cause: error,
-              loggedMetadata: {
-                dataUrl: Util.getDataUrl(this.props.src),
-                status
-              }
-            });
-          });
+    loadGraphie(this.props.src, (data, localized) => {
+      if (this._isMounted && data.labels && data.range) {
+        const labelsRendered = {};
+        data.labels.forEach(label => {
+          labelsRendered[label.content] = false;
         });
-      } else {
-        retrieveData(Util.getDataUrl(this.props.src), (x, status, error) => {
-          Log.error("Data load failed for svg-image", 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
         });
       }
-    }
+    });
   }
   sizeProvided() {
     return this.props.width != null && this.props.height != null;
@@ -45170,7 +45172,7 @@ const init = function init() {
 
 // 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.1.0";
 addLibraryVersionToPerseusDebug(libName, libVersion);
 
 const apiVersion = {
@@ -48722,5 +48724,5 @@ const ScoringUtil = {
  * Types
  */
 
-export { ApiOptions, ArticleRenderer, BaseRadio, Categorizer$1 as Categorizer, changeable as Changeable, ClassNames, dependencies as Dependencies, EditorJsonify, Expression, GrapherUtil, Grapher$1 as GrapherWidget, HintRenderer, HintsRenderer, InputNumber$1 as InputNumber, InteractiveGraph$1 as InteractiveGraphWidget, ItemExtras, JiptParagraphs, KhanColors, KhanMath, context as LoadingContext, Log, Matrix$1 as MatrixWidget, NumericInput$1 as NumericInput, PerseusExpressionAnswerFormConsidered, PerseusI18nContext, PerseusI18nContextProvider, PerseusMarkdown, Plotter$1 as PlotterWidget, QUESTION_WIDGETS, Radio, Renderer, ScoringUtil, ref as ServerItemRenderer, Table$1 as TableWidget, Util, denylist as WIDGET_PROP_DENYLIST, widgets$1 as Widgets, addWidget, apiVersion, bodyXsmallBold, components, containerSizeClass, contentHasWidgetType, convertWidgetNameToEnum, displaySigFigs, generateTestCategorizerWidget, generateTestExpressionWidget, generateTestInteractiveGraphWidget, generateTestNumericInputWidget, generateTestPerseusItem, generateTestRadioWidget, genericPerseusItemData, getAngleCoords, getAnswerFromUserInput, getAnswersFromWidgets, getCircleCoords, getClockwiseAngle, getCorrectAnswerForWidgetId, getImagesWithoutAltData, getInteractiveBoxFromSizeClass, getLineCoords, getLinearSystemCoords, getPointCoords, getPolygonCoords, getQuadraticCoords, getSegmentCoords, getSinusoidCoords, getValidWidgetIds, getWidgetFromWidgetMap, getWidgetIdsFromContent, getWidgetIdsFromContentByType, getWidgetTypeByWidgetId, getWidgetsFromWidgetMap, getWidgetsMapFromItemData, iconChevronDown, iconTrash, init, injectWidgets, interactiveSizes$1 as interactiveSizes, isItemRenderableByVersion, isWidgetIdInContent, isWrongAnswerSupported, itemDataVersion, ItemVersion as itemVersion, libVersion, lockedFigureColors, lockedFigureFillStyles, makeSafeUrl, mathOnlyParser, mediaQueries, parsePerseusItem, plotterPlotTypes, preprocessTex, registerAllWidgetsForTesting, scorePerseusItem, shouldHaveIndividualAnswer, traverse, usePerseusI18n, violatingWidgets, allWidgets as widgets };
+export { ApiOptions, ArticleRenderer, BaseRadio, Categorizer$1 as Categorizer, changeable as Changeable, ClassNames, dependencies as Dependencies, EditorJsonify, Expression, GrapherUtil, Grapher$1 as GrapherWidget, HintRenderer, HintsRenderer, InputNumber$1 as InputNumber, InteractiveGraph$1 as InteractiveGraphWidget, ItemExtras, JiptParagraphs, KhanColors, KhanMath, context as LoadingContext, Log, Matrix$1 as MatrixWidget, NumericInput$1 as NumericInput, PerseusExpressionAnswerFormConsidered, PerseusI18nContext, PerseusI18nContextProvider, PerseusMarkdown, Plotter$1 as PlotterWidget, QUESTION_WIDGETS, Radio, Renderer, ScoringUtil, ref as ServerItemRenderer, Table$1 as TableWidget, Util, denylist as WIDGET_PROP_DENYLIST, widgets$1 as Widgets, addWidget, apiVersion, bodyXsmallBold, components, containerSizeClass, contentHasWidgetType, convertWidgetNameToEnum, displaySigFigs, generateTestCategorizerWidget, generateTestExpressionWidget, generateTestInteractiveGraphWidget, generateTestNumericInputWidget, generateTestPerseusItem, generateTestRadioWidget, genericPerseusItemData, getAngleCoords, getAnswerFromUserInput, getAnswersFromWidgets, getCircleCoords, getClockwiseAngle, getCorrectAnswerForWidgetId, getImagesWithoutAltData, getInteractiveBoxFromSizeClass, getLineCoords, getLinearSystemCoords, getPointCoords, getPolygonCoords, getQuadraticCoords, getSegmentCoords, getSinusoidCoords, getValidWidgetIds, getWidgetFromWidgetMap, getWidgetIdsFromContent, getWidgetIdsFromContentByType, getWidgetTypeByWidgetId, getWidgetsFromWidgetMap, getWidgetsMapFromItemData, iconChevronDown, iconTrash, init, injectWidgets, interactiveSizes$1 as interactiveSizes, isItemRenderableByVersion, isWidgetIdInContent, isWrongAnswerSupported, itemDataVersion, ItemVersion as itemVersion, libVersion, lockedFigureColors, lockedFigureFillStyles, makeSafeUrl, mathOnlyParser, mediaQueries, parseDataFromJSONP, parsePerseusItem, plotterPlotTypes, preprocessTex, registerAllWidgetsForTesting, scorePerseusItem, shouldHaveIndividualAnswer, traverse, usePerseusI18n, violatingWidgets, allWidgets as widgets };
 //# sourceMappingURL=index.js.map