@khanacademy/perseus 45.0.0 → 45.1.0

package/dist/index.js

@@ -3918,6 +3918,7 @@ Zoom.prototype.zoomImage = function () {
     this._zoomOriginal();
   }.bind(this);
   img.src = this._targetImage.src;
+  img.alt = this._targetImage.alt;
   this.$zoomedImage = $zoomedImage;
 };
 Zoom.prototype._zoomOriginal = function () {
@@ -8993,7 +8994,10 @@ var Tex$1 = {
       // We use createElement instead of JSX here because we can't name this file tex.tsx;
       // that name is already taken.
       // eslint-disable-next-line import/no-deprecated
-      render( /*#__PURE__*/React__namespace.createElement(TeX, {
+      render(
+      /*#__PURE__*/
+      // eslint-disable-next-line react/no-children-prop
+      React__namespace.createElement(TeX, {
         children: text,
         onRender: callback
       }), $texHolder[0]);
@@ -14757,7 +14761,7 @@ const pluck = function (table, subKey) {
  *   });
  * {a: 2, b: 3}
  */
-const mapObject$2 = function (obj, lambda) {
+const mapObject = function (obj, lambda) {
   const result = {};
   Object.keys(obj).forEach(key => {
     // @ts-expect-error - TS2345 - Argument of type 'string' is not assignable to parameter of type 'K'.
@@ -14766,27 +14770,6 @@ const mapObject$2 = function (obj, lambda) {
   return result;
 };
 
-/**
- * Maps an array to an object
- *
- * > mapObjectFromArray(['a', 'b'], function(elem) {
- *       return elem + elem;
- *   });
- * {a: 'aa', b: 'bb'}
- */
-const mapObjectFromArray = function (arr, lambda) {
-  const result = {};
-  arr.forEach(elem => {
-    result[elem] = lambda(elem);
-  });
-  return result;
-};
-var objective_ = {
-  pluck: pluck,
-  mapObject: mapObject$2,
-  mapObjectFromArray: mapObjectFromArray
-};
-
 /**
  * MovableLine
  */
@@ -14851,7 +14834,7 @@ ___default["default"].extend(MovableLine$4.prototype, {
     //    - are objects, not primitives (and need a deeper copy)
     //    - they don't need getters created for them
     // TODO(jack): Consider "default" once we es3ify perseus
-    objective_.pluck(MovableLineOptions, "standard")), DEFAULT_PROPS$2);
+    pluck(MovableLineOptions, "standard")), DEFAULT_PROPS$2);
   },
   /**
    * Resets the object to its state as if it were constructed with
@@ -15358,7 +15341,7 @@ class MovablePoint$5 {
       //    - are objects, not primitives (and need a deeper copy)
       //    - they don't need getters created for them
       // TODO(jack): Consider "default" once we es3ify perseus
-      objective_.pluck(MovablePointOptions, "standard")
+      pluck(MovablePointOptions, "standard")
       // We only update props here, because we want things on state to
       // be persistent, and updated appropriately in modify()
       ),
@@ -16259,7 +16242,7 @@ ___default["default"].extend(MovablePolygon.prototype, {
     //    - are objects, not primitives (and need a deeper copy)
     //    - they don't need getters created for them
     // TODO(jack): Consider "default" once we es3ify perseus
-    objective_.pluck(MovablePolygonOptions, "standard")
+    pluck(MovablePolygonOptions, "standard")
 
     // We only update props here, because we want things on state to
     // be persistent, and updated appropriately in modify()
@@ -19481,12 +19464,9 @@ 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) => {
+  return mapObject(oldWidgetOptions, (widgetInfo, widgetId) => {
     if (!widgetInfo.type || !widgetInfo.alignment) {
       const newValues = {};
       if (!widgetInfo.type) {
@@ -19517,15 +19497,8 @@ widgetIds, userInputMap, strings, locale) {
       // Static widgets shouldn't count as empty
       return false;
     }
-    let score = null;
-    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);
-      score = Util.flattenScores(scores);
-    } else if (scorer) {
-      score = scorer(userInput, widget.options, strings, locale);
-    }
+    const score = scorer?.(userInputMap[id], widget.options, strings, locale);
     if (score) {
       return Util.scoreIsEmpty(score);
     }
@@ -19565,11 +19538,9 @@ widgetIds, userInputMap, strings, locale) {
     }
     const userInput = userInputMap[id];
     const scorer = getWidgetScorer(widget.type);
-    if (widget.type === "group") {
-      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);
+    const score = scorer?.(userInput, widget.options, strings, locale);
+    if (score != null) {
+      widgetScores[id] = score;
     }
   });
   return widgetScores;
@@ -19876,9 +19847,6 @@ class WidgetContainer extends React__namespace.Component {
   }
 }
 
-const {
-  mapObject
-} = objective_;
 const rContainsNonWhitespace = /\S/;
 const rImageURL = /(web\+graphie|https):\/\/[^\s]*/;
 const noopOnRender = () => {};
@@ -20995,6 +20963,13 @@ class Renderer extends React__namespace.Component {
     }, this);
     return state;
   };
+
+  /**
+   * Returns an array of widget ids that are empty (meaning widgets where the
+   * learner has not interacted with the widget yet or has not filled in all
+   * fields).  For example, the `interactive-graph` widget is considered
+   * empty if the graph is in the starting state.
+   */
   emptyWidgets() {
     return emptyWidgetsFunctional(this.state.widgetInfo, this.widgetIds, this.getUserInputMap(), this.props.strings, this.context.locale);
   }
@@ -21048,7 +21023,7 @@ class Renderer extends React__namespace.Component {
       }, 0);
     });
   };
