@khanacademy/perseus 43.1.0 → 45.0.0

package/dist/index.js

@@ -384,7 +384,8 @@ const mockStrings = {
     } = _ref28;
     return `Interactive elements: ${elements}`;
   },
-  srNoInteractiveElements: "No interactive elements"
+  srNoInteractiveElements: "No interactive elements",
+  selectAnAnswer: "Select an answer"
 };
 
 /**
@@ -14756,9 +14757,9 @@ const pluck = function (table, subKey) {
  *   });
  * {a: 2, b: 3}
  */
-const mapObject$1 = function (obj, lambda) {
+const mapObject$2 = function (obj, lambda) {
   const result = {};
-  ___default["default"].each(___default["default"].keys(obj), function (key) {
+  Object.keys(obj).forEach(key => {
     // @ts-expect-error - TS2345 - Argument of type 'string' is not assignable to parameter of type 'K'.
     result[key] = lambda(obj[key], key);
   });
@@ -14775,14 +14776,14 @@ const mapObject$1 = function (obj, lambda) {
  */
 const mapObjectFromArray = function (arr, lambda) {
   const result = {};
-  ___default["default"].each(arr, function (elem) {
+  arr.forEach(elem => {
     result[elem] = lambda(elem);
   });
   return result;
 };
 var objective_ = {
   pluck: pluck,
-  mapObject: mapObject$1,
+  mapObject: mapObject$2,
   mapObjectFromArray: mapObjectFromArray
 };
 
@@ -16829,7 +16830,7 @@ class Graphie extends React__namespace.Component {
   };
   _setupGraphie = () => {
     this._removeMovables();
-    const graphieDiv = ReactDOM__default["default"].findDOMNode(this.graphieDivRef.current);
+    const graphieDiv = this.graphieDivRef.current;
     if (graphieDiv == null || graphieDiv instanceof Text) {
       throw new Error("No graphie container div found");
     }
@@ -18918,6 +18919,138 @@ class QuestionParagraph extends React__namespace.Component {
   }
 }
 
+// These are all the current widgets that require user-input and are supported for automatic scoring
+const QUESTION_WIDGETS = ["numeric-input", "input-number", "radio", "interactive-graph", "interactive-number-line", "categorizer", "plotter", "orderer", "protractor", "matcher", "sorter"];
+
+/**
+ * Regex for widget placeholders in a string.
+ *
+ * First capture group is the widget ID (ex. 'radio 1')
+ * Second capture group is the widget type (ex. "radio)
+ * exec return will look like: ['[[☃ radio 1]]', 'radio 1', 'radio']
+ */
+function getWidgetRegex() {
+  return /\[\[☃ ([A-Za-z0-9- ]+)\]\]/g;
+}
+
+/**
+ * Add a widget placeholder using the widget ID.
+ * ex. addWidget("radio 1") => "[[☃ radio 1]]"
+ *
+ * @param {string} id
+ * @returns {string}
+ */
+function addWidget(id) {
+  return `[[☃ ${id}]]`;
+}
+
+/**
+ * Get a widget type by a widget's ID
+ * (please don't derive type from ID)
+ *
+ * @param {string} widgetId the ID of the widget
+ * @param {PerseusWidgetsMap} widgetMap widget ID to widget map
+ * @returns {string} the widget type (ie "radio")
+ */
+function getWidgetTypeByWidgetId(WidgetId, widgetMap) {
+  const widget = widgetMap[WidgetId];
+  return widget?.type ?? null;
+}
+
+/**
+ * Does the content have a specific type of widget?
+ *
+ * @param {string} type the type of the widget in question (ie "radio")
+ * @param {string} content the string to search through
+ * @param {PerseusWidgetsMap} widgetMap widget ID to widget map
+ * @returns {boolean} if the content includes the widget type
+ */
+function contentHasWidgetType(type, content, widgetMap) {
+  return getWidgetIdsFromContentByType(type, content, widgetMap).length > 0;
+}
+
+/**
+ * Extract all widget IDs, which includes the widget type and instance number.
+ * example output: ['radio 1', 'categorizer 1', 'categorizor 2']
+ *
+ * Content should contain Perseus widget placeholders,
+ * which look like: '[[☃ radio 1]]'.
+ *
+ * @param {string} content
+ * @returns {ReadonlyArray<string>} widgetIds
+ */
+function getWidgetIdsFromContent(content) {
+  const widgets = [];
+  const localWidgetRegex = getWidgetRegex();
+  let match = localWidgetRegex.exec(content);
+  while (match !== null) {
+    widgets.push(match[1]);
+    match = localWidgetRegex.exec(content);
+  }
+  return widgets;
+}
+
+/**
+ * Get a list of widget IDs from content,
+ * but only for specific widget types
+ *
+ * @param {string} type the type of widget (ie "radio")
+ * @param {string} content the string to parse
+ * @param {PerseusWidgetsMap} widgetMap widget ID to widget map
+ * @returns {ReadonlyArray<string>} the widget type (ie "radio")
+ */
+function getWidgetIdsFromContentByType(type, content, widgetMap) {
+  const rv = [];
+  const widgetIdsInContent = getWidgetIdsFromContent(content);
+  widgetIdsInContent.forEach(widgetId => {
+    const widget = widgetMap[widgetId];
+    if (widget?.type === type) {
+      rv.push(widgetId);
+    }
+  });
+  return rv;
+}
+
+/**
+ * Pull the widget map out of ItemData
+ *
+ * @param {PerseusItem} PerseusItem containing a widgetMap
+ * @returns {WidgetMap} the widget map in the PerseusItem
+ */
+function getWidgetsMapFromItemData(itemData) {
+  return itemData.question.widgets;
+}
+
+/**
+ * Get the widget information from a WidgetMap
+ *
+ * @param {string} widgetId the ID of the widget
+ * @returns {PerseusWidget | null} the widget data if it exists, otherwise null
+ */
+function getWidgetFromWidgetMap(widgetId, widgetMap) {
+  return widgetMap[widgetId] ?? null;
+}
+
+/**
+ * Get select widgets from a widget map.
+ * Useful for multi-items that needs to split
+ * one PerseusItem into several
+ *
+ * @param {ReadonlyArray<string>} widgetIds to extract
+ * @param {PerseusWidgetsMap} widgetMap to extract from
+ * @return {PerseusWidgetsMap} a new widget map with requested widgets
+ */
+function getWidgetsFromWidgetMap(widgetIds, widgetMap) {
+  const widgets = {};
+  widgetIds.forEach(widgetId => {
+    const widget = getWidgetFromWidgetMap(widgetId, widgetMap);
+    if (widget) {
+      widgets[widgetId] = widget;
+    }
+  });
+  return widgets;
+}
+
 const DEFAULT_ALIGNMENT$1 = "block";
 // NOTE(kevinb): "default" is not one in `validAlignments`.
 const DEFAULT_SUPPORTED_ALIGNMENTS = ["default"];
@@ -19348,12 +19481,38 @@ var widgets$1 = /*#__PURE__*/Object.freeze({
   isLintable: isLintable
 });
 
+const {
+  mapObject: mapObject$1
+} = objective_;
+function getUpgradedWidgetOptions(oldWidgetOptions) {
+  // @ts-expect-error - TS2322 - Type '(props: Props) => Partial<Record<string, CategorizerWidget | CSProgramWidget | DefinitionWidget | DropdownWidget | ... 35 more ... | VideoWidget>>' is not assignable to type '(props: Props) => { [key: string]: PerseusWidget; }'.
+  return mapObject$1(oldWidgetOptions, (widgetInfo, widgetId) => {
+    if (!widgetInfo.type || !widgetInfo.alignment) {
+      const newValues = {};
+      if (!widgetInfo.type) {
+        // TODO: why does widget have no type?
+        // We don't want to derive type from widget ID
+        // see: LEMS-1845
+        newValues.type = widgetId.split(" ")[0];
+      }
+      if (!widgetInfo.alignment) {
+        newValues.alignment = "default";
+      }
+      widgetInfo = {
+        ...widgetInfo,
+        ...newValues
+      };
+    }
+    return upgradeWidgetInfoToLatestVersion(widgetInfo);
+  });
+}
 function emptyWidgetsFunctional(widgets,
 // This is a port of old code, I'm not sure why
 // we need widgetIds vs the keys of the widgets object
 widgetIds, userInputMap, strings, locale) {
+  const upgradedWidgets = getUpgradedWidgetOptions(widgets);
   return widgetIds.filter(id => {
-    const widget = widgets[id];
+    const widget = upgradedWidgets[id];
     if (!widget || widget.static) {
       // Static widgets shouldn't count as empty
       return false;
@@ -19372,12 +19531,27 @@ widgetIds, userInputMap, strings, locale) {
     }
   });
 }
+
+// TODO: combine scorePerseusItem with scoreWidgetsFunctional
+// once scorePerseusItem is the only one calling scoreWidgetsFunctional
+function scorePerseusItem(perseusRenderData, userInputMap,
+// TODO(LEMS-2461,LEMS-2391): these probably
+// need to be removed before we move this to the server
+strings, locale) {
+  // There seems to be a chance that PerseusRenderer.widgets might include
+  // widget data for widgets that are not in PerseusRenderer.content,
+  // so this checks that the widgets are being used before scoring them
+  const usedWidgetIds = getWidgetIdsFromContent(perseusRenderData.content);
+  const scores = scoreWidgetsFunctional(perseusRenderData.widgets, usedWidgetIds, userInputMap, strings, locale);
+  return Util.flattenScores(scores);
+}
 function scoreWidgetsFunctional(widgets,
 // This is a port of old code, I'm not sure why
 // we need widgetIds vs the keys of the widgets object
 widgetIds, userInputMap, strings, locale) {
+  const upgradedWidgets = getUpgradedWidgetOptions(widgets);
   const gradedWidgetIds = widgetIds.filter(id => {
-    const props = widgets[id];
+    const props = upgradedWidgets[id];
     const widgetIsGraded = props?.graded == null || props.graded;
     const widgetIsStatic = !!props?.static;
     // Ungraded widgets or widgets set to static shouldn't be graded.
@@ -19385,14 +19559,14 @@ widgetIds, userInputMap, strings, locale) {
   });
   const widgetScores = {};
   gradedWidgetIds.forEach(id => {
-    const widget = widgets[id];
+    const widget = upgradedWidgets[id];
     if (!widget) {
       return;
     }
     const userInput = userInputMap[id];
     const scorer = getWidgetScorer(widget.type);
     if (widget.type === "group") {
-      const scores = scoreWidgetsFunctional(widget.options.widgets, Object.keys(widget.options.widgets), userInputMap[id], strings, locale);
+      const scores = scoreWidgetsFunctional(widget.options.widgets, getWidgetIdsFromContent(widget.options.content), userInputMap[id], strings, locale);
       widgetScores[id] = Util.flattenScores(scores);
     } else if (scorer) {
       widgetScores[id] = scorer(userInput, widget.options, strings, locale);
@@ -19917,32 +20091,12 @@ class Renderer extends React__namespace.Component {
     };
   };
   _getInitialWidgetState = props => {
-    const allWidgetInfo = this._getAllWidgetsInfo(props);
+    const allWidgetInfo = getUpgradedWidgetOptions(props.widgets);
     return {
       widgetInfo: allWidgetInfo,
       widgetProps: this._getAllWidgetsStartProps(allWidgetInfo, props)
     };
   };
-
-  // @ts-expect-error - TS2322 - Type '(props: Props) => Partial<Record<string, CategorizerWidget | CSProgramWidget | DefinitionWidget | DropdownWidget | ... 35 more ... | VideoWidget>>' is not assignable to type '(props: Props) => { [key: string]: PerseusWidget; }'.
-  _getAllWidgetsInfo = props => {
-    return mapObject(props.widgets, (widgetInfo, widgetId) => {
-      if (!widgetInfo.type || !widgetInfo.alignment) {
-        const newValues = {};
-        if (!widgetInfo.type) {
-          // TODO: why does widget have no type?
-          // We don't want to derive type from widget ID
-          // see: LEMS-1845
-          newValues.type = widgetId.split(" ")[0];
-        }
-        if (!widgetInfo.alignment) {
-          newValues.alignment = "default";
-        }
-        widgetInfo = ___default["default"].extend({}, widgetInfo, newValues);
-      }
-      return upgradeWidgetInfoToLatestVersion(widgetInfo);
-    });
-  };
   _getAllWidgetsStartProps = (allWidgetInfo, props) => {
     const {
       apiOptions,
@@ -20441,7 +20595,7 @@ class Renderer extends React__namespace.Component {
       // Instead, we center them with css magic in styles.less
       // /cry(aria)
       this._foundTextNodes = true;
-      if (___default["default"].contains(this.widgetIds, node.id)) {
+      if (this.widgetIds.includes(node.id)) {
         // We don't want to render a duplicate widget key/ref,
         // as this causes problems with react (for obvious
         // reasons). Instead we just notify the
@@ -20766,7 +20920,7 @@ class Renderer extends React__namespace.Component {
   };
   getInputPaths = () => {
     const inputPaths = [];
-    ___default["default"].each(this.widgetIds, widgetId => {
+    this.widgetIds.forEach(widgetId => {
       const widget = this.getWidgetInstance(widgetId);
       if (widget && widget.getInputPaths) {
         // Grab all input paths and add widgetID to the front
@@ -20774,7 +20928,7 @@ class Renderer extends React__namespace.Component {
         // Prefix paths with their widgetID and add to collective
         // list of paths.
         // @ts-expect-error - TS2345 - Argument of type '(inputPath: string) => void' is not assignable to parameter of type 'CollectionIterator<FocusPath, void, readonly FocusPath[]>'.
-        ___default["default"].each(widgetInputPaths, inputPath => {
+        widgetInputPaths.forEach(inputPath => {
           const relativeInputPath = [widgetId].concat(inputPath);
           inputPaths.push(relativeInputPath);
         });
@@ -20967,33 +21121,30 @@ class Renderer extends React__namespace.Component {
   }
 
   /**
-   * Returns an object mapping from widget ID to perseus-style score.
-   * The keys of this object are the values of the array returned
-   * from `getWidgetIds`.
-   */
-  scoreWidgets() {
-    return scoreWidgetsFunctional(this.state.widgetInfo, this.widgetIds, this.getUserInputMap(), this.props.strings, this.context.locale);
-  }
-
-  /**
-   * Grades the content.
+   * Scores the content.
+   *
+   * @deprecated use scorePerseusItem
    */
   score() {
-    const scores = this.scoreWidgets();
+    const scores = scoreWidgetsFunctional(this.state.widgetInfo, this.widgetIds, this.getUserInputMap(), this.props.strings, this.context.locale);
     const combinedScore = Util.flattenScores(scores);
     return combinedScore;
   }
-  guessAndScore() {
+
+  /**
+   * @deprecated use scorePerseusItem
+   */
+  guessAndScore = () => {
     const totalGuess = this.getUserInput();
     const totalScore = this.score();
     return [totalGuess, totalScore];
-  }
+  };
   examples = () => {
     const widgetIds = this.widgetIds;
-    const examples = ___default["default"].compact(___default["default"].map(widgetIds, widgetId => {
+    const examples = widgetIds.map(widgetId => {
       const widget = this.getWidgetInstance(widgetId);
       return widget != null && widget.examples ? widget.examples() : null;
-    }));
+    }).filter(Boolean);
 
     // no widgets with examples
     if (!examples.length) {
@@ -21376,6 +21527,7 @@ const HORIZONTAL_ALIGNMNENTS = {
  * ```
  */
 class Tooltip extends React__namespace.Component {
+  tooltipContainerRef = /*#__PURE__*/React__namespace.createRef();
   static defaultProps = {
     className: "",
     arrowSize: 10,
@@ -21458,8 +21610,7 @@ class Tooltip extends React__namespace.Component {
         display: this.props.show ? "block" : "none"
       }
     }, /*#__PURE__*/React__namespace.createElement("div", {
-      // eslint-disable-next-line react/no-string-refs
-      ref: "tooltipContainer",
+      ref: this.tooltipContainerRef,
       className: "tooltipContainer",
       style: {
         position: "absolute",
@@ -21486,10 +21637,8 @@ class Tooltip extends React__namespace.Component {
     }, this.props.children.slice(1)), arrowBelow));
   }
   _updateHeight() {
-    const tooltipContainer = ReactDOM__default["default"].findDOMNode(
-    // eslint-disable-next-line react/no-string-refs
-    this.refs.tooltipContainer);
-    const height = tooltipContainer.offsetHeight;
+    const tooltipContainer = this.tooltipContainerRef.current;
+    const height = tooltipContainer?.offsetHeight || 0;
     if (height !== this.state.height) {
       this.setState({
         height
@@ -27443,6 +27592,7 @@ function scoreDropdown(userInput, rubric) {
 }
 
 class Dropdown extends React__namespace.Component {
+  static contextType = PerseusI18nContext;
   static defaultProps = {
     choices: [],
     selected: 0,
@@ -27485,26 +27635,44 @@ class Dropdown extends React__namespace.Component {
       value: String(i + 1),
       label: choice
     }))];
-    return /*#__PURE__*/React__namespace.createElement("div", {
-      // NOTE(jared): These are required to prevent weird behavior
-      // When there's a dropdown in a zoomable table.
+    return /*#__PURE__*/React__namespace.createElement(wonderBlocksCore.UniqueIDProvider, {
+      scope: "dropdown-widget",
+      mockOnFirstRender: true
+    }, ids => /*#__PURE__*/React__namespace.createElement(wonderBlocksCore.View
+    // NOTE(jared): These are required to prevent weird behavior
+    // When there's a dropdown in a zoomable table.
+    , {
       onClick: e => {
         e.stopPropagation();
       },
       onTouchStart: e => {
         e.stopPropagation();
       }
-    }, /*#__PURE__*/React__namespace.createElement(wonderBlocksDropdown.SingleSelect, {
+    }, this.props.visibleLabel && /*#__PURE__*/React__namespace.createElement(wonderBlocksTypography.LabelLarge, {
+      tag: "label",
+      id: ids.get("dropdown-label")
+    }, this.props.visibleLabel), /*#__PURE__*/React__namespace.createElement(wonderBlocksDropdown.SingleSelect, {
+      id: ids.get("dropdown"),
       placeholder: "",
       onChange: value => this._handleChange(parseInt(value)),
       selectedValue: String(this.props.selected),
-      disabled: this.props.apiOptions.readOnly
-    }, children));
+      disabled: this.props.apiOptions.readOnly,
+      "aria-label": this.props.ariaLabel || this.context.strings.selectAnAnswer,
+      "aria-labelledby": ids.get("dropdown-label")
+      // This is currently necessary for SRs to read the labels properly.
+      // However, WB is working on a change to add the "combobox" role to
+      // all dropdowns.
+      // See https://khanacademy.atlassian.net/browse/WB-1671
+      ,
+      role: "combobox"
+    }, children)));
   }
 }
 const optionsTransform = widgetOptions => {
   return {
     placeholder: widgetOptions.placeholder,
+    visibleLabel: widgetOptions.visibleLabel,
+    ariaLabel: widgetOptions.ariaLabel,
     choices: widgetOptions.choices.map(choice => choice.content)
   };
 };
@@ -29584,6 +29752,9 @@ class Group extends React__namespace.Component {
         this.change("widgets", this.rendererRef.props.widgets);
       }
     };
+
+    // TODO(LEMS-2391): replace this when there's a separate check
+    // for valid/invalid state
     const score = this.rendererRef?.score();
     const isValid = score && score.type !== "invalid";
     const isInvalid = score && score.type === "invalid";
@@ -30630,6 +30801,7 @@ function numSteps$1(range, step) {
   return Math.floor((range[1] - range[0]) / step);
 }
 class Graph extends React__namespace.Component {
+  graphieDivRef = /*#__PURE__*/React__namespace.createRef();
   protractor;
   ruler;
   _graphie;
@@ -30709,9 +30881,7 @@ class Graph extends React__namespace.Component {
     if (this._hasSetupGraphieThisUpdate) {
       return;
     }
-
-    // eslint-disable-next-line react/no-string-refs
-    const graphieDiv = ReactDOM__default["default"].findDOMNode(this.refs.graphieDiv);
+    const graphieDiv = this.graphieDivRef.current;
     // @ts-expect-error - TS2769 - No overload matches this call. | TS2339 - Property 'empty' does not exist on type 'JQueryStatic'.
     $__default["default"](graphieDiv).empty();
 
@@ -30900,7 +31070,7 @@ class Graph extends React__namespace.Component {
       onClick: this.onClick
     }, image, /*#__PURE__*/React__namespace.createElement("div", {
       className: "graphie",
-      ref: "graphieDiv"
+      ref: this.graphieDivRef
     }));
   }
 }
@@ -31986,13 +32156,13 @@ class InfoTip extends React__namespace.Component {
  * this component allows multiple selection!
  */
 class MultiButtonGroup extends React__namespace.Component {
+  buttonContainerRef = /*#__PURE__*/React__namespace.createRef();
   static defaultProps = {
     values: [],
     allowEmpty: true
   };
   focus() {
-    // @ts-expect-error - TS2339 - Property 'focus' does not exist on type 'Element | Text'.
-    ReactDOM__namespace.findDOMNode(this)?.focus();
+    this.buttonContainerRef.current?.focus();
     return true;
   }
   toggleSelect = newValue => {
@@ -32027,7 +32197,8 @@ class MultiButtonGroup extends React__namespace.Component {
       display: "inline-block"
     };
     return /*#__PURE__*/React__namespace.createElement("div", {
-      style: outerStyle
+      style: outerStyle,
+      ref: this.buttonContainerRef
     }, buttons);
   }
 }
@@ -45209,7 +45380,7 @@ const init = function () {
 
 // This file is processed by a Rollup plugin (replace) to inject the production
 const libName = "@khanacademy/perseus";
-const libVersion = "43.1.0";
+const libVersion = "45.0.0";
 perseusCore.addLibraryVersionToPerseusDebug(libName, libVersion);
 
 const apiVersion = {
@@ -45813,6 +45984,13 @@ class ServerItemRenderer extends React__namespace.Component {
         this.props.onRendered(true);
       }
     }
+    if (this.props.score && this.props.score !== prevProps.score) {
+      const emptyQuestionAreaWidgets = this.questionRenderer.emptyWidgets();
+      this.setState({
+        questionCompleted: this.props.score.correct,
+        questionHighlightedWidgets: emptyQuestionAreaWidgets
+      });
+    }
   }
   componentWillUnmount() {
     if (this.blurTimeoutID != null) {
@@ -45948,18 +46126,37 @@ class ServerItemRenderer extends React__namespace.Component {
     return this.questionRenderer.getPromptJSON();
   }
 
+  /**
+   * Returns an array of the widget `.getUserInput()` results
+   *
+   * TODO: can we remove this? Seems to be just for backwards
+   * compatibility with old Perseus Chrome logging
+   * @deprecated use getUserInput
+   */
+  getUserInputLegacy() {
+    return this.questionRenderer.getUserInput();
+  }
+
+  /**
+   * Returns an object of the widget `.getUserInput()` results
+   */
+  getUserInput() {
+    return this.questionRenderer.getUserInputMap();
+  }
+
   /**
    * Grades the item.
+   *
+   * @deprecated use scorePerseusItem
    */
   scoreInput() {
-    const guessAndScore = this.questionRenderer.guessAndScore();
-    const guess = guessAndScore[0];
-    const score = guessAndScore[1];
+    const guess = this.getUserInput();
+    const score = scorePerseusItem(this.props.item.question, guess, this.context.strings, this.context.locale);
 
     // Continue to include an empty guess for the now defunct answer area.
     // TODO(alex): Check whether we rely on the format here for
     //             analyzing ProblemLogs. If not, remove this layer.
-    const maxCompatGuess = [guess, []];
+    const maxCompatGuess = [this.questionRenderer.getUserInput(), []];
     const keScore = Util.keScoreFromPerseusScore(score, maxCompatGuess, this.questionRenderer.getSerializedState());
     const emptyQuestionAreaWidgets = this.questionRenderer.emptyWidgets();
     this.setState({
@@ -47821,138 +48018,6 @@ const registerAllWidgetsForTesting = () => {
   replaceDeprecatedWidgets();
 };
 
-// These are all the current widgets that require user-input and are supported for automatic scoring
-const QUESTION_WIDGETS = ["numeric-input", "input-number", "radio", "interactive-graph", "interactive-number-line", "categorizer", "plotter", "orderer", "protractor", "matcher", "sorter"];
-
-/**
- * Regex for widget placeholders in a string.
- *
- * First capture group is the widget ID (ex. 'radio 1')
- * Second capture group is the widget type (ex. "radio)
- * exec return will look like: ['[[☃ radio 1]]', 'radio 1', 'radio']
- */
-function getWidgetRegex() {
-  return /\[\[☃ ([A-Za-z0-9- ]+)\]\]/g;
-}
-
-/**
- * Add a widget placeholder using the widget ID.
- * ex. addWidget("radio 1") => "[[☃ radio 1]]"
- *
- * @param {string} id
- * @returns {string}
- */
-function addWidget(id) {
-  return `[[☃ ${id}]]`;
-}
-
-/**
- * Get a widget type by a widget's ID
- * (please don't derive type from ID)
- *
- * @param {string} widgetId the ID of the widget
- * @param {PerseusWidgetsMap} widgetMap widget ID to widget map
- * @returns {string} the widget type (ie "radio")
- */
-function getWidgetTypeByWidgetId(WidgetId, widgetMap) {
-  const widget = widgetMap[WidgetId];
-  return widget?.type ?? null;
-}
-
-/**
- * Does the content have a specific type of widget?
- *
- * @param {string} type the type of the widget in question (ie "radio")
- * @param {string} content the string to search through
- * @param {PerseusWidgetsMap} widgetMap widget ID to widget map
- * @returns {boolean} if the content includes the widget type
- */
-function contentHasWidgetType(type, content, widgetMap) {
-  return getWidgetIdsFromContentByType(type, content, widgetMap).length > 0;
-}
-
-/**
- * Extract all widget IDs, which includes the widget type and instance number.
- * example output: ['radio 1', 'categorizer 1', 'categorizor 2']
- *
- * Content should contain Perseus widget placeholders,
- * which look like: '[[☃ radio 1]]'.
- *
- * @param {string} content
- * @returns {ReadonlyArray<string>} widgetIds
- */
-function getWidgetIdsFromContent(content) {
-  const widgets = [];
-  const localWidgetRegex = getWidgetRegex();
-  let match = localWidgetRegex.exec(content);
-  while (match !== null) {
-    widgets.push(match[1]);
-    match = localWidgetRegex.exec(content);
-  }
-  return widgets;
-}
-
-/**
- * Get a list of widget IDs from content,
- * but only for specific widget types
- *
- * @param {string} type the type of widget (ie "radio")
- * @param {string} content the string to parse
- * @param {PerseusWidgetsMap} widgetMap widget ID to widget map
- * @returns {ReadonlyArray<string>} the widget type (ie "radio")
- */
-function getWidgetIdsFromContentByType(type, content, widgetMap) {
-  const rv = [];
-  const widgetIdsInContent = getWidgetIdsFromContent(content);
-  widgetIdsInContent.forEach(widgetId => {
-    const widget = widgetMap[widgetId];
-    if (widget?.type === type) {
-      rv.push(widgetId);
-    }
-  });
-  return rv;
-}
-
-/**
- * Pull the widget map out of ItemData
- *
- * @param {PerseusItem} PerseusItem containing a widgetMap
- * @returns {WidgetMap} the widget map in the PerseusItem
- */
-function getWidgetsMapFromItemData(itemData) {
-  return itemData.question.widgets;
-}
-
-/**
- * Get the widget information from a WidgetMap
- *
- * @param {string} widgetId the ID of the widget
- * @returns {PerseusWidget | null} the widget data if it exists, otherwise null
- */
-function getWidgetFromWidgetMap(widgetId, widgetMap) {
-  return widgetMap[widgetId] ?? null;
-}
-
-/**
- * Get select widgets from a widget map.
- * Useful for multi-items that needs to split
- * one PerseusItem into several
- *
- * @param {ReadonlyArray<string>} widgetIds to extract
- * @param {PerseusWidgetsMap} widgetMap to extract from
- * @return {PerseusWidgetsMap} a new widget map with requested widgets
- */
-function getWidgetsFromWidgetMap(widgetIds, widgetMap) {
-  const widgets = {};
-  widgetIds.forEach(widgetId => {
-    const widget = getWidgetFromWidgetMap(widgetId, widgetMap);
-    if (widget) {
-      widgets[widgetId] = widget;
-    }
-  });
-  return widgets;
-}
-
 /**
  * This function extracts the answers from the widgets.
  *
@@ -48896,6 +48961,8 @@ const parseDefinitionWidget = parseWidget(constant("definition"), object({
 
 const parseDropdownWidget = parseWidget(constant("dropdown"), object({
   placeholder: string,
+  ariaLabel: optional(string),
+  visibleLabel: optional(string),
   static: defaulted(boolean, () => false),
   choices: array(object({
     content: string,
@@ -50120,6 +50187,7 @@ exports.parsePerseusItem = parsePerseusItem;
 exports.plotterPlotTypes = plotterPlotTypes;
 exports.preprocessTex = preprocessTex;
 exports.registerAllWidgetsForTesting = registerAllWidgetsForTesting;
+exports.scorePerseusItem = scorePerseusItem;
 exports.shapes = shapes;
 exports.shouldHaveIndividualAnswer = shouldHaveIndividualAnswer;
 exports.traverse = traverse;