@khanacademy/perseus-core 3.5.0 → 3.7.0

package/dist/es/index.js

@@ -1,3 +1,5 @@
+import { seededRNG as seededRNG$1, shuffle as shuffle$2 } from '@khanacademy/perseus-core';
+
 /**
  * Adds the given perseus library version information to the __perseus_debug__
  * object and ensures that the object is attached to `globalThis` (`window` in
@@ -818,7 +820,7 @@ function times(n, iteratee, context) {
 }
 
 // Return a random integer between `min` and `max` (inclusive).
-function random(min, max) {
+function random$1(min, max) {
   if (max == null) {
     max = min;
     min = 0;
@@ -1561,14 +1563,14 @@ function toArray(obj) {
 function sample(obj, n, guard) {
   if (n == null || guard) {
     if (!isArrayLike(obj)) obj = values(obj);
-    return obj[random(obj.length - 1)];
+    return obj[random$1(obj.length - 1)];
   }
   var sample = toArray(obj);
   var length = getLength(sample);
   n = Math.max(Math.min(n, length), 0);
   var last = length - 1;
   for (var index = 0; index < n; index++) {
-    var rand = random(index, last);
+    var rand = random$1(index, last);
     var temp = sample[index];
     sample[index] = sample[rand];
     sample[rand] = temp;
@@ -1577,7 +1579,7 @@ function sample(obj, n, guard) {
 }
 
 // Shuffle a collection.
-function shuffle(obj) {
+function shuffle$1(obj) {
   return sample(obj, Infinity);
 }
 
@@ -1963,7 +1965,7 @@ var allExports = /*#__PURE__*/Object.freeze({
     matcher: matcher,
     matches: matcher,
     times: times,
-    random: random,
+    random: random$1,
     now: now,
     escape: escape,
     unescape: unescape,
@@ -2020,7 +2022,7 @@ var allExports = /*#__PURE__*/Object.freeze({
     where: where,
     max: max,
     min: min,
-    shuffle: shuffle,
+    shuffle: shuffle$1,
     sample: sample,
     sortBy: sortBy,
     groupBy: groupBy,
@@ -3076,7 +3078,7 @@ function parseWidget(parseType, parseOptions) {
     graded: optional(boolean),
     alignment: optional(string),
     options: parseOptions,
-    key: optional(number),
+    key: optional(nullable(number)),
     version: optional(object({
       major: number,
       minor: number
@@ -3156,6 +3158,13 @@ function convert(f) {
   return (rawValue, ctx) => ctx.success(f(rawValue));
 }
 
+const parseLegacyButtonSet = enumeration("basic", "basic+div", "trig", "prealgebra", "logarithms", "basic relations", "advanced relations", "scientific");
+const parseLegacyButtonSets = defaulted(array(parseLegacyButtonSet),
+// NOTE(benchristel): I copied the default buttonSets from
+// expression.tsx. See the parse-perseus-json/README.md for
+// an explanation of why we want to duplicate the default here.
+() => ["basic", "trig", "prealgebra", "logarithms"]);
+
 /**
  * Creates a parser for a widget options type with multiple major versions. Old
  * versions are migrated to the latest version. The parse fails if the input
@@ -3244,11 +3253,6 @@ function removeInvalidAnswerForms(possiblyInvalid) {
   }
   return valid;
 }
-
-// NOTE(benchristel): I copied the default buttonSets from
-// expression.tsx. See the parse-perseus-json/README.md for
-// an explanation of why we want to duplicate the default here.
-const parseButtonSets = defaulted(array(enumeration("basic", "basic+div", "trig", "prealgebra", "logarithms", "basic relations", "advanced relations")), () => ["basic", "trig", "prealgebra", "logarithms"]);
 const version1 = object({
   major: constant(1),
   minor: number
@@ -3259,7 +3263,7 @@ const parseExpressionWidgetV1 = parseWidgetWithVersion(version1, constant("expre
   times: boolean,
   visibleLabel: optional(string),
   ariaLabel: optional(string),
-  buttonSets: parseButtonSets,
+  buttonSets: parseLegacyButtonSets,
   buttonsVisible: optional(enumeration("always", "never", "focused"))
 }));
 const version0 = optional(object({
@@ -3274,7 +3278,7 @@ const parseExpressionWidgetV0 = parseWidgetWithVersion(version0, constant("expre
   form: boolean,
   simplify: boolean,
   value: string,
-  buttonSets: parseButtonSets,
+  buttonSets: parseLegacyButtonSets,
   buttonsVisible: optional(enumeration("always", "never", "focused"))
 }));
 function migrateV0ToV1(widget) {
@@ -3460,14 +3464,15 @@ const imageDimensionToNumber = pipeParsers(union(number).or(string).parser)
 // string parses to either NaN (using parseInt) or 0 (using unary +) and
 // CSS will treat NaN as invalid and default to 0 instead.
 .then(convert(emptyToZero)).then(stringToNumber).parser;
+const dimensionOrUndefined = defaulted(imageDimensionToNumber, () => undefined);
 const parsePerseusImageBackground = object({
   url: optional(nullable(string)),
-  width: optional(imageDimensionToNumber),
-  height: optional(imageDimensionToNumber),
-  top: optional(imageDimensionToNumber),
-  left: optional(imageDimensionToNumber),
-  bottom: optional(imageDimensionToNumber),
-  scale: optional(imageDimensionToNumber)
+  width: dimensionOrUndefined,
+  height: dimensionOrUndefined,
+  top: dimensionOrUndefined,
+  left: dimensionOrUndefined,
+  bottom: dimensionOrUndefined,
+  scale: dimensionOrUndefined
 });
 
 const pairOfNumbers$2 = pair(number, number);
@@ -4208,7 +4213,7 @@ const parseNumericInputWidget = parseWidget(constant("numeric-input"), object({
     // the data, simplify this.
     value: optional(nullable(number)),
     status: string,
-    answerForms: optional(array(parseMathFormat)),
+    answerForms: defaulted(array(parseMathFormat), () => undefined),
     strict: boolean,
     maxError: optional(nullable(number)),
     // TODO(benchristel): simplify should never be a boolean, but we
@@ -4306,7 +4311,7 @@ const parseRadioWidget = parseWidget(constant("radio"), object({
     // There is an import cycle between radio-widget.ts and
     // widgets-map.ts. The anonymous function below ensures that we
     // don't refer to parseWidgetsMap before it's defined.
-    widgets: optional((rawVal, ctx) => parseWidgetsMap(rawVal, ctx))
+    widgets: defaulted((rawVal, ctx) => parseWidgetsMap(rawVal, ctx), () => undefined)
   })),
   hasNoneOfTheAbove: optional(boolean),
   countChoices: optional(boolean),
@@ -4459,13 +4464,17 @@ const parseDeprecatedWidget = parseWidget(
 (_, 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("a string representing a positive integer", rawValue);
+const parseStringToNonNegativeInt = (rawValue, ctx) => {
+  // The article renderer seems to allow the numeric part of a widget ID to
+  // be 0, at least for image widgets. However, if widget IDs in an exercise
+  // contain 0, the exercise renderer will blow up. We allow 0 here for
+  // compatibility with articles.
+  if (typeof rawValue !== "string" || !/^(0|[1-9][0-9]*)$/.test(rawValue)) {
+    return ctx.failure("a string representing a non-negative integer", rawValue);
   }
   return ctx.success(+rawValue);
 };
-const parseWidgetIdComponents = pair(string, parseStringToPositiveInt);
+const parseWidgetIdComponents = pair(string, parseStringToNonNegativeInt);
 
 const parsePerseusRenderer = defaulted(object({
   // TODO(benchristel): content is also defaulted to empty string in
@@ -4476,8 +4485,9 @@ const parsePerseusRenderer = defaulted(object({
   // The anonymous function below ensures that we don't try to access
   // parseWidgetsMap before it's defined.
   widgets: defaulted((rawVal, ctx) => parseWidgetsMap(rawVal, ctx), () => ({})),
-  metadata: optional(array(string)),
-  images: parseImages
+  images: parseImages,
+  // deprecated
+  metadata: any
 }),
 // Default value
 () => ({
@@ -4488,29 +4498,48 @@ const parsePerseusRenderer = defaulted(object({
 
 const parsePerseusArticle = union(parsePerseusRenderer).or(array(parsePerseusRenderer)).parser;
 
-function _objectWithoutPropertiesLoose(r, e) {
-  if (null == r) return {};
-  var t = {};
-  for (var n in r) if ({}.hasOwnProperty.call(r, n)) {
-    if (-1 !== e.indexOf(n)) continue;
-    t[n] = r[n];
-  }
-  return t;
-}
-
 const parseHint = object({
   replace: optional(boolean),
   content: string,
   widgets: defaulted(parseWidgetsMap, () => ({})),
-  metadata: optional(array(string)),
-  images: parseImages
+  images: parseImages,
+  // deprecated
+  metadata: any
 });
 
-const _excluded$a = ["type", "options"];
+const parsePerseusAnswerArea = pipeParsers(defaulted(object({}), () => ({}))).then(convert(toAnswerArea)).parser;
+
+// Some answerAreas have extra, bogus fields, like:
+//
+//   "answerArea": {
+//     "type": "multiple",
+//     "options": {},
+//     "version": null,
+//     "static": false,
+//     "graded": false,
+//     "alignment": "",
+//   }
+//
+// This function filters the fields of an answerArea object, keeping only the
+// known ones, and converts `undefined` and `null` values to `false`.
+function toAnswerArea(raw) {
+  return {
+    zTable: !!raw.zTable,
+    calculator: !!raw.calculator,
+    chi2Table: !!raw.chi2Table,
+    financialCalculatorMonthlyPayment: !!raw.financialCalculatorMonthlyPayment,
+    financialCalculatorTotalAmount: !!raw.financialCalculatorTotalAmount,
+    financialCalculatorTimeToPayOff: !!raw.financialCalculatorTimeToPayOff,
+    periodicTable: !!raw.periodicTable,
+    periodicTableWithKey: !!raw.periodicTableWithKey,
+    tTable: !!raw.tTable
+  };
+}
+
 const parsePerseusItem$1 = object({
   question: parsePerseusRenderer,
   hints: defaulted(array(parseHint), () => []),
-  answerArea: pipeParsers(defaulted(object({}), () => ({}))).then(migrateAnswerArea).then(record(enumeration(...ItemExtras), boolean)).parser,
+  answerArea: parsePerseusAnswerArea,
   itemDataVersion: optional(object({
     major: number,
     minor: number
@@ -4519,24 +4548,6 @@ const parsePerseusItem$1 = object({
   answer: any
 });
 
-// Some answerAreas have extra fields, like:
-//
-//   "answerArea": {
-//     "type": "multiple",
-//     "options": {
-//       "content": "",
-//       "images": {},
-//       "widgets": {}
-//     }
-//   }
-//
-// The "type" and "options" fields don't seem to be used anywhere. This
-// migration function removes them.
-function migrateAnswerArea(rawValue, ctx) {
-  const rest = _objectWithoutPropertiesLoose(rawValue, _excluded$a);
-  return ctx.success(rest);
-}
-
 /**
  * Helper to parse PerseusItem JSON
  * Why not just use JSON.parse? We want:
@@ -4611,7 +4622,7 @@ function throwErrorIfCheatingDetected() {
 
 // This file is processed by a Rollup plugin (replace) to inject the production
 const libName = "@khanacademy/perseus-core";
-const libVersion = "3.5.0";
+const libVersion = "3.7.0";
 addLibraryVersionToPerseusDebug(libName, libVersion);
 
 /**
@@ -4710,6 +4721,24 @@ const mapObject = function mapObject(obj, lambda) {
   return result;
 };
 
+/**
+ * For details on the individual options, see the
+ * PerseusCategorizerWidgetOptions type
+ */
+
+/**
+ * Given a PerseusCategorizerWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getCategorizerPublicWidgetOptions(options) {
+  return {
+    items: options.items,
+    categories: options.categories,
+    randomizeItems: options.randomizeItems,
+    static: options.static
+  };
+}
+
 const defaultWidgetOptions$v = {
   items: [],
   categories: [],
@@ -4718,9 +4747,14 @@ const defaultWidgetOptions$v = {
 };
 const categorizerWidgetLogic = {
   name: "categorizer",
-  defaultWidgetOptions: defaultWidgetOptions$v
+  defaultWidgetOptions: defaultWidgetOptions$v,
+  getPublicWidgetOptions: getCategorizerPublicWidgetOptions
 };
 
+function getCSProgramPublicWidgetOptions(options) {
+  return options;
+}
+
 const DEFAULT_HEIGHT = 400;
 const defaultWidgetOptions$u = {
   programID: "",
@@ -4736,7 +4770,8 @@ const defaultWidgetOptions$u = {
 const csProgramWidgetLogic = {
   name: "cs-program",
   defaultWidgetOptions: defaultWidgetOptions$u,
-  supportedAlignments: ["block", "full-width"]
+  supportedAlignments: ["block", "full-width"],
+  getPublicWidgetOptions: getCSProgramPublicWidgetOptions
 };
 
 const defaultWidgetOptions$t = {
@@ -4749,6 +4784,27 @@ const definitionWidgetLogic = {
   defaultAlignment: "inline"
 };
 
+/**
+ * For details on the individual options, see the
+ * PerseusDropdownWidgetOptions type
+ */
+
+/**
+ * Given a PerseusDropdownWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getDropdownPublicWidgetOptions(options) {
+  return {
+    choices: options.choices.map(choice => ({
+      content: choice.content
+    })),
+    placeholder: options.placeholder,
+    static: options.static,
+    visibleLabel: options.visibleLabel,
+    ariaLabel: options.ariaLabel
+  };
+}
+
 const defaultWidgetOptions$s = {
   placeholder: "",
   choices: [{
@@ -4759,7 +4815,8 @@ const defaultWidgetOptions$s = {
 const dropdownWidgetLogic = {
   name: "definition",
   defaultWidgetOptions: defaultWidgetOptions$s,
-  defaultAlignment: "inline-block"
+  defaultAlignment: "inline-block",
+  getPublicWidgetOptions: getDropdownPublicWidgetOptions
 };
 
 const defaultWidgetOptions$r = {
@@ -4801,12 +4858,33 @@ const defaultWidgetOptions$q = {
   functions: ["f", "g", "h"]
 };
 
+/**
+ * For details on the individual options, see the
+ * PerseusExpressionWidgetOptions type
+ */
+
+/**
+ * Given a PerseusExpressionWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getExpressionPublicWidgetOptions(options) {
+  return {
+    buttonSets: options.buttonSets,
+    functions: options.functions,
+    times: options.times,
+    visibleLabel: options.visibleLabel,
+    ariaLabel: options.ariaLabel,
+    buttonsVisible: options.buttonsVisible
+  };
+}
+
 const expressionWidgetLogic = {
   name: "expression",
   version: currentVersion$3,
   widgetOptionsUpgrades: widgetOptionsUpgrades$2,
   defaultWidgetOptions: defaultWidgetOptions$q,
-  defaultAlignment: "inline-block"
+  defaultAlignment: "inline-block",
+  getPublicWidgetOptions: getExpressionPublicWidgetOptions
 };
 
 const defaultWidgetOptions$p = {
@@ -4829,6 +4907,22 @@ const gradedGroupSetWidgetLogic = {
   defaultWidgetOptions: defaultWidgetOptions$o
 };
 
+function _objectWithoutPropertiesLoose(r, e) {
+  if (null == r) return {};
+  var t = {};
+  for (var n in r) if ({}.hasOwnProperty.call(r, n)) {
+    if (-1 !== e.indexOf(n)) continue;
+    t[n] = r[n];
+  }
+  return t;
+}
+
+const _excluded$9 = ["correct"];
+function getGrapherPublicWidgetOptions(options) {
+  const publicOptions = _objectWithoutPropertiesLoose(options, _excluded$9);
+  return publicOptions;
+}
+
 const defaultWidgetOptions$n = {
   graph: {
     labels: ["x", "y"],
@@ -4851,22 +4945,24 @@ const defaultWidgetOptions$n = {
 };
 const grapherWidgetLogic = {
   name: "grapher",
-  defaultWidgetOptions: defaultWidgetOptions$n
+  defaultWidgetOptions: defaultWidgetOptions$n,
+  getPublicWidgetOptions: getGrapherPublicWidgetOptions
 };
 
 const defaultWidgetOptions$m = {
   content: "",
   widgets: {},
-  images: {},
-  // `undefined` instead of `null` so that getDefaultProps works for
-  // `the GroupMetadataEditor`
-  metadata: undefined
+  images: {}
 };
 const groupWidgetLogic = {
   name: "group",
   defaultWidgetOptions: defaultWidgetOptions$m
 };
 
+function getIFramePublicWidgetOptions(options) {
+  return options;
+}
+
 const defaultWidgetOptions$l = {
   url: "",
   settings: [{
@@ -4880,7 +4976,8 @@ const defaultWidgetOptions$l = {
 };
 const iframeWidgetLogic = {
   name: "iframe",
-  defaultWidgetOptions: defaultWidgetOptions$l
+  defaultWidgetOptions: defaultWidgetOptions$l,
+  getPublicWidgetOptions: getIFramePublicWidgetOptions
 };
 
 const defaultWidgetOptions$k = {
@@ -4934,6 +5031,12 @@ const interactionWidgetLogic = {
   defaultWidgetOptions: defaultWidgetOptions$i
 };
 
+const _excluded$8 = ["correct"];
+function getInteractiveGraphPublicWidgetOptions(options) {
+  const publicOptions = _objectWithoutPropertiesLoose(options, _excluded$8);
+  return publicOptions;
+}
+
 const defaultWidgetOptions$h = {
   labels: ["x", "y"],
   range: [[-10, 10], [-10, 10]],
@@ -4954,9 +5057,26 @@ const defaultWidgetOptions$h = {
 };
 const interactiveGraphWidgetLogic = {
   name: "interactive-graph",
-  defaultWidgetOptions: defaultWidgetOptions$h
+  defaultWidgetOptions: defaultWidgetOptions$h,
+  getPublicWidgetOptions: getInteractiveGraphPublicWidgetOptions
 };
 
+const _excluded$7 = ["answers"];
+/**
+ * For details on the individual options, see the
+ * PerseusLabelImageWidgetOptions type
+ */
+
+function getLabelImagePublicWidgetOptions(options) {
+  return _extends({}, options, {
+    markers: options.markers.map(getLabelImageMarkerPublicData)
+  });
+}
+function getLabelImageMarkerPublicData(marker) {
+  const publicData = _objectWithoutPropertiesLoose(marker, _excluded$7);
+  return publicData;
+}
+
 const defaultWidgetOptions$g = {
   choices: [],
   imageAlt: "",
@@ -4969,9 +5089,67 @@ const defaultWidgetOptions$g = {
 };
 const labelImageWidgetLogic = {
   name: "label-image",
-  defaultWidgetOptions: defaultWidgetOptions$g
+  defaultWidgetOptions: defaultWidgetOptions$g,
+  getPublicWidgetOptions: getLabelImagePublicWidgetOptions
 };
 
+// TODO(LEMS-2841): Should be able to remove once getPublicWidgetOptions is hooked up
+
+// TODO(LEMS-2841): Should be able to remove once getPublicWidgetOptions is hooked up
+const shuffleMatcher = props => {
+  // Use the same random() function to shuffle both columns sequentially
+  const rng = seededRNG$1(props.problemNum);
+  let left;
+  if (!props.orderMatters) {
+    // If the order doesn't matter, don't shuffle the left column
+    left = props.left;
+  } else {
+    left = shuffle$2(props.left, rng, /* ensurePermuted */true);
+  }
+  const right = shuffle$2(props.right, rng, /* ensurePermuted */true);
+  return {
+    left,
+    right
+  };
+};
+
+// TODO(LEMS-2841): Can shorten to shuffleMatcher after above function removed
+function shuffleMatcherWithRandom(data) {
+  // Use the same random() function to shuffle both columns sequentially
+  let left;
+  if (!data.orderMatters) {
+    // If the order doesn't matter, don't shuffle the left column
+    left = data.left;
+  } else {
+    left = shuffle$2(data.left, Math.random, /* ensurePermuted */true);
+  }
+  const right = shuffle$2(data.right, Math.random, /* ensurePermuted */true);
+  return {
+    left,
+    right
+  };
+}
+
+/**
+ * For details on the individual options, see the
+ * PerseusMatcherWidgetOptions type
+ */
+
+/**
+ * Given a PerseusMatcherWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getMatcherPublicWidgetOptions(options) {
+  const {
+    left,
+    right
+  } = shuffleMatcherWithRandom(options);
+  return _extends({}, options, {
+    left: left,
+    right: right
+  });
+}
+
 const defaultWidgetOptions$f = {
   left: ["$x$", "$y$", "$z$"],
   right: ["$1$", "$2$", "$3$"],
@@ -4981,9 +5159,16 @@ const defaultWidgetOptions$f = {
 };
 const matcherWidgetLogic = {
   name: "matcher",
-  defaultWidgetOptions: defaultWidgetOptions$f
+  defaultWidgetOptions: defaultWidgetOptions$f,
+  getPublicWidgetOptions: getMatcherPublicWidgetOptions
 };
 
+const _excluded$6 = ["answers"];
+function getMatrixPublicWidgetOptions(options) {
+  const publicOptions = _objectWithoutPropertiesLoose(options, _excluded$6);
+  return publicOptions;
+}
+
 const defaultWidgetOptions$e = {
   matrixBoardSize: [3, 3],
   answers: [[]],
@@ -4993,10 +5178,11 @@ const defaultWidgetOptions$e = {
 };
 const matrixWidgetLogic = {
   name: "matrix",
-  defaultWidgetOptions: defaultWidgetOptions$e
+  defaultWidgetOptions: defaultWidgetOptions$e,
+  getPublicWidgetOptions: getMatrixPublicWidgetOptions
 };
 
-const _excluded$9 = ["imageUrl", "imageTop", "imageLeft"];
+const _excluded$5 = ["imageUrl", "imageTop", "imageLeft"];
 const currentVersion$2 = {
   major: 1,
   minor: 0
@@ -5008,7 +5194,7 @@ const widgetOptionsUpgrades$1 = {
         imageTop,
         imageLeft
       } = v0options,
-      rest = _objectWithoutPropertiesLoose(v0options, _excluded$9);
+      rest = _objectWithoutPropertiesLoose(v0options, _excluded$5);
     return _extends({}, rest, {
       image: {
         url: imageUrl,
@@ -5036,6 +5222,12 @@ const measurerWidgetLogic = {
   defaultWidgetOptions: defaultWidgetOptions$d
 };
 
+const _excluded$4 = ["correctX", "correctRel"];
+function getNumberLinePublicWidgetOptions(options) {
+  const publicOptions = _objectWithoutPropertiesLoose(options, _excluded$4);
+  return publicOptions;
+}
+
 const defaultWidgetOptions$c = {
   range: [0, 10],
   labelRange: [null, null],
@@ -5052,9 +5244,25 @@ const defaultWidgetOptions$c = {
 };
 const numberLineWidgetLogic = {
   name: "number-line",
-  defaultWidgetOptions: defaultWidgetOptions$c
+  defaultWidgetOptions: defaultWidgetOptions$c,
+  getPublicWidgetOptions: getNumberLinePublicWidgetOptions
 };
 
+const _excluded$3 = ["answers"];
+/**
+ * For details on the individual options, see the
+ * PerseusNumericInputWidgetOptions type
+ */
+
+/**
+ * Given a PerseusNumericInputWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getNumericInputPublicWidgetOptions(options) {
+  const publicWidgetOptions = _objectWithoutPropertiesLoose(options, _excluded$3);
+  return publicWidgetOptions;
+}
+
 const defaultWidgetOptions$b = {
   answers: [{
     value: null,
@@ -5073,9 +5281,27 @@ const defaultWidgetOptions$b = {
 const numericInputWidgetLogic = {
   name: "numeric-input",
   defaultWidgetOptions: defaultWidgetOptions$b,
-  defaultAlignment: "inline-block"
+  defaultAlignment: "inline-block",
+  getPublicWidgetOptions: getNumericInputPublicWidgetOptions
 };
 
+/**
+ * For details on the individual options, see the
+ * PerseusOrdererWidgetOptions type
+ */
+
+/**
+ * Given a PerseusOrdererWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getOrdererPublicWidgetOptions(options) {
+  return {
+    options: options.options,
+    height: options.height,
+    layout: options.layout
+  };
+}
+
 const defaultWidgetOptions$a = {
   correctOptions: [{
     content: "$x$"
@@ -5088,7 +5314,8 @@ const defaultWidgetOptions$a = {
 };
 const ordererWidgetLogic = {
   name: "orderer",
-  defaultWidgetOptions: defaultWidgetOptions$a
+  defaultWidgetOptions: defaultWidgetOptions$a,
+  getPublicWidgetOptions: getOrdererPublicWidgetOptions
 };
 
 const defaultWidgetOptions$9 = {
@@ -5137,6 +5364,21 @@ const phetSimulationWidgetLogic = {
   defaultWidgetOptions: defaultWidgetOptions$6
 };
 
+const _excluded$2 = ["correct"];
+/**
+ * For details on the individual options, see the
+ * PerseusPlotterWidgetOptions type
+ */
+
+/**
+ * Given a PerseusPlotterWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getPlotterPublicWidgetOptions(options) {
+  const publicOptions = _objectWithoutPropertiesLoose(options, _excluded$2);
+  return publicOptions;
+}
+
 const defaultWidgetOptions$5 = {
   scaleY: 1,
   maxY: 10,
@@ -5154,7 +5396,8 @@ const defaultWidgetOptions$5 = {
 };
 const plotterWidgetLogic = {
   name: "plotter",
-  defaultWidgetOptions: defaultWidgetOptions$5
+  defaultWidgetOptions: defaultWidgetOptions$5,
+  getPublicWidgetOptions: getPlotterPublicWidgetOptions
 };
 
 const defaultWidgetOptions$4 = {
@@ -5166,7 +5409,7 @@ const pythonProgramWidgetLogic = {
   defaultWidgetOptions: defaultWidgetOptions$4
 };
 
-const _excluded$8 = ["noneOfTheAbove"];
+const _excluded$1 = ["noneOfTheAbove"];
 const currentVersion = {
   major: 1,
   minor: 0
@@ -5176,7 +5419,7 @@ const widgetOptionsUpgrades = {
     const {
         noneOfTheAbove
       } = v0props,
-      rest = _objectWithoutPropertiesLoose(v0props, _excluded$8);
+      rest = _objectWithoutPropertiesLoose(v0props, _excluded$1);
     if (noneOfTheAbove) {
       throw new Error("radio widget v0 no longer supports auto noneOfTheAbove");
     }
@@ -5195,13 +5438,73 @@ const defaultWidgetOptions$3 = {
   deselectEnabled: false
 };
 
+/**
+ * For details on the individual options, see the
+ * PerseusRadioWidgetOptions type
+ */
+
+/**
+ * Only the options from each Radio choice that should be exposed to the client.
+ */
+
+/**
+ * Given a PerseusRadioChoice object, return a new object with only the public
+ * data that should be included in the Radio public widget options.
+ */
+function getRadioChoicePublicData(choice) {
+  const {
+    content,
+    isNoneOfTheAbove,
+    widgets
+  } = choice;
+  return {
+    content,
+    isNoneOfTheAbove,
+    widgets
+  };
+}
+
+/**
+ * Given a PerseusRadioWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getRadioPublicWidgetOptions(options) {
+  return _extends({}, options, {
+    choices: options.choices.map(getRadioChoicePublicData)
+  });
+}
+
 const radioWidgetLogic = {
   name: "radio",
   version: currentVersion,
   widgetOptionsUpgrades: widgetOptionsUpgrades,
-  defaultWidgetOptions: defaultWidgetOptions$3
+  defaultWidgetOptions: defaultWidgetOptions$3,
+  getPublicWidgetOptions: getRadioPublicWidgetOptions
 };
 
+/**
+ * For details on the individual options, see the
+ * PerseusSorterWidgetOptions type
+ */
+
+/**
+ * Given a PerseusSorterWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getSorterPublicWidgetOptions(options) {
+  const shuffledCorrect = shuffle$2(options.correct, Math.random, /* ensurePermuted */true);
+  return _extends({}, options, {
+    // Note(Tamara): This does not provide correct answer information any longer.
+    // To maintain compatibility with the original widget options, we are
+    // keeping the key the same. Represents initial state of the cards here.
+    correct: shuffledCorrect,
+    // Note(Tamara): This new key is only added here with "true". There isn't
+    // a place where it is set to false. It indicates that the correct field
+    // has been shuffled and no longer contains correct answer info.
+    isCorrectShuffled: true
+  });
+}
+
 const defaultWidgetOptions$2 = {
   correct: ["$x$", "$y$", "$z$"],
   layout: "horizontal",
@@ -5209,9 +5512,16 @@ const defaultWidgetOptions$2 = {
 };
 const sorterWidgetLogic = {
   name: "sorter",
-  defaultWidgetOptions: defaultWidgetOptions$2
+  defaultWidgetOptions: defaultWidgetOptions$2,
+  getPublicWidgetOptions: getSorterPublicWidgetOptions
 };
 
+const _excluded = ["answers"];
+function getTablePublicWidgetOptions(options) {
+  const publicOptions = _objectWithoutPropertiesLoose(options, _excluded);
+  return publicOptions;
+}
+
 const defaultRows = 4;
 const defaultColumns = 1;
 
@@ -5226,7 +5536,8 @@ const defaultWidgetOptions$1 = {
 };
 const tableWidgetLogic = {
   name: "table",
-  defaultWidgetOptions: defaultWidgetOptions$1
+  defaultWidgetOptions: defaultWidgetOptions$1,
+  getPublicWidgetOptions: getTablePublicWidgetOptions
 };
 
 const defaultWidgetOptions = {
@@ -5254,6 +5565,13 @@ function getCurrentVersion(type) {
     minor: 0
   };
 }
+
+// TODO(LEMS-2870): getPublicWidgetOptionsFunction/PublicWidgetOptionsFunction
+// need better types
+const getPublicWidgetOptionsFunction = name => {
+  var _widgets$name$getPubl, _widgets$name;
+  return (_widgets$name$getPubl = (_widgets$name = widgets[name]) == null ? void 0 : _widgets$name.getPublicWidgetOptions) != null ? _widgets$name$getPubl : i => i;
+};
 function getWidgetOptionsUpgrades(type) {
   const widgetLogic = widgets[type];
   return (widgetLogic == null ? void 0 : widgetLogic.widgetOptionsUpgrades) || {};
@@ -5339,6 +5657,7 @@ var coreWidgetRegistry = /*#__PURE__*/Object.freeze({
     __proto__: null,
     isWidgetRegistered: isWidgetRegistered,
     getCurrentVersion: getCurrentVersion,
+    getPublicWidgetOptionsFunction: getPublicWidgetOptionsFunction,
     getWidgetOptionsUpgrades: getWidgetOptionsUpgrades,
     getDefaultWidgetOptions: getDefaultWidgetOptions,
     getSupportedAlignments: getSupportedAlignments,
@@ -5465,221 +5784,75 @@ function getUpgradedWidgetOptions(oldWidgetOptions) {
   });
 }
 
-/**
- * For details on the individual options, see the
- * PerseusOrdererWidgetOptions type
- */
-
-/**
- * Given a PerseusOrdererWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getOrdererPublicWidgetOptions(options) {
-  return {
-    options: options.options,
-    height: options.height,
-    layout: options.layout
-  };
-}
-
-/**
- * For details on the individual options, see the
- * PerseusCategorizerWidgetOptions type
- */
-
-/**
- * Given a PerseusCategorizerWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getCategorizerPublicWidgetOptions(options) {
-  return {
-    items: options.items,
-    categories: options.categories,
-    randomizeItems: options.randomizeItems,
-    static: options.static
-  };
-}
-
-function getCSProgramPublicWidgetOptions(options) {
-  return options;
-}
-
-/**
- * For details on the individual options, see the
- * PerseusExpressionWidgetOptions type
- */
-
-/**
- * Given a PerseusExpressionWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getExpressionPublicWidgetOptions(options) {
-  return {
-    buttonSets: options.buttonSets,
-    functions: options.functions,
-    times: options.times,
-    visibleLabel: options.visibleLabel,
-    ariaLabel: options.ariaLabel,
-    buttonsVisible: options.buttonsVisible
-  };
-}
-
-const _excluded$7 = ["correct"];
-function getGrapherPublicWidgetOptions(options) {
-  const publicOptions = _objectWithoutPropertiesLoose(options, _excluded$7);
-  return publicOptions;
-}
-
-const _excluded$6 = ["correct"];
-function getInteractiveGraphPublicWidgetOptions(options) {
-  const publicOptions = _objectWithoutPropertiesLoose(options, _excluded$6);
-  return publicOptions;
-}
-
-const _excluded$5 = ["answers"];
-/**
- * For details on the individual options, see the
- * PerseusLabelImageWidgetOptions type
- */
-
-function getLabelImagePublicWidgetOptions(options) {
-  return _extends({}, options, {
-    markers: options.markers.map(getLabelImageMarkerPublicData)
+function splitPerseusItem(originalItem) {
+  var _item$widgets;
+  const item = _.clone(originalItem);
+  const originalWidgets = (_item$widgets = item.widgets) != null ? _item$widgets : {};
+  const upgradedWidgets = getUpgradedWidgetOptions(originalWidgets);
+  const splitWidgets = {};
+  for (const [id, widget] of Object.entries(upgradedWidgets)) {
+    const publicWidgetOptionsFun = getPublicWidgetOptionsFunction(widget.type);
+    splitWidgets[id] = _extends({}, widget, {
+      options: publicWidgetOptionsFun(widget.options)
+    });
+  }
+  return _extends({}, item, {
+    widgets: splitWidgets
   });
 }
-function getLabelImageMarkerPublicData(marker) {
-  const publicData = _objectWithoutPropertiesLoose(marker, _excluded$5);
-  return publicData;
-}
-
-/**
- * For details on the individual options, see the
- * PerseusSorterWidgetOptions type
- */
-
-/**
- * Given a PerseusSorterWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getSorterPublicWidgetOptions(options) {
-  return {
-    // Note(Tamara): This does not provide correct answer information any longer.
-    // To maintain compatibility with the original widget options, we are
-    // keeping the key the same. Represents initial state of the cards here.
-    correct: options.correct.slice().sort(),
-    padding: options.padding,
-    layout: options.layout
-  };
-}
-
-/**
- * For details on the individual options, see the
- * PerseusDropdownWidgetOptions type
- */
-
-/**
- * Given a PerseusDropdownWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getDropdownPublicWidgetOptions(options) {
-  return {
-    choices: options.choices.map(choice => ({
-      content: choice.content
-    })),
-    placeholder: options.placeholder,
-    static: options.static,
-    visibleLabel: options.visibleLabel,
-    ariaLabel: options.ariaLabel
-  };
-}
-
-const _excluded$4 = ["answers"];
-/**
- * For details on the individual options, see the
- * PerseusNumericInputWidgetOptions type
- */
-
-/**
- * Given a PerseusNumericInputWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getNumericInputPublicWidgetOptions(options) {
-  const publicWidgetOptions = _objectWithoutPropertiesLoose(options, _excluded$4);
-  return publicWidgetOptions;
-}
-
-const _excluded$3 = ["correctX", "correctRel"];
-function getNumberLinePublicWidgetOptions(options) {
-  const publicOptions = _objectWithoutPropertiesLoose(options, _excluded$3);
-  return publicOptions;
-}
-
-/**
- * For details on the individual options, see the
- * PerseusRadioWidgetOptions type
- */
-
-/**
- * Only the options from each Radio choice that should be exposed to the client.
- */
 
-/**
- * Given a PerseusRadioChoice object, return a new object with only the public
- * data that should be included in the Radio public widget options.
- */
-function getRadioChoicePublicData(choice) {
-  const {
-    content,
-    isNoneOfTheAbove,
-    widgets
-  } = choice;
-  return {
-    content,
-    isNoneOfTheAbove,
-    widgets
+/* Note(tamara): Brought over from the perseus package packages/perseus/src/util.ts file.
+    May be useful to bring other perseus package utilities here. Contains utility functions
+    and types used across multiple widgets for randomization and shuffling. */
+const seededRNG = function seededRNG(seed) {
+  let randomSeed = seed;
+  return function () {
+    // Robert Jenkins' 32 bit integer hash function.
+    let seed = randomSeed;
+    seed = seed + 0x7ed55d16 + (seed << 12) & 0xffffffff;
+    seed = (seed ^ 0xc761c23c ^ seed >>> 19) & 0xffffffff;
+    seed = seed + 0x165667b1 + (seed << 5) & 0xffffffff;
+    seed = (seed + 0xd3a2646c ^ seed << 9) & 0xffffffff;
+    seed = seed + 0xfd7046c5 + (seed << 3) & 0xffffffff;
+    seed = (seed ^ 0xb55a4f09 ^ seed >>> 16) & 0xffffffff;
+    return (randomSeed = seed & 0xfffffff) / 0x10000000;
   };
-}
-
-/**
- * Given a PerseusRadioWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getRadioPublicWidgetOptions(options) {
-  return _extends({}, options, {
-    choices: options.choices.map(getRadioChoicePublicData)
-  });
-}
-
-const _excluded$2 = ["answers"];
-function getTablePublicWidgetOptions(options) {
-  const publicOptions = _objectWithoutPropertiesLoose(options, _excluded$2);
-  return publicOptions;
-}
-
-function getIFramePublicWidgetOptions(options) {
-  return options;
-}
-
-const _excluded$1 = ["answers"];
-function getMatrixPublicWidgetOptions(options) {
-  const publicOptions = _objectWithoutPropertiesLoose(options, _excluded$1);
-  return publicOptions;
-}
-
-const _excluded = ["correct"];
-/**
- * For details on the individual options, see the
- * PerseusPlotterWidgetOptions type
- */
+};
 
-/**
- * Given a PerseusPlotterWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getPlotterPublicWidgetOptions(options) {
-  const publicOptions = _objectWithoutPropertiesLoose(options, _excluded);
-  return publicOptions;
+// Shuffle an array using a given random seed or function.
+// If `ensurePermuted` is true, the input and output are guaranteed to be
+// distinct permutations.
+function shuffle(array, randomSeed, ensurePermuted = false) {
+  // Always return a copy of the input array
+  const shuffled = _.clone(array);
+
+  // Handle edge cases (input array is empty or uniform)
+  if (!shuffled.length || _.all(shuffled, function (value) {
+    return _.isEqual(value, shuffled[0]);
+  })) {
+    return shuffled;
+  }
+  let random;
+  if (typeof randomSeed === "function") {
+    random = randomSeed;
+  } else {
+    random = seededRNG(randomSeed);
+  }
+  do {
+    // Fischer-Yates shuffle
+    for (let top = shuffled.length; top > 0; top--) {
+      const newEnd = Math.floor(random() * top);
+      const temp = shuffled[newEnd];
+
+      // @ts-expect-error - TS2542 - Index signature in type 'readonly T[]' only permits reading.
+      shuffled[newEnd] = shuffled[top - 1];
+      // @ts-expect-error - TS2542 - Index signature in type 'readonly T[]' only permits reading.
+      shuffled[top - 1] = temp;
+    }
+  } while (ensurePermuted && _.isEqual(array, shuffled));
+  return shuffled;
 }
+const random = seededRNG(new Date().getTime() & 0xffffffff);
 
-export { coreWidgetRegistry as CoreWidgetRegistry, Errors, grapherUtil as GrapherUtil, ItemExtras, PerseusError, PerseusExpressionAnswerFormConsidered, addLibraryVersionToPerseusDebug, addWidget, approximateDeepEqual, approximateEqual, categorizerWidgetLogic as categorizerLogic, csProgramWidgetLogic as csProgramLogic, deepClone, definitionWidgetLogic as definitionLogic, dropdownWidgetLogic as dropdownLogic, explanationWidgetLogic as explanationLogic, expressionWidgetLogic as expressionLogic, getCSProgramPublicWidgetOptions, getCategorizerPublicWidgetOptions, getDecimalSeparator, getDropdownPublicWidgetOptions, getExpressionPublicWidgetOptions, getGrapherPublicWidgetOptions, getIFramePublicWidgetOptions, getInteractiveGraphPublicWidgetOptions, getLabelImagePublicWidgetOptions, getMatrixPublicWidgetOptions, getMatrixSize, getNumberLinePublicWidgetOptions, getNumericInputPublicWidgetOptions, getOrdererPublicWidgetOptions, getPlotterPublicWidgetOptions, getRadioPublicWidgetOptions, getSorterPublicWidgetOptions, getTablePublicWidgetOptions, getUpgradedWidgetOptions, getWidgetIdsFromContent, getWidgetIdsFromContentByType, gradedGroupWidgetLogic as gradedGroupLogic, gradedGroupSetWidgetLogic as gradedGroupSetLogic, grapherWidgetLogic as grapherLogic, groupWidgetLogic as groupLogic, iframeWidgetLogic as iframeLogic, imageWidgetLogic as imageLogic, inputNumberWidgetLogic as inputNumberLogic, interactionWidgetLogic as interactionLogic, interactiveGraphWidgetLogic as interactiveGraphLogic, isFailure, isSuccess, labelImageWidgetLogic as labelImageLogic, libVersion, lockedFigureColorNames, lockedFigureColors, lockedFigureFillStyles, mapObject, matcherWidgetLogic as matcherLogic, matrixWidgetLogic as matrixLogic, measurerWidgetLogic as measurerLogic, numberLineWidgetLogic as numberLineLogic, numericInputWidgetLogic as numericInputLogic, ordererWidgetLogic as ordererLogic, parseAndMigratePerseusArticle, parseAndMigratePerseusItem, parsePerseusItem, passageWidgetLogic as passageLogic, passageRefWidgetLogic as passageRefLogic, passageRefTargetWidgetLogic as passageRefTargetLogic, phetSimulationWidgetLogic as phetSimulationLogic, plotterWidgetLogic as plotterLogic, plotterPlotTypes, pluck, pythonProgramWidgetLogic as pythonProgramLogic, radioWidgetLogic as radioLogic, sorterWidgetLogic as sorterLogic, tableWidgetLogic as tableLogic, upgradeWidgetInfoToLatestVersion, videoWidgetLogic as videoLogic };
+export { coreWidgetRegistry as CoreWidgetRegistry, Errors, grapherUtil as GrapherUtil, ItemExtras, PerseusError, PerseusExpressionAnswerFormConsidered, addLibraryVersionToPerseusDebug, addWidget, approximateDeepEqual, approximateEqual, categorizerWidgetLogic as categorizerLogic, csProgramWidgetLogic as csProgramLogic, deepClone, definitionWidgetLogic as definitionLogic, dropdownWidgetLogic as dropdownLogic, explanationWidgetLogic as explanationLogic, expressionWidgetLogic as expressionLogic, getCSProgramPublicWidgetOptions, getCategorizerPublicWidgetOptions, getDecimalSeparator, getDropdownPublicWidgetOptions, getExpressionPublicWidgetOptions, getGrapherPublicWidgetOptions, getIFramePublicWidgetOptions, getInteractiveGraphPublicWidgetOptions, getLabelImagePublicWidgetOptions, getMatcherPublicWidgetOptions, getMatrixPublicWidgetOptions, getMatrixSize, getNumberLinePublicWidgetOptions, getNumericInputPublicWidgetOptions, getOrdererPublicWidgetOptions, getPlotterPublicWidgetOptions, getRadioPublicWidgetOptions, getSorterPublicWidgetOptions, getTablePublicWidgetOptions, getUpgradedWidgetOptions, getWidgetIdsFromContent, getWidgetIdsFromContentByType, gradedGroupWidgetLogic as gradedGroupLogic, gradedGroupSetWidgetLogic as gradedGroupSetLogic, grapherWidgetLogic as grapherLogic, groupWidgetLogic as groupLogic, iframeWidgetLogic as iframeLogic, imageWidgetLogic as imageLogic, inputNumberWidgetLogic as inputNumberLogic, interactionWidgetLogic as interactionLogic, interactiveGraphWidgetLogic as interactiveGraphLogic, isFailure, isSuccess, labelImageWidgetLogic as labelImageLogic, libVersion, lockedFigureColorNames, lockedFigureColors, lockedFigureFillStyles, mapObject, matcherWidgetLogic as matcherLogic, matrixWidgetLogic as matrixLogic, measurerWidgetLogic as measurerLogic, numberLineWidgetLogic as numberLineLogic, numericInputWidgetLogic as numericInputLogic, ordererWidgetLogic as ordererLogic, parseAndMigratePerseusArticle, parseAndMigratePerseusItem, parsePerseusItem, passageWidgetLogic as passageLogic, passageRefWidgetLogic as passageRefLogic, passageRefTargetWidgetLogic as passageRefTargetLogic, phetSimulationWidgetLogic as phetSimulationLogic, plotterWidgetLogic as plotterLogic, plotterPlotTypes, pluck, pythonProgramWidgetLogic as pythonProgramLogic, radioWidgetLogic as radioLogic, random, seededRNG, shuffle, shuffleMatcher, sorterWidgetLogic as sorterLogic, splitPerseusItem, tableWidgetLogic as tableLogic, upgradeWidgetInfoToLatestVersion, videoWidgetLogic as videoLogic };
 //# sourceMappingURL=index.js.map