-  setInputValue = (path, newValue, focus) => {
+  setInputValue = (path, newValue, cb) => {
     // @ts-expect-error - TS2345 - Argument of type 'FocusPath' is not assignable to parameter of type 'List<any>'.
     const widgetId = ___default["default"].first(path);
     // @ts-expect-error - TS2345 - Argument of type 'FocusPath' is not assignable to parameter of type 'List<any>'.
@@ -21056,7 +21031,7 @@ class Renderer extends React__namespace.Component {
     const widget = this.getWidgetInstance(widgetId);
 
     // Widget handles parsing of the interWidgetPath.
-    widget?.setInputValue?.(interWidgetPath, newValue, focus);
+    widget?.setInputValue?.(interWidgetPath, newValue, cb);
   };
 
   /**
@@ -21354,6 +21329,7 @@ class TextInput extends React__namespace.Component {
       value: formattedValue,
       type: "text",
       "aria-label": labelText,
+      "aria-describedby": this.props["aria-describedby"],
       onChange: value => this.props.onChange(value),
       placeholder: placeholder,
       onFocus: onFocus,
@@ -21612,6 +21588,7 @@ class Tooltip extends React__namespace.Component {
     }, /*#__PURE__*/React__namespace.createElement("div", {
       ref: this.tooltipContainerRef,
       className: "tooltipContainer",
+      role: "tooltip",
       style: {
         position: "absolute",
         // height must start out undefined, not null, so that
@@ -21688,9 +21665,15 @@ class InputWithExamples extends React__namespace.Component {
   };
   _renderInput = () => {
     const id = this._getUniqueId();
+    const ariaId = `aria-for-${id}`;
+    // Generate text from a known set of format options that will read well in a screen reader
+    const examplesAria = this.props.examples.length === 7 ? "" : `${this.props.examples[0]}
+                   ${this.props.examples.slice(1).join(", or\n")}`
+    // @ts-expect-error TS2550: Property replaceAll does not exist on type string.
+    .replaceAll("*", "").replaceAll("$", "").replaceAll("\\ \\text{pi}", " pi").replaceAll("\\ ", " and ");
     const inputProps = {
       id: id,
-      "aria-describedby": id,
+      "aria-describedby": ariaId,
       ref: "input",
       className: this._getInputClassName(),
       labelText: this.props.labelText,
@@ -21706,7 +21689,12 @@ class InputWithExamples extends React__namespace.Component {
       autoCorrect: "off",
       spellCheck: "false"
     };
-    return /*#__PURE__*/React__namespace.createElement(TextInput, inputProps);
+    return /*#__PURE__*/React__namespace.createElement(React__namespace.Fragment, null, /*#__PURE__*/React__namespace.createElement(TextInput, inputProps), /*#__PURE__*/React__namespace.createElement("span", {
+      id: ariaId,
+      style: {
+        display: "none"
+      }
+    }, examplesAria));
   };
   _handleFocus = () => {
     this.props.onFocus();
@@ -21747,8 +21735,12 @@ class InputWithExamples extends React__namespace.Component {
   };
   render() {
     const input = this._renderInput();
-    const examplesContent = ___default["default"].map(this.props.examples, example => {
-      return "- " + example;
+    const examplesContent = this.props.examples.length <= 2 ? this.props.examples.join(" ") // A single item (with or without leading text) is not a "list"
+    : this.props.examples // 2 or more items should display as a list
+    .map((example, index) => {
+      // If the first example is bold, then it is most likely a heading/leading text.
+      // So, it shouldn't be part of the list.
+      return index === 0 && example.startsWith("**") ? `${example}\n` : `- ${example}`;
     }).join("\n");
     const showExamples = this.props.shouldShowExamples && this.state.showExamples;
     return /*#__PURE__*/React__namespace.createElement(Tooltip, {
@@ -22402,7 +22394,7 @@ function scoreNumericInput(userInput, rubric, strings) {
   // We may have received TeX; try to parse it before grading.
   // If `currentValue` is not TeX, this should be a no-op.
   const currentValue = ParseTex(userInput.currentValue);
-  const normalizedAnswerExpected = rubric.answers.filter(answer => answer.status === "correct").every(answer => Math.abs(answer.value) <= 1);
+  const normalizedAnswerExpected = rubric.answers.filter(answer => answer.status === "correct").every(answer => answer.value !== undefined && Math.abs(answer.value) <= 1);
 
   // The coefficient is an attribute of the widget
   let localValue = currentValue;
@@ -22478,7 +22470,8 @@ class NumericInput extends React__namespace.Component {
   state = {
     // keeps track of the other set of values when switching
     // between 0 and finite solutions
-    previousValues: [""]
+    previousValues: [""],
+    isFocused: false
   };
 
   // TODO(Nicole, Jeremy): This is maybe never used and should be removed
@@ -22543,9 +22536,21 @@ class NumericInput extends React__namespace.Component {
   };
   _handleFocus = () => {
     this.props.onFocus([]);
+    this.setState(currentState => {
+      return {
+        ...currentState,
+        isFocused: true
+      };
+    });
   };
   _handleBlur = () => {
     this.props.onBlur([]);
+    this.setState(currentState => {
+      return {
+        ...currentState,
+        isFocused: false
+      };
+    });
   };
   render() {
     let labelText = this.props.labelText;
@@ -22576,13 +22581,20 @@ class NumericInput extends React__namespace.Component {
     // component.
     const styles = aphrodite.StyleSheet.create({
       input: {
+        borderRadius: "3px",
+        borderWidth: this.state.isFocused ? "2px" : "1px",
+        display: "inline-block",
+        fontFamily: `Symbola, "Times New Roman", serif`,
+        fontSize: "18px",
+        height: "32px",
+        lineHeight: "18px",
+        padding: this.state.isFocused ? "4px" : "4px 5px",
+        // account for added focus border thickness
         textAlign: this.props.rightAlign ? "right" : "left",
-        width: this.props.size === "small" ? 40 : 80,
-        padding: 0,
-        height: "auto"
+        width: this.props.size === "small" ? 40 : 80
       }
     });
-    return /*#__PURE__*/React__namespace.createElement("div", null, /*#__PURE__*/React__namespace.createElement(InputWithExamples, {
+    return /*#__PURE__*/React__namespace.createElement(InputWithExamples, {
       ref: ref => this.inputRef = ref,
       value: this.props.currentValue,
       onChange: this.handleChange,
@@ -22594,7 +22606,7 @@ class NumericInput extends React__namespace.Component {
       id: this.props.widgetId,
       disabled: this.props.apiOptions.readOnly,
       style: styles.input
-    }));
+    });
   }
 }
 
@@ -27522,8 +27534,8 @@ var Definition$1 = {
   scorer: () => scoreNoop()
 };
 
-// The props are type `any` on purpose so that this can receive props
-// from any deprecated widget
+// There are no required props, but this component can receive props from any
+// deprecated widget
 class DeprecatedStandin extends React__default["default"].Component {
   static contextType = PerseusI18nContext;
   // this just helps with TS weak typing when a Widget
@@ -29646,6 +29658,13 @@ const getPromptJSON$f = rendererJSON => {
   };
 };
 
+// The `group` widget is basically a widget hosting a full Perseus system in
+// it. As such, scoring a group means scoring all widgets it contains.
+function scoreGroup(userInput, options, strings, locale) {
+  const scores = scoreWidgetsFunctional(options.widgets, Object.keys(options.widgets), userInput, strings, locale);
+  return Util.flattenScores(scores);
+}
+
 // exports has no 'transform'
 
 class Group extends React__namespace.Component {
@@ -29797,6 +29816,9 @@ var Group$1 = {
   displayName: "Group (SAT only)",
   widget: Group,
   traverseChildWidgets: traverseChildWidgets,
+  // TODO(LEMS-2656): remove TS suppression
+  // @ts-expect-error: Type 'UserInput' is not assignable to type 'PerseusCSProgramUserInput'.
+  scorer: scoreGroup,
   hidden: true,
   isLintable: true
 };
@@ -32540,6 +32562,61 @@ const LegacyGrid = _ref => {
 
 // Range is replaced within this file with Interval, but it is used elsewhere
 // and exported from the package, so we need to keep it around.
+/**
+ * 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": AutoCorrectWidget;
+ *     }
+ * }
+ *
+ * // 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.
@@ -32555,6 +32632,9 @@ const LegacyGrid = _ref => {
  * A "MultiItem" is an advanced Perseus item. It is rendered by the
  * `MultiRenderer` and you can control the layout of individual parts of the
  * item.
+ *
+ * @deprecated MultiItem support is slated for removal in a future Perseus
+ * release.
  */
 const ItemExtras = [
 // The user might benefit from using a Scientific Calculator.  Provided on Khan Academy when true
@@ -32576,6 +32656,11 @@ const ItemExtras = [
 // 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
@@ -32644,7 +32729,9 @@ const ItemExtras = [
 
 //prettier-ignore
 
-// A background image applied to various widgets.
+/**
+ * A background image applied to various widgets.
+ */
 
 const PerseusExpressionAnswerFormConsidered = ["correct", "wrong", "ungraded"];
 
@@ -37288,8 +37375,6 @@ const makeInvalidTypeError = (functionName, graphType) => {
   });
 };
 
-// There's no transform function in exports
-
 // TODO: there's another, very similar getSinusoidCoefficients function
 // they should probably be merged
 function getSinusoidCoefficients(coords) {
@@ -42407,23 +42492,37 @@ const getPromptJSON$6 = (renderProps, userInput) => {
   };
 };
 
-function scoreNumberLine(state, rubric) {
-  const range = rubric.range;
-  const divisionRange = state.divisionRange;
-  const start = rubric.initialX != null ? rubric.initialX : range[0];
-  const startRel = rubric.isInequality ? "ge" : "eq";
-  const correctRel = rubric.correctRel || "eq";
-  const correctPos = kmath.number.equal(state.numLinePosition, rubric.correctX || 0);
-  const outsideAllowedRange = state.numDivisions > divisionRange[1] || state.numDivisions < divisionRange[0];
+/**
+ * Checks user input is within the allowed range and not the same as the initial
+ * state.
+ * @param userInput
+ * @see 'scoreNumberLine' for the scoring logic.
+ */
+function validateNumberLine(userInput) {
+  const divisionRange = userInput.divisionRange;
+  const outsideAllowedRange = userInput.numDivisions > divisionRange[1] || userInput.numDivisions < divisionRange[0];
 
   // TODO: I don't think isTickCrtl is a thing anymore
-  if (state.isTickCrtl && outsideAllowedRange) {
+  if (userInput.isTickCrtl && outsideAllowedRange) {
     return {
       type: "invalid",
       message: "Number of divisions is outside the allowed range."
     };
   }
-  if (correctPos && correctRel === state.rel) {
+  return null;
+}
+
+function scoreNumberLine(userInput, scoringData) {
+  const validationError = validateNumberLine(userInput);
+  if (validationError) {
+    return validationError;
+  }
+  const range = scoringData.range;
+  const start = scoringData.initialX != null ? scoringData.initialX : range[0];
+  const startRel = scoringData.isInequality ? "ge" : "eq";
+  const correctRel = scoringData.correctRel || "eq";
+  const correctPos = kmath.number.equal(userInput.numLinePosition, scoringData.correctX || 0);
+  if (correctPos && correctRel === userInput.rel) {
     return {
       type: "points",
       earned: 1,
@@ -42431,7 +42530,7 @@ function scoreNumberLine(state, rubric) {
       message: null
     };
   }
-  if (state.numLinePosition === start && state.rel === startRel) {
+  if (userInput.numLinePosition === start && userInput.rel === startRel) {
     // We're where we started.
     return {
       type: "invalid",
@@ -45380,7 +45479,7 @@ const init = function () {
 
 // This file is processed by a Rollup plugin (replace) to inject the production
 const libName = "@khanacademy/perseus";
-const libVersion = "45.0.0";
+const libVersion = "45.1.0";
 perseusCore.addLibraryVersionToPerseusDebug(libName, libVersion);
 
 const apiVersion = {
@@ -45968,14 +46067,10 @@ class ServerItemRenderer extends React__namespace.Component {
     });
   }
   componentDidUpdate(prevProps, prevState) {
-    if (this.props.apiOptions.answerableCallback) {
+    const answerableCallback = this.props.apiOptions.answerableCallback;
+    if (answerableCallback != null) {
       const isAnswerable = this.questionRenderer.emptyWidgets().length === 0;
-      const {
-        answerableCallback
-      } = this.props.apiOptions;
-      if (answerableCallback) {
-        answerableCallback(isAnswerable);
-      }
+      answerableCallback(isAnswerable);
     }
     if (!this._fullyRendered) {
       const assetsLoaded = Object.values(this.state.assetStatuses).every(Boolean);
@@ -46346,7 +46441,7 @@ const traverseRenderer$1 = function (rendererOptions, contentCallback, deepWidge
       newContent = modifiedContent;
     }
   }
-  const newWidgets = objective_.mapObject(rendererOptions.widgets || {}, function (widgetInfo, widgetId) {
+  const newWidgets = mapObject(rendererOptions.widgets || {}, function (widgetInfo, widgetId) {
     // Widgets without info or a type are empty widgets, and
     // should always be renderable. It's also annoying to write
     // checks for this everywhere, so we just filter them out once and
@@ -48956,7 +49051,7 @@ const parseCSProgramWidget = parseWidget(constant("cs-program"), object({
 const parseDefinitionWidget = parseWidget(constant("definition"), object({
   togglePrompt: string,
   definition: string,
-  static: boolean
+  static: defaulted(boolean, () => false)
 }));
 
 const parseDropdownWidget = parseWidget(constant("dropdown"), object({
@@ -49159,15 +49254,26 @@ const parseIframeWidget = parseWidget(constant("iframe"), object({
   static: defaulted(boolean, () => false)
 }));
 
+const stringToNumber = (rawValue, ctx) => {
+  if (typeof rawValue === "number") {
+    return ctx.success(rawValue);
+  }
+  const parsedNumber = +rawValue;
+  if (rawValue === "" || isNaN(parsedNumber)) {
+    return ctx.failure("a number or numeric string", rawValue);
+  }
+  return ctx.success(parsedNumber);
+};
+
+const numericToNumber = pipeParsers(union(number).or(string).parser).then(stringToNumber).parser;
 const parsePerseusImageBackground = object({
   url: optional(nullable(string)),
-  width: optional(number),
-  height: optional(number),
-  top: optional(number),
-  left: optional(number),
-  bottom: optional(number),
-  // TODO(benchristel): convert scale to a number
-  scale: optional(union(number).or(string).parser)
+  width: optional(numericToNumber),
+  height: optional(numericToNumber),
+  top: optional(numericToNumber),
+  left: optional(numericToNumber),
+  bottom: optional(numericToNumber),
+  scale: optional(numericToNumber)
 });
 
 const pairOfNumbers$2 = pair(number, number);
@@ -49186,6 +49292,12 @@ const parseImageWidget = parseWidget(constant("image"), object({
   box: optional(pairOfNumbers$2)
 }));
 
+const booleanToString = (rawValue, ctx) => {
+  if (typeof rawValue === "boolean") {
+    return ctx.success(String(rawValue));
+  }
+  return ctx.failure("boolean", rawValue);
+};
 const parseInputNumberWidget = parseWidget(constant("input-number"), object({
   answerType: optional(enumeration("number", "decimal", "integer", "rational", "improper", "mixed", "percent", "pi")),
   inexact: optional(boolean),
@@ -49193,7 +49305,11 @@ const parseInputNumberWidget = parseWidget(constant("input-number"), object({
   rightAlign: optional(boolean),
   simplify: enumeration("required", "optional", "enforced"),
   size: enumeration("normal", "small"),
-  value: union(number).or(string).parser,
+  // TODO(benchristel): there are some content items where value is a
+  // boolean, even though that makes no sense. We should figure out if
+  // those content items are actually published anywhere, and consider
+  // updating them.
+  value: union(number).or(string).or(booleanToString).parser,
   customKeypad: optional(boolean)
 }));
 
@@ -49491,18 +49607,27 @@ const parseLockedFunctionType = object({
 const parseLockedFigure = union(parseLockedPointType).or(parseLockedLineType).or(parseLockedVectorType).or(parseLockedEllipseType).or(parseLockedPolygonType).or(parseLockedFunctionType).or(parseLockedLabelType).parser;
 const parseInteractiveGraphWidget = parseWidget(constant("interactive-graph"), object({
   step: pairOfNumbers,
-  gridStep: pairOfNumbers,
-  snapStep: pairOfNumbers,
+  // TODO(benchristel): rather than making gridStep and snapStep
+  // optional, we should duplicate the defaulting logic from the
+  // InteractiveGraph component. See parse-perseus-json/README.md for
+  // why.
+  gridStep: optional(pairOfNumbers),
+  snapStep: optional(pairOfNumbers),
   backgroundImage: optional(parsePerseusImageBackground),
   markings: enumeration("graph", "grid", "none"),
-  labels: array(string),
+  labels: optional(array(string)),
   showProtractor: boolean,
   showRuler: optional(boolean),
   showTooltips: optional(boolean),
   rulerLabel: optional(string),
   rulerTicks: optional(number),
   range: pair(pairOfNumbers, pairOfNumbers),
-  graph: parsePerseusGraphType,
+  // NOTE(benchristel): I copied the default graph from
+  // interactive-graph.tsx. See the parse-perseus-json/README.md for
+  // an explanation of why we want to duplicate the default here.
+  graph: defaulted(parsePerseusGraphType, () => ({
+    type: "linear"
+  })),
   correct: parsePerseusGraphType,
   // TODO(benchristel): default lockedFigures to empty array
   lockedFigures: optional(array(parseLockedFigure)),
@@ -49570,7 +49695,10 @@ const parseNumberLineWidget = parseWidget(constant("number-line"), object({
   isTickCtrl: optional(nullable(boolean)),
   divisionRange: array(number),
   numDivisions: optional(nullable(number)),
-  snapDivisions: number,
+  // NOTE(benchristel): I copied the default snapDivisions from
+  // number-line.tsx. See the parse-perseus-json/README.md for
+  // an explanation of why we want to duplicate the default here.
+  snapDivisions: defaulted(number, () => 2),
   tickStep: optional(nullable(number)),
   correctRel: optional(nullable(string)),
   correctX: number,
@@ -49583,18 +49711,18 @@ const parseMathFormat = enumeration("integer", "mixed", "improper", "proper", "d
 const parseNumericInputWidget = parseWidget(constant("numeric-input"), object({
   answers: array(object({
     message: string,
-    value: number,
+    value: optional(number),
     status: string,
     answerForms: optional(array(parseMathFormat)),
     strict: boolean,
     maxError: optional(nullable(number)),
     simplify: optional(nullable(string))
   })),
-  labelText: string,
+  labelText: optional(string),
   size: string,
   coefficient: boolean,
   rightAlign: optional(boolean),
-  static: boolean,
+  static: defaulted(boolean, () => false),
   answerForms: optional(array(object({
     name: parseMathFormat,
     simplify: optional(nullable(enumeration("required", "correct", "enforced", "optional")))
@@ -49607,12 +49735,18 @@ const parseNumericInputWidget = parseWidget(constant("numeric-input"), object({
 function parseRenderer(rawValue, ctx) {
   return parsePerseusRenderer(rawValue, ctx);
 }
+const largeToAuto = (height, ctx) => {
+  if (height === "large") {
+    return ctx.success("auto");
+  }
+  return ctx.success(height);
+};
 const parseOrdererWidget = parseWidget(constant("orderer"), object({
-  options: array(parseRenderer),
+  options: defaulted(array(parseRenderer), () => []),
   correctOptions: array(parseRenderer),
   otherOptions: array(parseRenderer),
-  height: enumeration("normal", "auto"),
-  layout: enumeration("horizontal", "vertical")
+  height: pipeParsers(enumeration("normal", "auto", "large")).then(largeToAuto).parser,
+  layout: defaulted(enumeration("horizontal", "vertical"), () => "horizontal")
 }));
 
 const parsePassageRefWidget = parseWidget(constant("passage-ref"), object({
@@ -49626,7 +49760,7 @@ const parsePassageWidget = parseWidget(constant("passage"), object({
   passageText: string,
   passageTitle: string,
   showLineNumbers: boolean,
-  static: boolean
+  static: defaulted(boolean, () => false)
 }));
 
 const parsePhetSimulationWidget = parseWidget(constant("phet-simulation"), object({
@@ -49647,7 +49781,10 @@ const parsePlotterWidget = parseWidget(constant("plotter"), object({
   picUrl: optional(nullable(string)),
   picSize: optional(nullable(number)),
   picBoxHeight: optional(nullable(number)),
-  plotDimensions: array(number)
+  // NOTE(benchristel): I copied the default plotDimensions from
+  // plotter.tsx. See the parse-perseus-json/README.md for an explanation
+  // of why we want to duplicate the defaults here.
+  plotDimensions: defaulted(array(number), () => [380, 300])
 }));
 
 const parsePythonProgramWidget = parseWidget(constant("python-program"), object({
@@ -49800,6 +49937,10 @@ const parseWidgetsMapEntry = (_ref, widgetMap, ctx) => {
       return parseAndAssign(`table ${id}`, parseTableWidget);
     case "video":
       return parseAndAssign(`video ${id}`, parseVideoWidget);
+    case "sequence":
+      // sequence is a deprecated widget type, and the corresponding
+      // widget component no longer exists.
+      return parseAndAssign(`sequence ${id}`, parseDeprecatedWidget);
     default:
       if (getWidget(type)) {
         // @ts-expect-error - 'type' is not a valid widget type
@@ -49808,6 +49949,11 @@ const parseWidgetsMapEntry = (_ref, widgetMap, ctx) => {
       return ctx.failure("a valid widget type", type);
   }
 };
+const parseDeprecatedWidget = parseWidget(
+// Ignore the incoming widget type and hardcode "deprecated-standin"
+(_, ctx) => ctx.success("deprecated-standin"),
+// Allow any widget options
+object({}));
 const parseStringToPositiveInt = (rawValue, ctx) => {
   if (typeof rawValue !== "string" || !/^[1-9][0-9]*$/.test(rawValue)) {
     return ctx.failure("numeric string", rawValue);